Troubleshooting Guide

Mobile Ticket : Troubleshooting Guide

Troubleshooting Guide

If, after following the configuration procedures above, your Mobile Ticket setup still does not work as expected, we suggest that you check your configuration by following the steps below. Use a tool such as Advanced REST client or Postman to perform the REST calls.

For more information about REST calls that can be used for the Mobile Ticketscenario, through the API Gateway, please see the API Gateway SDK documentation.

1. Perform the REST call below, to verify that you have a successful connection to Orchestra central (using port 8080)

You need to replace “serviceId” and “branchId” with valid Id numbers from your configuration. Also, you need to use Basic Authorization and the Username and Password for the mobile user (set in Parameters in the System Administration application, in Orchestra).

/qsystem/mobile/rest/v2/services/serviceId/branches/branchId/ticket/issue/

If the REST call successfully issues a ticket, you have verified that the connection works.

If it fails, however, check that Orchestra is configured correctly. For more information, see “Installation and configuration for node.js and Mobile Ticket” .

2. To verify that your connection through the API Gateway is correctly configured, perform the following trial REST call through API Gateway.

Make sure that you have set the correct authorization, using your auth-token and that you replace [serviceId] and [branchId] with valid Id numbers from your configuration.

/MobileTicket/services/[serviceId]/branches/[branchId]/ticket/issue

If the REST call is successful and a ticket is issued, you have verified that the connection works.

If it fails, however, make sure that you have configured the API Gateway correctly. See “Configuration for Mobile Ticket web application” .

3. Start the node.js server, from a command prompt, with the following command:

npm start

4. Check that the web page and UI works as expected, by entering https://<your ip-address>:4443 in the browser address field.

The table below contains some answers to some Frequently Asked Questions:

Question	Answer
Why are my Branches not available, in the Branch selection list?	In Orchestra, make sure that the check box Mobile enabled is checked for all the Branches that you want to be listed.
Why are my Services not available, in the Service selection list?	In Orchestra, make sure that the check box Mobile enabled is checked for all the Services that you want to be listed.
Why can I not create a mobile ticket?	In Orchestra, make sure that the VisitApp unit type is installed. Make sure that API Gateway is configured correctly.
Why is my connection to Orchestra/API Gateway not working properly?	Make sure that you have opened up port 9090, in your firewall, see “Prerequisite - Windows Control Panel:” . Make sure that API Gateway is configured correctly.