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 形式)

{
"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"
}

この内容はお役に立ちましたか?

正確ではなかった

明確ではなかった

関係なかった

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

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

コミュニティに質問