Salesforce アカウントの作成
以下の手順に従って、Salesforce アカウントを作成します。
-
詳細を記入します。
-
[サインアップ] ボタンをクリックすると、確認とパスワード設定のメールが届きます。
-
パスワードとセキュリティの質問を設定し、Salesforce にログインします。
-
ログインすると、Lightning ビューが表示され、ユーザーアイコン (右上隅) から Classic ビューに変更します。
Salesforce の設定
接続された Salesforce アプリケーションをセットアップするには、以下の手順に従います。
-
[セットアップ] アイコン (右上) に移動します。
-
セットアップ ウィンドウが展開したら、左側のパネルの [ビルド] セクションで [作成] → [アプリ] に移動します。
-
アプリ ウィンドウの [接続済みアプリ] セクションで、[新規] を選択して新しい接続済みアプリを登録します。
-
[新規接続アプリの登録] ウィンドウで、必須フィールドに入力します。
-
API (OAuth 設定を有効にする) セクションで、[OAuth 設定を有効にする] チェックボックスをクリックします (販売組織に接続するには、認証コード フローとユーザー名パスワード フローの 2 つのオプションがあります。認証コード フローを使用して認証トークンを取得する場合尾は、(OAuth 設定を有効にする) で説明したコールバック URL が関係します)。OAuth スコープは、販売組織で外部ユーザーのアクセスを設定する制限を定義します (Access を使用して、独自の要件に従ってスコープを設定できるデータ (API ) を管理しています)。
-
詳細を入力したら、[保存] をクリックします。次のウィンドウに進み、アプリが作成されるのを待ちます。
-
アプリが作成されると、アプリの詳細を示すウィンドウが表示されます。
Postman を使用した API 呼び出しの実行
-
次のステップは、アクセス トークンを取得することです。開発者組織に接続している場合は、URL に https://login.salesforce.com/services/oauth2/token を使用してアクセストークンを取得します。 ただし、サンドボックスを使用している場合は、トークン URL として https://test.salesforce.com/services/oauth2/token を使用できます。
-
Postman を開き、呼び出しを設定します。
[x-www-form-urlencoded] ラジオボタンが選択されていることを確認します。以下の 5 つのキーと値のペアを追加します。
キー: ユーザー名 | 値: <組織のログイン ユーザー名>
キー : パスワード | 値: <組織のログイン パスワード>
キー : grant_type | 値: パスワード
キー : client_id | 値: <Salesforce 組織の接続アプリのコンシューマー キー>
キー : client_secret | 値: <Salesforce 組織の接続アプリのコンシューマー シークレット>
注: 注: キー - パスワード: ログイン シークレット トークンも必要になります。 -
呼び出しを実行するとエラーが発生する場合は、Salesforce に認証用の追加パラメータが必要です。
-
これを解決するには、ログインした Salesforce サイトに移動し、ユーザー名で [設定] に移動します。
-
[設定] ページの左側のパネルの [個人] セクションで、[セキュリティ トークンのリセット] を選択します。
-
[トークンのリセット] ページで、[セキュリティ トークンのリセット] ボタンをクリックします。
-
登録したメール アドレスにセキュリティ トークンが届きます。
-
実際のユーザーのパスワードを使用してセキュリティ トークンを追加し、呼び出しを実行します。
-
販売組織に接続するために生成されたアクセス トークンは、レスポンスで受信されます。
-
アクセス トークンをコピーして保存します。
注: 注 : アクセス トークンには有効期間があります。API 呼び出しで Session Expired エラーが表示されたら、アクセス トークンの再生成が必要な場合があります。 -
Salesforce への呼び出しを実行し、さまざまなアカウントを利用できるようにします。
-
受信した電子メールから Salesforce の URL をコピーし、次のようにリクエスト URL を生成します。
Baseurl/services/data/version/query?q=SOQL クエリ
-
[ヘッダー] タブで、キーと値のペアを指定します。
キー: 認可 | 値: ベアラー {{アクセス トークン}}
-
[送信] をクリックすると、出力を受信します。
クエリと REST API 呼び出しの詳細については、「REST API 開発者ガイド」を参照してください。
Evolve を介した Salesforce への接続
Evolve を介して Salesforce に接続するには、以下の手順に従います。
-
Evolve サイトにログインし、管理者アプリケーションに移動します。
-
左側のパネルから [接続] に移動します。
-
[接続] ページで、[データ ソース] タブに移動します。
-
[追加] をクリックして、新しいデータ接続を追加します。詳細を入力します (デモ用に API: baseURL/services/data/v49.0/sobjects/Account/{id} を使用しています)。
注: 注 : パスワードは実際のパスワード + 上記の postman の例で使用されているセキュリティ トークンである必要があります。 -
[保存] をクリックして、データ接続を保存します。
Composer ソリューションでの作成済みデータ接続の使用
-
Evolve サイトの他のアプリに移動します。
-
左側のパネルから [ソリューション] に移動します。[ソリューション] ページで、[フォーム ライブラリ] を選択し、新しいフォーム ソリューションを作成します ([ソリューションの追加] ボタンを使用)。
-
新しいソリューションの [フォーム] タブに移動し、フォーム フィールド名 ID を追加します。
-
[ソリューション] タブの [データ接続] に移動し、[データ接続] を追加して詳細を追加します。
以下の手順に従って、フォーム フィールドから API URL を作成します。
-
API URL の下で、右側の 3 つのドットをクリックします。
-
[URL ビルダー] ページで、右側の 3 つのドットをもう一度クリックして、フィールド値を URL に追加します。
-
[フィールド値] をクリックして 、フォーム フィールドを選択します。
-
[フォーム] ページに追加されたフォーム フィールドを選択し、[OK] ボタンをクリックします。
-
URL は次のように作成されます。
/services/data/v49.0/sobjects/account/[/my:myFields/my:id]
-
-
以下に説明するように出力スキーマを使用します (現在、スキーマを取得する機能はありません。出力、入力、エラーを分析し、それに応じてスキーマを作成します)。
{ "Id": "string", "IsDeleted": "bool", "Name": "string", "BillingStreet": "string", "BillingCity": "string", "BillingAddress": { "city": "string", "state": "string", "street": "string" }, "ShippingStreet": "string", "ShippingCity": "string", "ShippingState": "string" }
-
詳細を入力したら、[OK] ボタンをクリックしてデータ接続を追加します。
-
[ソリューション] タブで、作成されたデータ接続を右クリックし、[フォーム フィールドの作成] オプションを選択します。
-
[フィールド マッピング] ダイアログで、詳細を入力します。
-
[次へ] をクリックします。
-
[フィールド マッピング] フィールド ダイアログで、必要に応じてフィールド マッピングを編集および変更できます。それ以外の場合は、[OK] をクリックします。
-
コンポーザー ソリューションの [フォーム] タブに移動し、フォームのデータ接続に関連する必須フィールドをドラッグします。
-
フォームにボタンを追加し、追加されたボタンのクリックで実行されるように Web サービスを構成します。
-
[フォーム] タブに Web サービス要素を追加します。
-
ドロップダウンで get サービスを選択します。
-
[ボタンで呼び出し] チェックボックスを選択します。
-
-
[ソリューション] タブ → [ソリューションの展開と起動] に移動します。
-
起動されたフォームで、データを取得する ID (id: 0012w00000UWpwPAAT) を入力し、追加されたボタンをクリックして Web サービスを実行します。
-
クエリされたデータはフォームに表示されます。
-
同様に、POST、PUT などの他の操作を要件に応じて使用できます。
詳細については、「REST API 開発者ガイド」を参照してください。