リリースノート
1.0.0 (Requires minimum Cloud Exchange version 6.0.0)
Added
- 初回リリース。
サポート:タスクの作成、タスクの更新、ステータスと重大度の同期。
本書では、Netskope Cloud ExchangeプラットフォームのTicket OrchestratorモジュールでAsana v1.0.0プラグインを設定する方法について説明します。このプラグインは、Asanaプラットフォームでタスクを作成するために使用されます。また、タスクの更新、ステータスと重要度の同期もサポートしています。
前提条件
この設定を完了するには、以下が必要です。
- Netskopeテナント(または、例えば本番環境と開発/テスト環境など、複数のテナント)。
- Netskope テナントプラグインおよびチケットオーケストレータープラグインがすでに構成されている Netskope Cloud Exchange テナント。
- チケットの作成、更新、表示、および API トークンの生成権限を持つアカウントを持つ Asana インスタンス。
- Secret Managerの構成については、このドキュメントを参照してください。Azure Key Vault Secrets Managerをセットアップするには、このドキュメントを参照してください。
- 次のホストへの接続:https://app.asana.com/api/1.0.
Asanaプラグインのサポート
このプラグインは、Asanaプラットフォームでタスクを作成するために使用されます。タスクの更新、ステータスと重大度の同期もサポートしています。
| チケットでサポートされているアラートの種類 | チケットでサポートされているイベントの種類 |
|---|---|
| 侵害されたクレデンシャル、ポリシー、マルサイト、マルウェア、DLP、セキュリティ評価、ウォッチリスト、検疫、修復、UBA、CTEP、デバイス、コンテンツ | エンドポイント、インシデント |
マッピング
キューマッピング
| デスクリプション | 名前と値 |
|---|---|
| 名前(サマリー)のカスタムメッセージのデフォルトマップフィールド | Netskope:$appCategory アラート名:$alertName イベント名:$alert_name |
| ノート(デスクリプション)のカスタムメッセージのデフォルトマップフィールド | アラート/イベントID: $id アラート/イベントアプリ: $app アラート/イベントユーザー: $user アラート名: $alertName アラートタイプ: $alertType アラートアプリカテゴリ: $appCategory イベント名: $alert_name イベントタイプ: $eventType |
Default Status Mapping
| Cloud Exchangeフィールド | Asanaフィールド |
|---|---|
| 新しい | 新しい |
| 進行中 | 進行中 |
| 保留中 | 保留中 |
| Closed | Closed |
| Deleted | – |
| その他 | other |
Default Severity Mappings
| Cloud Exchangeフィールド | Asanaフィールド |
|---|---|
| 致命的 | 致命的 |
| 高い | 高い |
| 中くらい | 中くらい |
| 低い | 低い |
| 情報提供 | – |
| その他 | other |
権限
ユーザーは管理者ロールを持っているか、対象のプロジェクトおよびワークスペースでタスクを作成する権限を持っている必要があります。
APIの詳細
Base URL: https://app.asana.com/api/1.0 (設定の API ベース URL)。リストされているすべてのエンドポイントはそれに関連しています。
使うAPI一覧
| APIエンドポイント | 方法 | 使うケース |
|---|---|---|
| /users/me | 得る | 認証手順でトークンを検証します。 |
| /workspaces | 得る | 「ワークスペース」ドロップダウンをポピュレートし、「構成パラメーター」で選択したワークスペースを検証します。 |
| /workspaces/{workspace_gid}/custom_fields | 得る | キューマッピングおよび「ステータス」/「重大度」フィールド名の検証のために、ワークスペースのカスタムフィールドを取得します。 |
| /workspaces/{workspace_gid}/projects | 得る | ワークスペースのアーカイブされていないプロジェクトでキューリストを埋めます。 |
| /projects/{project_gid}/custom_field_settings | 得る | キュープロジェクトのカスタムフィールドを取得し、作成時およびインシデント更新時にマッピングされたカスタムフィールド値を検証および変換します。 |
| /tasks | 役職 | キューとして選択されたAsanaプロジェクトにタスクを作成します。 |
| /tasks/{task_gid} | PUT | タスクの担当者およびマッピングされたカスタムフィールドを更新します(POST /batch のサブリクエストとして送信されます)。 |
| /tasks/{task_gid}/stories | 役職 | タスクにコメントを追加します(重複排除コメントとして直接送信されるか、インシデント更新を伴うPOST /batchのサブリクエストとして送信されます)。 |
| /tasks/{task_gid} | 得る | 同期中(POST /batchのサブ要求)にタスクの現在のステータス、重大度、および担当者を取得します。 |
| /batch | 役職 | 1回の呼び出しで最大10個のサブリクエストを送信できます。タスクの更新+コメント、同期中にタスクを読むなど。 |
Pagination (list APIs)
| パラメータ | デスクリプション |
|---|---|
| limit | ページサイズ。常に100。 |
| offset | 前回の応答の next_page.offset からのカーソル。最初のページには送信されません。 |
プラグインは next_page が null になるまでページを読み取ります(最大100ページ)。
Validate Token
API Endpoint: /users/me
Method: 得る
Request Headers
| 鍵 | Value |
|---|---|
| Authorization | Bearer <Bearer Token> |
| ユーザーエージェント | netskope-ce-7.0.0-cto-asana-v1.0.0 |
Query Parameters
| パラメータ | デスクリプション |
|---|---|
| opt_fields | gid,name,電子メール |
| limit | 1 |
API Response
{
"data": {
"gid": "1219158266245161",
"email": "user@example.com",
"name": "CE User",
"resource_type": "user"
}
}
ワークスペースを取得
API Endpoint: /workspaces
Method: 得る
Request Headers
| 鍵 | Value |
|---|---|
| Authorization | Bearer <Bearer Token> |
| ユーザーエージェント | netskope-ce-7.0.0-cto-asana-v1.0.0 |
Query Parameters
| パラメータ | デスクリプション |
|---|---|
| opt_fields | gid,name |
| limit | Page size (100 per page). |
| offset | 後続ページのページネーションカーソル。 |
API Response
{
"data": [
{
"gid": "1207511261202026",
"name": "crestdata.ai",
"resource_type": "workspace"
},
{
"gid": "1219248179687734",
"name": "Project Workspace",
"resource_type": "workspace"
}
],
"next_page": null
}
ワークスペースカスタムフィールドを取得
API Endpoint: /workspaces/{workspace_gid}/custom_fields
Method: 得る
Request Headers
| 鍵 | Value |
|---|---|
| Authorization | Bearer <Bearer Token> |
| ユーザーエージェント | netskope-ce-7.0.0-cto-asana-v1.0.0 |
Query Parameters
| パラメータ | デスクリプション |
|---|---|
| opt_fields | gid,name,resource_subtype,representation_type,is_formula_field,enum_options.gid,enum_options.name,enum_options.enabled |
| limit | Page size (100 per page). |
| offset | 後続ページのページネーションカーソル。 |
API Response
{
"data": [
{
"gid": "1219251107661327",
"name": "Severity",
"resource_subtype": "enum",
"representation_type": "enum",
"is_formula_field": false,
"resource_type": "custom_field",
"enum_options": [
{
"gid": "1219251107661328",
"name": "Critical",
"enabled": true,
"resource_type": "enum_option"
},
{
"gid": "1219251107661329",
"name": "High",
"enabled": true,
"resource_type": "enum_option"
},
{
"gid": "1219251107661330",
"name": "Medium",
"enabled": true,
"resource_type": "enum_option"
},
{
"gid": "1219251107661331",
"name": "Low",
"enabled": true,
"resource_type": "enum_option"
}
]
},
{
"gid": "1219247798084316",
"name": "Status",
"resource_subtype": "text",
"representation_type": "text",
"is_formula_field": false,
"resource_type": "custom_field"
}
],
"next_page": {
"offset": "eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9",
"path": "/workspaces/1207511261202026/custom_fields?limit=100&offset=eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9",
"uri": "https://app.asana.com/api/1.0/workspaces/1207511261202026/custom\_fields?limit=100&offset=eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9"
}
}
ワークスペースプロジェクトの取得
API Endpoint: /workspaces/{workspace_gid}/projects
Method: 得る
Request Headers
| 鍵 | Value |
|---|---|
| Authorization | Bearer <Bearer Token> |
| ユーザーエージェント | netskope-ce-7.0.0-cto-asana-v1.0.0 |
Query Parameters
| パラメータ | デスクリプション |
|---|---|
| archived | false。アーカイブされていないプロジェクトのみが返されます。 |
| opt_fields | gid,name |
| limit | Page size (100 per page). |
| offset | 後続ページのページネーションカーソル。 |
API Response
{
"data": [
{
"gid": "1219245697468891",
"name": "Netskope Project",
"resource_type": "project"
},
{
"gid": "1219245697468900",
"name": "SOC Board",
"resource_type": "project"
}
],
"next_page": null
}
プロジェクトカスタムフィールド設定を取得
API Endpoint: /projects/{project_gid}/custom_field_settings
Method: 得る
Request Headers
| 鍵 | Value |
|---|---|
| Authorization | Bearer <Bearer Token> |
| ユーザーエージェント | netskope-ce-7.0.0-cto-asana-v1.0.0 |
Query Parameters
| パラメータ | デスクリプション |
|---|---|
| opt_fields | custom_field.gid,custom_field.name,custom_field.resource_subtype,custom_field.representation_type,custom_field.is_formula_field,custom_field.enum_options.gid,custom_field.enum_options.name,custom_field.enum_options.enabled |
| limit | Page size (100 per page). |
| offset | 後続ページのページネーションカーソル。 |
API Response
{
"data": [
{
"gid": "1219248075786133",
"resource_type": "custom_field_setting",
"custom_field": {
"gid": "1219251107661327",
"name": "Severity",
"resource_subtype": "enum",
"representation_type": "enum",
"is_formula_field": false,
"resource_type": "custom_field",
"enum_options": [
{
"gid": "1219251107661329",
"name": "High",
"enabled": true,
"resource_type": "enum_option"
},
{
"gid": "1219251107661331",
"name": "Low",
"enabled": true,
"resource_type": "enum_option"
}
]
}
}
],
"next_page": null
}
Create Task
API Endpoint: /tasks
Method: 役職
Request Headers
| 鍵 | Value |
|---|---|
| Authorization | Bearer <Bearer Token> |
| ユーザーエージェント | netskope-ce-7.0.0-cto-asana-v1.0.0 |
Query Parameters
| パラメータ | デスクリプション |
|---|---|
| opt_fields | gid,name,permalink_url,completed,completed_at,assignee.gid,assignee.email,memberships.section.name,memberships.project.gid,custom_fields.gid,custom_fields.name,custom_fields.display_value,custom_fields.enum_value.name |
Request Body
{
"data": {
"name": "[CE] Netskope Alert - DLP Violation",
"projects": [
"1219245697468891"
],
"notes": "Alert ID: 7f3c... Alert Name: DLP Violation ...",
"assignee": "analyst@example.com",
"custom_fields": {
"1219251107661327": "1219251107661329",
"1219250000000001": 85,
"1219250000000002": {
"date": "2026-10-16"
}
}
}
}
API Response
{
"data": {
"gid": "1219269610239849",
"name": "[CE] Netskope Alert - DLP Violation",
"permalink_url": "https://app.asana.com/1/1207511261202026/project/1219245697468891/task/1219269610239849",
"completed": false,
"completed_at": null,
"assignee": {
"gid": "1219158266245161",
"email": "analyst@example.com",
"resource_type": "user"
},
"memberships": [
{
"project": {
"gid": "1219245697468891",
"resource_type": "project"
},
"section": {
"name": "Untitled section",
"resource_type": "section"
}
}
],
"custom_fields": [
{
"gid": "1219251107661327",
"name": "Severity",
"display_value": "High",
"enum_value": {
"name": "High",
"resource_type": "enum_option"
},
"resource_type": "custom_field"
}
],
"resource_type": "task"
}
}
タスクの更新
API Endpoint: /tasks/{task_gid}
Method:PUT
Request Headers
| 鍵 | Value |
|---|---|
| Authorization | Bearer <Bearer Token> |
| ユーザーエージェント | netskope-ce-7.0.0-cto-asana-v1.0.0 |
Request Body
{
"assignee": "analyst@example.com",
"custom_fields": {
"1219251107661327": "1219251107661328"
}
}
API Response
{
"status_code": 200,
"headers": {},
"body": {
"data": {
"gid": "1219269610239849",
"name": "[CE] Netskope Alert - DLP Violation",
"permalink_url": "https://app.asana.com/1/1207511261202026/project/1219245697468891/task/1219269610239849",
"assignee": {
"gid": "1219158266245161",
"email": "analyst@example.com"
},
"custom_fields": [
{
"gid": "1219251107661327",
"name": "Severity",
"display_value": "Critical",
"enum_value": {
"name": "Critical"
}
}
]
}
}
}
Add Comment
API Endpoint: /tasks/{task_gid}/stories
Method: 役職
Request Headers
| 鍵 | Value |
|---|---|
| Authorization | Bearer <Bearer Token> |
| ユーザーエージェント | netskope-ce-7.0.0-cto-asana-v1.0.0 |
Query Parameters
| パラメータ | デスクリプション |
|---|---|
| opt_fields | gid,created_at,created_by.name,resource_subtype,text |
Request Body
{
"data": {
"text": "Received new alert/event with Alert/Event ID: 7f3c... and Alert Name: DLP Violation, Event Name: DLP Violation in Cloud Exchange."
}
}
API Response
{
"data": {
"gid": "1219270000000123",
"created_at": "2026-10-16T09:15:22.123Z",
"created_by": {
"gid": "1219158266245161",
"name": "CE User",
"resource_type": "user"
},
"resource_subtype": "comment_added",
"text": "Received new alert/event with Alert/Event ID: 7f3c... and Alert Name: DLP Violation, Event Name: DLP Violation in Cloud Exchange.",
"resource_type": "story"
}
}
タスクの取得
API Endpoint: /tasks/{task_gid}
Method: 得る
Request Headers
| 鍵 | Value |
|---|---|
| Authorization | Bearer <Bearer Token> |
| ユーザーエージェント | netskope-ce-7.0.0-cto-asana-v1.0.0 |
API Response
{
"status_code": 200,
"headers": {},
"body": {
"data": {
"gid": "1219269610239849",
"name": "[CE] Netskope Alert - DLP Violation",
"completed": false,
"completed_at": null,
"modified_at": "2026-10-16T10:02:11.456Z",
"permalink_url": "https://app.asana.com/1/1207511261202026/project/1219245697468891/task/1219269610239849",
"assignee": {
"gid": "1219158266245161",
"email": "analyst@example.com"
},
"memberships": [
{
"project": {
"gid": "1219245697468891"
},
"section": {
"gid": "1219245697468895",
"name": "In Review"
}
}
],
"custom_fields": [
{
"gid": "1219251280995675",
"name": "Status",
"display_value": "In Progress",
"enum_value": {
"name": "In Progress"
}
},
{
"gid": "1219251107661327",
"name": "Severity",
"display_value": "High",
"enum_value": {
"name": "High"
}
}
]
}
}
}
バッチリクエスト
API Endpoint: /batch
Method: 役職
Request Headers
| 鍵 | Value |
|---|---|
| Authorization | Bearer <Bearer Token> |
| ユーザーエージェント | netskope-ce-7.0.0-cto-asana-v1.0.0 |
Request Body
{
"data": {
"actions": [
{
"relative_path": "/tasks/1219269610239849",
"method": "put",
"data": {
"assignee": "analyst@example.com",
"custom_fields": {
"1219251107661327": "1219251107661328"
}
},
"options": {
"fields": [
"gid",
"name",
"permalink_url",
"completed",
"completed_at",
"assignee.gid",
"assignee.email",
"memberships.section.name",
"memberships.project.gid",
"custom_fields.gid",
"custom_fields.name",
"custom_fields.display_value",
"custom_fields.enum_value.name"
]
}
}
]
}
}
API Response
{
"data": [
{
"status_code": 200,
"headers": {},
"body": {
"data": {
"gid": "1219269610239849",
"name": "[CE] Netskope Alert - DLP Violation",
"assignee": {
"gid": "1219158266245161",
"email": "analyst@example.com"
},
"custom_fields": [
{
"gid": "1219251280995675",
"name": "Status",
"display_value": "Closed",
"enum_value": {
"name": "Closed"
}
}
]
}
}
},
{
"status_code": 404,
"headers": {},
"body": {
"errors": [
{
"message": "task: Not a recognized ID: 1219269610239850",
"help": "For more information on API status codes and how to handle them, read the docs on errors: https://developers.asana.com/docs/errors"
}
]
}
}
]
}
パフォーマンスマトリックス
これらの測定値は、以下の仕様を満たす大型CEスタックで収集されたものです。
| デスクリプション | 仕様 |
|---|---|
| スタックの詳細 | サイズ:大 RAM:32 GB CPU コア:16 |
| 1分あたりに作成されるチケット数 | 約42チケット/分 |
ユーザーエージェント
netskope-ce-7.0.0-cto-asana-v1.0.0
ワークフロー
- Asana API トークンを取得します。
- Asanaプラグインを構成します。
- ビジネスルールを設定します。
- キューを設定します。
- プラグインを検証してください。
動画を見る
再生ボタンをクリックして動画をご覧ください。
Asana APIトークンを取得する
-
Asanaデベロッパーコンソールにログインし、Personal access tokens > Create new tokenをクリックします。Asanaデベロッパーコンソールにログインできない場合は、Asana ITサポートチームにコンタクトしてください。

