クイックスタート - オブジェクトと添付ファイル

概要

このガイドの目的は、以下の ServiceNow 系アクティビティを使用した、実用的なサンプルを作成できるようになることです。

• ServiceNow レコードを挿入
• 添付ファイルを追加
• 添付ファイルをダウンロード
• 添付ファイルを削除
• ServiceNow レコードを取得
• ServiceNow レコードを削除

この実用的なサンプルにより、ServiceNow インスタンスへの接続をすばやく確認したり、アクティビティの入力/出力データ型に習熟したりすることができます。

このページの手順を完了すると、以下のアクションを実行するオートメーション シーケンスが使用できるようになります。

1. ServiceNow インスタンスへの接続を確立します ([ServiceNow アプリケーション スコープ])。
2. 新しい ServiceNow インシデントを作成します ([ServiceNow レコードを挿入])。
3. 新しいインシデントにファイルをアップロードします ([添付ファイルを追加])。
4. アップロードしたファイルをローカル フォルダーにダウンロードします ([添付ファイルをダウンロード])。
5. アップロードしたファイルを削除します ([添付ファイルを削除])。
6. ファイルが削除されたことを確認します。これは、添付ファイルのレコードの取得を試行し、予期されるエラー メッセージを出力することによって行います ([ServiceNow レコードを取得]、[条件分岐 (if)])

7. 作成したインシデントを削除します ([ServiceNow レコードを削除])。

   
   

   

   
   

前提条件

はじめる前に

1. ServiceNow の「セットアップ」の手順を完了します。
2. ServiceNow レコードに添付するローカル ファイルを用意してください。

手順

プロジェクトをビルドする

1. アクティビティを追加します。
2. ServiceNow インスタンスのユーザー名とパスワードに対して ( セットアップ 時に) 作成した資格情報アセットの [ アセット名] を入力します (例: "ServiceNowSignin")。
3. [パスワード] の値に対し、 SecureString 変数を作成して入力します (例: password)。
4. [ユーザー名] の値に対し、String 型変数を作成して入力します (例: username)。
5. 2 つ目の [資格情報を取得] アクティビティを追加します。
6. ServiceNow インスタンスのクライアント ID とクライアント シークレットに対して ( セットアップ 時に) 作成した資格情報アセットの [ アセット名] を入力します (例: "ServiceNowClients")。
7. [パスワード] の値に対し、 SecureString 変数を作成して入力します (例: clientSecret)。
8. [ユーザー名] の値に対し、String 型変数を作成して入力します (例: clientId)。
9. 2 つの [資格情報を取得] アクティビティの後に [ServiceNow アプリケーション スコープ] アクティビティを追加します。
10. [クライアント シークレット] プロパティに、上記の手順でクライアント シークレットに対して作成した SecureString 型変数を入力します (例: clientSecret)。
11. [クライアント ID] プロパティに、クライアント ID に対して作成した String 型変数を入力します (例: clientId)。
12. [パスワード] プロパティに、上記の手順でパスワードに対して作成した SecureString 型変数を入力します (例: password)。
13. [ユーザー名] プロパティに、ユーザー名に対して作成した String 型変数を入力します (例: clientId)。
14. [エンドポイント URL] の値に使用する String 型変数を作成して入力します (例: endpointURL)。
15. [ServiceNow アプリケーション スコープ] アクティビティ内に [ServiceNow レコードを挿入] アクティビティを追加します。
16. [ServiceNow レコードを挿入] アクティビティの [設定] ボタンをクリックします (オブジェクト ウィザードが開きます)。
17. [ オブジェクトを選択 ] ドロップダウン リストで、[ Incident] を選択します。
18. sys_id の値に対し、String 変数を作成して入力します (例: sysID)。

19. [単一のフィールドを追加] テキストボックスに「short_description」と入力します。

    • short_description の値を入力します (例: "UiPath-Attachment")。
20. [完了] をクリックします。
21. [ServiceNow のステータス] の値に対し、ResponseStatus 変数を作成して入力します (例: insertRecordResponse)。
22. [ServiceNow レコードを挿入] アクティビティの後にアクティビティを追加します。

23. 次のテキストを入力します: "Record created: "+insertRecordResponse.Success.ToString+" | sys_id: "+sysID (sysID は、上記の sys_id 値のフィールドに対して作成された変数です)。

    
    

    

    
    
24. [1 行を書き込み] アクティビティの後に [添付ファイルを追加] アクティビティを追加します。
25. [添付ファイルを追加] アクティビティの [設定] ボタンをクリックします。
26. [オブジェクトを選択] ドロップダウン リストで、[Incident] を選択します。
27. [ ファイル名 ] プロパティに、ローカル ファイルへのフル パス (例: "C:\UiPath_Projects\DemoFile.docx") を入力するか、アクティビティの [ファイルを選択 ] ボタンをクリックします。
28. [オブジェクトの sys_id] プロパティで、[レコードを挿入] アクティビティに対して作成した sys_id 変数を入力します (例: sysID)。
29. [添付ファイル ID] プロパティに対し、String 型変数を作成して入力します (例: attachmentId)。
30. [ ServiceNow のステータス] の値に対し、 ResponseStatus 変数を作成して入力します (例: addAttachmentResponse)。
31. [ServiceNow レコードを挿入] アクティビティの後にアクティビティを追加します。
32. 次の テキストを入力します: 「"Attachment added: "+addAttachmentResponse.Success.ToString+ " | sys_id: "+attachmentId」 (attachmentId は、上記の [添付ファイル ID] プロパティに対して作成された変数です)。
33. [1 行を書き込み] アクティビティの後に [添付ファイルをダウンロード] アクティビティを追加します。
34. ファイルのダウンロード先の [ファイル パス] を入力します (例: "C:\UiPath_Projects\Downloads")。
35. [sys_id] プロパティに、[添付ファイルを追加] アクティビティに対して作成した AttachmentId 変数を入力します (例: attachmentId)。
36. [添付ファイルをダウンロード] アクティビティの後に [添付ファイルを削除] アクティビティを追加します。

37. [オブジェクトの sys_id] プロパティに、[添付ファイルを追加] アクティビティに対して作成した AttachmentId 変数を入力します (例: attachmentId)。

    
    

    

    
    

プロジェクトをテストする

1. [添付ファイルを削除] アクティビティの後に、[ServiceNow レコードを取得] アクティビティを追加します。
2. [ServiceNow レコードを挿入] アクティビティの [設定] ボタンをクリックします。
3. [ オブジェクトを選択 ] ドロップダウン リストで、[ 添付ファイル] を選択します。
4. [ sys_id 値 ] フィールドに、[ 添付ファイル を追加] アクティビティに対して作成した AttachmentId 変数を入力します (例: attachmentId)。
5. [完了] をクリックします。
6. [ServiceNow のステータス] の値に対し、ResponseStatus 変数を作成して入力します (例: getRecordResponse)。
7. [ServiceNow レコードを取得] アクティビティの後にアクティビティを追加します。
8. [条件] プロパティに 「getRecordResponse.Success=False And getRecordResponse.Message.Contains("No Record")」と入力し、エラー メッセージを確認して、添付ファイルのレコードが削除されたかどうかを判断します (getRecordResponse は上記で [ServiceNow のステータス] プロパティに対して作成した変数です)。

9. [Then] ステートメント ボックスに [1 行を書き込み] アクティビティを追加します。

   1. [ テキスト] プロパティに 、「"Test passed: "+getRecordResponse.Message」と入力します。

   2. [1 行を書き込み] アクティビティの後に [ServiceNow レコードを削除] アクティビティを追加します。

   3. [ 添付ファイルを追加] アクティビティの [ 設定 ] ボタンをクリックします。

   4. [オブジェクトを選択 ] ドロップダウン リストで、[ Incident] を選択します。

   5. [ID] プロパティに、[レコードを挿入] アクティビティに対して作成した sys_id 変数を入力します (例: sysID)。

   6. [ ServiceNow のステータス] の値に対し、 ResponseStatus 変数を作成して入力します (例: deleteRecordResponse)。

10. [ServiceNow レコードを削除] アクティビティの後に [1 行を書き込み] アクティビティを追加します。

    1. [ テキスト] プロパティに 、「"Record deleted: "+deleteRecordResponse.Success.ToString」と入力します。

11. [Else] ステートメント ボックスに [1 行を書き込み] アクティビティを追加します。

    1. [テキスト] プロパティに、「"Test failed: "+getRecordResponse.Message」と入力します。

12. [実行] をクリックして、[出力] ウィンドウに期待される [1 行を書き込み] の値が含まれていることを確認します。

    
    

    

    
    

完了です!

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