Add Operation

This LDAP tool creates an LDAP operation and adds it to the operation list for execution with the Add Entry Ex or Modify Entry Ex tools. Operation lists are useful in LDAP because they allow you to perform multiple operations on multiple LDAP entries over one connection. For example, a caller might choose to modify their password and change several other personal settings through an IVR. The handler could add all of these operations to a list, and then execute them. You must specify an integer for the type of operation to perform. You must also specify an attribute to operate on and optionally an attribute value to use (with add and modify operations.) See Introduction to LDAP tools for more information on using this tool.

Note: If you are creating an operation list for the Add Entry Ex tool, you may only specify Add operations. This is because Add Entry Ex should only be used to created entries that contain multi-valued attributes.

Inputs

Operation List

The operation list to which the operation should be added. If you do not specify an operation list, one is created for you. The operation name is then available from the output Operation List parameter.

Operation

The type of operation to add to the operation list.

Note: If you are creating an operation list for the Add Entry Ex tool, you may only specify Add operations. This is because Add Entry Ex should only be used to created entries that contain multi-valued attributes.

Refer to the following table:

0=Delete Attribute. If the logged in user has permissions, this operation deletes all values for the specified attribute. Do not use this operation in an operations list created for the Add Entry Ex tool.

1=Add Attribute. If the logged in user has permissions, this operation adds another value to the attribute. This operation allows you to create multi-valued attributes. For example, if the attribute foo contains the values "A" and you add the value "C," foo's value will be "A" and "C" after this operation.

2=Replace attribute  replaces one or more existing attribute values with the attribute value that you specify. For example, if the attribute foo contains the values "A" and "B" and you replace them with "C", foos value will be "C" after this operation. Do not use this operation in an operations list created for the Add Entry Ex tool.

Attribute

Specify the attribute to operate on.

Values

For Add and Modify operations, specify the attribute values to use when changing the entry. For delete operations you should not specify a value.

Outputs

OperationList

If you did not specify the name of an operation list in the Operations List input parameter, this is the name of the operation list that was created for you. You will need this operation list when executing the list with the Add Entry Ex or Modify Entry Ex tools.

Error Code

The code associated with a processing error.

Error Message

A string description describing the error that occurred.

Error Native

A string description of an error that occurred in the LDAPLib module that connects this CIC server to your LDAP Server.

Exit Paths

Success

This step takes the Success of the operation completed successfully.

Failure  

This tool takes the Failure exit path if an error occurred. Examine the output error text to determine the problem.