Skip to main content
Kinetic Community

BMC ITSM7 Work Order Work Info Create CE

Creates a BMC ITSM7 Work Order Work Info record based upon the parameters provided.

Downloads

By downloading this file, you acknowledge that you agree to our Terms of Service

bmc_itsm7_work_order_work_info_create_ce_v1.zip

Detailed Description

Creates Work Info entries related to a Work Order.  The relationship is established by placing the Work Order ID in the 'Work Order ID' field on the 'WOI:WorkInfo' form.

The Include Review Request parameter invokes a method that builds and places a link in the Notes field on the Work Info entry.  When this link is clicked, the original service request submission is opened in the read-only Review Request mode.

The Include Question Answers parameter invokes a method which builds a question and answer pair display of the service request submittal. These data elements are  placed in the Notes field of the Work Info entry.  This provides a quick view of the triggering service request submittal data.

The Work Info entry accommodates up to three file attachments.  When configuring the task, this handler expects the Name (not the label) of the attachment question. The handler will use this value to locate the attachment file within the filestore of the Kinetic Request application. If more than three attachments are needed, it is recommended to create additional Work Info entries.

The following data is used to create the 'WOI:WorkInfo' record:
* Sets the 'Detailed Description' field to a concatenation of the following:
  - The URL link to the Review Request view of the triggering Kinetic Request
    submission (if provided).
  - The value of the "Work Info Notes" parameter.
  - The formatted string of Question name to full answer pairs (if provided).
* Sets the 'Work Order Entry ID' field to the result of a lookup to the
  WOI:WorkOrder form.  The lookup is done using the work order id parameter
  and the resulting entry's request id is used.
* Attaches the files associated to the specified Attachment field menu label
  parameters to the specified fields:
  - 'z2AF Work Log01'          => "Attachment Question Menu Label 1"
  - 'z2AF Work Log02'          => "Attachment Question Menu Label 2"
  - 'z2AF Work Log03'          => "Attachment Question Menu Label 3"
* Sets the following field values to the specified values:
  - 'Secure Work Log'          => "No"
  - 'View Access'              => "Internal"
  - 'Communication Source'     => "Web"
  - 'z1D Previous Operation'   => "SET"
  - 'Status'                   => "Enabled"
  - 'Work Log Type'            => "General Information"
* Sets the following field values to the values of the specified parameters:
  - 'Work Order ID'               => "Work Order ID"
  - 'Description'              => "Work Info Summary"
  - 'Detailed Description'     => "Work Info Notes"
  - 'Work Log Date'            => "Work Info Submit Date"
  - 'Work Log Submitter'       => "Submitter"

Parameters

Name Description
Work Order Number The Work Order Number of the Change to associate the Work Order Work Info entry with.
Include Review Request Option to prepend the review request URL to the Notes of the Incident Work Info entry.
Include Question Answers Option to append the question answer pairs to the Notes of the Incident Work Info entry.
View Access Option to choose Public or Internal view access for the work log entry.
Work Info Summary Sets the Summary of the Incident Work Info entry.
Work Info Notes Sets the Notes of the Incident Work Info entry.
Work Info Submit Date Sets the Date of the Incident Work Info entry.
Attachment Input Type Choose "Field" if the input for the attachment info as a Field Name or choose "JSON" if the input is a (single) attachment's JSON from the Get Attachment Info handler. Note that if "Field" is specified, the fields entered should only allow one attachment. Options: Field, JSON (Default: Field)
Attachment Field 1 The field name of an attachment question to retrieve an attachment from. Displayed if Attachment Input Type is Field.
Attachment Field 2 The field name of an attachment question to retrieve an attachment from. Displayed if Attachment Input Type is Field.
Attachment Field 3 The field name of an attachment question to retrieve an attachment from. Displayed if Attachment Input Type is Field.
Attachment JSON 1 The JSON of an attachment question to retrieve an attachment from. Displayed if Attachment Input Type is JSON.
Attachment JSON 2 The JSON of an attachment question to retrieve an attachment from. Displayed if Attachment Input Type is JSON.
Attachment JSON 3 The JSON of an attachment question to retrieve an attachment from. Displayed if Attachment Input Type is JSON.
Submitter Sets the Submitter of the Incident Work Info entry.
Locked Sets the Incident Work Info entry Locked status. Valid Options: Yes,No
View Access Sets the Incident Work Info entry to Public or Internal. Defaults to Public
Submission ID Submission ID of the submission that should be used to retrieve answers.
Space Slug Space this is being used in. Can override provided info parameter.

Sample Configuration

Parameter Example Configuration
Work Order Number <%= @results['Work Order Create']['Work Order Number'] %>
Include Review Request Yes
Include Question Answers No
View Access Internal
Work Info Summary <%= @inputs['Summary'] %>
Work Info Notes <%= @inputs['Notes'] %>
Work Info Submit Date <%= @inputs['Date'] %>
Attachment Input Type Field
Attachment Field 1 Attachment Question A
Attachment Field 2 Attachment Question B
Attachment Field 3 Attachment Question C
Submitter <%= @inputs['Login Id'] %>
Locked Yes
View Access Public
Submission ID <%= @inputs['Submission ID'] %>
Space Slug  

Results

Name Description
Entry Id The Request Id of the generated Work Order Work Info entry.

Change Log

Version Date Description
1 2016-07-20 Initial version