tdi入门指南--精选文档

1、IBM Tivoli Directory Integrator 5.2：入门指南S152-0828-00注意 在使用本资料及其支持的产品之前，请阅读附录B. 声明中的一般信息。第一版（2003 年 11 月） 该修订版适用于 IBM Tivoli Directory Integrator V5R2 及其所有的后继发行版与修改，除非在新的修订版中另有说明。国际商业机器公司版权 2002、2003. 保留所有的权利前言本文档包含管理 IBM(R) Tivoli(R) Directory Integrator 所需的信息。本书的读者本书是为系统管理员和所有有兴趣学习更多 IBM Tivoli Dir

2、ectory Integrator 知识的用户准备的。出版物请阅读 IBM Tivoli Directory Integrator 库的描述来确定哪些出版物可能会对您有帮助。确定了所需的出版物之后，请参考在线访问出版物的指示信息。IBM Tivoli Directory Integrator 库IBM Tivoli Directory Integrator 库中的出版物有：IBM Tivoli Directory Integrator 5.2：自述包含关于 IBM Tivoli Directory Integrator 5.2 的最新信息。 IBM Tivoli Directory Integ

3、rator 5.2：入门指南IBM Tivoli Directory Integrator 5.2 的简单教程和介绍。 IBM Tivoli Directory Integrator 5.2：管理员指南包含安装 IBM Tivoli Directory Integrator 的完整信息。包含从以前的 IBM Tivoli Directory Integrator 版本迁移的信息。包含有关 IBM Tivoli Directory Integrator 的配置日志记录功能的信息。 IBM Tivoli Directory Integrator 5.2：用户指南包含关于如何使用 IBM Tivol

4、i Directory Integrator 5.2 工具的信息。包含使用 IBM Tivoli Directory Integrator 工具（ibmditk）设计解决方案或从命令行（ibmdisrv）运行预先做好的解决方案的指示信息。还提供关于接口、概念以及“组装流水线事件处理 程序”的创建和管理的信息。包含创建交互和实际动手学习 IBM Tivoli Directory Integrator 5.2 的示例。 IBM Tivoli Directory Integrator 5.2：参考指南包含 IBM Tivoli Directory Integrator 5.2 组装流水线的各个组件（

5、接口、事件处理程序、解析器、插件等等）的详细信息。 相关的出版物下列出版物中提供了与 IBM Tivoli Directory Integrator 相关的信息：· IBM Tivoli Directory Integrator 5.2 使用 Sun Microsystems 的 JNDI 客户机。 请参考位于 的 Sun Microsystems Web 站点上的 Java(TM) Naming and Directory Interface(TM) 1.2.1 Specification 以了解关于 JNDI 客户机的信息。· “Tivoli 软件库”提供了各种各样的

6、Tivoli 出版物，比如白皮书、数据表、演示、红皮书和发布函。“Tivoli 软件库”可在位于 的 Web 站点获得。· Tivoli Software Glossary 包含许多与 Tivoli 软件相关的技术术语的定义。Tivoli Software Glossary 只有英语版，可从 Tivoli 软件库 Web 页面 左侧的 Tivoli glossary 链接获得。在线访问出版物本产品的出版物可在线获得，有可移植文档格式（Portable Document Format，PDF）或超文本标记语言（Hypertext Markup Language，HTML）格式，或者这两

7、种格式都有；这些出版物可以从 Tivoli 软件库： 获得。要在库中查找产品出版物，请单击该库页面左侧的 Product manuals 链接。然后，在 Tivoli software information center 页面找到并单击产品的名称。信息按产品组织在一起，其中包括自述文件、安装指南、用户指南、管理员指南并且如有必要的话，还包括开发者参考大全。注:要确保正确打印 PDF 格式的出版物，请选择 Adobe Acrobat“打印”窗口（单击 文件->打印）的适合纸张大小复选框。辅助功能辅助功能用来帮助身体残疾的用户（比如行动不便或视力不佳的用户）成功使用软件产品。使用这个产品时

8、，您可以使用辅助技术听到和浏览界面。安装了本产品之后，您还可以使用键盘（而不用鼠标）来操作图形用户界面上的所有功能。联系软件支持在联系 IBM Tivoli 软件 support 来解决问题之前，请参考 IBM System Management 和 Tivoli software Web 站点，站点位置：如果您还需要其它帮助，请使用IBM 软件支持指南中描述的方法在下列 Web 站点联系软件支持：该指南提供以下信息：· 获得支持的注册和资格要求· 电话号码和电子邮件地址，这些取决于您所在的国家或地区· 在联系客户支持前您必须收集的一系列信息内容前言本书的读者出版