-
トークン名を入力し、I agree to the Asana API Termsチェックボックスをオンにして、Create tokenをクリックします。

-
生成されたトークンはCloud Exchangeでプラグインを構成するために使用されるため、コピーしてください。

Asanaプラグインを構成する
-
Cloud Exchange で、 Settings > Plugin Storeに移動します。Asana v1.0.0 (CTO)プラグインを検索して選択してください。

-
構成名を入力し、必要に応じて同期間隔を変更してください。

-
Next をクリックし、認証パラメータを入力します。
- API Base URL: Asana REST APIのベースURL。デフォルト:https://app.asana.com/api/1.0
- Token:Asanaの個人用アクセス トークン。前に作成したトークン。

-
Nextをクリックして、設定パラメータを入力してください。
- Workspace: プロジェクトを含むAsanaワークスペースを選択します。リストはAsanaインスタンスからリアルタイムで取得されます。Asanaの左下にあるプロフィール写真メニュからワークスペースを確認できます。
- Status Field Name: タスクステータスを保持するAsanaカスタムフィールドの正確な名前。ステータスをCloud Exchangeに同期するために使用されます。空の場合、ステータスは同期されません。
- Severity Field Name: タスクの重大度を保持するAsanaカスタムフィールドの正確な名前。重大度をCloud Exchangeに同期するために使用されます。空の場合、重大度は同期されません。

