Node-REDは主にIoT領域でサービス連携に使われてますが、Node-RED を使用してリアルタイムのチャット・アプリケーションを 5 分で作成するのようにWebページ/アプリケーションを作ることも可能です。
ということは、SalesforceのCanvasを使えばNode-REDで作成したWebアプリケーションがSalesforce内で使える!ということで、このたびnode-red-contrib-forceにSigned Requestを検証&デコードするノードを作りました。
以下、チュートリアル的に紹介します。
Node-REDをHerokuで動かす
Node-REDをHerokuで動かすには以下のHerokuボタンをクリックしてください(以下、例として https://node-red-123.herokuapp.com にデプロイしたものとします)
何もしないとNode-REDのエディタ画面がフルオープンになってしまうのでHerokuの環境変数としてNODE_RED_USERNAME
とNODE_RED_PASSWORD
を必須としてます。ユーザ名とパスワードを決めて入力したら "Deploy for Free" ボタンをクリックしてください。
![スクリーンショット 2015-12-22 14.53.35.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.amazonaws.com%2F0%2F21109%2F1fc03a74-4507-0be9-d8f5-733059e50c55.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=b9c907c479baee36f77a9f1ccd27a73b)
デプロイしたらホストにアクセスしてみます(今回の例ですと https://node-red-123.herokuapp.com )以下のような画面が表示されますので "Go to your Node-RED flow editor" ボタンをクリックします。
![スクリーンショット 2015-12-22 14.56.44.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.amazonaws.com%2F0%2F21109%2Fe63a4c32-a9bb-bff2-1f11-b14b6185594c.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=2f5d89b035ac82b947fbcae860a599bf)
するとログイン画面に遷移しますので先ほどHerokuデプロイ画面で設定したユーザ名とパスワードを入力してログインします。
![スクリーンショット 2015-12-22 14.58.54.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.amazonaws.com%2F0%2F21109%2F4ddd9698-9015-2f00-3e29-8b8ec072aec7.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=e8b952ec280f04ac3bc9ca9b3691b798)
これで以下のようにNode-REDエディタ画面が表示されればOKです。今後、直接エディタ画面を開くには/red
を付与してアクセスします(今回の例ですと https://node-red-123.herokuapp.com/red )
![スクリーンショット 2015-12-22 15.01.06.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.amazonaws.com%2F0%2F21109%2F03db75b9-25c4-a3a0-b684-6c940daac448.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=b1c561bfa1c759d890fade3c8ca5f884)
あとは今回紹介するnode-red-contrib-forceというモジュール/プラグイン的なもの(Node-REDでは一つ一つのモジュール/プラグイン的なものをノードと呼びます)をインストールします。
node-red-contrib-forceを使うには、npm install -g node-red-admin
でnode-red-adminをインストールして以下のコマンドを叩きます。
$ node-red-admin target <Node-REDのエディタ画面のURL 例:https://node-red-123.herokuapp.com/red>
$ node-red-admin login
Username: <Herokuにデプロイする時に設定したユーザ名>
Password: <Herokuにデプロイする時に設定したパスワード>
Logged in
$ node-red-admin install node-red-contrib-force
Module: node-red-contrib-force
Version: 0.0.6
Nodes Types State
node-red-contrib-force/chatter force-chatter in enabled
node-red-contrib-force/forcedotcom force enabled
force in
node-red-contrib-force/forcedotcom-bulk force-bulk in enabled
node-red-contrib-force/forcedotcom-signed-request force signed request enabled
Node-REDでWebページを作成する
まず、以下のようにHTTP Inputノードをドラッグ&ドロップしてワークスペースの好きな場所へ置きます。
![スクリーンショット 2015-12-22 14.42.29.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.amazonaws.com%2F0%2F21109%2F6ed476cd-47cb-65e6-6be7-c6b14490ad90.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=61f15fdb83973c7670e27c3740552555)
次に配置したノードをダブルクリックするとノード定義用の設定ダイアログが開きますので以下のようにHTTP Inputノードに/canvas
というURLを設定します。これだけでNode-REDが動くHTTPのGETメソッドのエンドポイントを作成できます。
![スクリーンショット 2015-12-22 14.45.58.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.amazonaws.com%2F0%2F21109%2Fbbb7e963-0ce7-ffc9-f5a0-f0b7bcf42f94.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=3b49bfd54fc26c0ca6a3d7b41cea6567)
あとは表示するWebページを定義するTemplateノードとHTTP Outputノード(HTTPレスポンス)と念のためDebugノードを以下のように配置してDeployボタンをクリックします。上記でエンドポイントを定義したHTTP Inputノード以外はデフォルトのまま(配置してつなぐだけ)で良いです。
![スクリーンショット 2015-12-22 14.38.33.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.amazonaws.com%2F0%2F21109%2Fc81be80f-9543-b05b-1c7e-d318f7dee6c1.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=95332e7286152dc55d7c08775bb22e59)
ここまでできたところでNode-REDをデプロイしたホストにHTTP Inputノードで定義したエンドポイント(今回の例ですと https://node-red-123.herokuapp.com/canvas )へアクセスしてみます。
![スクリーンショット 2015-12-22 14.20.13.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.amazonaws.com%2F0%2F21109%2Fc927abae-f3c2-9f50-e106-c14dfa505804.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=3359a51efb3a8fda70f5f95516033aca)
Templateノードがデフォルト定義のままなので[object Object]
となってますがWebページが返ってきました。
続いて先ほどのURLに?aaa=111
というパラメータを付与して(今回の例ですと https://node-red-123.herokuapp.com/canvas?aaa=111 )アクセスしてみます。
表示されるWebページは変化ありませんがNode-REDのエディタ画面に戻るとデバッグに送信したパラメータが表示されています。
![スクリーンショット 2015-12-22 14.24.57.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.amazonaws.com%2F0%2F21109%2F18ffe898-5f07-8f71-3b49-e7dcd9370121.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=51b9cec1b0473049e10c55788034433a)
これはHTTP Inputノード([get] /canvas
)で受け取ったパラメータをNode-REDがJSONに変換してmsg.payload
というプロパティにセットしてDebugノードへ流した結果です。
![スクリーンショット 2015-12-22 14.26.05.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.amazonaws.com%2F0%2F21109%2F73e7fd73-2f18-1dd4-ddea-1f312a2c258a.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=314ae9ebbf81b6464e39c688126d465a)
これでNode-REDのノード同士を接続するラインを流れるメインのデータはmsg.payload
を流れているのが解るのでTemplateノードを以下のように変更してみます(Templateノードをダブルクリックすると設定ダイアログが開きます)
This is the payload: {{payload.aaa}} !
![スクリーンショット 2015-12-22 14.32.09.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.amazonaws.com%2F0%2F21109%2F9a9cc5bb-84b8-63ec-2f70-da6049180348.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=9d1daf908706afce275c9bccc6d0ca87)
これで再度デプロイします。
![スクリーンショット 2015-12-22 14.38.33.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.amazonaws.com%2F0%2F21109%2Fafd4e2ad-e353-53f1-92b0-f53193bb3be0.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=d71dbb59f450ab95da903008659e3676)
そして再度パラメータ付きでアクセスしてみますと(今回の例ですと https://node-red-123.herokuapp.com/canvas?aaa=111 )以下のようにパラメータの値がWebページ表示されます。あとは "111" を他の値に変えたりして仕組みを理解しましょう。
![スクリーンショット 2015-12-22 15.11.42.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.amazonaws.com%2F0%2F21109%2F0bac7844-8278-8450-63d5-795bc4a8653b.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=fb04530301be0b137099954f9ebc229c)
Salesforce Canvasに表示する
さて、前置きが長くなりましたが本題です。
まず接続アプリケーションの作成ですが基本的なSalesforce Canvasの設定についてはSFDC:Force.com CanvasでHerokuアプリと連携してみましたが詳しいです。
あえて補足しますと、以下のように "キャンバスアプリケーションの URL" に作成したエンドポイント(今回の例ですと https://node-red-123.herokuapp.com/canvas )アクセス方法を "署名付き要求(POST)" 、場所に "Visualforce ページ" を選択します。
![スクリーンショット 2015-12-22 15.22.35.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.amazonaws.com%2F0%2F21109%2F7cc1808b-cae8-7c5e-644f-518f52b25e01.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=70f0374d6772ccd61538fba92bf299ff)
接続アプリケーションのアクセス方法を "署名付き要求(POST)" に設定したので以下のようにNode-REDのエンドポイントもPOSTメソッドを受け付けるように変更します。
![スクリーンショット 2015-12-22 15.28.45.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.amazonaws.com%2F0%2F21109%2Fa0c1275f-e001-b8fa-b574-b78d0e05ac8c.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=96123479141a0e8d042a499803c32bd6)
続いて以下のようにノードを配置してforce signed requestノードをダブルクリックして設定ダイアログを開きます。
![スクリーンショット 2015-12-22 15.35.31.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.amazonaws.com%2F0%2F21109%2F4c123124-be0f-5ca8-50f3-2fe43998256a.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=e3be2041e438e20a4cb01e5ddc8bfe26)
ここでSalesforceと接続する情報を設定するために以下のようにペンマークのアイコンをクリックします。
![スクリーンショット 2015-12-22 15.38.14.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.amazonaws.com%2F0%2F21109%2F5adde7e8-c7f8-7003-86b5-739b9ce29f70.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=af539c35947c3db4a582b11ef5319d00)
以下のように "Login Type" は "login By Signed-Request" を選択して "User Name" に組織のユーザ名と "Client Secret" に接続アプリケーションの "コンシューマの秘密" を入力して "Add" ボタンをクリックします。
![スクリーンショット 2015-12-22 15.43.33.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.amazonaws.com%2F0%2F21109%2Ff7338b46-d2ed-07a4-b1d2-52d552a42c6f.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=cc56ea5beb7f8258632936b9d3bcd290)
ちなみに、ここで設定した組織のユーザ名は単なる目印なので以下のようにメールアドレス形式でもないものでも構いません。これで "OK" ボタンをクリックしてして設定ダイアログを閉じて "Deploy" ボタンをクリックしてデプロイします。
![スクリーンショット 2015-12-22 15.50.24.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.amazonaws.com%2F0%2F21109%2Febcb09e1-aa29-068e-800a-2f88810f9ede.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=da371d22f3f7ae829605f1201f792691)
最後にVisualforceページを用意します。詳しく説明しませんが接続アプリケーションが "test" という名前の場合は以下のような感じです。
<apex:page >
<apex:canvasApp developerName="test" />
</apex:page>
![スクリーンショット 2015-12-22 15.53.05.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.amazonaws.com%2F0%2F21109%2F24156823-d1fd-9920-f5b9-73d79072266e.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=36757c549ae4f314ebbfc9d21cad9d41)
これでプレビューを見てみましょう。以下のようにSalesforceから送られてきたSigned Requestが検証&デコードされてコンテキストがJSONとなって画面とNode-REDのデバッグに表示されればOKです。
![スクリーンショット 2015-12-22 15.56.42.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.amazonaws.com%2F0%2F21109%2Fd60f26b6-d9fb-db29-7637-3f32430c62ad.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=7f6f5133856b1c7a940d42449209885b)
![スクリーンショット 2015-12-22 16.03.12.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.amazonaws.com%2F0%2F21109%2F5c54b742-20ae-10e6-9cf6-c3b5286169e7.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=3a8f68bafbddc96254126f616cf45563)
Salesforceのデータを取得して画面にリスト表示する
これでSalesforce CanvasのSigned Requestでの認証はうまくいったので、このままNode-REDでSalesforce側のデータを取得してTemplateノードで表示してみましょう。
まずは以下のようにChangeノードを配置します。
![スクリーンショット 2015-12-22 16.09.37.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.amazonaws.com%2F0%2F21109%2Fed37a3e7-82fd-672b-4c80-e4affa0d4221.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=0ce6bd72213906fedacf93434beb28d2)
配置したChangeノードの設定ダイアログを開き(Changeノードをダブルクリック)以下のようにmsg.payload
へSelect Id, Name From Account
というSOQL文字列をセットするように定義します。
![スクリーンショット 2015-12-22 16.12.05.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.amazonaws.com%2F0%2F21109%2F80fe1933-bdc0-dda1-a01e-4a63d36a330d.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=ae3b06f15c53e4b7a4b85c5fa0bd555d)
続いて以下のようにforceノードを配置します。
![スクリーンショット 2015-12-22 16.21.59.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.amazonaws.com%2F0%2F21109%2Fdb0481a9-1419-3a9a-0484-21ddec8ada49.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=5296ea7ebe80d205fdaa9cd39cf968d3)
配置したforceノードの設定ダイアログを開き(forceノードをダブルクリック)以下のように "Log in as" は先ほどforce signed requestノードで設定したアカウントと同じアカウントを選択、 "Operation" は "query" を選択してデプロイします。
![スクリーンショット 2015-12-22 16.17.26.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.amazonaws.com%2F0%2F21109%2F9d82130c-f88b-a2d4-7cbf-041e4d475023.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=3316fbcb480022650a05aee540e83a0a)
これでSalesforceからデータ取得できるか一旦試してみます。再度、先ほど作成したVisualforceページへアクセスします。以下のようにJSONでAccountの情報が表示されればOKです。
![スクリーンショット 2015-12-22 16.24.18.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.amazonaws.com%2F0%2F21109%2F622cc984-1a96-a8d0-f03c-1218e74a3037.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=08000c4f5e6fe635bd570e9cac53f85d)
これはChangeノードでSOQLをmsg.payload
にセットして流すことで、後続のforceノードが受け取ったSOQLを実行してデータを取得しているという流れです。
Node-REDでは前段のノードから後続ノードのパラメータを流して、後続の動作を動的にするテクニックをよく使います。これによって冗長なデータフローになるのを避けられます。
最後にTemplateノードを以下のように配置して...
![スクリーンショット 2015-12-22 16.26.40.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.amazonaws.com%2F0%2F21109%2Fad5cc1ea-cfac-c899-9915-7afd1022f7c6.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=f460185d068f9558654f0a739e07d762)
以下のように定義してデプロイして...
<ul>{{#payload.records}}<li>{{Id}} : {{Name}}</li>{{/payload.records}}</ul>
![スクリーンショット 2015-12-22 16.31.09.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.amazonaws.com%2F0%2F21109%2F41a71119-940e-5a68-437e-f16cc43d7b67.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=7e033de310ed12c0321eac5437e3f89f)
再度、Visualforceページへアクセスして以下のように表示されたらOKです。
![スクリーンショット 2015-12-22 16.33.23.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.amazonaws.com%2F0%2F21109%2F466ac6de-97fa-3732-2fb7-722715a5e3e5.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=ef36cd489a46ba4833a45822dcdf131a)
まとめ
私が思うにNode-REDはSalesforceの外の世界でもビジュアルワークフロー&データフロー的なプロトタイピングでユーザと会話しながら要件の認識を合わせていくのに適したツールだと思います。
そのような使い方を可能にするためには気軽に誰でもどこでもインストールして使えるべきです。オープンソースソフトウェアの時点で、その大半はクリアしているのですが、今後も色々と考慮して発展していかないといけない点も多々あります。
そのためには様々な領域の有志が集い、様々なユースケースにおいてNode-REDを利用するにはどうしたら使いやすいかを考え発展させなければならないと思います。また、Node-REDは発展できるポテンシャルもあります。
貢献してみたい方は是非Node-REDユーザグループに参加しましょう!
おまけ
今回の設定(Node-REDではフローと呼びます)はJSONをインポートすると再現できます。インポートのやり方は以下のようにメニューから "Import > Clipboard" を選択して開いたダイアログに以下のJSONを貼付けます。
![スクリーンショット 2015-12-22 16.36.02.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.amazonaws.com%2F0%2F21109%2Ff80594a8-91a5-52e2-d8a5-80e90a0c75a7.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=ec2e708fced8770653494dea2eb892ec)
[{
"id": "4f9b24d7.b064dc",
"type": "force",
"z": "",
"username": "",
"loginurl": "https://login.salesforce.com",
"logintype": "Signed-Request"
}, {
"id": "68be3f5.f9741c",
"type": "debug",
"z": "569fcd48.a96034",
"name": "",
"active": true,
"console": "false",
"complete": "false",
"x": 513,
"y": 222,
"wires": []
}, {
"id": "d1e76ece.2e189",
"type": "http in",
"z": "569fcd48.a96034",
"name": "",
"url": "/canvas",
"method": "post",
"swaggerDoc": "",
"x": 125,
"y": 63,
"wires": [
["f70ef5e8.08f108"]
]
}, {
"id": "f70ef5e8.08f108",
"type": "force signed request",
"z": "569fcd48.a96034",
"force": "4f9b24d7.b064dc",
"name": "",
"x": 320,
"y": 64,
"wires": [
["870ac031.78f54"]
]
}, {
"id": "870ac031.78f54",
"type": "change",
"z": "569fcd48.a96034",
"name": "",
"rules": [{
"t": "set",
"p": "payload",
"to": "Select Id, Name From Account"
}],
"action": "",
"property": "",
"from": "",
"to": "",
"reg": false,
"x": 526,
"y": 64,
"wires": [
["9238e368.6dc72"]
]
}, {
"id": "9238e368.6dc72",
"type": "force in",
"z": "569fcd48.a96034",
"force": "4f9b24d7.b064dc",
"operation": "query",
"sobject": "",
"extname": "",
"name": "",
"x": 128,
"y": 135,
"wires": [
["68be3f5.f9741c", "7612ac7f.89ed54"]
]
}, {
"id": "5e74439f.a18bbc",
"type": "http response",
"z": "569fcd48.a96034",
"name": "",
"x": 494,
"y": 135,
"wires": []
}, {
"id": "7612ac7f.89ed54",
"type": "template",
"z": "569fcd48.a96034",
"name": "",
"field": "payload",
"format": "handlebars",
"template": "<ul>{{#payload.records}}<li>{{Id}} : {{Name}}</li>{{/payload.records}}</ul>",
"x": 310,
"y": 137,
"wires": [
["5e74439f.a18bbc"]
]
}]