We're updating our terminology in Jira

'Issue' is changing to 'work item'. You might notice some inconsistencies while this big change takes place.

Jira Edge Connector のアラート アクション データ

この記事では、Jira Service Management Cloud の一部のお客様に段階的に展開されている、Jira Service Management でネイティブに利用できる新しいアラート機能を取り上げています。ご利用のサイトにはまだ表示されていないか、利用できない可能性があります。

Jira Service Management は、アラート・アクティビティ・データをさまざまな統合に渡します。このデータを利用できる統合の一部を以下に示します。

Webhook 統合の場合、アラート・アクション・データは Webhook リクエストの JSON 本文で提供されます。Marid を使用する統合の場合、データは Marid のスクリプト・ディレクトリにある任意のスクリプトで使用できます。

Alert actions (アラート アクション)

作成

[チーム]: このアラートに割り当てられたチームの ID

[受信者]: このアラートに割り当てられた受信者の ID

JSON

{ "source":{ "name":"web", "type":"API" }, "alert":{ "updatedAt":1420452193166002000, "tags": [ "tag1", "tag2" ], "teams" : [ "team1", "team2" ], "recipients" : [ "recipient1", "recipient2" ], "message":" test alert", "username":"[email protected]", "alertId":"052652ac-5d1c-464a-812a-7dd18bbfba8c", "source":"[email protected]", "alias":"aliastest", "tinyId":"23", "createdAt":1420452191104, "userId":"daed1180-0ce8-438b-8f8e-57e1a5920a2d", "entity":"" }, "action":"Create", "integrationId":"37c8f316-17c6-49d7-899b-9c7e540c048d", "integrationName":"Integration1" }

Acknowledge

JSON

{ "source":{ "name":"", "type":"web" }, "alert":{ "updatedAt":1420452224764002246, "tags": [ "tag1", "tag2" ], "message":"test alert", "username":"[email protected]", "alertId":"052652ac-5d1c-464a-812a-7dd18bbfba8c", "source":"[email protected]", "alias":"aliastest", "tinyId":"23", "createdAt":1420452191104, "userId":"daed1180-0ce8-438b-8f8e-57e1a5920a2d", "entity":"" }, "action":"Acknowledge", "integrationId":"37c8f316-17c6-49d7-899b-9c7e540c048d", "integrationName":"Integration1" }

承認解除

JSON

{ "source":{ "name":"", "type":"web" }, "alert":{ "updatedAt":1420452224764002246, "tags": [ "tag1", "tag2" ], "message":"test alert", "username":"[email protected]", "alertId":"052652ac-5d1c-464a-812a-7dd18bbfba8c", "source":"[email protected]", "alias":"aliastest", "tinyId":"23", "createdAt":1420452191104, "userId":"daed1180-0ce8-438b-8f8e-57e1a5920a2d", "entity":"" }, "action":"UnAcknowledge", "integrationId":"37c8f316-17c6-49d7-899b-9c7e540c048d", "integrationName":"Integration1" }

AddTeam

JSON

{ "source":{ "name":"", "type":"web" }, "alert":{ "updatedAt":1420452256147001924, "tags": [ "tag1", "tag2" ], "message":"test alert", "username":"[email protected]", "alertId":"052652ac-5d1c-464a-812a-7dd18bbfba8c", "source":"[email protected]", "alias":"aliastest", "tinyId":"23", "createdAt":1420452191104, "userId":"daed1180-0ce8-438b-8f8e-57e1a5920a2d", "entity":"", "team":"team2" }, "action":"AddTeam", "integrationId":"37c8f316-17c6-49d7-899b-9c7e540c048d", "integrationName":"Integration1" }

AddRecipient

JSON

{ "source":{ "name":"", "type":"web" }, "alert":{ "updatedAt":1420452274617001925, "tags": [ "tag1", "tag2" ], "message":"test alert", "username":"[email protected]", "alertId":"052652ac-5d1c-464a-812a-7dd18bbfba8c", "source":"[email protected]", "alias":"aliastest", "tinyId":"23", "createdAt":1420452191104, "userId":"daed1180-0ce8-438b-8f8e-57e1a5920a2d", "entity":"", "recipient":"team2_escalation" }, "action":"AddRecipient", "integrationId":"37c8f316-17c6-49d7-899b-9c7e540c048d", "integrationName":"Integration1" }

AddNote

JSON

{ "source":{ "name":"", "type":"web" }, "alert":{ "updatedAt":1420452275002000962, "tags": [ "tag1", "tag2" ], "message":"test alert", "username":"[email protected]", "alertId":"052652ac-5d1c-464a-812a-7dd18bbfba8c", "source":"[email protected]", "alias":"aliastest", "tinyId":"23", "createdAt":1420452191104, "userId":"daed1180-0ce8-438b-8f8e-57e1a5920a2d", "entity":"", "note":"note to test alert" }, "action":"AddNote", "integrationId":"37c8f316-17c6-49d7-899b-9c7e540c048d", "integrationName":"Integration1" }

AddTags

JSON

{ "source":{ "name":"", "type":"web" }, "alert":{ "updatedAt":1420452275002000962, "tags": [ "tag1", "tag2", "tag3" ], "addedTags":"tag1,tag2,tag3", "message":"test alert", "username":"[email protected]", "alertId":"052652ac-5d1c-464a-812a-7dd18bbfba8c", "source":"[email protected]", "alias":"aliastest", "tinyId":"23", "createdAt":1420452191104, "userId":"daed1180-0ce8-438b-8f8e-57e1a5920a2d", "entity":"" }, "action":"AddTags", "integrationId":"37c8f316-17c6-49d7-899b-9c7e540c048d", "integrationName":"Integration1" }

RemoveTags

JSON

{ "source":{ "name":"", "type":"web" }, "alert":{ "updatedAt":1420452275002000962, "tags": [ "tag1", "tag2" ], "removedTags":"tag3", "message":"test alert", "username":"[email protected]", "alertId":"052652ac-5d1c-464a-812a-7dd18bbfba8c", "source":"[email protected]", "alias":"aliastest", "tinyId":"23", "createdAt":1420452191104, "userId":"daed1180-0ce8-438b-8f8e-57e1a5920a2d", "entity":"" }, "action":"RemoveTags", "integrationId":"37c8f316-17c6-49d7-899b-9c7e540c048d", "integrationName":"Integration1" }

close

JSON

{ "source":{ "name":"", "type":"web" }, "alert":{ "updatedAt":1420452374669001603, "tags": [ "tag1", "tag2" ], "message":"test alert", "username":"[email protected]", "alertId":"052652ac-5d1c-464a-812a-7dd18bbfba8c", "source":"[email protected]", "alias":"aliastest", "tinyId":"23", "createdAt":1420452191104, "userId":"daed1180-0ce8-438b-8f8e-57e1a5920a2d", "entity":"" }, "action":"Close", "integrationId":"37c8f316-17c6-49d7-899b-9c7e540c048d", "integrationName":"Integration1" }

所有権の割り当て

JSON

{ "source":{ "name":"", "type":"web" }, "alert":{ "updatedAt":1420452374669001603, "tags": [ "tag1", "tag2" ], "message":"test alert", "username":"[email protected]", "alertId":"052652ac-5d1c-464a-812a-7dd18bbfba8c", "source":"[email protected]", "alias":"aliastest", "tinyId":"23", "createdAt":1420452191104, "userId":"daed1180-0ce8-438b-8f8e-57e1a5920a2d", "entity":"", "owner" : "[email protected]" }, "action":"AssignOwnership", "integrationId":"37c8f316-17c6-49d7-899b-9c7e540c048d", "integrationName":"Integration1" }

Take Ownership (所有権の保有)

JSON

{ "integrationType":"Integration1", "alert":{ "createdAt":1470226893192, "tinyId":"47", "alias":"8a745a79-3ed3-4044-8427-98e067c0623c", "alertId":"8a745a79-3ed3-4044-8427-98e067c0623c", "source":"[email protected]", "message":"message test", "userId":"ac6a9ab7-98fe-4256-8a0e-30dc082a55e7", "entity":"", "tags":[ "tag1","tag2" ], "updatedAt":1470383477928000335, "username":"[email protected]" }, "integrationName":"Webhook", "action":"TakeOwnership", "integrationId":"fd8755c1-7a5e-4829-9ecc-8990e1a2eed3", "source":{ "name":"", "type":"web" } }

削除

JSON

{ "source":{ "name":"", "type":"web" }, "alert":{ "tinyId":"23", "alias":"aliastest", "entity":"", "message":"test alert", "updatedAt":1420452374669001603, "alertId":"052652ac-5d1c-464a-812a-7dd18bbfba8c", "username":"[email protected]", "source":"[email protected]", "createdAt":1420452191104, "userId":"daed1180-0ce8-438b-8f8e-57e1a5920a2d" }, "action":"Delete", "integrationId":"37c8f316-17c6-49d7-899b-9c7e540c048d", "integrationName":"Integration1" }

エスカレート

escalationNotify の「entity」プロパティには、次の値のいずれかを指定します。

  • ユーザー

  • group

  • team

  • スケジュール

escalationNotify の「type」プロパティは次のいずれかになります。

  • 「user」「group」「team」エンティティの場合は「default」

  • 「schedule」エンティティの場合は「default」「previous」「next」のいずれか

JSON

{ "escalationId":"51859f57-7fad-467b-ad79-59acbc69cb6a", "headers":{ "foo":"bar" }, "integrationName":"Webhook_Test", "escalationNotify":{ "name":"[email protected]", "id":"64818849-71d6-40ce-87c6-ed5e588702fd", "type":"default", "entity":"user" }, "integrationId":"868be72a-8015-432e-8b23-c1f7f4374baa", "escalationName":"test_esc", "alert":{ "alertId":"7ba97e3a-d328-4b5e-8f9a-39e945a3869a" }, "escalationTime":0, "action":"Escalate", "repeatCount":0 }

優先度のアップデート

JSON

{ "action": "UpdatePriority", "alert": { "alertId": "8809ea18-89ea-4e4e-9cca-8037fd745e102343", "message": "alert", "tags": [], "tinyId": "418", "source": "[email protected]", "entity": "", "alias": "8809ea18-89ea-4e4e-9cca-8037fd745e122220", "createdAt": 1512047424512, "updatedAt": 1512559548447000000, "username": "[email protected]", "userId": "486c4622-6db5-47220-b467-3ffb7s1be9b03", "insertedAt": 1512047424512000000, "priority": "P1", "oldPriority": "P3" }, "source": { "name": "", "type": "web" }, "integrationId": "1a423289-568a-468c-8a11-b1404edf0a832334534344", "integrationName": "Webhook1", "integrationType": "Webhook" }

説明のアップデート

JSON

{ "action": "UpdateDescription", "alert": { "alertId": "0474d8d4-a4f2-4b2a-8b4d-1d5909faee41-1542176739551", "message": "test alert", "tags": [], "tinyId": "418", "entity": "", "alias": "8809ea18-89ea-4e4e-9cca-8037fd745e122220", "createdAt": 1512047424512, "updatedAt": 1512559548447000000, "username": "[email protected]", "userId": "486c4622-6db5-47220-b467-3ffb7s1be9b03", "description": "test description", "recipients": [], "teams": [], "actions": [], "details": {}, "priority": "P3", "oldPriority": "P3", "source": "[email protected]" }, "source": { "name": "", "type": "web" }, "integrationId": "1a423289-568a-468c-8a11-b1404edf0a832334534344", "integrationName": "Webhook1", "integrationType": "Webhook" }

メッセージを更新する

JSON

{ "action": "UpdateMessage", "alert": { "alertId": "0474d8d4-a4f2-4b2a-8b4d-1d5909faee41-1542176739551", "message": "test alert 2", "tags": [], "tinyId": "418", "entity": "", "alias": "8809ea18-89ea-4e4e-9cca-8037fd745e122220", "createdAt": 1512047424512, "updatedAt": 1512559548447000000, "username": "[email protected]", "userId": "486c4622-6db5-47220-b467-3ffb7s1be9b03", "description": "test description", "recipients": [], "teams": [], "actions": [], "details": {}, "priority": "P3", "oldPriority": "P3", "source": "[email protected]" }, "source": { "name": "", "type": "web" }, "integrationId": "1a423289-568a-468c-8a11-b1404edf0a832334534344", "integrationName": "Webhook1", "integrationType": "Webhook" }

「TestAction」という名前のカスタム・アクション

JSON

{ "source":{ "name":"", "type":"web" }, "alert":{ "updatedAt":1420452275002000962, "tags": [ "tag1", "tag2" ], "message":"test alert", "username":"[email protected]", "alertId":"052652ac-5d1c-464a-812a-7dd18bbfba8c", "source":"[email protected]", "alias":"aliastest", "tinyId":"23", "createdAt":1420452191104, "userId":"daed1180-0ce8-438b-8f8e-57e1a5920a2d", "entity":"" }, "action":"TestAction", "integrationId":"37c8f316-17c6-49d7-899b-9c7e540c048d", "integrationName":"Integration1" }

 

さらにヘルプが必要ですか?

アトラシアン コミュニティをご利用ください。
OSZAR »