More than 1 year has passed since last update.

【Salesforceの商談IDと商談名をRPAで楽々取得！】BizRobo!でSalesforceのREST APIを呼びだす方法

Last updated at 2023-11-10Posted at 2023-11-10

本記事でできること

本記事では、SalesforceのREST APIを利用して「昨日登録された商談から商談IDと商談名を取得してタイプファイルに出力する」ロボットを作成します。
APIを用いて開発をすることでSalesforceと別システムの自動化が実現しやすくなると思います。
また、SalesforceのAPIの使い方やBizRobo!でAPIを利用するための設定方法について理解できます。

背景

BizRobo!はステップの編集だけで簡単にデジタルレイバー(ロボット)を作成できるので非エンジニアの方にもなじみやすいのが特徴だと思います。
ただ、画面操作だけの開発だとクラウドサービスのアップデート等でUIが変更になるとロボットが止まってしまって改修に時間がかかってしまう、、、というケースも少なくないと思います。
そういった状況を解決するためにAPIを利用するという方法があります。
ただ、非エンジニアの方の中には「APIって高度なイメージがあって難しそう」「ステップの操作でも実行できるから充分」と思う方もいらっしゃると思います。(かくゆう私もそう思っていた時期がありました)
そのような方に向けて弊社で利用しているAPIとその使い方について紹介したいと思います。

本記事はサードパーティーのツールを利用するため、動作を保証するものではございません。
APIを利用するための参考としてお考え下さい。

BizRobo!に搭載されているコネクター機能を用いてSalesforceを操作することも可能です。
コネクターを使う場合はこちらを参照ください。

事前準備

Salesforceの設定

Salesforceの認証を設定してください

ユーザのAPI有効化
OAuth設定の有効化

認証の設定が終わったらプロパティを用意します。
今回のロボットでは以下の値を利用します。

プロパティ	ラベル
instance_name	組織のインスタンス
username	ユーザ名
passsword	パスワード
client_id	コンシューマ鍵
client_secret	コンシューマの秘密

利用バージョン

本記事で利用する各システムの情報は下記になります。

対象システム	利用バージョン
BizRobo!	11.3.0.2
Salesforce REST API	58.0

ロボットの作成手順

以下のステップにて実現します。
左から12個のステップごとに説明をしていきます。

①パスワード取得（Lookup Password）

ロボットにパスワードを持たせるのはセキュリティ的によくないのでMCのパスワードストアを利用します。
流れとしては以下になります。
A：ステップを用意する
B：MCのパスワードストアにパスワードを設定する
C：アクセストークンを取得する
D：MCのパスワードストアにアクセストークンを設定する

A:ステップを用意

ステップ選択: その他 > パスワード取得

パスワード取得ステップ設定

ユーザー名: Salesforceのユーザ名（username）
ターゲットシステム: 任意の値
変数: パスワード型の変数を設定

B:MCのパスワードストア設定(パスワード)

MCログイン
リポジトリ > パスワードストア > パスワードストアエントリを作成を選択
ユーザー名: DSと同じユーザー名の値を入力
ターゲットシステム: DSと同じターゲットシステムの値を入力
パスワード: Salesforceのパスワード（passsword）
OKボタンクリック

C:アクセストークン取得

DSに戻る
ヘルプ > 製品について

Design Studio アクセストークンをコピー

D:MCのパスワードストア設定(アクセス)

MCログイン
リポジトリ > パスワードストア > パスワードアクセス > パスワードアクセスエントリを作成を選択
プロジェクト: 対象プロジェクト選択
パスワードアクセストークン: 先ほどコピーしたDesign Studio アクセストークンを貼り付け
説明: パスワードについての説明を入力
パスワードエントリ: ユーザー名@ターゲットシステムを選択
OKボタンクリック

以上で設定完了です。
変数にパスワードが格納されていることを確認してください。

②アクセストークン生成（OAth）

アクセストークンを生成するステップを作成します。
流れとしては以下になります。
A：ステップを用意する
B：ステップの設定をする

A:ステップを用意

ステップ選択: Web サービス呼出 > REST Web サービス呼出

第３者が見てもわかりやすいようにコメントを記入しておくと良いでしょうか。

B:ステップの設定

URL: REST APIのエンドポイント
- https://[Salesforceの組織のインスタンス（instance_name）]/services/oauth2/token
リクエスト: REST APIの操作方法
- POST
パラメータで指定
パラメータ: REST APIに送信する追加情報
- grant_type: password(固定値)
- username: Salesforceのユーザ名（username）
- password: password(変数)
- client_id: Salesforceのコンシューマ鍵（client_id）
- client_secret: Salesforceのコンシューマの秘密（client_secret）
エンコード:Form-urlencoded
出力値:ブラウザにロード
送信する追加ヘッダー: REST APIに送信する付加情報
- Content-Type:application/x-www-form-urlencoded

SalesforceのOauthの詳細については開発者ガイドをご確認ください。

③レスポンスを読み取り専用で開く（View as JSON）

②で取得した情報をJSON形式で読み取り専用で開きます。

ステップ挿入: アクションを選択 > 開く（読み取り専用）

④アクセストークン取得（Extract Access Token）

③で表示されたJSONからアクセストークンを取得します。

access_tokenを選択して変数に抽出する

変数にアクセストークンが格納されていることを確認してください。

⑤昨日登録された商談を取得（query）

SOQLクエリを設定してSalesforceから情報を取得します。

ステップ選択: Web サービス呼出 > REST Web サービス呼出
ステップ名変更: Call REST Web Serviceからqueryへ変更
URL: https://[Salesforceの組織のインスタンス（instance_name）]/services/data/v58.0/query
リクエスト: GET
パラメータ: SOQL クエリ
- q: SELECT Id,Name FROM Opportunity WHERE CreatedDate=YESTERDAY
出力値:ブラウザにロード
送信する追加ヘッダー
- エクスプレッションを選択して以下を設定
- "Authorization:Bearer "+access_token