Dialogue Studio Installation

Prerequisites

 

Installation

Anywhere365 Node-RED modules support Node-RED v1+

 

Install Node-RED

  1. First make sure you have the latest version of nodejs and nodered installed. Instructions are based on Chocolatey (https://chocolatey.org/)

  2. Then run the following commands separately:

    1. choco install nodejs -y

    2. npm install --global --production windows-build-tools​

    3. npm install node-red -g

    Note Errors about not being able to detect vs tools (during installation of Node-Red) should not be a problem.

    Note When step 2 or 3 fails, you may want to run the following command:

    npm install --global --production windows-build-tools

 

Start Node-RED to check if this works.

If you are behind a proxy, this can take up to 5 minutes (so be patient): https://discourse.nodered.org/t/node-red-v0-19-4-3-minute-delay-during-startup-on-windows/3798

​​

Go to http://localhost:1880 in your browser. (more information: https://nodered.org/docs/getting-started/windows​)

Note When starting failes with the following error: "cannot be loaded because running scripts is disabled on​ this system.​" use the command: Set-ExecutionPolicy RemoteSigne​d

If everything went fine, you should see the UI of Node-RED with an empty canvas.

 

Deploy Dialogue Studio Nodes

  1. Now extract the NodeRedPlugin to a folder on disk, for example C:\data\plugins\NodeRedPlugin

  2. From the command line navigate to %userprofile%\.node-red and execute this command:

    ​npm install C:\data\plugins\NodeRedPlugin\NodeRedPlugin

  3. Restart the node-red application by pressing ctrl+c and executing node-red again.

 

Configure Dialogue Studio UCC Plugin

  1. Now extract the UCC plugin to a folder on disk, for example C:\data\plugins\NodeRedPlugin

  2. Add the following line to your UnifiedContactCenter in config.xml of the UCC config:

    <Plugin name="NodeRedPlugin" isIdentityPlugin="true" path="C:\data\plugins\NodeRedPlugin\UccPlugin" file="Wsp.Anywhere365.Ucc.NodeRedPlugin​.dll"/>

  3. (Re)start the UCC to load the plugin.

The UCC starts a SignalR Hub that is used by the NodeRed plugin. To check if the plugin is installed and running correctly navigate in a webbrowser on the UCC machine to http://localhost:8888/uccName/signalr/hubs. You should see a JavaScript document that describes the contract of the hub.

 

(​Optional) make the Anywhere365 library displaying on top in Node-RED

  1. By default any non-builtin library will be appended to the end of the library list in Node-RED. There is a way to define the order of libraries. Open the following file in a text editor: %userprofile%\.node-red\settings.js

  2. Find the line containing the paletteCategories setting and uncomment it by removing the leading double slashes (//). In the list add 'anywhere365' as the first element. Your configuration should look something like:

    paletteCategories: ['anywhere365', 'subflows', 'input', 'output', 'function', 'social', 'mobile', 'storage', 'analysis', 'advanced'],​

  3. Restart Node-RED in order to make the change effective

 

(Optional) Run as a service

For running node-red as a service at startup, you can look at: https://nssm.cc/