Lightning Connect で JSON External オブジェクトと連携

こんにちは！ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。

CData Connect Server を使ってSalesforce コンソールやSalesforce Mobile App からJSON のデータ に接続することができます。 この記事では、CData Connect Server およびSalesforce Lightning Connect をつかって、JSON 外部オブジェクトを作成します。

CData Connect Server は、ピュアSQL のクラウドインターフェースをJSON に提供し、データを複製せずにSalesforce Lightning Connect からリアルタイムJSON のデータとの統合を手軽に実現します。Salesforce Lightning Connect はCData Connect Server をSQL Server データベースとして認識し、最適化されたデータ処理を使用してサポートされているすべてのSQL 操作（フィルタ、JOIN など）をJSON に直接プッシュして、サーバー側の処理を利用して、JSON のデータを素早く返します。

1. Connect Server にログインし、［DATA MODEL］をクリックします。
2. ［Available Data Sources］から［JSON］を選択します。
3. 必要な認証プロパティを入力し、JSON に接続します。

   データソースへの認証については、ヘルプドキュメントの「はじめに」を参照してください。CData 製品は、JSON API を双方向データベーステーブルとして、JSON ファイルを読み取り専用ビュー（ローカル ファイル、一般的なクラウドサービスに保存されているファイル、FTP サーバー）としてモデル化します。HTTP Basic、Digest、NTLM、OAuth、FTP などの主要な認証スキームがサポートされています。詳細はヘルプドキュメントの「はじめに」を参照してください。

   URI を設定して認証値を入力したら、DataModel を設定してデータ表現とデータ構造をより厳密に一致させます。

   DataModel プロパティは、データをどのようにテーブルに表現するかを制御するプロパティで、次の基本設定を切り替えます。

   • Document（デフォルト）：JSON データのトップレベルのドキュメントビューをモデル化します。CData 製品 は、ネストされたオブジェクト配列を集約されたJSON オブジェクトとして返します。
   • FlattenedDocuments：ネストされた配列オブジェクトと親オブジェクトを、単一テーブルに暗黙的に結合します。
   • Relational：階層データから個々の関連テーブルを返します。テーブルには、親ドキュメントにリンクする主キーと外部キーが含まれています。

   リレーショナル表現の設定についての詳細は、ヘルプドキュメントの「JSON データのモデリング」を参照してください。また、以下の例で使用されているサンプルデータも確認できます。データには人や所有する車、それらの車に行われたさまざまなメンテナンスサービスのエントリが含まれています。

   Amazon S3 内のJSON への接続

   URI をバケット内のJSON ドキュメントに設定します。さらに、次のプロパティを設定して認証します。

   • AWSAccessKey：AWS アクセスキー（username）に設定。
   • AWSSecretKey：AWS シークレットキーに設定。

   Box 内のJSON への接続

   URI をJSON ファイルへのパスに設定します。Box へ認証するには、OAuth 認証標準を使います。 認証方法については、Box への接続 を参照してください。

   Dropbox 内のJSON への接続

   URI をJSON ファイルへのパスに設定します。Dropbox へ認証するには、OAuth 認証標準を使います。 認証方法については、Dropbox への接続 を参照してください。ユーザーアカウントまたはサービスアカウントで認証できます。ユーザーアカウントフローでは、以下の接続文字列で示すように、ユーザー資格情報の接続プロパティを設定する必要はありません。 URI=dropbox://folder1/file.json; InitiateOAuth=GETANDREFRESH; OAuthClientId=oauthclientid1; OAuthClientSecret=oauthcliensecret1; CallbackUrl=http://localhost:12345;

   SharePoint Online SOAP 内のJSON への接続

   URI をJSON ファイルを含むドキュメントライブラリに設定します。認証するには、User、Password、およびStorageBaseURL を設定します。

   SharePoint Online REST 内のJSON への接続

   URI をJSON ファイルを含むドキュメントライブラリに設定します。StorageBaseURL は任意です。指定しない場合、ドライバーはルートドライブで動作します。 認証するには、OAuth 認証標準を使用します。

   FTP 内のJSON への接続

   URI をJSON ファイルへのパスが付いたサーバーのアドレスに設定します。認証するには、User およびPassword を設定します。

   Google Drive 内のJSON への接続

   デスクトップアプリケーションからのGoogle への認証には、InitiateOAuth をGETANDREFRESH に設定して、接続してください。詳細はドキュメントの「Google Drive への接続」を参照してください。

   
4. Create & Test をクリックします。
5. Edit JSON Connection ページのPermissions タブに移動し、ユーザーベースのアクセス許可を更新します。
6. USERS タブでAuthToken を取得します。

コネクションが構成されたら、Salesforce Lightning Connect からJSON に接続できるようになります。

JSON Services にOData データソースとして接続

次の手順で、Connect Server からのフィードに接続する設定を行います。

1. セールスフォースにログインして、［設定］→［開発］→［外部データソース］をクリックします。
2. ［新規外部データソース］をクリックします。
3. 以下のプロパティにデータを入力します。:
   • 外部データソース: リストビューやレポートで使われるラベル名を入力。
   • 名前: ユニークな識別子を入力。
   • 種別: SQL Server を選択。
4. 認証には、次のプロパティを設定します:
   • 認証プロトコル: パスワード認証を選択します。OAuth 2.0 も選択可能です。
   • Certificate: Enter or browse to the certificate to be used to encrypt and authenticate communications from Salesforce to your server.
   • 管理者ユーザ名: Connect Server で設定したユーザー名を入力。
   • 管理者パスワード: ユーザーのauth トークンを入力。

JSON Services と同期したオブジェクトの作成

外部データソース作成後、次の手順で JSON のデータを反映する外部オブジェクトを作成します。 JSON 外部オブジェクトとJSON テーブルの定義を同期する必要があります。

1. 作成した外部データソースを選択します。
2. ［検証して同期］をクリックします。
3. JSON テーブルをクリックして、外部オブジェクトとします。

Salesforce オブジェクトとして JSON Services にアクセス

JSON のデータ を外部データソースとして追加し、JSON テーブルをJSON 外部データソースとして同期すると、標準のSalesforce オブジェクトとして外部オブジェクトを使用することができます。

• フィルターリストビュー付で新しいタブを作成する:

  

• 標準Salesforce オブジェクトと並べて JSON 外部オブジェクトをディスプレイできます: