BMC Remedyforce と統合する

統合でできるようになること

Jira Service Management では BMC Remedyforce との強力なインテグレーションが実現されます。BMC Remedyforce で新しいインシデントが作成されると、インシデントに関する詳しい情報を含む、対応する Jira Service Management アラートが自動的に作成されます。Jira Service Management には、オンコール ローテーション、スケジューリング機能、アラート エスカレーションを含む充実した通知が用意されているため、BMC Remedyforce を利用されているお客様は最高クラスのインシデント管理を実現できます。

統合による機能

• インシデントが BMC Remedyforce で作成されると、アラートが Jira Service Management で作成されます。

• インシデントが BMC Remedyforce でクローズ、拒否、クローズ/連絡先なし、クローズしてメール、完了として更新されると、アラートは Jira Service Management でもクローズされます。

• BMC Remedyforce でインシデントが受け入れ済み、割り当て済みとして更新されると、Jira Service Management のアラートは承認済みとして更新されます。

• [Send Alert Updates Back to BMC RemedyForce (アラートの更新を BMC RemedyForce に送り返す)] が有効な場合、BMC RemedyForce で作成されたアラートに対して選択したアクションが Jira Service Management で実行されると、BMC RemedyForce で BMC RemedyForce のアクションが実行されます。

統合をセットアップする

BMC Remedyforce は双方向のインテグレーションです。設定は次の手順で行います。

• Jira Service Management で BMC Remedyforce インテグレーションを追加する

• BMC Remedyforce でインテグレーションを設定する

BMC Remedyforce インテグレーションを追加する

Jira Service Management で BMC Remedyforce インテグレーションを追加するには、次の手順を実行します。

1. チームの運用ページに移動します。

2. 左側のナビゲーション パネルで、[統合]、[統合を追加] の順に選択します。

3. 検索を実行して「BMC Remedyforce」を選択します。

4. 次の画面で、統合の名前を入力します。

5. オプション: 特定のチームが統合からのアラートを受信するようにする場合は、[Assignee team (担当者チーム)] のチームを選択します。

6. [続行] を選択します。
   この時点で、統合が保存されます。

7. [統合を設定する手順] セクションを展開して、API キーをコピーします。
   後で BMC Remedyforce でインテグレーションを設定するときにこのキーを使用します。

8. [統合をオンにする] を選択します。
   統合のために作成したルールは、統合をオンにした場合にのみ機能します。

BMC Remedyforce でインテグレーションを設定する

BMC Remedyforce とのインテグレーションでは、Jira Service Management へのインシデントの転送がサポートされています。これを設定するには、次の手順を実行します。

1. jsmClass.apxc ファイルをダウンロードします。

2. BMC Remedyforce で BMC Remedyforce の設定ページに移動します。

3. jsmClass.apxc を開いて、内容をコピーします。

4. 「セットアップ」ページに内容を貼り付けます。

5. [保存] を選択します。

6. [作成] > [オブジェクト] の順に移動します。

7. [カスタム オブジェクト] リストで [インシデント] を選択します。

8. [トリガー] リストの上部にある [新規] を選択します。

9. jsmTrigger.apxt ファイルをダウンロードします。

10. 「BMC Remedyforce セットアップ」ページに移動します。

11. jsmTrigger.apxt を開いて、内容をコピーします。

12. 先ほど Jira Service Management からコピーした API キーをトリガー関数の apiKey に貼り付けます。

13. [保存] を選択します。

トリガー メソッドで送信される必須フィールド

カスタマイズしたフィールドの Apex Trigger 関数を設定する

BMC Remedyforce で、カスタマーは新しいフィールドを作成して、インシデントでそれらのフィールドを使用できます。Jira Service Management アラートでカスタム フィールドを使用する必要がある場合は、Apex 関数をカスタマイズする必要があります。Apex トリガー関数には、編集できるカスタム フィールドが 10 個あります。これらのフィールドは定義されていますが、初期化されていません。カスタマイズしたフィールドは、次の手順で送信できます。

• 設定ページの左側で [ 作成] -> [オブジェクト] に移動します。

• [カスタムオブジェクト] リストで [インシデント] をクリックします。

• [カスタム フィールドと関係] リストで送信する必要があるフィールドを見つけ、指定されたフィールド名を [API 名] 列にメモします。

• Apex トリガー関数に移動して、まだ初期化されていないカスタム フィールドを編集します。フィールドを obj.<COPIED_API_NAME> として初期化します。データ タイプが文字列と異なる場合は、データ タイプも変更する必要があります。カスタム フィールドはペイロードに既に追加されています。フィールドを初期化すると、Jira Service Management に送信されます。

• カスタム フィールドを Jira Service Management アラートに追加する必要がある場合は、「Jira Service Management 統合」ページの [詳細設定] に移動して、フィルターまたはアラート設定を更新します。

Jira Service Management から BMC Remedyforce

1. BMC Remedyforce にアラートと更新を送信するために、接続アプリを作成します。OAuth 設定を有効にして接続アプリを作成するには、このページに従います。

2. 接続アプリを作成したら、接続アプリからコンシューマー キーとコンシューマー シークレットをコピーします。

3. コンシューマー キー、カスタマー シークレット、ユーザー名、パスワードの情報を Jira Service Management に追加します。

4. インシデント オブジェクトに新しいカスタム フィールドである jsm-alias を追加します。

1. 設定ページの左側にある オブジェクト マネージャー に移動します。

2. [カスタムオブジェクト] リストで [インシデント] をクリックします。

3. 左側のメニューから [フィールドと関係] を選択して、[新規] をクリックします

4. カスタム フィールドに含まれる情報の種類としてテキストを選択し、[次へ] をクリックします。

5. [フィールド ラベル] に jsm-alias、[長さ] に 255 を入力します。

6. 既定のセキュリティと [ページに追加] レイアウト設定を使用します。[保存して新規作成] を選択します。

トラブルシューティング

Apex アプリから「不正なエンドポイント。[設定] > [セキュリティ] > [リモートサイト設定] をご確認ください」というメッセージを含む開発者スクリプトの例外を受け取った場合は、[セットアップ] > [セキュリティ] > [リモート サイト設定] タブに移動して、[新しいリモート サイト] から https://api.atlassian.com/jsm/ops/integration/v1/json を追加します。