レコードを挿入

UiPath.OracleNetSuite.Activities.InsertRecord

[レコードを挿入] アクティビティは、SOAP のadd 操作を使用して新しいレコード オブジェクトを挿入します。

レコードの挿入後、アクティビティは要求のステータス (成功/失敗情報) を、後続のアクティビティ (例: 条件ロジック) で使用できる Status 型オブジェクト ([NetSuite のステータス]) に出力します。

このアクティビティは、新しいレコード オブジェクトの internalid の値も返します。たとえば、NetSuite の従業員オブジェクトを挿入する場合、オブジェクト ウィザードで String 型変数を追加して、この internalId 値を出力できます (以下の例を参照)。

動作のしくみ

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

1. 「セットアップ」の手順を完了します。
2. プロジェクトに [Oracle NetSuite アプリケーション スコープ] アクティビティを追加します。
3. [Oracle NetSuite アプリケーション スコープ] アクティビティ内に [レコードを挿入] アクティビティを追加します。
4. [レコードを挿入] アクティビティの [設定] ボタンをクリックします (オブジェクト ウィザードが開きます)。
5. 挿入するオブジェクトを選択し、設定するフィールドを (値とともに) 挿入および追加します。
6. [出力] セクションのプロパティのために ResponseStatus 型変数を作成し、入力します。
   • 入力プロパティ値は、追加操作に送信されます。
   • 操作は、ResponseStatus の値を出力プロパティ変数に返します。
     
     

     

     
     

アクティビティの本体

[NetSuite レコードを挿入] のプロパティ値を入力するには、[設定] ボタンをクリックしてオブジェクト ウィザードを使用する必要があります。

詳細については、「ServiceNow について」の「ウィザード」セクションをご覧ください。

• オブジェクトを選択 - 挿入するオブジェクトの種類を入力します。ドロップダウン リストから項目を選択します。
• 内部 ID - 作成する NetSuite レコードの ID です。このフィールドでは String 型の変数のみがサポートされています。
  • 新しいレコードを挿入すると、ServiceNow によって sys_id が自動生成されます。他のアクティビティで使用するためにこの値を取得するには、オブジェクト ウィザードで String 型数を作成して入力します (以下の例を参照)。
  • 詳細については、「セットアップ」ガイドの「[Show Internal IDs] を有効化する」をご覧ください。

プロパティ

共通

• 表示名 - アクティビティの表示名です。 このフィールドでは Strings 型または String 型変数のみがサポートされます。

その他

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

オプション

• レコード - 操作中に設定される追加のフィールド一式を含むレコードです。このレコードは、設定ウィザードで選択したオブジェクトと同じ種類である必要があります。 フィールドが設定ウィザードで設定されている場合、その値でレコードの値が上書きされます。

出力

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