REST API Salesforce 統合 - Automate_Evolve - Automate_Studio_Manager - 20.3

Automate Evolve ユーザー ガイド

Product type
ソフトウェア
Portfolio
Integrate
Product family
Automate
Product
Automate > Automate Evolve
Version
20.3
Language
日本語
Product name
Automate Evolve
Title
Automate Evolve ユーザー ガイド
Topic type
リファレンス
管理
概要
First publish date
2018

Salesforce アカウントの作成

以下の手順に従って、Salesforce アカウントを作成します。

  1. https://developer.salesforce.com/signup に移動します。

  2. 詳細を記入します。

  3. [サインアップ] ボタンをクリックすると、確認とパスワード設定のメールが届きます。

  4. パスワードとセキュリティの質問を設定し、Salesforce にログインします。

  5. ログインすると、Lightning ビューが表示され、ユーザーアイコン (右上隅) から Classic ビューに変更します。

Salesforce の設定

接続された Salesforce アプリケーションをセットアップするには、以下の手順に従います。

  1. [セットアップ] アイコン (右上) に移動します。

  2. セットアップ ウィンドウが展開したら、左側のパネルの [ビルド] セクションで [作成] [アプリ] に移動します。

  3. アプリ ウィンドウの [接続済みアプリ] セクションで、[新規] を選択して新しい接続済みアプリを登録します。

  4. [新規接続アプリの登録] ウィンドウで、必須フィールドに入力します。

  5. API (OAuth 設定を有効にする) セクションで、[OAuth 設定を有効にする] チェックボックスをクリックします (販売組織に接続するには、認証コード フローとユーザー名パスワード フローの 2 つのオプションがあります。認証コード フローを使用して認証トークンを取得する場合尾は、(OAuth 設定を有効にする) で説明したコールバック URL が関係します)。OAuth スコープは、販売組織で外部ユーザーのアクセスを設定する制限を定義します (Access を使用して、独自の要件に従ってスコープを設定できるデータ (API ) を管理しています)。

  6. 詳細を入力したら、[保存] をクリックします。次のウィンドウに進み、アプリが作成されるのを待ちます。

  7. アプリが作成されると、アプリの詳細を示すウィンドウが表示されます。

注: : コンシューマー キーとコンシューマー シークレットは、アクセス トークンを取得して Salesforce へのAPI 呼び出しを行うために使用されます。

Postman を使用した API 呼び出しの実行

  1. 次のステップは、アクセス トークンを取得することです。開発者組織に接続している場合は、URL に https://login.salesforce.com/services/oauth2/token を使用してアクセストークンを取得します。 ただし、サンドボックスを使用している場合は、トークン URL として https://test.salesforce.com/services/oauth2/token を使用できます。

  2. Postman を開き、呼び出しを設定します。

    [x-www-form-urlencoded] ラジオボタンが選択されていることを確認します。以下の 5 つのキーと値のペアを追加します。

    キー: ユーザー名 | : <組織のログイン ユーザー名>

    キー : パスワード | : <組織のログイン パスワード>

    キー : grant_type | : パスワード

    キー : client_id | : <Salesforce 組織の接続アプリのコンシューマー キー>

    キー : client_secret | : <Salesforce 組織の接続アプリのコンシューマー シークレット>

    注: : キー - パスワード: ログイン シークレット トークンも必要になります。
  3. 呼び出しを実行するとエラーが発生する場合は、Salesforce に認証用の追加パラメータが必要です。

  4. これを解決するには、ログインした Salesforce サイトに移動し、ユーザー名で [設定] に移動します。

  5. [設定] ページの左側のパネルの [個人] セクションで、[セキュリティ トークンのリセット] を選択します。

  6. [トークンのリセット] ページで、[セキュリティ トークンのリセット] ボタンをクリックします。

  7. 登録したメール アドレスにセキュリティ トークンが届きます。

  8. 実際のユーザーのパスワードを使用してセキュリティ トークンを追加し、呼び出しを実行します。

  9. 販売組織に接続するために生成されたアクセス トークンは、レスポンスで受信されます。

  10. アクセス トークンをコピーして保存します。

    注: : アクセス トークンには有効期間があります。API 呼び出しで Session Expired エラーが表示されたら、アクセス トークンの再生成が必要な場合があります。
  11. Salesforce への呼び出しを実行し、さまざまなアカウントを利用できるようにします。

  12. 受信した電子メールから Salesforce の URL をコピーし、次のようにリクエスト URL を生成します。

    Baseurl/services/data/version/query?q=SOQL クエリ

  13. [ヘッダー] タブで、キーと値のペアを指定します。

    キー: 認可 | : ベアラー {{アクセス トークン}}

  14. [送信] をクリックすると、出力を受信します。

