Skip to main content

Micro Focus Service Manager

This Integration is part of the Micro Focus Service Manager Pack.#

Service Manager By Micro Focus (Formerly HPE Software).

Configure Micro Focus Service Manager on Cortex XSOAR#

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

  2. Search for Micro Focus Service Manager.

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

    ParameterRequired
    Server URL (e.g. https://192.168.0.1:13080)True
    UsernameTrue
    PasswordTrue
    Trust any certificate (not secure)False
    Use system proxy settingsFalse
  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.

hpsm-update-incident#


Updates existing incident (beta).

Base Command#

hpsm-update-incident

Input#

Argument NameDescriptionRequired
incidentIdThe ID of the incident. For example: "IM10013".Required
titleThe title of the incident.Optional
descriptionThe description of the incident.Optional
serviceThe service. For example: "CI1001060", "CI1001030".Optional
impactThe impact. Default is 4. Should be a number like 3 or 4.Optional
urgencyThe urgency. Default is 4. Should be a number like 3 or 4.Optional
alertStatusThe alert status. For example: "SLA BREACH".Optional
areaThe area. For example: "performance", "failure", "hardware", "access". .Optional
assignmentGroupThe assignment group. For example: "Office Supplies (North America)".Optional
affectedCIThe affected CI. For example: "CI1000783".Optional
categoryCategory of the incident. For example: "incident", "complaint".Optional
companyThe company. For example: "advantage".Optional
phaseThe phase. For example: "Categorization".Optional
statusThe status. For example: "Categorize".Optional
subareaThe sub-area. For example: system or application hangs, function or feature not working, error message, job failed, hardware failure, etc.Optional
customFieldsCustom fields in JSON format. For example: {"businessUnit":"5"}. Field name is case-sensitive.Optional

Context Output#

PathTypeDescription
Ticket.IDunknownThe ID of the ticket.
Ticket.CreatorunknownThe name of the user who created/opened the ticket.
Ticket.AssigneeunknownTo whom the ticket is assigned.
Ticket.StateunknownThe state of the ticket (open, closed, on hold).
HPSM.Incidents.IncidentIDunknownThe ID of the incident.
HPSM.Incidents.ServiceunknownService/device number (For example: CI1001030).
HPSM.Incidents.AreaunknownIncident area.
HPSM.Incidents.AssigneeunknownIncident assignee.
HPSM.Incidents.AssignmentGroupunknownIncident assignment group.
HPSM.Incidents.CategoryunknownIncident category.
HPSM.Incidents.ClosedByunknownThe user who closed the incident.
HPSM.Incidents.ClosedTimeunknownIncident close time.
HPSM.Incidents.ClosureCodeunknownIncident closure code.
HPSM.Incidents.CompanyunknownIncident company.
HPSM.Incidents.ContactunknownIncident contact details.
HPSM.Incidents.DescriptionunknownIncident description.
HPSM.Incidents.ImpactunknownIncident impact.
HPSM.Incidents.JournalUpdatesunknownIncident journal updates.
HPSM.Incidents.OpenTimeunknownIncident open time.
HPSM.Incidents.OpenedByunknownThe user who opened the incident.
HPSM.Incidents.PhaseunknownIncident phase.
HPSM.Incidents.SolutionunknownIncident solution.
HPSM.Incidents.StatusunknownIncident status.
HPSM.Incidents.SubareaunknownIncident sub-area.
HPSM.Incidents.TitleunknownIncident title.
HPSM.Incidents.UpdatedByunknownThe last user who updated the incident.
HPSM.Incidents.UpdatedTimeunknownIncident update time.
HPSM.Incidents.UrgencyunknownIncident urgency.

hpsm-create-incident#


Creates a new incident.

Base Command#

hpsm-create-incident

Input#

Argument NameDescriptionRequired
titleThe title of the incident.Required
descriptionThe description of the incident.Required
serviceThe service. For example: "CI1001060", "CI1001030".Required
impactThe impact. Default is 4. Should be a number like 3 or 4.Optional
urgencyThe impact. Default is 4. Should be a number like 3 or 4.Optional
alertStatusThe alert status. For example: "SLA BREACH".Optional
areaThe area. For example: "performance", "failure", "hardware", "access".Optional
assignmentGroupThe assignment group. For example: "Office Supplies (North America)".Optional
affectedCIThe affected CI. For example: "CI1000783".Optional
categoryCategory of the incident. For example: "incident", "complaint".Required
companyThe company. For example: "advantage".Optional
phaseThe phase. For example: "Categorization".Optional
statusThe status. For example: "Categorize".Optional
subareaThe sub-area. For example: system or application hangs, function or feature not working, error message, job failed, hardware failure, etc.Optional
customFieldsCustom fields in JSON format. For example: {"businessUnit":"5"}. Field name is case-sensitive.Optional

Context Output#

PathTypeDescription
Ticket.IDunknownThe ID of the ticket.
Ticket.CreatorunknownThe user who created/opened the ticket.
Ticket.AssigneeunknownTo whom the ticket is assigned.
Ticket.StateunknownThe state of the ticket (open, closed, on hold).
HPSM.Incidents.IncidentIDunknownThe ID of the incident.
HPSM.Incidents.ServiceunknownService/device number.
HPSM.Incidents.AreaunknownIncident area.
HPSM.Incidents.AssigneeunknownIncident assignee.
HPSM.Incidents.AssignmentGroupunknownIncident assignment group.
HPSM.Incidents.CategoryunknownIncident category.
HPSM.Incidents.ClosedByunknownThe user who closed the incident.
HPSM.Incidents.ClosedTimeunknownIncident close time.
HPSM.Incidents.ClosureCodeunknownIncident closure code.
HPSM.Incidents.CompanyunknownIncident company.
HPSM.Incidents.ContactunknownIncident contact details.
HPSM.Incidents.DescriptionunknownIncident description.
HPSM.Incidents.ImpactunknownIncident impact.
HPSM.Incidents.JournalUpdatesunknownIncident journal updates.
HPSM.Incidents.OpenTimeunknownIncident open time.
HPSM.Incidents.OpenedByunknownThe user who opened the incident.
HPSM.Incidents.PhaseunknownIncident phase.
HPSM.Incidents.SolutionunknownIncident solution.
HPSM.Incidents.StatusunknownIncident status.
HPSM.Incidents.SubareaunknownIncident sub-area.
HPSM.Incidents.TitleunknownIncident title.
HPSM.Incidents.UpdatedByunknownThe last user who updated the incident.
HPSM.Incidents.UpdatedTimeunknownIncident update time.
HPSM.Incidents.UrgencyunknownIncident urgency.

hpsm-list-incidents#


Returns all incidents.

Base Command#

hpsm-list-incidents

Input#

Argument NameDescriptionRequired
queryThe query by which to limit the returned list of incidents. For example: field1=value1&field2=value2. For more information, see https://docs.microfocus.com/SM/9.41/Codeless/Content/Resources/PDF_PD/HP_Service_Manager_Web_Services_codeless.pdf.Optional

Context Output#

PathTypeDescription
HPSM.IncidentIDsunknownAn array of incident IDs.

hpsm-get-incident-by-id#


Returns a single incident by ID. If no incident exists with the specified ID, an error will be returned.

Base Command#

hpsm-get-incident-by-id

Input#

Argument NameDescriptionRequired
incidentIdThe ID of an incident. For exampleJ: "IM10013".Required

Context Output#

PathTypeDescription
Ticket.IDunknownThe ID of the ticket.
Ticket.CreatorunknownThe user who created/opened the ticket.
Ticket.AssigneeunknownTo whom the ticket is assigned.
Ticket.StateunknownThe state of the ticket (open, closed, on hold).
HPSM.Incidents.IncidentIDunknownThe ID of the incident.
HPSM.Incidents.ServiceunknownService/device number.
HPSM.Incidents.AreaunknownIncident area.
HPSM.Incidents.AssigneeunknownIncident assignee.
HPSM.Incidents.AssignmentGroupunknownIncident assignment group.
HPSM.Incidents.CategoryunknownIncident category.
HPSM.Incidents.ClosedByunknownThe user who closed the incident.
HPSM.Incidents.ClosedTimeunknownIncident close time.
HPSM.Incidents.ClosureCodeunknownIncident closure code.
HPSM.Incidents.CompanyunknownIncident company.
HPSM.Incidents.ContactunknownIncident contact details.
HPSM.Incidents.DescriptionunknownIncident description.
HPSM.Incidents.ImpactunknownIncident impact.
HPSM.Incidents.JournalUpdatesunknownIncident journal updates.
HPSM.Incidents.OpenTimeunknownIncident open time.
HPSM.Incidents.OpenedByunknownThe user who opened the incident.
HPSM.Incidents.PhaseunknownIncident phase.
HPSM.Incidents.SolutionunknownIncident solution.
HPSM.Incidents.StatusunknownIncident status.
HPSM.Incidents.SubareaunknownIncident sub-area.
HPSM.Incidents.TitleunknownIncident title.
HPSM.Incidents.UpdatedByunknownThe last user who updated the incident.
HPSM.Incidents.UpdatedTimeunknownIncident update time.
HPSM.Incidents.UrgencyunknownIncident urgency.

hpsm-create-resource#


Updates the existing resource (beta).

Base Command#

hpsm-create-resource

Input#

Argument NameDescriptionRequired
titleThe title of the resource.Required
descriptionThe description of the resource.Required
serviceThe service. For example: "CI1001060", "CI1001030".Required
impactThe impact. Default is 4. Should be a number like 3 or 4.Optional
urgencyThe urgency. Default is 4. Should be a number like 3 or 4.Optional
alertStatusThe alert status. For example: "SLA BREACH".Optional
areaThe area. For example: performance, failure, hardware, access".Optional
assignmentGroupThe assignment group. For example: "Office Supplies (North America)".Optional
affectedCIThe affected CI. For example: "CI1000783".Optional
categoryCategory of resource. For example: "resource", "complaint".Required
companyThe company. For example: "advantage".Optional
phaseThe phase. For example: "Categorization".Optional
statusThe status. For example: "Categorize".Optional
subareaThe sub-area. For example: system or application hangs, function or feature not working, error message, job failed, hardware failure, etc.Optional
customFieldsCustom fields in JSON format. For example: {"businessUnit":"5"}. Field name is case-sensitive.Optional
resourceNameThe resource name (API URI) that will be used. For example: "incidents".Required
resourceKeyThe resource key that will be used. For example: "InteractionID".Required

Context Output#

PathTypeDescription
Ticket.IDunknownThe ID of the ticket.
Ticket.CreatorunknownThe user who created/opened the ticket.
Ticket.AssigneeunknownTo whom the ticket is assigned.
Ticket.StateunknownThe state of the ticket (open, closed, on hold).
HPSM.Resources.ResourceIDunknownThe ID of the resource.
HPSM.Resources.ServiceunknownService/device number.
HPSM.Resources.AreaunknownResource area.
HPSM.Resources.AssigneeunknownResource assignee.
HPSM.Resources.AssignmentGroupunknownResource assignment group.
HPSM.Resources.CategoryunknownResource category.
HPSM.Resources.ClosedByunknownThe user who closed the resource.
HPSM.Resources.ClosedTimeunknownResource close time.
HPSM.Resources.ClosureCodeunknownResource closure code.
HPSM.Resources.CompanyunknownResource company.
HPSM.Resources.ContactunknownResource contact details.
HPSM.Resources.DescriptionunknownResource description.
HPSM.Resources.ImpactunknownResource impact.
HPSM.Resources.JournalUpdatesunknownResource journal updates.
HPSM.Resources.OpenTimeunknownResource open time.
HPSM.Resources.OpenedByunknownThe user who opened the resource.
HPSM.Resources.PhaseunknownResource phase.
HPSM.Resources.SolutionunknownResource solution.
HPSM.Resources.StatusunknownResource status.
HPSM.Resources.SubareaunknownResource sub-area.
HPSM.Resources.TitleunknownResource title.
HPSM.Resources.UpdatedByunknownThe last user who updated the resource.
HPSM.Resources.UpdatedTimeunknownResource update time.
HPSM.Resources.UrgencyunknownResource urgency.

hpsm-update-resource#


Creates a new resource.

Base Command#

hpsm-update-resource

Input#

Argument NameDescriptionRequired
titleThe title of the resource.Required
descriptionThe description of the resource.Required
serviceThe service. For example: "CI1001060", "CI1001030".Required
impactThe impact. Default is 4. Should be a number like 3 or 4.Optional
urgencyThe urgency. Default is 4. Should be a number like 3 or 4.Optional
alertStatusThe alert status. For example: "SLA BREACH".Optional
areaThe area. For example: "performance", "failure", "hardware", "access".Optional
assignmentGroupThe assignment group. For example: "Office Supplies (North America)".Optional
affectedCIThe affected CI. For example: "CI1000783".Optional
categoryCategory of resource. For example: "resource", "complaint".Required
companyThe company. For example: "advantage".Optional
phaseThe phase. For example: "Categorization".Optional
statusThe status. For example: "Categorize".Optional
subareaThe sub-area. For example: system or application hangs, function or feature not working, error message, job failed, hardware failure, etc.Optional
customFieldsCustom fields in JSON format. For example: {"businessUnit":"5"}. Field name is case-sensitive.Optional
resourceNameThe resource name (API URI) that will be used. For example: "incidents".Required
resourceKeyThe resource key that will be used. For example: "InteractionID".Required

Context Output#

PathTypeDescription
Ticket.IDunknownThe ID of the ticket.
Ticket.CreatorunknownThe user who created/opened the ticket.
Ticket.AssigneeunknownTo whom the ticket is assigned.
Ticket.StateunknownThe state of the ticket (open, closed, on hold).
HPSM.Resources.ResourceIDunknownThe ID of the resource.
HPSM.Resources.ServiceunknownService/device number.
HPSM.Resources.AreaunknownResource area.
HPSM.Resources.AssigneeunknownResource assignee.
HPSM.Resources.AssignmentGroupunknownResource assignment group.
HPSM.Resources.CategoryunknownResource category.
HPSM.Resources.ClosedByunknownThe user who closed the resource.
HPSM.Resources.ClosedTimeunknownResource close time.
HPSM.Resources.ClosureCodeunknownResource closure code.
HPSM.Resources.CompanyunknownResource company.
HPSM.Resources.ContactunknownResource contact details.
HPSM.Resources.DescriptionunknownResource description.
HPSM.Resources.ImpactunknownResource impact.
HPSM.Resources.JournalUpdatesunknownResource journal updates.
HPSM.Resources.OpenTimeunknownResource open time.
HPSM.Resources.OpenedByunknownThe user who opened the resource.
HPSM.Resources.PhaseunknownResource phase.
HPSM.Resources.SolutionunknownResource solution.
HPSM.Resources.StatusunknownResource status.
HPSM.Resources.SubareaunknownResource sub-area.
HPSM.Resources.TitleunknownResource title.
HPSM.Resources.UpdatedByunknownThe last user who updated the resource.
HPSM.Resources.UpdatedTimeunknownResource update time.
HPSM.Resources.UrgencyunknownResource urgency.

hpsm-list-resources#


Returns all resources (beta).

Base Command#

hpsm-list-resources

Input#

Argument NameDescriptionRequired
queryThe query by which to limit the returned list of incidents. For example: field1=value1&field2=value2. For more information, see https://docs.microfocus.com/SM/9.41/Codeless/Content/Resources/PDF_PD/HP_Service_Manager_Web_Services_codeless.pdf.Optional
resourceNameThe resource name (API URI) that will be used. For example: "incidents".Required

Context Output#

PathTypeDescription
HPSM.ResourceIDsunknownAn array of resource IDs.

hpsm-get-resource-by-id#


Returns a single resource by ID. If no resource exists with the specified ID, an error will be returned (beta).

Base Command#

hpsm-get-resource-by-id

Input#

Argument NameDescriptionRequired
resourceIdThe ID of the resource. For example: "IM10013".Required
resourceNameThe resource name (API URI) that will be used. For example: "incidents".Required

Context Output#

PathTypeDescription
Ticket.IDunknownThe ID of the ticket.
Ticket.CreatorunknownThe user who created/opened the ticket.
Ticket.AssigneeunknownTo whom the ticket is assigned.
Ticket.StateunknownThe state of the ticket (open, closed, on hold).
HPSM.Resources.ResourceIDunknownThe ID of the resource.
HPSM.Resources.ServiceunknownService/device number.
HPSM.Resources.AreaunknownResource area.
HPSM.Resources.AssigneeunknownResource assignee.
HPSM.Resources.AssignmentGroupunknownResource assignment group.
HPSM.Resources.CategoryunknownResource category.
HPSM.Resources.ClosedByunknownThe user who closed the resource.
HPSM.Resources.ClosedTimeunknownResource close time.
HPSM.Resources.ClosureCodeunknownResource closure code.
HPSM.Resources.CompanyunknownResource company.
HPSM.Resources.ContactunknownResource contact details.
HPSM.Resources.DescriptionunknownResource description.
HPSM.Resources.ImpactunknownResource impact.
HPSM.Resources.JournalUpdatesunknownResource journal updates.
HPSM.Resources.OpenTimeunknownResource open time.
HPSM.Resources.OpenedByunknownThe user who opened the resource.
HPSM.Resources.PhaseunknownResource phase.
HPSM.Resources.SolutionunknownResource solution.
HPSM.Resources.StatusunknownResource status.
HPSM.Resources.SubareaunknownResource sub-area.
HPSM.Resources.TitleunknownResource title.
HPSM.Resources.UpdatedByunknownThe last user who updated the resource.
HPSM.Resources.UpdatedTimeunknownResource update time.
HPSM.Resources.UrgencyunknownResource urgency.

hpsm-list-devices#


Returns a list of devices, filtered according to query.

Base Command#

hpsm-list-devices

Input#

Argument NameDescriptionRequired
queryThe query by which to limit the returned list of incidents. For example: field1=value1&field2=value2. For more information, see https://docs.microfocus.com/SM/9.41/Codeless/Content/Resources/PDF_PD/HP_Service_Manager_Web_Services_codeless.pdf.Optional

Context Output#

PathTypeDescription
HPSM.DeviceIDsunknownThe IDs (configuration items) of the devices.

hpsm-get-device#


Find and return a device by ID.

Base Command#

hpsm-get-device

Input#

Argument NameDescriptionRequired
configurationItemID of the configuration item of the device. For example: "CI1000011".Required

Context Output#

PathTypeDescription
HPSM.Devices.AssignmentGroupunknownDevice assignment group.
HPSM.Devices.CompanyunknownDevice company.
HPSM.Devices.ConfigurationItemunknownDevice configuration item.
HPSM.Devices.ConfigurationItemSubTypeunknownDevice configurationItem sub-type.
HPSM.Devices.ConfigurationItemTypeunknownDevice configuration item type.
HPSM.Devices.DepartmentunknownDevice department.
HPSM.Devices.DisplayNameunknownDevice display name.
HPSM.Devices.LocationunknownDevice location.
HPSM.Devices.LocationCodeunknownDevice location code.
HPSM.Devices.ModelunknownDevice model.
HPSM.Devices.PartNumberunknownDevice part number.
HPSM.Devices.StatusunknownDevice status.
HPSM.Devices.UpdatedByunknownThe last user who updated the device.