Skip to main content

ServiceNow

Triggered Instructions

Checking the triggered instruction history in 1E Core. The 1E Core application enables other 1E ServiceNow applications. For example, Tachyon instructions can be triggered from the incident form in the ITSM module of ServiceNow. 1E Core keeps a history of instructions it has executed (triggered) on behalf of those applications. The history includes:

  • The instructions

  • Parameters passed to a Tachyon instruction

  • Responses received from a Tachyon instruction

  • The Business Application that triggered the Tachyon instruction

  • Target end-user device.

Viewing Triggered Instruction History

A 1E Core administrator can view details for every instruction run in 1E Core on the 1E Core → Triggered Instructions page.

1E Core App roles required to view the Instruction History

To access the Triggered Instruction page, a ServiceNow user must be a member of the following role.

  • x_1e_core_connect.admin

Viewing the details for all the instructions run in 1E Core

To view details for every instruction run on the 1E Core app:

  1. Login to ServiceNow.

  2. Navigate to 1E Core→Triggered Instructions.

  3. The right-hand pane displays a list of ran instructions.

  4. To view the details for a particular instruction, click on the instruction ID link in the Number column. Doing this displays the Triggered Instruction page for the selected instruction, as described in The Triggered Instruction page.

230724279.png
Triggered Instruction page

The Triggered Instruction page displays the following information:

Field Name

Description

Number

A unique number assigned to every triggered instruction record.

Instruction Name

The name of the executed instruction.

Instruction Parameters

This field contains JSON parameters passed to Tachyon for this triggered instruction.

Target Endpoint

The CI hostname (computer name) from the incident or request. It refers to the device name for the endpoint where Tachyon server will execute the instruction.

Task

The incident number where the Tachyon instruction was executed.

Status

The instruction status as reported by Tachyon, such as completed, error, awaiting approval etc.

Instruction Execution ID

The unique instruction ID returned by Tachyon when run.

Business Application Name

The 1E ServiceNow application that initiated the instruction.

User

The ServiceNow username that ran the instruction.

230724278.png
Purging Triggered Instructions

The 1E Core application has common APIs that can be used by other 1E ServiceNow applications. Along with a group of other APIs, 1E Core has an API to purge instructions which accepts the following parameters:

  1. Business Application Name

  2. No. of Months.

The API purges triggered instructions specified by the Business Application Name and older than the given number of months. It will not purge triggered instructions passed by any other application and are newer than the specified number of months.