Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

On In this Pagearticle

Table of Contents
maxLevel2
excludeOlder Versions|Additional Resources|Related Links|Related Information

Snap type:

Write

Description:

The Update Entry Snap updates an entry in Active Directory. An entry (user Account) can be updated in any Organizational Unit (OU), Domain Controller (DC), etc.

The attributes of table will create on suggest based on the existing distinguished name into Active Directory. The table consists of all the fields that needs to be updated.

To generate the suggested attributes into the table the existing distinguished name is required.

  • Expected upstream Snaps: Upstream Snap can be given. File reader followed by any file parser  followed parser followed by Structure.
  • Expected downstream Snaps: Any file Formatter followed by File Writer.
  • Expected input:   Existing Existing distinguished name, Entry attributes(Attribute keys, Attribute values)
  • Expected output:  This This Snap will give the output data as status of updated entry.
Prerequisites:

[None].

Support and limitations:

Works in Ultra Task Pipelines.

Account: 

This Snap uses account references created on the Accounts page of SnapLogic Manager to handle access to this endpoint. See Active Directory Basic Auth Account for information on setting up this type of account.

Views:


InputThis Snap has exactly one document input view.
OutputThis Snap has exactly one document output view.
ErrorThis Snap has at most one document error view and produces zero or more documents in the view.


Settings

Label

Required. The name for the Snap. You can modify this to be more specific, especially if you have more than one of the same Snap in your pipelinePipeline.

Existing distinguished name


Required. The LDAP API references an LDAP object by its distinguished name (DN). A DN is a sequence of relative distinguished names (RDN) connected by commas. An RDN is an attribute with an associated value in the form attribute=value, normally expressed in a UTF-8 string format.   The typical RDN attribute types include: 

DC = domainComponent, CN = commonName, OU = organizationalUnitName,O = organizationName, STREET = streetAddress, L = localityName,ST = stateOrProvinceName, C = countryName, UID = userid.

This field is applicable only to existing users. If the user does not exist, create an entry using the Create Entry Snap first.

ExampleA distinguished name for an LDAP entry can be represented as: 

CN=AbcUser,CN=Users,DC=server,DC=company,DC=com. 

In this example, to refer to the entire user list, you can remove the initial attribute, CN=AbcUser.

Default value: [None]

You can also use special characters in the distinguished name. See the section Using Special Characters in Distinguished Name below.

Attribute Value Delimiter

Character or string to be used as delimiter to separate multiple values provided to the Attribute Value field.

Example,(Comma), ;(Semi-colon),  :(Colon),  /(Backslash)

Default value:  [None]

Entry attributes

Required. The table of suggested attribute key-value pairs to create the entry. Consists of two fields:

  • Attribute Key
  • Attribute Value
Attribute Key

Required. Attribute keys to create the entry.

Note

Some of the attribute keys and its values may require to create the entry. For example: objectClass, DistinguishedName.

Default value: [None]

Attribute Value

Required. Value of the attribute. Its expression.

Note

Some of the attribute values corresponding to their keys require to create the entry For example: value of the key objectClass as 'top, user, organizationalPerson' and the value of the key DistinguishedName as 'CN=SomeUser, CN=Users, DC=child, DC=parent, DC=Domain, DC=com'.


Note

Space is considered to be a string in attribute when using a multi-value attribute.

Default value: [None]

Entry attributes


Required. The table of attribute key-value pairs to update the entry.

Attribute keys: The suggested attributes based on the provided Existing distinguished name property.
Attribute values: The corresponding values of the suggested key to update the entry.

Pass through

Select to include the entire input data in the Snap's output. The Snap includes this data within the $original field in the output. 

Default value: Not selected

Multiexcerpt include macro
nameSnap Execution
pageSOAP Execute

Multiexcerpt include macro
nameExecution_Detail_Write
pageSOAP Execute


Examples

Excerpt Include
Active Directory Add Member
Active Directory Add Member
nopaneltrue

Excerpt Include
Active Directory Snap Pack
Active Directory Snap Pack
nopaneltrue