Skip to main content

BMC Helix ITSM

This Integration is part of the BMC Helix ITSM Pack.#

Supported versions

Supported Cortex XSOAR versions: 6.2.0 and later.

BMC Helix ITSM integration enables customers to manage service request, incident, change request, task, problem investigation, known error and work order tickets. This integration was integrated and tested with version 22.1.05 of BmcITSM

Configure BMC Helix ITSM on Cortex XSOAR#

  1. Navigate to Settings > Integrations > Servers & Services.

  2. Search for BMC Helix ITSM.

  3. Click Add instance to create and configure a new integration instance.

    ParameterDescriptionRequired
    Server URLFor Example: https://localhost:8008True
    User NameTrue
    PasswordTrue
    Maximum Number of Incidents per FetchDefault is 50. Maximum is 200.False
    First fetch timestamp (<number> <time unit>, e.g., 12 hours, 7 days).False
    Ticket TypeThe type of the tickets to fetch.False
    Ticket StatusThe status of the tickets to fetch. Since each ticket type has its own unique set of statuses, select only statuses that match the selected ticket type(s).False
    Ticket ImpactThe impact of the tickets to fetch.False
    Ticket UrgencyThe urgency of the tickets to fetch.False
    Fetch by QuerySearch query to fetch tickets. For example: Status = "Draft" AND Impact = "1-Extensive/Widespread". The query is used in addition to the existing parameters. See the BMC documentation for building search qualifications.False
    Incident Mirroring DirectionChoose the direction to mirror the incident: Incoming (from BMC Helix ITSM to Cortex XSOAR), Outgoing (from Cortex XSOAR to BMC Helix ITSM), or Incoming and Outgoing (from/to Cortex XSOAR and BMC Helix ITSM).False
    Close Mirrored XSOAR IncidentWhen selected, closing the BMC Helix ITSM ticket is mirrored in Cortex XSOAR.False
    Close Mirrored BMC Helix ITSM TicketWhen selected, closing the Cortex XSOAR incident is mirrored in BMC Helix ITSM.False
    Use system proxy settingsFalse
    Trust any certificate (not secure)False
    Incident typeFalse
    Fetch incidentsFalse
  4. Click Test to validate the URLs, token, and connection.

Commands#

You can execute these commands from the Cortex XSOAR CLI, as part of an automation, or in a playbook. After you successfully execute a command, a DBot message appears in the War Room with the command details.

bmc-itsm-user-list#


Retrieves a list of user profiles from BMC Helix ITSM. The records are retrieved by the query argument or by the filtering arguments. When using filtering arguments, each one defines a 'LIKE' operation and an 'AND' operator is used between them. To see the entire JSON then you can use the raw_response=true at the end of the command.

Base Command#

bmc-itsm-user-list

Input#

Argument NameDescriptionRequired
user_idsA comma-separated list of user IDs. Used as a filtering argument.Optional
queryThe query to search by. For example: Status = "Draft" AND Impact = "1-Extensive/Widespread". The query is used in addition to the existing arguments. See the BMC documentation for building search qualifications.Optional
limitThe maximum number of records to retrieve. Default is 50.Optional
page_sizeThe maximum number of records to retrieve per page.Optional
pageThe page number of the results to retrieve.Optional
first_nameThe user first name. Used as a filtering argument.Optional
last_nameThe user first name. Used as a filtering argument.Optional
companyThe user company name. Used as a filtering argument.Optional
departmentThe user department name. Used as a filtering argument.Optional
organizationThe user organization name. Used as a filtering argument.Optional

Context Output#

PathTypeDescription
BmcITSM.User.IdStringThe user ID.
BmcITSM.User.FirstNameStringThe user first name.
BmcITSM.User.LastNameStringThe user last name.

Command example#

!bmc-itsm-user-list limit=2

Context Example#

{
"BmcITSM": {
"User": [
{
"Company": "Calbro Services",
"Department": null,
"FirstName": "App",
"Id": "PPL000000000005",
"LastName": "Admin",
"Organization": null,
"Region": "Americas",
"Site": "Headquarters, Building 1.31",
"SiteGroup": "United States"
},
{
"Company": "Calbro Services",
"Department": null,
"FirstName": "Orchestration",
"Id": "PPL000000000012",
"LastName": "Admin",
"Organization": null,
"Region": "Americas",
"Site": "Headquarters, Building 1.31",
"SiteGroup": "United States"
}
]
}
}

Human Readable Output#

List Users.#

Showing 2 records out of 12. |Id|First Name|Last Name|Company|Department|Site Group|Region|Site|Organization| |---|---|---|---|---|---|---|---|---| | PPL000000000005 | App | Admin | Calbro Services | | United States | Americas | Headquarters, Building 1.31 | | | PPL000000000012 | Orchestration | Admin | Calbro Services | | United States | Americas | Headquarters, Building 1.31 | |

bmc-itsm-company-list#


Retrieves a list of companies from BMC Helix ITSM. The records are retrieved by the query argument or by the filtering arguments. When using filtering arguments, each one defines a 'LIKE' operation and an 'AND' operator is used between them. To see the entire JSON then you can use the raw_response=true at the end of the command.

Base Command#

bmc-itsm-company-list

Input#

Argument NameDescriptionRequired
company_idsA comma-separated list of company ID. Filtering argument.Optional
queryThe query to search by. For example: Status = "Draft" AND Impact = "1-Extensive/Widespread". The query is used in addition to the existing arguments. See the BMC documentation for building search qualifications.Optional
limitThe maximum number of records to retrieve. Default is 50.Optional
page_sizeThe maximum number of records to retrieve per page.Optional
pageThe page number of the results to retrieve.Optional
companyThe user company name. Used as a filtering argument.Optional
company_typeThe user company type. Used as a filtering argument.Optional

Context Output#

PathTypeDescription
BmcITSM.Company.IdStringThe company ID.
BmcITSM.Company.NameStringThe company name.
BmcITSM.Company.TypeStringThe company type.

Command example#

!bmc-itsm-company-list limit=2

Context Example#

{
"BmcITSM": {
"Company": [
{
"Id": "CPY000000000015",
"Name": "- Global -",
"Type": "- System -"
},
{
"Id": "CPY000000000016",
"Name": "Adobe Systems",
"Type": "Manufacturer"
}
]
}
}

Human Readable Output#

List Companies.#

Showing 2 records out of 28. |Id|Name|Type| |---|---|---| | CPY000000000015 | - Global - | - System - | | CPY000000000016 | Adobe Systems | Manufacturer |

bmc-itsm-service-request-definition-list#


Retrieves a list of service request definitions. The records are retrieved by the query argument or by the filtering arguments. When using filtering arguments, each one defines a 'LIKE' operation and an 'AND' operator is used between them. To see the entire JSON then you can use the raw_response=true at the end of the command.

Base Command#

bmc-itsm-service-request-definition-list

Input#

Argument NameDescriptionRequired
srd_idsA comma-separated list of service request definition IDs. Used as a filtering argument.Optional
queryThe query to search by. For example: Status = "Draft" AND Impact = "1-Extensive/Widespread". The query is used in addition to the existing arguments. See the BMC documentation for building search qualifications.Optional
limitThe maximum number of records to retrieve. Default is 50.Optional
page_sizeThe maximum number of records to retrieve per page.Optional
pageThe page number of the results to retrieve.Optional
descriptionThe service request ticket definition description. Used as a filtering argument.Optional

Context Output#

PathTypeDescription
BmcITSM.ServiceRequestDefinition.IdStringThe service request ticket definition ID.
BmcITSM.ServiceRequestDefinition.DescriptionStringThe service request ticket definition description.
BmcITSM.ServiceRequestDefinition.InstanceIDStringThe service request ticket instance ID. Used for creating service requests.

Command example#

!bmc-itsm-service-request-definition-list limit=2

Context Example#

{
"BmcITSM": {
"ServiceRequestDefinition": [
{
"Description": "Other request to facilities that isn't specifically listed.",
"Id": "000000000000382|000000000000382",
"InstanceID": "SRGAA5V0GENAWAO6U31IO5YO03KYL3"
},
{
"Description": "Request to order new office equipment",
"Id": "000000000000381|000000000000381",
"InstanceID": "SRGAA5V0GENAWAO6U2OFO5YNN0K4Y6"
}
]
}
}

Human Readable Output#

List service request definitions.#

Showing 2 records out of 157. |Id|Description|Instance ID| |---|---|---| | 000000000000382|000000000000382 | Other request to facilities that isn't specifically listed. | SRGAA5V0GENAWAO6U31IO5YO03KYL3 | | 000000000000381|000000000000381 | Request to order new office equipment | SRGAA5V0GENAWAO6U2OFO5YNN0K4Y6 |

bmc-itsm-ticket-list#


Retrieves a list of BMC Helix ITSM tickets. The records are retrieved by the query argument or by the filtering arguments. When using filtering arguments, each one defines a 'LIKE' operation and an 'AND' operator is used between them. To see the entire JSON then you can use the raw_response=true at the end of the command.

Base Command#

bmc-itsm-ticket-list

Input#

Argument NameDescriptionRequired
ticket_typeThe type of tickets to search for. Possible values are: service request, incident, task, change request, problem investigation, known error, work order.Required
queryThe query to search by. For example: Status = "Draft" AND Impact = "1-Extensive/Widespread". The query is used in addition to the existing arguments. See the BMC documentation for building search qualifications.Optional
limitThe maximum number of records to retrieve. Default is 50.Optional
page_sizeThe maximum number of records to retrieve per page.Optional
pageThe page number of the results to retrieve.Optional
ticket_idsA comma-separated list of ticket request IDs. Used as a filtering argument. Use Display ID for work order type.Optional
statusThe status of the tickets to fetch. Since each ticket type has its own unique set of statuses, select only statuses that match the selected ticket type(s). Possible values are: Draft, In Cart, In Review, Submitted, Pending, Waiting Approval, Planning, In Progress, Completed, Rejected, Cancelled, Closed, New, Assigned, Resolved, Request For Authorization, Request For Change, Planning In Progress, Scheduled For Review, Scheduled For Approval, Scheduled, Implementation In Progress, Staged, Work In Progress, Waiting, Bypassed, Under Review, Under Investigation, Scheduled For Correction, Assigned To Vendor, No Action Planned, Corrected.Optional
impactThe ticket impact. Used as a filtering argument. Possible values are: 1-Extensive/Widespread, 2-Significant/Large, 3-Moderate/Limited, 4-Minor/Localized.Optional
urgencyThe ticket urgency. Used as a filtering argument. Possible values are: 1-Critical, 2-High, 3-Medium, 4-Low.Optional
priorityThe ticket priority. Used as a filtering argument. Possible values are: Critical, High, Medium, Low.Optional
risk_levelThe ticket risk level. Used as a filtering argument. Possible values are: Risk Level 1, Risk Level 2, Risk Level 3, Risk Level 4.Optional
change_typeThe ticket change type level. Relevant only for ticket type change requests. Used as a filtering argument. Possible values are: Project, Change, Release, Asset Configuration, Asset Management, Asset Lease, Purchase Requisition, Asset Maintenance.Optional
summaryThe ticket summary. Used as a filtering argument.Optional

Context Output#

PathTypeDescription
BmcITSM.Ticket.RequestIDStringThe ticket ID.
BmcITSM.Ticket.DisplayIDStringThe ticket request number.
BmcITSM.Ticket.InstanceIdStringThe ticket instance ID.
BmcITSM.Ticket.TypeStringThe ticket type.
BmcITSM.Ticket.TargetDateDateThe ticket target date in UTC.
BmcITSM.Ticket.StatusStringThe ticket status.
BmcITSM.Ticket.StatusReasonStringThe ticket status reason.
BmcITSM.Ticket.SubmitterStringThe ticket submitter.
BmcITSM.Ticket.PriorityStringThe ticket priority.
BmcITSM.Ticket.RiskLevelStringThe ticket risk level.
BmcITSM.Ticket.ImpactStringThe ticket impact.
BmcITSM.Ticket.UrgencyStringThe ticket urgency.
BmcITSM.Ticket.RequesterUnknownThe ticket requester info.
BmcITSM.Ticket.CustomerUnknownThe ticket customer info.
BmcITSM.Ticket.assigneeUnknownThe ticket assignee info.
BmcITSM.Ticket.SummaryStringThe ticket summary.
BmcITSM.Ticket.DetailsStringThe ticket details.
BmcITSM.Ticket.CreateDateDateThe ticket create date time in UTC.
BmcITSM.Ticket.LastModifiedDateDateThe ticket last update date time in UTC.

Command example#

!bmc-itsm-ticket-list ticket_type="service request" limit=2

Context Example#

{
"BmcITSM": {
"Ticket": [
{
"Assignee": {
"AssignedGroup": null,
"FullName": "Mary Mann",
"Group": "Backoffice Support",
"SupportCompany": "Calbro Services",
"SupportOrganization": "IT Support"
},
"CreateDate": "2022-06-29T14:38:36",
"Customer": {
"Company": "Calbro Services",
"Department": null,
"E-mail": null,
"FirstName": "App",
"LastName": "Admin",
"Organization": null,
"PhoneNumber": "###"
},
"Details": null,
"DisplayID": "REQ000000000398",
"Impact": "1-Extensive/Widespread",
"InstanceId": "AGGAI7ZXDK9WFAR4IUA2R3J3RVIB6Q",
"LastModifiedDate": "2022-07-11T07:27:05",
"Priority": null,
"Request Type": "Standard",
"RequestID": "000000000000396",
"Requester": {
"Company": "Calbro Services",
"FirstName": "App",
"LastName": "Admin",
"Region": "Americas",
"Site": "Headquarters, Building 1.31",
"SiteGroup": "United States"
},
"Status": "Planning",
"StatusReason": null,
"Submitter": "appadmin",
"Summary": "Add user access to network",
"TargetDate": null,
"Type": "service request",
"Urgency": "2-High"
},
{
"Assignee": {
"AssignedGroup": null,
"FullName": "Bob Baxter",
"Group": "Backoffice Support",
"SupportCompany": "Calbro Services",
"SupportOrganization": "IT Support"
},
"CreateDate": "2022-06-29T14:38:36",
"Customer": {
"Company": "Calbro Services",
"Department": null,
"E-mail": null,
"FirstName": "App",
"LastName": "Admin",
"Organization": null,
"PhoneNumber": "###"
},
"Details": null,
"DisplayID": "REQ000000000400",
"Impact": "1-Extensive/Widespread",
"InstanceId": "AGGAI7ZXDK9WFAR4IUA2R3J3RVIB6W",
"LastModifiedDate": "2022-07-11T07:27:05",
"Priority": null,
"Request Type": "Standard",
"RequestID": "000000000000398",
"Requester": {
"Company": "Calbro Services",
"FirstName": "App",
"LastName": "Admin",
"Region": "Americas",
"Site": "Headquarters, Building 1.31",
"SiteGroup": "United States"
},
"Status": "Planning",
"StatusReason": null,
"Submitter": "appadmin",
"Summary": "Add SAP printer",
"TargetDate": null,
"Type": "service request",
"Urgency": "2-High"
}
]
}
}

Human Readable Output#

List Tickets.#

Showing 2 records out of 227. |Type|Request ID|Display ID|Summary|Status|Urgency|Impact|Create Date|Last Modified Date| |---|---|---|---|---|---|---|---|---| | service request | 000000000000396 | REQ000000000398 | Add user access to network | Planning | 2-High | 1-Extensive/Widespread | 2022-06-29T14:38:36 | 2022-07-11T07:27:05 | | service request | 000000000000398 | REQ000000000400 | Add SAP printer | Planning | 2-High | 1-Extensive/Widespread | 2022-06-29T14:38:36 | 2022-07-11T07:27:05 |

bmc-itsm-service-request-create#


Creates a new service request ticket. A service request ticket is the request record that is generated from the service request definition to manage and track the execution. To create it, you need to provide the srd_instance_id argument, which can be retrieved by by executing the bmc-itsm-service-request-definition-list command and extracting the instanceID field. User and company arguments can be retrieved by executing the bmc-itsm-user-list and bmc-itsm-company-list. To see the entire JSON, you can use the raw_response=true at the end of the command.

Base Command#

bmc-itsm-service-request-create

Input#

Argument NameDescriptionRequired
srd_instance_idThe instance ID of the service request ticket. It can be retrieved by executing bmc-itsm-service-request-definition-list command.Required
first_nameThe requester first name. By default it is determined by the logged in user. If provided, login_id, first_name, and last_name arguments must be provided together.Optional
last_nameThe requester last name. By default it is determined by the logged in user. If provided, login_id, first_name, and last_name arguments must be provided together.Optional
login_idThe requester login ID. By default it is determined by the logged in user. If provided, login_id, first_name, and last_name arguments must be provided together.Optional
summaryThe service request ticket summary.Optional
statusThe service request ticket status. Possible values are: Draft, In Cart, In Review, Submitted, Pending, Waiting Approval, Planning, In Progress, Completed, Rejected, Cancelled, Closed.Optional
urgencyThe ticket urgency. Required when the ticket creation is without a template. Possible values are: 1-Critical, 2-High, 3-Medium, 4-Low.Optional
impactThe ticket impact. Required when the ticket creation is without a template. Possible values are: 1-Extensive/Widespread, 2-Significant/Large, 3-Moderate/Limited, 4-Minor/Localized.Optional
additional_fieldsThe fields which are not present in the current argument list can be added here in the format "fieldname1=value;fieldname2=value". Possible fields: Assigned Group, Assignee, or any other custom field.Optional

Context Output#

PathTypeDescription
BmcITSM.ServiceRequest.RequestIDStringThe service request ticket unique request ID.
BmcITSM.ServiceRequest.DisplayIDStringThe service request ticket request number.
BmcITSM.ServiceRequest.CreateDateDateThe service request ticket create date time in UTC.

