Service Manager Authoring Tool workflow activity reference

This article provides guidance for information technology (IT) developers so that they can create custom Windows Workflow Foundation (WF) activities that IT pros can use to build WF workflows that are specific to their IT processes. Custom WF activities extend the Activity Library—the activities that are distributed with the Service Manager Authoring Tool. The Workflow Activity Reference section of this document provides details of the default WF activities in the Activity Library. This information is intended to help developers (or IT pros acting as developers) create custom WF activities, as needed.

For information about how to use WF activities and WF workflows with Service Manager, see Automating IT Processes with Workflows.

Active Directory activities

Use Active Directory Domain Services (AD DS) activities to make Active Directory functions part of your workflow in Service Manager.

The Service Manager Authoring Tool provides two default Service Manager activities in the Active Directory Activities group in the Activities Toolbox pane. The sections in this article describe these activities.

Add AD DS Computer to a Group activity

This activity adds a computer to a security group in Active Directory Domain Services (AD DS) in Service Manager. The computer and the group must belong to the same domain, and all the containers in the domain are searched.

Design time prerequisites Run time prerequisites
None When you use this activity, ensure that the Service Manager Workflow account has sufficient permissions to modify security groups in AD DS.

Properties

The Add AD DS Computer to Group activity uses the input properties that are described in the following table.

Display name Internal name Type Required Description
Computer Domain ComputerDomain String Yes The fully qualified DNS domain name where the computer is located (for example, contoso.com).
Computer Name FullyQualifiedComputerName String Yes The name of the computer.
Group Name FullyQualifiedGroupName String Yes The name of the Active Directory Domain Services group.

The Add AD DS Computer to Group activity generates the output that is described in the following table.

Display name Internal name Type Description
Output Output Boolean The result of the operation: True if the addition succeeded; False if it failed.
Errors and exceptions Remarks Example
None None None

Add AD DS User to Group activity

This activity adds a user to a security group in Active Directory Domain Services (AD DS) in Service Manager. The user and the group must belong to the same domain, and all the containers in the domain are searched.

Design time prerequisites Run time prerequisites
None When you use this activity, ensure that the Service Manager Workflow account has sufficient permissions to modify security groups in AD DS.

Properties

The Add AD DS User to Group activity uses the input properties that are listed in the following table.

Display name Internal name Type Required Description
User Domain UserDomain String Yes The fully qualified domain name (FQDN) of the user.
User Name UserName String Yes The sign-in name of the user.
Group Name FullyQualifiedGroupName String Yes The FQDN of the group.

The Add AD DS User to Group activity generates the output that is described in the following table.

Display Name Internal Name Type Description
Output Output Boolean The result of the operation: True if the addition succeeded, False if it failed.
Errors and exceptions Remarks Example
None None None

Control Flow activities

Use control flow activities to provide structure—branches, loops, or timer delays—for your workflow in Service Manager.

The Authoring Tool provides four default control flow activities in the Control Flow group in the Activities Toolbox pane.

Delay activity

This activity introduces a delay between activities in a workflow in Service Manager. The Delay activity is derived from the Microsoft .NET Framework DelayActivity class.

Design time prerequisites Run time prerequisites
None None

Properties

The Delay activity uses the input properties that are listed in the following table.

Display name Internal name Type Required Description
Initialize TimeoutDuration InitializeTimeoutDuration Internal Specifies a handler to initialize the TimeoutDuration property.
TimeoutDuration TimeoutDuration Timespan Yes Duration of the delay.

The Delay activity doesn't produce an output property.

Errors and exceptions Remarks Example
None For more information about this activity, see DelayActivity Class in the .NET Framework Class Library. None

For Each Loop activity

The For Each Loop activity takes as an input an array (collection) of objects and repeats the set of activities within the loop for each object in the collection. For example, if the input collection has five objects, the loop iterates five times. If the collection is empty, the loop doesn't iterate. There's no upper limit to the number of objects in the collection. The For Each Loop activity always runs on the computer on which the workflow runs.

The For Each Loop activity is a composite activity with two containers for activities:

  • Input Container: This activity sets up the loop and defines the input collection. You can use the Get Incident or the Get Virtual Machine activity in this role.

  • Loop Container: Named ForEachChildActivity, this activity contains the loop activities. Most Windows Workflow Foundation (WF) activities that you place in this container have two additional properties: Current Item and Property to Bind. For each activity within the loop container, set these properties as follows:

    1. Set Current Item to the Current Item property of the Loop Container activity of the ForEach activity. If this activity is the first activity in the For Each Loop activity, Current Item is set automatically.

    2. Set the value of the Property to Bind property to the value of the property of the current activity that uses the Current Item value.

Two types of activities don't get the Current Item and Property to Bind properties and therefore can't use the objects in the input collection:

  • Script activities, such as the Windows PowerShell Script activity.

  • Custom activities or other activities that don't inherit from the WorkflowActivityBase class. Such activities include those activities that are based on the Activity base class, such as native Visual Studio activities.

Design time prerequisites Run time prerequisites
None None

Properties

The For Each Loop activity uses the input properties that are described in the following table.

Display name Internal name Type Required Description
Input Collection InputCollection Array/Object N/A A collection of objects to be passed, one at a time, to the activities within the For Each Loop activity. If the activity that resides in the input container produces an array of objects as its output property, Input Collection is automatically set to that property. To view the current value of this property, right-click the loop container, and select Properties.
Current Item CurrentItem Object N/A An index into Input Collection that activities within the loop can use as an input property. For the first activity in the loop container, this property is set automatically.
Errors and exceptions Remarks Example
The For Each Loop activity uses the custom tracking service that is supplied by Service Manager to log errors and exceptions when the activity runs. The activity generates errors or exceptions under the following conditions:

- If any error occurs in the ForEachLoop activity and that isn't with the child activities, the workflow terminates.
- If any error occurs within the child activities, the workflow terminates unless ContinueOnError=true.
- If any of the input properties are null. The activity doesn't iterate.

Each activity within the For Each Loop activity must write its own errors or exceptions to the custom tracking service. The For Each Loop activity doesn't do so itself.
None None

IfElse activity

This activity controls the sequence of activities within a workflow based on a Boolean (True/False) condition. You can use the outcome of a previous activity, such as a script activity, for the condition.

The IfElse activity is a Visual Studio activity that uses rules and conditions. For more information about using rules and conditions in Windows Workflow Foundation (WF), see Tutorial: Use Rules and Conditions in WF in the MSDN Library.

Design time prerequisites Run time prerequisites
None None

Properties

None.

Errors and exceptions Remarks Example
None For more information about the IfElse activity, see IfElseActivity Class in the .NET Framework 4 Class Library. None

Parallel activity

This activity forks the sequence of activities into two simultaneous sequences of activities. The Parallel activity is a Visual Studio activity. For more information about the ParallelActivity class, see ParallelActivity Class in the .NET Framework Class Library.

Design time prerequisites Run time prerequisites
None None

Properties

None.

Errors and exceptions Remarks Example
None None None

Virtual Machine Manager activities

Use virtual machine management activities in Service Manager to build workflows that allow for creating and updating virtual machines. The virtual machine management activities support System Center Virtual Machine Manager.

The Service Manager Authoring Tool provides the following five default virtual machine management activities in the VMM Activities group in the Activities Toolbox pane.

Get VM activity

This activity in Service Manager retrieves a list of one or more virtual machine IDs from a Virtual Machine Manager (VMM) Library.

Design time prerequisites Run time prerequisites
None - The Virtual Machine Manager console and Service Manager must both be installed on the same server.
- Ensure that the Service Manager Workflow account has sufficient permissions to modify security groups in Active Directory Domain Services (AD DS).
- The Virtual Machine Manager console and Service Manager must both be installed on the same server.
- Ensure that the Service Manager Workflow account has sufficient permissions to modify security groups in Active Directory Domain Services (AD DS).

Properties

The Get VM activity uses the input properties in the following table.

Display name Internal name Type Required Description
Parameter Set ParameterSet String No; the default is Connection. Specifies a subset of parameters organized for a particular purpose. For the Get VM activity, you can select one of the following parameter sets:

- All: Search for all the available virtual machines.
- ID: Search for a virtual machine with a known ID.
- Connection: Search for virtual machines that are connected to the Virtual Machine Manager (VMM) server that is designated by the VMMServer property.
- VMHostGroup: Search for virtual machines that are connected to the virtual machine host that is designated by the VM Host property.
Continue On Error ContinueOnError Boolean No. (The default setting is True.) Determines whether the workflow should continue running if the activity fails.
Has Error HasError N/A Specifies if the activity has an error set. (Read-only)
All All Boolean No. (The default setting is True.) Available if the Parameter Set is All. If it's set to True, the Get VM activity returns a list of the virtual machine IDs of all of the available virtual machines.
ID ID String Required if Parameter Set is ID. Available if the Parameter Set is ID. If it's set to True, the Get VM activity returns a list of the virtual machine IDs of all of the virtual machines whose virtual machine IDs match all or part of the specified ID value.
Management Group ManagementGroup String No Specifies the management group in which this activity will run. Set to localhost. (Read-only)
Script Server Target String Yes Specifies the Domain Name System (DNS) name of the server that runs the Service Manager console. Don't use localhost.
Script Time Limit TimeoutSeconds Integer No. (The default setting is 300 seconds.) Specifies the maximum number of seconds to allow for the activity to run.
VM Host VMHost String Required if the Parameter Set is VMHostGroup Available if the Parameter Set is VMHostGroup. If this parameter set is selected, the Get VM activity returns a list of the virtual machine IDs of all the virtual machines running on the specified host.
VM Name VMName String No Specifies the name or part of a name of the virtual machine to search for. If the string is part of a name, the activity retrieves the IDs of all the virtual machines that contain the string.
VMMServer VMMServer String Yes Specifies the name of the System Center Virtual Machine Manager (VMM) server that manages the virtual machines.

The Get VM activity generates the output that is described in the following table.

Display name Internal name Type Comments
VM IDs VMIDList Array of strings Specifies the list of the IDs of virtual machines with names that match all or part of the VM Name string.
Errors and exceptions Remarks Example
The Get VM activity uses the custom tracking service that is supplied by Service Manager to log errors and exceptions when the activity runs. The activity generates errors or exceptions as appropriate if any of the script properties can't be resolved. None None

Move VM activity

This activity in Service Manager moves a virtual machine from the Virtual Machine Manager (VMM) Library to a maintenance host.

Design time prerequisites Run time prerequisites
None - The Virtual Machine Manager console and Service Manager must both be installed on the same server.
- Ensure that the Service Manager Workflow account has sufficient permissions to modify security groups in Active Directory Domain Services (AD DS).

Properties

The Move VM activity uses the input properties in the following table.

