Automation Catalog (IAP 2022.1)
  • 21 Nov 2024
  • Dark
    Light
  • PDF

Automation Catalog (IAP 2022.1)

  • Dark
    Light
  • PDF

Article summary

  • Automation Catalog is a legacy functionality only in IAP/2022.1
  • See related breaking change notice → Automation Catalog Removed

What is Automation Catalog?

When network automation is implemented with Automation Catalog, configuration changes are consistently applied across the infrastructure through pre-built specific tasks, making network management more efficient and easier to scale across more functional areas and departments within your enterprise. Users can also accelerate the roll out of new services and applications by creating new instantiations of an existing automation, with the ability to manually start or schedule single or recurring automations.

To access the application, select Automation Catalog in the left navbar of the IAP/2022.1 home page.

01_autoCatalog

Once the Automation Catalog application displays, you can click the grid icon in the top toolbar to view all the automations available in Automation Catalog, or begin by clicking the appropriate icons to search or create an automation from the Get Started dialog box.

Automation Catalog | Home Page
02_autoCatalogStart

Automation Catalog | Automations
03_autoCatalogGrid

The main user interface (UI) for Automation Catalog is described below along with summary descriptions for various features and functionality.

04_automationsView

UI Label UI Element Description
1a Plus (+) icon Create new automation from side navigation.
1b Plus (+) icon Create new automation from blank card.
2 Collection icon Navigate back to the collection view.
3 Automation title Click to view/edit automation detail.
4 Stacked dots Click to open modal to view/edit automation detail.
5 Play button Click to run the automation.

Creating a New Automation

There are two ways to create an automation using Automation Catalog.

  1. Click the plus (+) icon in the side navigation (1a).
  2. Click the plus (+) icon on the blank card (1b).

After clicking the (+) icon, the Create Automation dialog will open. Once you to enter a name and description for your automation, click the Create button. You will be redirected to the collection view and the automation will be added to the collection list in the left sidebar.

14_createAutomation

Editing an Automation

There are three ways to edit automation details in Automation Catalog:

  1. Click the title of the automation (3).
  2. Click the stacked dots button to edit details (4).
  3. Click the name of your automation in the left side navigation.

Within the automation, you can change multiple attributes.

05_automationDetails

UI Label Description
1 Access management. Used to set automation permissions. For more information, see Automation Permissions below.
2 Actions to delete or export an automation.
3 Required. The Automation bound to the item .
4 Optional. The Form bound to the item.
Note: Automation Catalog does not support the dynamic dropdown options feature from JSON Forms. If you wish to use a JSON Form with dynamic dropdown options to schedule an automation, you must use Operations Manager instead. Existing Automation Catalog items may be moved to Operations Manager by following the migration process outlined within the Automations guide.
5 View and edit the current form assigned to this automation in Form Builder.
6 Create a new form in Form Builder.
7 Save changes to the automation.
8 Activate this switch to run an automation on a schedule. For more information, see Schedule an Automation below.
9 Run the automation (outside of a scheduled run). Note: Can also run the automation from the play button in the collection view.

Note: If working to access your form data from the automation canvas, please see Querying Form Data below.

Setting Automation Permissions

Click the cog icon at the top of the Automation Details page to open the Access Management panel, which allows you to assign user groups authorized to change and/or view an automation. By default, no group permissions are assigned, which grants all users permission to change, view, and execute an automation.

  • To assign Read-Write permissions to a group, use the search bar to locate the appropriate group. Once all group selections are made, click Save.
  • Groups with Write permissions are authorized to change, view, and execute an automation while Read-only groups have permission only to view and execute.
  • If a Write group or Read-only group is set, then the counterpart group must also be defined; in other words, a Write group cannot be configured without at least one group specified as Read-only and vice versa.

06_gbac0

Note: A warning message will appear if modifying these permissions will negatively impact the current user.

07_gbac1

Running an Automation

There are two ways to run an automation using Automation Catalog.

You can press the Run Manually button (see image above). Alternately, from the Automations page, click the stacked dots menu button and select Run. Input the form data, if required. Then click Run.

08_automationMenuRun

09_automationFormDataRun

Scheduling an Automation

To run an automation on a schedule, activate the Schedule switch slider. Once the switch is activated, set the schedule properties.

Property Description
Start on Required. This will be the date of the first instance. Must be set in the future.
Run At Required. Must be set in conjunction with the Start on property. This is the time to run the first instance.
Repeat Optional. Set this property to run the automation on a repeat schedule.
Form Data Optional. Set this property if you want the schedule to pass in formData to the automation.

The following example is an automation that runs every evening at 10:30pm (from July 4th onward) and passes in the following data to an automation.

{
  "formData": {
    "name": "paul"
  }
}

10_scheduleOptions


Was this article helpful?

Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.