-
Next をクリックし、次のフィールドのマッピング構成を入力します:
ステータスマッピングのデフォルトマッピングは次の通りです。

カスタムステータスを作成するには、ページ下部のAddをクリックしてください。

Add NewをクリックしてCloud Exchangeフィールドを作成します。
フィールド名を入力し、Add Fieldをクリックします。任意のステータスにマップし、Saveをクリックします。


デフォルトの重大度マッピングは次の通りです。カスタムステータスと同様に、要件に応じてカスタム重大度を作成することもできます。

-
Saveをクリックします。新しいプラグインは、Ticket Orchestrator > Pluginsページに表示されます。

Asanaのチケットオーケストレータービジネスルールを構成する
Asanaプラットフォームでチケットを作成するために必要なフィルタに基づいてビジネスルールを作成します。
-
Ticket OrchestratorでBusiness Rulesに移動します。
-
Create New Ruleをクリックしてください。
-
適切なルール名を入力し、ビジネスルールのフィールドに適切なフィルタークエリ条件を作成します。Filter Queryをクリックしてクエリを手動で入力することもできます。

-
Saveをクリックしてください。

-
重複排除ルールを設定するには、作成したビジネスルールを展開します。
-
「重複排除」ルールのタイトルの横にある + アイコンをクリックします。

