This page details the steps to create a new Automation This page details the steps to create a new Automation workflow.
Table of Contents | ||||||
---|---|---|---|---|---|---|
|
...
- As an Administrator, click the Automation icon.
The Automation page appears. - Click the Workflows tab.
- Click New Workflow.
- Provide a Name and Description to your workflow and click Save.
The new Automation workflow appears in the Workflows list. - Click the workflow Name to start designing the workflow.
Info | ||
---|---|---|
| ||
When you click on any workflow, the Automation Workflow Designer opens in a new tab. If that does not happen, please open a Support Ticket or send an email to support@serviceaide.com. |
...
- On the Workflows tab, click the Name link to open your workflow in the Automation Workflow Designer.
A basic workflow with a Start and Stop point appears on the canvas. - Click Call Service + on the left pane to add an Operation to the canvas.
- Double-click the Call Service entity just added, to open the Call Service Activity Configuration window and configure it.
- Configure the Activity Details:
- Specify the name of the Operation under Activity Name field.
- The Activity Id is set automatically.
- Add a description under Activity Purpose field.
- Select an OOTB Operation from the 'Select a Service' list. A complete list of OOTB Operations is available at Out-of-the-box Automation Operations and Workflows.
- Click Next to go to the next tab.
- Configure the Service Input for the Operation in the Workflow.
- Define the Service Inputs that the Operation will receive from an external system, which it will then use to execute the task. For example, to Reset AD User password, the inputs the Operation will need is sAMAccountName of AD User, which will be passed from the skill attribute to the workflow. Input is an object that consists of all input fields and you can use it by typing
input.field_name.
- Click Save Draft on the Workflow Designer to save the changes.
- Define the Service Inputs that the Operation will receive from an external system, which it will then use to execute the task. For example, to Reset AD User password, the inputs the Operation will need is sAMAccountName of AD User, which will be passed from the skill attribute to the workflow. Input is an object that consists of all input fields and you can use it by typing
- In the above step you configured one operation. Similarly, you can create multiple operations within the same workflow.
- Define the sequence of your automation workflow by connecting the Start, Stop points and the Operations.
Defining the Start Activity Data
This is a requirement only when you are creating a new Automation Workflow. (For OOTB workflows this is already completed.)- Go to the Start step and double-click to open Start. It consists of the JSON Schema and Input tabs. The JSON Schema tab contains the details of all the inputs that the workflow will need. It defines which input parameters are required (mandatory), which parameters are optional and what are the data-types (string, number etc) of each input parameter. The Input tab should contain a super set list of all the input parameters that the workflow will need.
- First go to the Input tab and add all Input Parameters that are required for the various operations in your workflow.
- For example in the sample workflow below there are two operations. Operation 1 has input parameters requestor and login_name. Operation 2 has input parameters requestor, and to. In that case a super set of all the input parameters must be defined under the Input tab of Start step as shown in the following screenshot. Manually enter the input parameters under the Service Input tab. Remember to write the parameters inside curly brackets {}. Multiple parameters are separated by a comma.
- After this click the i button on the top right corner.
- This will open a website in a new browser tab, to generate the JSON Schema. Under the Sample JSON Document area, copy and paste all your input parameters and click Generate Schema.
- The JSON data is generated in the section below, as seen below.
- Copy this Infered JSON Schema and paste it into the Workflow Designer - Start step >> JSON Schema tab.
- Click Next, then click Submit. This saves the Start Activity data. For a custom or newly created workflow, if this step is not completed, then the input parameters defined in Automation Workflow will not be mapped with parameters of the automation workflow.
- Go to the Start step and double-click to open Start. It consists of the JSON Schema and Input tabs. The JSON Schema tab contains the details of all the inputs that the workflow will need. It defines which input parameters are required (mandatory), which parameters are optional and what are the data-types (string, number etc) of each input parameter. The Input tab should contain a super set list of all the input parameters that the workflow will need.
- Click Publish to publish your Automation workflow.
...
In order to execute a workflow, the system will need some configurations such as how to connect to the system where the automated task will be executed. You can store these configurations under the Service Configurations.
- Click the Automation icon.
The Automation page appears. - Click the Service Configurations tab.
- Identify the appropriate Service Configuration you need to update. Refer to the table listed in Annexure I to understand which Service Configuration is related to which Operation.
- Click the Edit icon to edit the records.
- If you want to input an encrypted value in the configurations, use the Encryption Utility provided. Add the data in Text to Encrypt field and click Encrypt.
The Encrypted text appears in the field below. - Click Copy to copy the encrypted text to the clipboard.
- Paste it under appropriate tag on the left pane.
Click Save to save your Service Configuration.
Info title Note Note that the Service Configuration is internally linked to the appropriate Operation. Administrator does not need to relate or link them.
Step 4 : Publish Automation workflow as a Service
...
- On the Automation page, click the Workflow Services tab.
- Click New Workflow Service as shown below.
The Workflow Services page appears as shown below. - Select your Workflow from the list.
- Provide the Name to your workflow service.
- Provide the workflow Description.
- Select the Orchestration Server as default. The Orchestration server should be set to 'default' if you are using the SaaS version of Automation. If you have deployed the Automation server on-premise, then the details have to be specified here.
- Click Save & Next.
The Attributes tab appears. - Click Add Text Attribute to add the attribute information.
The Add Text Attribute pop-up window appears as shown below. - Specify the attribute Field ID.
- System automatically populates the Field ID as the attribute Name.
- You can choose whether a Placeholder is required for the attribute.
- Click Save to save the changes.
Step 5 : Add the Automation Service into Ticket Workflow
...
Refer to the steps listed at Execute an Automation Service from a Ticket Workflow.
Annexure I: OOTB Operations and their corresponding Service Configurations
No. | Operation Name | Service Configurations | Input Name | Service Configurations | |
---|---|---|---|---|---|
1 | Disable AD User | Login Nameactive_directory_configuration sa_default_configurations | active_directory_configurationLogin Name | ||
2 | Add AD User to Group | Login Nameactive_directory_configuration sa_default_configurations | Login Name Group Name | active_directory_configuration | |
3 | Create AD User | Login Nameactive_directory_configuration sa_default_configurations | Login Name First Name Last Name | active_directory_configuration | Employee ID |
4 | Unlock AD User | Login Nameactive_directory_configuration sa_default_configurations | active_directory_configurationLogin Name | ||
5 | Delete AD User | Login Nameactive_directory_configuration sa_default_configurations | active_directory_configurationLogin Name | ||
6 | Reset AD User Password | Login Nameactive_directory_configuration sa_default_configurations | Login Name Mobile Number | ||
active_directory_configuration | 7 | Create AD Group | Group Nameactive_directory_configuration sa_default_configurations | ||
Group Description | active_directory_configuration | ||||
Group Name Group Description sAMAccountName | |||||
8 | Enable AD User | Login Nameactive_directory_configuration sa_default_configurations | active_directory_configurationLogin Name | ||
9 | Check Linux file exists | File Namelinux_configuration sa_default_configurations | File Name Directory | pathlinux_configurationPath | |
10 | Execute Shell Script | Shell script file absolute pathlinux_configuration sa_default_configurations | linux_configurationShell script file absolute path | ||
11 | Compare two files in Linux | linux_configuration sa_default_configurations | Absolute path of file one | sa_default_configurationsAbsolute path of file two | linux_configuration |
12 | StopStop Windows Service | Windows Service Nameactive_directory_configuration sa_default_configurations | active_directory_configurationWindows Service Name | ||
13 | Windows Service Status | Windows Service Nameactive_directory_configuration sa_default_configurations | active_directory_configurationWindows Service Name | ||
14 | Start Windows Service | Windows Service Nameactive_directory_configuration sa_default | _configurationsactive_directory_configuration_configurations | Windows Service Name | |
15 | Execute Power Shell | Power Shell script absolute pathactive_directory_configuration sa_default_configurations | active_directory_configurationPower Shell script absolute path | ||
16 | Create VMware Snapshot | VM Namevmware_configuration sa_default_configurations | VM Name New Snapshot Name | vmware_configurationNew Snapshot Description | |
17 | Clone VMware Instance | New VM Namevmware_configuration sa_default_configurations | New VM Name Existing VM Name | vmware_configuration||
18 | Delete VM Single Snapshot | VM Namevmware_configuration sa_default_configurations | VM Name VM Snapshot Name | vmware_configuration||
19 | Revert Snapshot of VM Instance | VM Namevmware_configuration sa_default_configurations | VM Name VM Snapshot Name | vmware_configuration||
20 | Delete VM Instance | Existing VM Namevmware_configuration sa_default_configurations | vmware_configurationExisting VM Name | ||
21 | Stop VMware Instance | Existing VM Namevmware_configuration sa_default_configurations | vmware_configurationExisting VM Name | ||
22 | Start VMware Instance | Existing VM Namevmware_configuration sa_default_configurations | vmware_configurationExisting VM Name | ||
23 | ISM Service | request update statusTicket Status (Ex: Resolved)request update status | sa_default_configurations | Ticket Status | |
24 | ISM Create Service Request | Requestor For Name | sa_default_configurations | Requestor For Name Parent Request ID Request Details Request Description Request Category Request Class Requestor Name | |
25 | ISM add worklog | Worklog Descriptionsa_default_configurations | Worklog Description | ||
26 | Send Twilio SMS | Mobile Number | sms_and_email_configuration | Message | sa_default_configurations |
Mobile Number Message |
Info | ||
---|---|---|
| ||
requestor input field is common for all workflows. |