OutSystems開発において、これから外部システム接続の中心になりそうなIntegration Builder。
以前は、Personal Environmentでは試せなかったのですが、いつのまにか可能に。
SalesforceのDevelopler Editionを使って、動作確認が行えました。
この記事は、Personal Environmentによる動作確認の手順のメモです。
確認環境
Personal Environment(Version 11.13.0 (Build 31107))
Service Studio (Version 11.11.12)
Integration BuilderはSaaS：https://integrationbuilder.outsystems.com/
Salesforce Developer Editionを用意
Developer Editionは、https://developer.salesforce.com/ja/
にアクセス。
右上のサインアップを選択し、フォームに必要な情報を入力します。
入力したメールアドレスに確認のメールが来るので、「アカウントを確認」ボタンをクリック。
確認後ログインできるようになるので、後で動作確認に使うTODOに1レコード追加しておきます。
（画面上部のToDoのリンク → 新規ToDoでレコードが追加できる）
Integration Builderにログイン
未ログインの状態でアクセスすると、ログインフォームにリダイレクトされます。
EnvironmentにPersonal EnvironmentのURLを設定。
（https://www.outsystems.com/Portal/Trial_Portal
のYour Infrastructure）。
UsernameとPasswordはOutSystemsアカウントのものを利用する。
Integration BuilderでSalesforceとのIntegrationを作成
Salesforceへ接続
まず、Create Integrationボタンをクリックして開始。
Choose a providerでSalesforceを選択します。
どちらが正しいのかわかりませんが、とりあえずProductionで試してみました。
ここで、Salesforceへのサインインが要求されます。
許可をクリック。
接続するオブジェクトを選択する
Nextで次のステップへ。
デフォルトでSalesforceにあるオブジェクトが画面左にリストアップされるようです。
無難そうなのでTODOを選択してみました。すると右側に、TODOのfieldが表示されました。
チェックボックスが表示されているので、そのfieldを選択するように見えます。
とりあえず、デフォルトのまま（全field選択）に。
OutSystemsの開発環境にアプリケーションを作成する
Nextで次のステップへ。
App name：OutSystems開発環境に作成するコネクタアプリケーションの名前
Integration module name：OutSystems開発環境でアプリケーション開発者が利用するモジュールの名前
Driver module name：Integrationから利用され、直接Salesforceに接続するモジュールの名前
この画面の右下に、1-Click Publishボタンがあるのでクリックする。
生成されたアプリケーションの情報が表示されました。
Connectionの設定
ここで、環境にインストールされた、Integration Managerへリダイレクト。
さらにIM_Salesforceモジュールへリダイレクトされました。
この右でConnectionを選択するようです。Salesforce Development Connectionがデフォルトであったのでとりあえずこれを選択（ただし、このConnectionはテスト目的専用とのこと）。
Finishボタンをクリック。これでIntegration Builderでの設定は終了のようです。
アプリケーション開発
ここからは、Service Studioで作業します。
こんな感じのアプリケーションができていました。設定時に指定した名前通りですね。
テスト用アプリケーションでManage Dependenciesを開き、_ISモジュールのServer Actionへの参照を追加します。
DataActionを作成し、以下のように実装してみました。
CountToDoは、ToDoの中に入っているデータ件数を返すようです。
パラメータは無指定にしておきました。
GetToDoは、指定したIdのレコードを返してくる。
パラメータは、Salesforce上でToDoの1レコードを選択すると、URLの/viewの手前にIdが含まれるようです。
テストなので、それぞれのActionのOutput ParameterのAttributeを適当に文字列として結合してみました。
想定通り、CountToDoはデータ件数の1、GetToDoはSalesforceレコードに含まれていた件名を含む属性データが返ってきました。
ただ、オブジェクト名、field名に日本語が含まれているとOutSystemsにマッピングするときに問題があります。オブジェクト名はEntity名にマッピングされますが、日本語の部分が「_」になり、Attributeは名前が「AttributeN」（Nの部分が連番）にマッピングされてしまいました。
これはちょっと使いにくい。