BMC FootPrints v12 と統合する

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

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

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

統合による機能

BMC FootPrints v12 でインシデントが作成されると、Jira Service Management でアラートが作成されます。
BMC FootPrints v12 でインシデントが更新されると、Jira Service Management でアラートにメモが追加されます。
BMC FootPrints v12 でインシデントが解決されると、Jira Service Management でアラートがクローズされます。
BMC FootPrints v12 で問題が作成されると、Jira Service Management でアラートが作成されます。
BMC FootPrints v12 で問題が更新されると、Jira Service Management でアラートにメモが追加されます。
BMC FootPrints v12 で問題が解決されると、Jira Service Management でアラートがクローズされます。
Jira Service Management でアラートが作成されると、BMC FootPrints v12 でインシデントまたは問題が作成されます。
Jira Service Management でアラートにメモが追加されると、BMC FootPrints v12 でインシデントまたは問題が更新されます。
Jira Service Management でアラートの優先順位が変更されると、インシデントまたは問題の優先順位が BMC FootPrints v12 で更新されます。
Jira Service Management でアラートがクローズされると、BMC FootPrints v12 でインシデントまたは問題が解決されます。

統合をセットアップする

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

Jira Service Management で BMC FootPrints v12 インテグレーションを追加する
BMC FootPrints v12 でインテグレーションを設定する

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

Jira Service Management の Free プランまたは Standard プランを使用している場合は、この統合はチームの運用ページからのみ追加できます。Settings (歯車のアイコン) > Products ([Jira 設定] の下) > OPERATIONS からこの機能にアクセスするには、Premium プランまたは Enterprise プランが必要です。

統合をチームの運用ページから追加すると、そのチームが統合の所有者になります。つまり、Jira Service Management は、この統合を通じて受信したアラートをチームにのみ割り当てます。

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

チームの運用ページに移動します。
左側のナビゲーションパネルで、[統合]、[統合を追加] の順に選択します。
検索を実行して「BMC FootPrints v12」を選択します。
次の画面で、統合の名前を入力します。
オプション: 特定のチームが統合からのアラートを受信するようにする場合は、[Assignee team (担当者チーム)] のチームを選択します。
[続行] を選択します。
この時点で、統合が保存されます。
[統合を設定する手順] セクションを展開して、API キーをコピーします。
後で BMC FootPrints v12 でインテグレーションを設定する際にこのキーを使用します。
[統合をオンにする] を選択します。
統合のために作成したルールは、統合をオンにした場合にのみ機能します。

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

BMC FootPrints v12 と Jira Service Management のインテグレーションを設定するには、次の手順を実行します。

BMC FootPrints v12 で [管理] タブに移動します。
[ワークスペース] > [Service Desk workspace (サービスデスクワークスペース)] を選択します。
インシデント レコード定義と問題レコード定義のいずれかまたは両方について、以下のステップを繰り返します。
1. レコード定義を 2 回選択すると、その詳細が表示されます。
2. 左側のメニューにある [フィールド] を選択します。
3. [追加]、[フィールドを追加] の順に選択します。
4. 名前には「JSM Alert Alias」と入力します。
  Jira Service Management では API からフィールドにアクセスするためにこの名前を使用するため、指定されているものとまったく同じ名前を使用してください。
5. [フィールドタイプ] で [Simple Text (シンプルテキスト)] を選択します。
6. [権限] で [非表示] を選択します。
7. [保存] を選択します。
8. [Input Size (入力サイズ)] として [Medium (中)] を選択します。
9. [Length (長さ)] として [No Restriction (無制限)] を選択します。
10. [保存] を選択します。
11. レコード定義に戻り、[Business Rules (ビジネスルール)] を選択します。
12. [New Business Rule (新しいビジネスルール)] > [After Save Rule (ルールの保存後)] を選択します。
13. [Business Rule Name (ビジネスルール名)] に「Send to JSM」と入力します。
14. [Run Any Time for the Business Rule Schedule (ビジネスルールスケジュールでいつでも実行)] を選択します。
15. [Add New Trigger (新しいトリガーを追加)] を選択します。
16. トリガーに [After Save (保存後)] を選択します。
17. [On Create (作成時)] と [On Update by User (ユーザーによる更新時)] の両方を選択します。
18. [作成]、[Add New Action (新しいアクションの追加)] の順に選択します。
19. アクションの [Execute external action (外部アクションの実行)] を選択します。
  - Linux ディストリビューションを使用している場合、次の手順に従います。
    - [インシデント] ワークスペースでテキストボックスに /usr/bin/send2jsm -incidentNumber [incident_number] を貼り付けます。
    - [問題] ワークスペースでテキストボックスに /usr/bin/send2jsm -problemNumber [problem_number] を貼り付けます。
  - Windows をお使いの場合:
    - [インシデント] ワークスペースでテキストボックスに C:\jsm-integration\scripts\send2jsm.exe -incidentNumber [incident_number] を貼り付けます。
    - [問題] ワークスペースでテキストボックスに C:\jsm-integration\scripts\send2jsm.exe -problemNumber [problem_number] を貼り付けます。
20. [作成] を選択します。
[保存] を選択してビジネスルールを保存します。
サービスデスクワークスペースに戻り、[Save and Publish (保存して公開)] を選択します。

JEC 経由で統合する

または、Jira Service Management の JEC と BMC FootPrints v12 スクリプトを使用して、BMC FootPrints v12 でアクションを実行します。これによって、独自のスクリプトや機能をデプロイして提供された機能を変更し、カスタマイズしたアクションを BMC FootPrints v12 上で実行できます。BMC FootPrints v12 インテグレーションパッケージを使用するには、ステップを最後まで実行します。

JEC をダウンロードする

BMC FootPrints v12 パッケージの最新バージョンをダウンロードします。

JEC をインストールする

JEC パッケージを含むインテグレーション zip ファイルをディレクトリ内に解凍します (C:\jsm が推奨パス)。便宜上、この解凍パスを %JEC_HOME% と呼びます。解凍場所の値で JEC_HOME というシステム環境変数を作成できます。これを行うには、昇格した Powershell セッションを開き、次のコマンドを入力します。

powershell

[Environment]::SetEnvironmentVariable("JEC_HOME", <Path you extracted JEC package>, 'Machine')

この機能を使用するには、インテグレーション設定ページで [Select Create BMC FootPrints v12 Incidents/Problems for Jira Service Management alert (Jira Service Management アラート用に FootPrints v12 のインシデント/問題を選択)] を選択します。

JEC 用の BMC FootPrints v12 インテグレーションを設定する

BMC FootPrints v12 インテグレーションに JEC ユーティリティを使用するには、インテグレーション設定を編集して Authenticate with Jira Edge Connector only (Jira Edge Connector のみで認証)] を選択します。
BMC FootPrints v12 に関するその他の設定は、インテグレーション設定ページまたは JEC 設定ファイルを使用して実行できます。インテグレーションページの設定は設定ファイルより優先されます。

JEC を設定する

BMC FootPrints v12 でアクションを実行するために、JEC ではパス %JEC_HOME%\conf\config.json にある設定ファイルから設定パラメーターを取得します。

設定パラメーター

apiKey — 上記で作成した BMC FootPrints v12 インテグレーションから API キーをコピーします。
url — BMC FootPrints v12 インスタンスの URL。
username — 認証用の BMC FootPrints v12 ユーザーのユーザー名。
password — 認証用の BMC FootPrints v12 ユーザーのパスワード。
incidentWorkspaceId – BMC FootPrints v12 内のインシデントワークスペースの ID (例 6)。
problemWorkspaceId – BMC FootPrints v12 の問題ワークスペースの ID (例: 7)。

ダウンロードしたパッケージには、パス %JEC_HOME%\jecService64.exe にある JEC 実行可能ファイル、およびパス %JEC_HOME%\scripts\actionExecutor.py にある、JEC で実行する必要があるスクリプトも含まれています。JEC の設定が完了したら、JEC を実行する必要があります。JEC の実行方法についてはこちらをご確認ください。

JEC に送信されるパラメーターの例

JSON

{
    "type": "bmcFootPrintsV12",
    "alertId": "ccec1231-9cbf-468c-a6ce-c52a18712404",
    "customerId": "c32f2305-f7ad-4fed-8d85-2f3cae411983",
    "action": "Create",
    "mappedActionV2": {
        "name": "createIncident",
        "extraField": ""
    },
    "integrationId": "5769475e-ddc6-4978-812e-50ed2aab9a5b",
    "integrationName": "BMCFootPrints v12",
    "integrationType": "BMCFootPrintsV12",
    "sendViaOEC": true,
    "url": "",
    "username": "",
    "password": "",
    "workspaceName": "",
    "shortDescription": "Test message.",
    "priority": "P3",
    "description": "[JSM] Test description."
}

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

正確ではなかった

明確ではなかった

関係なかった

Jira Service Management サポート