-
要件に従ってルール名とフィルターを入力し、Saveをクリックします。

重複排除ルールがビジネスルールに追加された場合、Cloud Exchangeは重複排除ルールに従って新しいチケット/タスクを作成しません。代わりに、そのチケットの重複排除カウントを増やし、そのチケットにコメントを追加します。重複排除ルールは、タイプがエンドポイントのすべてのアラートおよびイベントに必要です。インシデントイベントの場合、重複排除ルールがなくても、Cloud Exchangeは新しいチケットを作成しません。代わりに、送信先プラットフォームのそのチケットにコメントを追加します。
Asana用のTicket Orchestratorキューを構成します
-
Ticket OrchestratorでQueuesに移動します。
-
Add Queue Configurationをクリックし、ドロップダウンからビジネスルール、プラグイン構成、およびキューを選択します。
[マップフィールド]セクションの[アラート]と[インシデント]の間で適切な値をマップします。アラートまたはイベントの属性は、カスタムメッセージフィールドの「$」からアクセスできます。Add ボタンをクリックして、フィールドマッピングを追加します。

メモは、AsanaプラットフォームのUI上のデスクリプションとして反映されます。 -
既にアラート/イベントを取得済みの場合、 Saveをクリックしてキューを同期してください。

Asanaプラグインを検証する
Cloud Exchangeで検証する
ワークフローを検証するには、Netskope Alerts/Eventsが必要です。
-
Asanaで作成されたチケットのリストを表示するには、Ticket OrchestratorのTicketsに移動してください。

-
Logging ページからチケットの作成を確認します。Settings > Logging に移動し、プラグイン名でフィルタを適用します。


Asanaで検証する
インシデント作成を検証するには:
-
チケットオーケストレーターで、Ticketsに移動し、チケットの外部リンク列のOpenをクリックします。これにより、Asana Cloud に移動し、新しく作成されたチケットを表示できます。

インシデントイベントのために作成されたタスクは次のとおりです。

UBAアラート用に作成されたタスクを次に示します:

-
Cloud Exchangeのすべてのチケットの全体的なステータスを表示するには、Ticket Orchestratorタブに移動します。


Asanaプラグインのトラブルシューティング
Asanaプラグインを設定できません
Asanaプラグインを設定できない場合、以下のいずれかの理由が考えられます:
- 間違ったクレデンシャルが提供されました。
- ユーザーに必要な権限がありません。
- 不適切なAPIベースURLが提供されました。
What to do:
- 必ず正しいクレデンシャルを入力してください。
- ユーザーに必要な権限があることを確認してください。「権限」セクションを参照してください。
- 正しいインスタンスAPIベースURLが提供されていることを確認してください。デフォルトでは、プラグインのURLはhttps://app.asana.com/api/1.0となります。インスタンスのAPIベースURLが異なる場合は、プラグイン設定のAPIベースURLを更新してください。
プラグインを使用してチケットを作成できません
プラグインでチケットを作成できない場合は、以下のいずれかの理由が考えられます。
- Cloud Exchangeにアラートやイベントが存在しない、または新しいアラートやイベントが取得されていない。
- ビジネスルールにフィルタリングされたアラート/イベントはありません。
- ユーザーにはインシデントを作成するために必要な権限がありません。
- 名前およびメモフィールドは、キュー構成ではマップされません。
What to do:
- アラート/イベントが[アラート/イベント]ページで利用可能かどうかを確認してください。アラート/イベントが利用できない場合、チケットは作成されません。チケットオーケストレーターでアラート/イベントを作成するために、テナントまたはその他の必要な構成を構成してください。
- ビジネスルールを確認し、アラートがフィルタリングされているかどうかをテストして確認します。フィルタリングでアラートが利用できない場合は、ビジネスルールを更新します。
- ユーザーに必要な権限があることを確認します。「権限」セクションを参照してください。
- タスクを作成するには、名前フィールドとメモフィールドに値を割り当てるようにしてください。
既に設定されたプラグインを編集中に行われた変更は反映されません
Cloud Exchange v6.1.0以下では、更新された構成パラメータを保存できない場合があります。
What to do: 設定パラメータを更新する場合は、プラグインを編集して[設定パラメータ]ページに移動し、変更するパラメータを更新して[設定パラメータ]タブの[保存]をクリックしてください。

