- 基本情報
- Mulesoft の UiPath アドイン
- Microsoft Power Automate の UiPath アドイン
- Salesforce の UiPath アドイン
- ServiceNow の UiPath アドイン
- Workato の UiPath アドイン
- Workday の UiPath アドイン

アドイン ユーザー ガイド
オブジェクトと添付ファイル
このガイドの目的は、以下の ServiceNow 系アクティビティを使用した、実用的なサンプルを作成できるようになることです。
この実用的なサンプルにより、ServiceNow インスタンスへの接続をすばやく確認したり、アクティビティの入力/出力データ型に習熟したりすることができます。
概要
このページの手順を完了すると、以下のアクションを実行するオートメーション シーケンスが使用できるようになります。
-
ServiceNow インスタンスへの接続を確立します ([ServiceNow アプリケーション スコープ])。
-
新しい ServiceNow インシデントを作成します ([ServiceNow レコードを挿入])。
-
新しいインシデントにファイルをアップロードします ([添付ファイルを追加])。
-
アップロードしたファイルをローカル フォルダーにダウンロードします ([添付ファイルをダウンロード])。
-
アップロードしたファイルを削除します ([添付ファイルを削除])。
-
ファイルが削除されたことを確認します。これは、添付ファイルのレコードの取得を試行し、予期されるエラー メッセージを出力することによって行います ([ServiceNow レコードを取得] および [条件分岐 (if)])
-
作成したインシデントを削除します ([ServiceNow レコードを削除])。

