Read Entry

This LDAP tool retrieves specified attributes from a specified LDAP Directory Services entry. It then creates a handle to that entry that you can pass to the Get Entry Attribute tool. See Introduction to LDAP tools for more information on using this tool.

Inputs

Session ID

The unique identifier for the session created with the Session tool.

EntryDN

The distinguished name (DN) of the entry this tool will operate on. For example, you might use: uid=JDoe, ou=subscribers, ou=People, dc=inin, dc=com

Contact your LDAP administrator for information regarding the entry location syntax for your LDAP directory information tree.

Attributes

A list of string value containing the names of the attributes you want to retrieve. Leave this field blank to retrieve all attributes. You might use the Parse String tool to generate the list of attributes.

Timeout

The amount of time to wait before taking the Failure exit path.

Outputs

Entry

The handle to the entry. You can pass this handle to the Get Entry Attribute tool to extract the values of one of the attributes this tool acquired.

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.