Add Group Members Smart Service

This node allows you to add a user (or users) to a group as a step in your process.

CAUTION: The Add Group Members Service Node can only be executed by a System Administrator, or by Administrators of the group in which new members are being added. If this task is assigned to any other user, a run-time exception is thrown and the process will be paused when that user attempts to submit the task generated by this node.

It is found under Appian Service Nodes > Identity Management in the process modeler. To use the Add Group Members Node click the node and drag it onto the canvas. Right-click on the designer canvas and select "Properties". The "Configure Add Group Members" dialog box is displayed. Or, double-click the node.

Properties

  • Category: Identity Management

  • Icon:

  • Assignment Options: Attended/Unattended

Configuration Options

This section contains tab configuration details specific to this smart service. For more information about common configurations see the Process Node Properties page.

Data Tab

This tab displays all the inputs and outputs for the node. You can add additional input and outputs, if needed.

The default inputs for this node are:

Input Type Required Multiple
Choose New Members People Yes Yes
Choose Group Group Yes No

TIP: When the Add Group Members node is run as an attended node, you will not be able to specify a value for any of the node inputs through the "Data" tab. Users can however, specify default values for form elements through the "Forms" tab.

a!addMembersToGroup()

The Add Group Members smart service is available as an expression function that can be executed inside a saveInto on a Interface Component or as part of a Web API.

Syntax

a!addMembersToGroup(group, newMembers, onSuccess, onError)

Inputs

  • group (Group): The group to which the new members will be added.
  • newMembers (List of User or Group): The users and groups that will be added as members.
  • onSuccess (Any Type): A list of saves or an HTTP response to execute after the smart service executes successfully. Created with a!save() or a!httpResponse().
  • onError (Any Type): A list of saves or an HTTP response to execute when the smart service does not execute successfully. Created with a!save() or a!httpResponse().
FEEDBACK