サービスエクスチェンジでの変換の作成

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間:5分
  • プロバイダーまたはコンシューマーは、 サービスエクスチェンジ で変換を作成して、接続されたインスタンス間でタスクを統合します。

    始める前に

    必要なロール:admin

    このタスクについて

    次の手順では、プロバイダーの変換プロセスについて説明します。コンシューマーは次の場所に移動できます すべて > サービスエクスチェンジ コンシューマー > 変換 と同じプロセスに従います。

    手順

    1. 移動先 すべて > サービスエクスチェンジ プロバイダー > アドミニストレーション > 変換.
    2. [New] をクリックします。
    3. フォームで、フィールドに入力します。
      表 : 1. フォームを変換
      フィールド 説明
      番号 変換レコードの自動生成番号。
      会社 この変換が適用されるコンシューマー名。
      すべての会社

      これを選択すると、同じ会社レベルの変換を持つ会社を除くすべての会社に対して変換が実行されます。

      このフィールドを使用して、すべての会社に適用できるデフォルトの変換定義を作成します。[すべての会社] フィールドでは、要件が類似している場合でも、各顧客アカウントに特定の変換を定義する必要がなくなります。デフォルトの定義を使用して、すべての会社の特定のフィールドを同時に変換できます。

      グローバル変換は、構成に一致し、特定の変換がまだ定義されていない会社にのみ適用されます。同じ構成の会社固有の変換が既に存在する場合、これによりグローバル変換が上書きされます。

      タイプ
      • シンプル:各インスタンスでフィールドに既知の安定した選択リストがある場合に使用されます。受信値と送信値に一致するように、変換ラインの関連リストが作成されます。
      • 詳細:新しい値を決定するためにスクリプトを必要とする複雑な基準に使用されます。
      • 仮想受信:仮想受信フィールドを変換するために使用されます。新しい値を判別するためのスクリプトが必要です。
      • 仮想送信:仮想送信フィールドを変換するために使用されます。新しい値を判別するためのスクリプトが必要です。
      インバウンド この変換の受信変換を有効にするオプション。このオプションは、[タイプ] で [シンプル] または [詳細] を選択した場合にのみ使用できます。
      アウトバウンド この変換の送信変換を有効にするオプション。このオプションは、[タイプ] で [シンプル] または [詳細] を選択した場合にのみ使用できます。
      プロバイダーテーブル プロバイダーのタスクテーブルを指定するオプション。例:ケース。
      コンシューマーテーブル コンシューマーのタスクテーブルを指定するオプション。たとえば、[インシデント] です。
      プロバイダーフィールド プロバイダーのフィールドを指定するオプション。たとえば、State などです。このフィールドは、[タイプ] で [シンプル] または [詳細] を選択した場合にのみ使用できます。
      コンシューマーフィールド コンシューマーのフィールドを指定するオプション。たとえば、 State などです。このフィールドは、[タイプ] で [シンプル] または [詳細] を選択した場合にのみ使用できます。
      仮想フィールド [タイプ] フィールドが [仮想受信 ] または [仮想送信] に設定されている場合、このフィールドは、この変換が入力する仮想フィールドを参照するために使用できます。
    4. [Save (保存)] をクリックします。
    5. 次のいずれかを選択します。
      1. シンプル: [ラインの変換] 関連リストで [新規 ] をクリックし、フォームのフィールドに入力します。
        表 : 2. [ラインの変換] フォーム
        フィールド 説明
        プロバイダーラベル プロバイダーの選択肢ラベルを指定するオプション。たとえば、オープンです。
        プロバイダー値 プロバイダーの選択値を指定するオプション。例:10。
        顧客ラベル 顧客の選択ラベルを指定するオプション。たとえば、進捗状況です。
        顧客価値 顧客の選択値を指定するオプション。例では 2。
        注:
        変換マッピング支援機能を使用して、プロバイダーテーブルとコンシューマーテーブル間の変換マッピングを自動的に生成できます。詳細については、「Automate transforms with Now Assist for TMT」を参照してください。
      2. 詳細:次の例に示すように、スクリプトを使用して送信と受信のラベルと値を定義します。
        output.value=input.value;
        output.label=input.label;
        
        var ci=new GlideRecord('cmdb_ci');
        
        if(direction=='inbound'){
           if(ci.get('correlation_id',input.value)){
              output.value=ci.sys_id+";
              output.label=ci.getDisplayValue();
              }
        }
        if (direction=='outbound'){
          if(ci.get(input.value)){
             if(ci.correlation_id){
                output.value=ci.correlation_id+";
                output.label=input.label;
               }
            }
        }
              
        
      3. 仮想受信:次の例に示すように、スクリプトを使用して受信ラベルと値を決定します。
        var inputArr = input.value.split(',');
        var outputValues = [];
        var outputLabels = [];
        for (i in inputArr) {
            getInstanceID(inputArr[i]);
        }
        output.value = outputValues+'';
        output.label = outputLabels+'';
        
        function getInstanceID(name) {
            var gr = new GlideRecord('cmdb_ci_server');
            if (gr.get('name', name)) {
                outputValues.push(gr.sys_id+'');
                outputLabels.push(name);
            }
        }
      4. 仮想送信:次の例に示すように、スクリプトを使用して送信ラベルと値を決定します。
        /*
         ** The 'input' object contains the original value and label
         ** 'direction' contains an 'inbound' or 'outbound' value to determine transform direction
         ** 'object_data' contains the Remote Task GlideRecord
         ** It is required to set the variables 'output.value' and 'output.label' with your script.
         */
        output.value = 'condev,conprod';
        output.label = 'condev,conprod';
    6. [Submit (送信)] を選択します。
    7. 変換フォームで、[ アクティブ化] をクリックします。

    タスクの結果

    ServiceNow®インスタンスに変換レコードが作成されます。変換に一致するリモートタスクの受信または送信フィールドは、それらを自動的に使用されます。詳細については、「プロバイダー向け サービスエクスチェンジ でのリモートタスク定義の作成」を参照してください。