Jira Service Management の管理者向けの利用開始ガイド
最初に、Jira Service Management の使用を開始する方法を確認します。
BMC Remedyforce と統合する
この記事では、Jira Service Management Cloud の一部のお客様に段階的に展開されている、Jira Service Management でネイティブに利用できる新しいアラート機能を取り上げています。ご利用のサイトにはまだ表示されていないか、利用できない可能性があります。
統合でできるようになること
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 の Free プランまたは Standard プランを使用している場合は、この統合はチームの運用ページからのみ追加できます。Settings (歯車のアイコン) > Products ([Jira 設定] の下) > OPERATIONS からこの機能にアクセスするには、Premium プランまたは Enterprise プランが必要です。
統合をチームの運用ページから追加すると、そのチームが統合の所有者になります。つまり、Jira Service Management は、この統合を通じて受信したアラートをチームにのみ割り当てます。
Jira Service Management で BMC Remedyforce インテグレーションを追加するには、次の手順を実行します。
チームの運用ページに移動します。
左側のナビゲーション パネルで、[統合]、[統合を追加] の順に選択します。
検索を実行して「BMC Remedyforce」を選択します。
次の画面で、統合の名前を入力します。
オプション: 特定のチームが統合からのアラートを受信するようにする場合は、[Assignee team (担当者チーム)] のチームを選択します。
[続行] を選択します。
この時点で、統合が保存されます。[統合を設定する手順] セクションを展開して、API キーをコピーします。
後で BMC Remedyforce でインテグレーションを設定するときにこのキーを使用します。[統合をオンにする] を選択します。
統合のために作成したルールは、統合をオンにした場合にのみ機能します。
BMC Remedyforce でインテグレーションを設定する
BMC Remedyforce とのインテグレーションでは、Jira Service Management へのインシデントの転送がサポートされています。これを設定するには、次の手順を実行します。
BMC Remedyforce で BMC Remedyforce の設定ページに移動します。
jsmClass.apxc を開いて、内容をコピーします。
「セットアップ」ページに内容を貼り付けます。
[保存] を選択します。
[作成] > [オブジェクト] の順に移動します。
[カスタム オブジェクト] リストで [インシデント] を選択します。
[トリガー] リストの上部にある [新規] を選択します。
「BMC Remedyforce セットアップ」ページに移動します。
jsmTrigger.apxt を開いて、内容をコピーします。
先ほど Jira Service Management からコピーした API キーをトリガー関数の apiKey に貼り付けます。
[保存] を選択します。
トリガー メソッドで送信される必須フィールド
簡易モードで統合を追加した (詳細な統合の設定を編集していない) 場合、次のフィールドは必須です。
ID
shortDescription
impactId
statusId
CategoryID
priorityId
重大度
name
ownerId
statusChangeDate
ID
clientName
urgencyId
incidentResolution
設定でパラメータとして与えられるフィールドは必須です。BMC Remedy Force システムで使用されていないフィールドがある場合は、Apex トリガー関数でこれらのフィールドを削除する必要があります。また、これらのフィールドを統合設定のパラメータとして指定しないでください。
カスタマイズしたフィールドの 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 に追加します。
パスワード
Jira Service Management に入力するパスワードは、Salesforce のログイン パスワードとアカウントのセキュリティ トークンを連結したものです。つまり、パスワードが ABC であり、セキュリティ トークンが XYZ である場合は、ABCXYZ と入力します。セキュリティ トークンを持っていない場合は、[設定] > [個人情報] > [セキュリティ トークンをリセット] の順に移動します。新しいセキュリティ トークンがメールで送信されます。
4. インシデント オブジェクトに新しいカスタム フィールドである jsm-alias を追加します。
設定ページの左側にある オブジェクト マネージャー に移動します。
[カスタムオブジェクト] リストで [インシデント] をクリックします。
左側のメニューから [フィールドと関係] を選択して、[新規] をクリックします
カスタム フィールドに含まれる情報の種類としてテキストを選択し、[次へ] をクリックします。
[フィールド ラベル] に jsm-alias、[長さ] に 255 を入力します。
既定のセキュリティと [ページに追加] レイアウト設定を使用します。[保存して新規作成] を選択します。
すでに古い統合があり、これから双方向に変換しようとしている場合は、Apex トリガー コードを更新します。
トラブルシューティング
Apex アプリから「不正なエンドポイント。[設定] > [セキュリティ] > [リモートサイト設定] をご確認ください」というメッセージを含む開発者スクリプトの例外を受け取った場合は、[セットアップ] > [セキュリティ] > [リモート サイト設定] タブに移動して、[新しいリモート サイト] から https://api.atlassian.com/jsm/ops/integration/v1/json を追加します。
この内容はお役に立ちましたか?