各製品の資料を入手。
詳細はこちら →
Salesforce Connect で外部GraphQL オブジェクトを作成・編集する方法
CData Connect Cloud とSalesforce Connect を使用して、アプリやダッシュボードからアクセスできるGraphQL オブジェクトを作成します。
最終更新日：2023-08-17
この記事で実現できるGraphQL 連携のシナリオ
こんにちは！ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。
CData Connect Cloud を使えば、Salesforce のようなクラウドベースのアプリケーションや、Salesforce Mobile App のようなモバイルアプリケーションからGraphQL のデータにアクセスできます。この記事では、CData Connect Cloud とSalesforce Connect を使用して標準のSalesforce オブジェクトとともに外部のGraphQL オブジェクトにアクセスします。
Connect Cloud アカウントの取得
以下のステップを実行するには、CData Connect Cloud のアカウントが必要になります。こちらから製品の詳しい情報とアカウント作成、30日間無償トライアルのご利用を開始できますので、ぜひご利用ください。
Connect Cloud を構成する
Salesforce Connect でGraphQL のデータをリアルタイムで操作するには、Connect Cloud からGraphQL に接続し、コネクションにユーザーアクセスを提供してGraphQL のデータのOData エンドポイントを作成する必要があります。
（オプション）新しいConnect Cloud ユーザーの追加
必要であれば、Connect Cloud 経由でGraphQL に接続するユーザーを作成します。
- ユーザーページに移動し、 Invite Users をクリックします。
- 新しいユーザーのE メールアドレスを入力して、 Send to invite the user をクリックします。
![新しいユーザーを招待]()
- ユーザーページからユーザーを確認および編集できます。
![Connect Cloud users]()
パーソナルアクセストークンの追加
OAuth 認証をサポートしていないサービス、アプリケーション、プラットフォーム、またはフレームワークから接続する場合は、認証に使用するパーソナルアクセストークン（PAT）を作成できます。きめ細かなアクセス管理を行うために、サービスごとに個別のPAT を作成するのがベストプラクティスです。
- Connect Cloud アプリの右上にあるユーザー名をクリックし、User Profile をクリックします。
- User Profile ページでPersonal Access Token セクションにスクロールし、 Create PAT をクリックします。
- PAT の名前を入力して Create をクリックします。
![Creating a new PAT]()
- パーソナルアクセストークンは作成時にしか表示されないため、必ずコピーして安全に保存してください。
Connect Cloud からGraphQL に接続
CData Connect Cloud では、簡単なクリック操作ベースのインターフェースでデータソースに接続できます。
- Connect Cloud にログインし、 Add Connection をクリックします。
![Adding a Connection]()
- Add Connection パネルから「GraphQL」を選択します。
![データソースを選択]()
-
必要な認証プロパティを入力し、GraphQL に接続します。
GraphQL サービスのURL を指定する必要があります。 ドライバーは2種類の認証をサポートします。
- Basic: AuthScheme をBasic に設定。GraphQL サービスのUser とPassword を指定する必要があります。
- OAuth 1.0 & 2.0: 詳しい説明は、ヘルプドキュメントのOAuth セクションを参照してください。
![Configuring a connection （NetSuite の例）]()
- Create & Test をクリックします。
- Edit GraphQL Connection ページのPermissions タブに移動し、ユーザーベースのアクセス許可を更新します。
![権限を更新]()
Connect Cloud にGraphQL OData エンドポイントを追加する
GraphQL に接続したら、目的のテーブルのOData エンドポイントを作成します。
- OData ページに移動し、 Add to create new OData endpoints をクリックします。
- GraphQL 接続（例：GraphQL1）を選択し、Next をクリックします。
- 使用するテーブルを選択し、Confirm をクリックします。
![テーブルを選択（NetSuite の例）]()
コネクションとOData エンドポイントを設定したら、Salesforce Connect からGraphQL のデータに接続できます。
外部データソースとしてGraphQL のデータに接続する
以下のステップに従って、Connect Cloud に生成されたフィードに接続します。
- Salesforce にログインし、「Setup」->「Integrations」->「External Data Sources」とクリックします。
- 「New External Data Source」をクリックします。
- 以下のプロパティに値を入力します。
- External Data Sources：リストビューおよびレポートで使用するラベルを入力します。
- Name：個別の識別子を入力します。
- Type：「Salesforce Connect: OData 4.0」オプションを選択します。
- URL：Connect Cloud OData エンドポイントのURL（https://cloud.cdata.com/api/odata/service） を入力します。
- 「Writable External Objects」オプションを選択します。
- 「Format」メニューから「JSON」を選択します。
- 「Authentication」セクションでは、以下のプロパティを設定します。
- Identity Type：組織のすべてのメンバーが同じ認証情報を使用してConnect Cloud にアクセスする場合は、「Named Principal」を選択します。 各自の認証情報で接続する場合は、「Per User」を選択します。
- Authentication Protocol：基本認証を使用するには、「Password Authentication」を選択します。
- Certificate：Salesforce からサーバーへの通信を暗号化および認証するために使用する証明書を入力または参照します。
- Username：Connect Cloud のユーザー名を入力します。（例：[email protected]）
- Password：ユーザーのPAT を入力します。
GraphQL オブジェクトを同期する
外部データソースを作成したら、以下のステップに従って、データソースへの変更を反映するGraphQL 外部オブジェクトを作成します。GraphQL 外部オブジェクトの定義をGraphQL テーブルの定義と同期します。
- 作成した外部データソースのリンクをクリックします。
- 「Validate and Scan」をクリックします。
- 外部オブジェクトとして使用するGraphQL テーブルを選択します。
GraphQL のデータにSalesforce オブジェクトとしてアクセスする
GraphQL のデータを外部データソースとして追加し、GraphQL テーブルを外部オブジェクトとして同期すると、標準のSalesforce オブジェクトと同じように外部GraphQL オブジェクトを使用できるようになります。
-
フィルタリストビューを使用して新しいタブを作成します。
![Viewing external objects from Salesforce （NetSuite の例）]()
-
外部オブジェクトのレポートを作成します。
![Reporting on external objects from Salesforce （NetSuite の例）]()
-
Salesforce ダッシュボードから、GraphQL オブジェクトを作成、アップデート、および削除します。
![Editing external objects from Salesforce （NetSuite の例）]()
クラウドアプリケーションからGraphQL のデータへのアクセスを簡単に
これで、Salesforce からGraphQL のデータへリアルタイムでクラウドベースの接続が可能です。Salesforce のようなクラウドアプリケーションから簡単に100を超えるSaaS、ビッグデータ、NoSQL ソースのデータにアクセスする方法の詳細については、Connect Cloud ページを参照してください。