Display name Internal name Type Required Description
Continue On Error ContinueOnError Boolean No. (The default setting is True.) Determines whether the workflow should continue running if the activity fails.
Has Error HasError N/A Specifies whether the activity has an error set. (Read-only)
Block LM If Host Busy BlockLMIfHostBusy Boolean No. (The default setting is False.) Blocks retrying a Hyper-V live migration if the migration failed because the source host or the destination host is already participating in another live migration.
Job Group JobGroup Guid (string) No Specifies an identifier for a series of commands that will run as a set.
Job Variable JobVariable String No Specifies that job progress is tracked and stored in the variable named by this parameter.
Management Group ManagementGroup String No Specifies the management group in which this activity will run. Set to localhost. (Read-only)
Path Path String No Specifies the destination of the virtual machine on the maintenance host.
PROTipID PROTipID Guid No Specifies the ID of the Performance and Resource Optimization (PRO) tip that triggered this action. Allows for future auditing of PRO tips.
Run Asynchronously RunAsynchronously Boolean No. (The default setting is False.) Specifies that the job runs asynchronously so that control returns to the command shell immediately.
Script Server Target String Yes Specifies the Domain Name System (DNS) name of the server that runs the Service Manager console. Don't use localhost.
Script Time Limit TimeoutSeconds Integer No. (The default setting is 300 seconds.) Specifies the maximum number of seconds to allow for the activity to run.
Start VM On Target StartVMOnTarget Boolean No. (The default setting is False.) Specifies that a virtual machine starts as soon as it reaches its destination host.
Use Cluster UseCluster Boolean No. (The default setting is False.) Forces the use of Windows Server 2008 Cluster Migration for the transfer of a virtual machine that is in a saved state to a host, even if the cluster supports Hyper-V live migration.
Use LAN UseLan Boolean No. (The default setting is False.) Forces a transfer over the local area network (LAN) even if a faster transfer mechanism, such as a storage area network (SAN) transfer, is available.
VM Host VMHostName String Yes Specifies the name of the maintenance host to which the virtual machine will be moved.
VM ID VMID String Yes Specifies the unique ID of the virtual machine to be moved.
VMM Server VMMServer String Yes Specifies the name of the System Center Virtual Machine Manager (VMM) server that manages the virtual machines.

The Move VM activity generates the output that is described in the following table.

Display name Internal name Type Comments
VM ID VMID String Specifies the unique ID of the virtual machine that was moved. The input VM ID and the output VM ID are equal unless the activity failed to find a virtual machine with a VM ID that matches the input VM ID. In that case, the output VM ID is set to Null.
Errors and exceptions Remarks Example
The Move VM activity uses the custom tracking service that is supplied by Service Manager to log errors and exceptions when the activity runs. The activity generates errors or exceptions as appropriate if any of the script properties can't be resolved. None None

Shutdown VM activity

This activity in Service Manager shuts down the guest operating system on a virtual machine.

You can use the Shutdown VM activity on a virtual machine on a Windows-based host (a Hyper-V host or a Virtual Server host) only if virtualization guest services are installed on the virtual machine. For a virtual machine that is deployed on a Hyper-V host, the virtualization guest service is called Integration Components. For a virtual machine that is deployed on a Virtual Server host, the virtualization guest service is called Virtual Machine Additions.

Design time prerequisites Run time prerequisites
None - The Virtual Machine Manager console and Service Manager must both be installed on the same server.
- Ensure that the Service Manager Workflow account has sufficient permissions to modify security groups in Active Directory Domain Services (AD DS).

Properties

The Shutdown VM activity uses the input properties that are described in the following table.

Display name Internal name Type Required Description
Continue On Error ContinueOnError Boolean No. (The default setting is True.) Determines whether the workflow should continue running if the activity fails.
Has Error HasError N/A Specifies whether the activity has an error set. (Read-only)
Job Variable JobVariable String No Specifies that job progress is tracked and stored in the variable that is named by this parameter.
Management Group ManagementGroup String No Specifies the management group in which this activity will run. Set to localhost. (Read-only)
PROTipID PROTipID Guid No Specifies the ID of the Performance and Resource Optimization (PRO) tip that triggered this action. Allows for future auditing of PRO tips.
Run Asynchronously RunAsynchronously Boolean No. (The default setting is False.) Specifies that the job runs asynchronously so that control returns to the command shell immediately.
Script Server Target String Yes Specifies the Domain Name System (DNS) name of the server that runs the Service Manager console. Don't use Localhost.
Script Time Limit TimeoutSeconds Integer No. (The default setting is 300 seconds.) Specifies the maximum number of seconds to allow for the activity to run.
VM ID VMID String Yes Specifies the unique ID of the virtual machine to be shut down.
VMMServer VMMServer String Yes Specifies the name of the System Center Virtual Machine Manager (VMM) server that manages the virtual machines.

The Shutdown VM activity generates the output that is described in the following table.

Display name Internal name Type Comments
VM ID VMID String Specifies the unique ID of the virtual machine that was shut down. The input VM ID and the output VM ID are equal unless the activity failed to find a virtual machine with a VM ID that matches the input VM ID. In that case, the output VM ID is set to Null.
Errors and exceptions Remarks Example
The Shutdown VM activity uses the custom tracking service that is supplied by Service Manager to log errors and exceptions when the activity runs. The activity generates errors or exceptions as appropriate if any of the script properties can't be resolved. None None

Start VM activity

This activity in Service Manager starts a stopped or paused virtual machine.

Design time prerequisites Run time prerequisites
None None

Properties

The Start VM activity uses the input properties in the following table.

Display name Internal name Type Required Description
Continue On Error ContinueOnError Boolean No. (The default setting is True.) Determines whether the workflow should continue running if the activity fails.
Has Error HasError N/A Specifies whether the activity has an error set. (Read-only)
Job Variable JobVariable String No Specifies that job progress is tracked and stored in the variable that is named by this parameter.
Management Group ManagementGroup String No The management group in which this activity will run. Set to localhost. (Read-only)
PROTipID PROTipID Guid No Specifies the ID of the Performance and Resource Optimization (PRO) tip that triggered this action. Allows for future auditing of PRO tips.
Run Asynchronously RunAsynchronously Boolean No. (The default setting is False.) Specifies that the job runs asynchronously so that control returns to the command shell immediately.
Script Server Target String Yes Specifies the Domain Name System (DNS) name of the server that runs the Service Manager console. Don't use localhost.
Script Time Limit TimeoutSeconds Integer No. (The default setting is 300 seconds.) Specifies the maximum number of seconds to allow for the activity to run.
VM ID VMID String Yes Specifies the unique ID of the virtual machine to be started.
VMMServer VMMServer String Yes Specifies the name of the System Center Virtual Machine Manager (VMM) server that manages the virtual machines.

The Start VM activity generates the output that is described in the following table.

Display Name Internal Name Type Comments
VM ID VMID String Specifies the unique ID of the virtual machine that was started. The input VM ID and the output VM ID are equal unless the activity failed to find a virtual machine with a VM ID that matches the input VM ID. In that case, the output VM ID is set to Null.
Errors and exceptions Remarks Example
The Start VM activity uses the custom tracking service that is supplied by Service Manager to log errors and exceptions when the activity runs. The activity generates errors or exceptions, as appropriate, if any of the script properties can't be resolved. None None

Save State VM activity

This activity in Service Manager saves the state of a virtual machine and then stops the virtual machine.

Design time prerequisites Run time prerequisites
None - The Virtual Machine Manager console and Service Manager must be both installed on the same server.
- Ensure that the Service Manager Workflow account has sufficient permissions to modify security groups in Active Directory Domain Services (AD DS).

Properties

The Save State VM activity uses the input properties that are described in the following table.

