How to test and verify that the SmartConnect REST service is operating correctly on SmartConnect 2018.
1. First thing to do is locate where the web service is supposed to be running. Open SmartConnect and go to the “Setup” tab and click on the “Setup” button. Then click the “Running Servers” button and look for a machine listed that says “WCF Rest Service” In this screenshot you can see my REST service is installed on a machine named “EONE-2014” if you don’t see any machines listed, then the web service was not installed, and you would need to install it on a machine with IIS on it.
2. Now you need to either login to that machine directly, or remote into the desktop of that machine. Once you are logged into the machine, launch Internet Information Services (IIS) by opening a Windows Run command (Windows key + R) and type in “inetmgr” and hitting enter, the IIS manager should look like this. Expand the list of “Sites” under it and make sure you see one named “SmartConnectWcf”
3. Click on the “Content View” tab at the bottom of the page. Then right click on the “SmartConnect.svc” file and select “Browse” like this.
4. If the web service is running correctly, it should bring up this “welcome to the SmartConnect WCF service” screen in your default browser. This will verify that the web service is running, note that the web service URL will say http://localhost:5557/SmartConnect.svc/
5. The next test is to change the word “localhost” to the name of the machine the web service is running on. This will test if the web service is resolvable using the server name, it should bring you back to the same screen you see above. So in this screenshot you can see that I have changed the URL to http://EONE-2014:5557/SmartConnect.svc/
6. The next test will verify if the SmartConnect SQL database is accessible from the web service. You are going to add /validatesession to the end of the URL you typed above, so in my case it will be http://EONE-2014:5557/SmartConnect.svc/validatesession. This method does not require any sort of Windows authentication, it is testing if the SQL database is accessible to the web service, and if it is connected correctly, you will get a list of how many users have been added inside of SmartConnect. The browser session should look like this if it is able to read the database.
7. The last test is to test of the credentials you are using has access to any SmartConnect maps. This will require you to type in your Windows login, and your password. Change the word “validatesession” to “getmaplist” and then it will prompt you for credentials. In the below screenshot I changed my URL to http://EONE-2014:5557/SmartConnect.svc/getmaplist/ and typing in my Windows credentials which is “eonedemo/eone” and my password.
8. If everything is configured correctly the above URL should return a list of the maps that the user has access to run like this. At this point you should be able to utilize the SmartConnect REST
webservice.
