Configure Script Objects

Owned by Enterprise IT
Last updated: Apr 23, 2024 by Mayuresh Balaji Kamble (Unlicensed)Version comment

Scripts are the set of commands which are written to accomplish a specific task. Scripts can be written in multiple languages like PowerShell, Perl Python etc. Published scripts will be available to create the Orchestration Workflow.

To get a quick understanding of loading the Script to the Service Automation, browse the following video.

To configure a new Orchestration Script:

  1. Select Script Configurations. The Script Configurations list page is displayed.
  2. On the Script Configurations list page, click on + icon to configure a new script. For more information on the fields of Script Configurations list page, see, Field Description.
  3. Select the Script Language.
  4. Click Load Parameters, after specifying the script. Specify other required fields in Script Configurations details page. For more information on the fields of Script Configurations details page, see, Field Description.
  5. Click Submit. A new Orchestration Script  is configured.

To update an existing Orchestration Script:

  1. Select Script Configurations. The Script Configurations list page is displayed.
  2. On the Script Configurations list page, select the specific script to edit or view the script. For more information on the fields of Script Configurations list page, see, Field Description.
  3. Click Load Parameters, after specifying the required parameters of the script. For more information on the fields of Script Configurations details page, see, Field Description.
  4. Click Submit. The orchestration's script's configurations are updated.


Figure:  Script Configurations List Page

Field Description

The following table describes the fields on the Script Configurations list page:

Fields

Description

Script Name

Displays the script name.

Status

Displays the status of the script.

Category

Displays the category of the script.

Right click on icon and the following options are displayed:

  • Sort (A to z)
  • Sort (Z to a)
  • Group by Column

Check the Group by Column check box to group the categories. Uncheck the Group by Column check box to un-group the categories.

Script Language

Displays the script language.

Created By

Displays the name of the user who has created the script.

Last Updated By

Displays the name of the user who has last updated the script.

Last Updated Date

Displays the date on which the script was last updated.

Created Date

Displays the date on which the script was last created.

Description

Displays the description of the script.

Click this icon to add a new script.

Click this icon and select one the of following options:

  • Export to Excel – To export the all the listed script configurations to Microsoft Excel sheet.
  • Export to JSON - To export the individual listed script configuration to the respective individual json file.

Click this option and Filter Pop-up page is displayed. You can apply, save, and update the filters to the script configuration.

Figure: Filter Pop-up

Click this option and Edit Column pop-up page is displayed. You can add a column, delete a column, or change the order of columns. Click Apply to save the changes and you can view the applied changes on Screen Configurations page.

Figure: Edit Columns Pop-up

Click on this icon, a search text box is displayed against each column to search the data against each column.

Figure: Script Configurations details page

Field Description

The following table describes the fields on the Script Configurations list page:

Fields

Description

Script Language

Select the language in which you want to write the script. SummitAI Orchestration supports the following scripting languages:

  • DOS Command
  • Perl Script
  • PowerShell Script
  • Python
  • Shell Script (Windows)
  • Shell Script (Non-Windows)
  • VB Script

Theme

You can select the theme while writing the script to get the better view of the script. The following themes are available:

  • Light
  • Dark
  • High Contrast Dark

Script Editor

Specify the commands in the script window.

Input Parameters should be declared as [*VariableName*]

The starting and ending of Output Parameters should be declared as [START##VariableName##] and [END##VariableName##].

Script Details

Specify the following parameters under script details.

  • Script Name – Specify the script name.
  • Category – Specify the category of automation script.
  • Status – By default, status will be in Design mode. Specify the status of the script as required. Available options are as follows:
    • Design
    • Maintenance
    • Published

Except Status field, all other fields will be read-only. Only published scripts will be displayed in the Workflow Designer.

  • Description – Specify the description of the script.

Execution

Specify the following parameters under execution.

  • Max Run Time (In Mins) - Specify the maximum run time for the script in terms of minutes. By default, it is saved as 0, if maximum run time is not specified.
  • Remote Execution By - Administrators can configure the Orchestration Scripts to capture the account under which the Script should get executed through Remote Executor Tool by selecting System Account or CI Account.

Input

Once you click on Load Parameters, the parameters specified in the script are displayed under Input tab.

Output

Once you click on Load Parameters, the output variables specified in the script are displayed in Output Variable drop-down under Output tab. You can map the Output Name to the required Output Value.

By default, the following options are available in Output Value drop-down list:

  • Execution Output
  • Execution Error

Criteria

Specify the condition to define the success or failure of the Orchestration Script.

  • Slide the Active button to make the success criteria on.
  • Select the variable from the list.
  • Choose the condition from the list.
  • Specify the value for the condition.