前提条件
はじめる前に
- ServiceNow の「セットアップ」の手順を完了します。
- ServiceNow レコードに添付するローカル ファイルを用意してください。
手順
プロジェクトをビルドする
-
[資格情報を取得] アクティビティを追加します。
-
ServiceNow インスタンスのユーザー名とパスワードに対して (セットアップ時に) 作成した資格情報アセットの AssetName を入力します (例:
ServiceNowSignin)。 -
[パスワード] の値を表す
SecureString変数を作成し、入力します (例:password)。 -
[ユーザー名] の値の
String変数を作成し、入力します (例:username)。 -
2 つ目の [資格情報を取得] アクティビティを追加します。
-
ServiceNow インスタンスの (設定時に) 作成した資格情報アセットの [AssetName]、[Client Id] と [Client Secret] (例: クライアントシークレット) を入力します (例:
ServiceNowClients)。 -
[パスワード] の値を表す
SecureString変数を作成し、入力します (例:clientSecret)。 -
[ユーザー名] の値の
String変数を作成し、入力します (例:clientId)。 -
2 つの[資格情報を取得] アクティビティの後に[ServiceNow アプリケーション スコープ] アクティビティを追加します。
-
[クライアント シークレット] プロパティに、上記の手順でクライアント シークレット用に作成した
SecureString型変数を入力します (例:clientSecret)。 -
[クライアント ID] プロパティに、クライアント ID 用に作成した
String変数を入力します (例:clientId)。 -
[パスワード] プロパティに、上記の手順でパスワードに対して作成した
SecureString型変数を入力します (例: password)。 -
[ ユーザー名 ] プロパティに、ユーザー名用に作成した
String変数を入力します (例:clientId)。 -
[エンドポイント URL] の
String変数を作成し、入力します (例:endpointURL)。 -
[ServiceNow アプリケーション スコープ] アクティビティ内に [ ServiceNow レコードを挿入 ] アクティビティを追加します。
-
[ServiceNow レコードを挿入] アクティビティの [設定] ボタンをクリックします (オブジェクト ウィザードが開きます)。
-
[ オブジェクトを選択 ] ドロップダウン リストで、[ Incident] を選択します。
-
[sys_id値] に対し、
String変数を作成して入力します (例:sysID -
[ 単一のフィールドを追加 ] テキスト ボックスに「
short_description」と入力します。- short_description値を入力します (例:
UiPath-Attachment)。
- short_description値を入力します (例:
-
[完了] をクリックします。
-
ServiceNowStatus 値の
ResponseStatus変数を作成し、入力します (例:insertRecordResponse)。 -
[ServiceNow レコードを挿入] アクティビティの後に [1 行を書き込み] アクティビティを追加します。
-
次のテキストを入力します: "Record created: "+insertRecordResponse.Success.ToString+" |sys_id: "+sysID (
sysIDは、上記の [sys_id値] フィールド用に作成された変数です)。
-
[1 行を書き込み] アクティビティの後に [添付ファイルを追加] アクティビティを追加します。
-
[添付ファイルを追加] アクティビティの [設定] ボタンをクリックします。
-
[オブジェクトを選択] ドロップダウン リストで、[Incident] を選択します。
-
[ ファイル名 ] プロパティに、ローカル ファイルへのフル パス (例:
"C:\UiPath_Projects\DemoFile.docx"など) を入力するか、アクティビティの [ファイルを選択] ボタンをクリックします。 -
[オブジェクトの sys_id] プロパティに、[レコードを挿入] アクティビティ用に作成したsys_id変数を入力します (例:
sysID -
[添付ファイル ID] プロパティの
String型変数を作成し、入力します (例:attachmentId)。 -
ServiceNowStatus 値の
ResponseStatus変数を作成し、入力します (例:addAttachmentResponse)。 -
[ServiceNow レコードを挿入] アクティビティの後に [1 行を書き込み] アクティビティを追加します。
-
次の テキストを入力します: "Attachment added: "+addAttachmentResponse.Success.ToString+ " |sys_id: "+
attachmentId(attachmentIdは上記の [添付ファイル ID ] プロパティ用に作成された変数です)。 -
[1 行を書き込み] アクティビティの後に [添付ファイルをダウンロード] アクティビティを追加します。
-
ファイルをダウンロードする ファイルのパス を入力します (例:
"C:\UiPath_Projects\Downloads")。 -
[sysid] プロパティに、[添付ファイルを追加] アクティビティ用に作成した AttachmentId 変数を入力します (例:
attachmentId)。 -
[添付ファイルをダウンロード] アクティビティの後に [添付ファイルを削除] アクティビティを追加します。
-
[オブジェクトの sys_id] プロパティに、[添付ファイルを追加] アクティビティ用に作成した AttachmentId 変数を入力します (例:
attachmentId)。
プロジェクトをテストする
-
[添付ファイルを削除] アクティビティの後に、[ServiceNow レコードを取得] アクティビティを追加します。
-
[ServiceNow レコードを挿入] アクティビティの [設定] ボタンをクリックします。
-
[ オブジェクトを選択 ] ドロップダウン リストで、[ 添付ファイル] を選択します。
-
[sys_id値] フィールドに、[添付ファイルを追加] アクティビティ用に作成した AttachmentId 変数を入力します (例:
attachmentId -
[完了] をクリックします。
-
ServiceNowStatus 値の
ResponseStatus変数を作成し、入力します (例:getRecordResponse)。 -
[ServiceNow レコードを取得] アクティビティの後に [条件分岐 (if)] アクティビティを追加します。
-
[ 条件] プロパティに「
getRecordResponse.Success=False And getRecordResponse.Message.Contains("No Record")」と入力し、エラー メッセージを確認して添付ファイルのレコードが正常に削除されたかどうかを判断します (getRecordResponseは、上記の [ServiceNowStatus ] プロパティ用に作成した変数です)。 -
[Then] ステートメント ボックスに [1 行を書き込み] アクティビティを追加します。
- [テキスト] プロパティに、「"Test passed: "+
getRecordResponse.Messageと入力します。
- [テキスト] プロパティに、「"Test passed: "+
-
[1 行を書き込み] アクティビティの後に [ServiceNow レコードを削除] アクティビティを追加します。
- [添付ファイルを追加] アクティビティの [設定] ボタンをクリックします。
- [オブジェクトを選択] ドロップダウン リストで、[Incident] を選択します。
- [Id] プロパティに、[レコードを挿入] アクティビティ用に作成したsys_id変数を入力します (例:
sysID)。 - ServiceNowStatus 値の
ResponseStatus変数を作成し、入力します (例:deleteRecordResponse)。
-
[ServiceNow レコードを削除] アクティビティの後に [1 行を書き込み] アクティビティを追加します。
- [テキスト] プロパティに「Record deleted: "+
deleteRecordResponse.Success.ToStringと入力します。
- [テキスト] プロパティに「Record deleted: "+
-
[Else] ステートメント ボックスに [1 行を書き込み] アクティビティを追加します。
- [テキスト] プロパティに、「Test failed: "+
getRecordResponse.Messageと入力します。
- [テキスト] プロパティに、「Test failed: "+
-
[実行] をクリックして、[出力] ウィンドウに期待される [1 行を書き込み] の値が含まれていることを確認します。

完了です!
ServiceNow アクティビティの詳細 (プロパティの入力/出力の例を含む) については「アクティビティ」をご覧ください。すべてのアクティビティがまとめられたリストと、アクティビティの詳細な説明ページへのリンクが記載されています。