Heroku ConnectのGetting Started
Dev CenterのGetting Started on Heroku with Heroku Connectに添って進めていけば、SalesforceのテーブルがPostgresのテーブルと同期するところまで試せます。サンプルアプリはsinatraとsinatra-activerecordを使っています。
Salesforceは開発に利用できる無料のDeveloperEditionがあるので[ここからサインアップしておきます]。
しばらくするとメールが来るのでパスワードを設定してログインします。
ログインするとこんな画面になりますが、サンプルアプリで使うのは「取引先責任者」です。イマイチ意味の分からない翻訳ですがContactのことです。ちなみに取引先がAccountです。
取引先責任者を開いたら、ビュー→すべての取引先責任者→Go
DeveloperEditionにサンプルで入っている取引先責任者が表示されます。Getting Startedを進めていくと、これがPostgresに同期されます。
最初のデプロイ
Getting Startedのこのステップでは、Heroku Buttonでこのサンプルアプリをデプロイします。フリープランのHeroku PostgresとHeroku Connectがインストールされます。
同期設定
ダッシュボードからデプロイしたアプリを開き、Heroku Connectアドオンを開きます。
最初はPostgresとSalesforceの設定です。Setup Connection→Next→Next→Salesforceにログイン→アクセス許可と進めます。
Create Mappingをクリックすると、Salesforceのテーブル(Salesforce用語ではオブジェクトといいます)一覧が出てくるのでContactを探してクリックします。右上に検索ボックスがあります。
同期間隔、双方向同期するか、どのカラム(Salesforce用語では項目)を同期するかを設定できます。
Mapped Fieldsで以下の3つを選んで右上のSaveで保存します。
- FirstName
- LastName
同期確認
次のステップはDataclip、その次のステップはGitHub連携の話です。その次がソースコードを修正してGitHubからデプロイする説明ですが、heroku git:clone --app アプリ名して手元で書き換えてgit push heroku masterでよいでしょう。
書き換える、というかコメントアウトを解除するのはapp.rbのこの辺です。
class Contact < ActiveRecord::Base
self.table_name = 'salesforce.contact'
end
# ↓この4行のコメントアウトを解除する
get "/contacts" do
@contacts = Contact.all
erb :index
end
https://アプリ名.herokuapp.com/contactsを開くと同期されていることが確認できます。
アドオンダッシュボードのGUIで同期設定すると、Heroku Connectが使うPostgresのスキーマにテーブルができるのでマイグレーションする必要はありません。むしろ勝手にテーブルを作るとアドオンGUIでエラーになります。