Home | Table of Contents | LDAPWriter | CloverETL 4.6.1
--- | --- | ---
Prev | Writers | Next

## LDAPWriter

# Not available in Community Designer

Short Description
Ports
Metadata
LDAPWriter Attributes
Details
See also

### Short Description

LDAPWriter writes information to LDAP directory.

It provides the logic to update information on LDAP directory. An update can be add/delete entries, add/replace/remove attributes. Metadata must match LDAP object attribute name. "DN" metadata attribute is required.

Component | Data output | Input ports | Output ports | Transformation | Transf. required | Java | CTL | Auto-propagated metadata
--- | --- | --- | --- | --- | --- | --- | --- | ---
LDAPWriter | LDAP directory tree | 1 | 0-1 |  |  |  |  |

### Icon

### Ports

Port type | Number | Required | Description | Metadata
--- | --- | --- | --- | ---
Input | 0 |  | For correct data records | Any
Output | 0 |  | For rejected records. If rejected port connected then input records rejected by LDAP server get copied to output with fields with autofilling "ErrText" populated with error message. | Input 0

### Metadata

LDAPWriter does not propagate metadata.

LDAPWriter has no metadata template.

Metadata on the input must precisely match the LDAP object attribute name. The Distinguished Name metadata attribute is required. As the LDAP attributes are multivalued, their values can be separated by pipe or specified separator. String and byte are the only metadata types supported.

### LDAPWriter Attributes

Attribute | Req | Description | Possible values
--- | --- | --- | ---
Basic
LDAP URL | yes | LDAP URL of the directory. Can be a list of URLs separated by pipe. | pattern: `ldap://host:port/`
Action |  | Defines the action to be performed with the entry. | replace_attributes (default) | add_entry | remove_entry | remove_attributes
User |  | User DN to be used when connecting to the LDAP directory. Similar to the following: `cn=john.smith,dc=example,dc=com`. |
Password |  | Password to be used when connecting to the LDAP directory. |
Advanced
Multi-value separator |  | LDAPWriter can handle keys with multiple values. These are delimited by this string or character. <none> is special escape value which turns off this functionality, then only first value is written. This attribute can only be used for string data type. When byte type is used, first value is the only one that is written. | "|" (default) | other character or string
Fields to ignore |  | A semicolon-separated list of fields not to be sent to LDAP. For example, an ignored field which is optionally populated with error message when sent out. |
Binary attributes | no | List of field names containing binary attributes. By default, the objectGUID is added to list of binary attributes. | e.g. objectGUID
LDAP Connection Properties | no | Java Property-like style of key-value definitions which will be added to LDAP connection environment. |

### Details

`String`, `byte` and `cbyte` are the only metadata types supported. Most of the LDAP types are compatible with clover string, however, for instance, the `userPassword` LDAP type is necessary to populate from byte data field. LDAP rules are applied : to add an entry, required attributes (even object class) are required in metadata.

| Note
LDAP attribute may be multivalued. The default value separator is "|" and is reasonable only for string data fields.

##### Multivalue fields

LDAP attributes may be multivalued. It depends on the input field type how multi values are handled. If Single type, then separator in the field's value may be used. If List, then each item from the list becomes one value of an attribute. Only String and (C)Byte field types are supported, both in Single and List container types. If input data/record contains Map<String> field, then keys are mapped on attribute names and values become attribute values. In case of value string with "multiValueSeparator" (if defined) then such value is first split into individual items which then become attribute's multivalues.

### See also

LDAPReader
Common Properties of Components
Specific Attribute Types
Common Properties of Writers
Writers Comparison

Prev | Up | Next
JSONWriter | Home | Table of Contents | LotusWriter