Jira Service Management の管理者向けの利用開始ガイド
最初に、Jira Service Management の使用を開始する方法を確認します。
Magentrix と統合する
この記事では、Jira Service Management Cloud の一部のお客様に段階的に展開されている、Jira Service Management でネイティブに利用できる新しいアラート機能を取り上げています。ご利用のサイトにはまだ表示されていないか、利用できない可能性があります。
統合でできるようになること
Jira Service Management は Magentrix との強力な双方向の統合を提供します。Magentrix 統合を使用することで、カスタマー ポータルでケースが作成されたときに Jira Service Management でアラートが作成され、その逆も同様に実行されます。このミラーリングは、Jira Service Management の堅牢なオンコール設定とルーティング ルールによって、適切なユーザーに適切なタイミングでアラートを集約するのに役立ちます。
統合による機能
Magentrix カスタマー ポータルでケースが作成されると、Jira Service Management でアラートが作成されます。
Magentrix カスタマー ポータルでケースがクローズされると、Jira Service Management でアラートがクローズされます。
Magentrix カスタマー ポータルでケースのステータスが [Active (アクティブ)] に変更されると、Jira Service Management でアラートが承認されます。
Jira Service Management でアラートが作成されると、Magentrix カスタマー ポータルでケースが作成されます。
統合をセットアップする
Magentrix は双方向の統合です。設定は次の手順で行います。
Jira Service Management で Magentrix 統合を追加する
アラート アクションをマッピングする
Magentrix で統合を設定する
Magentrix 統合を追加する
Jira Service Management の Free プランまたは Standard プランを使用している場合は、この統合はチームの運用ページからのみ追加できます。Settings (歯車のアイコン) > Products ([Jira 設定] の下) > OPERATIONS からこの機能にアクセスするには、Premium プランまたは Enterprise プランが必要です。
統合をチームの運用ページから追加すると、そのチームが統合の所有者になります。つまり、Jira Service Management は、この統合を通じて受信したアラートをチームにのみ割り当てます。
Jira Service Management で Magentrix 統合を追加するには、次の手順を実行します。
チームのオペレーション ページに移動します。
左側のナビゲーション パネルで、[統合]、[統合を追加] の順に選択します。
検索を実行して「Magentrix」を選択します。
次の画面で、統合の名前を入力します。
オプション: 特定のチームが統合からのアラートを受信するようにする場合は、[Assignee team (担当者チーム)] のチームを選択します。
[続行] を選択します。
この時点で、統合が保存されます。[統合を設定する手順] セクションを展開して、API キーをコピーします。
このキーは、後ほど Magentrix で統合を設定する際に使用します。[統合をオンにする] を選択します。
統合のために作成したルールは、統合をオンにした場合にのみ機能します。
Magentrix で統合を設定する
Magentrix で統合を設定するには、次の手順を実行します。
受信用
Magentrix で、左側のメニューにある [Develop (開発)] を展開します。
[Classes & Triggers (クラスとトリガー)] を選択します。
[新規] を選択します。
[Trigger (トリガー)] > [Next (次へ)] を選択します。
エンティティ フィールドで [Case (Force) (ケース (強制))] を選択して [Next (次へ)] を選択します。
[Name (名前)] に「JsmAlertTrigger」と入力します。
[Version (バージョン)] で [3.0] を選択します。
[保存] を選択します。
このファイルの内容を Magentrix UI エディターにコピーします。
Jira Service Management で統合を追加する際にコピーした API キーを [JSM_API_KEY] フィールドに貼り付けます。
[保存] を選択します。
送信用
[Magentrix Subdomain (Magentrix サブドメイン)] には、Magentrix インスタンスのサブドメインを入力します。
たとえば、Magentrix の URL が https://test.magentrixcloud.com である場合は、フィールドに「test」と入力します。[Magentrix Username (Magentrix ユーザー名)] には、Magentrix のユーザー名を入力します。
[Magentrix Password (Magentrix パスワード)] には、Magentrix のユーザー パスワードを入力します。
アラート アクションをマッピングする
Jira Service Management アクションと Magentrix アクション間のアクション マッピングを定義できます。アラートのソースが Magentrix ではない場合 (つまり、アラートが別の統合によって作成された場合) のマッピングも行えます。マッピングには、Jira Service Management のアクション リストから選択できます。
ケース タイプが指定されていない場合は、その値が既定で「問題」に設定されます。
カスタマイズしたフィールドの Magentrix トリガーを設定する
Jira Service Management アラートでカスタム フィールドを使用するには、Magentrix トリガーをカスタマイズします。トリガーには、編集可能なカスタム フィールドが 10 個あります。これらのフィールドは定義されていますが、初期化されていません。ペイロードでカスタム フィールドを送信するには、次のステップに従います。
Magentrix を初期化して、カスタム フィールドを選択します。
カスタム フィールドはペイロードにすでに追加されています。フィールドを初期化すると、Jira Service Management に送信されます。Jira Service Management アラートにカスタム フィールドを追加するには、[受信] セクションを展開して、必要に応じてアラート ルールを追加します。
Magentrix から送信されたペイロードのサンプル
(JSON 形式)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
{
"caseId": "5002600000DHQfbACH",
"caseDescription": "Sample case description",
"severity": "S3 - Medium",
"caseNumber": "00314044",
"description": "Sample description",
"priority": "Medium",
"subject": "[JSM] Sample message",
"caseType": "Problem",
"ownerEmail": "sampleemail@sample.com",
"caseStatus": "New",
"accountName": "Sample Account",
"assetName": "Sample Asset",
"isEscalated": "TRUE",
"escalatedBy": "0032600000dQcsPAAS",
"customField1": "Sample Custom Field",
"customField2": "Sample Custom Field",
"customField3": "Sample Custom Field",
"customField4": "Sample Custom Field",
"customField5": "Sample Custom Field",
"customField6": "Sample Custom Field",
"customField7": "Sample Custom Field",
"customField8": "Sample Custom Field",
"customField9": "Sample Custom Field",
"customField10": "Sample Custom Field"
}
この内容はお役に立ちましたか?