-
IBM
Tivoli
Directory
Integrator
5.2:
Guía
del
usuario
SC10-9839-00
���
-
IBM
Tivoli
Directory
Integrator
5.2:
Guía
del
usuario
SC10-9839-00
���
-
Nota
Antes
de
utilizar
esta
información
y
el
producto
al
que
da
soporte,
lea
la
información
general
contenida
en
el
Apéndice
E,
“Avisos”,
en
la
página
161.
Primera
edición
(noviembre
2003)
Esta
publicación
es
la
traducción
del
original
inglés
IBM
Tivoli
Directory
Integrator
5.2:
Users
Guide
(SC32-1378-00).
Esta
edición
se
aplica
a
la
versión
5,
release
2
de
IBM
Tivoli
Directory
Integrator
y
a
todos
los
releases
y
modificaciones
posteriores
hasta
que
se
indique
lo
contrario
en
nuevas
ediciones.
©
Copyright
International
Business
Machines
Corporation
2003.
Reservados
todos
los
derechos.
-
Prefacio
Este
documento
contiene
la
información
necesaria
para
administrar
IBM
Tivoli
Directory
Integrator.
A
quién
va
dirigido
este
manual
Este
manual
va
dirigido
a
aquellos
usuarios
que
ya
han
leído
la
Guía
de
iniciación
y
que
van
a
diseñar
soluciones
basadas
en
IBM
Tivoli
Directory
Integrator.
Publicaciones
Lea
las
descripciones
de
la
biblioteca
de
IBM
Tivoli
Directory
Integrator
para
determinar
qué
publicaciones
pueden
resultarle
útiles.
Cuando
haya
determinado
las
publicaciones
que
necesita,
consulte
las
instrucciones
para
acceder
a
las
publicaciones
en
línea.
Biblioteca
de
IBM
Tivoli
Directory
Integrator
Las
publicaciones
de
la
biblioteca
de
IBM
Tivoli
Directory
Integrator
son:
IBM
Tivoli
Directory
Integrator
5.2:
Léame
Contiene
la
información
de
última
hora
acerca
de
IBM
Tivoli
Directory
Integrator
5.2.
IBM
Tivoli
Directory
Integrator
5.2:
Guía
de
iniciación
Una
breve
guía
de
aprendizaje
y
una
introducción
a
IBM
Tivoli
Directory
Integrator
5.2.
IBM
Tivoli
Directory
Integrator
5.2:
Administrator
Guide
Contiene
toda
la
información
para
instalar
IBM
Tivoli
Directory
Integrator.
Incluye
información
para
realizar
la
migración
desde
una
versión
anterior
de
IBM
Tivoli
Directory
Integrator.
Incluye
información
acerca
de
cómo
configurar
la
función
de
registro
de
IBM
Tivoli
Directory
Integrator.
IBM
Tivoli
Directory
Integrator
5.2:
Guía
del
usuario
Contiene
información
acerca
de
cómo
utilizar
la
herramienta
IBM
Tivoli
Directory
Integrator
5.2.
Contiene
las
instrucciones
para
diseñar
soluciones
utilizando
la
herramienta
IBM
Tivoli
Directory
Integrator
(ibmditk)
o
para
ejecutar
soluciones
preparadas
previamente
desde
la
línea
de
mandatos
(ibmdisrv).
Asimismo,
proporciona
información
acerca
de
las
interfaces,
los
conceptos
y
la
creación
y
gestión
de
la
línea
de
ensamblaje
y
de
los
manejadores
de
sucesos.
Incluye
ejemplos
para
crear
interacción
y
obtener
aprendizaje
práctico
sobre
IBM
Tivoli
Directory
Integrator
5.2.
IBM
Tivoli
Directory
Integrator
5.2:
Reference
Guide
Contiene
información
detallada
acerca
de
los
componentes
individuales
de
la
línea
de
ensamblaje
de
IBM
Tivoli
Directory
Integrator
5.2
(conectores,
manejadores
de
sucesos,
analizadores,
plug-ins,
etc.).
Publicaciones
relacionadas
En
las
publicaciones
siguientes
puede
encontrar
información
relacionada
con
IBM
Tivoli
Directory
Integrator:
v
IBM
Tivoli
Directory
Integrator
5.2
utiliza
el
cliente
JNDI
de
Sun
Microsystems.
Para
obtener
información
acerca
del
cliente
JNDI,
consulte
la
publicación
Java
©
Copyright
IBM
Corp.
2003
iii
-
Naming
and
Directory
Interface™
1.2.1
Specification
en
el
sitio
Web
de
Sun
Microsystems
http://java.sun.com/products/jndi/1.2/javadoc/index.html.
v
La
biblioteca
de
software
de
Tivoli
proporciona
diferentes
publicaciones
de
Tivoli
como,
por
ejemplo
libros
blancos,
hojas
de
especificaciones,
demostraciones,
libros
rojos
y
cartas
sobre
anuncios.
La
biblioteca
de
software
de
Tivoli
está
disponible
en
el
sitio
Web
http://www.ibm.com/software/tivoli/library/
v
El
glosario
de
software
de
Tivoli
incluye
definiciones
de
muchos
términos
técnicos
relacionados
con
el
software
de
Tivoli.
El
glosario
de
software
de
Tivoli
está
disponible,
sólo
en
inglés,
en
el
enlace
Glossary
situado
a
la
izquierda
de
la
página
Web
de
la
biblioteca
de
software
de
Tivoli
http://www.ibm.com/software/tivoli/library/
Acceso
a
las
publicaciones
en
línea
Las
publicaciones
de
este
producto
están
disponibles
en
línea
en
formato
PDF
(Portable
Document
Format)
o
HTML
(Hypertext
Markup
Language)
o
en
ambos
en
la
biblioteca
de
software
de
Tivoli:
http://www.ibm.com/software/tivoli/library.
Para
localizar
las
publicaciones
del
producto
en
la
biblioteca,
pulse
el
enlace
Product
manuals
situado
a
la
izquierda
en
la
página
de
la
biblioteca.
A
continuación,
localice
y
pulse
el
nombre
del
producto
en
la
página
del
centro
de
información
de
software
de
Tivoli.
La
información
está
organizada
por
productos
e
incluye
archivos
LÉAME,
guías
de
instalación,
guías
del
usuario,
guías
del
administrador
y
manuales
de
consulta
del
desarrollador,
según
sea
necesario.
Nota:
para
asegurarse
de
que
las
publicaciones
en
formato
PDF
se
imprimen
correctamente,
seleccione
el
recuadro
de
selección
Ajustar
a
página
de
la
ventana
Imprimir
de
Adobe
Acrobat
(disponible
cuando
pulsa
Archivo->Imprimir).
Accesibilidad
Las
características
de
accesibilidad
permiten
a
los
usuarios
con
discapacidades
físicas,
por
ejemplo,
con
problemas
de
movilidad
o
de
vista,
utilizar
correctamente
los
productos
de
software.
Con
este
producto
puede
utilizar
las
tecnologías
de
ayuda
para
escuchar
y
navegar
por
la
interfaz.
Después
de
la
instalación
también
puede
utilizar
todas
las
funciones
de
la
interfaz
gráfica
de
usuario
desde
el
teclado
en
lugar
del
ratón.
Cómo
ponerse
en
contacto
con
el
soporte
de
software
Antes
de
ponerse
en
contacto
con
el
soporte
de
software
de
IBM
Tivoli
por
algún
problema,
consulte
el
sitio
Web
de
IBM
System
Management
y
Tivoli
en:
http://www.ibm.com/software/sysmgmt/products/support/
Si
necesita
más
ayuda,
póngase
en
contacto
con
el
soporte
de
software
utilizando
los
métodos
que
se
describen
en
la
publicación
IBM
Software
Support
Guide
en
el
sitio
Web
siguiente:
http://techsupport.services.ibm.com/guides/handbook.html
iv
IBM
Tivoli
Directory
Integrator
5.2:
Guía
del
usuario
http://java.sun.com/products/jndi/1.2/javadoc/index.htmlhttp://www.ibm.com/software/tivoli/library/http://www.ibm.com/software/tivoli/library/http://www.ibm.com/software/tivoli/library/http://www.ibm.com/software/sysmgmt/products/support/http://techsupport.services.ibm.com/guides/handbook.html
-
La
guía
le
proporciona
la
información
siguiente:
v
Los
requisitos
de
registro
y
acceso
para
recibir
soporte
v
Los
números
de
teléfono
y
las
direcciones
de
correo
electrónico,
dependiendo
del
país
en
el
que
se
encuentre
v
Una
lista
de
la
información
que
debe
reunir
antes
de
ponerse
en
contacto
con
el
servicio
de
soporte
al
cliente
Prefacio
v
-
vi
IBM
Tivoli
Directory
Integrator
5.2:
Guía
del
usuario
-
Contenido
Prefacio
.
.
.
.
.
.
.
.
.
.
.
.
.
. iii
A
quién
va
dirigido
este
manual
.
.
.
.
.
.
. iii
Publicaciones
.
.
.
.
.
.
.
.
.
.
.
.
.
. iii
Biblioteca
de
IBM
Tivoli
Directory
Integrator
.
. iii
Publicaciones
relacionadas
.
.
.
.
.
.
.
. iii
Acceso
a
las
publicaciones
en
línea
.
.
.
.
. iv
Accesibilidad
.
.
.
.
.
.
.
.
.
.
.
.
.
. iv
Cómo
ponerse
en
contacto
con
el
soporte
de
software
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. iv
Capítulo
1.
Introducción
.
.
.
.
.
.
.
. 1
Conceptos
generales
.
.
.
.
.
.
.
.
.
.
.
. 1
Componentes
del
programa
e
interfaz
.
.
.
.
.
. 1
Editor
de
configuraciones
de
IBM
Tivoli
Directory
Integrator
.
.
.
.
.
.
.
.
.
.
.
.
.
. 1
Servidor
IBM
Tivoli
Directory
Integrator
.
.
.
. 2
API
de
IBM
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 2
Objetos
de
script
.
.
.
.
.
.
.
.
.
.
.
.
. 2
Capítulo
2.
Conceptos
de
IBM
Tivoli
Directory
Integrator
.
.
.
.
.
.
.
.
.
. 3
Línea
de
ensamblaje
.
.
.
.
.
.
.
.
.
.
.
. 3
Flujo
de
la
línea
de
ensamblaje
.
.
.
.
.
.
. 5
Inicio
de
una
línea
de
ensamblaje
en
el
editor
de
configuraciones
de
IBM
Tivoli
Directory
Integrator
–
ibmditk
.
.
.
.
.
.
.
.
.
.
.
.
.
. 7
Inicio
de
una
línea
de
ensamblaje
desde
un
manejador
de
sucesos
o
script
.
.
.
.
.
.
. 7
Acceso
a
conectores
en
la
línea
de
ensamblaje
.
. 7
Pase
de
parámetros
de
la
línea
de
ensamblaje
.
. 7
Cajón
de
arena
.
.
.
.
.
.
.
.
.
.
.
. 10
Conectores
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 11
Esquema
del
conector
.
.
.
.
.
.
.
.
.
. 13
Cómo
comparten
los
datos
los
conectores
(la
entrada
work)
.
.
.
.
.
.
.
.
.
.
.
. 13
Modalidades
del
conector
.
.
.
.
.
.
.
. 13
Estados
del
conector
.
.
.
.
.
.
.
.
.
. 21
Analizadores
.
.
.
.
.
.
.
.
.
.
.
.
.
. 21
Conversión
de
la
codificación
de
caracteres
.
.
. 22
Criterio
de
enlace
.
.
.
.
.
.
.
.
.
.
.
. 22
Criterio
de
enlace
simple
.
.
.
.
.
.
.
.
. 22
Criterio
de
enlace
avanzado
.
.
.
.
.
.
.
. 23
Manejadores
de
sucesos
.
.
.
.
.
.
.
.
.
. 24
Inicio
del
manejador
de
sucesos
.
.
.
.
.
. 25
El
objeto
event
.
.
.
.
.
.
.
.
.
.
.
. 26
Enganches
de
manejadores
de
sucesos
.
.
.
. 26
Correlación
de
acciones
del
manejador
de
sucesos
26
Condiciones
.
.
.
.
.
.
.
.
.
.
.
.
. 27
Acciones
.
.
.
.
.
.
.
.
.
.
.
.
.
. 27
Nombre
de
atributo/propiedad
.
.
.
.
.
.
. 28
Scripts
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 28
Control
del
flujo
de
una
línea
de
ensamblaje
.
. 29
Cuándo
se
necesitan
los
scripts
.
.
.
.
.
.
. 30
Integración
de
los
scripts
en
su
solución
.
.
.
. 30
Cómo
afectan
los
scripts
a
la
ejecución
.
.
.
. 31
Puntos
de
control
para
scripts
.
.
.
.
.
.
. 32
Comparación
de
cadenas
JavaScript
.
.
.
.
. 34
Acceso
a
sus
propias
clases
Java
.
.
.
.
.
. 35
Scripts
en
JavaScript
.
.
.
.
.
.
.
.
.
. 36
Scripts
en
lenguajes
sin
el
nuevo
java.*
.
.
.
. 36
Utilización
de
valores
binarios
en
scripts
.
.
. 37
Utilización
de
valores
de
fecha
en
scripts
.
.
. 37
Utilización
de
valores
de
coma
flotante
en
scripts
37
Ejemplos
.
.
.
.
.
.
.
.
.
.
.
.
.
. 38
Enganches
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 38
Habilitación
o
inhabilitación
de
enganches
.
.
. 39
Sobrescritura
de
enganches
.
.
.
.
.
.
.
. 39
Enganches
de
error
.
.
.
.
.
.
.
.
.
.
. 39
Lista
de
enganches
.
.
.
.
.
.
.
.
.
.
. 40
Deltas
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 46
Atributo
exclusivo
.
.
.
.
.
.
.
.
.
.
. 46
Distintivos
Delta
.
.
.
.
.
.
.
.
.
.
.
. 47
Deltas
y
cálculo
de
cambios
.
.
.
.
.
.
.
. 47
Proceso
Delta
.
.
.
.
.
.
.
.
.
.
.
.
. 48
Estructuras
de
la
tabla
Delta
.
.
.
.
.
.
.
. 49
Almacén
del
sistema
.
.
.
.
.
.
.
.
.
.
. 50
Almacén
de
propiedades
del
usuario
.
.
.
.
. 50
Almacén
Delta
.
.
.
.
.
.
.
.
.
.
.
. 51
Almacén
de
puntos
de
control/reinicio
.
.
.
. 51
Métodos
de
la
fábrica
de
almacén
.
.
.
.
.
. 51
Métodos
del
almacén
de
propiedades
.
.
.
.
. 53
Métodos
de
UserFunctions
(objeto
system)
.
.
. 53
Herencia
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 54
Correlación
de
atributos
.
.
.
.
.
.
.
.
.
. 54
Comportamiento
ante
un
valor
nulo
.
.
.
.
. 56
Objeto
conn
.
.
.
.
.
.
.
.
.
.
.
.
. 57
Objetos
de
configuración
y
del
sistema
importantes
58
Cómo
controlar
el
número
de
hebras
.
.
.
.
. 59
Punto
de
control/reinicio
.
.
.
.
.
.
.
.
.
. 60
Guardar
y
almacenar
la
información
de
estado
de
la
línea
de
ensamblaje
.
.
.
.
.
.
.
.
.
. 61
Limitaciones
.
.
.
.
.
.
.
.
.
.
.
.
. 63
Consecuencias
del
reinicio
.
.
.
.
.
.
.
. 68
Acciones
de
reinicio
.
.
.
.
.
.
.
.
.
. 68
Depuración
.
.
.
.
.
.
.
.
.
.
.
.
.
. 72
Depurador
de
flujos
.
.
.
.
.
.
.
.
.
. 72
Registro
y
depuración
.
.
.
.
.
.
.
.
.
. 73
Configuración
.
.
.
.
.
.
.
.
.
.
.
.
. 75
Propiedades
externas
.
.
.
.
.
.
.
.
.
. 75
Inclusiones/Espacios
de
nombres
.
.
.
.
.
. 75
Soporte
de
SSL
(Secure
Sockets
Layer)
de
IBM
Tivoli
Directory
Integrator
.
.
.
.
.
.
.
.
.
.
. 75
Seguridad
en
la
conexión
entre
IBM
Tivoli
Directory
Integrator
5.2
y
servidores
con
SSL
(IBM
Tivoli
Directory
Integrator
como
cliente)
.
. 76
Seguridad
en
la
conexión
entre
un
cliente
e
IBM
Tivoli
Directory
Integrator
5.2
con
SSL
(IBM
Tivoli
Directory
Integrator
como
servidor)
.
.
. 77
Configuración
SSL
para
IBM
Tivoli
Directory
Integrator
y
Microsoft
Active
Directory
.
.
.
. 78
©
Copyright
IBM
Corp.
2003
vii
-
Obtención
de
una
conexión
JDBC
segura
en
una
línea
de
ensamblaje
de
IBM
Tivoli
Directory
Integrator
5.2
mediante
IDS
Server
.
.
.
.
. 80
Obtención
de
una
conexión
JDBC
segura
en
una
línea
de
ensamblaje
de
IBM
Tivoli
Directory
Integrator
5.2
mediante
NetDirect
JDataConnect
. 83
Capítulo
3.
Editor
de
configuraciones
de
IBM
Tivoli
Directory
Integrator
.
.
. 85
Utilización
del
editor
de
configuraciones
.
.
.
. 85
Controles
de
lista
.
.
.
.
.
.
.
.
.
.
. 86
Controles
de
pestaña
.
.
.
.
.
.
.
.
.
. 87
Controles
de
teclado
.
.
.
.
.
.
.
.
.
. 87
Desplazamiento
por
las
ventanas
de
detalles
.
. 87
Selecciones
del
menú
principal
.
.
.
.
.
.
. 88
Ventanas
del
editor
de
scripts
.
.
.
.
.
.
. 90
Configuraciones
.
.
.
.
.
.
.
.
.
.
.
.
. 91
Crear
una
nueva
configuración
.
.
.
.
.
.
. 91
Abrir
una
configuración
existente
.
.
.
.
.
. 92
Guardar
una
configuración
.
.
.
.
.
.
.
. 92
Renombrar
una
configuración
.
.
.
.
.
.
. 92
Cerrar
una
configuración
.
.
.
.
.
.
.
.
. 92
Copiar
elementos
entre
configuraciones
abiertas
(o
carpetas)
.
.
.
.
.
.
.
.
.
.
.
.
. 92
Gestión
de
carpetas
de
configuración
.
.
.
.
. 93
Líneas
de
ensamblaje
.
.
.
.
.
.
.
.
.
.
. 94
Gestión
de
las
líneas
de
ensamblaje
.
.
.
.
. 94
Configuración
de
la
línea
de
ensamblaje
.
.
.
. 94
Comprobación
de
las
líneas
de
ensamblaje
.
. 103
Trabajo
con
los
archivos
de
la
línea
de
ensamblaje
antes
de
que
se
complete
el
proceso
. 104
Conectores
.
.
.
.
.
.
.
.
.
.
.
.
.
. 104
Gestión
de
conectores
.
.
.
.
.
.
.
.
. 104
Utilización
de
conectores
en
las
líneas
de
ensamblaje
(conectores
de
la
línea
de
ensamblaje)
.
.
.
.
.
.
.
.
.
.
.
.
. 105
Conectores
de
la
biblioteca
.
.
.
.
.
.
.
. 117
Conectores
de
script
.
.
.
.
.
.
.
.
.
. 118
Analizadores
.
.
.
.
.
.
.
.
.
.
.
.
. 119
Manejadores
de
sucesos
.
.
.
.
.
.
.
.
.
. 120
Interfaz
del
manejador
de
sucesos
.
.
.
.
. 121
Biblioteca
de
scripts
.
.
.
.
.
.
.
.
.
.
. 126
Bibliotecas
Java
.
.
.
.
.
.
.
.
.
.
.
.
. 127
Preferencias
(Propiedades
Java)
.
.
.
.
.
. 128
Propiedades
Java
.
.
.
.
.
.
.
.
.
.
. 129
Inclusiones
.
.
.
.
.
.
.
.
.
.
.
.
.
. 130
Propiedades
externas
.
.
.
.
.
.
.
.
.
.
. 130
Configuración
de
las
propiedades
externas
.
. 131
Gestión
de
las
propiedades
externas
.
.
.
.
. 132
Registro
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 132
Niveles
de
registro
.
.
.
.
.
.
.
.
.
. 137
Etiquetas
de
los
parámetros
de
las
pestañas
Conector
y
Analizador
.
.
.
.
.
.
.
.
.
. 137
Capítulo
4.
Ejemplos
.
.
.
.
.
.
.
. 139
Conector
de
VBScript
y
conector
de
contactos
de
Microsoft
Outlook
.
.
.
.
.
.
.
.
.
.
.
. 139
Código
de
ejemplo
.
.
.
.
.
.
.
.
.
. 139
Consulte
también
.
.
.
.
.
.
.
.
.
.
. 141
Conector
JavaScript
.
.
.
.
.
.
.
.
.
.
. 141
Código
de
ejemplo
.
.
.
.
.
.
.
.
.
. 141
Consulte
también
.
.
.
.
.
.
.
.
.
.
. 142
Analizador
JavaScript
.
.
.
.
.
.
.
.
.
. 142
Código
de
ejemplo
.
.
.
.
.
.
.
.
.
. 142
Consulte
también
.
.
.
.
.
.
.
.
.
.
. 142
Escritura
de
un
conector
en
bruto
nuevo
.
.
.
. 142
Conector
basado
en
script
.
.
.
.
.
.
.
. 143
Conector
basado
en
Java
.
.
.
.
.
.
.
. 143
Creación
e
instalación
de
un
conector
basado
en
Java
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 143
Cómo
copiar
directorios
con
el
conector
LDAP
.
. 145
Capítulo
5.
Opciones
de
la
línea
de
mandatos
de
IBM
Tivoli
Directory
Integrator
.
.
.
.
.
.
.
.
.
.
.
.
. 147
Editor
de
configuraciones
de
IBM
Tivoli
Directory
Integrator
.
.
.
.
.
.
.
.
.
.
.
.
.
. 147
Servidor
IBM
Tivoli
Directory
Integrator
.
.
.
. 147
Apéndice
A.
Utilización
de
la
base
de
datos
CloudScape
.
.
.
.
.
.
.
.
. 149
CloudScape
incorporado
.
.
.
.
.
.
.
.
. 149
Sobrescritura
de
los
valores
por
omisión
de
CloudScape
.
.
.
.
.
.
.
.
.
.
.
.
.
. 149
Apéndice
B.
Aumento
de
la
memoria
disponible
en
la
máquina
virtual
.
.
. 151
Apéndice
C.
Juegos
de
caracteres
de
doble
byte
en
IBM
Tivoli
Directory
Integrator
.
.
.
.
.
.
.
.
.
.
.
.
. 153
Apéndice
D.
Diccionario
de
términos
155
Términos
de
LDAP
.
.
.
.
.
.
.
.
.
.
. 155
Términos
de
IBM
Tivoli
Directory
Integrator
.
.
. 155
Apéndice
E.
Avisos
.
.
.
.
.
.
.
.
. 161
Declaraciones
de
componentes
de
terceros
.
.
.
. 163
Declaración
de
Apache
.
.
.
.
.
.
.
.
. 163
Declaración
de
Rhino
.
.
.
.
.
.
.
.
.
. 164
Marcas
registradas
.
.
.
.
.
.
.
.
.
.
.
. 164
viii
IBM
Tivoli
Directory
Integrator
5.2:
Guía
del
usuario
-
Capítulo
1.
Introducción
Los
ejemplos
que
complementan
este
manual
se
encuentran
en
el
directorio
directorio_raíz/examples
de
IBM
Tivoli
Directory
Integrator.
Conceptos
generales
A
continuación,
figuran
algunos
de
los
conceptos
generales
que
se
pueden
encontrar
en
la
documentación
de
IBM
Tivoli
Directory
Integrator.
v
“Línea
de
ensamblaje”
en
la
página
3
v
“Conectores”
en
la
página
11
v
“Criterio
de
enlace”
en
la
página
22
v
“Manejadores
de
sucesos”
en
la
página
24
v
“Scripts”
en
la
página
28
v
“Enganches”
en
la
página
38
v
“Deltas
y
cálculo
de
cambios”
en
la
página
47
v
“Almacén
del
sistema”
en
la
página
50
v
“Herencia”
en
la
página
54
v
“Correlación
de
atributos”
en
la
página
54
v
“Objetos
de
configuración
y
del
sistema
importantes”
en
la
página
58
v
“Punto
de
control/reinicio”
en
la
página
60
v
“Depuración”
en
la
página
72
v
“Configuración”
en
la
página
75
v
“Acceso
a
sus
propias
clases
Java”
en
la
página
35
v
Apéndice
D,
“Diccionario
de
términos”,
en
la
página
155
Componentes
del
programa
e
interfaz
IBM
Tivoli
Directory
Integrator
consta
de
dos
programas
Java:
v
El
editor
de
configuraciones,
conocido
también
como
el
kit
de
herramientas
o
la
GUI
v
El
servidor
Ambos
programas
funcionan
con
una
descripción
de
la
solución
de
integración,
denominada
configuración.
Con
el
editor
de
configuraciones
puede
crear,
desarrollar
y
mantener
configuraciones
y
desplegar
su
solución
de
integración
utilizando
el
servidor
de
tiempo
de
ejecución.
Editor
de
configuraciones
de
IBM
Tivoli
Directory
Integrator
El
editor
de
configuraciones
se
activa
iniciando
el
archivo
por
lotes
o
script
ibmditk
que
configura
los
parámetros
de
entorno
de
la
máquina
virtual
Java
y
luego
inicia
el
editor
de
configuraciones.
Esta
herramienta
se
utiliza
para
crear
y
gestionar
sus
configuraciones
de
la
solución
de
integración
y
le
permite
trabajar
con
varias
configuraciones
al
mismo
tiempo.
Las
configuraciones
se
almacenan
como
documentos
XML
altamente
estructurados
y
pueden
cifrarse.
©
Copyright
IBM
Corp.
2003
1
-
v
Consulte
el
Capítulo
3,
“Editor
de
configuraciones
de
IBM
Tivoli
Directory
Integrator”,
en
la
página
85,
para
obtener
más
información
acerca
del
editor
de
configuraciones
de
IBM
Tivoli
Directory
Integrator.
Servidor
IBM
Tivoli
Directory
Integrator
Cuando
tenga
una
configuración
podrá
desplegar
a
continuación
su
solución
con
el
archivo
por
lotes
o
script
del
servidor
IBM
Tivoli
Directory
Integrator,
ibmdisrv,
que
establece
el
entorno
de
la
máquina
virtual
Java
y
luego
inicia
el
servidor.
Además
de
los
mandatos
incluidos
en
la
propia
configuración,
tiene
varias
opciones
de
línea
de
mandatos
para
controlar
el
comportamiento
del
servidor
y
su
manejo
de
la
configuración.
v
Consulte
el
Capítulo
5,
“Opciones
de
la
línea
de
mandatos
de
IBM
Tivoli
Directory
Integrator”,
en
la
página
147.
API
de
IBM
En
el
paquete
de
instalación
se
incluye
documentación
JavaDoc,
con
información
técnica
completa,
donde
se
describen
todos
los
objetos
java
internos
disponibles
(archivo
directorio_raíz\docs\api\index.html).
Objetos
de
script
Los
objetos
de
script
están
disponibles
en
todas
partes
de
las
líneas
de
ensamblaje
(siempre
que
el
contexto
sea
válido).
Algunos
de
los
objetos
principales
se
describen
en
el
apartado
″Objects″,
IBM
Tivoli
Directory
Integrator
5.2:
Reference
Guide.
2
IBM
Tivoli
Directory
Integrator
5.2:
Guía
del
usuario
-
Capítulo
2.
Conceptos
de
IBM
Tivoli
Directory
Integrator
Una
configuración
de
IBM
Tivoli
Directory
Integrator
describe
los
diferentes
componentes
del
sistema
que
se
han
configurado
y
enlazado
para
formar
una
solución.
Generalmente,
se
trata
de
una
lista
de
componentes
de
IBM
Tivoli
Directory
Integrator
(conectores,
analizadores
y
manejadores
de
sucesos)
que
se
configuran
para
que
funcionen
con
los
sistemas
y
almacenes
de
datos
incluidos
en
la
infraestructura.
Los
conectores
se
enlazan
entre
sí
para
resolver
flujos
de
datos
específicos.
Estas
implementaciones
de
los
flujos
de
datos
se
denominan
Líneas
de
ensamblaje.
Adicionalmente,
la
configuración
puede
contener
uno
o
más
manejadores
de
sucesos
que
se
utilizan
para
dar
servicio
a
los
sucesos
de
entrada
y
para
activar
y
controlar
la
ejecución
de
las
líneas
de
ensamblaje.
Finalmente,
tanto
los
conectores
como
los
manejadores
de
sucesos
pueden
utilizar
analizadores
para
interpretar
las
corrientes
de
bytes
o
para
dar
formato
a
las
corrientes
de
bytes
que
se
están
escribiendo
o
transmitiendo.
Estos
componentes
se
describen
en
los
apartados
siguientes,
junto
con
otros
conceptos
relevantes.
Línea
de
ensamblaje
Por
lo
general,
una
línea
de
ensamblaje
procesa
datos
(por
ejemplo,
entradas,
registros,
elementos,
objetos)
de
un
origen
de
datos,
los
transforma
y
combina
con
los
datos
de
otros
orígenes
de
datos
y
finalmente
envía
la
salida
a
uno
o
varios
destinos.
Es
importante
recordar
que
la
línea
de
ensamblaje
se
ha
diseñado
y
optimizado
para
trabajar
con
un
elemento
cada
vez.
No
obstante,
si
desea
realizar
varias
actualizaciones
o
varias
supresiones
(por
ejemplo,
si
desea
procesar
más
de
un
elemento
cada
vez)
entonces
deberá
escribir
scripts
de
línea
de
ensamblaje
para
hacerlo.
Si
es
necesario,
este
tipo
de
proceso
se
puede
implementar
utilizando
los
lenguajes
de
scripts,
bibliotecas
Java
y
funciones
estándar
de
IBM
Tivoli
Directory
Integrator
que
desee
(como
por
ejemplo,
agrupar
los
datos
en
un
almacén
de
datos
clasificado
con
el
conector
JDBC
y
luego
puede
volver
a
leerlos
y
procesarlos
con
una
segunda
línea
de
ensamblaje).
La
línea
de
ensamblaje
consta
de
varios
conectores
que
funcionan
en
modalidades
específicas
y
pueden
formar
la
base
de
su
solución.
Para
obtener
una
visión
general
de
la
línea
de
ensamblaje,
consulte
la
publicación
IBM
Tivoli
Directory
Integrator
5.2:
Guía
de
iniciación.
La
mayor
parte
de
los
elementos
de
configuración
(líneas
de
ensamblaje,
conectores,
manejadores
de
sucesos,
etc.)
se
pueden
manipular
directamente
en
los
scripts,
por
lo
tanto,
debe
prestar
atención
cuando
les
asigne
nombres.
Utilice
únicamente
caracteres
alfanuméricos
y
no
utilice
caracteres
nacionales
especiales
(por
ejemplo,
å,
ä),
separadores
(excepto
el
subrayado
(
_
)),
espacios
en
blanco,
etc.
Debe
evitarlos
porque
ocasionan
problemas
de
incompatibilidad
en
algunas
plataformas
y
pueden
impedir
su
acceso
desde
el
script.
Las
líneas
de
ensamblaje
pueden
incluir
lo
siguiente:
Conectores
Generalmente
dos
o
más
conectores
que
se
conectan
a
los
orígenes
de
©
Copyright
IBM
Corp.
2003
3
-
datos
(sistemas
de
archivo,
directorios,
bases
de
datos,
etc.).
Normalmente,
un
conector
proporciona
entrada
a
la
línea
de
ensamblaje
y
como
mínimo
un
conector
proporciona
la
salida.
Un
elemento
importante
de
IBM
Tivoli
Directory
Integrator
es
su
amplia
biblioteca
de
conectores
pero,
por
supuesto,
puede
escribir
sus
propios
conectores.
Los
conectores
se
pueden
ejecutar
en
diferentes
modalidades
como
por
ejemplo,
en
modalidad
Iterator,
Update,
Delete,
etc.
Nota:
las
líneas
de
ensamblaje
pueden
constar
de
tantos
conectores
como
sea
necesario
para
solucionar,
por
ejemplo,
un
flujo
de
datos
específico,
sin
que
haya
límite
en
el
sistema.
No
obstante,
lo
recomendable
es
mantener
una
línea
de
ensamblaje
del
modo
más
simple
posible
para
garantizar
al
máximo
su
mantenimiento.
Analizador
Los
conectores
que
leen
o
entregan
una
corriente
de
bytes
(por
ejemplo,
un
conector
de
URL
o
un
conector
de
sistema
de
archivos)
deben
asociarse
a
un
analizador
relevante.
Al
igual
que
con
los
conectores,
puede
escribir
su
propio
analizador
o
ampliar
uno
de
los
analizadores
estándar
que
están
disponibles
con
el
sistema.
Normas
de
empresa
Aunque
las
funciones
que
incorpora
IBM
Tivoli
Directory
Integrator
le
ayudan
a
configurar
rápidamente
su
solución,
debe
personalizar
la
configuración
añadiendo
sus
propias
normas
de
empresa.
Esta
personalización
se
divide
en
dos
categorías:
las
transformaciones
de
datos
y
el
control
de
flujo.
Las
transformaciones
de
datos
generalmente
las
maneja
un
script
que
se
añade
a
las
correlaciones
de
atributos
(correlaciones
de
entrada
y
de
salida)
mientras
que
el
control
de
flujo
se
efectúa
creando
enganches
de
script.
Entrada
work
La
entrada
work
es
un
objeto
de
almacenamiento
que
contiene
los
atributos
que
se
transportan
por
la
línea
de
ensamblaje.
Los
conectores
comparten
la
entrada
work,
que
se
puede
pasar
entre
líneas
de
ensamblaje
y
manejadores
de
sucesos.
Puede
encontrar
una
descripción
detallada
de
la
correlación
de
atributos
entre
el
origen
de
datos
y
la
entrada
work
en
el
apartado
“Correlación
de
atributos”
en
la
página
54.
Componente
de
script
Un
componente
de
script
es
un
bloque
de
script
que
se
puede
añadir
a
una
línea
de
ensamblaje
del
mismo
modo
que
un
conector.
A
diferencia
de
un
conector,
el
componente
de
script
no
tiene
un
comportamiento
o
una
modalidad
predefinida
y
puede
implementar
libremente
sus
funciones
tal
y
como
desee.
La
línea
de
ensamblaje
está
fuertemente
relacionada
con
el
manejador
de
sucesos:
Manejador
de
sucesos
El
manejador
de
sucesos
es
un
componente
de
IBM
Tivoli
Directory
Integrator
que
reside
fuera
de
las
líneas
de
ensamblaje.
Generalmente,
se
utilizan
para
captar
notificaciones
de
sucesos
procedentes
de
la
infraestructura
y,
a
continuación,
para
enviar
estos
sucesos
a
una
o
más
líneas
de
ensamblaje.
Por
ejemplo,
puede
establecer
un
manejador
de
sucesos
para
sondear
un
URL
de
FTP
y,
a
continuación,
puede
iniciar
una
línea
de
ensamblaje
para
procesar
los
archivos
a
medida
que
van
apareciendo.
4
IBM
Tivoli
Directory
Integrator
5.2:
Guía
del
usuario
-
Flujo
de
la
línea
de
ensamblaje
Las
líneas
de
ensamblaje
proporcionan
un
comportamiento
automatizado
incorporado
que
le
ayuda
a
crear
y
desplegar
rápidamente
los
flujos
de
datos.
Este
comportamiento
automatizado
se
denomina
flujo
de
la
línea
de
ensamblaje.
El
flujo
de
la
línea
de
ensamblaje
efectúa
la
secuencia
siguiente
de
acciones:
Prólogos
(Antes
de
Initialize)
En
primer
lugar,
si
está
definido
algún
prólogo
global
en
la
biblioteca
de
scripts,
entonces
se
evalúa.
A
continuación,
viene
el
enganche
Antes
de
inicializar
los
conectores
(cuya
etiqueta
en
el
editor
de
configuraciones
es
Prólogo
–
Antes
de
Initialize
y
se
encuentra
en
la
pestaña
Enganches
de
la
línea
de
ensamblaje).
Dado
que
este
prólogo
de
la
línea
de
ensamblaje
se
ejecuta
antes
de
que
se
inicialicen
los
conectores,
es
un
lugar
correcto
para
preparar
los
archivos
que
uno
o
varios
conectores
están
esperando
(por
ejemplo,
el
resultado
de
un
archivo
de
entrada
procesado
previamente)
e
incluso
para
cambiar
los
parámetros
específicos
de
los
conectores
como
por
ejemplo,
las
direcciones
del
servidor,
los
parámetros
de
autenticación,
los
filtros
de
búsqueda
y
los
nombres
de
vías
de
acceso.
Inicialización
del
conector
La
secuencia
de
inicialización
se
realiza
para
cada
conector
individualmente,
según
el
orden
definido
en
la
línea
de
ensamblaje.
Para
cada
conector
el
flujo
es
el
siguiente:
1.
Se
llama
al
enganche
Prólogo
–
Antes
de
Initialize
del
conector.
2.
Se
activa
el
conector
y
se
conecta
al
origen
de
datos
subyacente
o
de
destino.
3.
Si
el
conector
está
en
modalidad
Iterator,
entonces
se
procesa
el
enganche
Prólogo
–
Antes
de
Selection
y
el
conector
selecciona
la
entrada
(activa
una
llamada
específica
del
origen
de
datos
como,
por
ejemplo,
ejecutar
una
sentencia
SQL
SELECT
o
una
búsqueda
ldap).
4.
Se
evalúa
el
enganche
Prólogo
–
Después
de
Selection.
5.
Se
llama
al
enganche
Prólogo
–
Después
de
Initialize
(independientemente
de
la
modalidad).
Si
falla
la
inicialización
de
un
conector,
entonces
el
flujo
de
la
línea
de
ensamblaje
pasa
al
enganche
Prólogo
–
En
caso
de
error
donde
puede
tratar
este
error.
Nota:
en
esta
fase
se
evalúan
los
conectores
de
script
(los
conectores
que
se
implementan
utilizando
un
lenguaje
de
scripts)
de
modo
que
las
funciones
de
los
conectores
necesarias
queden
registradas
y
se
ejecute
el
código
de
inicialización.
Configuración
del
iterador
Si
se
han
definido
uno
o
varios
iteradores
(los
conectores
en
modalidad
Iterator),
entonces
se
procesa
su
enganche
Prólogo
–
Antes
de
Selection
y
cada
iterador
obtiene
una
vista
del
origen
de
datos
conectado
llamando
a
la
función
selectEntries()
subyacente
de
la
inteligencia
del
origen
de
datos
del
conector
(conocido
también
como
conector
en
bruto).
Esto
hace
que
el
conector
active
una
llamada
específica
del
origen
de
datos
como,
por
ejemplo,
una
sentencia
SQL
SELECT
o
ldapsearch.
Una
vez
seleccionadas
las
entradas,
se
llama
al
enganche
Prólogo
–
Después
de
Selection
para
cada
iterador.
Prólogos
(Después
de
Initialize)
Se
ejecuta
el
enganche
Prólogo–
Después
de
Initialize
de
cada
conector.
Capítulo
2.
Conceptos
de
IBM
Tivoli
Directory
Integrator
5
-
Ciclos
de
la
línea
de
ensamblaje
Una
vez
finalizada
la
inicialización,
se
inicia
el
ciclo
de
la
línea
de
ensamblaje
y
se
pasa
el
control
al
primer
conector.
Si
tiene
uno
o
varios
iteradores
en
la
línea
de
ensamblaje,
el
primero
iniciará
el
ciclo
realizando
una
llamada
getNext()
y
recuperando
la
primera
entrada
del
sistema
conectado.
Cuando
este
iterador
termina
de
obtener
y
correlacionar
los
atributos,
pasa
el
control
al
siguiente
conector
que
no
sea
iterador,
el
cual
realiza
su
trabajo
y
a
su
vez
pasa
el
control
al
conector
siguiente
y
así
sucesivamente.
Cuando
se
alcanza
el
final
de
la
línea
de
ensamblaje,
se
vacía
la
entrada
work
y
si
todavía
queda
como
mínimo
un
iterador
activo,
el
flujo
pasa
al
principio
de
la
línea
de
ensamblaje
y
se
recupera
la
entrada
siguiente.
En
los
casos
de
varios
iteradores,
el
primer
iterador
continúa
alimentando
la
línea
de
ensamblaje
con
datos
hasta
que
se
agota
su
conjunto
de
resultados.
A
continuación,
el
segundo
iterador
comienza
a
recuperar
datos
de
su
origen.
Cuando
finalizan
los
datos
de
entrada,
se
detiene
la
línea
de
ensamblaje.
La
línea
de
ensamblaje
se
detiene
también
si
se
produce
un
error
no
manejado.
Epílogo
(Antes
de
Close)
Se
procesa
el
enganche
de
la
línea
de
ensamblaje
denominado
Epílogo
–
Antes
de
Close.
Cierre
de
conectores
Ahora
los
enganches
de
epílogo
de
conectores
se
llaman
en
el
orden
en
que
aparecen
en
el
editor
de
configuraciones:
1.
El
enganche
Antes
de
Close.
2.
La
conexión
con
el
origen
de
datos
se
cierra.
3.
El
enganche
Después
de
Close.
Epílogo
(Después
de
Close)
Finalmente,
se
ejecuta
el
enganche
de
la
línea
de
ensamblaje
Epílogo
–
Después
de
Close.v
Como
se
ha
mencionado
anteriormente,
si
tiene
más
de
un
conector
en
modalidad
Iterator
(consulte
el
apartado
“Modalidades
del
conector”
en
la
página
13),
estos
conectores
se
apilan
en
el
orden
en
que
se
muestran
en
la
configuración
(de
arriba
abajo).
Por
ejemplo,
si
tiene
dos
iteradores,
a
y
b,
entonces
se
llama
a
a
hasta
que
no
devuelva
más
entradas
antes
de
que
la
línea
de
ensamblaje
pase
a
b.
v
Si
no
tienen
ningún
conector
en
modalidad
Iterator
y
no
se
ha
proporcionado
una
IWE
(entrada
de
trabajo
inicial)
a
la
línea
de
ensamblaje
cuando
se
inicia,
por
ejemplo,
llamando
a
un
manejador
de
sucesos,
y
si
no
se
ha
creado
una
entrada
work
en
el
enganche
Prólogo
de
la
línea
de
ensamblaje
o
del
conector,
entonces
la
línea
de
ensamblaje
realizará
un
solo
paso.
Finalmente,
hay
un
enganche
Solicitud
de
conclusión
en
el
que
puede
colocar
código
que
se
procese
si
la
línea
de
ensamblaje
se
cierra
correctamente
debido
a
una
solicitud
externa
de
conclusión
(esto
es,
la
línea
de
ensamblaje
no
se
detiene
anormalmente)
lo
que
le
permite
realizar
una
conclusión
con
normalidad.
Dispone
de
funciones
especiales
del
objeto
system
para
ignorar
o
reintentar
la
entrada
work
actual,
al
igual
que
para
ignorar
un
conector,
etc.
Consulte
el
apartado
“Control
del
flujo
de
una
línea
de
ensamblaje”
en
la
página
29,
para
obtener
información
detallada.
6
IBM
Tivoli
Directory
Integrator
5.2:
Guía
del
usuario
-
Inicio
de
una
línea
de
ensamblaje
en
el
editor
de
configuraciones
de
IBM
Tivoli
Directory
Integrator
–
ibmditk
Cuando
inicia
una
línea
de
ensamblaje
en
el
editor
de
configuraciones,
generalmente
tiene
como
mínimo
un
conector
funcionando
en
modalidad
Iterator
(a
menos
que
proporcione
la
línea
de
ensamblaje
con
una
entrada
de
trabajo
inicial).
Si
no
tiene
un
iterador,
y
no
se
proporciona
una
entrada
de
trabajo
inicial,
entonces
la
línea
de
ensamblaje
no
tiene
alimentación
de
datos
y
no
realiza
ningún
trabajo.
Como
se
ha
indicado
anteriormente,
también
puede
tener
varios
conectores
configurados
como
iteradores.
La
línea
de
ensamblaje
se
inicia
con
el
primer
iterador
y
continúa
con
el
siguiente
iterador
después
de
que
el
anterior
alcance
el
final
de
su
conjunto
de
datos.
Inicio
de
una
línea
de
ensamblaje
desde
un
manejador
de
sucesos
o
script
Consulte
el
apartado
“Pase
de
parámetros
de
la
línea
de
ensamblaje”
para
obtener
más
información.
Acceso
a
conectores
en
la
línea
de
ensamblaje
Cada
conector
está
disponible
para
los
scripts
de
la
línea
de
ensamblaje
como
una
variable
de
script
con
el
nombre
seleccionado
para
el
conector
cuando
fue
añadido
a
la
línea
de
ensamblaje.
Tenga
en
cuenta
que
puede
cargar
dinámicamente
conectores
desde
sus
scripts
utilizando
la
función
system.getConnector(),
aunque
esta
no
es
una
tarea
para
usuarios
sin
experiencia.
El
objeto
conector
que
obtiene
de
esta
llamada
es
un
objeto
conector
en
bruto
y
es
la
parte
específica
del
origen
datos
de
un
conector
de
línea
de
ensamblaje.
Cuando
cambia
el
tipo
de
cualquier
conector,
realmente
está
intercambiando
su
inteligencia
de
origen
de
datos
(el
conector
en
bruto)
que
proporciona
las
funciones
para
acceder
a
los
datos
de
un
sistema,
servicio
o
almacén
de
datos
específico.
La
mayor
parte
de
las
funciones
de
un
conector
de
línea
de
ensamblaje,
incluidas
las
correlaciones
de
atributos,
los
criterios
de
enlace
y
los
enganches
las
proporciona
el
kernel
de
IBM
Tivoli
Directory
Integrator
y
se
mantiene
intacto
cuando
intercambia
los
tipos
de
conectores.
Pase
de
parámetros
de
la
línea
de
ensamblaje
Hay
tres
formas
de
pasar
datos
a
una
línea
de
ensamblaje:
v
Generar
su
propia
entrada
inicial
en
la
línea
de
ensamblaje
(por
ejemplo,
en
un
script
de
prólogo).
v
Alimentarla
desde
uno
o
varios
iteradores.
v
Iniciar
la
línea
de
ensamblaje
con
parámetros
de
otra
línea
de
ensamblaje
o
manejador
de
sucesos.
Si
desea
iniciar
una
línea
de
ensamblaje
con
parámetros
de
otra
línea
de
ensamblaje
o
manejador
de
sucesos,
entonces
tiene
dos
opciones:
v
Utilizar
el
método
TCB
(bloque
de
llamada
de
tareas),
que
es
el
preferido.
v
Proporcionar
directamente
una
entrada
de
trabajo
inicial.
Nota:
esta
posibilidad
se
proporciona
por
motivos
de
compatibilidad
con
versiones
anteriores.
Capítulo
2.
Conceptos
de
IBM
Tivoli
Directory
Integrator
7
-
TCB
(bloque
de
llamada
de
tareas)
Uso
básico:
el
TCB
(bloque
de
llamada
de
tareas)
lo
utiliza
un
llamante
para
establecer
varios
parámetros
de
una
línea
de
ensamblaje.
El
TCB
puede
proporcionar
al
usuario
una
lista
de
parámetros
de
entrada
o
salida
especificados
mediante
una
línea
de
ensamblaje
(como
se
define
en
la
pestaña
Llamada/Retorno
de
la
línea
de
ensamblaje)
y
también
permite
al
llamante
establecer
parámetros
para
los
conectores
de
la
línea
de
ensamblaje.
El
TCB
consta
de
las
secciones
lógicas
siguientes:
v
La
entrada
de
trabajo
inicial
pasada
a
la
línea
de
ensamblaje:
tcb.setInitalWorkEntry()
v
Los
parámetros
del
conector:
tcb.setConnectorParameter()
v
Las
normas
de
correlación
de
entrada/salida
para
la
línea
de
ensamblaje
(establecidas
en
el
editor
de
configuraciones
bajo
la
pestaña
Llamada/Retorno)
v
Un
objeto
acumulador
que
recibe
todas
las
entradas
work
de
la
línea
de
ensamblaje:
tcb.setAccumulator()
Por
ejemplo,
iniciar
una
línea
de
ensamblaje
con
una
entrada
de
trabajo
inicial
y
establecer
el
parámetro
filePath
de
un
conector
llamado
MyInput
a
"d:\myinput.txt"
se
consigue
con
el
código
siguiente:
var
tcb
=
system.newTCB();
//
Crear
un
TCB
nuevo
var
myIWE
=
system.newEntry();
//
Crear
un
objeto
de
entrada
nuevo
myIWE.setAttribute("name","John
Doe");
//
Añadir
un
atributo
a
myIWE
tcb.setInitialWorkEntry
(
myIWE
)
//
Establecer
la
IWE
y
el
parámetro
//
(más
abajo);
//
Tenga
en
cuenta
que
dado
que
se
trata
de
una
cadena
JavaScript,
//
la
barra
inclinada
debe
utilizarse
como
"escape"
//
o
se
debe
utilizar
una
barra
invertida
(sintaxis
de
Windows)
tcb.setConnectorParameter
(
"MyInput",
"filePath",
"d:\myinput.txt"
);
var
al
=
main.startAL
(
"MyAssemblyLine",
tcb
)
//
Iniciar
AL
con
tcb;
Utilización
de
un
acumulador:
como
se
ha
indicado
anteriormente,
también
puede
pasar
un
objeto
acumulador
a
una
línea
de
ensamblaje
con
TCB.
Un
acumulador
también
puede
ser
uno
de
los
siguientes:
java.util.Collection
Todas
las
entradas
work
se
clonan
y
se
añaden
a
la
colección
(por
ejemplo,
ArrayList,
Vector,
etc.).
com.ibm.di.server.ConnectorInterface
(Conector
en
bruto)
Se
llama
al
método
putEntry()
para
este
conector
en
bruto
con
la
entrada
work
al
final
de
cada
ciclo
de
la
línea
de
ensamblaje.
com.ibm.di.server.ParserInterface
(Analizador)
Se
llama
al
método
writeEntry()
para
este
analizador
con
la
entrada
work
al
final
de
cada
ciclo
de
la
línea
de
ensamblaje.
com.ibm.di.server.AssemblyLineComponent
(Conector
de
línea
de
ensamblaje)
Se
llama
al
método
add()
para
este
analizador
con
la
entrada
work
al
final
de
cada
ciclo
de
la
línea
de
ensamblaje.
Si
el
acumulador
no
es
una
de
estas
clases
o
interfaces,
se
genera
una
excepción.
Por
ejemplo,
para
acumular
todas
las
entradas
work
de
una
línea
de
ensamblaje
en
un
archivo
XML
puede
hacer
lo
siguiente:
var
parser
=
system.getParser
(
"nombre_ejemplo.XML"
);
//
Obtener
un
analizador
//
Configurarlo
para
escribir
en
archivo
parser.setOutputStream
(
new
java.io.FileOutputStream
(
"d:/accum.xml"
));
8
IBM
Tivoli
Directory
Integrator
5.2:
Guía
del
usuario
-
parser.initParser();
//
Inicializarlo.
tcb.setAccumulator
(
parser
);
//
Establecer
el
analizador
//
en
tcb
var
al
=
main.startAL
(
"MyAssemblyLine",
tcb
);
//
Iniciar
AL
con
tcb
al.join();
//
Esperar
a
que
AL
finalice
parser.closeParser();
//
Cerrar
el
analizador
-
esto
vacía
y
//
cierre
el
archivo
de
salida.
Por
supuesto,
puede
configurar
un
conector
en
lugar
de
programar
manualmente
el
analizador
como
en
el
ejemplo
siguiente:
var
connector
=
system.getConnector("myFileSysConnWithXMLParser");
tcb.setAccumulator
(
connector
);
var
al
=
main.startAL(
"MyAssemblyLine",
tcb);
al.join();
connector.terminate();
Generalmente,
el
TCB
lo
inicializa
el
usuario
y
luego
lo
utiliza
la
línea
de
ensamblaje.
Si
la
línea
de
ensamblaje
tiene
una
especificación
Llamada/Retorno,
el
TCB
vuelve
a
correlacionar
los
atributos
de
entrada
con
la
entrada
de
trabajo
inicial
como
espera
la
línea
de
ensamblaje
y,
del
mismo
modo,
para
establecer
el
objeto
resultante.
Esto
se
lleva
a
cabo
para
que
la
interfaz
de
llamada
externa
a
una
línea
de
ensamblaje
pueda
permanecer
igual
incluso
si
cambian
los
nombres
internos
de
la
entrada
work
en
la
línea
de
ensamblaje.
Una
vez
se
pasa
el
TCB
a
una
línea
de
ensamblaje,
no
debe
esperar
nada
más
del
TCB.
Utilice
getResult()
y
getStats()
de
la
línea
de
ensamblaje
para
recuperar
el
objeto
de
resultado
y
las
estadísticas.
La
correlación
de
resultados
de
TCB
se
efectúa
antes
del
Epílogo
y
de
ese
modo
puede
acceder
al
resultado
final
antes
de
que
lo
obtenga
el
llamante
de
la
línea
de
ensamblaje.
Suministro
de
una
IWE
(entrada
de
trabajo
inicial)
Este
es
un
método
alternativo
de
pasar
parámetros
y
está
soportado
por
motivos
de
compatibilidad
con
versiones
anteriores.
Cuando
se
inicia
una
línea
de
ensamblaje
con
el
mandato
system.startAL()
mediante
un
manejador
de
sucesos
o
desde
un
script,
todavía
se
pueden
pasar
parámetros
a
la
línea
de
ensamblaje
que
se
alimentan
configurando
valores
de
atributo
o
de
propiedades
en
la
entrada
de
trabajo
inicial
(a
la
que
se
accede
mediante
la
variable
work).
A
continuación,
el
usuario
debe
aplicar
estos
valores
para
establecer
los
parámetros
del
conector
(por
ejemplo,
en
el
enganche
de
la
línea
de
ensamblaje
Prólogo
–
Initialize
utilizando
la
función
nombreConector.setParam().
Nota:
el
usuario
debe
borrar
la
entrada
work
con
la
llamada
task.setWork(null),
de
lo
contrario,
los
iteradores
de
la
línea
de
ensamblaje
pasan
por
el
primer
ciclo.
Puede
examinar
el
resultado
de
la
línea
de
ensamblaje
(que
es
la
entrada
work
cuando
se
detiene
la
línea
de
ensamblaje)
utilizando
la
función
getResult().
Consulte
también
el
apartado
″(runtime
provided)
Connector″
de
la
publicación
IBM
Tivoli
Directory
Integrator
5.2:
Reference
Guide.
Capítulo
2.
Conceptos
de
IBM
Tivoli
Directory
Integrator
9
-
El
siguiente
es
un
ejemplo
de
cómo
pasar
un
valor
de
parámetro
del
conector
con
una
IWE:
var
entry
=
system.newEntry();
entry.setAttribute
("userNameForLookup",
"John
Doe");
//
Aquí
comienza
la
línea
de
ensamblaje
var
al
=
main.startAL
(
"EmailLookupAL",
entry
);
//
esperar
a
que
la
línea
de
ensamblaje
finalice
al.join();
var
result
=
al.getResult();
//
presupone
que
la
línea
de
ensamblaje
establece
el
atributo
mail
en
//
su
entrada
de
trabajo
task.logmsg
("Correo
electrónico
devuelto
=
"
+
result.getString("mail"));
Cajón
de
arena
IBM
Tivoli
Directory
Integrator
incluye
una
función
de
cajón
de
arena
que
permite
al
usuario
registrar
el
funcionamiento
de
uno
o
varios
conectores
en
una
línea
de
ensamblaje
para
reproducirlos
posteriormente
sin
que
sea
necesario
que
los
orígenes
de
datos
estén
disponibles.
Esta
función
utiliza
el
recurso
del
almacén
del
sistema.
Consulte
el
apartado
“Almacén
del
sistema”
en
la
página
50,
para
obtener
información
acerca
del
almacén
del
sistema.
Antes
de
poder
registrar
o
reproducir
una
línea
de
ensamblaje,
debe
indicar
a
IBM
Tivoli
Directory
Integrator
donde
ha
de
almacenar
los
datos
de
registro
de
la
línea
de
ensamblaje.
Esto
se
lleva
a
cabo
en
la
pestaña
Cajón
de
arena
de
la
ventana
de
detalles
de
la
línea
de
ensamblaje.
En
la
parte
superior
de
esta
pantalla
hay
un
campo
con
la
etiqueta
Base
de
datos
donde
puede
escribir
la
vía
de
acceso
del
directorio
para
que
lo
utilice
el
sistema.
Registro
de
entradas
de
la
línea
de
ensamblaje
Cuando
haya
configurado
la
vía
de
acceso
de
la
base
de
datos
del
almacén
de
usuario
que
se
ha
de
utilizar,
debe
seleccionar
los
conectores
que
se
van
a
registrar.
Esto
también
se
lleva
a
cabo
en
la
pestaña
Cajón
de
arena
de
la
línea
de
ensamblaje.
Esta
pestaña
le
presenta
la
lista
de
conectores
de
la
línea
de
ensamblaje,
cada
línea
le
ofrece
los
recuadros
de
selección
Registro
habilitado
y
Reproducción
habilitada.
Para
poder
registrar
las
operaciones
de
un
conector,
simplemente
seleccione
Registro
habilitado
para
dicho
conector.
Para
iniciar
el
registro
de
la
línea
de
ensamblaje,
seleccione
Registro
en
la
lista
desplegable
junto
al
botón
Ejecutar
de
la
parte
superior
de
la
ventana
de
detalles
de
la
línea
de
ensamblaje.
Ahora
cuando
ejecute
la
línea
de
ensamblaje,
todas
las
operaciones
de
acceso
a
datos
se
registran
para
los
conectores
seleccionados.
Para
ejecutar
una
línea
de
ensamblaje
en
modalidad
de
Registro
desde
la
línea
de
mandatos,
inicie
el
servidor
con
el
conmutador
-qr.
Cuando
está
en
Modalidad
de
registro,
la
línea
de
ensamblaje
guarda
todo
el
contenido
que
recibe
de
los
conectores
en
bruto
(los
atributos
y
propiedades)
y
también
el
TCB
si
éste
se
ha
pasado
a
la
línea
de
ensamblaje.
En
realidad,
solamente
se
registran
los
datos
de
los
conectores
de
entrada
(los
conectores
en
modalidad
Iterator,
Lookup
o
CallReply).
Durante
el
registro
se
ignoran
los
datos
de
los
conectores
que
efectúan
la
salida
(en
modalidad
Update,
Add
o
Delete)
pero
se
registran
los
mensajes
de
error
generados
por
el
conector
en
bruto
y
se
reproducen
posteriormente
durante
la
reproducción.
10
IBM
Tivoli
Directory
Integrator
5.2:
Guía
del
usuario
-
Reproducción
del
cajón
de
arena
de
los
registros
de
la
línea
de
ensamblaje
Cuando
una
línea
de
ensamblaje
está
en
modalidad
de
cajón
de