Page History

Setting up ACP Access in ProVision

Before using the ACP Workflow Gadget, you must set the ACP URL and user credentials in Admin → Admin Preferences.

Enter the ACP URL for a licensed ACP instance, then provide the ACP Username and Password for the user that should be used to execute Workflows. To verify the account, click "Test Configuration" - you will be notified whether the account is valid. 

When done, click "Update".

After setup, the ACP Workflows Gadget will Gadget will load with the available Workflows from your ACP instance, and can be configured to select which Workflow and inputs you wish to use.

Configuring the ACP Workflow Form

The ACP Workflow form is access from the Edit Section page, under "Manage Gadgets".

Once ACP settings have been added to Admin Preferences, the "ACP Workflow Form" Gadget can be added to a Section, and Workflows from the associated ACP instance will be available to select. containing fields to select the desired Workflow to Run, Title, and map input options.

Select a Workflow, then edit the title to display on the gadget and map input options. Input options will vary according to the selected Workflow. Registered constraints can be applied to default input fields. See Constraints for more details.

You may also choose to refresh the page once the workflow execution is complete, and/or show JSON results. 

Multiple Forms may be added to a Section, in order to run additional Workflows or option settings.  When complete, click "Save".

Working with the ACP Workflow Form

Once enabled, the Gadget will show on the resource page for any resource of the section type.

Input the field data necessary for the Workflow - here, it's adding a hostname - then click "Execute Workflow" to process the chain of workflow calls. 

If "Display JSON Results" has been enabled, a display modal will appear showing the JSON response of the executed workflow.

When done reviewing the response, click "Close". 

If the page has not refreshed, you will see a message informing you whether the Workflow has successfully executed.

In this example, a "Customer Turn-Up" Workflow was selected (created in ProVision's ACP product) that performed six functions with one button click. The successful "Execute" for "Customer Turn-Up" created a new customer resource entry, assigned IPv4 and IPv6 blocks to them, created a DNS zone for the hostname, and lastly created 'A' and 'AAAA' records for the zone.

Using this gadget, you can:

• Direct Assign with or without additional filtering options. In cases where duplicate blocks exist, using the filter options with Direct Assign allows you to specifically control which of the dupilicate duplicate blocks is assigned.
  • To open the Direct Assign section of the Gadget and the advanced options, click the expansion caret in the upper right section, and then click "Advanced Options". 
    
• Smart Assign with or without additional filtering options. Required fields for Smart assign are: "Type", "RIR", and "Size", but additional fields such as "Region", "VLAN", "LIR", "Resource" (for blocks that allow subassignments), and various "Tag" mode options.
• Smart Browse using smart assign filter options to bring up a browsable list of blocks meeting that criteracriteria, from which you may assign or assign out of. 
  • To open the Smart Assign / Smart Browse section of the Gadget and the advanced options, click the expansion caret in the upper right Smart Assign section, and then click "Advanced Options". 
    
• View, Filter, and Sort Assigned Blocks for the resource via the "IP Blocks" list.
  • To Filter: click the "filter" link in the top right area of the header to open filter options. Enter your desired criteria and hit "Apply". 
    
  • To Sort: Click on the header name you wish to sort by, and the field will toggle between ascending and descending order.
    
• Manage Assigned Blocks for the resource by going into the "IP Blocks" list, and using the Action Menu (Gear Icon) to perform actions for the selected block.
  All options available in IPAM Manage for a block are also available in the IPAM Gadget Action menu, although the "Templates" option will be applicable in the IPAM Gadget.
  
• Edit Multiple Blocks: by shift-clicking or cmd-clicking to select multiple blocks, and then right click to show the multi-block Action options, then select "Edit". The Edit Block Attributes screen will display.
  

For more information on assigning and managing blocks, see Working with IP Blocks - Assigning IP Space.