Chapter 5: Charts and Dashboard Setup.
Node.js Installation on CRM Server With our GUMU™ Integration, we have introduced chart and dashboard screens in CRM applications. With the help of these screens, the user now has the ability to view data for quick and high-level visual sales analysis. On this screen, we display the customer’s data on global and individual levels from Sage X3 on a real-time basis.
For GUMUâ„¢ Charts and dashboard screens to work, we need to download and Install the node.js LTS version setup file from given URL - https://nodejs.org/en/
![](https://docs.greytrix.com/~gitbook/image?url=https%3A%2F%2F794987320-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MCRVg-TYx3gVa2Tqtf_%252Fuploads%252FMyAIfMAERCer92ZsHaXG%252FImage51.jpg%3Falt%3Dmedia%26token%3D5c8e6df7-2f7c-479e-a1e8-5fc49f287b6e&width=768&dpr=4&quality=100&sign=1579a2aa&sv=1)
2. Users can also check the installed node.js setup version by following the below steps
- Open the Start menu, then type cmd in the Search box and press Enter - Run the command prompt using run as administrator - In the command line window that appears, type node --version and press Enter - On the below line node.js version will appear
Node-Red setup and installation
3. For charts and dashboard details to appear on the CRM screens the user will need to install node-red using the command prompt. Open the command prompt with run as administrator and type the below command
npm install -g --unsafe-perm node-red
4. After node-red installation, run the node-red below command under the administrator run command prompt to keep the Kendo charts up and running
node-red
5. Access the Node-Red URL below URL:- http://[system IP address]:1880/ E.g. - http://192.168.0.125:1880/
6. The user will need to check if the MSSQL-plus module is installed under Node-Red. If not, then it needs to install, and for that follow below Screenshots and steps.
Click on Menu present on the right side corner and select the Manage Palette as shown below
![](https://docs.greytrix.com/~gitbook/image?url=https%3A%2F%2F794987320-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MCRVg-TYx3gVa2Tqtf_%252Fuploads%252FkGfkrjLLoY1Mqbw3y670%252FImage52.jpg%3Falt%3Dmedia%26token%3D47d23d5d-abe3-4fcb-a1c2-a10b4f35c047&width=768&dpr=4&quality=100&sign=18fdc953&sv=1)
Now navigate to the Install tab, search for the MSSQL module in the search module and install the MSSQL-plus module. Refer below screenshot for a better understanding
![](https://docs.greytrix.com/~gitbook/image?url=https%3A%2F%2F794987320-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MCRVg-TYx3gVa2Tqtf_%252Fuploads%252FtbyMJPYN4F1Hmo5DIUMO%252FImage53.jpg%3Falt%3Dmedia%26token%3Dace1d857-0a4c-433a-b392-6da4c8319611&width=768&dpr=4&quality=100&sign=6dfeaf7d&sv=1)
7. Once the MSSQL-plus module is installed. The user needs to import the SQL node.json file under Node-Red by performing the steps below
Click on the menu button present on the node-red application and then click on the Import button.
![](https://docs.greytrix.com/~gitbook/image?url=https%3A%2F%2F794987320-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MCRVg-TYx3gVa2Tqtf_%252Fuploads%252Fw5GzTqIEzUfrUsqYMElv%252FImage54.jpg%3Falt%3Dmedia%26token%3D226d2b4f-0400-4ab6-b141-a77f677c733e&width=768&dpr=4&quality=100&sign=7fe6398f&sv=1)
Click on select a file to import then navigate to the given path below and select Sage X3 SQL.json file (Assuming the Greytrix folder is on C drive) C:\Program Files (x86)\Greytrix\GUMU for Sage CRM - Sage X3\Patches\V7 OR Above\Sage X3 SQL.json
![](https://docs.greytrix.com/~gitbook/image?url=https%3A%2F%2F794987320-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MCRVg-TYx3gVa2Tqtf_%252Fuploads%252Fd9a3SYuWiwdCdjTrxsm4%252Fimage.png%3Falt%3Dmedia%26token%3D5657f8c2-5ae3-4a93-98b0-327d18c44b59&width=768&dpr=4&quality=100&sign=311f82e&sv=1)
Click on the import button to import the selected JSON file
![](https://docs.greytrix.com/~gitbook/image?url=https%3A%2F%2F794987320-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MCRVg-TYx3gVa2Tqtf_%252Fuploads%252FJ1YaPxun0Dy691sExF8d%252Fimage.png%3Falt%3Dmedia%26token%3D065bc09e-83e5-4321-88cb-2db561fc51c5&width=768&dpr=4&quality=100&sign=1198cce4&sv=1)
8. After the JSON file gets imported then click on the Deploy button present in the right corner
![](https://docs.greytrix.com/~gitbook/image?url=https%3A%2F%2F794987320-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MCRVg-TYx3gVa2Tqtf_%252Fuploads%252FgtULxgScVcO515tQsedI%252Fimage.png%3Falt%3Dmedia%26token%3Dcc5e667c-4086-48f5-b950-36c0b8aebdc2&width=768&dpr=4&quality=100&sign=b954ec6c&sv=1)
9. Now, double-click on MSSQL-PLUS where the properties screen will get displayed to add CRM’s SQL details click on the edit as shown below
![](https://docs.greytrix.com/~gitbook/image?url=https%3A%2F%2F794987320-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MCRVg-TYx3gVa2Tqtf_%252Fuploads%252FImjjFND3po2dIUjFRQRz%252Fimage.png%3Falt%3Dmedia%26token%3Da541a5dc-3312-400c-83b1-13a979dbea73&width=768&dpr=4&quality=100&sign=8614818b&sv=1)
![](https://docs.greytrix.com/~gitbook/image?url=https%3A%2F%2F794987320-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MCRVg-TYx3gVa2Tqtf_%252Fuploads%252FLScAbBMkWugZ5AGctM7b%252Fimage.png%3Falt%3Dmedia%26token%3D8417fd50-f6ca-4953-952d-d2c09f0ba8b0&width=768&dpr=4&quality=100&sign=15c9920b&sv=1)
10. Add the proper CRM SQL details similarly as shown below image and also check the same checkbox as shown below
![](https://docs.greytrix.com/~gitbook/image?url=https%3A%2F%2F794987320-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MCRVg-TYx3gVa2Tqtf_%252Fuploads%252Fp01UeXi0v62B1Tr6uW14%252Fimage.png%3Falt%3Dmedia%26token%3D7c82582b-c91b-460c-b841-840f9c2eb5bf&width=768&dpr=4&quality=100&sign=c8f6a338&sv=1)
11. Once the SQL details are configured under the properties screen. The user can do a test connection which can be verified through logs when clicking on the debug button. Refer to the below image.
![](https://docs.greytrix.com/~gitbook/image?url=https%3A%2F%2F794987320-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MCRVg-TYx3gVa2Tqtf_%252Fuploads%252F5gW8EfWuYgzmud8cuKnB%252Fimage.png%3Falt%3Dmedia%26token%3D5f1a267a-20c3-4594-901c-db3fbd43e52d&width=768&dpr=4&quality=100&sign=c35f089d&sv=1)
12. After that click on inject button, and the logs will get generated under debug screen as shown below
![](https://docs.greytrix.com/~gitbook/image?url=https%3A%2F%2F794987320-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MCRVg-TYx3gVa2Tqtf_%252Fuploads%252FkFysPghSfvQsEqXrreqQ%252Fimage.png%3Falt%3Dmedia%26token%3De70a9287-e2c7-42b6-a868-5d6250fc87da&width=768&dpr=4&quality=100&sign=d6227fa2&sv=1)
13. Expand the logs at the detail level and verify if data arrive similar to that present in Sage X3.
![](https://docs.greytrix.com/~gitbook/image?url=https%3A%2F%2F794987320-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MCRVg-TYx3gVa2Tqtf_%252Fuploads%252FHcuDEuJqOOJq2bWikl8A%252Fimage.png%3Falt%3Dmedia%26token%3D84cd8502-ce41-469d-a766-98146a4f01ea&width=768&dpr=4&quality=100&sign=153bf372&sv=1)
14. The Node-Red URL needs to configure in CRM. For that Navigate to Administration > Translation and enter the below-mentioned details under respective fields and search Caption Family: NodeRedStatusURL Caption Code : NodeRedStatusURL
Now click on the caption code hyperlink and enter the details of the node-red URL
E.g.:- node url - http:// [node red IP]:1880/
Also, similarly as shown below Image and save the details
![](https://docs.greytrix.com/~gitbook/image?url=https%3A%2F%2F794987320-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MCRVg-TYx3gVa2Tqtf_%252Fuploads%252FQTamsJwVsIcfQDzQsC9C%252Fimage.png%3Falt%3Dmedia%26token%3Dca0f2715-90e0-4484-b19f-14a386234bea&width=768&dpr=4&quality=100&sign=f712f847&sv=1)
15. The Dashboard that has the ability to show the customer’s data need to be created manually.
ERP Data Dashboard
Go to the Sage CRM home page there click on new dashboard button and select Create Dashboard.
Under Dashboard, details enter name as ‘ERP Data’ and click ok then cancel.
![](https://docs.greytrix.com/~gitbook/image?url=https%3A%2F%2F794987320-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MCRVg-TYx3gVa2Tqtf_%252Fuploads%252FT0QUm4aQ8JqvzAcEjaFe%252Fimage.png%3Falt%3Dmedia%26token%3Dc3448def-d169-4f11-bb1f-e95240c9407e&width=768&dpr=4&quality=100&sign=8cfe0d64&sv=1)
Now click on the new gadget button beside the new dashboard button and then click on create gadget and select web site.
On the gadget wizard screen, under the content block field select ERPGolbalDashboard and click on the next button
![](https://docs.greytrix.com/~gitbook/image?url=https%3A%2F%2F794987320-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MCRVg-TYx3gVa2Tqtf_%252Fuploads%252FYr3nqAUYQqqJoy2zRsGI%252Fimage.png%3Falt%3Dmedia%26token%3Dce1e00c1-bc0d-41a5-a405-fe509509c6f6&width=768&dpr=4&quality=100&sign=5bdaab88&sv=1)
Enter ‘Sage X3 Data’ under the name field and click on the finish button.
![](https://docs.greytrix.com/~gitbook/image?url=https%3A%2F%2F794987320-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MCRVg-TYx3gVa2Tqtf_%252Fuploads%252FhwYWXhDKTqjOKYLLKchx%252Fimage.png%3Falt%3Dmedia%26token%3Dc2f8e25a-7ca4-4bf9-9f62-cc9bd63e766d&width=768&dpr=4&quality=100&sign=9d0bc845&sv=1)
Customer Dashboard
Similarly, create a dashboard for customers. Select one of the customers and go to the dashboard. Now click on the new dashboard button and select Create Dashboard.
Under Dashboard, details enter the name as ‘Customer Dashboard’ and click ok then cancel.
![](https://docs.greytrix.com/~gitbook/image?url=https%3A%2F%2F794987320-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MCRVg-TYx3gVa2Tqtf_%252Fuploads%252FHRk0nMBG0kAxTVdyUWNJ%252Fimage.png%3Falt%3Dmedia%26token%3D7a2b0aa4-ec60-4fdc-b914-5ae3e75b0b59&width=768&dpr=4&quality=100&sign=7a32d9d4&sv=1)
Now click on the new gadget button beside the new dashboard button and click on create gadget and select web site.
On the gadget wizard screen, under the content block field select ERP Dashboard and click on the next button
![](https://docs.greytrix.com/~gitbook/image?url=https%3A%2F%2F794987320-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MCRVg-TYx3gVa2Tqtf_%252Fuploads%252FNed2Da4loS8kSnq4aBEy%252Fimage.png%3Falt%3Dmedia%26token%3Db644dc05-e72a-48b8-ba26-bdebb422901a&width=768&dpr=4&quality=100&sign=f8d10e8e&sv=1)
Enter ‘Sage X3 Data’ under the name field and click on the finish button.
![](https://docs.greytrix.com/~gitbook/image?url=https%3A%2F%2F794987320-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MCRVg-TYx3gVa2Tqtf_%252Fuploads%252FqZYgRYkF3qnBtVLerUwN%252Fimage.png%3Falt%3Dmedia%26token%3D2e22e622-3a97-4768-892b-93fcf4f9df4c&width=768&dpr=4&quality=100&sign=216a5e8f&sv=1)
For Configuring GUMUâ„¢ from Sage CRM and Sage X3 side, kindly refer User Guide.
Last updated