DevOpsツール統合の作成

DevOps ツール統合を作成するために、統合開発者は、 DevOps ツール統合設定と、ソースツールからデータを収集して変換するための ワークフロースタジオ サブフローを構成します。次に、 DevOps アドミニストレーターが DevOps ツール接続を構成します。

始める前に

注:

統合をスコープ対象アプリとして作成する場合、システムアドミニストレーターはこれらのロールを統合開発者にアサインして、統合開発者が特定のスコープのツール統合と統合機能レコードを作成できるようにする必要があります。

• スコープ対象アプリの開発者ロール
• DevOps admin ロール

必要なロール:sn_devops.admin

このタスクについて

DevOpsツール統合手順を作成するには、統合開発者とDevOpsアドミンの両方が構成する必要があります。

• 統合開発者は、 DevOpsでツール統合レコード、 ワークフロースタジオ サブフロー、ツール機能マッピング、および統合機能レコードを DevOps で作成して、機能とアクションをマッピングします。
  注:

  通知、接続、および検出機能がサポートされています。
• DevOpsアドミンは、DevOps 接続 (計画またはコーディングツール) を設定し、Webhook と認証情報を使用してソースツールを構成します。

この手順では、 DevOps ツール統合を作成するための詳細なステップを示します。

手順

1. 統合開発者:
   ソースツールの統合機能とアクション、およびサブフローを構成します。
   1. 次のように移動する。 DevOps > 統合 > ツール統合 をクリックし、統合するツール (ソースツール) を定義するレコードを作成します。
      注:

      DevOps アプリケーションで提供されているツール統合レコードは編集しないでください。

      表 : 1. DevOps ツール統合

      ツールラベル	サンプルコードツール
      テーブル	コードツール [sn_devops_tool]
      パッケージ化可能な統合を使用する	選択済み
      統合バージョン	1.0
      アクティブ	選択済み

   2. 次のように移動する。 Flow Designer > デザイナー をクリックし、統合するツール (ソースツール) からデータを収集して変換するための サブフローを作成します 。
      注:

      [ 別のユーザーとして実行 ] フィールドを [システムユーザー] に設定し、[ 入力 ラベル] を [現在の変数] に設定する必要があります。

      表 : 2. 通知サブフローのプロパティ

      [Name (名前)]	コードツール通知
      アプリケーション	サンプル統合アプリ
      アクセス可能	「All application scopes (すべてのアプリケーションスコープ)」
      説明	統合アプリ用のコードツール
      実行方法	システムユーザー

      サブフローには、API 呼び出しによる詳細データの取得や元のペイロードの変換が含まれている必要があります。変換されたペイロードを受信イベントレコードにコピーします。

      注:

      DevOps メインフローを編集しないでください。
   3. 次のように移動する。 DevOps > 統合 > ツール機能のマッピング をクリックし、ツール統合レコードをツールタイプ機能にマッピングするレコードを作成します。

      表 : 3. DevOps ツール機能のマッピング

      ツール統合	サンプルツール
      ツールタイプの機能	コード

   4. 次のように移動する。 DevOps > 統合 > 統合機能 をクリックし、ツール機能マッピングのアクションを指定するレコードを作成します。
      注:

      DevOps アプリケーションで提供される統合機能レコードは編集しないでください。

      表 : 4. DevOps 統合機能

      ツール統合	サンプルコードツール
      機能マッピング	サンプルコード ツールコード 注: ツールタイプの機能レコードは編集しないでください。
      アクション	通知 注: ツールアクションレコードを編集しないでください。
      アクティブ	選択済み
      タイムアウト (ミリ秒)	対応するサブフローのタイムアウト。サブフローの実行がこの値を超えると、タイムアウト例外が発生します。 値はミリ秒 (ms) 単位です。デフォルトは 45,000 (45 秒) です。
      サブフロー名	x_snc_sample_integ.code_tool_notification 名前には、実際のサブフロー名の前に、スコープ名とドット (.) がプリフィックスとして付きます。 たとえば、次のようになります。 connect_code_tool サブフロー my_app_scope スコープ このフィールドの値は my_app_scope.connect_code_tool です。 注: 通知機能の [サブフロー名 ] フィールドを空白のままにすると、通知のデフォルト処理が行われます。 「通知ツールの機能アクション」を参照してください。
      ドメイン	グローバル

2. DevOps 管理者：

   DevOps からソースツールへの接続を構成します。

   1. ツールレコードには次のものが含まれている必要があります。
      • 統合開発者が作成したツール統合レコードへの参照 ( [ツール ] フィールド内)
      • ツールラベル
      • 接続エイリアス (接続と資格情報)
   2. DevOps計画立案ツールで作成された通知 (Webhook) を通知エンドポイントのソースツールサービスフックにコピーし、認証情報を devops.integration.user に設定します。
   [受信イベント] リスト (DevOps > アドミニストレーション > 受信イベント) を開きます。

   オブジェクトが DevOps Core テーブルに挿入されると、受信イベントレコードのステータスは [処理済み ] に設定されます。イベント状況には、[新規]、[処理中]、[処理済み]、[不一致]、および [エラー] があります。

3. ツール統合レコードとサブフローが別のスコープで作成されている場合、 DevOps アドミンは、2 つの新しいクロススコープ権限レコードを作成して、アプリが受信イベントテーブルにアクセスできるようにする必要があります。
   次のように移動する。 システムアプリケーション > アプリケーションのクロススコープアクセス また、読み取りと書き込みのクロススコープ権限レコードを作成して、アプリが受信イベントテーブルにアクセスできるようにします。

   フィールド	読み取り	書き込み
   ソーススコープ	現在のアプリケーションに基づいて自動入力されます
   ターゲットスコープ	DevOps
   ターゲット名	sn_devops_inbound_event
   ターゲットタイプ	テーブル
   操作	読み取り	書き込み
   ステータス	許可

例

図 : 1. DevOps ツール統合

図 : 2. ワークフロースタジオ サブフローのプロパティ

図 : 3. ワークフロースタジオ サブフロー

図 : 4. ワークフロースタジオ DevOps 統合:通知フロー

図 : 5. DevOps ツール機能のマッピング

図 : 6. 統合機能

図 : 7. 計画立案ツール

図 : 8. クロススコープアクセスレコード (読み取りと書き込み)