Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Release v1.0.0

...

Template NameExtension NameExtension Version
ServiceNow Incidentue-servicenow-incident1.0.0

Refer to Changelog for version history information.

...

FieldInput typeDefault valueTypeDescription
ActionRequiredCreate IncidentChoiceAction performed upon the task execution. Available actions.
  • Create Incident
ServiceNow Instance URLRequired-TextURL of the ServiceNow instance.
ServiceNow CredentialsRequired-CredentialsCredentials for accessing ServiceNow via API.The Credentials definition should be as follows.
  • ServiceNow username as "Runtime User".
  • ServiceNow password as "Runtime Password".
CallerOptional-Dynamic ChoiceUser who reported or is affected by this incident.
CategoryOptional-Dynamic ChoiceThe category for incident creation. If not provided, the default category defined on ServiceNow will be considered.
SubcategoryOptional-Dynamic ChoiceThe subcategory for incident creation. The choice of Subcategory depends on the previous choice of Category.
ImpactOptional-ChoiceImpact of the created incident. The following options are available.
  • High
  • Medium
  • Low
UrgencyOptional-ChoiceUrgency of the created incident. The following options are available.
  • High
  • Medium
  • Low
Assigned ToOptional-Dynamic ChoiceUser primarily responsible for treating this incident in ServiceNow.
Assignment GroupOptional-Dynamic ChoiceAssignment group that is responsible working on this incident in ServiceNow.
Short DescriptionRequired-TextShort description of the incident.
DescriptionOptional-Large TextDescription of the incident.
Attach Output SourceRequired-- None --ChoiceParameter controlling whether an attachment will be attached to the incident and the source of it. The following options are available.
  • -- None --
  • Sibling Task Instance
  • Any Task Instance
Output TypeOptionalAllChoiceThe type of output to be used as attachment. The following options are available.
  • All
  • Standard Output
  • Standard Error
Required when Attach Output Source is “Sibling Task” or “Any Task Instance”.
Number of linesOptional100IntegerThe number of lines to be retrieved from the task instance output. The extension will provide up to the specified number of lines, less if there is not enough lines generated.

Required when Attach Output Source is “Sibling Task” or “Any Task Instance”.

The value must be greater then 0.
Task Instance IDOptional-TextUUID of the task instance the output of which is attached. UAC Functions can be used to resolve the required Task Instance ID. For more information the reader can refer to the task examples.

Required when Attach Output Source is “Sibling Task” or “Any Task Instance”.
UC URLOptional-TextBase URL of the target Universal Controller.

Required when Attach Output Source is “Sibling Task” or “Any Task Instance”.
UC CredentialOptional-
Credential for accessing the Controller.

The Credentials definition should be as follows.
  • UA Controller username as "Runtime User".
  • UA Controller password as "Runtime Password".
Required when Attach Output Source is “Sibling Task” or “Any Task Instance”.

...

Note

Using empty value for dynamic choice fields will result with ServiceNow setting a default value for the field if one exists.

Note

...

Using non-existing value for dynamic choice fields will result with ServiceNow setting an empty value or a default value for the field if one exists.

Task Examples

Create Incident

Example of creation of an incident. Create IncidentImage Removed

Image Added

Create Incident with attachment from a Sibling Task

Example of creation of an incident with attachment from a sibling task within a workflow. The workflow is configured to create a ServiceNow incident when a task fails.
A workflow where the Failure transition of a SQL Task is followed by a ServiceNow Incident Universal Task.

Create WorkflowImage Removed Image Added
Task configured to use the information from the failed Universal Task Instance as attachment for creating a ServiceNow Incident.

Create IncidentImage RemovedImage Added

Create Incident From Any Task Instance

Example of creation of an incident from any Task Instance.

The use case shows a Task Monitor configured to monitor a specific task for failure.

Configure MonitorImage RemovedImage Added

The Task Monitor Trigger is configured to create a new ServiceNow Incident Task Instance when triggered by the Task Monitor.

Create TriggerImage RemovedImage Added

The created Incident task propagates the output of the failing Task Instance as an attachment to ServiceNow.

Create IncidentImage RemovedImage Added

Task Output

Exit Codes

...

Document LinkDescription
Universal TemplatesUser documentation for creating, working with and understanding Universal Templates and Integrations.
Universal TasksUser documentation for creating Universal Tasks in the Universal Controller user interface.
CredentialsUser documentation for creating and working with credentials.
Resolvable Credentials Permitted PropertyUser documentation for Resolvable Credentials Permitted Property.
ServiceNow DocumentationUser documentation for ServiceNow.

Changelog

ue-servicenow-incident-1.0.0 (2022-

...

07-

...

28)

  • Added: Basic Functionality for ServiceNow Incidents (#29442)