Blog
 
  • Blog
  • Salesforce の取引先データをMonacaアプリで取得してみる

Salesforce の取引先データをMonacaアプリで取得してみる

by 宮本航太 | February 25, 2020

こんにちは、エンジニアの宮本です。

前回の記事で SQLServer に格納されている Lead データを、 Monaca 上で作成したアプリで一覧表示させてみました。

https://jp.cdata.com/blog/2020-02-21-094902

その記事の中で最後に、

ちなみに APIServer クラウド環境で構成したい場合は、AWS AMIでクラウド・ホスティングのAPI Server で簡単に構成できます。

と書きましたので、今回はAWS AMI の ホスティングされた APIServer と、前回作成したMonacaアプリをインポートして、 Salesforce のデータを表示するアプリを作成していきます。アプリは前回作成したものをインポートして使いまわします。

構成

f:id:sennanvolar44:20200221155612p:plain
AWS AMI の APIServer で Salesforce のAccount オブジェクトだけAPIを公開し、Monaca上のアプリで参照する構成です。
また、AMI の APIServer 初期設定では Salesforce を選択することができませんので、CData Salesforce JDBC Driver をAPISever のインスタンスにインストールして、データソースを追加していきます。
なお、他の JDBC Driver をインストールすれば、Salesforce 以外のデータソースも 追加することが可能です。対応データソースは以下リンクをご参照ください。

API Server: データベースから簡単にREST API を開発・運用

必要なもの

実施手順

ざっくりとした手順は、

  • AMI で APIServer を構成
  • APIServer に Salesforce JDBC Driver を組み込む
  • Monaca で前回のアプリプロジェクトをインポート
  • アプリをSalesforce のAccountオブジェクトの内容に修正
  • スマホで確認

となります。では、始めていきます。

AMI で APIServer を構成

こちらのURL（https://jp.cdata.com/apiserver/）から、 AWS (AMI) のAPIServer 用意できます。APIServer のインストールや外部公開も最初から設定されているので、ものすごく楽に環境を用意できます。

まずは「AWS MARKETPLACE」ボタンをクリックして進めていきます。

f:id:sennanvolar44:20200221144915p:plain

「Continue to Subscribe」ボタンをクリックします。

f:id:sennanvolar44:20200221150502p:plain

「Continue to Configuration」ボタンをクリックします。

f:id:sennanvolar44:20200221151552p:plain

左の赤枠の内容を選択後、「Continue to Launch」をクリックします。
※Region は Tokyo じゃなくても大丈夫です。

f:id:sennanvolar44:20200221151846p:plain

「Security Group Settings」や「Key Pair Settings」を選択した後、下にある「Launch」ボタンをクリックします。

f:id:sennanvolar44:20200221152451p:plain

たった数ステップだけで APIServer が完成しました！

f:id:sennanvolar44:20200221152716p:plain


[Salesforce] Account オブジェクトの APIを生成

まずは、APIServer に Salesforce JDBC Driver を配置しますので、CData のWEBサイト(https://jp.cdata.com/drivers/salesforce/download/jdbc/)よりダウンロードします。30日間無料でご利用いただけます。

ダウンロードした setup.jar を APIServer にアップロードし、インストールを行っていきます。
今回は WinSCP ファイル転送ツールを使います。接続はホスト名、ユーザ名にcentos、SSHでAMIでインスタンス作成した際に指定した秘密鍵をセットし、ログインします。
※アップロード方法は別方法でも良いです。

f:id:sennanvolar44:20200221172225p:plain

接続したら、setup.jar を適当な場所にアップロードします。

f:id:sennanvolar44:20200221180626p:plain

アップロードしましたら、Teraterm などで接続して setup.jar を実行します。インストールはそのまま進んで大丈夫です。

f:id:sennanvolar44:20200221181301p:plain

インストールで指定したパスに、Salesforce JDBC Driver がインストールされています。その Jar ファイルと lic ファイルを APIServer に配置します。配置後、オーナーを jetty に変更します。
コマンド以下の通りです。

ここでインスタンスをリブートして APIServer で Salesforce を扱えるようにします。

リブートが完了したら、ブラウザからアクセスしてみてください。
ログイン画面が表示されますので、以下内容を入力してログインします。

  • User：admin
  • Password：EC2 のインスタンス ID

f:id:sennanvolar44:20200221153955p:plain

以下内容を読んだ後、「I Agree」をクリックします。

f:id:sennanvolar44:20200221154658p:plain

TOP画面が表示された後、ヘッダーの「SETTINGS」→「Connections」とクリックすると Salesforce のアイコンが表示されます。これで APIServer でも Salesforce を扱うことができるようになりました。

f:id:sennanvolar44:20200221183721p:plain

Salesforce のアイコンをクリックすると以下の画面が表示されます。接続情報を入力して接続のテストを行った後、右上の「Save Change」ボタンで保存します。

f:id:sennanvolar44:20200221184108p:plain

次はSalesforce のどのオブジェクトのAPI を生成するか決めていきます。「Resources」→「Add Resource」をクリックします。

f:id:sennanvolar44:20200221222947p:plain

「Salesforce」を選択し「Next」で次に進みます。

f:id:sennanvolar44:20200221223456p:plain

Account オブジェクトを選択します。

f:id:sennanvolar44:20200221224245p:plain

公開する Account オブジェクトの API の機能制限や、対象の項目などを制御することができますが、今回はそのままでいきます。

f:id:sennanvolar44:20200221224418p:plain

これで Salesforce の Account オブジェクトの API を生成することができました。

f:id:sennanvolar44:20200221224853p:plain

ヘッダーの「API」をクリックすると、実際に生成した API の URL などを確認することができます。

f:id:sennanvolar44:20200221225103p:plain

あとは接続ユーザと接続可能な IPアドレス、クロスドメインアクセス 許可の設定をしていきます。

まずは接続可能なユーザを作成していきます。以下のキャプチャの順でクリックし、ユーザを作成していきます。

f:id:sennanvolar44:20200220114707p:plain

ユーザ名を「User or Group」に入力します。また CRUD の制限もかけずにします。下のキャプチャのように全てにチャックを入れた後、「Save Changes」ボタンをクリックします。

f:id:sennanvolar44:20200126174130p:plain

以下のように Authtoken が発行されたユーザが作成されます。あとで Authtoken を使いますのでどこかに保持しときます。

f:id:sennanvolar44:20200126180412p:plain

次に、接続可能な IPアドレス の制御行っていきますので、「Server」タブをクリックします。

f:id:sennanvolar44:20200126180845p:plain

一番下にスクロールすると、接続できる IPアドレスの設定箇所があります。「Add」ボタンをクリック後、全て許可の アスタリスク(*) を登録します。（IPアドレスの指定がある場合はここで設定してください）

f:id:sennanvolar44:20200126181043p:plain

最後に、クロスドメインアクセスの許可を行います。「Server」タブより以下画面に遷移できます。赤枠部分のチェックボックスにチェックを入れ、「Save Changes」をクリックして完了です。

f:id:sennanvolar44:20200222165037p:plain

以上で APIServer の設定が完了です。

Monaca アプリのプロジェクトを再利用

前回作成したアプリのプロジェクトをインポートして、再利用していきます。 こちらからダウンロードして zip ファイルを取得します。

github.com

Monaca を開き、「インポート」をクリックします。

f:id:sennanvolar44:20200221230526p:plain

「ZIPファイル」をクリックし、先ほどダウンロードしたZIPファイルを選択します。その後、そのまま進んでいきプロジェクトを作成します。

f:id:sennanvolar44:20200221230727p:plain

インポートしたプロジェクトを選択後、「クラウドIDEで開く」をクリックします。

f:id:sennanvolar44:20200221231932p:plain

今回はインポートしたアプリをほぼ踏襲します。が、取得するデータが違うので、Account データの内容が反映されるよう修正します。

変更部分は、URL、セキュリティトークン、詳細画面の内容をSalesforceのデータに合わせたくらいです。以下にコードを貼り付けています。

動作確認

Salesforce の Account データを取得するアプリが動くことを確認できました。

f:id:sennanvolar44:20200224000229p:plain

最後に

今回は AWS の AMI で構成した APIServer に JDBCDriver インストールしてデータソースを追加しました。同じ手法で Salesforce 以外のデータソースも追加できますので、もし気になるものがあればお試しいただければと思います。

www.cdata.com

CData API Server Salesforce Monaca モバイル CData API Server ソリューションとユースケース
関連コンテンツ
ロードバランサー（ALB）を使ってAMI版 API Serverを冗長化 国産iPaaS BizteX Connect で SQL Server のデータを kintone に連携 Docker コンテナ（Tomcat）上のAPIServer にコネクタを追加する： 管理用DB利用偏 Salesforce とBigQuery のデータをもとにActionista! でダッシュボードを作成してみた：CData JDBC Driver CDataSyncをGoogle Cloud PlatformでHTTPS化（SSL化）してホスティングする方法 オンプレOracle DB にCloudGateway 経由でGoogleAppsScript からWEB APIでアクセスしてみた：CData APIServer オンプレOracle DB にSSHサーバ経由でGoogleAppsScript からSQLでアクセスしてみた：SQLGateway Dataiku データサイエンスプラットフォームで CData JDBC Driver を活用する方法 CData APIServer 経由でSQLServer のデータをMonacaのアプリで扱う CData APIServer と AppSheet でモバイルアプリを作成してみる