Command example#

!bmc-itsm-service-request-create service_request_definition_id=SRGAA5V0GENAWAO6ZQWYO6EBWDOUAU

Context Example#

{
"BmcITSM": {
"Task": {
"CreateDate": "2022-07-27T08:44:43",
"DisplayID": "REQ000000000513",
"RequestID": "000000000000513"
}
}
}

Human Readable Output#

Task ticket successfully Created.#

Create DateDisplay IDRequest ID
2022-07-27T08:44:43TAS000000000413TAS000000000413

bmc-itsm-service-request-update#


Updates the details of a service request ticket for a given request ID. User and company related arguments can be retrieved by executing the bmc-itsm-user-list and bmc-itsm-company-list commands.

Base Command#

bmc-itsm-service-request-update

Input#

Argument NameDescriptionRequired
ticket_request_idThe unique identifier of the service request ticket to update.Required
customer_first_nameThe customer first name. By default it is determined by the logged in user.Optional
customer_last_nameThe customer last name. By default it is determined by the logged in user.Optional
statusThe service request ticket status. Possible values are: Draft, In Cart, In Review, Submitted, Pending, Waiting Approval, Planning, In Progress, Completed, Rejected, Cancelled, Closed.Optional
urgencyThe ticket request urgency. Required when the ticket creation is without a template. Possible values are: 1-Critical, 2-High, 3-Medium, 4-Low.Optional
impactIncident Request impact. Required when the ticket creation is without a template. Possible values are: 1-Extensive/Widespread, 2-Significant/Large, 3-Moderate/Limited, 4-Minor/Localized.Optional
status_reasonThe reason for updating the status. Required only if status argument is provided. Possible values are: Review, Need More Information, Approval, System Error, With Issues, Automatically Closed, Successful, By User, By Provider, System, Cancelled, Reopen By User.Optional
location_companyThe company associated with the service request process.Optional
regionThe region associated with the company location.Optional
site_groupThe site group associated with the region.Optional
siteThe site associated with the site group.Optional
assigneeThe full name of the employee the ticket will be assigned to. It can be retrieved by using the bmc-itsm-user-list command.Optional
additional_fieldsThe fields which are not present in the current argument list can be added here in the format "fieldname1=value;fieldname2=value". Possible fields: Assigned Group, Assignee, or any other custom field.Optional

Context Output#

There is no context output for this command.

Command example#

!bmc-itsm-service-request-update service_request_id=000000000000259 status=Cancelled status_reason=Cancelled

Human Readable Output#

Service Request: 000000000000259 was successfully updated.

bmc-itsm-incident-update#


Update incident ticket.

Base Command#

bmc-itsm-incident-update

Input#

Argument NameDescriptionRequired
ticket_request_idThe ID of the incident ticket to update.Required
first_nameThe customer first name the incident ticket is for.Optional
last_nameThe customer last name the incident ticket is for.Optional
summaryThe incident ticket summary.Optional
service_typeThe type of the incident ticket. Possible values are: User Service Restoration, User Service Request, Infrastructure Restoration, Infrastructure Event, Security Incident.Optional
urgencyThe ticket urgency. Required when the ticket creation is without a template. Possible values are: 1-Critical, 2-High, 3-Medium, 4-Low.Optional
impactThe ticket impact. Required when the ticket creation is without a template. Possible values are: 1-Extensive/Widespread, 2-Significant/Large, 3-Moderate/Limited, 4-Minor/Localized.Optional
statusThe incident ticket status. Possible values are: New, Assigned, In Progress, Pending, Resolved, Closed, Cancelled.Optional
reported_sourceThe incident ticket reported source. Possible values are: Direct Input, Email,External Escalation, Fax, Self Service, Systems Management, Phone, Voice Mail, Walk In, Web, Other, BMC Impact Manager Event.Optional
additional_fieldsThe fields which are not present in the current argument list can be added here in the format "fieldname1=value;fieldname2=value". Possible fields: Assigned Group, Assignee, or any other custom field. Possible values are: The fields which are not present in the current argument list can be added here in the format "fieldname1=value;fieldname2=value".Possible fields: Assigned Group, Assignee, or any other custom field..Optional
detailed_descriptionThe incident ticket summary.Optional
companyThe company associated with the requester. By default it is determined by the logged in user.Optional
assigned_support_companyThe company for the assignee’s support organization. It makes up the first tier of the assignee’s support organization data structure.Optional
assigned_support_organizationThe organization for the assignee’s support organization. It makes up the second tier of the assignee’s support organization data structure.Optional
assigned_groupThe group for the assignee’s support organization. It makes up the third tier of the assignee’s support organization data structure.Optional
assigneeThe full name of the employee the ticket will be assigned to. It can be retrieved by using the bmc-itsm-user-list command.Optional
assignee_login_idThe login ID of the assignee. The assignee and assignee_login_id arguments must be provided together.Optional
regionThe region, which makes up the second tier of the customer’s business organization data structure.Optional
site_groupThe site group associated with the region.Optional
siteThe site associated with the site group.Optional
status_reasonThe reason for updating the ticket status. Required when status is provided. Possible values are: Infrastructure Change Created, Local Site Action Required, Purchase Order Approval, Registration Approval, Supplier Delivery, Support Contact Hold, Third Party Vendor Action Reqd, Client Action Required, Infrastructure Change Request, Future Enhancement, Pending Original Incident, Client Hold, Monitoring Incident, Customer Follow-Up Required, Temporary Corrective Action, No Further Action Required, Resolved by Original Incident, Automated Resolution Reported, No longer a Causal CI, Pending Causal Incident Resolution, Resolved by Causal Incident.Optional
resolutionThe ticket resolution description. Required when status is provided.Optional

Context Output#

There is no context output for this command.

Command example#

!bmc-itsm-incident-update request_id=INC000000000532 assignee="Mary Mann" assignee_login_id=Mary impact="2-Significant/Large" urgency="1-Critical"

Human Readable Output#

Incident: INC000000000532 was successfully updated.

bmc-itsm-ticket-delete#


Deletes a ticket by its request ID. Only admin users can perform this command.

Base Command#

bmc-itsm-ticket-delete

Input#

Argument NameDescriptionRequired
ticket_idsA comma-separated list of ticket request IDs to delete.Required
ticket_typeThe type of the tickets to delete. Possible values are: incident, task, change request, problem investigation, known error, work order.Required

Context Output#

There is no context output for this command.

Command example#

!bmc-itsm-ticket-delete ticket_ids=TAS000000000260 ticket_type=task

Human Readable Output#

task TAS000000000260 was deleted successfully

bmc-itsm-incident-create#


Creates a new incident ticket. An incident is any event that is not part of the standard operation of a service and that causes an interruption to or a reduction in the quality of that service.

Base Command#

bmc-itsm-incident-create

Input#

Argument NameDescriptionRequired
first_nameThe customer first name the incident ticket is for.Required
last_nameThe customer last name the incident ticket is for.Required
template_instance_idThe instance ID of the template to use. Required only when the ticket attributes should be based on the template's fields. The instance ID can be retrieved by executing the bmc-itsm-incident-template-list command.Optional
summaryThe incident ticket summary. Required when the template_instance_id argument is not provided.Optional
service_typeThe type of the incident ticket. Required when the template_instance_id argument is not provided. Possible values are: User Service Restoration, User Service Request, Infrastructure Restoration, Infrastructure Event, Security Incident.Optional
urgencyThe ticket urgency. Required when the ticket creation is without a template. Possible values are: 1-Critical, 2-High, 3-Medium, 4-Low.Required
impactThe ticket impact. Required when the creation is without a template. Possible values are: 1-Extensive/Widespread, 2-Significant/Large, 3-Moderate/Limited, 4-Minor/Localized.Required
statusIncident status. Possible values are: New, Assigned, In Progress, Pending, Resolved, Closed, Cancelled.Required
reported_sourceThe incident ticket reported source. Required when the template_instance_id argument is not provided. Possible values are: Direct Input, Email,External Escalation, Fax, Self Service, Systems Management, Phone, Voice Mail, Walk In, Web, Other, BMC Impact Manager Event.Optional
additional_fieldsThe fields which are not present in the current argument list can be added here in the format "fieldname1=value;fieldname2=value". Possible fields: Assigned Group, Assignee, or any other custom field. Possible values are: The fields which are not present in the current argument list can be added here in the format "fieldname1=value;fieldname2=value".Possible fields: Assigned Group, Assignee, or any other custom field..Optional
detailsThe incident ticket detailed description.Optional
companyThe company associated with the requester. By default it is determined by the logged in user.Optional
assigned_support_companyThe company for the assignee’s support organization. It makes up the first tier of the assignee’s support organization data structure.Optional
assigned_support_organizationThe organization for the assignee’s support organization. It makes up the second tier of the assignee’s support organization data structure.Optional
assigned_groupThe group for the assignee’s support organization. It makes up the third tier of the assignee’s support organization data structure.Optional
assigneeThe full name of the employee the ticket will be assigned to. The assignee and assignee_login_id arguments must be provided together. It can be retrieved by using the bmc-itsm-user-list command.Optional
assignee_login_idThe login ID of the assignee. The assignee and assignee_login_id arguments must be provided together. It can be retrieved by using the bmc-itsm-user-list command.Optional
regionThe region associated with the company.Optional
site_groupThe site group associated with the region.Optional
siteThe site associated with the site group.Optional

Context Output#

PathTypeDescription
BmcITSM.Incident.RequestIDStringThe incident ticket request ID.
BmcITSM.Incident.DisplayIDStringThe incident ticket display ID.
BmcITSM.Incident.CreateDateDateThe incident ticket create date time in UTC.

Command example#

!bmc-itsm-incident-create first_name=Allen last_name=Allbrook impact="1-Extensive/Widespread" status=Assigned urgency="1-Critical" template_instance_id=AG00123F73CF5EKnsTSQ5rvrAAZfQA

Context Example#

{
"BmcITSM": {
"Incident": {
"CreateDate": "2022-07-27T08:44:51",
"DisplayID": "INC000000000505",
"RequestID": "INC000000000606"
}
}
}

Human Readable Output#

Incident ticket successfully Created#

Create DateDisplay IDRequest ID
2022-07-27T08:44:51INC000000000505INC000000000606

bmc-itsm-change-request-create#


Creates a change request ticket in BMC Helix ITSM. The ticket is created by using a template or from scratch.

Base Command#

bmc-itsm-change-request-create

Input#

Argument NameDescriptionRequired
first_nameThe requester first name.Required
last_nameThe requester last name.Required
customer_first_nameThe customer first name.Optional
customer_last_nameThe customer last name.Optional
summaryThe change request ticket title. Required when the template ID argument is not provided.Optional
template_idThe instance ID of the template to use. Required only when the ticket attributes should be based on the template's fields. The ID can be retrieved by executing the bmc-itsm-change-request-template-list command.Optional
change_typeThe change request ticket type. Required when the ticket creation is without a template. Possible values are: Project, Change, Release, Asset Configuration, Asset Management, Asset Lease, Purchase Requisition, Asset Maintenance.Optional
change_timingThe class of the change request ticket which best describes your scenario. Possible values are: Emergency, Expedited, Latent, Normal, No Impact, Standard.Optional
impactThe change request ticket impact. Required when the ticket creation is without a template. Possible values are: 1-Extensive/Widespread, 2-Significant/Large, 3-Moderate/Limited, 4-Minor/Localized.Optional
urgencyThe change request ticket urgency. Required when the ticket creation is without a template. Possible values are: 1-Critical, 2-High, 3-Medium, 4-Low.Optional
risk_levelThe change request ticket risk level. Required when the ticket creation is without a template. Possible values are: Risk Level 1, Risk Level 2, Risk Level 3, Risk Level 4, Risk Level 5.Optional
statusThe change request ticket status. Required when the ticket creation is without a template. Possible values are: Request For Authorization, Request For Change, Planning In Progress, Scheduled For Review, Scheduled For Approval, Scheduled, Implementation In Progress, Pending, Rejected, Completed, Closed, Cancelled.Optional
location_companyThe company associated with the change request process. Required when template ID argument is not provided.Optional
additional_fieldsThe fields which are not present in the current argument list can be added here in the format "fieldname1=value;fieldname2=value". Possible fields: Assigned Group, Assignee, or any other custom field.Optional

Context Output#

PathTypeDescription
BmcITSM.ChangeRequest.RequestIDStringThe change request ticket unique request ID.
BmcITSM.ChangeRequest.DisplayIDStringThe change request ticket request number.
BmcITSM.ChangeRequest.CreateDateDateThe change request ticket create date time.

Command example#

!bmc-itsm-change-request-create template_id=AG00123F73CF5EK3sTSQTb3rAAbfQA first_name=Allen last_name=Allbrook summary="Change request for README"

Context Example#

{
"BmcITSM": {
"ChangeRequest": {
"CreateDate": "2022-07-27T08:44:24",
"DisplayID": "CRQ000000000404",
"RequestID": "CRQ000000000406"
}
}
}

Human Readable Output#

Change Request ticket successfully Created#

Create DateDisplay IDRequest ID
2022-07-27T08:44:24CRQ000000000404CRQ000000000406

bmc-itsm-change-request-update#


Updates the details of change request ticket for the specified request ID.

Base Command#

bmc-itsm-change-request-update

Input#

Argument NameDescriptionRequired
ticket_request_idThe ID of the change request ticket to update.Required
first_nameThe customer first name the change request ticket is for.Optional
last_nameThe customer last name the change request ticket is for.Optional
summaryThe change request ticket summary.Optional
change_typeThe change request ticket type. Possible values are: Project, Change, Release, Asset Configuration, Asset Management, Asset Lease, Purchase Requisition, Asset Maintenance.Optional
change_timingThe class of the change request ticket which best describes your scenario. Possible values are: Emergency, Expedited, Latent, Normal, No Impact, Standard.Optional
impactThe change request ticket impact. Possible values are: 1-Extensive/Widespread, 2-Significant/Large, 3-Moderate/Limited, 4-Minor/Localized.Optional
urgencyThe change request ticket urgency. Possible values are: 1-Critical, 2-High, 3-Medium, 4-Low.Optional
risk_levelThe change request ticket risk level. Possible values are: Risk Level 1, Risk Level 2, Risk Level 3, Risk Level 4, Risk Level 5.Optional
statusThe change request ticket status. Possible values are: Request For Authorization, Request For Change, Planning In Progress, Scheduled For Review, Scheduled For Approval, Scheduled, Implementation In Progress, Pending, Rejected, Completed, Closed, Cancelled.Optional
additional_fieldsThe fields which are not present in the current argument list can be added here in the format "fieldname1=value;fieldname2=value". Possible fields: Assigned Group, Assignee, or any other custom field.Optional
companyThe company associated with the requester. By default it is determined by the logged in user.Optional
organizationThe organization associated with the requester.Optional
departmentThe department associated with the requester.Optional
location_companyThe company associated with the change request process.Optional
regionThe region associated with the company location.Optional
site_groupThe site group associated with the region.Optional
siteThe site associated with the site group.Optional
support_organizationThe second tier of the change manager’s support organization data structure.Optional
support_group_nameThe third tier of the change manager’s support organization data structure.Optional
status_reasonThe reason for updating the ticket status. Required when status is provided. Possible values are: No Longer Required, Funding Not Available, To Be Re-Scheduled, Resources Not Available, Successful, Successful with Issues, Unsuccessful, Backed Out, Final Review Complete, Final Review Required, Additional Coding Required, Insufficient Task Data, In Verification, In Rollout, Insufficient Change Data, Schedule Conflicts, In Development, In Test, In Build, In Rollback, In Documentation, Vendor Purchase, Support Group Communication, Task Review, Miscellaneous, Future Enhancement, Manager Intervention, Accepted, Assigned, Built, On Hold.Optional
detailsThe change request ticket details.Optional

Context Output#

There is no context output for this command.

Command example#

!bmc-itsm-change-request-update reuqest_id=CRQ000000000313 status="Request For Authorization" details="more details" status_reason=Accepted

Human Readable Output#

Incident: CRQ000000000313 was successfully updated.

bmc-itsm-task-create#


Creates a new task ticket. By splitting cases into individual tasks (assignments), you can focus on one assignment at a time to resolve cases more efficiently. Task ticket type can be attached only to the following ticket types: change request, incident, problem investigation, known error and work order.

Base Command#

bmc-itsm-task-create

Input#

Argument NameDescriptionRequired
template_idThe instance ID of the template to use. The ID can be retrieved by executing the bmc-itsm-task-template-list command.Optional
summaryThe task ticket summary.Required
detailsThe task ticket detailed description.Required
root_ticket_typeThe parent ticket type. Possible values are: change request, incident, problem investigation, known error, work order.Required
root_request_idThe request ID of the parent ticket. Can be found in the context output of the bmc-itsm-ticket-list command. Use Display ID for work orders.Required
root_request_nameThe display name of the parent ticket in the task ticket. If not provided, the parent ticket displayID is displayed.Optional
root_request_modeThe parent ticket request mode. Possible values are: Real, Simulation. Default is Real.Optional
statusThe task status. Possible values are: Staged, Assigned, Pending, Work In Progress, Waiting, Closed, Bypassed.Required
task_typeWhether the task is manual or automatic. Possible values are: Automatic, Manual.Optional
additional_fieldsThe fields which are not present in the current argument list can be added here in the format "fieldname1=value;fieldname2=value". Possible fields: Assignee or any other custom field. Possible values are: The fields which are not present in the current argument list can be added here in the format "fieldname1=value;fieldname2=value".Possible fields: Assignee or any other custom field..Optional
priorityThe task ticket priority. Possible values are: Critical, High, Medium, Low.Required
location_companyThe company associated with the task process.Required
support_companyThe technical support team associated with the company.Optional
assigned_support_organizationThe organization for the task's support organization. It makes up the second tier of the task’s support organization data structure. The arguments assigned_support_organization, assigned_group, and support_company should be provided together.Optional
assigned_support_groupThe group for the task's support organization. It makes up the third tier of the task's support organization data structure. The arguments assigned_support_organization, assigned_group, and support_company should be provided together.Optional
impactThe task ticket impact. Possible values are: 1-Extensive/Widespread, 2-Significant/Large, 3-Moderate/Limited, 4-Minor/Localized.Optional
urgencyThe task ticket urgency. Possible values are: 1-Critical, 2-High, 3-Medium, 4-Low.Optional
assigneeThe full name of the employee the ticket will be assigned to. It can be retrieved by using the bmc-itsm-user-list command.Optional
scedulded_start_dateThe task ticket scheduled future start date. For example, in 12 hours, in 7 days.Optional
scedulded_end_dateThe task ticket scheduled future end date. For example, in 12 hours, in 7 days.Optional

Context Output#

PathTypeDescription
BmcITSM.Task.RequestIDStringThe task ticket unique Request ID.
BmcITSM.Task.DisplayIDStringThe task ticket request display ID.
BmcITSM.Task.CreateDateDateThe task ticket creation date time in UTC.

Command example#

!bmc-itsm-task-create location_company="Calbro Services" details="Details" priority=Critical root_request_id=PBI000000000322 root_request_name=error root_ticket_type="problem investigation" status=Assigned summary="Summary task" assigned_support_group="Service Desk" assigned_support_organization="IT Support" support_company="Calbro Services" task_type=Manual assignee="Francie Stafford" scedulded_end_date="in 10 days" scedulded_start_date="in 2 days"

Context Example#

{
"BmcITSM": {
"Task": {
"CreateDate": "2022-07-27T08:44:43",
"DisplayID": "TAS000000000413",
"RequestID": "TAS000000000413"
}
}
}

Human Readable Output#

Task ticket successfully Created.#

Create DateDisplay IDRequest ID
2022-07-27T08:44:43TAS000000000413TAS000000000413

bmc-itsm-task-update#


Updates the task ticket.

Base Command#

bmc-itsm-task-update

Input#

Argument NameDescriptionRequired
ticket_request_idThe ID of the task ticket to update.Required
summaryThe task ticket summary.Optional
detailsThe task ticket detailed description.Optional
priorityThe task ticket priority. Possible values are: Critical, High, Medium, Low.Optional
statusThe task ticket status. Possible values are: Staged, Assigned, Pending, Work In Progress, Waiting, Closed, Bypassed.Optional
status_reasonThe reason for changing the ticket status. Required when the status is changed. Possible values are: Success, Failed, Cancelled, Assignment, Staging in Progress, Staging Complete, Acknowledgment, Another Task, Task Rule, Completion, Error.Optional
companyThe company associated with the requester. By default it is determined by the logged in user.Optional
location_companyThe company associated with the task process.Optional
support_companyThe technical support team associated with the company.Optional
assigneeThe full name of the employee the ticket is assigned to. It can be retrieved by using the bmc-itsm-user-list command.Optional
assigned_support_organizationThe organization for the problem assignee’s support organization. It makes up the second tier of the problem assignee’s support organization data structure. The arguments assigned_support_organization, assigned_group, and assigned_support_company should be provided together.Optional
assigned_groupThe group for the problem assignee's support organization. It makes up the third tier of the problem assignee's support organization data structure. The arguments assigned_support_organization, assigned_group, and support_company should be provided together.Optional
task_typeThe task ticket type. Possible values are: Automatic, Manual.Optional
additional_fieldsThe fields which are not present in the current argument list can be added here in the format "fieldname1=value;fieldname2=value". Possible fields: Assignee or any other custom field. Possible values are: The fields which are not present in the current argument list can be added here in the format "fieldname1=value;fieldname2=value".Possible fields: Assignee or any other custom field..Optional
scedulded_start_dateThe task ticket scheduled future start date. For example, in 12 hours, in 7 days.Optional
scedulded_end_dateThe task ticket scheduled future end date. For example, in 12 hours, in 7 days.Optional

Context Output#

There is no context output for this command.

Command example#

!bmc-itsm-task-update task_id=TAS000000000305 company=test priority=High status="Work In Progress" status_reason="Task Rule" summary="Updated summary for demo" details="Updated details for demo"

Human Readable Output#

Task: TAS000000000305 was successfully updated.

bmc-itsm-problem-investigation-create#


Creates a problem investigation ticket.

Base Command#

bmc-itsm-problem-investigation-create

Input#

Argument NameDescriptionRequired
first_nameThe customer first name the ticket request is for.Required
last_nameThe customer last name the ticket request is for.Required
statusThe problem investigation ticket status. Possible values are: Draft, Under Review, Request for Authorization, Assigned, Under Investigation, Pending, Completed, Rejected, Closed, Cancelled.Required
investigation_driverThe problem investigation ticket driver. Possible values are: High Impact Incident, Re-Occurring Incidents, Non-Routine Incident, Other.Required
summaryThe problem investigation ticket summary.Required
detailsThe detailed description on the problem investigation ticket.Optional
impactThe problem investigation ticket impact. Possible values are: 1-Extensive/Widespread, 2-Significant/Large, 3-Moderate/Limited, 4-Minor/Localized.Required
urgencyThe problem investigation ticket urgency. Possible values are: 1-Critical, 2-High, 3-Medium, 4-Low.Required
target_resolution_dateThe future resolution date. For example, in 12 hours, in 7 days.Optional
companyThe company associated with the requester. By default it is determined by the logged in user.Optional
regionThe region of the problem investigation location. The arguments region, site_group, and site should be provided together.Optional
site_groupThe site group of the problem investigation location. The arguments region, site_group, and site should be provided together.Optional
siteThe site of the problem investigation location. The arguments region, site_group, and site should be provided together.Optional
assigneeThe full name of the employee the ticket will be assigned to. It can be retrieved by using the bmc-itsm-user-list command.Optional
assignee_pbm_mgrThe full name of the employee the ticket will be assigned to as the problem coordinator. It can be retrieved by using the bmc-itsm-user-list command.Optional
assigned_group_pbm_mgrThe group for the problem coordinator’s support organization, which makes up the third tier of the problem coordinator’s support organization data structure. The arguments support_organization_pbm_mgr, assigned_group_pbm_mgr, and support_company_pbm_mgr should be provided together.Optional
support_company_pbm_mgrThe company for the problem coordinator’s support organization, which makes up the first tier of the problem coordinator’s support organization data structure. The arguments support_organization_pbm_mgr, assigned_group_pbm_mgr, and support_company_pbm_mgr should be provided together.Optional
support_organization_pbm_mgrThe organization for the problem coordinator’s support organization, which makes up the second tier of the problem coordinator’s support organization data structure. The arguments support_organization_pbm_mgr, assigned_group_pbm_mgr, and support_company_pbm_mgr should be provided together.Optional
assigned_support_companyThe company for the problem assignee’s support organization. It makes up the first tier of the problem assignee’s support organization data structure. The arguments assigned_support_organization, assigned_group, and assigned_support_company should be provided together.Optional
assigned_support_organizationThe organization for the problem assignee’s support organization. It makes up the second tier of the problem assignee’s support organization data structure. The arguments assigned_support_organization, assigned_group, and assigned_support_company should be provided together.Optional
assigned_groupThe group for the problem assignee's support organization. It makes up the third tier of the problem assignee's support organization data structure. The arguments assigned_support_organization, assigned_group, and support_company should be provided together.Optional
investigation_justificationThe justification for the ticket creation.Optional
temporary_workaroundThe problem workaround.Optional
resolutionThe ticket resolution.Optional
additional_fieldsThe fields which are not present in the current argument list can be added here in the format "fieldname1=value;fieldname2=value". Possible fields: Assigned Group, Assignee or any other custom field.Optional

Context Output#

PathTypeDescription
BmcITSM.ProblemInvestigation.RequestIDStringThe problem investigation ticket unique Request ID.
BmcITSM.ProblemInvestigation.DisplayIDStringThe problem investigation ticket display ID.
BmcITSM.ProblemInvestigation.CreateDateDateThe problem investigation ticket creation date time in UTC.

Command example#

!bmc-itsm-problem-investigation-create first_name=Allen last_name=Allbrook summary=Test-create-prob urgency="1-Critical" impact="4-Minor/Localized" details="Problem details" status=Assigned target_resolution_date="in 3 days" assigned_support_company="Calbro Services" assigned_support_organization="IT Support" assigned_group="Backoffice Support" investigation_driver="High Impact Incident"

Context Example#

{
"BmcITSM": {
"ProblemInvestigation": {
"CreateDate": "2022-07-27T08:44:33",
"DisplayID": "PBI000000000404",
"RequestID": "PBI000000000404"
}
}
}

Human Readable Output#

Problem Investigation ticket successfully Created#

Create DateDisplay IDRequest ID
2022-07-27T08:44:33PBI000000000404PBI000000000404

bmc-itsm-problem-investigation-update#


Updates The problem investigation ticket type.

Base Command#

bmc-itsm-problem-investigation-update

Input#

Argument NameDescriptionRequired
ticket_request_idThe problem investigation ticket request ID.Required
statusThe problem investigation ticket status. Possible values are: Draft, Under Review, Request for Authorization, Assigned, Under Investigation, Pending, Completed, Rejected, Closed, Cancelled.Optional
investigation_driverThe problem investigation ticket driver. Possible values are: High Impact Incident, Re-Occuring Incidents, Non-Routine Incident, Other.Optional
summaryThe problem investigation ticket summary.Optional
impactThe problem investigation ticket impact. Possible values are: 1-Extensive/Widespread, 2-Significant/Large, 3-Moderate/Limited, 4-Minor/Localized.Optional
urgencyThe problem investigation ticket urgency. Possible values are: 1-Critical, 2-High, 3-Medium, 4-Low.Optional
target_resolution_dateThe problem investigation ticket target resolution date. For example, in 12 hours, in 7 days.Optional
detailsThe problem investigation ticket detailed description.Optional
companyThe company associated with the requester. By default it is determined by the logged in user.Optional
regionThe region of the problem investigation location. The arguments region, site_group, and site should be provided together.Optional
site_groupThe site group of the problem investigation location. The arguments region, site_group, and site should be provided together.Optional
siteThe site of the problem investigation location.The arguments region, site_group, and site should be provided together.Optional
assigned_toThe technical support person the ticket is assigned to.Optional
assigned_group_pbm_mgrThe group for the problem coordinator’s support organization, which makes up the third tier of the problem coordinator’s support organization data structure. The arguments support_organization_pbm_mgr, assigned_group_pbm_mgr, and support_company_pbm_mgr should be provided together.Optional
support_company_pbm_mgrThe company for the problem coordinator’s support organization, which makes up the first tier of the problem coordinator’s support organization data structure. The arguments support_organization_pbm_mgr, assigned_group_pbm_mgr, and support_company_pbm_mgr should be provided together.Optional
support_organization_pbm_mgrThe organization for the problem coordinator’s support organization, which makes up the second tier of the problem coordinator’s support organization data structure. The arguments support_organization_pbm_mgr, assigned_group_pbm_mgr, and support_company_pbm_mgr should be provided together.Optional
assigned_support_companyThe company for the problem assignee’s support organization. It makes up the first tier of the problem assignee’s support organization data structure. The arguments assigned_support_organization, assigned_group, and assigned_support_company should be provided together.Optional
assigned_support_organizationThe organization for the problem assignee’s support organization. It makes up the second tier of the problem assignee’s support organization data structure. The arguments assigned_support_organization, assigned_group, and assigned_support_company should be provided together.Optional
assigned_groupThe group for the problem assignee's support organization. It makes up the third tier of the problem assignee's support organization data structure. The arguments assigned_support_organization, assigned_group, and support_company should be provided together.Optional
investigation_justificationThe justification for the ticket creation.Optional
temporary_workaroundThe problem workaround.Optional
resolutionThe ticket resolution.Optional
status_reasonThe reason for changing the status. Required when the status argument is provided. Possible values are: Publish, Reject, Not Applicable.Optional

Context Output#

There is no context output for this command.

Command example#

!bmc-itsm-problem-investigation-update problem_investigation_id=PBI000000000322 details="updated problem details" status="Under Investigation" status_reason=Publish

Human Readable Output#

Problem Investigation: PBI000000000322 was successfully updated.

bmc-itsm-known-error-create#


Create known error ticket.

Base Command#

bmc-itsm-known-error-create

Input#

Argument NameDescriptionRequired
statusThe known error ticket status. Possible values are: Assigned, Scheduled For Correction, Assigned To Vendor, No Action Planned, Corrected, Closed, Cancelled.Required
summaryThe known error ticket summary.Required
detailsThe known error ticket Detailed description.Required
impactThe known error ticket impact. Possible values are: 1-Extensive/Widespread, 2-Significant/Large, 3-Moderate/Limited, 4-Minor/Localized.Required
urgencyThe known error ticket urgency. Possible values are: 1-Critical, 2-High, 3-Medium, 4-Low.Required
view_accessWhether if the ticket is for internal view or public view. Possible values are: Public, Internal.Required
companyCompany associated with the Requester.Required
target_resolution_dateKnown error resolution date. Future resolution date. For example, in 12 hours, in 7 days.Required
resolutionTicket resolution.Optional
assigned_group_pbm_mgrIt makes up the third tier of the Problem Coordinator’s Support Organization data structure.Optional
support_company_pbm_mgrthe Company for the Problem Coordinator’s Support Organization. It makes up the first tier of it.Optional
support_organization_pbm_mgrIt makes up the second tier of the Problem Coordinator’s Support Organization data structure.Optional
assigned_support_companyThe company for the problem assignee’s support organization. It makes up the first tier of the problem assignee’s support organization data structure.Optional
assigned_support_organizationThe organization for the problem assignee’s support organization. It makes up the second tier of the problem assignee’s support organization data structure.Optional
assigned_groupThe group for the problem assignee’s support organization. It makes up the third tier of the problem assignee’s support organization data structure.Optional
investigation_justificationThe justification for the ticket creation.Optional
assigneeThe full name of the staff member to whom the ticket will be assigned to. It can be retrieved by using the 'bmc-itsm-user-list' command.Optional
assignee_pbm_mgrThe full name of the staff member to whom the ticket will be assign to as the problem coordinator. It can be retrieved by using the 'bmc-itsm-user-list' command.Optional
temporary_workaroundError workaround.Optional
additional_fieldsThe fields which are not present in the current argument list can be added here in the format "fieldname1=value;fieldname2=value". Possible fields: Assigned Group, Assignee or any other custom field.Optional

Context Output#

PathTypeDescription
BmcITSM.KnownError.RequestIDStringKnown Error unique Request ID.
BmcITSM.KnownError.DisplayIDStringKnownError Display ID.
BmcITSM.KnownError.CreateDateDateKnownError Create time in UTC.

Command example#

!bmc-itsm-known-error-create summary="New Error API" details="New Error API Details" target_resolution_date=" in 5 days" company="Calbro Services" resolution="error resolution" investigation_justification=look assignee="Bob Baxter" assigned_support_company="Calbro Services" assigned_support_organization="IT Support" assigned_group="Backoffice Support" impact="2-Significant/Large" status=Assigned urgency="2-High" view_access=Internal

Context Example#

{
"BmcITSM": {
"KnownError": {
"CreateDate": "2022-07-27T08:44:37",
"DisplayID": "PKE000000000303",
"RequestID": "PKE000000000303"
}
}
}

Human Readable Output#

Known Error ticket successfully Created#

Create DateDisplay IDRequest ID
2022-07-27T08:44:37PKE000000000303PKE000000000303

bmc-itsm-known-error-update#


Update Known Error ticket type.

Base Command#

bmc-itsm-known-error-update

Input#

Argument NameDescriptionRequired
ticket_request_idThe known error ticket request ID.Required
statusThe known error ticket status. Possible values are: Assigned, Scheduled For Correction, Assigned To Vendor, No Action Planned, Corrected, Closed, Cancelled.Optional
summaryThe known error ticket summary.Optional
detailsThe known error ticket detailed description.Optional
impactThe known error ticket impact. Possible values are: 1-Extensive/Widespread, 2-Significant/Large, 3-Moderate/Limited, 4-Minor/Localized.Optional
urgencyThe known error ticket urgency. Possible values are: 1-Critical, 2-High, 3-Medium, 4-Low.Optional
view_accessThe known error ticket internal access. Possible values are: Public, Internal.Optional
companyCompany associated with the Requester. By default is determined by the logged in user.Optional
target_resolution_dateKnown error resolution date. Future resolution date. For example, in 12 hours, in 7 days.Optional
resolutionTicket resolution.Optional
assigned_group_pbm_mgrIt makes up the third tier of the Problem Coordinator’s Support Organization data structure.Optional
support_company_pbm_mgrthe Company for the Problem Coordinator’s Support Organization. It makes up the first tier of it.Optional
support_organization_pbm_mgrIt makes up the second tier of the Problem Coordinator’s Support Organization data structure.Optional
assigned_support_companyThe company for the problem assignee’s support organization. It makes up the first tier of the problem assignee’s support organization data structure.Optional
assigned_support_organizationThe organization for the problem assignee’s support organization. It makes up the second tier of the problem assignee’s support organization data structure.Optional
assigned_groupThe group for the problem assignee’s support organization. It makes up the third tier of the problem assignee’s support organization data structure.Optional
temporary_workaroundError workaround.Optional
status_reasonThe reason for changing the status. Required when the status is provided. Possible values are: Duplicate, No Longer Applicable, Pending PIR, Funding Not Available, Pending Infrastructure Change, Pending Third Party Vendor.Optional
assigneeThe full name of the employee the ticket will be assigned to. It can be retrieved by using the bmc-itsm-user-list command.Optional
assignee_pbm_mgrThe full name of the employee the ticket will be assign to as the problem coordinator. It can be retrieved by using the bmc-itsm-user-list command.Optional
additional_fieldsThe fields which are not present in the current argument list can be added here in the format "fieldname1=value;fieldname2=value". Possible fields: Assigned Group, Assignee or any other custom field.Optional

Context Output#

There is no context output for this command.

Command example#

!bmc-itsm-known-error-update known_error_id=PKE000000000226 impact="2-Significant/Large" details="UPDATED KNOWN ERROR DETAILS" resolution="Updated resolution" temporary_workaround="Updated workaround" summary="Updated summary" status="Assigned To Vendor" status_reason="Pending PIR" target_resolution_date="In 20 days"

Human Readable Output#

Known Error: PKE000000000226 was successfully updated.

bmc-itsm-change-request-template-list#


Lists all change requests ticket templates. Useful for creating change request tickets. The records are retrieved by the query argument or by the filtering arguments. When using filtering arguments, each one defines a 'LIKE' operation and an 'AND' operator is used between them. To see the entire JSON then you can use the raw_response=true at the end of the command.

Base Command#

bmc-itsm-change-request-template-list

Input#

Argument NameDescriptionRequired
template_idsA comma-separated list of change request template IDs. Used as a filtering argument.Optional
queryThe query to search by. For example: Status = "Draft" AND Impact = "1-Extensive/Widespread". The query is used in addition to the existing arguments. See the BMC documentation for building search qualifications.Optional
limitThe maximum number of records to retrieve. Default is 50.Optional
page_sizeThe maximum number of records to retrieve per page.Optional
pageThe page number of the results to retrieve.Optional
descriptionThe change request ticket description. Used as a filtering argument.Optional

Context Output#

PathTypeDescription
BmcITSM.ChangeRequestTemplate.IdStringThe change request ticket template ID.
BmcITSM.ChangeRequestTemplate.DescriptionStringThe change request ticket template description.
BmcITSM.ChangeRequestTemplate.InstanceIDStringThe change request ticket template instance ID. Useful for creating change request tickets.

Command example#

!bmc-itsm-change-request-template-list limit=2

Context Example#

{
"BmcITSM": {
"ChangeRequestTemplate": [
{
"Description": "Add New Employee",
"Id": "CTP000000000002",
"InstanceID": "AG00123F73CF5EK3sTSQD73rAAa_QA"
},
{
"Description": "Configure new computer",
"Id": "CTP000000000003",
"InstanceID": "AG00123F73CF5EK3sTSQTb3rAAbfQA"
}
]
}
}

Human Readable Output#

List change request templates.#

Showing 2 records out of 13. |Id|Description|Instance ID| |---|---|---| | CTP000000000002 | Add New Employee | AG00123F73CF5EK3sTSQD73rAAa_QA | | CTP000000000003 | Configure new computer | AG00123F73CF5EK3sTSQTb3rAAbfQA |

bmc-itsm-incident-template-list#


Lists all incident requests ticket templates. Useful for create incident tickets. The records are retrieved by the query argument or by the filtering arguments. When using filtering arguments, each one defines a 'LIKE' operation and an 'AND' operator is used between them. To see the entire JSON then you can use the raw_response=true at the end of the command.

Base Command#

bmc-itsm-incident-template-list

Input#

Argument NameDescriptionRequired
queryThe query to search by. For example: Status = "Draft" AND Impact = "1-Extensive/Widespread". The query is used in addition to the existing arguments. See the BMC documentation for building search qualifications.Optional
limitThe maximum number of records to retrieve. Default is 50.Optional
page_sizeThe maximum number of records to retrieve per page.Optional
pageThe page number of the results to retrieve.Optional
descriptionThe incident ticket template description. Used as a filtering argument.Optional
template_idsA comma-separated list of incident template IDs. Used as a filtering argument.Optional

Context Output#

PathTypeDescription
BmcITSM.IncidentTemplate.IdStringThe incident ticket template ID.
BmcITSM.IncidentTemplate.DescriptionStringThe incident ticket template description.
BmcITSM.IncidentTemplate.InstanceIDStringThe incident ticket template ID. Useful for creating change request tickets.

Command example#

!bmc-itsm-incident-template-list limit=2

Context Example#

{
"BmcITSM": {
"IncidentTemplate": [
{
"Description": "Email Password Reset",
"Id": "HTP000000000001",
"InstanceID": "AG00123F73CF5EKnsTSQSrvrAAYvQA"
},
{
"Description": "Email Service is Down",
"Id": "HTP000000000002",
"InstanceID": "AG00123F73CF5EKnsTSQ5rvrAAZfQA"
}
]
}
}

Human Readable Output#

List incident templates.#

Showing 2 records out of 2. |Id|Description|Instance ID| |---|---|---| | HTP000000000001 | Email Password Reset | AG00123F73CF5EKnsTSQSrvrAAYvQA | | HTP000000000002 | Email Service is Down | AG00123F73CF5EKnsTSQ5rvrAAZfQA |

bmc-itsm-task-template-list#


Lists all task ticket templates. Useful for creating task tickets. The records are retrieved by the query argument or by the filtering arguments. When using filtering arguments, each one defines a 'LIKE' operation and an 'AND' operator is used between them. To see the entire JSON then you can use the raw_response=true at the end of the command.

Base Command#

bmc-itsm-task-template-list

Input#

Argument NameDescriptionRequired
queryThe query to search by. For example: Status = "Draft" AND Impact = "1-Extensive/Widespread". The query is used in addition to the existing arguments. See the BMC documentation for building search qualifications.Optional
limitThe maximum number of records to retrieve. Default is 50.Optional
page_sizeThe maximum number of records to retrieve per page.Optional
pageThe page number of the results to retrieve.Optional
template_idsA comma-separated list of task template IDs. Used as a filtering argument.Optional
task_nameThe task ticket template name. Used as a filtering argument.Optional

Context Output#

PathTypeDescription
BmcITSM.TaskTemplate.IdStringThe task ticket template ID.
BmcITSM.TaskTemplate.TaskNameStringThe task template name.
BmcITSM.TaskTemplate.InstanceIDStringThe task ticket template ID. Useful for creating change request tickets.

Command example#

!bmc-itsm-task-template-list limit=2

Context Example#

{
"BmcITSM": {
"TaskTemplate": [
{
"Id": "14",
"InstanceID": "TM00123F73CF5EK3sTSQ877rAAhfQA",
"TaskName": "Backup System"
},
{
"Id": "13",
"InstanceID": "TM001143D417CBD_bDQwojSFAA9qQA",
"TaskName": "Check Approval automatically"
}
]
}
}

Human Readable Output#

List task templates.#

Showing 2 records out of 25. |Id|Task Name|Instance ID| |---|---|---| | 14 | Backup System | TM00123F73CF5EK3sTSQ877rAAhfQA | | 13 | Check Approval automatically | TM001143D417CBD_bDQwojSFAA9qQA |

get-mapping-fields#


Returns the list of fields for an incident type.

Base Command#

get-mapping-fields

Input#

Argument NameDescriptionRequired

Context Output#

There is no context output for this command.

get-remote-data#


Gets remote data from a remote incident. This method does not update the current incident, and should be used for debugging purposes.

Base Command#

get-remote-data

Input#

Argument NameDescriptionRequired
idThe ticket ID.Required
lastUpdateRetrieves entries that were created after lastUpdate.Required

Context Output#

There is no context output for this command.

get-modified-remote-data#


Gets the list of incidents that were modified since the last update time. Note that this method is here for debugging purposes. The get-modified-remote-data command is used as part of a Mirroring feature, which is available in Cortex XSOAR from version 6.1.

Base Command#

get-modified-remote-data

Input#

Argument NameDescriptionRequired
lastUpdateA date string in local time representing the last time the incident was updated. The incident is only returned if it was modified after the last update time.Optional

Context Output#

There is no context output for this command.

bmc-itsm-support-group-list#


Lists all support groups. Useful for getting possible (Company, Support Organization, Support Group) triplets.

Base Command#

bmc-itsm-support-group-list

Input#

Argument NameDescriptionRequired
limitThe maximum number of records to retrieve. Default is 50.Optional
page_sizeThe maximum number of records to retrieve per page.Optional
pageThe page number of the results to retrieve.Optional
companyCompany name. Used as a filtering argument.Optional
support_organizationSupport organization name. Used as a filtering argument.Optional
support_groupSupport group name. Used as a filtering argument.Optional

Context Output#

PathTypeDescription
BmcITSM.SupportGroup.SupportGroupIDStringThe support group ID.
BmcITSM.SupportGroup.CompanyStringThe support company.
BmcITSM.SupportGroup.SupportOrganizationStringThe support organization.
BmcITSM.SupportGroup.SupportGroupNameStringThe support group.

Command example#

!bmc-itsm-support-group-list limit=2

Context Example#

{
"BmcITSM": {
"SupportGroup": [
{
"Company": "Apex Global",
"SupportGroupID": "APX990000000029",
"SupportGroupName": "Apex Global - Facilities",
"SupportOrganization": "Facilities Support"
},
{
"Company": "Calbro Services",
"SupportGroupID": "SGP000000000110",
"SupportGroupName": "Application Development / Deployment",
"SupportOrganization": "Application Support"
}
]
}
}

Human Readable Output#

List support groups.#

Showing 2 records out of 15. |Support Group ID|Company|Support Organization|Support Group Name| |---|---|---|---| | APX990000000029 | Apex Global | Facilities Support | Apex Global - Facilities | | SGP000000000110 | Calbro Services | Application Support | Application Development / Deployment |

bmc-itsm-work-order-template-list#


Lists all work order templates. Useful for creating work orders. The records are retrieved by the query argument or by the filtering arguments. When using filtering arguments, each one defines a 'LIKE' operation and an 'AND' operator is used between them. To see the entire JSON, you can use the raw_response=true at the end of the command.

Base Command#

bmc-itsm-work-order-template-list

Input#

Argument NameDescriptionRequired
queryThe query to search by. For example, query="Company like \"BMCOpsMonitoring\"". The query is used in addition to the existing arguments. See the BMC documentation for building search qualifications.Optional
limitThe maximum number of records to retrieve. Default is 50.Optional
page_sizeThe maximum number of records to retrieve per page.Optional
pageThe page number of the results to retrieve.Optional
template_idsA comma-separated list of work order template GUIDs. Used as a filtering argument.Optional
template_nameThe work order template name. Used as a filtering argument.Optional

Context Output#

PathTypeDescription
BmcITSM.WorkOrderTemplate.IdStringThe work order template ID.
BmcITSM.WorkOrderTemplate.NameStringThe work order template name.
BmcITSM.WorkOrderTemplate.GUIDStringThe work order template GUID.

Command example#

!bmc-itsm-work-order-template-list limit=2

Context Example#

{
"BmcITSM": {
"WorkOrderTemplate": [
{
"GUID": "IDGCWH5RDMNSBARVRM5ERVRM5EKP11",
"Id": "000000000000002",
"Name": "Share Folder Access"
},
{
"GUID": "IDGCWH5RDMNSBARVRNNGRVRNNGKY0X",
"Id": "000000000000003",
"Name": "New Share Folder Access"
}
]
}
}

Human Readable Output#

List work order templates.#

Showing 2 records out of 9. |Id|Name|GUID| |---|---|---| | 000000000000002 | Share Folder Access | IDGCWH5RDMNSBARVRM5ERVRM5EKP11 | | 000000000000003 | New Share Folder Access | IDGCWH5RDMNSBARVRNNGRVRNNGKY0X |

bmc-itsm-work-order-create#


Creates a new work order ticket.

Base Command#

bmc-itsm-work-order-create

Input#

Argument NameDescriptionRequired
template_guidThe instance GUID of the template to use. The GUID can be retrieved by executing the bmc-itsm-work-order-template-list command.Optional
first_nameRequester first name.Optional
last_nameRequester last name.Optional
customer_first_nameCustomer first name.Required
customer_last_nameCustomer last name.Required
customer_companyCustomer company.Required
customer_person_idCustomer person ID. Use it when customer first and last name pair is not unique.Optional
summaryThe work order summary.Required
detailed_descriptionThe work order ticket detailed description.Required
statusThe work order status. Possible values are: Assigned, Pending, Waiting Approval, Planning, In Progress, Completed, Rejected, Cancelled, Closed.Required
additional_fieldsThe fields which are not present in the current argument list can be added here in the format "fieldname1=value;fieldname2=value". Example: additional_fields="Support Company=Calbro Services;Support Organization=IT Support;Support Group Name=Service Desk;Request Assignee=Scully Agent".Optional
priorityThe work order ticket priority. Possible values are: Critical, High, Medium, Low.Required
work_order_typeThe work order ticket type. Possible values are: General, Project.Optional
location_companyThe company associated with the task process.Required
scedulded_start_dateThe work order ticket scheduled future start date. For example, in 12 hours, in 7 days.Optional
scedulded_end_dateThe work order ticket scheduled future end date. For example, in 12 hours, in 7 days.Optional

Context Output#

PathTypeDescription
BmcITSM.WorkOrder.RequestIDStringThe work order ticket unique Request ID.
BmcITSM.WorkOrder.DisplayIDStringThe work order ticket unique Display ID.
BmcITSM.WorkOrder.CreateDateDateThe work order ticket creation date time in UTC.

Command example#

!bmc-itsm-work-order-create customer_company="Calbro Services" customer_first_name="Scully" customer_last_name="Agent" detailed_description="Easy peasy work order" location_company="Calbro Services" priority=Low status=Pending summary="Easy peasy work order. No, really." customer_person_id=PPL000000000607 additional_fields="Support Company=Calbro Services;Support Organization=IT Support;Support Group Name=Service Desk;Request Assignee=Scully Agent"

Context Example#

{
"BmcITSM": {
"WorkOrder": {
"CreateDate": "2024-02-07T08:08:23",
"DisplayID": "WO0000000001002",
"RequestID": "WO0000000000702"
}
}
}

Human Readable Output#

Work order ticket successfully created.#

Create DateDisplay IDRequest ID
2024-02-07T08:08:23WO0000000001002WO0000000000702

bmc-itsm-work-order-update#


Updates the work order ticket.

Base Command#

bmc-itsm-work-order-update

Input#

Argument NameDescriptionRequired
request_idThe ID of the work order ticket to update.Required
summaryThe work order ticket summary.Optional
detailed_descriptionThe work order ticket detailed description.Optional
priorityThe work order ticket priority. Possible values are: Critical, High, Medium, Low.Optional
statusThe work order ticket status. Possible values are: Assigned, Pending, Waiting Approval, Planning, In Progress, Completed, Rejected, Cancelled, Closed.Optional
status_reasonThe reason for changing the ticket status. Possible values are: Initial Status, Awaiting Request Assignee, Client Hold, Client Additional Information Requested, Client Action Required, Support Contact Hold, Local Site Action Required, Purchase Order Approval, Supplier Delivery, Third Party Vendor Action Required, Infrastructure Change, Work not started, Successful, Successful with Issues, Cancelled by Requester, Cancelled by Support, Customer Close, System Close, System Close with Issues.Optional
companyThe company associated with the requester. By default it is determined by the logged in user.Optional
location_companyThe company associated with the work order process.Optional
assigneeThe full name of the employee the work order is assigned to. It can be retrieved by using the bmc-itsm-user-list command.Optional
support_organizationThe organization for the problem assignee's support organization. It makes up the second tier of the problem assignee's support organization data structure. The arguments support_organization, support_group should be provided together. It can be retrieved by using the bmc-itsm-support-group-list command.Optional
support_groupThe group for the problem assignee's support group. It makes up the third tier of the problem assignee's support organization data structure. The arguments support_organization, support_group should be provided together. It can be retrieved by using the bmc-itsm-support-group-list command.Optional
work_order_typeThe work order ticket type. Possible values are: General, Project.Optional
additional_fieldsThe fields which are not present in the current argument list can be added here in the format "fieldname1=value;fieldname2=value". Example: additional_fields="Support Company=Calbro Services;Support Organization=IT Support;Support Group Name=Service Desk;Request Assignee=Scully Agent".Optional
scedulded_start_dateThe work order ticket scheduled future start date. For example, in 12 hours, in 7 days.Optional
scedulded_end_dateThe work order ticket scheduled future end date. For example, in 12 hours, in 7 days.Optional

Context Output#

There is no context output for this command.

Command example#

!bmc-itsm-work-order-update request_id=WO0000000000701 summary="Updated summary" status="In Progress" support_organization="IT Support" support_group="Service Desk"

Human Readable Output#

Work Order: WO0000000000701 was successfully updated.

Incident Mirroring#

You can enable incident mirroring between Cortex XSOAR incidents and BMC Helix ITSM corresponding events (available from Cortex XSOAR version 6.0.0). To set up the mirroring:

  1. Enable Fetching incidents in your instance configuration.

  2. In the Mirroring Direction integration parameter, select in which direction the incidents should be mirrored:

    OptionDescription
    NoneTurns off incident mirroring.
    IncomingAny changes in BMC Helix ITSM events (mirroring incoming fields) will be reflected in Cortex XSOAR incidents.
    OutgoingAny changes in Cortex XSOAR incidents will be reflected in BMC Helix ITSM events (outgoing mirrored fields).
    Incoming And OutgoingChanges in Cortex XSOAR incidents and BMC Helix ITSM events will be reflected in both directions.
  3. Optional: Check the Close Mirrored XSOAR Incident integration parameter to close the Cortex XSOAR incident when the corresponding event is closed in BMC Helix ITSM.

Newly fetched incidents will be mirrored in the chosen direction. However, this selection does not affect existing incidents. Important Note: To ensure the mirroring works as expected, mappers are required, both for incoming and outgoing, to map the expected fields in Cortex XSOAR and BMC Helix ITSM.