インポート セット経由でレコードを挿入

UiPath.ServiceNow.Activities.InsertImportSetRecords

[インポート セット経由でレコードを挿入] アクティビティでは、ServiceNow の Import Set - GET API を使用して既存のレコードを更新したり、新しいレコードを挿入したりします。

操作が完了すると、このアクティビティは、挿入結果を持つ DataTable 型オブジェクト ([結果]) と、オブジェクトの操作ステータス (成功/失敗情報) を持つ ResponseStatus 型オブジェクト ([ServiceNow のステータス]) を出力します。これらの出力は後続のアクティビティ (条件付きロジックなど) で使用できます。

ヒント:

このアクティビティ パッケージはレコードを更新または挿入する方法として、[ServiceNow レコードを更新]、[ServiceNow レコードを挿入]、[レコードを更新または挿入]、[インポート セット経由でレコードを挿入] の 4 つのアクティビティを提供します。

[ServiceNow レコードを更新] アクティビティ、[ServiceNow レコードを挿入] アクティビティ、[レコードを更新または挿入] アクティビティでは、REST API を使用して運用環境のテーブルに直接書き込みます。[インポート セット経由でレコードを挿入] アクティビティでは、REST Import Set API を使用してインポート セット テーブルに書き込み、そこから対象の運用環境のテーブルにデータが変換されます。

運用環境のテーブルに直接書き込まないように、[インポート セット経由でレコードを挿入] アクティビティを使用して、レコードを更新または新しいレコードを挿入することをお勧めします。

インポート セットのパフォーマンスのトラブルシューティングなどの詳細については、ServiceNow ドキュメントの「Import sets」をご覧ください。

インポート セットの使用について詳しくは、ServiceNow ドキュメントの「Web service import set」と「Importing data using import sets」をご覧ください。

動作のしくみ

以下の手順とメッセージ シーケンス ダイアグラムは、設計時 (つまり、アクティビティの依存関係と入/出力プロパティ) から実行時に至るまでの、アクティビティの動作のしくみの例を示したものです。

1. 「セットアップ」の手順を完了します。
2. [ServiceNow アプリケーション スコープ] アクティビティをプロジェクトに追加します。
3. [ServiceNow アプリケーション スコープ] アクティビティ内に [インポート セット経由でレコードを挿入] アクティビティを追加します。
4. [インポート セット経由でレコードを挿入] アクティビティの [設定] ボタンをクリックします (オブジェクト ウィザードが開きます)。
5. インポート セットに使用するオブジェクトを選択し、[入力] セクションのプロパティを入力します。
6. [出力] セクションのプロパティのために DataTable 型変数および ResponseStatus 型変数を作成し、入力します。
   • 入力プロパティ値は、Import Set - GET API に渡されます。

   • API は、出力プロパティ変数に `DataTable` と `ResponseStatus` の値を返します。

     
     

     

     
     

アクティビティの本体

インポート セットを選択するには、[ 設定 ] ボタンをクリックして オブジェクト ウィザード を使用する必要があります。

• オブジェクト - 使用するインポート セットです。オブジェクト ウィザードを使用して、インポート セットを選択します。オブジェクト ウィザードのドロップダウン リストには、ServiceNow アプリケーションに存在するインポート セットが含まれています。

プロパティ

注: [複数フィールドを追加] オプションを見ても選択したオブジェクトのプロパティのリストが表示されない場合は、ServiceNow でオブジェクトのメタ データを表示してデータを変更するための十分な権限を持っていない可能性があります。詳細については、「トラブルシューティング」をご覧ください。

共通

• 表示名 - アクティビティの表示名です。 String または String 型変数を入力します。

入力

• データテーブル - 挿入するデータです。 DataTable 型変数を入力します。

その他

• プライベート - オンにした場合、変数および引数の値が Verbose レベルでログに出力されなくなります。

出力

• 結果 - 挿入の結果データです。DataTable 型変数を入力します。
• ステータス - 要求のステータスです (成功/失敗に関する情報)。ResponseStatus 型変数を入力します (UiPath.BAF.Models.ResponseStatus)。ResponseStatus オブジェクトには、他のアクティビティで使用できる 3 つのプロパティが含まれています。
  • Success - Boolean - API 要求が成功したかどうかを示します。
  • ErrorCode - String - API 要求が成功しなかった場合の応答エラーです (Success=False)。
  • Message - String - エラー メッセージです。