102 - Building a Basic Workflow

Introduction

Hello and welcome! In this tutorial, we'll guide you through the process of creating automated workflows using Rewst. Our focus will be on creating a form, building an MVP workflow, and connecting the two with a trigger. Follow these steps to build the Add or Remove Users from AD workflow!

When you've completed this training, don't forget to get credit!

Watch the video and follow along with the steps below

Get Credit

To get credit for completing this session offline, please submit this form.

Follow Along

Part 1: Build a Form to Add or Remove Users in AD

We'll start by creating a form to collect the necessary information to pass to the workflow. First, we'll go to the Forms section in Rewst. Next, we'll design the form with fields, and configure the fields to dynamically show us a list of users and groups. And finally, we'll define which variables can be accessed from the workflow for each field. Follow these steps:

Steps: Building a Form

Add a Form

Go to Automations → Forms in the menu.
Click Add at the top right to add a new Form.
Type Add or Remove from AzureAD Group for the name.
Click Submit.

Add a Dropdown field to Choose a User

Drag and Drop a Dropdown field.
Click on the field to open the field settings.
Type "user_id" for the Field Name.
Replace the default Field Label text with "User".
Type "Choose a User" for the Field Description text.
Click the Required checkbox.
Click on the Dynamic Options slider.
Choose Microsoft Graph for the Integration dropdown.
Choose Users for the Resource dropdown.

Add a Dropdown field to Choose a Group

Drag and Drop a Dropdown field.
Click on the field to open the field settings.
Type "group_id" for the Field Name.
Replace the default Field Label text with "Group".
Type "Select a Group" for the Field Description text.
Click the Required checkbox.
Click on the Dynamic Options slider.
Choose Microsoft Graph for the Integration dropdown.
Choose Groups for the Resource dropdown.

Add Radio Buttons to identify whether to add or remove users

Drag and Drop a Radio Buttons field.
Click on the field to open the field settings.
Type "action" for the Field Name.
Replace the default Field Label text with "Add or Remove".
Click the Required checkbox.
Type "Add" for the first Option Label.
Type "Remove" for the second Option Label.
Click on the minus (-) button to remove the third option.
Type "add" for the first Option Value.
Type "remove" for the second Option Value.

Save the form

Click the Save button at the top right of the form builder.
Click Submit on the pop-up to confirm.

Part 2: Build a Workflow to Add or Remove Users in AD

Next, let's design a workflow that responds to the form submissions. We'll start by going to the Workflow section in Rewst and adding a new workflow. Then, we'll add the actions, including MS Graph actions, to the workflow. Finally, we'll implement transitions based on whether a user is added or removed from a group.

Steps: Creating a Workflow

Create a New Workflow

Go to Automations → Workflows in the menu.
Click Create at the top right to add a new Workflow.
Type Add or Remove User from AzureAD Group for the name.
Click Submit.

Add the Initial Workflow Actions

Open the Core section in the left Actions menu.
Drag and Drop the noop action to the Workflow Canvas.
Open the Microsoft Graph section in the left Actions menu.
Drag and Drop the Add Group Member action to the Workflow Canvas.
Click and Drag the transition from the noop action to the Add Group Member action.
- To do this, you will need to hover over the gray circle under the On Success section of the noop action.

Configure the Noop

Click on the noop Action to open the properties.
Click the edit icon next to the noop name.
Type "add_or_remove" for the name.
Type "Checks the action variable to determine if we are adding or removing a user from a group" for the Description.

Configure the Transition

Click on the transition on the noop Action.
Type "Add" in the Custom Label field.
Click on the Custom Condition option under Condition.
Click on the Jinja editor button next to the Custom Condition field.
Type the following to add a custom condition where the action is performed on "add".

{{ CTX.action == "add" }}

Close the editor.

Configure the Workflow Variable Inputs with the Form Variables

