iContact データをHeroku Postgres にレプリケーションして、Salesforce Connect から利用する方法
CData Sync は、いろいろなシナリオのデータレプリケーション（同期）を行うことができるスタンドアロンのアプリケーションです。例えば、sandbox および本番インスタンスのデータをデータベースに同期することができます。iContact のデータ をHeroku 上のPostgreSQL に同期することで、Salesforce の通常オブジェクトに加えて、Salesforce 外部オブジェクト（Salesforce Connect）としてiContact のデータへのアクセスが可能になります。
要件
本レプリケーション例では、次が必要です:
- CData Sync (試用版もしくは商用版)、およびiContact のレプリケーションに必要なライセンス。
- Heroku Postgress を含むHeroku app および、Heroku Connect アドオン許可。
- Salesforce アカウント。
レプリケーション同期先の設定
CData Sync を使って、iContact のデータ をHeroku 上のPostgreSQL データベースにレプリケーションできます。本記事では、Heroku 上の既存のPostgreSQL を使用します。PostgreSQL データベースをレプリケーション先に指定するには、［接続］タブから進みます。
- ［同期先］タブをクリックします。
- PostgreSQL を同期先として選択します。
PostgreSQL への接続には、Port（デフォルトでは5432）、およびデータベース接続プロパティを設定し、サーバーに認証するuser およびpassword を設定します。データベースプロパティが指定されていない場合には、ユーザーのデフォルトデータベースに接続します。
- 接続のテスト］をクリックして、正しく接続できているかをテストします。
- ［変更を保存］をクリックします。
iContact 接続の設定
データソース側にiContact を設定します。［接続］タブをクリックします。
- ［接続の追加］セクションで［データソース］タブを選択します。
- iContact アイコンをデータソースとして選択します。プリインストールされたソースにiContact がない場合には、追加データソースとしてダウンロードします。
- 接続プロパティに入力をします。
iContact アカウントで「Settings & Billing > Integrations」に移動し、Custom API Integration を作成します。AppId、Username、Password、AccountId はすべて、その連携の Getting Connected ページで確認できます。
- ［接続のテスト］をクリックして、正しく接続できているかをテストします。
- ［変更を保存］をクリックします。
iContact インスタンス毎のクエリの設定
Data Sync はレプリケーションをコントロールするSQL クエリを簡単なGUI 操作で設定できます。
レプリケーションジョブ設定には、［ジョブ］タブに進み、［ジョブを追加］ボタンをクリックします。
次にデータソースおよび同期先をそれぞれドロップダウンから選択します。
テーブル全体をレプリケーションする
テーブル全体をレプリケーションするには、［テーブル］セクションで［テーブルを追加］をクリックします。表示されたテーブルリストからレプリケーションするテーブルをチェックします。
テーブルをカスタマイズしてレプリケーションする
レプリケーションはテーブル全体ではなく、カスタマイズが可能です。［変更］機能を使えば、レプリケーションするカラムの指定、同期先でのカラム名を変更しての保存、ソースデータの各種加工が可能です。レプリケーションのカスタマイズには、ジョブの［変更］ボタンをクリックしてカスタマイズウィンドウを開いて操作を行います:
- チェックボックスでフィールドを追加もしくは削除
- カラムリストの下に新しく計算されたフィールドを追加する
- フィルタセクションを利用してフィルタを追加する
インターフェースを使って変更を行うと、レプリケーションのSQL クエリは以下のようなシンプルなものから：
REPLICATE [Campaigns]
次のような複雑なものになります:
REPLICATE [Campaigns] SELECT [ClientFolderId], [CampaignId] FROM [Campaigns] WHERE [Name] = Summer Newsletter 2024
レプリケーションのスケジュール起動設定
［スケジュール］セクションでは、レプリケーションジョブの自動起動スケジュール設定が可能です。反復同期間隔は、15分おきから毎月1回までの間で設定が可能です。
レプリケーションジョブを設定したら、［変更を保存］ボタンを押して保存します。複数のiContact のデータ のジョブを作成して、Salesforce の外部オブジェクトとして利用可能です。
外部オブジェクトとしてiContact データレプリケーションにアクセス
iContact のデータ がHeroku 上のPostgreSQL データベースとしてレプリケーションされたので、Heroku のOData インターフェースを設定し、Salesforce Connect から外部オブジェクトとしてデータ連携できるようにします。
Heroku のOData Service を設定します
まずは、Heroku 上のPostgreSQL データベースに複製されたiContact のデータ への接続のために、データベースに対しHeroku External Object を設定します。
- Heroku ダッシュボードで、［Connect Add-on］ をクリックします。
- ［External Objects］を指定します。はじめてHeroku External Object を使用する場合には、OData Server のログインクレデンシャルを作成するようにナビゲートされます。
- OData service URL およびクレデンシャルを確認します。このクレデンシャルをSalesforce Connect 接続時に利用します。
- ［Data Sources］において、前のプロセスで作成したレプリケーション済みデータベースを設定します。
詳しくは、こちらのHeroku documentation を参照してください。
Salesforce の外部データソースの設定
Heroku のOData サービスの設定が終わったら、Salesforce Connect を使って、複製されたiContact のデータ のデータに外部データソースとして連携します。
- Salesforce で設定をクリックします。
- Administration (管理)セクションで、［データ］→［外部データソース］をクリック。
- データソースパラメータプロパティを設定します:
- External Data Source: Salesforce UI に表示される名前
- Name: API の一位の識別子
- Type: Salesforce Connect: OData 4.0
- URL: Heroku Connect のOData エンドポイント
- Format: JSON
- 認証の設定:
- Identity Type: Named Principal
- Authentication Protocol: Password Authentication
- Username: Heroku Connect username
- Password: Heroku Connect password
- ［保存］をクリック。
iContact オブジェクトの同期
Salesforce の外部データソース登録が終わったら、次の方法でiContact 外部データソースに変更を反映させます。iContact テーブルの定義とiContact 外部オブジェクトの定義を同期します。
- 作成した外部データソースのリンクをクリック。
- ［Validate and Sync］をクリック
- iContact テーブルを選択して、［同期］をクリックします。
Salesforce オブジェクトとしてiContact データにアクセス
これで、レプリケーションされたiContact エンティティに対して、Salesforce の通常オブジェクトと同じように外部オブジェクトとしてアクセスが可能になりました。
是非、CData Sync の30日の無償評価版 をダウンロードして、Salesforce との連携をお試しください！