Display name Internal name Type Required Description
Continue On Error ContinueOnError Boolean No. (The default setting is True.) Determines whether the workflow should continue running if the activity fails.
Has Error HasError N/A Specifies whether the activity has an error set. (Read-only)
Job Variable JobVariable String No Specifies that job progress is tracked and stored in the variable that is named by this parameter.
Management Group ManagementGroup String No Specifies the management group in which this activity will run. Set to localhost. (Read-only)
PROTipID PROTipID Guid No Specifies the ID of the Performance and Resource Optimization (PRO) tip that triggered this action. Allows for future auditing of PRO tips.
Run Asynchronously RunAsynchronously Boolean No. (The default setting is False.) Specifies that the job runs asynchronously so that control returns to the command shell immediately.
Script Server Target String Yes Specifies the Domain Name System (DNS) name of the server that runs the Service Manager console. Don't use localhost.
Script Time Limit TimeoutSeconds Integer No. (The default setting is 300 seconds.) Specifies the maximum number of seconds to allow for the activity to run.
VM ID VMID String Yes Specifies the unique ID of the virtual machine to be saved.
VMM Server VMMServer String Yes Specifies the name of the System Center Virtual Machine Manager (VMM) server that manages the virtual machines.

The Save State VM activity generates the output that is described in the following table.

Display name Internal name Type Comments
VM ID VMID String Specifies the unique ID of the virtual machine that was saved. The input VM ID and the output VM ID are equal unless the activity failed to find a virtual machine with a VM ID that matches the input VM ID. In that case, the output VM ID is set to Null.
Errors and exceptions Remarks Example
The Save State VM activity uses the custom tracking service that is supplied by Service Manager to log errors and exceptions when the activity runs. The activity generates errors or exceptions as appropriate if any of the script properties can't be resolved. None None

Script activities

Use a script activity in Service Manager to run a script as part of a workflow.

Script activities run as a separate process from the workflows; however, they also run under the security context of the Service Manager Workflow account.

The Service Manager Authoring Tool provides the following three default script activities in the Generic Script Activities subgroup of the Script Activities group in the Activities Toolbox pane.

Command Script activity

This activity runs a command-line script as part of a Windows Workflow Foundation (WF) workflow.

Design time prerequisites Run time prerequisites
None None

Properties

The Command Script activity uses the input properties that are described in the following table.

Display name Internal name Type Required Description
Continue On Error ContinueOnError Boolean No. (The default setting is True.) Determines whether the workflow should continue running if the activity fails.
Has Error HasError N/A Specifies whether the activity has an error set. (Read-only)
Management Group ManagementGroupName String No Specifies the management group to which the script server belongs. By default, this is set to localhost. (Read-only)
Script Parameters Parameters Dictionary <string,string> Yes Specifies command-line switches or switch/value pairs to be passed into the script when it runs.
Script Body ScriptBody String Yes Specifies the text of the script itself.
Script Server Target String No Specifies the Domain Name System (DNS) name of the server that runs the Service Manager console. Don't use localhost.
Script Time Limit TimeoutSeconds Integer No. (The default setting is 300 seconds.) Specifies the maximum number of seconds to allow for the script to run.
Errors and exceptions Remarks Example
The Command Script activity uses the custom tracking service that is supplied by Service Manager to log errors and exceptions when the activity runs. The activity generates errors or exceptions as appropriate if any of the script properties can't be resolved. None None

Windows PowerShell Script activity

This activity in Service Manager runs a Windows PowerShell script as part of a Windows Workflow Foundation (WF) workflow.

Design time prerequisites Run time prerequisites
The Windows PowerShell Script activity depends upon the following prerequisites at design time:
- Windows PowerShell 2.0
Windows PowerShell 2.0

Properties

The Windows PowerShell Script activity uses the input properties that are described in the following table.

Display name Internal name Type Required Description
Continue On Error ContinueOnError Boolean No. (The default setting is True.) Determines whether the workflow should continue running if the activity fails.
Has Error HasError N/A Specifies whether the activity has an error set. (Read-only)
Management Group ManagementGroupName String No Specifies the management group to which the script server belongs. By default, this is set to localhost. (Read-only)
Script Parameters Parameters Dictionary <string,string> Yes Specifies the name/value list of parameters to be passed into the script when it runs.

You can set parameter values to any of the following management pack references:

- $Target/...$
- $MPElement[...]
- $Data/...$. $Data references are resolved only at run time in the parameters (not in the script itself).

Using one of these references as the only value for a parameter sets that parameter to the XML string that represents the input data item (from GetItemXML).
Script Body ScriptBody String Yes Specifies the text of the script itself.
Snap-ins SnapIns String No Lists Windows PowerShell snap-ins to preload into the runspace.
Script Server Target String No Specifies the Domain Name System (DNS) name of the server that runs the Service Manager console. Don't use localhost.
Script Time Limit TimeoutSeconds Integer No. (The default setting is 300 seconds.) Specifies the maximum number of seconds to allow for the script to run.
Errors and exceptions Remarks Example
The Windows PowerShell Script activity uses the custom tracking service that is supplied by Service Manager to log errors and exceptions when the activity runs. The activity generates errors or exceptions as appropriate if any of the script properties can't be resolved. For more information about Windows PowerShell, see Windows PowerShell. None

VBScript Script activity

This activity in Service Manager runs a VBScript script as part of a Windows Workflow Foundation (WF) workflow.

Design time prerequisites Run time prerequisites
The VBScript Script activity depends on the following prerequisites at design time:
None.
None

Properties

The VBScript Script activity uses the input properties that are described in the following table.

Display Name Internal Name Type Required Description
Continue On Error ContinueOnError Boolean No. (The default setting is True.) Determines whether the workflow continues to run if the activity fails.
Has Error HasError N/A Specifies whether the activity has an error set. (Read-only)
Management Group ManagementGroupName String No Specifies the management group to which the script server belongs. (By default, this is set to localhost) (Read-only)
Script Parameters Parameters Dictionary <string,string> Yes Provides the list of the standard switches and any associated values that this script uses when it runs.
Script Body ScriptBody String Yes Specifies the text of the script itself.
Script Server Target String No Specifies the Domain Name System (DNS) name of the server that runs the Service Manager console. Don't use localhost.
Script Time Limit TimeoutSeconds Integer No. (The default setting is 300 seconds.) Specifies the maximum number of seconds to allow for the script to run.
Errors and exceptions Remarks Example
The VBScript Script activity uses the custom tracking service that is supplied by Service Manager to log errors and exceptions when the activity runs. The activity generates errors or exceptions as appropriate if any of the script properties can't be resolved. None None

Service Manager activities

Use Service Manager activities in Service Manager to make Service Manager functions part of your workflow.

The Service Manager Authoring Tool provides the following four default Service Manager activities in the SM Activities group in the Activities Toolbox pane.

Create Incident activity

This activity creates and populates an incident in Service Manager.

Design time prerequisites Run time prerequisites
None None

Properties

The Create Incident activity uses the input properties that are listed in the following table.

Display name Internal name Type Required Comments
Incident ID IncidentID String Yes Specifies the unique identifier who is generated for the Incident object.
Action Log Comment ActionLogComment String Yes Specifies the comment to include in the Incident object's action log.
Affected User Domain AffectedUserDomain String Yes Specifies the name of the Domain Name System (DNS) domain of the primary user who is affected by the incident.
Affected User Name AffectedUserName String Yes Specifies the user name of the primary user who is affected by the incident.
Category Category Integer Yes Specifies the type of incident, such as Networking or Printing. The value is the ID of enum. (Category -enum data field)
Continue On Error ContinueOnError Boolean No. (The default setting is true.) Determines whether the workflow should continue running if the activity fails.
Impact Impact Integer Yes Specifies the impact of the incident on the affected user or users. The value is the ID of enum. (Impact -enum data type)
Source Source Integer No Specifies the source of information about the incident, such as Phone or E-mail. The value is the ID of enum. (Source -enum data type field)
Summary Summary String Yes Specifies the summary text that describes the incident.
Urgency Urgency Integer Yes Specifies the urgency of resolving the incident. The value is the ID of enum. (Urgency -enum data type field)

The Create Incident activity generates the output that is described in the following table.