既知の行動
- No Fixed Fields: Asanaには固定フィールドがないため、マッピングはユーザーが作成するものによって異なります。名前、メモ、担当者を除いて、Asanaタスクに固定フィールドはありません。ServiceNowやJiraのような組み込みのステータスや重大度はありません。
- Workspace-level field listing: カスタムフィールドは、選択したプロジェクトでフィルタリングされるのではなく、ワークスペースレベルでリストされます。選択したプロジェクトに関連付けられていないフィールドが表示され、フィールドとプロジェクトを特定するエラーが発生してタスク作成に失敗することがあります。
- Duplicate project names: プロジェクト名が同じ場合、キューのドロップダウンメニューでは見分けがつきません。ただし、タスクは実際に選択されたプロジェクト内に作成されます。
- Duplicate field names: Asanaでは、ワークスペース内に同じ名前とタイプのカスタムフィールドを作成できます。これにより、これらの重複するフィールドを単一のプロジェクトに作成できます。そのため、同じ名前とタイプのフィールドが、キューのマッピングで同じラベルで表示される場合があります。
- Duplicate Status or Severity fields: Asanaでは、プロジェクト内で同じ名前のカスタムフィールドを複数作成できます。同期中、プラグインは名前でフィールドを識別します(
StatusまたはSeverity、大文字と小文字は区別されません)。- Dropdown fields first: プラグインは、Asanaによって返された順序で一致する名前のドロップダウンフィールドを確認し、選択されたオプションを持つ最初のフィールドを使用します。
- Other fields as a fallback: 一致するドロップダウンフィールドで選択された値がない場合、プラグインは一致する名前を持つ、値を含む最初のテキスト、数字、または日付フィールドを使用します。空のフィールドはスキップされます。
- Sync States : 同期状態の間、プラグインはフィールド名のみからタスクの「ステータス」と「深刻度」を読み取り、値を含むドロップダウンフィールドと、その次にテキストフィールドを使用します。Asanaでは、1つのプロジェクトに同じ名前のカスタムフィールドを複数含めることができます。
- User Errors: Asanaプラグインを介して作成され、Asanaで削除されたタスクに対して403エラーが発生する場合があります。このため、ユーザーはプラグイン構成カードにエラーメッセージを表示する場合もあります。この問題を解決するには、Cloud Exchangeの [チケット] ページからすでに削除されたチケット(Asana上で)を削除します。
CTO Asana [CTO Asana]: タスク「1219575971976398」をAsanaと同期中にエラーが発生しました。終了コード403を受け取りました。エラー:このタスクにアクセスできません。
タスクは、次の同期サイクルで再読み込みされます。 - プラグイン構成のステータスまたは重要度のマッピングからその他 > その他のマッピングが削除されている場合、マッピング構成に存在しないステータスまたは重要度に対して、Cloud Exchangeチケットはステータスとして新しい、または重要度として低いを表示します。アップデートインシデントをNetskopeテナントに戻すトグルが有効になっている場合、これはインシデントイベントの場合にNetskopeテナントのステータスまたは重要度も更新する可能性があります。
制限
プロジェクトが削除されると、そのプロジェクトが既に設定されているキューはIDとして表示されます。

