Recommended
Recommended
More Related Content
What's hot
What's hot (20)
Similar to Salesforce連携のためのOData入門
Similar to Salesforce連携のためのOData入門 (11)
More from Shunji Konishi
More from Shunji Konishi (20)
Recently uploaded
Recently uploaded (9)
Salesforce連携のためのOData入門
- 2. Heroku Postgres上のデータをSalesforceの外部オ ブジェクトとして参照したいらしい ODataの細かい仕様がどうなっているのかという点に は全く踏み込んでいない ◦ 所詮2，3日調べた程度なので多くを期待してはいけない
- 3. Open Data Protocol ◦ http://www.odata.org/ ◦ Microsoft が主導で推進しているらしい httpのREST APIだけでデータの参照・更新・削除を 行うための仕様 SQLのhttp版くらいに思っておけばOKだと思う ◦ ↑というか、まさに今この程度の理解 ◦ 具体的な検索条件やソートの指定の仕方等はなんとなく試し てみた程度でちゃんと調べてはいない
- 4. httpだけでデータを読み書きできることにつきる CORS(Cross Origin Resource Sharing)との組み 合わせを考えるとこんな状況もありえるかも？ ◦ 近年色々な鉄道会社が時刻表や電車の遅延情報などをAPI で提供し始めている(気がする) ◦ しかし、それぞれの鉄道会社はAPIはRESTではあっても全部 独自形式(知らないけど多分) ◦ 各社のAPIはCORSには対応していないのでブラウザから直 接は叩けず、サーバで実行するしかない(に違いない) ◦ CORSとODataがサポートされればブラウザから直接各社の データに統一規格でアクセスできるのサーバ不要でアプリが 作れる(公開先はもはやGitHub.ioで良いですね(^^v) まぁ希望なんで当分なさそうではあるけど
- 5. V1からV4まであるらしい ◦ V4は近日正式リリース予定らしい どこが変わったのかは知らないけど、多分できること が増えているのであろう 現在広く使われているバージョンはV2 ◦ かどうかは確信が無いが、とりあえずSalesforceの外部デー タ参照でサポートされているのはV2のみ ◦ V4も近い将来サポートされるらしい
- 6. http://www.odata.org/libraries/ MS主導のため.NETのライブラリが一番充実している Javaのライブラリで有力なのは以下の二つ ◦ Apache Olingo V2 and V4 サーバ／クライアント両対応 ◦ odata4j V1 – V3 サーバ／クライアント両対応 odata4jはコミットログを見る限り停滞しているように 見えるので、Olingoを使うのが良さげ
- 7. 一部クラスがServlet API依存なので、Play等の非 Servletから扱うのはしんどい ◦ やりかけたけど途中であきらめました。 ライブラリの完成度はやや怪しいかも。。。(-- ◦ 2,3日の評価なんで何とも言えないけど(後述) Ｖ４はまったく未検証
- 8. https://github.com/shunjikonishi/odata- producer Olingoで作成したOData Producer ◦ JPAのエンティティを作成することでテーブルをODataとして 公開出来る ◦ サンプルデータとして、Car, Makerという二つのテーブルと テストデータを生成する ◦ ベーシック認証対応
- 9. サンプルはHeroku上で公開されているので以下の URLにアクセス ◦ BasicAuth: test/password ◦ http://flect-odata-test.herokuapp.com/odata ◦ http://flect-odata-test.herokuapp.com/odata/$metadata ◦ http://flect-odata-test.herokuapp.com/odata/Cars ◦ http://flect-odata-test.herokuapp.com/odata/Cars(1) ◦ http://flect-odata- test.herokuapp.com/odata/Cars?$filter=Car_name%20eq%2 0%27LEGACY%27
- 10. 設定 ＞ 開発 ＞ External Data Sources 設定項目 ◦ サーバURL: OData ProducerのURL (Ex. https://flect-odata-test.herokuapp.com/odata) ◦ 種別: OData 2.0 ◦ 形式: AtomPub ◦ Basic認証を設定した場合以下の認証設定が必要 ◦ ID種別: 指定ユーザ ◦ 認証プロトコル: パスワード認証 ◦ ユーザ名とパスワード
- 11. 設定 ＞ 開発 ＞ 外部オブジェクト ◦ 外部データソースを指定する以外は通常のカスタムオブジェ クトとあまり変わらない ◦ API参照名には「__x」が付加される ◦ 作成直後は外部IDと表示URLだけが項目として設定されて おり、各フィールドは手動でカスタム項目として追加する必要 がある データ型等を指定できる 大文字小文字の差異に注意($metadataでフィールド名を確認 しながら設定を行うと良い) ◦ 他の外部オブジェクトや標準／カスタムオブジェクトに対して 参照関係が設定できる 多分、通常の参照／親子関係と同じ感覚で使用できると思う
- 12. Car#maker_id -> Maker#maker_idの参照関係 を設定した例(デフォルトのまま)
- 13. サブクエリ等も使えるがSOQLとして正しくてもエラー となるケースもあるらしい 成功するクエリの例 ◦ SELECT car_name__c, maker__r.maker_name__c FROM car__x WHERE maker__r.maker_name__c = 'HONDA’
- 14. EXTERNAL_OBJECT_UNSUPPORTED_EXCEPTION ◦ LIKE検索で発生 ◦ ODataのfilterにLIKE構文はない QUERY_TOO_COMPLICATED ◦ 参照テーブルにLIKE構文を使用したらエラーコードが変わっ た ◦ これもfilterの制限と思われる 原理的にODataでサポートしていない検索はできないはず
- 15. http://flect-odata- test.herokuapp.com/odata/Cars?$filter=inde xof(Car_name, ‘WING’) eq 0 仕様にあるfilterのindexofとか実装されていない。 ただし、SalesforceからのOdata APIのキックでOlingo側の 未実装が問題となるケースには遭遇していない
- 16. External Datasourceの設定画面にこんな項目がある 多分filterのカスタム関数を自前で作ればそれが使えるんだと 思う この辺を参考にすれば実装できそう http://olingo.apache.org/doc/odata2/tutorials/Olingo_T utorial_AdvancedRead_FilterVisitor.html 必要に迫られれば作る(PullRequest歓迎)
- 17. https://github.com/shunjikonishi/odata- producer をフォーク 環境変数DATABASE_URLに接続先のPostgreSQLの URLを定義 ◦ 現在はPostgreSQL固定になっているので、MySQL等を使う場合 はHerokuEntityManagerFactoryとpersistense.xmlの修正が 必要 サンプルエンティティ(src/…/entities/*.java)を削除 公開したいエンティティをentities以下に定義 いじょ ◦ ローカルでの動作確認はrun.sh(run.bat)でできます。 ◦ Herokuで動かす場合は環境変数「APP_OPTS」でBASIC認証が 設定できます。
- 18. JPAのエンティティとして定 義する ◦ Lombokが入っているので getter/setterは不要 余計な修飾は一切いらな い ◦ OneToManyとか ManyToOneとかは Salesforce側で解決される ので不要 ◦ 下手に付けるとOlingoがエ ラーで落ちることがある ◦ @Columnでフィールド名を 変更しても良いけど Salesforce側でも設定でき るのであまり意味はない
- 19. 紆余曲折あったが、結局のところ公式ドキュメント (http://olingo.apache.org/doc/odata2/index.htm l)のJPAの章ほぼそのままで動いた ただしデフォルトでは例外発生時にStackTraceがでない のでそこだけは手を入れた方が良い ◦ MyODataJPAServiceFactory#getCallback参照 ◦ 当初OneToManyの定義が書き方によって動かなくて、原因を特 定するのにえらい苦労した フックポイントは多いので多分何でもできるはず ◦ ODataの仕様書をちゃんと読めばね。。。。 ◦ ちょいちょいNot implementedを見かけるがそれも自力で解決で きると思われる ちゃんと使おうと思ったら絶対ソースは読むべき(基本)
- 20. とりあえずSalesforceから参照可能なODataProducerを 作るだけなら難しくはない ◦ 現状一番の問題はLIKEが使えないこと ◦ 認証がBASIC認証だけで良いかは課題 HerokuのOAuthを使っても良いけどあんまり意味が無い気がする ◦ パフォーマンス、実用性などは実案件に即した検証が必要 V4の今後がどうなるかは謎なので現状V2でどこまで作り 込むべきかは不明 ◦ 1年以内にV4が来るならV2での実装は不要と思う ◦ しかしOlingoのV4ドキュメントは現状ほとんどない。。。(-- OData自体はSalesforceと関係なくWatchする価値のあ る技術