Name Type Comments
SM Incident System.WorkItem.Incident Returns the constructed incident class instance.
Errors and exceptions Remarks Example
None None None

Get Incident activity

This activity retrieves one or more incidents in Service Manager.

Design time prerequisites Run time prerequisites
None None

Properties

The Get Incident activity uses the input properties that are listed in the following table.

Display name Internal name Type Required Comments
Affected User Domain AffectedUserDomain String No Specifies the name of the Domain Name System (DNS) domain of the primary user who is affected by the incident.
Affected User Name AffectedUserName String No Specifies the user name of the primary user who is affected by the incident.
Category Category Integer No Specifies the type of incident, such as Networking or Printing. The value is the ID of enum. (Category -enum data field)
Continue On Error ContinueOnError Boolean No. (The default is true.) Determines whether the workflow should continue running if the activity fails.
Incident ID IncidentID String No Specifies the unique identifier that is generated for the incident object.
Search Type SearchType Integer No Specifies the title of the search type that is used with the activity.
Status Status Integer No Specifies the status of incident. The value is the ID of enum. (Status -enum data field)
Summary Text SummaryText String No Specifies the summary text that describes the incident.

The Get Incident activity generates the output that is described in the following table.

Display name Internal name Type Comments
SM Incidents SMIncidents Array of System.Workitem.Incident Specifies an array of incident objects.
Errors and exceptions Remarks Example
None The Get Incident activity has its own validator to perform error validation on input properties. None

Update Incident activity

This activity in Service Manager saves property changes to one Service Manager incident.

Design time prerequisites Run time prerequisites
None None

Properties

The Update Incident activity uses the input properties that are described in the following table.

Display name Internal name Type Required Description
Action Log Comment ActionLogComment String No Specifies a comment to include in the Incident object's action log.
Affected User Domain AffectedUserDomain String No Specifies the name of the Domain Name System (DNS) domain of the primary user who is affected by the incident.
Affected User Name AffectedUserName String No Specifies the user name of the primary user who is affected by the incident.
Category Category Integer No Specifies the type of incident, such as Networking or Printing. The value is the ID of enum. (Category -enum data type)
Continue On Error ContinueOnError Boolean No. (The default setting is true.) Determines whether the workflow should continue running if the activity fails.
Impact Impact Integer No Specifies the impact of the incident on the affected user or users. The value is the ID of enum. (Impact -enum data type)
Source Source Integer No Specifies the source of information about the incident, such as Phone or E-mail. The value is the ID of enum. (Source -enum data type)
Service Manager Incident SMIncident System.Workitem.Incident No The constructed incident class instance to be updated.
Status Status Integer No Specifies the status of the incident that generated the activity. The value is the ID of enum. (Status -enum data type)
Summary Summary String No Specifies the summary text that describes the incident.
Urgency Urgency Integer No Specifies the urgency of resolving the incident. The value is the ID of enum. (Urgency -enum data type field)

The Update Incident activity generates the output that is described in the following table.

Display name Internal name Type Description
SM Incident SMIncident System.WorkItem.Incident Returns an update of the incident class instance. The input SM Incident and the output SM Incident are equal unless the activity failed to find the SM Incident. In that case, the output SM Incident is set to Null.
Errors and exceptions Remarks Example
None None None

Set Activity Status to Completed activity

This activity updates the status of an automated activity in Service Manager.

Design time prerequisites Run time prerequisites
None None.

Properties

The Set Activity Status to Completed activity uses the input properties that are described in the following table.

Display name Internal name Type Required Description
Activity ID ActivityID String Yes Specifies the identifier of a Service Manager automated activity object.
Errors and exceptions Remarks Example
None When you're using this activity in a workflow that is triggered by a Service Manager automated activity, enter $Data/BaseManagedEntityId$ as the value of this property. This value applies to the Set Activity Status to Completed activity at the automated activity that triggered the workflow to run. None