Tivoli Directory Integrator 7.1.1: Users Guide
Directory IntegratorVersion 7.1.1Users Guide SC27-2706-01
Directory IntegratorVersion 7.1.1Users Guide SC27-2706-01
NoticesBefore using this information and the product it supports, read the general information under “Notices” on page 261.Edition noticeThis edition applies to version 7.1.1 of the IBM Tivoli Directory Integrator and to all subsequent releases andmodifications until otherwise indicated in new editions. Copyright IBM Corporation 2003, 2012.US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contractwith IBM Corp.
ContentsFigures . . . . . . . . . . . . . . . vTables . . . . . . . . . . . . . . . viiPreface . . . . . . . . . . . . . . . ixPublications. . . . . . . . . . . . . xiAccessing publications online . . . . xiiiAccessibility . . . . . . . . . . . . xvAccessibility features . . . .Keyboard navigation . . . .Interface information . . . .Vendor software . . . . .Related accessibility information. xv. xv. xv. xvi. xviChapter 1. General Concepts. . . . . . 1The AssemblyLine . . . . . . . . . . . . 1Connectors . . . . . . . . . . . . . . 3Functions . . . . . . . . . . . . . . 18Script Components . . . . . . . . . . . 18AttributeMaps . . . . . . . . . . . . 20Null Behavior . . . . . . . . . . . . 20Branch Components . . . . . . . . . . 22Parsers . . . . . . . . . . . . . . . 25Accessing your own Java classes . . . . . . 26AssemblyLine flow and Hooks . . . . . . . 26Controlling the flow of an AssemblyLine . . . 30Expressions . . . . . . . . . . . . . . 30Expressions in component parameters . . . . 33Expressions in LinkCriteria . . . . . . . . 33Expressions in Branches, Loops and Switch/Case 34Scripting with Expressions . . . . . . . . 34The Entry object . . . . . . . . . . . . . 35Chapter 2. Scripting in TDI . . . . . . 37Internal data model: Entries, Attributes and ValuesWorking with hierarchical Entry objects . . .Integrating scripting into your solution . . . .Controlling execution with scripting . . . . .Using variables . . . . . . . . . . .Using properties . . . . . . . . . . .Control points for scripting . . . . . . . .Scripting in an AssemblyLine . . . . . .AssemblyLine parameter passing . . . . .Scripting in a Connector . . . . . . . .Setting internal parameters by scripting . . .Scripting in a Parser . . . . . . . . .Java Script JavaScript . . . . . . . . .Data Representation . . . . . . . . .Ambiguous Function Calls . . . . . . .Char/String data in Java versus JavaScriptStrings . . . . . . . . . . . . . . Copyright IBM Corp. 2003, 2012.384050515152545456606060606061. 62Variable scope and naming . . . .Instantiating a Java class . . . . .Using binary values in scripting . .Using date values in scripting . . .Using floating point values in scripting.6364646465Chapter 3. The Configuration Editor . . 67The Project Model . . . . . . . . .The TDI Servers view . . . . . . .The TDI Project . . . . . . . . .Configuration Files . . . . . . . .The Project Builder . . . . . . . .Properties and substitution . . . . .The User Interface Model. . . . . . .The User Interface . . . . . . . . .The Application Window . . . . . .Servers view . . . . . . . . . .The Expression Editor . . . . . . .The AssemblyLine Editor . . . . . .The Connector Editor. . . . . . .Server Editor . . . . . . . . .Schema Editor . . . . . . . . .Data Browser . . . . . . . . .Forms Editor . . . . . . . . .Wizards . . . . . . . . . . .Running and Debugging AssemblyLinesTeam Support . . . . . . . . .The Problems View . . . . . . .JavaScript Enhancements . . . . .Solution Logging and Settings . . . .Server Properties . . . . . . . .Inheritance . . . . . . . . . .Actions and Key Bindings . . . . 75176181188189190Chapter 4. Debugging features in TDI193Sandbox . . . . . . . . . .Recording AssemblyLine input .Sandbox playback of AssemblyLineAssemblyLine Simulation Mode . .Proxy AssemblyLine workflow .Simulation script workflow . . . 193. 194194. 194. 198. 199. . . . . . .recordings. . . . . . . . . .Chapter 5. Easy ETL . . . . . . . . 201Chapter 6. System Store. . . . . . . 209User Property Store . . .Delta Store . . . . . .Store Factory methods . .Property Store methods . .UserFunctions (system object). . . . . . . . . . . . .methods .209210210211212Chapter 7. Deltas . . . . . . . . . . 213Delta Features .Delta Entry . 213. 214iii
Producing Delta Entries .Consuming Delta EntriesExamples . . . . . . . 216. 221. 223Viewing AssemblyLine execution history .Viewing tombstone records . . . . . .Viewing log files . . . . . . . . . 238. 239. 239Chapter 8. Tivoli Directory IntegratorDashboard . . . . . . . . . . . . 227Appendix A. What's new for IBM TivoliDirectory Integrator version 7.1.1 . . . 241Accessing Dashboard application . . . .Opening from a browser . . . . .Opening from the Windows Start menuUploading a data integration solution . .Creating a data integration solution . . .Solution Configuration . . . . . . .Adding solution description . . . .Configuring an AssenblyLine schedule .Configuring a connector . . . . . .Dashboard EasyETL . . . . . . . .Configuring EasyETL solutions . . .Server Configuration . . . . . . . .Configuring log settings . . . . . .Configuring tombstones . . . . . .Configuring Dashboard security settingsViewing installed components . . . .Viewing system store data . . . . .Dashboard RunReports . . . . . . .Creating RunReports . . . . . . .Configuring and browsing connector data .Solution Monitor . . . . . . . . .Starting and stopping the AssemblyLinesOverview of IBM Tivoli Directory Integratorversion 7.1.1 . . . . . . . . . . . . .Deprecated or removed functionality andcomponents . . . . . . . . . . . .Configuration Editor . . . . . . . . .Administration and Monitoring Console andAction Manager . . . . . . . . . .Server, Server API, and Server Componentsenhancements . . . . . . . . . . .Installation enhancements . . . . . . .Parsers, Connectors and Function ComponentsJavadocs, tooling and scripting . . . . .Password plug-in enhancements . . . . .Revised logging mechanism . . . . . .iv.Tivoli Directory Integrator 7.1.1: Users 5235235236236237238238. 241. 242. 243. 243. 244. 244244. 245. 246. 246Appendix B. IBM Tivoli DirectoryIntegrator terms . . . . . . . . . . 247Notices . . . . . . . . . . . . . . 261Index . . . . . . . . . . . . . . . 265
mple hierarchical entry . . . . . . .Traditional, flat entry . . . . . . . .Another simple hierarchical entry . . . .Hierarchical Entry object example . . . .The default TDI Server definition . . . .The TDI Project tree. . . . . . . . .TDI Project Properties window . . . . .Properties view . . . . . . . . . .Servers view in the Configuration EditorServers view; pop-up menu . . . . . .Expression Editor: simple property. . . .Expression Editor: Advanced (JavaScript)Expression Editor: text with v.6-stylesubstitution . . . . . . . . . . .AssemblyLine options menu . . . . . .AssemblyLine Settings . . . . . . . .AssemblyLine Log settings . . . . . .AssemblyLine Hooks . . . . . . . .AssemblyLine Operations . . . . . . .AssemblyLine simulation settings . . . .AssemblyLine simulation settings window,with script editor . . . . . . . . .AssemblyLine Sandbox settings . . . . .Specify Run Options dialog . . . . . .Quick Editor for IF/ELSE/ELSE-IF BranchSwitch/Case Branch . . . . . . . .Attribute Value loop . . . . . . . .Conditional loop . . . . . . . . . .Connector loop . . . . . . . . . .Connector Parameters in Connector LoopIndependent Attribute Map ComponentUser Documentation View . . . . . .Sample AssemblyLine report . . . . .Console log . . . . . . . . . . .Configuration Editor File associationspreferences . . . . . . . . . . .Attribute Mapping . . . . . . . . .Attribute Mapping, with discoveredAttributes . . . . . . . . . . . .Changing Attribute Map inheritance . . .Attribute Mapping, with JavaScript editingwindow for individual Attribute . . . .Add Attribute dialog . . . . . . . .Attribute map: inheritance dialog . . . .Attribute Map window . . . . . . .Connection tab . . . . . . . . . .Line Reader parser . . . . . . . . .Link Criteria tab . . . . . . . . .Expression Editor window, simple modeExpression Editor window, Advanced(JavaScript) mode . . . . . . . . .Pool tab: Connector Pool definition . . .Pool tab: Connector in AssemblyLineConnector Editor: Configure InheritanceServer Document editor . . . . . . .Schema Editor . . . . . . . . . . Copyright IBM Corp. 2003, 2012.414142456970727377. 78. 8081.82888990919293. 94. 95. 9697. 98. 99. 99. 100101101. 102. 103. 103. 104. 105. 106. 107.108109110113115116117118. 119. 123123124. 125. 100.101.102.103.Data Browser . . . . . . . . . . .Data Browser . . . . . . . . . . .Generic Data Browser . . . . . . . . .Stream Data Browser . . . . . . . . .JDBC Data Browser . . . . . . . . .JDBC Table details . . . . . . . . . ."Use as table" option . . . . . . . . .LDAP Data Browser . . . . . . . . .LDAP Data Browser entry . . . . . . .LDAP Data Browser schema item . . . . ."Use as search base" context menu choiceContext menu - Forms Editor choice . . . .Default Forms Editor screen for FileSystemConnector. . . . . . . . . . . . .Forms Editor, Events Script in LDAPConnector. . . . . . . . . . . . .Forms Editor - General section . . . . . .Forms Editor - Advanced section . . . . .Forms Editor - field definitions . . . . .Import Configuration wizard . . . . . .Linked file field . . . . . . . . . . ."Import from server" wizard . . . . . .New Connector in Resources folder wizardNew Component wizard . . . . . . . .New Component wizard, with filteringConnector Configuration panel . . . . .Parser Configuration panel . . . . . . .Parser selection dialog . . . . . . . ."Create AssemblyLine Report" commandChoose Config Report stylesheet dialogReports folder in the Project hierarchyThree options to start an AssemblyLineConsole log window . . . . . . . . .Data Stepper main window . . . . . . .Show/Hide button in the Data StepperShow/Hide components dialog . . . . .Debugger window . . . . . . . . . .Debugger at Before GetNext . . . . . .Error dialog: Stack Trace . . . . . . . .Debugger window: stepping through a scriptline-by-line. . . . . . . . . . . . .StepInto function . . . . . . . . . .Stepped-into function . . . . . . . . .Follow the function call . . . . . . . .Debug Server option . . . . . . . . .Run with Options window . . . . . . .Project Properties menu choice . . . . . .Project Properties . . . . . . . . . .CVS Share Project window . . . . . . .Problems View window . . . . . . . .Configuration Editor Preferences windowConfiguration system store settings . . . .Server document context meu . . . . . .AutoStart settings . . . . . . . . . .Solution Interface settings . . . . . . .Solution Interface settings: 3176181183184186186187v
104.105.106.107.108.109.110.111.Solution Interface settings: PropertiesSolution Interface settings: DescriptionProperties editor window . . . .Key Assignments window . . . .Simulation Settings window . . .EasyETL main window . . . . .EasyETL project context menu . . .Initial EasyETL project window . .viTivoli Directory Integrator 7.1.1: Users 117.LDAP Connector in Easy ETL . . . . . .Input/Output mapping . . . . . . . .Input/Output mapping, with TransformationsTransformation script . . . . . . . . .Completion dialog . . . . . . . . . .Synchronization AssemblyLine using Deltafunctionality . . . . . . . . . . . .204205205206207223
Tables1.2.3.4.5.6.Connector Pool Timeout property Value tableScript objects, their usage and availability.Special objects usable in Expressions . . .Pre-defined objects for use in Expressions inLinkCriteria . . . . . . . . . . .Pre-defined objects for use in Expressions inBranch Components. . . . . . . . .Component properties available duringAssemblyLine Execution . . . . . . . Copyright IBM Corp. 2003, 20121231. 33. 34. 34. 527.8.9.10.11.12.13.14.Eclipse CE extension point contributionsData Browser toolbar . . . . . . . .Forms Editor - parameter definition . . .Method invocation according to modeMethod invocation according to modeDelta Systable structure . . . . . . .Delta Table structure . . . . . . . .Tivoli Directory Integrator Dashboard MenuOptions . . . . . . . . . . . .74. 129. 141198199. 217. 217. 228vii
viiiTivoli Directory Integrator 7.1.1: Users Guide
PrefaceThis document contains the information that you need to develop solutions using components that arepart of the IBM Tivoli Directory Integrator.Tivoli Directory Integrator components are designed for network administrators who are responsible formaintaining user directories and other resources. This document assumes that you have practicalexperience installing and using both Tivoli Directory Integrator and IBM Tivoli Directory Server. Copyright IBM Corp. 2003, 2012ix
xTivoli Directory Integrator 7.1.1: Users Guide
PublicationsRead the descriptions of the IBM Tivoli Directory Integrator V7.1.1 library and the related publications todetermine which publications you might find helpful. After you determine the publications you need,refer to the instructions for accessing publications online.IBM Tivoli Directory Integrator libraryUse these short descriptions of publications and of external sources that can help you understandmethodology and components.IBM Tivoli Directory Integrator V7.1.1 Getting StartedContains a brief tutorial and introduction to Tivoli Directory Integrator. Includes examples tocreate interaction and hands-on learning of Tivoli Directory Integrator.IBM Tivoli Directory Integrator V7.1.1 Installation and Administrator GuideIncludes complete information about installing, migrating from a previous version, configuringthe logging functionality, and the security model underlying the Remote Server API of TivoliDirectory Integrator. Contains information on how to deploy and manage solutions.IBM Tivoli Directory Integrator V7.1.1 Users GuideContains information about using Tivoli Directory Integrator. Contains instructions for designingsolutions using the Directory Integrator designer tool (the Configuration Editor) or running theready-made solutions from the command line. Also provides information about interfaces,concepts and AssemblyLine creation.IBM Tivoli Directory Integrator V7.1.1 Reference GuideContains detailed information about the individual components of Tivoli Directory Integrator:Connectors, Function Components, Parsers, Objects and so forth – the building blocks of theAssemblyLine.IBM Tivoli Directory Integrator V7.1.1 Problem Determination GuideProvides information about Tivoli Directory Integrator tools, resources, and techniques that canaid in the identification and resolution of problems.IBM Tivoli Directory Integrator V7.1.1 Messages GuideProvides a list of all informational, warning and error messages associated with the TivoliDirectory Integrator.IBM Tivoli Directory Integrator V7.1.1 Password Synchronization Plug-ins GuideIncludes complete information for installing and configuring each of the five IBM PasswordSynchronization Plug-ins: Windows Password Synchronizer, Sun Directory Server PasswordSynchronizer, IBM Tivoli Directory Server Password Synchronizer, Domino PasswordSynchronizer and Password Synchronizer for UNIX and Linux. Also provides configurationinstructions for the LDAP Password Store and JMS Password Store.IBM Tivoli Directory Integrator V7.1.1 Release NotesDescribes new features and late-breaking information about Tivoli Directory Integrator that didnot get included in the documentation.Related PublicationsInformation related to the IBM Tivoli Directory Integrator is available in the following publications:v IBM Tivoli Directory Integrator V7.1.1 uses the JNDI client from Oracle. For information about theJNDI client, refer to the Java Naming and Directory Interface Specification at /guides/jndi/index.html . Copyright IBM Corp. 2003, 2012xi
v The Tivoli Software Library provides a variety of Tivoli publications such as white papers, datasheets,demonstrations, redbooks, and announcement letters. The Tivoli Software Library is available on theWeb at: http://www.ibm.com/software/tivoli/library/v The Tivoli Software Glossary includes definitions for many of the technical terms related to Tivolisoftware. The Tivoli Software Glossary is available on the Web, in English only, at liglossarymst.htmv A list of most requested documents as well as those identified as valuable in helping answer yourquestions related to IBM Tivoli Directory Integrator can be found at http://www.ibm.com/support/docview.wss?rs 697&context SSCQGF&uid swg27010509.xiiTivoli Directory Integrator 7.1.1: Users Guide
Accessing publications onlineThe publications for this product are available online in Portable Document Format (PDF) or HypertextMarkup Language (HTML) format, or both in the Tivoli software library: http://www.ibm.com/software/tivoli/library.To locate product publications in the library, click Product manuals on the left side of the Library page.Then, locate and click the name of the product on the Tivoli software information center page.A list of most requested documents as well as those identified as valuable in helping answer yourquestions related toIBM Tivoli Directory Integrator can be found at http://www-01.ibm.com/support/docview.wss?rs 697&uid swg27009673.Information is organized by product and includes readme files, installation guides, user's guides,administrator's guides, and developer's references as necessary.Note: To ensure proper printing of PDF publications, select the Fit to page check box in the AdobeAcrobat Print window. The Acrobat Print window is available when you select File Print. Copyright IBM Corp. 2003, 2012xiii
xivTivoli Directory Integrator 7.1.1: Users Guide
AccessibilityAccessibility features help a user who has a physical disability, such as restricted mobility or limitedvision, to use information technology products successfully. With IBM Tivoli Directory Integrator (TivoliDirectory Integrator), you can use assistive technologies to hear and navigate the interface. Afterinstallation you also can use the keyboard instead of the mouse to operate all features of the graphicaluser interface.Accessibility featuresThe following list includes major accessibility features of IBM Tivoli Directory Integrator:v Supports keyboard-only operation.v Supports interfaces commonly used by screen readers.v Discerns keys as tactually separate, and does not activate keys just by touching them.v Avoids the use of color as the only way to communicate status and information.v Provides accessible documentation.Keyboard navigationThis product uses standard Microsoft Windows navigation keys for common Windows actions such asaccess to the File menu, and to the copy, paste, and delete actions. Actions that are unique use keyboardshortcuts. Keyboard shortcuts have been provided wherever needed for all actions.Interface informationThe accessibility features of the user interface and docu
AssemblyLine flow and Hooks .26 Controlling the flow of an AssemblyLine . . . 30 Expressions .30 Expressions in component parameters .33 Expressions in LinkCriteria .33 Expressions in Branches, Loops and Switch/Case 34 Scripting with Expressions .34 The Entry object.35 Chapter 2. Scripting in TDI .37 Internal data model: Entries, Attributes and Values 38 Working with .
Tivoli Security Operations Manager Products include: Tivoli Composite Application Manager Tivoli Config Mgr Tivoli Decision Support for z/OS 9Tivoli Monitoring 9IBM Director Tivoli Ent Console Tivoli NetView Tivoli OMEGAMON 9Tivoli Provisioning Manager Tivoli Remote Cnt
problem in the Tivoli Directory Integrator server. A command-line interface (CLI) that allows remote control and execution of integration jobs. A cron-job on one Linux machine can control the execution of Tivoli Directory Integrator jobs on any other pl
supporte LDAP (Lightweight Directory Access Protocol ) V3, le standard du marché. . d'annuaires. Tivoli Directory Integrator, solution intégrée et configurable, simplifie la synchronisation des données d'un domaine Active Directory avec Tivoli Directory Server.
Decision Support for z/OS IBM Tivoli System Automation & IBM Tivoli Workload Automation IBM Tivoli Netview for z/OS, OMEGAMON, IBM Tivoli Composite Application Manager, DFSMS IBM Tivoli Identify Manager, IBM Tivoli Access Manage
v Tivoli Remote Control , . Tivoli Remote Control , ˆ . 149 C . Tivoli Remote Control . , RAM . Tivoli Remote Control . Tivoli Remote Control (third-party) . . AIX AIX 4.3.3 5.1
IBM Tivoli Composite Application Manager for SOA IBM Tivoli Usage and Accounting Manager Application Layer Management IBM Tivoli Application Dependency Discovery Manager IBM Tivoli OMEGAMON XE for Messaging IBM Tivoli Composite Application Manager for Response Time IBM Tivoli Composite Application Manager for Web Resources
IBM Tivoli Storage Manager for Windows Administrator's Reference GC32-0783 IBM Tivoli Storage Manager Messages GC32-0767 IBM Tivoli Storage Manager Using the Application Program Interface GC32-0793 Contacting customer support If you have a problem with any Tivoli product, you can contact Tivoli Customer
Tivoli Storage Manager for Windows Quick Start GC35-0409 Tivoli Storage Manager for Windows Administrator's Guide GC35-0410 Tivoli Storage Manager for Windows Administrator's Reference GC35-0411 Tivoli Storage Management Products License Information LC23-4470 Tivoli Storage Manager for HP-UX Quick Start GC35-0412
