1. ® IBM Tivoli Directory Integrator Tivoli Directory Integrator Exercise 2 – Mapping to inetOrgPerson Eddie Hartman eddie.hartman@no.ibm.com 2005.04.12 eddie.hartman@no.ibm.com ®

2. IBM Tivoli Directory Integrator 2 Exercise 01: CSV to XML CSV File XML Document FileSystem Connector w/ CSV Parser FileSystem Connector w/ XML Parser 1.Create AL (CSVtoXML) 2.Add Connector to read CSV (configure, discover & map) NOTE: Semi-colon separator (;) 3.Add Connector to write XML 4.Run AL and view results

3. IBM Tivoli Directory Integrator 3 Kernel/component architecture CSV File XML Document Each Connector has its own Connector Interface that is built to handle a specific protocol, API, transport or format. These are interchangeable, making it fast and easy to point your AssemblyLine at different data sources. The kernel provides common, generic functionality for all Connectors. This is where all customization is carried out (like Attribute Maps and scripting). This is the AssemblyLine Connector.

4. IBM Tivoli Directory Integrator 4 The Entry object CSV File XML Document The Entry object is the data carrier in an AssemblyLine. The primary Entry is the Work Entry which is used to move data down the flow. This object is accessed via the pre-registered script variable called "work". Each Connector has its own local Java bucket (called its Conn Entry) which is used as a local cache for reads & writes, and which available through the script variable "conn". Attribute_1 value_a value_b Attribute_2 value_c Attribute_n... Flat Schema: Entries can hold Attributes. Attributes can have values.

5. IBM Tivoli Directory Integrator 5 AL Lifecycle - Phase One: Initialization CSV File XML Document All Connectors bind to their data sources. XML Document CSV File

6. IBM Tivoli Directory Integrator 6 AL Lifecycle - Phase Two: Cycling (Read) CSV File XML Document AL automation powers the first Connector to read from the input file, passing the byte stream through the CSV Parser. The CSV Parser turns the byte stream into a series of Attributes, each with a single string value. Attributes are put in the Conn Entry.

7. IBM Tivoli Directory Integrator 7 AL Lifecycle - Phase Two: Cycling (Input Map) CSV File XML Document The Input Map of our first Connector specifies which Attributes are to be created in the Work Entry. The Input Map also specifies how the values of these new Work Entry Attributes are copied or computed based on those stored in the Conn Entry.

8. IBM Tivoli Directory Integrator 8 AL Lifecycle - Phase Two: Cycling (Output Map) CSV File XML Document The Work Entry is passed to our output Connector, where the Attributes to write are specified in its Output Map. Attribute values are now copied/computed the opposite direction: from the Work Entry to the Conn Entry.

9. IBM Tivoli Directory Integrator 9 AL Lifecycle - Phase Two: Cycling (Write) CSV File XML Document The output Connector performs the write operation using the Attributes in its Conn Entry.

10. IBM Tivoli Directory Integrator 10 AL Lifecycle - Phase Two: Cycling (Repeat...) CSV File XML Document When the end of the AssemblyLine is reached, AL automation empties the Work Entry and passes control back to the start again. Cycling repeats as long as there is data to process, or until the AL is terminated by command or aborts due to unhandled errors.

11. IBM Tivoli Directory Integrator 11 AL Lifecycle - Phase Three: Shutdown CSV File XML Document When the cycle phase stops, the Connectors close their connections.

12. IBM Tivoli Directory Integrator 12 Exercise 01: CSV to XML CSV File XML Document Address City Department Status FirstName LastName State Title EmployeeNumber Zip Simple mapping

13. IBM Tivoli Directory Integrator 13 Exercise 02: CSV to XML (inetOrgPerson) CSV File XML Document Address City Department Status FirstName LastName State Title EmployeeNumber Zip street l ou employeeType givenName sn st title uid postalCode cn mail objectClass dn Advanced mapping Simple mapping

14. IBM Tivoli Directory Integrator 14 Exercise 02: CSV to XML (Computed values) cnFirstName + " " + LastName mail cn (minus ".", replace " " with ".") + objectClass inetOrgPerson dn "uid=" + uid +

15. IBM Tivoli Directory Integrator 15 Exercise 02: CSV to XML (Advanced map) cn mail objectClass dn ret.value = conn.getString("FirstName") + " " + conn.getString("LastName"); var mVal = system.trim(conn.getString("cn")); mVal = system.remove(".", mVal); ret.value = mVal.replace(' ', '.') + "@ewidgets.com"; ret.value = ["top","person","organizationalPerson", ”inetOrgPerson”]; ret.value = "uid=" + conn.getString("uid") + ",ou=employees,o=ewidgets,dc=com";