Salesforce のデータを使用する

AppSheet を使用して、Salesforce のデータからモバイルアプリを作成できます。一般的なアプリでは、Salesforce のデータを他のデータソースのデータと結合します。

始める前に

Salesforce アカウント管理者は、ユーザー向けの AppSheet「パッケージ」を Salesforce インスタンスにまずインストールする必要があります。簡単に言えば、AppSheet が SalesForce データへの接続を許可されていることが、それによって Salesforce インスタンスに通知されます。

• Salesforce サンドボックス環境にデプロイする場合、こちらのリンクを使用してください。
• Salesforce 本番環境にデプロイする場合、こちらのリンクを使用してください。

注: AppSheet は、Salesfoprce API を使用して Salesforce インスタンスと通信します。Salesforce のドキュメントによると、この API は Salesforce の Enterprise、Unlimited、Developer の各エディションで自動的に有効になります。Professional エディションのユーザーは、Salesforce から別途、API アクセスを購入する必要がある場合があります。

AppSheet で Salesforce を使用する

注:

• Salesforce のデータを使用する場合、Row ID 列の初期値を UNIQUEID() に設定することは必須ではなく、設定しても影響がありません。Salesforce は、独自の一意の ID を使用して行 ID 列を設定します。
• AppSheet では、ポリモーフィック関係の列はサポートされていません。
• AppSheet の列設定に Salesforce の列が表示されない場合は通常、AppSheet でサポートされていない Salesforce のデータ型が使用されていることを意味します。

AppSheet アカウントを作成する際に、Salesforce を認証プロバイダとして使用できます。つまり、メインのログインは Salesforce アカウントに基づいて行うことができます。

Salesforce のサンドボックス インスタンスに AppSheet をインストールしている場合、ログインに使用する URL の変更が必要になります。クエリ文字列に sandboxInstance=true が含まれる URL を使用して、データソースの追加時に保持されるようにしてください。次に例を示します。

https://www.appsheet.com/account/login?sandboxInstance=true

https://www.appsheet.com/Account/AddSource?sandboxInstance=true?returnUrl=%2FAccount%2FAccount%23_tab_acctSources

これはブラウザからログインする場合に実施可能で、エミュレータ環境または全画面表示のブラウザ環境で動作することに注意してください。ただし、モバイルアプリは Salesforce の本番環境インスタンスまたはデベロッパー インスタンスに対してのみ動作します。

Salesforce アカウントをデータソースとして AppSheet アカウントに追加するには:

1. [My Account] > [Sources] タブに移動します。
2. [+ New Data Source] をクリックします。
3. データソースの名前を入力して、[Salesforce] をクリックします。

Salesforce がサポートしている OAuth プロセスを介して Salesforce インスタンスにログインすることを求められます。

Salesforce データソースがアカウントに追加されると、既存のテーブルを任意のアプリに追加できます。アプリで [+ New Table] を選択すると、特定のデータソースと、そのデータ・ソースからのテーブルを選択できます。

アプリに追加されると、AppSheet はすべてのデータソースを同様に扱います。実際、Salesforce データソースからのデータと他のソースからのデータを同じアプリ内で組み合わせることは一般的であり、自然なことです。

注: Salesforce では、日付コンポーネントがない時間データのみの保存はできません。サポートされているのは DateTime タイプだけです。Salesforce コネクタをアプリケーションに使用する場合、Time データタイプではなく、DateTime データタイプを必ず使用してください。使用しないと JSON パーサーエラーを受信することになります。

テンプレート アプリを Salesforce にコピーする

AppSheet は標準テンプレート アプリのギャラリーを備えており、データソースと認証プロバイダ全体で均一に機能することを目的としています。アプリ作成者がサンプルアプリのコピーを作成し、ニーズに合わせてコピーを変更することは一般的です。テンプレート アプリデータは Salesforce データソースにコピーできますが、いくつかの制限があります。テンプレート アプリ内の各テーブルは、Salesforce 内のカスタム テーブルとして作成されます。ただし、Salesforce プラットフォームによって適用される命名規則のため、すべてのカスタム オブジェクト名とフィールド名の先頭には appsheet_ が付き、末尾には __c が付きます。このため、テーブルと列の名前を使用する数式がある場合、テンプレート アプリにおいてエラーが発生する可能性があります。これらのエラーは手動で修正する必要があります。

画像を Salesforce に保存する

AppSheet は、画像とファイルの列を特別な方法で扱います。AppSheet アプリが画像やファイルをキャプチャして保存すると、AppSheet はプロバイダのファイル システム上に画像やファイルごとに新しいファイルを作成し、そのファイルに画像やファイルのデータを書き込みます。その後、このファイルの名前を Salesforce テーブルの画像またはファイルの列に挿入します。ファイルは、アカウントのデフォルトのフォルダパスのサブフォルダ（通常、/appsheet/data/appName）に保存されます。アカウント ページの [Settings] タブで、デフォルトのフォルダパスの表示や変更ができます。

Salesforce からの画像とファイルを使用する

Salesforce のデータの一部（リードなど）には、PhotoUrl 列が含まれます。アプリ内で表示されるこれらの写真が必要な場合、写真は一般公開されている必要があります。それには、Salesforce アカウントの [External Sharing Model] を有効にする必要があります。次に示すように、Salesforce の [Sharing Settings] コントロール ペインから実行してください。