Summary

The 1E Service Catalog Connect app communicates with the Tachyon system that is hosted in your production network. As a result, certain configuration details must be set up by a ServiceNow administrator to enable this communication with the Tachyon server. Additional settings must also be configured to manage how the 1E Service Catalog Connect app works.
On this page:

Tachyon Settings

The Tachyon Settings page contains settings for integrating Tachyon with ServiceNow for 1E Service Catalog Connect. 

This page is accessible only to a ServiceNow user that is a member of 1E Service Catalog Connect app role x_1e_service_catal.shopping_admin. If the user is also a ServiceNow admin, the properties on the page will only be changeable after setting the scope to 1E Service Catalog Connect.

All the properties on the page, except for Domain Controller FQDN, are mandatory.

Due to the limitations of ServiceNow property pages there are no validation checks applied to the fields when you are inputting the data. You should take extra care to ensure that all the fields are filled out correctly, but see the following note.


You can click on the Test Connection button at the top-right of the console to test that the username and password are correct.

Please refer to:

The following table describes the fields available on this page:

FieldDescription

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.
Impact: After making “Unlock domain account" catalog item inactive a user won’t be able to unlock the domain account from ServiceNow.

Other Configurations

Should Service Catalog Connect automatically create an incident when a requested item (RITM) fails?

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.

Shopping Settings Page

The Shopping Settings page is a sub-menu available under the Administration tab of 1E Service Catalog Connect. This page allows an admin user to set up the details required by Shopping and WSA to communicate with Tachyon for 1E Service Catalog Connect. 

This page is accessible only to a ServiceNow user that is a member of 1E Service Catalog Connect app role x_1e_service_catal.shopping_admin. If the user is also a ServiceNow admin, the properties on the page will only be changeable after setting the scope to 1E Service Catalog Connect.

All the fields on the page are mandatory except for Mid Server, which is dependent on whether Tachyon is accessible over the internet.

Due to the limitations of ServiceNow property pages there are no validation checks applied to any of the settings. You should take extra care to ensure that all the fields are filled out correctly.


The following table describes the fields available on this page:

FieldDescription

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 http://shopping or if you have modified the port from its default, http://shopping:120 or if you are using FQDN such as http://shopping.acme.local. Both HTTP and HTTPS are supported.

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.