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":"fili@ifountain.com", "alertId":"052652ac-5d1c-464a-812a-7dd18bbfba8c", "source":"fili@ifountain.com", "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":"fili@ifountain.com", "alertId":"052652ac-5d1c-464a-812a-7dd18bbfba8c", "source":"fili@ifountain.com", "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":"fili@ifountain.com", "alertId":"052652ac-5d1c-464a-812a-7dd18bbfba8c", "source":"fili@ifountain.com", "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":"fili@ifountain.com", "alertId":"052652ac-5d1c-464a-812a-7dd18bbfba8c", "source":"fili@ifountain.com", "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":"fili@ifountain.com", "alertId":"052652ac-5d1c-464a-812a-7dd18bbfba8c", "source":"fili@ifountain.com", "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":"fili@ifountain.com", "alertId":"052652ac-5d1c-464a-812a-7dd18bbfba8c", "source":"fili@ifountain.com", "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":"fili@ifountain.com", "alertId":"052652ac-5d1c-464a-812a-7dd18bbfba8c", "source":"fili@ifountain.com", "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":"fili@ifountain.com", "alertId":"052652ac-5d1c-464a-812a-7dd18bbfba8c", "source":"fili@ifountain.com", "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":"fili@ifountain.com", "alertId":"052652ac-5d1c-464a-812a-7dd18bbfba8c", "source":"fili@ifountain.com", "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":"fili@ifountain.com", "alertId":"052652ac-5d1c-464a-812a-7dd18bbfba8c", "source":"fili@ifountain.com", "alias":"aliastest", "tinyId":"23", "createdAt":1420452191104, "userId":"daed1180-0ce8-438b-8f8e-57e1a5920a2d", "entity":"", "owner" : "user2@ifountain.com" }, "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":"test@test.com", "message":"message test", "userId":"ac6a9ab7-98fe-4256-8a0e-30dc082a55e7", "entity":"", "tags":[ "tag1","tag2" ], "updatedAt":1470383477928000335, "username":"test@test.com" }, "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":"fili@ifountain.com", "source":"fili@ifountain.com", "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":"test@ifountain.com", "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": "user@atlassian.com", "entity": "", "alias": "8809ea18-89ea-4e4e-9cca-8037fd745e122220", "createdAt": 1512047424512, "updatedAt": 1512559548447000000, "username": "user@atlassian.com", "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": "user@atlassian.com", "userId": "486c4622-6db5-47220-b467-3ffb7s1be9b03", "description": "test description", "recipients": [], "teams": [], "actions": [], "details": {}, "priority": "P3", "oldPriority": "P3", "source": "user@atlassian.com" }, "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": "user@atlassian.com", "userId": "486c4622-6db5-47220-b467-3ffb7s1be9b03", "description": "test description", "recipients": [], "teams": [], "actions": [], "details": {}, "priority": "P3", "oldPriority": "P3", "source": "user@atlassian.com" }, "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":"fili@ifountain.com", "alertId":"052652ac-5d1c-464a-812a-7dd18bbfba8c", "source":"fili@ifountain.com", "alias":"aliastest", "tinyId":"23", "createdAt":1420452191104, "userId":"daed1180-0ce8-438b-8f8e-57e1a5920a2d", "entity":"" }, "action":"TestAction", "integrationId":"37c8f316-17c6-49d7-899b-9c7e540c048d", "integrationName":"Integration1" }

 

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

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