Table of Contents

Search

  1. Preface
  2. Understanding PowerExchange for LDAP
  3. PowerExchange for LDAP Configuration
  4. LDAP Sources and Targets
  5. LDAP Mappings
  6. LDAP Sessions
  7. Appendix A: LDAP Datatype Reference
  8. Appendix B: Error Messages
  9. Appendix C: Glossary

PowerExchange for LDAP User Guide for PowerCenter

PowerExchange for LDAP User Guide for PowerCenter

Configuring the Update Strategy

Configuring the Update Strategy

Each group in the target definition contains an attribute that determines the update strategy for the rows in that group. Configure the update strategy attribute in the mapping to specify the operation that you need to perform on the rows. You can perform INSERT, UPDATE, and DELETE operations on the rows. The default is INSERT.
The following table lists the valid values for the update strategy field for the parent group:
Operation
Value
INSERT
0
UPDATE AS UPDATE
1
DELETE
2
UPDATE ELSE INSERT
3
If you specify an invalid value for this field, the PowerCenter Integration Service treats the invalid value as INSERT. If you mark an entry for INSERT, the PowerCenter Integration Service treats the entry as INSERT. If the entry exists, the PowerCenter Integration Service writes an error into the session log. The session fails if the error count reaches the error threshold.
At the session level, the PowerCenter Integration Service ignores the value of the Treat Source Rows As property.
For child rows, an update operation is treated as replace. If a child row is marked for update, all values for the multi-valued attribute are replaced with the updated values. UPDATE AS UPDATE and UPDATE ELSE INSERT are skipped for child rows.
For example, consider an entry with a@infa.com mail attribute. You can add b@infa.com and c@infa.com as another mail attributes. As the child rows are marked for update, the entries b@infa.com and c@infa.com child rows will be marked for update. The rows in the target are replaced with b@infa.com and c@infa.com.
To reflect the changes made in the target, the PowerCenter Integration Service replaces the child rows marked for update with the changed values.
The following table lists the valid values for the update strategy for child group:
Operation
Value
INSERT
0
REPLACE
1
DELETE
2
REPLACE
3
The naming convention for the update strategy field is Update_Strategy_<group_name>. The Parent_Group group contains the Update_Strategy_Parent_Group field, the ou group contains the Update_Strategy_ou field, and the mail group contains the Update_Strategy_mail field.
The following table shows the sample rows in the source ParentGroup_src:
GPK__Parent_Group
Update Strategy
displayName
employeeNumber
1
0
Emanuell Lott
2678
1
0
John Walker
1253
The following table shows the sample rows in the source ou_src:
GPK__ou
GFK__Parent_Group__ou
Update_Strategy_ou
ou
1
1
0
Human Resources
2
1
0
People
3
2
0
Accounting
4
2
0
Product Development
The following table shows the sample rows in the source mail_src:
GPK_mail
GFK_Parent_mail
UpdateStrategy
mail
1
1
0
elott@airius.com
2
1
0
emanuel@gmail.com
3
1
0
elott@rediffmail.com
4
2
0
jwalker@airius.com
5
2
0
johnwalke@gmail.com
In this example, each source represents a group in the target definition. To maintain key relationships when you connect mapping objects, connect the source columns to the corresponding group in the target definition.
The PowerCenter Integration Service fails the session if you change the order of the groups or columns in the target definition.
The following table lists the column relationships between the source definitions and the groups in the multi-valued target definition:
Source Name
Source Column Name
Multi-Valued Group Name
Target Column Name
ParentGroup_src
GPK_Parent
Parent_Group
GPK__Parent_Group
ParentGroup_src
displayName
Parent_Group
displayName
ParentGroup_src
employeeNumber
Parent_Group
employeeNumber
mail_src
GPK_mail
mail
GPK__mail
mail_src
GFK_Parent_mail
mail
GFK__Parent_Group__mail
mail_src
mail
mail
mail
ou_src
GPK_ou
ou
GPK__ou
ou_src
GFK_Parent_ou
ou
GFK__Parent_Group__ou
ou_src
ou
ou
ou
The PowerCenter Integration Service inserts the following rows into the target definition:
[Parent (Emanuel Lott, 2678, ou (Human resources, People), mail (elott@airius.com, emanuel@gmail.com, elott@rediffmail.com)] [Parent (John Walker, 1253, ou (Accounting, Product Development), mail (jwalker@airius.com, johnwalker@gmail.com)]
If the DN field is linked and is configured as the primary key for the target, the entry is inserted according to the DN value for the field.
DN = Primary key value + Base DN
For example, the base DN value for the LDAP target is ou=People, o=airius.com, and cn is selected as the primary key. If the value for the cn attribute is John, the DN value of the inserted entry is cn=John, ou=People, o=airius.com. Otherwise, the entry is inserted under the base DN selected for the target definition.

0 COMMENTS

We’d like to hear from you!