- 概要
- Adobe Sign
- Alteryx
- Amazon Comprehend
- Amazon Connect
- Amazon Rekognition
- Amazon Textract
- Box
- コグニティブ
- DocuSign
- リリース ノート
- DocuSign アクティビティ パッケージについて
- プロジェクトの対応 OS
- セットアップ
- DocuSign スコープ
- DocuSign 操作を呼び出し
- Create Envelope
- Create Envelope And Send
- Create Envelope From Template
- エンベロープの受信者を作成
- ドキュメントを取得 (Get Document)
- ドキュメントを取得
- エンベロープを取得
- フォーム データを取得
- エンベロープを送信
- エンベロープを更新
- 添付ファイルのリストを表示
- カスタム フィールドのリストを表示
- ドキュメントのリストを表示
- List Envelope Status Changes
- 受信者のリストを表示
- 一括送信リストを作成
- 一括送信要求を作成
- 一括送信リストを取得
- 一括送信リストを取得
- テンプレートのカスタム フィールドを作成
- テンプレート受信者を作成
- テンプレートを取得
- テンプレートのリストを表示
- Google Vision
- Jira
- リリース ノート
- Jira アクティビティ パッケージについて
- プロジェクトの対応 OS
- セットアップ
- Jira スコープ
- メソッドを実行
- 添付ファイルを追加
- 添付ファイルを削除
- 添付ファイルをダウンロード
- 添付ファイルを取得
- コメントを追加
- コメントを削除
- コメントを取得
- コンポーネントを作成
- コンポーネントを削除
- コンポーネントを取得
- ダッシュボードを検索
- フィルターを作成
- フィルターを取得
- 課題リンクを作成
- 課題リンクを削除
- 課題リンク タイプを取得
- 課題リンクを取得
- ウォッチャーを追加
- 課題を割り当て
- 課題をクローン
- 課題を作成
- 課題を削除
- 課題を取得
- ウォッチャーを取得
- ウォッチャーを削除
- JQL を使用して課題を検索
- 課題をトランジション
- 課題を更新
- プロジェクトを作成する
- プロジェクトを削除
- プロジェクト タイプを取得
- プロジェクトを取得
- プロジェクトを更新
- トランジションを取得
- ユーザーを作成
- ユーザーを削除
- ユーザーを検索
- Marketo
- Microsoft Dynamics
- Microsoft Dynamics Finance and Operations
- Microsoft Translator
- Microsoft Vision
- Oracle Integration Cloud
- Oracle NetSuite
- Salesforce
- SAP BAPI
- ServiceNow
- Slack
- Smartsheet
- リリース ノート
- Smartsheet アクティビティ パッケージについて
- プロジェクトの対応 OS
- セットアップ
- テクニカル リファレンス
- クイックスタート - 行の操作
- Smartsheet アプリケーション スコープ
- ファイルを添付
- URL を添付 (Attach URL)
- 添付ファイルを削除
- 添付ファイルを取得
- 添付ファイルのリストを表示
- コメントを追加
- コメントを削除
- コメントを取得 (Get Comment)
- List Discussions
- フォルダーをコピー
- フォルダーを作成
- フォルダーを削除
- フォルダーを取得
- フォルダーのリストを表示
- グループ メンバーを追加
- グループを取得
- グループ リストを表示
- グループ メンバーを削除
- レポートを取得
- レポートのリストを表示
- 行を追加
- 行をコピー
- 行でディスカッションを作成
- 行を削除
- 行を取得
- 行のリストを取得 (List Rows
- 行を移動
- 行を更新
- シートをコピー
- シートを作成
- Create Sheet from Template
- シートをダウンロード
- シートを取得
- シートのリストを表示
- シートを更新
- ユーザーを追加
- ユーザーを取得
- List Users
- ユーザーを削除
- WorkSpaceをコピー
- WorkSpace を作成
- リストの WorkSpace
- CSV/XLSX からシートをインポート
- Smartsheet の操作を呼び出し
- 検索アクティビティ
- Send via Email
- オブジェクトを共有
- Success Factors
- Tableau
- Twilio
- Workato
- Workday
レコードを更新または挿入
UiPath.ServiceNow.Activities.UpsertRecords
[レコードを更新または挿入] アクティビティでは、ServiceNow の Batch - POST API を使用して 1 つ以上のレコードを更新または挿入します。
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」をご覧ください。
以下の手順とメッセージ シーケンス ダイアグラムは、設計時 (つまり、アクティビティの依存関係と入/出力プロパティ) から実行時に至るまでの、アクティビティの動作のしくみの例を示したものです。
- 「セットアップ」の手順を完了します。
- [ServiceNow アプリケーション スコープ] アクティビティをプロジェクトに追加します。
- [ ServiceNow アプリケーション スコープ] アクティビティ内に [ レコードを更新または挿入 ] アクティビティを追加します。
- [レコードを更新または挿入] アクティビティの [設定] ボタンをクリックします (オブジェクト ウィザードが開きます)。
- インポート セットに使用するオブジェクトを選択し、[入力] セクションのプロパティを入力します。
-
- 入力したプロパティ値は、Batch - POST API に渡されます。
-
API は、出力プロパティ変数に
DataTable
とResponseStatus
の値を返します。
オブジェクトを選択するには、[設定] ボタンをクリックしてオブジェクト ウィザードを使用する必要があります。
オブジェクト ウィザードの詳細については、「 ビジネス アクティビティのフレームワーク 」のページをご覧ください。
- オブジェクト - 挿入または更新するレコードの型です。 これは、[プロパティ] パネルではなく設計時のキャンバスに設定され、表示されます。 オブジェクト ウィザード を使用して、オブジェクトを選択します。
共通
- 表示名 - アクティビティの表示名です。 このフィールドでは
Strings
型またはString
型変数のみがサポートされます。
入力
-
データテーブル - 挿入または更新するレコード データです。
DataTable
型変数を入力します。- 既存のレコードを更新するには、適用する更新を含むデータ行に sys_id 値を追加します。
- sys_id 値のないデータ行は新しいレコードとして挿入されます (新しいレコードの sys_id は
DataTable
型の Results オブジェクトとして返されます)。 - 1 回のアクティビティの実行で更新または挿入可能なレコードの最大数は 200 です。200 件を超えるレコードを挿入または更新する場合、for ループを追加する、つまり 200 件のレコードを含む
DataTable
に対して [レコードを更新または挿入]アクティビティを 1 つ追加できます (たとえば、レコードの合計が 4,000 件の場合は、レコードを 20 の個別のアクティビティに分割できます)。詳細については、ServiceNow ドキュメントの「Batch API」をご覧ください。
その他
- プライベート - オンにした場合、変数および引数の値が Verbose レベルでログに出力されなくなります。
出力
-
ステータス - 要求のステータスです (成功/失敗に関する情報)。
ResponseStatus
型変数を入力します (UiPath.BAF.Models.ResponseStatus)。ResponseStatus
オブジェクトには、他のアクティビティで使用できる 3 つのプロパティが含まれています。- Success -
Boolean
- API 要求が成功したかどうかを示します。 - ErrorCode -
String
- API 要求が成功しなかった場合の応答エラーです (Success=False)。 - Message -
String
- エラー メッセージです。
- Success -
-
結果 - 挿入または更新されたレコードの結果です。[結果] の
DataTable
は、次の例外を除き、[入力] セクションの [データ テーブル] と同じ構造を持っています。- 正常に挿入された新しいレコードには sys_id 値が追加されます。
- レコードが更新されたのかテーブルに追加されたのかを示す、Add または Update の値を持つ ActionType 列が追加されます。
- 操作が失敗した場合のエラー情報を持つ Error 列が追加されます。