Click on the Configure Workflow Variable button in the top right menu.
- This is the pencil icon.
Type "300" in the Time Saved (seconds) field.
Click the plus (+) button next to Input Configuration to add the user variable.
Type "user_id" in the name field.
Click the Required checkbox.
Click the plus (+) button next to Input Configuration again to add the group variable.
Type "group_id" in the name field.
Click the Required checkbox.
Click the plus (+) button next to Input Configuration again to add the action variable.
Type "action" in the name field.
Click the Required checkbox.
Click Submit.

Part 3: Triggering the Workflow with the Form

Next, we'll add a Form trigger to the workflow to ensure that the information that comes through the form can kick off the workflow process.

Steps: Triggering the Workflow with the Form

Add a Form Trigger

Click the Add Trigger button at the top menu.
Type "Form Trigger" in the Name field.
Click the Enabled slider.
Choose Core - Form Submission for the Trigger Type.
Choose Microsoft Graph for Integration Overrides.
Choose the Add or Remove User from AzureAD Group form under Trigger Parameters → Form.
Click Submit.
Click Publish to save the Workflow with the new Trigger.

Part 4: Configuring the Add and Remove Graph Actions

We jumped ahead to show how to trigger a workflow with a form. We now are going back to set the parameters needed for the actions to add or remove a user from a group.

Steps: Finishing the Workflow

Add a Second Transition

Click the Add (+) button on the noop action to add a new transition.
Click and Drag the transition from the noop action to the Remove Group Member action.
- To do this, you will need to hover over the gray circle under the new On Success section you added.

Configure the Remove Transition

Click on the right transition on the noop Action.
Type "Remove" in the Custom Label field.
Click on the Custom Condition option under Condition.
Click on the Jinja editor button next to the Custom Condition field.
Type the following to add a custom condition.

{{ CTX.action == "remove" }}

Close the editor.

Set the Transitions to Follow First

Click the noop Action, now named "add_or_remove".
Click on the Advanced section at the bottom.
Click Follow First under Transition Mode.
Click Publish to save the Workflow.

Add and Configure the Remove Group Member Action

Open the Microsoft Graph section in the left Actions menu.
Drag and Drop the Remove Group Member action to the Workflow Canvas.
Click the Remove Group Member Action.
Type "Removing user from Group" in the Description field.
Click on the Jinja editor button next to the Group field.
Type the following to to reference the group_id input variable with Jinja:

{{ CTX.group_id }}

Close the editor.
Click on the Jinja editor button next to the User ID field.
Type the following to to reference the user_id input variable with Jinja:

{{ CTX.user_id }}

Close the editor.

Configure Add Group Member Action

Click the Add Group Member Action.
Type "Adding user to Group" in the Description field.
Click on the Jinja editor button next to the Group field.
Type the following to to reference the group_id input variable with Jinja:

{{ CTX.group_id }}

Click on the Jinja editor button next to the User ID field.
Type the following to to reference the user_id input variable with Jinja:

{{ CTX.user_id }}

Part 5: Check the Results

Finally, let's test out the workflow by filling out the form and checking the workflow results!

Steps: Testing the Workflow

⚠️ This will only work with live data If you are using Microsoft Graph, make sure you keep in mind that this will work with live data so you can add or remove users appropriately. It's best to have pretend data to work with.

View the Form URL

Click Edit Trigger at the top menu next to our Form Trigger
Click the View Direct URLs button next to Dynamic Form URL.
Click on the link.

Test the Form

Choose a User.
Choose a Group.
Click Add or Remove.

View the Results of the Workflow

Go to view results for workflow.
- This can be found next to the name of the workflow in the top menu.
Click on Succeeded under Status to see the full results.

📝 If the user or group aren't valid, you may see failure. To troubleshoot, you can open the Context, Logs, or Input sections to dig into more detail and see what happened.

Conclusion

Congratulations! You have successfully created a form, designed a workflow, and connected the two with a trigger to automate Azure AD group management. In Rewst 103, we'll take a step back and look at using Jinja in our workflows. If you have any questions, don't hesitate to reach out. Happy automating!

Additional Resources

For more information on using Forms, Workflows, and Triggers, check out our documentation:

Need more guidance?

Rewst 102

Building A Basic Workflow

Cluck U Office Hours

Come and Get Help!

Last updated 6 days ago