WinActorのOAuth関連ライブラリを使用して、Salesforce Lightning Platform (以降、Salesforceと記載します。) の Leadオブジェクトのデータを削除するサンプルシナリオについて説明します。
本サンプルシナリオは、以下の処理を行います。
本サンプルシナリオでは、以下のWinActorモジュールを使用します。
ノード/変数/変数値設定
01_WinActor制御/02_シナリオ制御/シナリオ停止.ums5
07_文字列操作/03_連結/文字列の連結(3つ).ums5
13_ファイル関連/05_ファイル名/シナリオフォルダのファイルパス.ums5
18_Excel関連/03_行列操作/Excel操作(行コピー).ums5
99_外部サービス連携/01_OAuth関連/RESTful API実行.ums5
Excelファイルを入力ファイルとします。
シナリオ内でExcelファイルをオープンし、処理を実施するのに必要な情報を取得します。
入力ファイルの詳細は入力ファイルの形式を参照してください。
削除時の実施結果を、JSON形式のログファイルとして保存します。
詳細はログファイルを参照してください。
本ドキュメントは、以下の技術レベルのユーザを対象としています。
サンプルシナリオは以下の環境で確認しています。
本サンプルシナリオの実施方法は以下の通りです。
本サンプルシナリオでSalesforce にアクセスする場合、Salesforce 側にも接続用のアプリケーションが必要です。まだ 接続アプリケーションを作成していない場合は、 Salesforce.com日本語公開ヘルプサイトの「接続アプリケーションの作成」 を参照して、以下の接続アプリケーションを作成してください。
本サンプルシナリオ(SS1903_5448_AccessSalesforceLead_Remove.ums5)が格納されているディレクトリに移動します。
このディレクトリに入力ファイルを配置します。
本サンプルシナリオには、サンプルのExcelファイルが添付されていますが、入力されているIDが異なるため、このファイルを使用して、削除を行うことができません。
本サンプルシナリオを実行する場合、登録を行ったときに自動付与されたIDが入った入力ファイルを使用する必要があります。
以下の手順で入力ファイルを作成します。
WinActorを起動し、本サンプルシナリオを読み込みます。
Salesforceの接続アプリケーションにアクセスするための値を、変数一覧で設定します。
アクセス用情報の設定 を参照してください。
本サンプルシナリオを実行するために必要な値を、変数一覧で更新します。
本サンプルシナリオの実行にあたり、事前に設定が必要な変数は下記の通りです。
本サンプルシナリオを実行開始します。
入力ファイルにあるデータをすべて削除するまで、シナリオはループします。
Salesforceのサイトにアクセスし、Excelファイルに格納されていたデータがすべて削除されていることを確認してください。
本サンプルシナリオでは、使用しているライブラリ由来のエラーメッセージを表示することがあります。
ライブラリ由来のエラーメッセージについては、ライブラリのエラーメッセージ一覧を参照してください。
本サンプルシナリオで使用している実装テクニックについて説明します。
入力ファイル(Excel)は以下の形式をとります。
行番号 | 指定内容 | 詳細 |
---|---|---|
1行目 | ヘッダ | ID 、(その他任意のデータ名)12 |
2行目以降 | 削除対象データを示すID | 削除用情報。A列にIDが格納されていること。(B列以降は任意) |
どのデータを削除するかを、入力ファイルのA列から取得します。
1行目はヘッダとみなし、2行目(A2)からデータを取得します。 「ID」列だけが入力されているファイル、「ID」列とその他の項目が登録されているファイル、どちらでも実行が可能です。
本サンプルシナリオは、送信用データファイルを使用しません。
「RESTful API URLパス名」に、削除するデータのID番号を付与して、RESTful API実行.ums5ライブラリを実施します。
本サンプルシナリオは、「削除結果確認」処理で、Salesforceから送られた実施結果のJSONファイルを解析します。
「削除結果確認」処理では、以下の処理を実施します。
実施結果が「False」だった場合、「エラー内容取得」処理で実施結果のファイルからerrorコード、errorメッセージを取得します。
本サンプルシナリオでは、変数一覧で指定された [ログフォルダ/log] のディレクトリにログを出力します。
どちらのファイルも、削除データの数だけ出力されます。
ログファイル名 | ログ内容 |
---|---|
ResponseJson_ZZx行目_{日付}.txt | 削除の実施結果を格納したJSONファイル。 ZZ:実施結果。正常終了時はOK、異常終了時はNG。 x:入力ファイル内の行番号 日付:削除実施日時。YYYYMMDDhhmmssの形式 |
版数 | 日付 | 修正内容 |
---|---|---|
1.0版 | 2019/03/25 | 初版 |
1.1版 | 2023/06/12 | 注意事項を削除 |