9、物IBM Tivoli Directory Integrator 库相关的出版物在线访问出版物辅助功能联系软件支持简介关于本手册脚本编制语言安装 IBM Tivoli Directory Integrator安装教程文件先简化再解决如何吃掉一头大象？集成即通信体系结构组装流水线连接器解析器事件处理程序IBM Tivoli Directory Integrator快速集成开发创建一个新配置文件创建组装流水线添加输入连接器将属性映射到组装流水线中添加输出连接器运行组装流水线使用 Hook模式转换添加联结连接器设置链接条件事件处理程序最后的思考附录A. index.html 和 OtherPage.

10、htmlindex.htmlOtherPage.html附录B. 声明第三方组件声明Apache 声明Rhino 声明商标简介关于本手册本书提供对一个简单系统的简单介绍。一点没错，简单一词用在这里可谓恰如其分，因为绞尽脑汁思考一个复杂问题的最好方法就是简化它。把它分解为几个更易管理的片段，然后管理这些组成部分。分而治之，各个击破。这是您在解决日常问题时本能地使用的一种技巧，它同样也可用于管理跨公司、跨企业或全球范围的信息交换。IBM Tivoli Directory Integrator 的设计和构建是基于这样的前提，即集成问题可以分为三个基本组成部分：· 通信中涉及的系统·

11、; 这些系统间的数据流· 触发数据流的事件在 IBM Tivoli Directory Integrator 中，您可以把对集成问题的这种原子式理解直接变成解决方案。您可以用持续的反馈和验证以增量方式构建自己的解决方案，一次增加一个流程。这意味着集成项目将变得更容易估计和规划。甚至有时候规划也可以减少以简化要实现的各个数据流的成本计算和确定工作。既然您将用一种可视且交互式的方法一个流程一个流程地开发解决方案，那么就可以随时向项目和公司管理人员报告（和演示）进度。IBM Tivoli Directory Integrator 管理所有连接拟集成的各种数据源并与之交互的技术细节，抽象地管

12、理它们的 API、传输、协议以及格式等细节。IBM Tivoli Directory Integrator 的焦点不是集中在数据上，而是把您的视线提到了信息层，使您能够把注意力集中在执行每次交换所需的转换、过滤和其它业务逻辑上。IBM Tivoli Directory Integrator 使您能够构建组件库和业务逻辑，您可以维护、扩展并重用这些组件库和业务逻辑来解决新的难题。您整个组织的各个开发项目都可以共享 IBM Tivoli Directory Integrator 资产，这样的话，各个项目之间相互独立，同时又都可以融合到连贯的集成基础结构中。在您于项目一开始考虑数据源和技术专家以便建

13、立自己的库时，这种方法可以更合理地预估所要使用的资源。这些集成资产就绪后，在整个网络范围内都可用，从而使您可以利用它们来创建新的解决方案和增强现有的解决方案。本文档向您介绍了这种方法，并提供了一些信息帮您深入理解 IBM Tivoli Directory Integrator 的这种极度而又优雅的简单性。脚本编制语言IBM Tivoli Directory Integrator 提供了一种优雅且直观的“先瞄准再射击”环境用来快速构建集成解决方案的框架。然而，紧接着您可能就想添加更高级的数据操作和转换逻辑以及过滤数据和控制 数据流行为的业务规则。所有这些都是通过在解决方案中编写脚本来完成的。因为

14、 IBM Tivoli Directory Integrator 使用“Bean 脚本编制框架”，所以有很多种脚本编制语言可供您选择，包括 JavaScript(TM)、VBScript 和 PerlScript。关于脚本编制语言的更多信息，请参阅IBM Tivoli Directory Integrator 5.2：参考指南。安装 IBM Tivoli Directory IntegratorIBM Tivoli Directory Integrator 是一个可快速部署的轻量级集成中间件。与传统的中间件不同，IBM Tivoli Directory Integrator 的安装几分钟就可以

15、完成，并且您可以立即开始 构建、测试和部署解决方案。该系统可在许多种平台上运行，包括 Windows(R) 和多种 UNIX(R) 以及 Linux 版本。关于安装 IBM Tivoli Directory Integrator 的更多信息，请参阅IBM Tivoli Directory Integrator 5.2：管理员指南中的IBM Tivoli Directory Integrator 安装说明。安装教程文件要使用本手册中的示例，您需要教程数据文件（不过，您也可以从本手册中的文本重新生成这些文件）。要访问这些示例文件，请转至安装目录中的 root_directory/examples

16、目录。root_directory 指安装 IBM Tivoli Directory Integrator 的目录。先简化再解决如何吃掉一头大象？答案是：一次咬一口。这同样是消化大型集成和系统部署项目的最佳方法。成功的关键在于将问题分解成许多更小、更易于管理的片段从而降低复杂程度。也就是说先从总体解决方案的一个部分着手，最好是从可以在一周或两周内完成的部分开始。理想情况是，该片段可独立投入生产。那样的话，当您处理解决方案的其余组成部分时，它就已经在提供投资回报了。当您把准备处理的片段隔离之后，就可以通过重点处理基本通信单元（数据流本身）来进一步简化它。现在您就可以满怀信心地开始实现它们了。集成

17、开发是使用 IBM Tivoli Directory Integrator 通过一系列的“尝试测试改进”周期来完成的，这使得该过程成了一个重复的、甚至探索性的过程。这不仅能帮助您发现更多有关自己的安装的信息，而且能够 让您随着对问题集以及它对基础结构的影响的理解的加深来开发自己的集成解决方案。要在头脑中对手上的问题有一个清楚的认识，一种非常不错的方法是把问题用一张图形画出来。用铅笔和一张纸以粗线条草拟一个流程图来制订出解决方案。 这样的练习不仅能帮助您直观地了解任务的范围，还可以作为在 IBM Tivoli Directory Integrator 中实现任务的蓝图。集成即通信集成问题都与通信

18、有关，因此通常可以细分成三个基本部分：· 进行通信的系统和设备· 这些系统间的数据流· 触发数据流的事件可以如下描述通信方案的这些组成元素：数据源它们是互相通信的数据资源库、系统和设备。例如： · 您准备实现或设法维护的企业目录（Enterprise Directory）· 您的 CRM 应用程序· 营业所电话系统· 列出公司设备和设备所有者的 Access 数据库。数据源代表种类繁多的系统和资源库，比如数据库（例如，DB2(R)、Oracle 和 SQL Server）、目录（例如，iPlanet、IBM Director

19、y Server、Domino(TM)、eDirectory 和 Active Directory）、目录服务（Exchange）、文件（例如， XML、LDIF 或 SOAP 文档）、经过特殊格式化的电子邮件或者内部系统和外部业务伙伴用于交流信息资产和服务的任意数目的接口机制。数据流数据流是指通信的线程及其内容，并且通常被描绘成指向数据移动方向的箭头。每条数据流都代表两个或更多系统之间的一个通信。但为让对话对于所有的参与者都有意义，每个参与者都必须了解通信的内容。您可能希望数据源以不同的方式表示它们的数据内容。某个系统可能以文本信息表示电话号码，包括用于使号码更易读的破折号和圆括号。而另一个

20、系统可能以数字数据存储电话号码。如果这两个系统要就此数据进行通信，那么就必须在对话中转换这些信息。此外，某个数据源中的信息可能并不完整，因此可能需要用来自其它数据源的属性来补充。而且，数据流中可能只有部分数据与接收系统相关。因此数据流还必须包含信息的映射、过滤和转换，以把它在输入源中的上下文转换为它在目的地系统中的上下文。事件事件可以描述为指示何时一组数据源与另一组数据源通信的情况。示例之一就是在人力资源系统中添加、更新或删除员工。另一个示例是访问控制系统检测到某个钥 匙卡片正在受限区域中使用。事件还可以基于日历或一个以时钟为准的计时器，例如，每 10 分钟开始一次通信，或者在周日的午夜 12

21、:00 开始通信。它还可以是手动触发的一次性事件，比如在一个系统中植入一个目录或清洗数据。事件通常被绑到数据源上，并且与指定的一组情况发生时触发的数据流相关。这些元素中的每一个都由 IBM Tivoli Directory Integrator 用它的三种类型的组件（接口、解析器和事件处理程序）来处理。· 连接器就是连接和访问数据源中数据的组件。例如，您可以使用 JDBC 连接器读 SQL 数据库，并可以向 SQL 数据库写入，而 LDAP 连接器使我们能够访问目录。某些类型的数据源不把数据作为结构化的对象（记录、条目等等）存储，而是作为字节流来存储。两个示例是 IP 上的数据和平面

22、文件。这时就要使用“解析器”了，它把字节流转换为结构化信息或者把结构化信息转换为字节流。· 数据流是通过把一个或多个“接口”连在一起实现的（必要时会把“接口”和“解析器”关联起来）。· 最后，可以配置事件处理程序，使它检取所连接的系统（例如目录或 POP3/IMAP 邮箱）中的更改通知，然后把这些事件分派给指定的组装流水线。在更深入地了解这些组件的工作原理之前，您需要总结一下想要实现的数据流。如上文所述，前面已经提到过，进行这项工作的一个不错的方法是画出一张数据流图表。有很多图表约定和样式可供选择，但符号的实际形状和类型并没有您对问题的理解那么重要。请使用方框、圆球、圆泡泡

23、或任何您喜欢的图形，但请保持一 致，并务必清楚、易读地标出每一项。这样一来，当您在几个月后查看这些图表时（或者其他人查看时），仍然能够明白这些符号是什么意思。一个输出数据源 （DS3）从初始数据源（DS1）获得数据。在此过程中，数据流还从第二个数据源（DS2）收集信息。在 IBM Tivoli Directory Integrator 中，这种数据流被称为组装流水线。每个组装流水线实现一个单向的数据流，理解这一点很重要。如果希望在两个或多个数据源之间实现双向同步，则必须使用单独的组装流水线来处理每个方向上的数据流。之所以这样做是因为每个方向上的数据的格式和内容以及对数据执行的操作很可能都是不同

24、的。注:IBM Tivoli Directory Integrator 提供创建“请求-响应”信息解决方案（比如 Web 服务）所需的一切。尽 管对于组装流水线可以包含的连接器数量没有限制，但组装流水线在包含足够的组件和脚本逻辑来使组装流水线尽可能自主的同时，必须包含尽可能少的连接器（例 如，参与数据流的每个数据源只有一个连接器）。个中的原因是使组装流水线便于理解和维护。同时它还会形成更简单、更快速和更具伸缩性的解决方案。IBM Tivoli Directory Integrator 的基本原理是一次处理一条数据流，从而简化问题集合，因此，让我们从 DS1 到 DS3 的数据流开始。各种系统的

25、数据组织方式会有很大区别。· 数据库通常把信息存储在具有固定数量字段的记录中。· 而目录则处理称为条目的变量对象。· 其它系统可以使用消息或键值对。IBM Tivoli Directory Integrator 把各种信息收集并存储在一个灵活强大的被称为条目的数据容器中，从而简化了这一问题。而数据值本身又保存在由“条目”掌管的被称为属性的对象中。另一个可能存在的问题是这些数据源使用不同的类型来表示存储的值。IBM Tivoli Directory Integrator 同样帮助您解决了这一问题。进入数据流的所有内容都被转换为一种与预定义的规则一致的格式（Java

26、对象）。因此，您的业务规则和转换逻辑就不必处理类型冲突问题了。但当数据准备输出时，IBM Tivoli Directory Integrator 会把它转换回特定于数据源的相关类型。为了完成数据流的可视化，请记录输入数据源的属性是如何映射（也可能是修改）为目标系统属性。例如，DS3 可能如下所示：First =DS1.FirstLast =DS1.LastFullName =DS1.First+" "+DS1.LastTitle =DS1.TitleMail =<compute_from_name>为使示例保持简单，请使用一个包含字段 First、Last 和

27、Title 且以逗号分隔的值文件作为 DS1。您的输出数据源（DS3）是一个 XML 文档。现在您已经很好地阐述了您的解决方案，我们就来看一下 IBM Tivoli Directory Integrator 如何处理数据流。体系结构IBM Tivoli Directory Integrator 的体系结构可分为两部分：· 核心系统提供大部分系统功能。IBM Tivoli Directory Integrator 的核心处理日志文件、错误检测和分派以及数据流的运行参数。定制的配置和业务逻辑也是在这里维护的。· 组件负责抽取您想使用的数据系统的技术细节和格式。IBM Tivol

28、i Directory Integrator 为您提供三种类型的组件： o 连接器o 解析器o 事件处理程序由于每个组件都是用核心功能（这些功能处理诸如集成流控制和定制等工作）包起来的，所以组件本身仍可以小巧轻 便。例如，如果您想实现自己的解析器，只需提供两个函数，一个用于解释传入的字节流的结构，另一个用于把结构添加到传出的字节流。如果您仔细看一下 IBM Tivoli Directory Integrator 的 jar 子目录，您就会看到标准组件是多么轻便，这使得它们很容易创建和扩展。这个核心组件设计使得 IBM Tivoli Directory Integrator 很容易扩展。这还意味

29、着您可以通过选择相关的组件，然后把它们放在适当的位置来快速构建自己的解决方案框架。组件是可以互换的，并且换出时不会影响数据流 定制的逻辑和配置的行为。这意味着您可以构建快速增加和扩展的集成解决方案，而同时又不会因底层基础结构的改变而遭到破坏。组装流水线图表中的数据流箭头可以转换为 IBM Tivoli Directory Integrator 中的组装流水线，它的工作方式与现实中的工业组装流水线相似。现实的组装流水线由许多专用机器组成，虽然这些机器在功能和构造上都各不相同，但是它们有一个共同的重要特征，那就是它们可以连接在一起，组成完整的从投料到产出的连续路线。无论生产所需的原材料是什么（例如

30、，鱼片、可乐汁、汽车部件等），组装流水线通常都设计成拥有一个或多个投料设备来接受它们。这些配料被处理，然后融合在一起。有时沿途从组装流水线上抽走副产品。在生产线的末端，制成品被传递到等候着的产品输出设备。如果生产人员获得了生产其它产品的订单，他们就拆开组装流水线，留下仍与新订单相关的机器。正确连接新设备，调整组装流水线，然后又重新开始生产。IBM Tivoli Directory Integrator 组装流水线的工作方式与此完全相同。IBM Tivoli Directory Integrator 组装流水线从各输入单元接收信息，根据这些输入执行操作，然后通过输出单元送出成品。IBM Tivo

31、li Directory Integrator 组装流水线一次处理一项（例如，一条数据记录、一个目录条目、一个注册表键等等）。来自连接的输入源的数据属性聚集在 Java 存储区（被称为 work 对象）中，可以添加脚本来处理这些信息：验证数据内容、计算新的属性和值并更改现有的属性和值，直到数据可以从组装流水线传送到一个或多个输出源。IBM Tivoli Directory Integrator 组装流水线的输入和输出单元被称为连接器，每个连接器链接到一个数据存储器。连接器把数据流与外部世界连在一起，并且它们还是进行数据转换和聚集的地方。同时您还可以在其中放置业务、安全性和身份管理逻辑。连接器连

32、接器与卡在一起的七巧板拼块相似，同时还链接到特定的数据源。每次选择其中一个七巧板拼块并将它添加到组装流水线时，都必须执行以下操作：1. 选择连接器的类型。2. 为连接器指定它在数据流中的角色。这种角色被称为连接器方式，它告诉 IBM Tivoli Directory Integrator 如何使用该连接器： o 输入连接器，它在其数据源中迭代或查找信息。o 输出连接器，它在所连接的系统或设备中插入、更新或删除数据。注:必须将数据从输入源中拉出，然后推入输出目的地。这正是连接器所擅长的。您可以随时更改连接器的类型和方式以顺应基础结构或者解决方案目标的更改。如果您的计划中已经考虑到了这种可能性，那

33、么组装流水线的其余部分（包括 数据转换和过滤）都不会受到影响。这正是把每个连接器看作一个黑盒子（这个黑盒子将数据传递到数据混合之中或从数据混合中抽取一些数据发送到数据源）很重 要的原因所在。每个连接器越独立，解决方案的扩充和维护就越方便。通过使“连接器”尽可能自主，您还可以很方便地将它们传送到“连接器库”并重新使用它们来更快地创建新的解决方案，甚至与他人共享这些连接器。使用 IBM Tivoli Directory Integrator 库功能还会使连接器的维护和增强变得更方便，因为您只需更新库中的连接器模板，从这个模板派生出的所有组装流水线就可以继承这些增强。当您准备好将自己的 解决方案投入

34、实际的工作时，您只需花几分钟时间就可以重新配置连接器以连接到生产数据源而不是测试环境中的数据源，并将解决方案从实验室移到现实的部署 中。不管什么时候需要将新数据包含到数据流中，您只需把相关的连接器添加到组装流水线即可。IBM Tivoli Directory Integrator 为您提供一个连接器库让您从中选择连接器，比如 LDAP、JDBC、Microsoft(R) NT4 Domain、Lotus(R) Notes(R) 和 POP3/IMAP。如果找不到自己要找的连接器，您可以继承现有的连接器，方法是使用一种先进的脚本语言（包括 JavaScript、VBScript 和 PerlSc

35、ript）覆盖该连接器的任何或所有函数。您甚至可以创建自己的连接器，使用脚本连接器包装程序中的脚本语言创建，或者使用 Java 或 CC+ 从头创建。不仅如此，IBM Tivoli Directory Integrator 支持大多数传输协议和机制，比如 TCP/IP、FTP、HTTP 和 JMS （MQ），用（或不用）SSL 或其它加密机制来保护信息流。关于脚本语言以及如何创建自己的脚本语言的更多信息，请参阅IBM Tivoli Directory Integrator 5.2：参考指南。解析器即便是从 IP 端口输入的非结构化数据（如文本文件或字节流），IBM Tivoli Directo

36、ry Integrator 也能通过将字节流传入一个或多个解析器来方便快捷地处理它们。解析器是另一种类型的 IBM Tivoli Directory Integrator 组件，系统附带了许多种解析器，包括 LDIF、DSML、XML、CSV 和固定长度的字段。并且正象连接器一样，您可以扩展和修改这些解析器，也可以创建自己的解析器。继续第 * 页上的示例，下一步是标识数据源。因为输入数据源是一个用逗号分隔值的文本文件，所以请使用与 CSV 解析器配对的文件系统连接器。请对输出也同样使用文件系统连接器，只不过这次将选择 XML 解析器以便把文件格式化为 XML 文档。注:已经在 UNIX 平台上

37、使用 UNIX 路径名约定创建了本手册中的示例。为使解决方案独立于平台，请在路径名中使用正斜杠（/）而不是反斜杠（），例如 examples/Tutorial/Tutorial1.cfg。这在 Windows 和 UNIX/Linux 平台上都适用。事件处理程序事件处理程序是第三种类型的 IBM Tivoli Directory Integrator 组件，提供用来构建实时集成解决方案的功能。与连接器一样，事件处理程序也可以拥有数据源智能，这使它们能够连接到一个系统或服务并等待事件通知。“邮箱事件处理程序”（它可以检测到新消息何 时到达一个 POP3 或 IMAP 邮箱）或“LDAP 事件处理

38、程序”（它可以捕获对目录所做的更改）就是典型的例子。当一个事件发生时，事件处理程序把事件的具体细节储存起来，然后根据您设置的条件操作规 则执行逻辑并启动组装流水线。有时连接器也可以用来捕获事件，与 JMS 连接器或 LDAP Changelog 连接器一样，这两者都可以配置成在等待新数据出现后再检索这些数据。但由于事件处理程序是在自己的线程内操作，所以它们可用来向多个组装流水线分派事件。 这就提供了一种更清晰和更直观的方法来从相同的数据源过滤和处理多种类型的事件。事件处理程序也可以配置为“自动启动”，这意味着如果您用配置文件启动服 务器，这些事件处理程序将立即被激活。这样您就不必为组装流水线特

39、别命名以让其用服务器的命令行参数运行了。既然已经向您介绍了 IBM Tivoli Directory Integrator 使用的组件，现在您就可以构建组装流水线了。但您需要一个输入文件才能继续进行。您可以在 IBM Tivoli Directory Integrator 的安装目录的子目录 examplesTutorial 下找到这样一个文件的示例，或者也可以用文本编辑器创建自己的这种文件。包含的样本数据如下所示：First;Last;TitleBill;Sanderman;Chief ScientistMick;Kamerun;CEOJill;Vox;CTORogerGregory;Hig

40、hpeak;VP Product DevelopmentErnie;Hazzle;Chief EvangelistPeter;Belamy;Business Support Manager 此文件名为 People.csv，位于 IBM Tivoli Directory Integrator 安装目录的 examples/Tutorial 文件夹中。 当它就位以后，您就可以使用 IBM Tivoli Directory Integrator 构建自己的解决方案了。IBM Tivoli Directory Integrator快速集成开发IBM Tivoli Directory Integrat

41、or 实际上是两个程序：Toolkit IDE 此程序为您提供创建、测试和调试集成解决方案的图形界面。Toolkit 集成开发环境（Toolkit Integrated Development Environment）用于创建运行时引擎启动的配置文件。Toolkit IDE 的可执行文件被称为 ibmditk。运行时服务器运行时服务器使用用 Toolkit IDE 创建的配置文件（存储为高度结构化的 XML 文档）为集成解决方案提供动力。此程序文件名为 ibmdisrv，您可以随意使用任意数量的服务器实例部署您的解决方案。IBM Tivoli Directory Integrator 技术对此

42、没有强制性限制。启动 Toolkit IDE。片刻之后向您显示主屏幕。从这里您可以创建一个新配置文件，您可以再度访问该文件。注:如果您看到的屏幕与本手册中的屏幕快照不同，那么您的系统可能使用了不同的显示设置。请执行以下操作来更改显示设置： 1. 单击文件->编辑首选项。2. 单击外观选项卡。3. 单击外观与感觉选项卡。IBM Tivoli Directory Integrator 窗口的大小可以调整。如果本手册中的屏幕快照与您自己看到的不一样，请尝试更改您屏幕上的窗口大小。选择文件->编辑首选项会打开一个对话框，在此对话框内您可以设置许多其它的用户界面参数，比如主按钮工具栏是否可见

43、，或者您是否希望 IBM Tivoli Directory Integrator 在窗口底部使用“状态栏”。屏幕的顶部是主菜单和按钮工具栏。主工具栏提供创建新配置文件、打开现有配置文件和保存当前工作的命令，同时还提供几个导航按钮。这些命令也可以在文件和窗口菜单中找到，在这里您还可以发现用来将配置保存到一个新文件名的另存为选项。创建一个新配置文件IBM Tivoli Directory Integrator 配置文件存储为 XML 文档。它们在 Toolkit IDE 中创建和维护，并用服务器来部署。 每个配置文件包含服务器运行的组装流水线和组成这些组装流水线的 IBM Tivoli Direc

44、tory Integrator 组件。配置文件还保存颜色和 GUI 界面风格等用户首选项。注:配置文件还可以散布在几个文件中，存储在几个位置上。IBM Tivoli Directory Integrator 在启动时使用您指定包含的 URL 和文件路径动态组合其配置。 这意味着您可以创建和维护可由许多服务器配置共享的公共设置和组件。您还可以通过在它们之间拖放组件来一次打开和处理几个配置文件。首次启动系统时，会向您显示如前面图形所示的空白屏幕。如果您现在创建新配置文件，IBM Tivoli Directory Integrator 将询问您是否想创建名为 rs.xml 的缺省配置文件。不要使用缺

45、省的配置文件名，请为该文件提供另一个名称。单击创建新的配置根按钮或使用文件->新建菜单选项创建一个名为 Tutorial1 的配置文件（请注意，会自动为您添加 .xml 扩展名）。此文件必须保存在 examples/Tutorial 目录中。注:可以将路径名输入为安装 IBM Tivoli Directory Integrator 时指定的目录的路径。屏幕左侧的树形视图被称为配置浏览器，它为您提供一组文件夹，这组文件夹包含您的解决方案的各个方面。顶部标有 AssemblyLines 的文件夹包含您创建的组装流水线。就在该文件夹的下方有三个文件夹，它们存储您的组件库（一个文件夹存储一种类型

46、的组件）。这使您能够使用配置和行为参数、数据转换以及其它业务规则来设置标准连接器（例如 LDAP、JDBC 和 Notes 等等），然后使用并重用它们来创建新的解决方案。下面没有非常详细地描述 Toolkit IDE 的界面，而是描述了一下这些配置屏幕的总体布局：· 工具栏下的屏幕的其余部分由几个窗格组成。“配置浏览器”出现在左边，不过您可以使用主工具栏中的切换显示配置树视图按钮来隐藏和显示这个窗格，或者单击“配置浏览器”旁边分隔栏顶部的箭头来隐藏和显示。这个窗格的右边是“详细信息”区域，该区域会发生改变以显示您在“配置浏览器”中选择的项的详细信息。· “详细信息”窗格可以

47、显示多个详细的视图，每次在“配置浏览器”中选择一个不同的项都会打开一个新视图。这些窗格可使用窗口菜单访问，或者使用每个视图顶部的选项卡访问（这取决于您为系统设置的外观）。· 有时“详细信息”窗格还包含项列表。如果您单击它，“详细信息”窗格还适合用来显示这些项的详细信息。· 更改列表中为任意列分配的空间，方法是在各列之间的边界上移动鼠标光标（光标会通过改变形状来指示可以如此操作），然后单击该边界并将其拖动到新位置。· 每个“元素”列表的顶部是一行按钮，它们提供这种类型的对象可用的一系列操作（在数据流窗格中，按钮栏在“连接器”列表的下面）。各个窗格的可用操作列表都不尽

48、相同，但常规行为都一样：选择列表中的一个条目，然后单击按钮（有添加按钮时除外，此时您不需要先选择任何内容）。· 在突出显示列表中的项时，您可以按 Shift 或 Ctrl 键来一次选择几个元素。· 您可以把项从“配置浏览器”拖到组装流水线中，或者在打开的配置文件间拖动项。创建组装流水线您首先必须创建一个新的组装流水线。右键单击 AssemblyLine 文件夹。从弹出的上下文相关菜单中，选择新建组装流水线。将此组装流水线命名为 CSVtoXML。可以将组装流水线命名为任何您想用的名称，但很重要的一点是要使用有助于记录解决方案的命名约定。注:为组装流水线或 IBM Tivol

49、i Directory Integrator 组件（如连接器和事件处理程序）命名时使用特殊字符和空格不是个好主意，因为以后当您想从命令提示符启动 IBM Tivoli Directory Integrator Server 来运行解决方案时这会导致出问题。在组装流水线中，解决方案中的组件和其它配置项都可在解决方案中作为脚本对象使用，这使您可以在运行时更改参数和行为。 这表示您想在脚本中使用能引用这些对象的名称。IBM Tivoli Directory Integrator 现在将把您带到组装流水线屏幕。请注意，此新屏幕将填满先前空白的配置窗格。在添加连接器之前，请快速地看一下组装流水线屏幕的布

50、局：“详细信息”面板的顶部是一行选项卡，每个选项卡都与“配置浏览器”中打开的项有关（在本例中，会显示新组装流水线的“详细信息”面板）。每个选项卡的标题中有一个按钮行，其中包含用于关闭此详细信息屏幕的关闭按钮。注:如果让光标悬浮在配置工具中的按钮上会出现工具提示。除关闭按钮之外，此按钮行还包含两个其它的按钮：运行运行当前组装流水线。 运行调试IBM Tivoli Directory Integrator 包含一个数据流调试程序，它使您能够按步骤执行组装流水线、观察当控制权从一个连接器传递到另一个连接器时组装流水线中传送和转换的数据。 组装流水线的“详细信息”屏幕左侧的白色框是“连接器”列表，新的

51、连接器添加到数据流后就会出现在这里。“连接器”列表的下方显示“工作条目”。它使您能够仔细查看数据流，并始终向您显示正从连接的系统读入的数据属性。这些列表的右边显示当前选择的连接器的详细信息。在此详细信息区域的顶部是组装流水线选项卡。这些选项卡使您可以访问该数据流的各个方面：这些选项卡有：Hook组装流水线 Hook 选项卡使您能够在以下时间设置要进行求值或要启动的脚本： · 在连接器初始化之前（使您能够在启动连接器的连接之前重新配置连接器）· 在连接器初始化之后，但在控制权传递给第一个连接器之前· 最后一个连接器完成之后· 当某个外部事件要求组装流水线终

52、止时数据流创建和维护连接器的位置。 配置.向您提供该组装流水线的诸多配置参数。 调用返回在这里您可以为该组装流水线指定输入和输出参数，以便于从外部过程（例如，事件处理程序）调用它。 如果单击配置. 选项卡，您会看到您可以设置想在该组装流水线中使用的参数（比如，脚本语言），还可以限制迭代次数（当开发和测试大型数据集合的组装流水线时这一点很有用）。注:不管您在组装流水线中选择使用哪种脚本语言，IBM Tivoli Directory Integrator 都允许您使用用其它语言编制的组件。您可以在 JavaScript 中编写自己的组装流水线逻辑，但只要您运行 IBM Tivoli Directo

53、ry Integrator 的平台支持您选择的脚本语言，您仍然可使用用 VBScript 创建的连接器和基于 PerlScript 的分析器。连接器框的正下方是“连接器”列表按钮栏，该栏提供许多用来处理连接器的操作：这些按钮执行以下操作：添加连接器将新的连接器添加到组装流水线。还可以通过将预先配置的连接器从“配置浏览器”拖到“连接器”列表中来完成这项工作。 添加脚本组件将新的连接器添加到组装流水线。“脚本组件”是一个可以放在组装流水线中的脚本块。 删除从组装流水线删除当前选择的接口或脚本组件。 重命名使您能够更改当前选择的项的名称。 上移将选择的连接器或脚本组件朝组装流水线的开始处上移一个点位

54、。这种位置调整很重要，因为组装流水线按自顶向下的顺序运行这些项。 下移将所选项朝列表末尾处向下移动。 复制到库复制所选的连接器，并将其放入连接器库中（ 在“配置浏览器”中的“接口”文件夹的下方）。 添加输入连接器单击添加以创建第一个连接器。把该连接器命名为 InputPeople，然后单击标记为连接器的下拉列表。现在从列表中选择文件系统模板，这样将显示系统附带的连接器，外加所有注册在连接器库（在 Connectors 文件夹中）中的连接器。库组件显示在这些下拉列表选项的顶部。这里要设置的最后一个参数是连接器方式，它告诉组装流水线此连接器的角色。IBM Tivoli Directory Inte

55、grator 有六种连接器方式：AddOnly这种方式适用于只向数据源添加新信息的连接器，例如，写入文件、首次植入数据库或目录等等。 DeleteDelete 方式让连接器搜索指定的条目记录，然后删除它们。为搜索使用的关键字规范被称为链接条件。连接器执行查找和更新时也必须为其指定链接条件，因为这些方式也要求连接器在连接的系统中查找匹配的数据。 IteratorIterator 方式连接器的运行贯穿整个数据源（或数据源的一部分，例如数据库视图或目录搜索的结果集），然后一次返回一个条目以便在组装流水线中进行处理。Iterator 方式的连接器被称为迭代器。一个组装流水线可以包含多个迭代器，并且这些

56、迭代器一个接一个地连续启动，也就是说，当第一个迭代器到达它的数据集末尾时第二个迭代器又启动。 Lookup此方式让连接器查找并返回与指定的搜索条件匹配的条目，也是将信息收集到数据流中的方式。 Update在 Update 方式下，连接器尝试查找指定的条目或记录。如果连接器查找成功，就用传递给它的信息修改现有的条目。如果没有找到，则连接器会改为添加该信息。 Call/Return这是个非常特殊的方式，在这种方式下首先输出一个调用包（比如一个 SOAP 消息或 JMS 条目），然后等待应答。如果您想使用 Web 服务连接器，那么必须将它设为 Call/Return 方式。 注:并不是所有的方式对于

57、所有连接器都可用。例如，如果处理的是文本文件，就不支持 Lookup、Delete、Update 和 Call/Return（除非您编写自己的连接器或增强现有的连接器）。对于一个组装流水线可以拥有的连接器的数量没有限制，而且您还可以按需要拥有适当数量的同类型连接器，甚至可以将它们连接到同一个数据源。在某些情 况下这甚至是必需的。例如，假设您想创建一个组装流水线来输出一个数据源中的所有记录。首先您设置一个迭代器（例如，一个 Iterator 方式的连接器）来返回您想删除的对象。然后添加另一个连接器，将其配置为使用同一个系统，但这次将其设为 Delete 方式。于是，组装流水线就轮询整个输入源，将条目发送给用来删除它们的第二个连接器。有时您并不希望让多个连接同时连到同一个数据源。即使在软件许可证强制资源锁定或限制的情况下也不可能。在这种情况下，您可以在滚动到“连接器类型”下拉列表的底端添加新的连接