Contents
The following table describes the fields available on this page:
Field | Description |
---|---|
Tachyon User Name and Tachyon User Password | This is the domain user name and password of a Tachyon user that is assigned to an Actioners role in Tachyon. The user name must be entered in the format: domain\username. Once configured, the user acts as a proxy for any ServiceNow user that is assigned to the 1E Service Catalog Connect role x_1e_service_catal.shopping_user in order to run instructions in Tachyon from ServiceNow, to verify the status of executed instructions, and collect responses from the instructions that have been run. This user is also used by the API Configuration Settings page to retrieve instructions from Tachyon to make them available in ServiceNow. |
Save buttons | There are two Save buttons on the page, one at the bottom of the screen and the other in the top-right of the screen heading, they both work identically and save any changes made to the fields on the Tachyon Settings page. |
Status API wait seconds | When an instruction is triggered from ServiceNow, there are frequent calls (polling) from ServiceNow to Tachyon for status updates of the instruction. 1E Service Catalog Connect asks 1E Core for the instruction status. 1E Core then asks Tachyon about the status of the current instruction and passes it back to 1E Service Catalog Connect. Status API wait seconds is the time duration in seconds for which 1E Service Catalog Connect waits before sending each status request. The default value is 3 seconds. |
Instruction history keep months | When a user clicks the Launch WSA Wizard button in 1E Service Catalog Connect, 1E Service Catalog Connect calls 1E Core to execute a Tachyon instruction. When 1E Core executes an instruction, the details are saved in 1E Core. Instruction history keep months is the number of months for which ServiceNow should preserve the Tachyon instruction history data. After this many months, a daily scheduled job will purge the older records. Purged instruction history can never be viewed/retrieved again. The default value is 6 months. |
Domain Controller FQDN | This property defines the fully qualified domain name of the domain controller on which the "Unlock domain account" instruction will be triggered. This optional property is only used for the Unlock domain account catalog item. To use this feature the 1E Client MUST be installed on the domain controller, if it is not then the catalog item will be unusable. Recommendation: if it is not permitted to install the 1EClient on a Domain Controller then a ServiceNow System administrator can make the “Unlock domain account" Catalog item inactive in the Maintain Item screen. |
Other Configurations | This property lets the admin user configure whether they want the app to open an incident automatically when a RITM fails, i.e. is in Closed Incomplete state. The default value of this property is true. |
Test Server Connection button | A Test Server Connection button is enabled once the settings have been saved on the API Configuration page. Any time the settings on the page are modified the button is disabled and only re-enabled when the changes have been saved. This button is used to test whether the settings saved on the page work correctly or not. As soon as this button is hit, ServiceNow tries to establish a connection with Tachyon server using the provided details and shows an overlay on the screen which prevents further modifications on the page. If there was a successful connection, then a success message is displayed on the page else an appropriate error message is displayed. |
Retrieve Instructions button | The Retrieve Instructions button is enabled once the settings have been saved on the API Configuration page. Any time the settings on the page are modified the button is disabled and only re-enabled when the changes have been saved. Clicking the Retrieve Instructions button causes the 1E Service Catalog Connect app to contact Tachyon using the Tachyon User Name and password to retrieve details about all the instructions that the Tachyon User account has Actioner permissions on. When the instructions have been successfully retrieved, a message is displayed on the page and the retrieved Tachyon instructions will be displayed on the 1E Core app Instruction Definitions page. If an error message is displayed you may need to carefully check the settings on the Tachyon Settings page. |
The following table describes the fields available on this page:
Field | Description |
---|---|
MID server | The name of MID server. This is required when Shopping is set up on-premises otherwise it's an optional field. If Shopping is not on the internet, ServiceNow (which is in a cloud) will never be able to communicate with it. In this case 1E Service Catalog Connect requires a bridge between the Shopping and ServiceNow. A MID server is a software application which gets installed on any local machine with internet connectivity in the Shopping domain and is set up pointing to the desired ServiceNow instance. |
Shopping server URL | The URL used by the application to communicate with Shopping APIs. This is the base URL prefix for accessing the Shopping API to communicate with the Shopping Web. Typically, this is set to the host header you defined in the Web configuration during Shopping Central installation, for example |
Shopping user name and password | In Shopping Console → Settings → WSA, there is a property named 'Sync WSA Orders Account'. The user which configured for this property in the Shopping Console is the same one needed to configure in ServiceNow for Shopping user name and password fields. This user is used when ServiceNow syncs data from Shopping. |
Shopping API | The relative URL for the Sync API of Shopping. The value of this field is used by the ServiceNow scheduled job that syncs data from Shopping into ServiceNow. Default value: /Shopping/WindowsServicingAssistant/LatestOrders |
API sync batch size | A number that limits the number of records coming from Shopping in one batch at the time of synchronization. It may happen that there is a huge number of Shopping orders available in Shopping DB to be synced in ServiceNow. Default value: 1000 |
Loopback URL | When ordering a Windows 10 item, 1E Service Catalog Connect needs the FQDN (computer name) of the current computer where the app is running. This field is the loopback URL that used to determine the FQDN of the local/current machine. Default value: https://localhost:8000/shoppingClientAgent/machineInfo |
Tachyon Instruction to be fired to launch WSA wizard | The 'Launch WSA Wizard' button triggers this Tachyon instruction to launch WSA wizard on the current computer. The Tachyon instruction name is 1E-Nomad-RunWSA |
Optional post-installation configurations
The following pages describe additional post-installation configurations you can make to enable certain features in your ServiceNow Service Catalog Connect implementation:
Windows 10 Catalog Item customization
Optional post-installation task for configuring Windows 10 catalog items.
Adding a new catalog item
Optional post-installation task for configuring a new catalog item.
Configure built-in 1E ServiceNow Catalog items
Optional post-installation task for configuring the built-in 1E ServiceNow Catalog items.
Guided Tour setup
Optional post-installation task for configuring the Guided Tour.
Adding Launch WSA Wizard to the ServiceNow Service Portal
Optional post-installation task for adding Launch WSA Wizard to the ServiceNow Service Portal.