この記事では、Salesforce から OData 4.0 としての Oiyokan に接続するときのポイントを紹介します。なお、Oiyokan そのものの説明については、こちらの記事を参照ください

Salesforce から利用可能な OData v4 情報

Salesforce Connect から接続可能な OData v4 として構成するにはいくつか満たしておくべき条件があります。

Entity には Keyが必要です
- つまり、テーブルには基本的に Primary Key が必要です
- OData v4 仕様としても Entity には Key が要求されます
- Key がない場合、Salesforce が $metadata を読み込む際にエラーが発生します (その場合、親切ではないエラーメッセージが表示される可能性があります)

現時点での Salesforce から利用可能な Oiyokan のサポート型マッピングは以下の通りです。

Edm.TimeOfDay は Salesforce がサポートしません。無理に利用しようとすると不親切なエラーが発生する可能性があります。
Edm.Guid は現時点では Oiyokan がサポートしないため利用できません。(Oiyokan の仕様に由来する利用不可です。JSON設定ファイルを直接編集して Binary にマップすると読み込みは可能になります)
Oiyokan の Edm と JDBC Types との詳細なマッピング情報はこちらの記事を参照。

Oiyokan Initializr の $filter: Treat null as blank にチェックを入れて、文字列を NULLで検索する場合に長さ0の文字列も検索結果に含めるようにします。
- これにより、Salesforce がブランク文字列を null として検索する仕様に一部対応することができるようになります
- 仮にこれを指定しない場合、RDB上のブランク文字列を条件にした検索に Salesforce の標準画面や Apex などからの検索でヒットできません

`Trailhead` `Playground` からの設定例

ここからは Trailhead Playground からの設定例の手順を示します。

これ以降の手順は、Heroku に Oiyokan がデプロイ済みで、以下の URL により OData v4 アクセス可能な状態になっている前提で記載します。

Note: この URL は記事執筆時点 (2021-05-16) では読み書き可能ですが、将来的には書き込みできなくなる可能性があります。

「検証して同期」をクリックして設定の正しさを検証して同期します。

「検証して同期」が成功するとテーブル名が一覧表示されます。利用したい「テーブル名」のチェックボックスをONにして「同期」をクリックします。

テーブルの同期が成功すると外部オブジェクト一覧に追加表示されます。「検証」をクリックして確認します。

「クエリの実行」をクリックして検証を実施します。「成功したクエリ」に表示されることを確認します。

Note: RDBの設定によっては、ソート順が Salesforce の期待するものと一致しない場合があります。この差異が出るのは Oiyokan としての仕様です。

追加された外部オブジェクトには Salesforce 標準機能や Apex などからアクセス可能になります。

初出: 2021-05-16