Get Group Members (MS Azure Active Directory) activity

An activity that gets information about the users who are members of an Microsoft Azure Active Directory group.


Get Group Members activity

Configure the Get Group Members activity

To configure the Get Group Members activity, do the procedure in this topic.

Prerequisites

Good to Know

How to Start

  1. Open Process Builder.

    For information about how to open this screen, refer to Process Builder.


    Open Process Builder
  2. In Process Builder, in the Activity Library, open the MS Azure Active Directory tab.

    Open MS Azure Active Directory tab
  3. On the MS Azure Active Directory tab, drag the Get Group Members activity onto your process.

    Drag Get Group Members activity

General Configuration

Specifies the basic settings for the Get Group Members activity.

Figure: General Configuration screen

General Configuration screen

Fields

Field NameDefinition

Display Name

Function:
Specifies the activity name that shows in your process.
Accepted Values:
One line of text that can have spaces.
Default Value:
None
Accepts Process Data Variables:
No
Example:
This is a common configuration field that is used in many examples. Refer to:
  • Examples - Step-by-step use case examples, information about what types of examples are provided in the AgilePoint NX Product Documentation, and other resources where you can find more examples.

Description

Function:
Specifies an optional text description for your activity.
Accepted Values:
More than one line of text.
Default Value:
None
Accepts Process Data Variables:
No

Connection Timeout (Seconds)

Function:
Specifies the number of seconds permitted to complete an action before the connection stops.
Accepted Values:
An integer, representing a number of seconds.
Default Value:
600
Accepts Process Data Variables:
No

Get Group Members Configuration screen

Specifies the configuration to get the information about users from a Microsoft Azure Active Directory group.

Figure: Get Group Members Configuration screen

Get Group Members Configuration screen

Fields

Field NameDefinition

MS Azure Active Directory

Function:
Specifies the access token that connects to your Microsoft Azure Active Directory.
Accepted Values:
A list of access tokens configured for your environment.
Default Value:
None
Accepts Process Data Variables:
No

Create Add Token icon

Opens this Screen:
Access Token for Microsoft Azure Active Directory
Function of this Screen:
Configure an access token to connect to Microsoft Azure Active Directory.

Group Name or ID

Function:
Specifies the name of the Microsoft Azure Active Directory group from the list or a process data variable that stores the group name or ID.
Accepted Values:
A Microsoft Azure Active Directory group name or ID.

When you select the access token from the MS Azure Active Directory field, a list of group names shows in this field.

Default Value:
None
Accepts Process Data Variables:
Yes

Map Response to AgilePoint Schema

Function:
Specifies the connection from the Microsoft Azure Active Directory API response parameter to your process schema.
Accepted Values:
Click the Schema Mapping Schema Mapping icon button to open the Schema Mapper screen.

Use this screen to connect the response to the data model for your process.

Default Value:
None
Example:
Refer to: