添付ファイルを追加

UiPath.ServiceNow.Activities.AddAttachment

[添付ファイルを追加] アクティビティでは、ServiceNow の Attachment - POST API を使用して、[オブジェクト] と [オブジェクトの sys_id] で特定されるレコード オブジェクトにファイル ([添付ファイル]) をアップロードします。

ファイルをアップロードすると、アクティビティは添付ファイルの sys_id ([添付ファイル ID]) と、アップロードのステータス (成功/失敗情報) を持つ ResponseStatus 型オブジェクト ([ServiceNow のステータス]) を出力します。どちらの出力も、後続のアクティビティの入力変数 ([添付ファイルをダウンロード] や [添付ファイルを削除] の [添付ファイル ID]、条件付きロジックにおける [ServiceNow のステータス] など) として使用できます。

動作のしくみ

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

1. 「セットアップ」の手順を完了します。
2. [ServiceNow アプリケーション スコープ] アクティビティをプロジェクトに追加します。
3. [ServiceNow アプリケーション スコープ] アクティビティ内に [添付ファイルを追加] アクティビティを追加します。
4. [添付ファイルを追加] アクティビティの [設定] ボタンをクリックします (オブジェクト ウィザードが開きます)。
5. ファイルを追加するオブジェクトを選択し、[入力] セクションのプロパティ値を入力します。
6. [出力] プロパティの String 変数および ResponseStatus 変数を作成し、入力します。

   • 入力したプロパティ値は、Attachment - POST API に渡されます。

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

     

アクティビティの本体

[添付ファイルを追加] アクティビティのプロパティ値を入力するには、[設定] ボタンをクリックしてオブジェクト ウィザードを開き、ServiceNow オブジェクトを選択します (また、オブジェクトを String として入力するオプションがあります)。

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

• オブジェクト - ファイルをアップロードする ServiceNow オブジェクトの型です。オブジェクト ウィザードを使用してオブジェクトを選択するか、有効な String または String 型変数を入力します。
• ファイル - 添付するファイルです。このフィールドは Strings または String 型変数のみをサポートします。
• Sys ID - ファイルを添付するレコードの ID です。このフィールドは Strings または String 型変数のみをサポートします。

プロパティ

共通

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

入力

• ファイル名 - アップロードするファイルの完全なローカル パスです。String または String 型変数を入力します。
• オブジェクトの sys_id - ファイルをアップロードする ServiceNow レコードの sys_id です。String または String 型変数を入力します。sys_id の値を取得するには、ServiceNow のドキュメント「Unique record identifier (sys_id)」に記載されているいずれかの手順に従うか、ServiceNow UI 内のレコードを右クリックして、ポップアップ メニューの [Copy sys_id] オプションを選択します。

その他

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

出力

• 添付ファイル ID - 添付ファイルの sys_id です。String 型変数を入力します。このプロパティ用に作成した変数は、後続のアクティビティ ([ServiceNow レコードを取得]、[添付ファイルをダウンロード] など) で入力変数として使用できます。
• ServiceNow のステータス - 要求のステータスです (成功/失敗に関する情報)。ResponseStatus 型変数を入力します (UiPath.BAF.Models.ResponseStatus)。ResponseStatus オブジェクトには、他のアクティビティで使用できる 3 つのプロパティが含まれています。
  • Success - Boolean - API 要求が成功したかどうかを示します。
  • ErrorCode - String - API 要求が成功しなかった場合の応答エラーです (Success = False)。
  • Message - String - エラー メッセージです。

例

次の画像は、アクティビティの依存関係と入力/出力プロパティの値の例です。

ステップバイステップの手順および例は、クイックスタート ガイドをご覧ください。