Page Comparison

Use this list of items if you are experiencing an issue with Aspenware Scanning. AW Aspenware Scanning uses Unity just like Aspenware Commerce but some customers have a stand-alone instance of Unity that only the scanners use which is typically installed on an internal server in the customers customer environment instead of a web server. Because these URLs may differ from the Commerce Unity URL, it’s important to know what URL is configured for the scanning app.

...

Questions to ask and how to test

1. Has the scanner been working or has it never worked?

   1. If it has been working, has anything in the environment changed, or are you currently having any network issues?

   2. Has there been an RTP upgrade recently? RTP 2022.2 introduced a change to the stored procedure, proc_publicGetPrepaidAccessProfileWithHistory that required a change in Unity. Customers running RTP 2022.2 or greater will need to upgrade Unity to v3.28.

   3. If it has never worked, all settings on the scanner need to be checked (refer to documentation).

2. What is the Unity URL being used by the scanner? The Unity URL can be found by scanning a barcode of the word, ‘SETTINGS’ on the Login page of the app (or ‘settings’ can be typed in). This will then show a page where the WebServiceURL, ClientID and ClientSecret are entered. Once the URL is known, check the log file on the server which is typically located in C:\inetpub\wwwroot\UnityProd\Logs (or whatever the application directory is named, (UnityProd, UnityProdScanning, etc).

3. Can the Unity URL be entered into a browser on the device to show the API page or does an error page show? If an error page shows, it’s likely the Unity URL cannot be reached on the wireless network the device is connected to. This is likely a network issue that the customer needs to look into.

   1. The format of the URL in SETTINGS should look like this WITH the trailing slash: https://unity.aspenwarecommerce.net/UnityQA/

   2. To test entering the URL into a browser on the device, it must be entered like this: https://unity.aspenwarecommerce.net/UnityQA/index.html

   3. If the URL shows the API page (not an error page), enter the ClientID and Client Secret to make sure they are valid. Click the ‘Authorize’ button:

      Image Modified

      1. Then enter the ClientID and ClientSecret being used

         Image Modified

      2. Then check the following scopes (the checkboxes)

         1. service.access / access control service (usually the first one in the list)

         2. services / services (usually the last one in the list)

      3. Then click ‘Authorize’. If the credentials worked, you should see this message. If you don’t, it’s possible the wrong ClientID and ClientSecret were entered.

         Image Modified

   4. Then to verify Unity can communicate to the RTP db, try the ‘get access locations' api call

      1. Change dropdown in upper right corner from V1 to V3

         Image Modified

      2. Click the entry, GET - /api/Access/locations

      3. Click ‘Try it out’ and then the blue Execute button

         Image Modified
   5. Image Modified

      If Unity can communicate to the RTP db, you should see a list of RTP Access Locations returned. This is one of the calls the scanner makes so if this works, the communication to RTP is working.

      Image Modified

   6. If you see anything other than a list of Access Locations returned, it’s possible Unity can’t communicate to RTP.

   7. If the above is working as expected but the scanners are still experiencing issues, emulate a scan in Swagger using the /api/access/process call. Click ‘Try it out’ and replace the default JSON with the example below.

...

...

Replace the above with the following but edit the values in bold to match the environment being used for testing.

...