This tutorial shows how you can integrate PixieBrix and AARI to perform two types of actions:

The example in this tutorial involves employee onboarding, where an HR manager creates an AARI request to provision IT accounts from Jira.

Here’s a step-by-step video to accompany the written tutorial:

We use Jira’s issue tracking software for this tutorial. If you don’t have a Jira account, you can try using another web page as a starting point, as the steps to integrate PixieBrix and AARI are the same no matter what web app you’re working with.

Here’s our example Jira ticket:

In Part 1, we’ll learn how to extract details from a Jira ticket, and send them off to an Automation Anywhere form in just a few clicks.

In the Page Editor, add a new Quick Bar item.

Configure the Quick Bar as follows:

Navigate to the Automation Anywhere Community edition login portal.

For me it’s https://community.cloud.automationanywhere.digital/

Login and go to the “Automation” tab

Now you can save the form by clicking the save button in the top right.

Navigate back to the Automation tab using the left hand sidebar.

Next, we’ll extract the JIRA issue ID from the page using the Extract from Page brick

After adding this brick, use the selector to highlight the issue ID.

When I highlight PIXI-149, I get the following selector:[role="presentation"] > li > a > span

Finally, change the property name to issueId so you can easily reference it later.

The Page Editor should look like this

Next add the Show a modal or sidebar form brick

Configure it like this:

Then under the form settings, below the “add new field” blue button.

Once again, after configuring the second field, go ahead and add a new field by using the “Add new field” blue button

Next, we need to pass the information from the PixieBrix Form Modal to Automation Anywhere. To achieve this add the Create AARI request brick.

This brick requires us to add inputs for our form fields.

To do this click the Add Item button. We’re prompted to specify an input name and string

Let’s add a second input, click the blue button again

Let’s add a third input, click the blue button again

Next, we’ll add the Control Room integration in the Service dropdown.

To make the integration available, you first need to configure it in the PixieBrix mod options.

To complete this step, refer to the documentation

Finally, we’ll add the processId.

To find the processId, go to the AAI Control Room Automation tab.

Click on Provision IT Account - Process and then the Run button (top right).

A new tab opens. The processId is in the URL after processInfoId=. In this example it’s 973

In Part 2, we’ll create a second mod that calls the Control Room API and displays AARI requests data in the PixieBrix Sidebar panel.

In this step we’re going to add a new mod. We’ll add a sidebar panel to track the status of our Automation Anywhere processes

Just like we did before, we want to grab the JIRA issue ID from the page. To do that we can use the PixieBrix brick called Extract from Page.

Let’s add this brick to our mod.

Select your JIRA issue and use the selector interactive menu to highlight the top of the ticket where the ID is specified.

In my case, it’s looking like this.

First I changed the Property name to ticketId.

Secondly, I use this selector as the Value:[role="presentation"] > li > a > span

Next, add the List AARI Requests brick.

For piiTag, use the value from the previous brick @data.tickedId

For Service, use the same service that you configured earlier in this tutorial.

Next, add the Render Document brick. This brick allows us to populate the sidebar with data.

In this step, we’ll remove unwanted elements from the Render Document brick, and add a Header or title to our Sidebar.

Select the penultimate box as shown in the picture above (blue outline). Then click Remove element. This will remove the boxes we don’t need for this tutorial. Once you remove them you will have nothing left except the body box.

Next, click the three-dot menu and add a Header 1. You can call the header AARI Requests

In this step, we’ll add and configure a List component, which allows us to organize an array of results in the sidebar.

Go on the three dot menu again and add a List.

In a List, you can specify an Array, an Element Key and an Item Type.

Let’s set these up now!

In this step, we’ll configure the Card’s header with two variables, which will return the name and status of the AARI request.

Click the inside of the element (notice the blue outline). You will see a new configuration appear in the middle of the Page Editor in the Mod Configuration Panel.

Here we want to set the heading field:

This takes the output from the previous brick and maps it to a single key called @element from which we can extract title and status, individually.

In this step, we’ll add a button to refresh the content in the Sidebar.

Click the three dot menu from the top-most container and add a button.

Next, click the blue Action button in the Preview panel. You will see a lot of options appear in the middle of your screen!

Let’s configure it like this:

Next, click the “Select a Brick” button (below the fields).

Search and select the “reactivate all” brick. This will add the brick @pixiebrix/reactivate as the action when you click the Refresh blue button.

In this step, we’ll add a button to open the AARI

This time we’re going to add a button inside the Card element. Select the box highlighted in blue and click the three dot menu inside it.

From the dropdown select button.

Once you’ve added a button, click it.

Once again we’re presented with the button configuration view. Change the following settings:

Next, click the “Select a Brick” button (below the fields)

Search and select the “Open a new tab” brick. This will add the brick @pixiebrix/browser/open-tab as the action when you click the Open in AARI blue button.

We’re presented with the button configuration view. Change the following settings:

In this FINAL step, we’ll add the createdOn time to each Card item to help us tell each AARI request apart.

We’ll add a text field inside the Card element.

Select the Card item and click the three dot menu inside it. Then select Text from the dropdown.

Once you’ve added a Text element, click it.

We’re presented with the Text configuration view. Change the following settings: