7.7 Working with Entity Activities

You use Entity activities to update entities in the Identity Vault. The procedures for working with Entity activities differ slightly from the procedures for working with other activity types.

The section includes the following topics:

7.7.1 Adding or Modifying an Entity

  1. From the Workflow page, click the Entity activity icon in the palette, then click the canvas to insert the Entity activity into the workflow.

  2. Click the Properties tab.

  3. Click in the Value column of the Entity Type field, then select the Entity Type (for example, User, Group) that you want to create or modify. If the target object that you specify in Step 6 already exists, the target object is modified; if the target object doesn't exist, it is created.

  4. Click in the Value column of the Operation field, then select Create/Modify.

  5. Click the Data Item Mapping tab.

  6. Click the button next to the Entity dn field to display the ECMA expression builder, then specify an expression that identifies the target of the operation (for example, “recipient”).

  7. Click OK to return to the Data Item Mapping view.

  8. Specify expressions for other attributes as required to create the Entity.

    See Section 3.2, Working with Entities and Attributes for information about adding entities. If you are adding an entity, you must enter expressions for all required attributes.

7.7.2 Using an Entity Activity to Delete an Entity

  1. From the Workflow page, click the Entity activity icon in the palette, then click the canvas to insert the Entity Activity into the workflow.

  2. Click the Properties tab.

  3. Click in the Value column of the Entity Type field, then select the Entity Type (for example, User, Group) to which the entity that you want to delete belongs.

  4. Click in the Value column of the Operation field, then select Delete entity.

  5. Click the Data Item Mapping tab.

  6. Click the button next to the Entity dn field to display the ECMA expression builder, then specify an expression that identifies the Entity that you want to delete.

  7. Click OK to return to the Data Item Mapping view.

7.7.3 Using an Entity Activity to Delete an Attribute or Value

  1. From the Workflow page, click the Entity activity icon in the palette, then click the canvas to insert the Entity activity into the workflow.

  2. Click the Properties tab.

  3. Click in the Value column of the Entity Type field, and select the Entity Type (for example, User, Group) of the entity to which the attribute or value that you want to delete belongs.

  4. Click in the Value column of the Operation field, and select Delete attribute/value.

  5. Click the Data Item Mapping tab.

  6. Click the button next to the Entity dn field to display the ECMA expression builder, then specify an expression that identifies the entity that contains the attribute or value that you want to delete.

  7. Click OK to return to the Data Item Mapping view.

  8. Click in the Delete Type field for the attribute to which you want the operation to apply, then select the operation from the list:

    • Select Delete Attribute for single-value attributes

    • Select either Delete Attribute or Delete Value for multi-value attributes. Selecting Delete Value for multi-value attributes also requires that you enter an expression to identify the value that you want to delete.

  9. To delete a value, click in the Delete Value Expression field for the attribute to which you want the operation to apply, then specify an expression that resolves to the value of the attribute that you want to delete.