クエリと REST API 呼び出しの詳細については、「REST API 開発者ガイド」を参照してください。

Evolve を介した Salesforce への接続

Evolve を介して Salesforce に接続するには、以下の手順に従います。

  1. Evolve サイトにログインし、管理者アプリケーションに移動します。

  2. 左側のパネルから [接続] に移動します。

  3. [接続] ページで、[データ ソース] タブに移動します。

  4. [追加] をクリックして、新しいデータ接続を追加します。詳細を入力します (デモ用に API: baseURL/services/data/v49.0/sobjects/Account/{id} を使用しています)。

    注: : パスワードは実際のパスワード + 上記の postman の例で使用されているセキュリティ トークンである必要があります。
  5. [保存] をクリックして、データ接続を保存します。

Composer ソリューションでの作成済みデータ接続の使用

  1. Evolve サイトの他のアプリに移動します。

  2. 左側のパネルから [ソリューション] に移動します。[ソリューション] ページで、[フォーム ライブラリ] を選択し、新しいフォーム ソリューションを作成します ([ソリューションの追加] ボタンを使用)。

  3. 新しいソリューションの [フォーム] タブに移動し、フォーム フィールド名 ID を追加します。

  4. [ソリューション] タブの [データ接続] に移動し、[データ接続] を追加して詳細を追加します。

    以下の手順に従って、フォーム フィールドから API URL を作成します。

    1. API URL の下で、右側の 3 つのドットをクリックします。

    2. [URL ビルダー] ページで、右側の 3 つのドットをもう一度クリックして、フィールド値を URL に追加します。

    3. [フィールド値] をクリックして 、フォーム フィールドを選択します。

    4. [フォーム] ページに追加されたフォーム フィールドを選択し、[OK] ボタンをクリックします。

    5. URL は次のように作成されます。

      /services/data/v49.0/sobjects/account/[/my:myFields/my:id]

  5. 以下に説明するように出力スキーマを使用します (現在、スキーマを取得する機能はありません。出力、入力、エラーを分析し、それに応じてスキーマを作成します)。

    { "Id": "string", "IsDeleted": "bool", "Name": "string", "BillingStreet": "string", "BillingCity": "string", "BillingAddress": { "city": "string", "state": "string", "street": "string" }, "ShippingStreet": "string", "ShippingCity": "string", "ShippingState": "string" } 
  6. 詳細を入力したら、[OK] ボタンをクリックしてデータ接続を追加します。

  7. [ソリューション] タブで、作成されたデータ接続を右クリックし、[フォーム フィールドの作成] オプションを選択します。

  8. [フィールド マッピング] ダイアログで、詳細を入力します。

  9. [次へ] をクリックします。

  10. [フィールド マッピング] フィールド ダイアログで、必要に応じてフィールド マッピングを編集および変更できます。それ以外の場合は、[OK] をクリックします。

  11. コンポーザー ソリューションの [フォーム] タブに移動し、フォームのデータ接続に関連する必須フィールドをドラッグします。

  12. フォームにボタンを追加し、追加されたボタンのクリックで実行されるように Web サービスを構成します。

    • [フォーム] タブに Web サービス要素を追加します。

    • ドロップダウンで get サービスを選択します。

    • [ボタンで呼び出し] チェックボックスを選択します。

  13. [ソリューション] タブ → [ソリューションの展開と起動] に移動します。

  14. 起動されたフォームで、データを取得する ID (id: 0012w00000UWpwPAAT) を入力し、追加されたボタンをクリックして Web サービスを実行します。

  15. クエリされたデータはフォームに表示されます。

  16. 同様に、POST、PUT などの他の操作を要件に応じて使用できます。

詳細については、「REST API 開発者ガイド」を参照してください。