レコードを更新

UiPath.MicrosoftDynamics.Activities.UpdateRecord

[レコードを更新] アクティビティは Web API の PATCH 操作を使用してレコードを更新します。

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

動作のしくみ

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

「セットアップ」の手順を完了します。
プロジェクトに [Microsoft Dynamics アプリケーションスコープ] アクティビティを追加します。
レコード識別子を出力するアクティビティを追加するか外部プロセスを実行します (例: [レコードを挿入]、[レコードを検索])。
[ Microsoft Dynamics アプリケーションスコープ] アクティビティ内に [ レコードを更新 ] アクティビティを追加します。
[レコードを更新] アクティビティの [設定] ボタンをクリックします (オブジェクトウィザードが開きます)。
更新する オブジェクト を選択し、レコード識別子を入力して、更新するフィールドを (値とともに) 追加します。
[出力 ] セクションのプロパティのために ResponseStatus 型変数を作成し、入力します。
- 入力プロパティ値は、PATCH 操作の要求に渡されます。
- この操作により、ResponseStatus と値が出力プロパティ変数に返されます。

以下のプロパティの値は、このアクティビティを UiPath Studio でプロジェクトに追加するときに指定します。

設定

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

オブジェクトウィザードを使用してオブジェクトを選択すると、更新するフィールドを追加できます。各オブジェクトで使用できるフィールドのリストは、Microsoft ドキュメントの「Web API EntityType Reference」をご覧ください。

オブジェクトウィザードの詳細については、「ビジネスアクティビティのフレームワーク」のページをご覧ください。

Advanced (カスタム)

追加フィールド - 挿入する列と値を含む DataRow です。 DataRow 型変数を入力します。
- DataRow の列名を判断/検証するには、[設定] ボタンをクリックしてオブジェクトを選択し、[フィールド] 列に表示される名前を確認します。DataRow の列名は、表示される名前に一致している必要があります。
- オブジェクトウィザードと [追加フィールド] プロパティの両方でフィールドの値を入力した場合、オブジェクトウィザードに入力した値が優先されます ([追加フィールド] の値は上書きされます)。

共通

その他

出力

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