DevOps 変更ワークスペースからのツール統合の作成

DevOps 変更 ワークスペースからツール統合を作成して、DevOps 変更速度 アプリケーションでデフォルトで利用できない追加のオーケストレーション、計画、およびコーディングツールを統合します。

始める前に

DevOps 変更速度の開始で指定されたタスクを完了します。

必要なロール:sn_devops.admin または sn_devops.tool_owner

アプリケーションスコープをカスタムアプリケーションに設定します。

このタスクについて

DevOps Change Workspace からツール統合を作成する方法については、このビデオをご覧ください。

手順

1. 移動先 ワークスペース > DevOps 変更ワークスペース.
2. DevOps ワークスペースで、次に移動します: アドミニストレーション > 統合 > ツール統合.
3. [New (新規)] を選択します。
   または、既存のツール統合レコードを開き、[ 編集 ] を選択することもできます (ベースシステムでサポートされていないカスタムツール統合の場合)。

   注:

   ベースシステムでサポートされていない計画立案ツールの場合は、ツール統合レコードで [ 編集 ] を選択して変換ステップに移動し、そこでフィールドを追加できます。ベースシステムでサポートされている計画立案ツールの場合は、[ フィールドマッピングの編集] を選択してフィールドを追加できます。サポートされている計画立案ツールのフィールドの追加については、「 計画立案ツール統合のカスタムフィールドの追加」を参照してください。
   [詳細] ステップが表示されます。
4. [ツールの詳細] ステップで、次のように入力します。

   表 : 1. 詳細ステップのフィールド

   フィールド	説明
   ツールラベル	ツール統合の名前。
   統合バージョン	ツール統合の API バージョン。

   
5. オプション: [+ ファイルの追加] を選択して、ツールのロゴの画像を追加します。
6. [ツールタイプの機能] セクションの [ 機能 ] フィールドで、ツールがサポートする機能を選択します。

   機能	説明
   オーケストレーション	ソフトウェア開発ライフサイクルにおける複雑なプロセスの実行を自動化および調整するツール。
   計画	ソフトウェア開発ライフサイクルの計画と管理に役立つツール。
   コード	プログラマーがコードを記述、編集、および管理するのに役立つツール。

   注:

   ツールは、複数のツールタイプの機能にマッピングできます。オーケストレーション、計画、およびコード機能では、ツール統合がサポートされています。
7. [Next (次へ)] をクリックします。
   ツール統合レコードが作成されます。
8. [アクション] ステップで、前のステップで選択したツール機能に必要なアクションを選択します。
   注:

   ツール機能アクションは、DevOps データモデルがツール統合と通信してデータをインポートできるようにするプロセスを定義します。各ツールタイプの機能には、独自のアクションセットが必要です。
9. [Next (次へ)] をクリックします。
   選択したアクションの統合機能レコードがデフォルト値で作成されます。
10. 構成ステップで、 フィールドの追加 を選択して、ツールに必要な構成を追加します。
    ここで構成されたフィールドは、ツールをオンボーディングするたびにプレイブックのパラメーターとして表示されます。
11. 次のフィールドに入力します。

    表 : 2. 構成

    フィールド	説明
    フィールド名	構成の名前
    順序	この構成が処理される順序。
    ラベル	構成のラベル。
    必須	true とマークすると、このツール統合のインスタンスを接続するときに接続の詳細として表示されます。
    フィールドタイプ	フィールドのタイプ (文字列またはパスワード)
    デフォルト値	この構成のデフォルト値。
    ヘルプテキスト	この構成が必須の場合、このツールのインスタンスを接続すると、接続の詳細のこのフィールドにヘルプテキストが表示されます。

12. [Next (次へ)] をクリックします。
    追加フィールドのツール統合設定レコードが作成されます。
13. 変換ステップで、各ツール機能アクションの変換を確認し、カスタムフィールドをツール統合に追加します。
    汎用変換スクリプトは、各ツールアクションに用意されています。トランスフォーマーベースのマッピングを呼び出す汎用スクリプトを拡張したり、レコードトランスフォーマーを作成して手動でフィールドにマップしたりすることができます。拡張するには、DevOpsGenericIntegrationHandlerSNC クラスを拡張して新しいスクリプトを作成し、必要なメソッドを上書きし、この新しく作成されたスクリプトを変換スクリプトで使用します。
    • 汎用スクリプトを使用する場合は、[ リソースパス ] フィールドにリソースパス API エンドポイントを入力します。
    • まだ使用できない場合は、[ レコードトランスフォーマーを作成] を選択して各機能の通知、検出、インポートアクションのレコードトランスフォーマーを作成し、レコードトランスフォーマールールを追加して、ツールのフィールドを DevOps データモデルのフィールドにマッピングします。レコードトランスフォーマーを作成してフィールドに手動でマッピングする方法については、「 計画立案ツール統合のカスタムフィールドの追加」を参照してください。
14. [次のステップ] では、プレイブックエクスペリエンスを介してツールのインスタンスに接続してツール統合を検証できます。また、ツール統合レコードを表示することもできます。
    注:

    [ツールに接続] ボタンを選択すると、接続可能なツールのリストに新しく作成されたツール統合が表示されます。

次のタスク

トークンを使用して受信イベントを DevOps 変更速度管理に送信するための Webhook の作成

• トークンを使用して受信イベントを DevOps 変更速度管理に送信するための Webhook の作成
  トークンベースの認証を使用して DevOps 変更速度管理に受信イベントを送信する Webhook を作成する必要があります。