IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

90
IBM Tivoli Directory Integrator 5.2 - Guide d’initiation SC11-2083-00

Transcript of IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Page 1: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

IBM

Tivoli

Directory

Integrator

5.2

-

Guide

d’initiation

SC11-2083-00

���

Page 2: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation
Page 3: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

IBM

Tivoli

Directory

Integrator

5.2

-

Guide

d’initiation

SC11-2083-00

���

Page 4: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Important

Avant

d’utiliser

le

présent

document

et

le

produit

associé,

prenez

connaissance

des

informations

générales

figurant

à

l’Annexe

B,

«Remarques»,

à

la

page

73.

Remarque

Certaines

captures

d’écrans

de

ce

manuel

ne

sont

pas

disponibles

en

français

à

la

date

d’impression.

Première

édition

-

février

2004

Réf.

US

:

SC32-1382-00

LE

PRESENT

DOCUMENT

EST

LIVRE

″EN

L’ETAT″.

IBM

DECLINE

TOUTE

RESPONSABILITE,

EXPRESSE

OU

IMPLICITE,

RELATIVE

AUX

INFORMATIONS

QUI

Y

SONT

CONTENUES,

Y

COMPRIS

EN

CE

QUI

CONCERNE

LES

GARANTIES

DE

QUALITE

MARCHANDE

OU

D’ADAPTATION

A

VOS

BESOINS.

Certaines

juridictions

n’autorisent

pas

l’exclusion

des

garanties

implicites,

auquel

cas

l’exclusion

ci-dessus

ne

vous

sera

pas

applicable.

Ce

document

est

mis

à

jour

périodiquement.

Chaque

nouvelle

édition

inclut

les

mises

à

jour.

Les

informations

qui

y

sont

fournies

sont

susceptibles

d’être

modifiées

avant

que

les

produits

décrits

ne

deviennent

eux-mêmes

disponibles.

En

outre,

il

peut

contenir

des

informations

ou

des

références

concernant

certains

produits,

logiciels

ou

services

non

annoncés

dans

ce

pays.

Cela

ne

signifie

cependant

pas

qu’ils

y

seront

annoncés.

Pour

plus

de

détails,

pour

toute

demande

d’ordre

technique,

ou

pour

obtenir

des

exemplaires

de

documents

IBM,

référez-vous

aux

documents

d’annonce

disponibles

dans

votre

pays,

ou

adressez-vous

à

votre

partenaire

commercial.

Vous

pouvez

également

consulter

les

serveurs

Internet

suivants

:

v

http://www.fr.ibm.com

(serveur

IBM

en

France)

v

http://www.can.ibm.com

(serveur

IBM

au

Canada)

v

http://www.ibm.com

(serveur

IBM

aux

Etats-Unis)

Compagnie

IBM

France

Direction

Qualité

Tour

Descartes

92066

Paris-La

Défense

Cedex

50

©

Copyright

IBM

France

2004.

Tous

droits

réservés.

©

Copyright

International

Business

Machines

Corporation

2002,

2003.

All

rights

reserved.

Page 5: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Préface

Le

présent

document

contient

les

informations

nécessaires

pour

administrer

IBM

Tivoli

Directory

Integrator.

Public

concerné

Ce

manuel

s’adresse

aux

administrateurs

système

et

aux

personnes

souhaitant

en

savoir

plus

sur

IBM

Tivoli

Directory

Integrator.

Publications

Reportez-vous

aux

descriptions

de

la

bibliothèque

IBM

Tivoli

Directory

Integrator

pour

déterminer

les

publications

qui

pourraient

vous

être

utiles.

Après

avoir

déterminé

les

publications

dont

vous

avez

besoin,

consultez

les

instructions

d’accès

aux

publications

en

ligne.

Bibliothèque

IBM

Tivoli

Directory

Integrator

La

bibliothèque

IBM

Tivoli

Directory

Integrator

comprend

les

publications

suivantes

:

IBM

Tivoli

Directory

Integrator

5.2

:

Lisez-moi

Ce

document

contient

des

informations

de

dernière

minute

sur

IBM

Tivoli

Directory

Integrator

5.2.

IBM

Tivoli

Directory

Integrator

5.2

:

Guide

d’initiation

Ce

document

contient

un

didacticiel

et

une

introduction

à

IBM

Tivoli

Directory

Integrator

5.2.

IBM

Tivoli

Directory

Integrator

5.2

:

Administrator

Guide

Ce

document

contient

des

informations

complètes

sur

l’installation

d’IBM

Tivoli

Directory

Integrator.

Il

explique

comment

migrer

une

version

IBM

Tivoli

Directory

Integrator

antérieure.

Par

ailleurs,

il

explique

comment

configurer

la

fonctionnalité

de

journalisation

d’IBM

Tivoli

Directory

Integrator.

IBM

Tivoli

Directory

Integrator

5.2

:

Guide

d’utilisation

Ce

document

explique

comment

utiliser

IBM

Tivoli

Directory

Integrator

5.2.

Il

explique

comment

concevoir

des

solutions

avec

IBM

Tivoli

Directory

Integrator

(ibmditk)

et

exécuter

des

solutions

prêtes

à

l’emploi

avec

une

ligne

de

commande

(ibmdisrv).

Il

contient

également

des

informations

sur

les

interfaces,

les

concepts,

la

création

et

la

gestion

de

lignes

d’assemblage

et

de

gestionnaires

d’événements.

Par

ailleurs,

il

propose

des

exemples

pour

créer

des

interactions

et

des

exercices

pratiques

sur

IBM

Tivoli

Directory

Integrator

5.2.

IBM

Tivoli

Directory

Integrator

5.2

:

Guide

de

référence

Ce

document

contient

des

informations

détaillées

sur

chaque

composant

de

la

ligne

d’assemblage

IBM

Tivoli

Directory

Integrator

5.2

(connecteurs,

gestionnaires

d’événements,

interpréteurs,

modules

d’extension).

©

Copyright

IBM

Corp.

2002,

2003

iii

Page 6: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Publications

connexes

Pour

en

savoir

plus

sur

IBM

Tivoli

Directory

Integrator,

consultez

les

publications

suivantes

:

v

IBM

Tivoli

Directory

Integrator

5.2

utilise

le

client

JNDI

de

Sun

Microsystems.

Pour

plus

d’informations

sur

le

client

JNDI,

consultez

le

document

Java

Naming

and

Directory

Interface

1.2.1

Specification

sur

le

site

Web

de

Sun

Microsystems

à

l’adresse

:

http://java.sun.com/products/jndi/1.2/javadoc/index.html.

v

La

bibliothèque

de

logiciels

Tivoli

propose

plusieurs

publications

Tivoli,

notamment

des

livres

blancs,

des

documents,

des

démonstrations,

des

redbooks

et

des

lettres

d’annonce.

La

bibliothèque

de

logiciels

Tivoli

est

disponible

sur

Internet

à

l’adresse

:

http://www.ibm.com/software/tivoli/library/

v

Le

Glossaire

des

logiciels

Tivoli

contient

les

définitions

de

nombreux

termes

techniques

se

rapportant

aux

logiciels

Tivoli.

Pour

télécharger

le

Glossaire

des

logiciels

Tivoli,

visitez

le

site

Web

à

l’adresse

:

http://publib.boulder.ibm.com/tividd/glossary/GlossTranslated.htm

Accès

aux

publications

en

ligne

Les

publications

sur

ce

produit

sont

disponibles

en

ligne

au

format

PDF

(Portable

Document

Format)

et/ou

HTML

(Hypertext

Markup

Language)

dans

la

bibliothèque

des

logiciels

Tivoli

à

l’adresse

:

http://www.ibm.com/software/tivoli/library.

Pour

rechercher

des

publications

produit

dans

la

bibliothèque,

cliquez

sur

le

lien

Product

manuals

à

gauche

de

la

page

Library.

Dans

la

page

Tivoli

Information

Center,

cliquez

sur

le

produit

de

votre

choix.

Organisé

par

produit,

le

site

propose

différents

documents

:

fichiers

Lisez-moi,

guides

d’installation,

d’utilisation

et

d’administration,

références

pour

développeurs.

Remarque

:

Pour

imprimer

correctement

les

publications

PDF,

cochez

la

case

Ajuster

dans

la

fenêtre

Imprimer

d’Adobe

Acrobat

(qui

apparaît

lorsque

vous

cliquez

sur

Fichier->Imprimer).

Accessibilité

Les

fonctions

d’accessibilité

permettent

aux

utilisateurs

présentant

une

incapacité

physique,

telle

qu’une

mobilité

restreinte

ou

une

vision

réduite,

d’utiliser

les

produits

logiciels

aisément.

Avec

ce

produit,

vous

pouvez

utiliser

des

technologies

d’assistance

au

handicap

qui

vous

permettent

d’entendre

et

de

vous

déplacer

dans

l’interface.

Après

installation,

vous

pouvez

également

vous

servir

du

clavier

au

lieu

de

la

souris

pour

utiliser

toutes

les

fonctions

de

l’interface

graphique.

iv

IBM

Tivoli

Directory

Integrator

5.2

-

Guide

d’initiation

Page 7: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Centre

de

support

logiciel

Avant

de

contacter

le

centre

de

support

logiciel

IBM

Tivoli

pour

un

problème,

visitez

le

site

Web

IBM

System

Management

and

Tivoli

Software

Web

à

l’adresse

:

http://www.ibm.com/software/sysmgmt/products/support/

Si

vous

avez

besoin

d’une

aide

supplémentaire,

contactez

le

centre

de

support

logiciel

en

utilisant

les

méthodes

décrites

dans

le

document

IBM

Software

Support

Guide

disponible

sur

Internet

à

l’adresse

:

http://techsupport.services.ibm.com/guides/handbook.html

Ce

guide

contient

des

informations

sur

les

points

suivants

:

v

Enregistrement

et

admissibilité

pour

bénéficier

d’une

assistance

v

Numéros

de

téléphone

et

adresses

électroniques

correspondant

à

votre

pays

v

Liste

des

informations

à

rassembler

avant

de

contacter

le

centre

de

support

client

Préface

v

Page 8: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

vi

IBM

Tivoli

Directory

Integrator

5.2

-

Guide

d’initiation

Page 9: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Table

des

matières

Préface

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. iii

Public

concerné

.

.

.

.

.

.

.

.

.

.

.

.

. iii

Publications

.

.

.

.

.

.

.

.

.

.

.

.

.

. iii

Bibliothèque

IBM

Tivoli

Directory

Integrator

.

. iii

Publications

connexes

.

.

.

.

.

.

.

.

.

. iv

Accès

aux

publications

en

ligne

.

.

.

.

.

.

. iv

Accessibilité

.

.

.

.

.

.

.

.

.

.

.

.

.

. iv

Centre

de

support

logiciel

.

.

.

.

.

.

.

.

.

. v

Avis

aux

lecteurs

canadiens

.

.

.

.

.

. ix

Chapitre

1.

Introduction

.

.

.

.

.

.

.

. 1

A

propos

de

ce

guide

.

.

.

.

.

.

.

.

.

.

. 1

Langages

de

rédaction

des

scripts

.

.

.

.

.

.

. 2

Installation

d’IBM

Tivoli

Directory

Integrator

.

.

. 2

Installation

des

fichiers

didacticiels

.

.

.

.

.

.

. 2

Chapitre

2.

Simplification

et

résolution

. 3

Comment

avaler

une

portion

éléphantesque

?

.

.

. 3

L’intégration

synonyme

de

communication

.

.

.

. 3

Architecture

.

.

.

.

.

.

.

.

.

.

.

.

.

. 6

Lignes

d’assemblage

.

.

.

.

.

.

.

.

.

.

.

. 7

Connecteurs

.

.

.

.

.

.

.

.

.

.

.

.

.

. 8

Interpréteurs

.

.

.

.

.

.

.

.

.

.

.

.

.

. 9

Gestionnaires

d’événements

.

.

.

.

.

.

.

.

. 10

Chapitre

3.

Présentation

d’IBM

Tivoli

Directory

Integrator

.

.

.

.

.

.

.

.

. 11

Développement

d’intégration

rapide

.

.

.

.

.

. 11

Création

d’une

nouvelle

configuration

.

.

.

.

. 12

Création

d’une

ligne

d’assemblage

.

.

.

.

.

.

. 14

Ajout

du

connecteur

d’entrée

.

.

.

.

.

.

.

. 18

Mappage

d’attributs

dans

la

ligne

d’assemblage

.

. 25

Ajout

du

connecteur

de

sortie

.

.

.

.

.

.

.

. 33

Exécution

de

votre

ligne

d’assemblage

.

.

.

.

. 37

Utilisation

des

crochets

.

.

.

.

.

.

.

.

.

. 40

Conversion

de

schéma

.

.

.

.

.

.

.

.

.

.

. 43

Ajout

du

connecteur

de

jointure

.

.

.

.

.

.

. 45

Configuration

des

critères

de

lien

.

.

.

.

.

.

. 49

Gestionnaires

d’événements

.

.

.

.

.

.

.

.

. 56

Considérations

finales

.

.

.

.

.

.

.

.

.

.

. 70

Annexe

A.

index.html

et

OtherPage.html

.

.

.

.

.

.

.

.

.

.

. 71

index.html

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 71

OtherPage.html

.

.

.

.

.

.

.

.

.

.

.

.

. 71

Annexe

B.

Remarques

.

.

.

.

.

.

.

. 73

Déclaration

de

composants

fournis

par

un

tiers

.

. 75

Déclaration

Apache

.

.

.

.

.

.

.

.

.

.

. 75

Déclaration

Rhino

.

.

.

.

.

.

.

.

.

.

. 76

Marques

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 76

©

Copyright

IBM

Corp.

2002,

2003

vii

Page 10: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

viii

IBM

Tivoli

Directory

Integrator

5.2

-

Guide

d’initiation

Page 11: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Avis

aux

lecteurs

canadiens

Le

présent

document

a

été

traduit

en

France.

Voici

les

principales

différences

et

particularités

dont

vous

devez

tenir

compte.

Illustrations

Les

illustrations

sont

fournies

à

titre

d’exemple.

Certaines

peuvent

contenir

des

données

propres

à

la

France.

Terminologie

La

terminologie

des

titres

IBM

peut

différer

d’un

pays

à

l’autre.

Reportez-vous

au

tableau

ci-dessous,

au

besoin.

IBM

France

IBM

Canada

ingénieur

commercial

représentant

agence

commerciale

succursale

ingénieur

technico-commercial

informaticien

inspecteur

technicien

du

matériel

Claviers

Les

lettres

sont

disposées

différemment

:

le

clavier

français

est

de

type

AZERTY,

et

le

clavier

français-canadien

de

type

QWERTY.

OS/2

et

Windows

-

Paramètres

canadiens

Au

Canada,

on

utilise

:

v

les

pages

de

codes

850

(multilingue)

et

863

(français-canadien),

v

le

code

pays

002,

v

le

code

clavier

CF.

Nomenclature

Les

touches

présentées

dans

le

tableau

d’équivalence

suivant

sont

libellées

différemment

selon

qu’il

s’agit

du

clavier

de

la

France,

du

clavier

du

Canada

ou

du

clavier

des

États-Unis.

Reportez-vous

à

ce

tableau

pour

faire

correspondre

les

touches

françaises

figurant

dans

le

présent

document

aux

touches

de

votre

clavier.

©

Copyright

IBM

Corp.

2002,

2003

ix

Page 12: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Brevets

Il

est

possible

qu’IBM

détienne

des

brevets

ou

qu’elle

ait

déposé

des

demandes

de

brevets

portant

sur

certains

sujets

abordés

dans

ce

document.

Le

fait

qu’IBM

vous

fournisse

le

présent

document

ne

signifie

pas

qu’elle

vous

accorde

un

permis

d’utilisation

de

ces

brevets.

Vous

pouvez

envoyer,

par

écrit,

vos

demandes

de

renseignements

relatives

aux

permis

d’utilisation

au

directeur

général

des

relations

commerciales

d’IBM,

3600

Steeles

Avenue

East,

Markham,

Ontario,

L3R

9Z7.

Assistance

téléphonique

Si

vous

avez

besoin

d’assistance

ou

si

vous

voulez

commander

du

matériel,

des

logiciels

et

des

publications

IBM,

contactez

IBM

direct

au

1

800

465-1234.

x

IBM

Tivoli

Directory

Integrator

5.2

-

Guide

d’initiation

Page 13: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Chapitre

1.

Introduction

A

propos

de

ce

guide

Ce

manuel

est

une

présentation

simple

d’un

système

simple.

Le

terme

simple

est

employé

ici

dans

un

sens

positif

et

pragmatique,

dans

la

mesure

le

meilleur

moyen

pour

appréhender

un

problème

complexe

est

de

le

diviser

en

éléments

plus

simples

et

plus

faciles

à

gérer,

puis

de

maîtriser

chacun

de

ces

éléments

(diviser

et

maîtriser).

Utilisée

naturellement

pour

résoudre

les

incidents

quotidiens,

cette

technique

s’applique

également

à

l’échange

d’informations

techniques

dans

un

bureau,

dans

une

entreprise

ou

à

l’échelle

mondiale.

La

conception

d’IBM

Tivoli

Directory

Integrator

part

du

principe

que

les

problèmes

d’intégration

peuvent

être

divisés

en

trois

éléments

de

base

:

v

Les

systèmes

utilisés

dans

la

communication

v

Les

flots

de

données

échangés

entre

ces

systèmes

v

Les

événements

qui

déclenchent

les

flots

de

données

IBM

Tivoli

Directory

Integrator

vous

permet

de

transformer

cette

vision

″atomique″

du

problème

d’intégration

directement

en

solution.

Vous

pouvez

créer

progressivement

votre

solution,

flot

par

flot,

avec

des

retours

d’informations

et

des

vérifications

constants.

Cela

se

traduit

par

des

projets

d’intégration

plus

faciles

à

évaluer

et

à

planifier.

Parfois

même,

la

planification

se

résume

simplement

à

l’estimation

et

à

la

détermination

des

coûts

des

flots

de

données

individuels

à

implémenter.

En

outre,

comme

vous

développez

la

solution

flot

par

flot

visuellement

et

de

manière

interactive,

vous

pouvez

informer

à

tout

moment

les

responsables

du

projet

et

de

l’entreprise

de

l’état

d’avancement.

IBM

Tivoli

Directory

Integrator

gère

les

aspects

techniques

de

la

connexion

et

de

l’interaction

avec

les

diverses

sources

de

données

que

vous

souhaitez

intégrer,

sans

tenir

compte

des

spécificités

de

leurs

API,

de

leurs

transferts,

de

leurs

protocoles

et

de

leurs

formats.

IBM

Tivoli

Directory

Integrator

privilégie

le

traitement

des

informations

plutôt

que

celui

des

simples

données,

ce

qui

vous

permet

de

vous

concentrer

sur

la

transformation,

le

filtrage

et

les

autres

logiques

applicatives

indispensables

à

tout

échange.

Grâce

à

IBM

Tivoli

Directory

Integrator,

vous

pouvez

créer

et

gérer

des

bibliothèques

de

composants

et

de

logiques

applicatives

que

vous

pouvez

enrichir

et

réutiliser

pour

répondre

à

de

nouvelles

demandes.

Tous

les

projets

développés

au

sein

de

votre

entreprise

peuvent

bénéficier

des

avantages

d’IBM

Tivoli

Directory

Integrator

puisqu’il

offre

la

possibilité

de

développer

des

projets

indépendants

(même

des

solutions

ponctuelles),

qui

s’intègrent

parfaitement

dans

une

infrastructure

cohérente.

Cette

approche

permet

une

utilisation

plus

rationnelle

et

plus

prévisible

des

ressources,

car

vos

experts

en

technologie

et

en

sources

de

données

interviennent

au

tout

début

d’un

projet

pour

créer

vos

bibliothèques.

Une

fois

en

place,

ces

ressources

d’intégration

sont

disponibles

dans

tout

le

réseau,

ce

qui

vous

permet

d’en

tirer

le

meilleur

parti

pour

créer

de

nouvelles

solutions

et

améliorer

celles

déjà

existantes.

©

Copyright

IBM

Corp.

2002,

2003

1

Page 14: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Ce

document

fournit

une

présentation

de

cette

approche,

ainsi

que

des

informations

sur

la

procédure

à

suivre

pour

bénéficier

de

la

simplicité

nette

et

conviviale

d’IBM

Tivoli

Directory

Integrator.

Langages

de

rédaction

des

scripts

IBM

Tivoli

Directory

Integrator

offre

un

environnement

de

pointage

et

de

cliquage

convivial

et

intuitif

qui

vous

permet

de

créer

rapidement

la

structure

de

votre

solution

intégrée.

Cependant,

il

est

probable

que

vous

souhaiterez

très

vite

ajouter

une

logique

de

manipulation

de

données

et

de

transformation

plus

avancée,

ainsi

que

des

règles

métier

pour

le

filtrage

de

vos

données

et

le

contrôle

du

comportement

de

vos

flots

de

données.

Pour

ce

faire,

vous

devez

rédiger

un

script

dans

votre

solution.

Comme

IBM

Tivoli

Directory

Integrator

utilise

la

structure

BSF

(Beans

Scripting

Framework),

vous

disposez

d’un

grand

choix

de

langages

de

rédaction

de

scripts,

notamment

JavaScript,

VBScript

et

PerlScript.

Pour

plus

d’informations

sur

les

langages

de

rédaction

des

scripts,

consultez

le

manuel

IBM

Tivoli

Directory

Integrator

5.2

:

Guide

de

référence.

Installation

d’IBM

Tivoli

Directory

Integrator

IBM

Tivoli

Directory

Integrator

est

un

logiciel

middleware

d’intégration

léger

et

rapide

à

déployer.

Contrairement

aux

produits

middleware

traditionnels,

IBM

Tivoli

Directory

Integrator

s’installe

en

quelques

minutes

et

vous

pouvez

commencer

à

créer,

tester

et

déployer

immédiatement

des

solutions.

Le

système

fonctionne

sur

un

grand

choix

de

plateformes,

y

compris

Windows

et

un

certain

nombre

de

versions

d’UNIX

et

de

Linux.

Pour

plus

d’informations

sur

l’installation

d’IBM

Tivoli

Directory

Integrator,

consultez

la

section

″IBM

Tivoli

Directory

Integrator

installation

instructions″

du

document

IBM

Tivoli

Directory

Integrator

5.2:

Administrator

Guide.

Installation

des

fichiers

didacticiels

Pour

utiliser

les

exemples

fournis

dans

ce

manuel,

vous

avez

besoin

d’installer

les

fichiers

didacticiels

(même

si

vous

pouvez

les

copier

dans

le

manuel).

Pour

accéder

à

ces

fichiers

d’exemples,

allez

dans

le

répertoire

d’exemples

répertoire_racine/examples

situé

dans

l’un

des

répertoires

d’installation.

répertoire_racine

indique

le

répertoire

d’installation

d’IBM

Tivoli

Directory

Integrator.

2

IBM

Tivoli

Directory

Integrator

5.2

-

Guide

d’initiation

Page 15: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Chapitre

2.

Simplification

et

résolution

Comment

avaler

une

portion

éléphantesque

?

La

réponse

est

:

une

bouchée

à

la

fois.

C’est

également

la

meilleure

approche

pour

diriger

des

projets

de

déploiement

de

systèmes

et

d’intégration

de

grande

échelle.

La

clé

de

la

réussite

consiste

à

réduire

la

complexité

en

divisant

le

problème

en

parties

gérables,

car

plus

petites.

Cette

démarche

signifie

commencer

par

une

partie

de

la

solution

générale

et

qui

puisse

de

préférence

être

réalisée

en

une

ou

deux

semaines.

L’idéal

serait

de

choisir

une

partie

qui

pourrait

être

lancée

en

production

de

manière

indépendante.

De

cette

manière,

vous

obtenez

un

retour

sur

investissement

dès

que

vous

abordez

le

reste

de

la

solution.

Après

avoir

isolé

la

partie

à

gérer,

simplifiez-la

davantage

en

vous

concentrant

sur

les

unités

de

communication

de

base

(les

flots

de

données

eux-mêmes).

Vous

êtes

maintenant

prêt

pour

les

implémenter.

Le

développement

de

l’intégration

se

fait

au

moyen

d’IBM

Tivoli

Directory

Integrator

grâce

à

une

série

de

cycles

composés

chacun

d’essais,

de

tests,

puis

de

perfectionnement,

ce

qui

donne

une

dimension

itérative,

voire

exploratoire,

au

processus.

Cette

démarche

vous

permet

non

seulement

d’en

découvrir

davantage

sur

votre

propre

installation,

mais

aussi

de

développer

votre

solution

d’intégration

à

mesure

que

vous

cernez

de

mieux

en

mieux

le

problème

et

son

impact

sur

votre

infrastructure.

Faire

un

dessin

du

problème

à

traiter

est

un

excellent

moyen

d’en

avoir

une

bonne

idée.

A

l’aide

d’un

crayon

et

d’une

feuille

de

papier,

dessinez

un

organigramme

illustrant

la

solution

dans

ses

grandes

lignes.

Non

seulement

cet

exercice

vous

aidera

à

visualiser

l’étendue

de

la

tâche,

mais

il

vous

fournira

un

plan

d’implémentation

dans

IBM

Tivoli

Directory

Integrator.

L’intégration

synonyme

de

communication

Tous

les

problèmes

d’intégration

concernent

la

communication

et

peuvent

en

conséquence

être

décomposés

en

trois

parties

élémentaires

:

v

Les

systèmes

et

unités

en

communication

v

Les

flots

de

données

échangés

entre

ces

systèmes

v

Les

événements

qui

déclenchent

les

flots

de

données

Ces

éléments

constitutifs

d’un

scénario

de

communications

peuvent

être

décrits

comme

suit

:

Sources

de

données

Il

s’agit

des

référentiels

de

données,

des

systèmes

et

des

unités

qui

communiquent

entre

eux.

Par

exemple

:

v

L’annuaire

d’entreprise

que

vous

implémentez

ou

essayez

de

gérer

v

Votre

application

de

gestion

de

la

relation

client

v

Le

système

téléphonique

du

bureau

v

La

base

de

données

Access

avec

la

liste

du

matériel

d’entreprise

et

de

ses

destinataires

©

Copyright

IBM

Corp.

2002,

2003

3

Page 16: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Les

sources

de

données

représentent

une

grande

variété

de

systèmes

et

de

référentiels,

tels

que

les

bases

de

données

(par

exemple,

DB2,

Oracle

et

SQL

Server),

les

annuaires

(par

exemple,

iPlanet,

IBM

Directory

Server,

Domino,

eDirectory

et

Active

Directory),

les

services

d’annuaires

(Exchange),

les

fichiers

(par

exemple,

documents

XML,

LDIF

ou

SOAP),

les

courriers

électroniques

spécialement

formatés

ou

tous

les

mécanismes

d’interface

utilisés

par

les

systèmes

internes

et

les

partenaires

commerciaux

externes

pour

dialoguer

avec

vos

ressources

et

services

d’informations.

Flots

de

données

Les

flots

de

données

sont

les

fils

des

communications

et

de

leur

contenu

et

sont

généralement

représentés

sous

la

formes

de

flèches

correspondant

au

sens

de

déplacement

des

données.

Chaque

flot

de

données

représente

une

communication

entre

plusieurs

systèmes.

Cependant,

pour

qu’une

conversation

ait

un

sens

aux

yeux

de

tous

les

participants,

ceux-ci

doivent

comprendre

les

informations

communiquées.

Les

sources

de

données

représenteront

probablement

leur

contenu

de

différentes

manières.

Un

système

pourrait

représenter

un

numéro

de

téléphone

comme

des

informations

textuelles,

y

compris

les

tirets

et

les

parenthèses

utilisés

pour

en

faciliter

la

lecture.

Un

autre

représenterait

les

numéros

de

téléphone

comme

des

données

numériques.

Pour

que

ces

deux

systèmes

communiquent

ces

données,

les

informations

doivent

être

traduites

au

cours

de

la

conversation.

De

plus,

les

informations

d’une

source

devront

sans

doute

être

complétées

par

des

attributs

d’autres

sources

de

données.

Il

se

peut

également

que

seules

certaines

données

du

flot

soient

utiles

pour

certains

systèmes

destinataires.

C’est

pourquoi

un

flot

de

données

doit

également

inclure

le

mappage,

le

filtrage

et

la

transformation

des

informations,

le

décalage

de

son

contexte

des

sources

d’entrée

vers

celles

des

systèmes

destinataires.

Evénements

Les

événements

peuvent

être

définis

comme

les

circonstances

régissant

la

communication

entre

deux

ensembles

de

sources

de

données.

Un

événement

peut

par

exemple

correspondre

à

l’ajout,

à

la

mise

à

jour

ou

à

la

suppression

d’un

employé

dans

le

système

de

ressources

humaines,

ou

encore

à

la

détection

d’une

carte

d’accès

dans

une

zone

restreinte

par

le

système

de

contrôle

d’accès.

Un

événement

peut

également

se

déclencher

à

un

moment

précis,

basé

sur

le

calendrier

ou

l’horloge,

par

exemple,

lorsque

le

démarrage

des

communications

est

programmé

toutes

les

10

minutes

ou

le

dimanche

à

minuit.

Il

peut

s’agir

également

d’un

événement

ponctuel

démarré

manuellement,

tel

que

le

remplissage

d’un

annuaire

ou

le

nettoyage

de

données

d’un

système.

Les

événements

sont

généralement

liés

à

une

source

de

données

et

sont

associés

aux

flots

de

données

déclenchés

lorsque

l’ensemble

de

circonstances

spécifié

se

produit.

Chacun

de

ces

éléments

est

traité

par

IBM

Tivoli

Directory

Integrator

à

l’aide

de

ses

trois

types

de

composants

:

les

connecteurs,

les

interpréteurs

et

les

gestionnaires

d’événements.

v

Les

connecteurs

sont

des

composants

qui

vous

permettent

d’accéder

aux

données

d’une

source

de

données.

Par

exemple,

vous

pouvez

utiliser

un

connecteur

JDBC

pour

effectuer

des

opérations

de

lecture

et

d’écriture

dans

une

4

IBM

Tivoli

Directory

Integrator

5.2

-

Guide

d’initiation

Page 17: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

base

de

données

SQL,

ou

un

connecteur

LDAP

pour

accéder

à

un

annuaire.

Certains

types

de

données

ne

stockent

pas

de

données

sous

la

forme

d’objets

structurés

(enregistrements,

entrées,

etc.)

mais

utilisent

des

trains

d’octets

à

la

place.

Parmi

ces

données,

citons

les

fichiers

ordinaires

et

les

fichiers

de

données

sur

IP.

Les

interpréteurs

convertissent

alors

les

trains

d’octets

en

informations

structurées

ou

inversement.

v

Les

flots

de

données

sont

implémentés

par

liaison

d’un

ou

plusieurs

connecteurs,

auxquels

sont

associés

des

interpréteurs

si

nécessaire.

v

Enfin,

vous

pouvez

configurer

les

gestionnaires

d’événements

pour

collecter

les

notifications

de

modifications

dans

les

systèmes

connectés

(annuaires

ou

boîtes

aux

lettres

POP3/IMAP,

par

exemple)

puis

envoyer

ces

événements

aux

lignes

d’assemblage

désignées.

Avant

d’examiner

de

plus

près

le

fonctionnement

de

ces

composants,

vous

devez

avoir

une

vue

globale

des

flots

de

données

que

vous

souhaitez

implémenter.

Comme

indiqué

précédemment,

une

bonne

méthode

consiste

à

créer

un

schéma.

Il

existe

bon

nombre

de

conventions

et

de

styles

de

schémas

à

choisir,

mais

la

forme

et

le

type,

proprement

dits,

des

symboles

sont

moins

importants

que

votre

compréhension

du

problème.

Utilisez

des

cases,

des

billes,

des

bulles

ou

tout

ce

que

vous

maîtrisez

bien,

mais

soyez

cohérent

et

veillez

à

désigner

tous

les

éléments

de

façon

claire

et

lisible.

Ainsi,

lorsque

vous

ou

quelqu’un

d’autre

regarderez

votre

schéma

dans

deux

mois,

il

sera

toujours

compréhensible.

Une

source

de

données

de

sortie

(DS3)

reçoit

des

données

d’une

source

de

données

initiale

(DS1).

Au

cours

du

transfert,

le

flot

de

données

collecte

des

informations

d’une

seconde

source

de

données

(DS2).

Dans

IBM

Tivoli

Directory

Integrator,

un

tel

flot

de

données

est

nommé

″ligne

d’assemblage″.

Notez

bien

que

chaque

ligne

d’assemblage

implémente

un

seul

flot

de

données

unidirectionnel.

Si

vous

souhaitez

effectuer

une

synchronisation

bidirectionnelle

entre

plusieurs

sources

de

données,

vous

devez

alors

utiliser

une

ligne

d’assemblage

séparée

pour

traiter

le

flot

dans

chaque

direction.

La

raison

en

est

la

suivante

:

le

format

et

le

contenu

des

données,

ainsi

que

les

opérations

effectuées

dessus

sont

fort

probablement

différents

pour

chaque

direction.

Remarque

:

IBM

Tivoli

Directory

Integrator

fournit

tous

les

éléments

nécessaires

à

la

création

de

solutions

d’informations

de

type

question-réponse,

telles

que

les

services

Web.Bien

qu’il

n’existe

pas

de

nombre

limite

de

connecteurs

d’une

ligne

d’assemblage,

celle-ci

doit

en

contenir

le

moins

possible

(par

exemple

une

par

source

de

données

participant

au

flot),

tout

en

comprenant

suffisamment

de

composants

et

de

logique

de

scripts

pour

être

la

plus

autonome

possible.

Le

raisonnement

qui

sous-tend

ce

principe

vise

à

faciliter

la

compréhension

et

la

gestion

de

la

ligne

d’assemblage.

Cela

permet

également

des

solutions

plus

simples,

plus

rapides

et

plus

évolutives.

La

philosophie

d’IBM

Tivoli

Directory

Integrator

consiste

à

traiter

les

flots

un

par

un

et

à

simplifier

l’ensemble

du

problème

en

commençant

par

le

flot

reliant

DS1

à

DS3.

L’organisation

des

données

peut

varier

d’un

système

à

l’autre

:

v

Les

données

sont

généralement

stockées

dans

des

enregistrements

avec

un

nombre

fixe

de

zones.

v

En

revanche,

les

annuaires

gèrent

des

objets

variables

appelés

entrées.

v

D’autres

systèmes

peuvent

utiliser

des

messages

ou

des

paires

valeurs-clés.

Chapitre

2.

Simplification

et

résolution

5

Page 18: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

IBM

Tivoli

Directory

Integrator

simplifie

le

problème

en

collectant

et

en

stockant

tous

les

types

d’informations

dans

un

conteneur

de

données

souple

et

puissant

appelé

entrée.

A

leur

tour,

les

valeurs

des

données

sont

elles-mêmes

conservées

dans

des

objets

appelés

attributs

contenus

et

gérés

par

l’entrée.

Autre

problème

potentiel

:

ces

sources

utilisent

différents

types

pour

représenter

les

valeurs

stockées.

IBM

Tivoli

Directory

Integrator

se

charge

du

problème

pour

vous

également.

Toutes

les

informations

entrant

dans

le

flot

de

données

sont

converties

dans

un

format

qui

correspond

à

des

règles

prédéfinies

(objets

Java).

De

cette

façon,

vos

règles

métier

et

votre

logique

de

transformation

n’ont

pas

à

gérer

les

conflits

de

type.

Lorsque

les

données

sont

prêtes

pour

la

sortie,

IBM

Tivoli

Directory

Integrator

les

convertit

dans

les

types

de

données

spécifiques

à

la

source.

Afin

de

visualiser

entièrement

le

flot

de

données,

enregistrez

la

manière

dont

les

attributs

de

la

source

de

données

d’entrée

sont

mappés

(et

éventuellement

modifiés)

pour

devenir

les

attributs

du

système

destinataire.

Par

exemple,

DS3

pourrait

avoir

l’aspect

suivant

:

First

=DS1.First

Last

=DS1.Last

FullName

=DS1.First+"

"+DS1.Last

Title

=DS1.Title

Mail

=<créé_à_partir_du_nom>

Pour

garder

l’exemple

simple,

utilisez

comme

source

DS1

un

fichier

CSV

contenant

les

zones

First,

Last

et

Title.

Votre

source

de

données

de

sortie

(DS3)

est

un

document

XML.

Maintenant

que

vous

avez

une

image

précise

de

la

solution,

concentrons-nous

sur

la

manière

dont

les

flots

de

données

sont

gérés

par

IBM

Tivoli

Directory

Integrator.

Architecture

L’architecture

d’IBM

Tivoli

Directory

Integrator

comporte

deux

parties

:

v

Le

processus

central,

qui

assure

la

plupart

des

fonctionnalités

du

système.

Le

processus

central

d’IBM

Tivoli

Directory

Integrator

gère

les

fichiers

journaux,

la

détection

et

la

communication

des

erreurs,

et

les

paramètres

d’exécution

des

flots

de

données.

Il

gère

également

votre

configuration

personnalisée

et

votre

logique

applicative.

v

Les

composants,

qui

prennent

en

charge

les

détails

techniques

des

systèmes

et

formats

de

données

que

vous

souhaitez

gérer.

IBM

Tivoli

Directory

Integrator

propose

trois

types

de

composants

:

Connecteurs

Interpréteurs

Gestionnaires

d’événements

Comme

chaque

composant

est

encapsulé

par

des

fonctionnalités

centrales

qui

gèrent,

par

exemple,

la

personnalisation

et

le

contrôle

des

flots

d’intégration,

les

composants

proprement

dits

peuvent

rester

petits

et

simples.

Par

exemple,

si

vous

souhaitez

implémenter

votre

propre

interpréteur,

il

vous

suffit

de

fournir

deux

fonctions

:

l’une

pour

l’interprétation

de

la

structure

d’un

train

d’octets

entrant

et

l’autre

pour

l’ajout

d’une

structure

à

un

train

d’octets

sortant.

Si

vous

jetez

un

coup

d’oeil

dans

le

sous-répertoire

JAR

d’IBM

Tivoli

Directory

Integrator,

vous

verrez

à

quel

point

les

composants

standard

sont

simples,

ce

qui

facilite

leur

création

et

leur

extension.

6

IBM

Tivoli

Directory

Integrator

5.2

-

Guide

d’initiation

Page 19: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Cette

conception

avec

composant

central/

fait

d’IBM

Tivoli

Directory

Integrator

un

produit

facilement

extensible.

Elle

vous

permet

également

de

créer

rapidement

la

structure

de

vos

solutions

en

faisant

glisser

les

composants

sélectionnés

jusqu’à

l’emplacement

désiré,

puis

en

cliquant

dessus.

Les

composants

peuvent

être

échangés

sans

affecter

la

logique

personnalisée

et

le

comportement

configuré

de

vos

flots

de

données.

Vous

pouvez

ainsi

créer

des

solutions

d’intégration

que

vous

pouvez

rapidement

compléter

et

étendre,

tout

en

les

rendant

moins

vulnérables

aux

modifications

dans

l’infrastructure

sous-jacente.

Lignes

d’assemblage

Les

flèches

des

flots

de

données

représentées

sur

le

graphique

se

traduisent

dans

IBM

Tivoli

Directory

Integrator

par

des

lignes

d’assemblage,

qui

fonctionnent

comme

de

véritables

lignes

d’assemblage

industrielles.

Ces

dernières

sont

constituées

d’un

certain

nombre

de

machines

spécialisées

qui

se

différencient

par

leurs

fonctions

et

leurs

constructions,

mais

ont

un

point

commun

:

elles

peuvent

être

liées

les

unes

aux

autres

pour

former

un

chemin

continu

des

sources

d’entrée

jusqu’à

la

sortie.

Une

ligne

d’assemblage

possède

généralement

une

ou

plusieurs

unités

d’entrée

conçues

pour

accepter

la

matière

première

nécessaire

à

la

production,

par

exemple

des

filets

de

poisson,

du

sirop

de

cola

ou

des

pièces

de

voiture.

Ces

éléments

sont

traités

et

assemblés.

Des

sous-produits

sont

parfois

extraits

de

la

ligne

d’assemblage

au

cours

du

trajet.

A

la

fin

de

la

chaîne

de

production,

les

produits

finis

sont

remis

à

des

unités

de

sorties

en

attente.

Si

une

équipe

de

production

reçoit

l’ordre

de

fabriquer

un

autre

produit,

elle

interrompt

la

chaîne

en

gardant

uniquement

les

machines

qui

serviront

à

la

nouvelle

commande.

De

nouvelles

unités

sont

reliées

dans

les

emplacements

adéquats,

la

chaîne

est

réajustée

et

la

production

recommence.

Les

lignes

d’assemblage

IBM

Tivoli

Directory

Integrator

fonctionnent

d’une

façon

très

semblable.

Les

lignes

d’assemblage

IBM

Tivoli

Directory

Integrator

reçoivent

des

informations

de

plusieurs

unités

d’entrée,

effectuent

des

opérations

sur

cette

entrée

et

acheminent

le

produit

fini

jusqu’à

des

unités

de

sortie.

Elles

traitent

un

élément

à

la

fois,

par

exemple,

un

enregistrement

de

données,

une

entrée

d’annuaire,

une

clé

de

registre,

etc.

Les

attributs

de

données

des

sources

d’entrée

connectées

s’accumulent

dans

une

benne

Java

(appelée

objet

work)

et

des

scripts

peuvent

être

ajoutés

à

ces

informations,

vérifiant

le

contenu

des

données,

calculant

de

nouveaux

attributs

et

de

nouvelles

valeurs,

et

modifiant

ceux

existants

jusqu’à

ce

que

les

données

soient

prêtes

à

être

remises

de

la

ligne

à

une

ou

plusieurs

sources

de

sortie.

Les

unités

d’entrée

et

de

sortie

d’une

ligne

d’assemblage

IBM

Tivoli

Directory

Integrator

sont

appelées

connecteurs

et

chacun

est

relié

à

un

magasin

de

données.

Les

connecteurs

relient

le

flot

de

données

au

monde

extérieur

et

se

trouvent

à

l’emplacement

de

la

transformation

et

du

regroupement

des

données.

Vous

pouvez

en

outre,

à

cet

emplacement,

organiser

votre

logique

de

gestion

d’entreprise,

de

sécurité

et

d’identité.

Chapitre

2.

Simplification

et

résolution

7

Page 20: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Connecteurs

Les

connecteurs

sont

comme

des

pièces

de

puzzle

qui

s’assemblent,

tout

en

servant

de

liens

à

une

source

de

données

spécifiques.

Chaque

fois

que

vous

sélectionnez

l’une

de

ces

pièces

de

puzzle

et

que

vous

l’ajoutez

à

la

ligne

d’assemblage,

vous

devez

:

1.

Choisir

le

type

de

connecteur.

2.

Affecter

au

connecteur

un

rôle

dans

le

flot

de

données.

C’est

ce

que

l’on

appelle

le

mode

Connecteur,

qui

indique

à

IBM

Tivoli

Directory

Integrator

comment

utiliser

le

connecteur

:

v

Un

connecteur

d’entrée

parcourant

par

itération

ou

recherchant

les

informations

dans

sa

source

v

Un

connecteur

de

sortie

qui

insère,

met

à

jour

ou

supprime

des

données

dans

le

système

ou

l’unité

connecté(e)

Remarque

:

Les

données

doivent

être

extraites

des

sources

d’entrée

puis

insérées

dans

les

destinations

de

sortie.

C’est

précisément

le

rôle

des

connecteurs.

Vous

pouvez

modifier

à

la

fois

le

type

et

le

mode

d’un

connecteur

chaque

fois

que

vous

le

souhaitez

afin

de

répondre

aux

changements

dans

votre

infrastructure

ou

dans

les

objectifs

de

votre

solution.

Si

vous

avez

prévu

cela,

le

reste

de

la

ligne

d’assemblage,

y

compris

le

filtrage

et

la

transformation

des

données,

n’est

pas

affecté.

Pour

cette

raison,

il

est

important

de

traiter

chaque

connecteur

comme

une

boîte

noire

qui

envoie

des

données

dans

le

mélange

ou

en

extrait

pour

les

envoyer

à

une

source

de

données.

Plus

les

connecteurs

sont

indépendants,

plus

votre

solution

est

facile

à

gérer.

En

rendant

vos

connecteurs

aussi

autonomes

que

possible,

vous

pouvez

également

les

transférer

rapidement

à

votre

bibliothèque

de

connecteurs

et

les

réutiliser

pour

créer

de

nouvelles

solutions

plus

rapidement,

voire

les

partager

avec

d’autres.

La

fonction

de

bibliothèque

d’IBM

Tivoli

Directory

Integrator

facilite

également

la

gestion

et

l’amélioration

de

vos

connecteurs

car

il

vous

suffit

de

mettre

à

jour

le

modèle

de

connecteur

dans

votre

bibliothèque

pour

que

toutes

les

lignes

d’assemblage

provenant

de

ce

modèle

héritent

des

améliorations.

Lorsque

vous

êtes

prêt

à

utiliser

véritablement

votre

solution,

vous

pouvez

reconfigurer

les

connecteurs

de

votre

bibliothèque

pour

établir

une

connexion

aux

sources

de

données

de

production

au

lieu

de

celles

de

votre

environnement

de

test

et

la

mettre

ainsi

en

pratique

en

quelques

minutes.

Chaque

fois

que

vous

devez

inclure

de

nouvelles

données

dans

le

flot,

il

vous

suffit

d’ajouter

à

la

ligne

d’assemblage

le

connecteur

approprié.

IBM

Tivoli

Directory

Integrator

met

à

votre

disposition

une

bibliothèque

de

connecteurs

à

sélectionner,

tels

que

LDAP,

JDBC,

Microsoft

NT4

Domain,

Lotus

Notes

et

POP3/IMAP.

Si

vous

ne

parvenez

pas

à

trouver

celui

que

vous

cherchez,

vous

pouvez

étendre

un

connecteur

existant

en

remplaçant

l’une

ou

l’ensemble

de

ses

fonctions

à

l’aide

de

l’un

des

principaux

langages

de

rédaction

de

scripts,

à

savoir

JavaScript,

VBScript

et

PerlScript.

Vous

pouvez

même

créer

votre

propre

connecteur

à

l’aide

d’un

langage

de

script

figurant

dans

l’encapsuleur

du

connecteur

Script

ou

en

utilisant

uniquement

Java

ou

C/C++.

8

IBM

Tivoli

Directory

Integrator

5.2

-

Guide

d’initiation

Page 21: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

De

plus,

IBM

Tivoli

Directory

Integrator

prend

en

charge

la

plupart

des

protocoles

et

mécanismes

de

transport,

tels

que

TCP/IP,

FTP,

HTTP

et

JMS

(MQ),

avec

ou

sans

SSL,

ou

d’autres

mécanismes

de

cryptage

pour

sécuriser

le

flot

d’informations.

Pour

plus

d’informations

sur

les

langages

de

rédaction

des

scripts

et

la

façon

de

créer

votre

propre

langage,

consultez

le

manuel

IBM

Tivoli

Directory

Integrator

5.2

:

Guide

de

référence.

Interpréteurs

Même

les

données

non

structurées,

telles

que

les

fichiers

texte

ou

les

trains

d’octets

passant

par

un

port

IP,

sont

traitées

rapidement

et

simplement

par

IBM

Tivoli

Directory

Integrator,

grâce

à

leur

transfert

par

un

ou

plusieurs

interpréteurs.

Les

interpréteurs

sont

un

autre

type

de

composant

IBM

Tivoli

Directory

Integrator

et

le

système

est

fourni

avec

plusieurs

interpréteurs

(LDIF,

DSML,

XML,

CSV

et

zone

de

longueur

fixe).

Comme

pour

les

connecteurs,

vous

pouvez

les

étendre,

les

modifier

et

en

créer

d’autres.

En

continuant

avec

l’exemple

de

la

page

6,

l’étape

suivante

consiste

à

identifier

les

sources

de

données.

La

source

de

données

d’entrée

étant

un

fichier

texte

au

format

CSV,

utilisez

le

connecteur

File

System

associé

à

l’interpréteur

CSV.

Vous

pouvez

également

utiliser

un

connecteur

File

System

pour

les

sorties,

en

choisissant

cette

fois

l’interpréteur

XML

pour

formater

le

fichier

en

document

XML.

Remarque

:

Les

exemples

donnés

dans

le

présent

manuel

ont

été

réalisés

sur

une

plateforme

UNIX

et

utilisent

les

conventions

de

chemin

d’accès

UNIX.

Pour

que

votre

solution

soit

indépendante

de

la

plateforme,

utilisez

la

barre

oblique

(/)

au

lieu

de

la

barre

oblique

inversée

(\)

dans

vos

noms

de

chemin,

par

exemple,

examples/Tutorial/Tutorial1.cfg.

Cela

fonctionne

à

la

fois

sur

les

plateformes

Windows

et

UNIX/Linux.

Chapitre

2.

Simplification

et

résolution

9

Page 22: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Gestionnaires

d’événements

Troisième

type

de

composant

d’IBM

Tivoli

Directory

Integrator,

les

gestionnaires

d’événements

offrent

des

fonctionnalités

pour

la

création

de

solutions

d’intégration

en

temps

réel.

Comme

les

connecteurs,

les

gestionnaires

d’événements

peuvent

avoir

une

intelligence

de

source

de

données

qui

leur

permet

de

se

connecter

à

un

système

ou

à

un

service

et

d’attendre

une

notification

d’événement.

Par

exemple,

le

gestionnaire

d’événements

Boîte

aux

lettres

peut

détecter

l’arrivée

de

nouveaux

messages

dans

une

boîte

aux

lettres

POP3

ou

IMAP,

et

le

gestionnaire

d’événements

LDAP

intercepter

des

modifications

apportées

à

un

annuaire.

Lorsqu’un

événement

se

produit,

le

gestionnaire

d’événements

stocke

les

détails

de

l’événement,

applique

une

logique

et

démarre

les

lignes

d’assemblage

en

fonction

des

conditions/règles

d’action

que

vous

avez

définies.

Parfois,

les

connecteurs

peuvent

être

utilisés

pour

intercepter

des

événements,

comme

c’est

le

cas

du

connecteur

JMS

ou

du

connecteur

du

journal

des

modifications

LDAP,

les

deux

pouvant

être

configurés

pour

récupérer

les

nouvelles

données

à

leur

arrivée.

Toutefois,

comme

le

gestionnaire

d’événements

fonctionne

avec

sa

propre

unité

d’exécution,

les

connecteurs

peuvent

servir

à

envoyer

des

événements

à

plusieurs

lignes

d’assemblage.

Cette

méthode

permet

de

filtrer

et

traiter

de

manière

plus

simple

et

plus

directe

des

événements

de

types

différents

provenant

de

la

même

source

(par

exemple,

des

appels

SOAP

ou

de

services

Web).

Vous

pouvez

également

configurer

des

gestionnaires

d’événements

pour

qu’ils

démarrent

automatiquement

;

ainsi,

lorsque

vous

démarrez

un

serveur

avec

la

configuration,

ils

sont

immédiatement

activés.

Cela

vous

évite

d’avoir

à

nommer

les

lignes

d’assemblage

à

exécuter

dans

les

paramètres

de

ligne

de

commande

du

serveur.

Maintenant

que

vous

connaissez

les

composants

utilisés

par

IBM

Tivoli

Directory

Integrator,

vous

êtes

prêt

pour

créer

la

ligne

d’assemblage.

Cependant,

pour

continuer,

il

vous

faut

un

fichier

d’entrée.

Vous

trouverez

un

exemple

de

ce

type

de

fichier

dans

le

sous-répertoire

examples\Tutorial

du

répertoire

d’installation

d’IBM

Tivoli

Directory

Integrator.

Vous

pouvez

aussi

le

créer

vous-même

dans

un

éditeur

de

texte.

Les

données

exemples

incluses

se

présentent

de

la

manière

suivante

:

First;Last;Title

Bill;Sanderman;Chercheur

principal

Mick;Kamerun;PDG

Jill;Vox;Directeur

technique

Roger

Gregory;Highpeak;Vice-président

Développement

produits

Ernie;Hazzle;Expert

principal

Peter;Belamy;Responsable

du

soutien

des

activités

Ce

fichier

est

nommé

People.csv.

Il

se

trouve

dans

le

dossier

examples/Tutorial

de

votre

répertoire

d’installation

IBM

Tivoli

Directory

Integrator.

Lorsqu’il

est

en

place,

vous

êtes

prêt

à

créer

votre

solution

à

l’aide

d’IBM

Tivoli

Directory

Integrator.

10

IBM

Tivoli

Directory

Integrator

5.2

-

Guide

d’initiation

Page 23: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Chapitre

3.

Présentation

d’IBM

Tivoli

Directory

Integrator

Développement

d’intégration

rapide

IBM

Tivoli

Directory

Integrator

comprend

en

réalité

deux

programmes

:

Toolkit

IDE

Ce

programme

fournit

une

interface

graphique

permettant

de

créer,

de

tester

et

de

déboguer

vos

solutions

d’intégration.

Toolkit

IDE

(Integrated

Development

Environment)

permet

de

créer

un

fichier

de

configuration

lancé

par

le

moteur

d’exécution.

Le

fichier

exécutable

Toolkit

IDE

est

nommé

ibmditk.

Serveur

d’exécution

A

partir

de

la

configuration

que

vous

avez

créée

à

l’aide

de

Toolkit

IDE

(et

qui

est

stockée

sous

forme

de

document

XML

hautement

structuré),

le

serveur

d’exécution

exécute

la

solution

d’intégration.

Ce

fichier

programme

s’appelle

ibmdisrv.

Vous

pouvez

développer

votre

solution

en

utilisant

autant

d’instances

de

serveur

que

vous

le

souhaitez.

Aucune

limite

n’est

imposée

par

la

technologie

IBM

Tivoli

Directory

Integrator.

Démarrez

Toolkit

IDE.

Au

bout

d’un

certain

temps,

l’écran

principal

apparaît.

De

là,

vous

pouvez

créer

une

nouvelle

configuration

que

vous

pourrez

ensuite

reprendre.

Remarque

:

Si

l’écran

affiché

est

différent

des

captures

d’écran

de

ce

manuel,

il

est

possible

qu’un

autre

paramètre

d’affichage

est

défini

dans

votre

système.

Pour

modifier

le

paramètre

d’affichage,

procédez

comme

suit

:

1.

Cliquez

sur

Fichier–>Modifier

les

préférences.

2.

Cliquez

sur

l’onglet

Affichage.

3.

Cliquez

sur

l’onglet

Présentation.

La

fenêtre

d’IBM

Tivoli

Directory

Integrator

peut

être

redimensionnée.

Si

les

captures

d’écran

de

ce

manuel

ne

correspondent

pas

aux

écrans

de

votre

système,

essayez

de

modifier

la

taille

de

la

fenêtre

sur

votre

écran.

En

sélectionnant

l’option

Fichier–>Modifier

les

préférences,

une

boîte

de

dialogue

s’ouvre.

Vous

pouvez

y

définir

un

plusieurs

autres

paramètres

d’interface

utilisateur,

par

exemple

indiquer

si

la

barre

d’outils

de

boutons

principaux

doit

être

visible

ou

masquée,

ou

si

vous

souhaitez

qu’IBM

Tivoli

Directory

Integrator

utilise

la

barre

d’état

en

bas

de

la

fenêtre.

Le

menu

principal

et

la

barre

d’outils

à

boutons

se

trouvent

en

haut

de

l’écran

©

Copyright

IBM

Corp.

2002,

2003

11

Page 24: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

La

barre

d’outils

principale

offre

des

commandes

vous

permettant

de

créer

de

nouvelles

configurations,

d’ouvrir

des

fichiers

de

configuration

existants

et

d’enregistrer

vos

travaux

en

cours.

Elle

comporte

également

des

boutons

de

navigation.

Vous

pouvez

aussi

exécuter

ces

commandes

à

partir

des

menus

Fichier

et

Fenêtre,

l’option

Enregistrer

sous

vous

permet

de

sauvegarder

votre

configuration

sous

un

autre

nom

de

fichier.

Création

d’une

nouvelle

configuration

Les

configurations

d’IBM

Tivoli

Directory

Integrator

sont

stockées

sous

la

forme

de

documents

XML.

Elles

sont

créées

et

gérées

à

l’aide

de

Toolkit

IDE

et

déployées

avec

le

serveur.

Chaque

configuration

contient

les

lignes

d’assemblage

lancées

par

un

serveur,

ainsi

que

les

composants

IBM

Tivoli

Directory

Integrator

qui

constituent

ces

lignes.

La

configuration

comprend

également

les

préférences

de

l’utilisateur,

telles

que

les

couleurs

et

le

style

d’interface

graphique.

Remarque

:

Les

configurations

peuvent

également

être

réparties

sur

plusieurs

fichiers

et

stockées

dans

plusieurs

emplacements.

IBM

Tivoli

Directory

Integrator

assemble

sa

configuration

en

mode

dynamique

au

démarrage

en

utilisant

les

URL

et

les

chemins

d’accès

que

vous

avez

spécifiés.

Par

conséquent,

vous

pouvez

créer

et

gérer

les

paramètres

d’entreprise

et

les

composants

susceptibles

d’être

partagés

par

bon

nombre

de

configurations

de

serveur.

Vous

pouvez

également

ouvrir

et

gérer

plusieurs

configurations

en

déplaçant

les

composants

de

l’une

à

l’autre.

12

IBM

Tivoli

Directory

Integrator

5.2

-

Guide

d’initiation

Page 25: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

A

la

première

mise

en

marche

du

système,

un

écran

vierge

tel

qu’illustré

ci-dessus

s’affiche.

Si

vous

créez

une

nouvelle

configuration,

IBM

Tivoli

Directory

Integrator

vous

demande

si

vous

souhaitez

créer

le

fichier

de

configuration

par

défaut,

appelé

rs.xml.

A

la

place

du

nom

par

défaut,

attribuez

au

fichier

un

nom

différent.

Cliquez

sur

le

bouton

Créer

une

nouvelle

racine

de

configuration

ou

utilisez

l’option

de

menu

Fichier–>Nouveau

pour

créer

un

fichier

de

configuration

Tutorial1

(notez

que

l’extension

.xml

est

ajoutée

automatiquement).

Ce

fichier

doit

être

enregistré

dans

le

répertoire

examples/Tutorial.

Remarque

:

Les

noms

de

chemin

peuvent

être

écrits

par

rapport

au

répertoire

spécifié

lors

de

l’installation

d’IBM

Tivoli

Directory

Integrator.

L’arborescence

à

gauche

de

l’écran

s’appelle

le

navigateur

de

configuration.

Il

affiche

un

ensemble

de

dossiers

contenant

différents

aspects

de

votre

solution.

Le

dossier

en

haut,

appelé

Lignes

d’assemblage,

contient

les

lignes

d’assemblage

que

vous

créez.

Trois

dossiers

situés

immédiatement

vous

permettent

de

stocker

votre

bibliothèque

de

composants

(un

dossier

pour

chaque

type

de

composant).

Cela

vous

permet

de

configurer

des

connecteurs

standard

(par

exemple,

LDAP,

JDBC,

Notes,

etc.),

avec

des

paramètres

de

configuration

et

de

comportement,

des

transformations

de

données

et

d’autres

règles

métier,

puis

de

les

utiliser

et

de

les

réutiliser

pour

créer

de

nouvelles

solutions.

Sans

aller

plus

avant

dans

la

description

de

l’interface

Toolkit

IDE,

voici

la

présentation

générale

de

ces

écrans

de

configuration

:

v

Le

reste

de

l’écran

sous

la

barre

d’outils

est

organisé

en

sous-fenêtres.

Le

navigateur

de

configuration

apparaît

à

gauche

mais

vous

pouvez

le

masquer

et

l’afficher

en

utilisant

le

bouton

Activer/Désactiver

l’arborescence

de

la

configuration

dans

la

barre

d’outils

principale

ou

en

cliquant

sur

les

flèches

en

haut

de

la

barre

de

diviseur

en

regard

du

navigateur

de

configuration.

A

droite

de

cette

sous-fenêtre,

la

zone

Détails

affiche

les

détails

des

éléments

sélectionnés

dans

le

navigateur

de

configuration.

v

La

sous-fenêtre

Détails

peut

afficher

plusieurs

vues

détaillées,

ouvrant

une

nouvelle

vue

chaque

fois

que

vous

sélectionnez

un

autre

élément

dans

le

navigateur

de

configuration.

Ces

sous-fenêtres

sont

accessibles

à

l’aide

du

menu

Fenêtre

ou

des

onglets

en

haut

de

chaque

vue

(selon

l’apparence

configurée

pour

le

système).

v

Certaines

sous-fenêtres

Détails

contiennent

également

des

listes

d’éléments.

Elles

changent

également

pour

afficher

les

détails

de

ces

éléments

et

lorsque

vous

cliquez

dessus.

v

Vous

pouvez

modifier

l’espace

affecté

à

chaque

colonne

de

la

liste

en

positionnant

le

curseur

de

la

souris

sur

la

ligne

de

séparation

des

colonnes

(le

curseur

change

de

forme),

puis

en

cliquant

et

en

faisant

glisser

la

ligne

jusqu’à

l’endroit

souhaité.

v

Une

rangée

de

boutons

située

en

haut

de

chaque

liste

d’éléments

permet

d’effectuer

toutes

les

opérations

disponibles

pour

le

type

d’objet

sélectionné

Chapitre

3.

Présentation

d’IBM

Tivoli

Directory

Integrator

13

Page 26: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

(dans

le

cas

de

la

sous-fenêtre

des

flots

de

données,

la

barre

d’outils

se

trouve

sous

la

liste

des

connecteurs).

La

liste

des

opérations

disponibles

varie

d’une

sous-fenêtre

à

l’autre

mais

l’ensemble

fonctionne

de

la

même

manière.

Sélectionnez

une

entrée

de

la

liste,

puis

cliquez

sur

le

bouton

de

votre

choix

(excepté

pour

les

boutons

de

type

Ajouter,

qui

ne

nécessitent

aucune

sélection

préalable).

v

Pour

sélectionner

plusieurs

éléments

à

la

fois,

appuyez

sur

Maj

ou

Ctrl

en

mettant

en

surbrillance

les

éléments

dans

les

listes.

v

Vous

pouvez

déplacer

les

éléments

du

navigateur

de

configuration

vers

vos

lignes

d’assemblage

ou

entre

les

configurations

ouvertes.

Création

d’une

ligne

d’assemblage

La

première

tâche

consiste

à

créer

une

nouvelle

ligne

d’assemblage.

Cliquez

à

l’aide

du

bouton

droit

de

la

souris

sur

le

dossier

Ligne

d’assemblage.

Dans

le

menu

contextuel

qui

apparaît,

sélectionnez

Nouvelle

ligne

d’assemblage.

Nommez-la

CSVversXML.

Vous

pouvez

donner

à

une

ligne

d’assemblage

le

nom

de

votre

choix,

mais

il

est

important

d’utiliser

une

convention

d’attribution

qui

vous

aide

à

documenter

votre

solution.

Remarque

:

L’utilisation

d’espaces

et

de

caractères

spéciaux

dans

les

noms

de

lignes

d’assemblage

ou

de

composants

IBM

Tivoli

Directory

Integrator

(comme

les

connecteurs

et

les

gestionnaires

d’événements)

n’est

pas

recommandée,

car

ils

risquent

d’engendrer

des

incidents

lorsque

vous

souhaiterez

démarrer

IBM

Tivoli

Directory

Integrator

Server

à

partir

d’une

invite

pour

lancer

votre

solution.

Dans

les

lignes

d’assemblage,

les

composants

et

les

autres

éléments

de

configuration

dans

votre

solution

sont

disponibles

dans

votre

solution

sous

la

forme

d’objets

script,

ce

qui

vous

permet

de

modifier

les

paramètres

et

le

comportement

au

moment

de

l’exécution.

Ainsi,

vous

pouvez

utiliser

des

noms

qui

désignent

ces

objets

dans

vos

scripts.

IBM

Tivoli

Directory

Integrator

affiche

l’écran

Ligne

d’assemblage.

Vous

remarquerez

que

ce

nouvel

écran

remplit

la

sous-fenêtre

de

configuration

jusqu’ici

vierge.

Avant

d’ajouter

les

connecteurs,

regardez

rapidement

la

présentation

de

l’écran

Ligne

d’assemblage.

14

IBM

Tivoli

Directory

Integrator

5.2

-

Guide

d’initiation

Page 27: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

La

partie

supérieure

de

la

sous-fenêtre

Détails

comporte

une

rangée

d’onglets,

correspondant

chacun

à

un

élément

ouvert

dans

le

navigateur

de

navigation

(en

l’occurrence,

le

nouvel

écran

Détails

de

la

ligne

d’assemblage).

Le

titre

de

chaque

onglet

comporte

une

rangée

de

boutons

qui

inclut

un

bouton

Fermer

pour

fermer

cet

écran

Détails.

Remarque

:

Si

vous

immobilisez

le

curseur

sur

l’un

des

boutons

de

Config

Tool,

une

infobulle

apparaît.

En

plus

du

bouton

Fermer,

la

rangée

de

boutons

comporte

également

deux

autres

boutons

:

Exécuter

Permet

d’exécuter

la

ligne

d’assemblage

courante.

Chapitre

3.

Présentation

d’IBM

Tivoli

Directory

Integrator

15

Page 28: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Exécuter

le

débogage

IBM

Tivoli

Directory

Integrator

dispose

d’un

débogueur

de

flot

de

données

qui

vous

permet

de

parcourir

la

ligne

d’assemblage

et

de

contrôler

les

données

transférées

et

converties

dans

la

ligne

d’assemblage

lorsque

le

contrôle

passe

d’un

connecteur

à

un

autre.

La

zone

blanche

à

gauche

de

l’écran

Détails

de

la

ligne

d’assemblage

indique

la

liste

des

connecteurs.

Elle

est

alimentée

au

fur

et

à

mesure

que

de

nouveaux

connecteurs

sont

ajoutés

à

votre

flot.

L’écran

Entrée

Work

se

trouve

sous

la

liste.

Il

vous

permet

d’examiner

votre

flot

de

données

et

de

connaître

à

tout

moment

les

attributs

de

données

lus

dans

les

systèmes

connectés.

Les

détails

du

connecteur

sélectionné

s’affichent

à

droite

de

cette

liste.

Les

onglets

concernant

la

ligne

d’assemblage

se

trouvent

en

haut

de

cette

zone.

Ces

onglets

vous

permettent

d’accéder

aux

différents

aspects

de

ce

flot

de

données

:

Ces

onglets

sont

les

suivants

:

Crochets

L’onglet

Crochets

de

la

ligne

d’assemblage

vous

permet

d’installer

des

scripts

à

évaluer

ou

à

démarrer

:

v

Avant

l’initialisation

des

connecteurs

(ce

qui

vous

permet

de

reconfigurer

vos

connecteurs

avant

qu’ils

ne

mettent

en

application

leurs

connexions)

v

Après

l’initialisation

des

connecteurs,

mais

avant

que

le

contrôle

ne

soit

transmis

au

premier

connecteur

v

Après

l’arrêt

du

dernier

connecteur

v

A

la

requête

de

fin

imposée

à

la

ligne

d’assemblage

par

un

événement

externe

Flot

de

données

Les

connecteurs

sont

créés

et

gérés

à

cet

endroit.

Configurer...

Fournit

un

certain

nombre

de

paramètres

de

configuration

pour

cette

ligne

d’assemblage.

Appeler/Renvoyer

Vous

permet

de

spécifier

les

paramètres

d’entrée

et

de

sortie

de

la

ligne

d’assemblage

pour

l’appeler

plus

facilement

à

partir

d’un

processus

externe

(par

exemple,

un

gestionnaire

d’événements).

Cliquez

sur

l’onglet

Configurer...

pour

consulter

les

paramètres

que

vous

pouvez

configurer.

Par

exemple,

vous

pouvez

définir

le

langage

de

rédaction

des

scripts

à

utiliser

dans

cette

ligne

d’assemblage

ou

limiter

le

nombre

d’itérations

(ce

qui

s’avère

utile

lorsque

vous

développez

et

testez

votre

ligne

d’assemblage

sur

des

ensembles

de

données

importants).

16

IBM

Tivoli

Directory

Integrator

5.2

-

Guide

d’initiation

Page 29: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Remarque

:

Quel

que

soit

le

langage

de

rédaction

des

scripts

sélectionné

pour

votre

ligne

d’assemblage,

IBM

Tivoli

Directory

Integrator

vous

permet

d’utiliser

des

composants

qui

ont

été

écrits

à

l’aide

d’autres

langages.

Vous

pouvez

écrire

votre

logique

de

ligne

d’assemblage

en

JavaScript

tout

en

conservant

le

connecteur

que

vous

avez

créé

avec

VBScript

ainsi

que

l’interpréteur

PerlScript

tant

que

le

langage

de

rédaction

des

scripts

choisi

est

pris

en

charge

par

la

plateforme

sur

laquelle

vous

exécutez

IBM

Tivoli

Directory

Integrator.

Sous

la

case

Connecteurs,

vous

trouverez

la

barre

d’outils

de

la

liste

des

connecteurs,

qui

vous

propose

un

certain

nombre

d’opérations

pour

la

gestion

de

vos

connecteurs

:

Ces

boutons

servent

à

effectuer

les

actions

suivantes

:

Ajouter

un

connecteur

Permet

d’ajouter

un

nouveau

connecteur

à

la

ligne

d’assemblage.

Vous

pouvez

également

déplacer

un

connecteur

préconfiguré

de

la

liste

des

connecteurs

à

partir

du

navigateur

de

configuration.

Ajouter

un

composant

script

Permet

d’ajouter

un

nouveau

connecteur

à

la

ligne

d’assemblage.

Un

composant

script

est

un

bloc

de

script

que

vous

pouvez

placer

dans

une

ligne

d’assemblage.

Supprimer

Permet

de

supprimer

le

connecteur

ou

le

composant

script

actuellement

sélectionné

de

la

ligne

d’assemblage.

Renommer

Permet

de

modifier

le

nom

du

connecteur

actuellement

sélectionné.

Haut

Permet

de

faire

monter

le

connecteur

ou

le

composant

script

sélectionné

d’un

niveau

vers

le

début

de

la

ligne

d’assemblage.

Cette

position

est

importante

car

la

ligne

d’assemblage

exécute

ces

éléments

de

haut

en

bas.

Bas

Permet

de

descendre

l’élément

sélectionné

vers

la

fin

de

la

liste.

Copie

dans

la

bibliothèque

Permet

de

faire

une

copie

du

connecteur

sélectionné

et

de

la

placer

dans

la

bibliothèque

de

connecteurs

(sous

le

dossier

Connecteurs

dans

le

navigateur

de

configuration).

Chapitre

3.

Présentation

d’IBM

Tivoli

Directory

Integrator

17

Page 30: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Ajout

du

connecteur

d’entrée

Cliquez

sur

Ajouter

pour

créer

le

premier

connecteur.

Nommez

ce

connecteur

Personnes_entrée

et

cliquez

sur

la

liste

déroulante

appelée

Connecteur.

Sélectionnez

à

présent

le

modèle

Système

de

fichiers

dans

la

liste,

qui

indique

les

connecteurs

fournis

avec

le

système,

ainsi

que

les

connecteurs

figurant

dans

votre

bibliothèque

de

connecteurs

(dans

le

dossiers

Connecteurs).

Les

composants

de

la

bibliothèque

s’affichent

en

haut

de

ces

listes

déroutantes

de

sélection.

Le

dernier

paramètre

à

définir

à

cet

endroit

est

le

mode,

de

connecteur,

qui

indique

à

la

ligne

d’assemblage

le

rôle

de

ce

connecteur.

IBM

Tivoli

Directory

Integrator

comprend

six

modes

de

connecteur

:

Ajout

uniquement

Ce

mode

est

destiné

aux

connecteurs

qui

ajoutent

uniquement

de

nouvelles

informations

à

la

source

de

données,

par

exemple,

qui

écrivent

dans

des

fichiers

ou

remplissent

une

base

de

données

ou

un

annuaire

pour

la

première

fois.

Suppression

Le

mode

Suppression

entraîne

la

recherche

puis

la

suppression,

par

le

connecteur,

de

l’enregistrement/entrée

spécifié.

La

spécification

des

clés

à

utiliser

pour

la

recherche

est

appelée

Critères

de

lien.

Vous

devez

indiquer

des

critères

de

lien

pour

les

connecteurs

de

recherche

et

de

mise

à

jour

car,

dans

ces

modes,

le

connecteur

doit

rechercher

des

données

correspondantes

dans

le

système

connecté.

Itérateur

En

mode

Itérateur,

les

connecteurs

parcourent

la

source

de

données

(ou

une

partie

de

celle-ci,

telle

qu’une

vue

de

base

de

données

ou

un

ensemble

de

résultats

d’une

recherche

dans

un

annuaire),

puis

renvoie

les

entrées

une

par

une

pour

qu’elles

soient

traitées

dans

la

ligne

d’assemblage.

Dans

ce

mode,

les

connecteurs

sont

appelés

Itérateurs.

Une

ligne

d’assemblage

peut

contenir

plusieurs

itérateurs

exécutés

les

uns

à

la

suite

des

autres,

le

deuxième

démarrant

lorsque

le

premier

atteint

la

fin

de

son

ensemble

de

données.

Recherche

Dans

ce

mode,

le

connecteur

recherche

et

renvoie

les

entrées

qui

correspondent

à

des

critères

de

recherche

spécifiés.

Il

indique

comment

collecter

les

informations

dans

un

flot

de

données.

18

IBM

Tivoli

Directory

Integrator

5.2

-

Guide

d’initiation

Page 31: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Mise

à

jour

Les

connecteurs

en

mode

Mise

à

jour

recherchent

l’entrée

ou

l’enregistrement

spécifié.

Si

la

recherche

réussit,

les

entrées

existantes

sont

modifiées

avec

les

informations

transmises

au

connecteur.

Dans

le

cas

contraire,

le

connecteur

ajoute

les

informations.

Appeler/Renvoyer

Ce

mode

très

spécial

envoie

d’abord

un

message

d’appel

(tel

qu’un

message

SOAP

ou

une

entrée

JMS)

puis

attend

une

réponse.

Si

vous

souhaitez

utiliser

le

connecteur

Service

Web,

vous

devez

le

régler

sur

ce

mode.

Remarque

:

Tous

les

modes

ne

sont

pas

disponibles

pour

tous

les

connecteurs.

Par

exemple,

si

vous

travaillez

avec

un

fichier

ordinaire,

les

modes

Recherche,

Suppression,

Mise

à

jour

et

Appeler/Renvoyer

ne

sont

pas

pris

en

charge

(sauf

si

vous

créez

votre

propre

connecteur

ou

développez

un

connecteur

existant).

Il

n’existe

pas

de

limite

au

nombre

de

connecteurs

que

peut

contenir

une

ligne

d’assemblage.

Vous

pouvez

également

utiliser

un

nombre

illimité

de

connecteurs

du

même

type,

voire

connectés

à

la

même

source

de

données.

Cela

s’avère

d’ailleurs

nécessaire

dans

certains

cas.

Prenons,

par

exemple,

le

cas

vous

souhaitez

créer

une

ligne

d’assemblage

pour

supprimer

tous

les

enregistrements

d’une

source

de

données.

D’abord,

vous

configurez

un

itérateur

(par

exemple,

un

connecteur

en

mode

Itérateur)

qui

devra

renvoyer

les

objets

que

vous

souhaitez

supprimer.

Ensuite,

vous

ajoutez

un

second

connecteur

configuré

pour

fonctionner

avec

le

même

système,

mais,

cette

fois,

en

mode

Suppression.

Ainsi,

la

ligne

d’assemblage

parcourt

en

boucle

la

source

d’entrée,

transmettant

les

entrées

au

second

connecteur,

qui

les

efface.

Il

est

parfois

déconseillé

de

disposer

de

plusieurs

connexions

simultanées

vers

la

même

source

de

données.

Cela

peut

même

être

impossible

en

raison

du

verrouillage

des

ressources

ou

de

limites

imposées

par

les

contrats

de

licence

des

logiciels.

Dans

ce

cas,

vous

pouvez

dire

à

IBM

Tivoli

Directory

Integrator

de

réutiliser

une

connexion

existante

lors

de

l’ajout

d’un

nouveau

connecteur

en

descendant

jusqu’en

bas

de

la

liste

déroulante

des

types

de

connecteur.

Dans

cette

liste,

un

symbole

at

(

@

)

apparaît

en

regard

du

nom

des

autres

connecteurs

de

la

ligne

d’assemblage.

Chapitre

3.

Présentation

d’IBM

Tivoli

Directory

Integrator

19

Page 32: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Après

avoir

nommé

votre

connecteur

et

défini

le

type

et

le

mode

(voir

«Ajout

du

connecteur

d’entrée»

à

la

page

18),

cliquez

sur

OK

pour

confirmer

vos

choix.

Ce

nouveau

connecteur

s’affiche

dans

la

liste

de

connecteurs

de

la

ligne

d’assemblage,

à

gauche

de

la

sous-fenêtre

de

configuration.

Vous

remarquerez

que

les

informations

relatives

au

connecteur

sélectionné

apparaissent

à

présent

dans

la

zone

d’affichage

Détails,

à

droite

de

la

liste.

20

IBM

Tivoli

Directory

Integrator

5.2

-

Guide

d’initiation

Page 33: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Si

vous

souhaitez

plus

tard

changer

le

type

de

connecteur,

il

vous

suffit

de

cliquer

sur

le

lien

Hériter

de

:

en

haut

de

la

sous-fenêtre

Détails

(en

regard

de

la

liste

déroulante

Etat)

et

sélectionnez

un

type

différent.

La

première

action

à

effectuer

avec

n’importe

quel

connecteur

ajouté

consiste

à

le

configurer.

Vérifiez

que

l’onglet

Configurer

est

sélectionné

dans

l’écran

Détails

du

connecteur

(comme

indiqué

ci-dessus).

Cet

onglet

est

étroitement

lié

à

la

source

de

données

à

laquelle

vous

vous

connectez

et

varie

selon

le

type

de

connecteur.

Avec

le

connecteur

Système

de

fichiers

que

vous

venez

d’ajouter,

vous

devez

entrer

le

chemin

du

fichier

dans

lequel

vous

souhaitez

écrire.

A

l’aide

du

bouton

Sélectionner...

en

regard

de

la

zone

Chemin

du

fichier

(vous

devrez

peut-être

faire

défiler

la

sous-fenêtre

ligne

par

ligne,

selon

la

résolution

de

votre

écran),

sélectionnez

le

fichier

People.csv

dans

le

sous-répertoire

examples/Tutorial.

Chapitre

3.

Présentation

d’IBM

Tivoli

Directory

Integrator

21

Page 34: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

En

plus

du

chemin

d’accès,

comme

vous

travaillez

actuellement

avec

un

type

de

connecteur

qui

lit

et

écrit

des

données

non

structurées,

vous

devez

configurer

également

un

interpréteur.

Sélectionnez

d’abord

l’onglet

Interpréteur

(en

regard

de

Connexion

dans

la

sous-fenêtre

Détails

du

connecteur)

et

cliquez

sur

le

lien

[parent]

dans

la

case

Hériter

de

:

en

bas

de

l’onglet.

22

IBM

Tivoli

Directory

Integrator

5.2

-

Guide

d’initiation

Page 35: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Une

autre

méthode

pour

configurer

l’héritage

du

connecteur,

ainsi

que

d’autres

caractéristiques,

consiste

à

utiliser

la

boîte

de

dialogue

Héritage.

Elle

est

accessible

par

le

bouton

Héritage

en

haut

de

la

sous-fenêtre

Détails

du

connecteur.

Remarque

:

Si

votre

bibliothèque

comporte

un

interpréteur

préconfiguré,

vous

pouvez

le

faire

glisser

à

partir

du

navigateur

de

configuration

et

le

déposer

sur

le

lien

[parent]

dans

la

case

Hériter

de

:.

Si

vous

cochez

les

autres

onglets

Connecteur,

tous

les

différents

aspects

d’un

connecteur

peuvent

être

hérités.

Lorsque

vous

ouvrez

la

boîte

de

dialogue

Héritage,

sélectionnez

l’interpréteur

CSV.

Chapitre

3.

Présentation

d’IBM

Tivoli

Directory

Integrator

23

Page 36: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Une

fois

l’interpréteur

en

place,

sélectionnez

l’onglet

Schéma.

Vous

pouvez

accéder

en

temps

réel

à

la

source

de

données.

Cliquez

sur

le

bouton

Connecter.

Cliquez

sur

le

bouton

Connecter

en

haut

de

cet

onglet

pour

voir

si

le

connecteur

atteint

la

source

de

données.

Si

la

connexion

aboutit,

le

message

Connexion

établie

apparaît.

A

présent,

cliquez

sur

le

bouton

Suivant.

Chaque

fois

que

vous

cliquez

sur

le

bouton

Suivant,

vous

demandez

au

système

de

lire

la

prochaine

entrée

de

la

source

de

données,

d’analyser

le

schéma

et

de

convertir

les

types

de

données

spécifiques

à

la

source

en

objets

Java

(par

exemple,

des

chaînes,

des

données

date/heure,

des

entiers).

24

IBM

Tivoli

Directory

Integrator

5.2

-

Guide

d’initiation

Page 37: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Les

données

extraites

de

la

source

s’affichent

dans

la

grille,

avec

les

noms

d’attribut,

les

types

d’objet

Java

dans

lesquels

IBM

Tivoli

Directory

Integrator

les

convertit

et

les

valeurs

réelles

trouvées

dans

la

source

de

données.

Cela

vous

permet

non

seulement

de

vous

assurer

que

vous

communiquez

directement

avec

le

système

ou

fichier

connecté,

mais

aussi

de

contrôler

visuellement

les

données

en

cours

de

lecture.

Ne

vous

inquiétez

pas

si

IBM

Tivoli

Directory

Integrator

ne

convertit

pas

les

types

de

données

sous-jacents

comme

vous

le

souhaiteriez

:

vous

avez

toujours

la

possibilité

d’annuler

cette

opération

lorsque

vous

mappez

ces

attributs

dans

le

flot

de

données.

Mappage

d’attributs

dans

la

ligne

d’assemblage

Le

mappage

d’attributs

consiste

à

déplacer

des

informations

entre

la

source

de

données

et

le

flot

de

données

et

inversement.

L’étape

précédente

vous

a

montré

comment

IBM

Tivoli

Directory

Integrator

détermine

le

schéma

et

convertit

automatiquement

les

données

en

objets

Java.

Quel

est

donc

l’intérêt

du

mappage

d’attributs

?

Bien

qu’IBM

Tivoli

Directory

Integrator

ait

mis

les

données

à

votre

disposition,

le

système

ne

sait

pas

à

l’avance

comment

vous

envisagez

de

les

utiliser.

Par

conséquent,

vous

devez

au

moins

sélectionner

les

attributs

à

utiliser.

Certains

attributs

peuvent

être

calculés,

fusionnés,

créés

ou

convertis

en

un

autre

format

ou

type

que

celui

choisi

par

IBM

Tivoli.

Habituellement,

ce

travail

est

effectué

par

codage

dans

votre

mappe

d’attributs.

Pour

avoir

une

idée

sur

la

façon

dont

cela

fonctionne

dans

IBM

Tivoli

Directory

Integrator,

vous

devez

d’abord

savoir

que

les

connecteurs

(en

fait,

tous

les

composants)

sont

constitués

de

deux

parties

:

v

Le

connecteur

brut,

capable

de

dialoguer

avec

une

source

de

données

et

d’en

interpréter

les

réponses

v

L’encapsuleur

du

connecteur

générique

Ligne

d’assemblage

qui

permet

aux

connecteurs

de

se

connecter

et

de

fonctionner

dans

la

structure

de

la

ligne

d’assemblage

d’IBM

Tivoli

Directory

Integrator.

Les

informations

à

destination

ou

en

provenance

d’une

source

de

données

sont

stockées

dans

un

objet

de

stockage

local

temporaire

à

l’intérieur

du

connecteur

brut.

A

cet

endroit,

vous

pouvez

mapper

les

attributs

dans

la

ligne

d’assemblage

ou,

dans

le

cas

d’un

connecteur

de

sortie,

dans

la

source

de

sortie

de

données.

Il

existe

un

objet

de

stockage

(un

objet

d’entrée)

nommé

work

et

utilisé

par

toute

la

ligne

d’assemblage

pour

transférer

les

valeurs

des

données

(attributs).

De

plus,

chaque

connecteur

possède

un

objet

d’entrée

local

nommé

conn

et

utilisé

pour

les

opérations

d’accès

de

données.

L’opération

qui

consiste

à

transférer

des

données

dans

un

flot

de

données

ou

à

en

extraire

s’appelle

le

mappage.

Cette

action

implique

le

transfert

de

valeurs

de

données

entre

un

objet

work

d’une

ligne

d’assemblage

et

l’objet

conn

d’un

connecteur.

Comme

indiqué

précédemment,

vous

pouvez

à

tout

moment

modifier

la

partie

spécifique

à

la

source

de

données.

Il

suffit

pour

cela

de

modifier

son

type

en

utilisant

le

bouton

Héritage

ou

de

cliquer

sur

le

lien

Hériter

de

:

en

haut

de

la

sous-fenêtre

Détails

du

connecteur

(voir

page

22)

.

Toutefois,

si

vous

procédez

ainsi,

vous

risquez

d’avoir

également

à

modifier

la

mappe

d’attributs

pour

que

vos

règles

métier

(script)

et

les

autres

connecteurs

de

votre

ligne

d’assemblage

aient

toujours

accès

aux

attributs

dont

ils

ont

besoin.

Chapitre

3.

Présentation

d’IBM

Tivoli

Directory

Integrator

25

Page 38: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Votre

mappe

d’attributs

peut

également

être

affectée

si

vous

modifiez

le

mode

de

votre

connecteur

dans

la

mesure

les

connecteurs

en

mode

entrée

mappent

les

attributs

depuis

une

mémoire

locale

du

connecteur

brut

(appelé

conn

dans

vos

scripts)

vers

l’objet

utilisé

pour

stocker

et

transférer

les

données

dans

la

ligne

d’assemblage

(l’objet

work).

Les

connecteurs

de

sortie

mappent

les

attributs

en

sens

inverse:

de

l’objet

work

vers

l’objet

conn.

Dans

cet

exemple,

le

connecteur

Personnes_entrée

est

en

mode

entrée,

si

bien

que

vous

devez

configurer

la

mappe

d’entrée.

Au-dessus

de

la

case

marquée

Attribut

work,

la

barre

d’outils

Mappe

d’attributs

vous

permet

de

gérer

les

attributs

de

la

mappe.

La

zone

à

droite

de

la

mappe

présente

la

liste

des

attributs

trouvés

par

le

connecteur.

De

là,

vous

pouvez

sélectionner

un

ou

plusieurs

attributs

pour

les

glisser

sur

la

mappe

d’attributs.

Pour

sélectionner

plusieurs

éléments

à

la

fois,

appuyez

sur

Maj

ou

Ctrl

en

mettant

en

surbrillance

les

éléments

dans

les

listes.

Remarque

:

Un

incident

peut

survenir

sur

la

version

actuelle

de

la

bibliothèque

à

interface

graphique

pour

Java

de

votre

plateforme

si

vous

essayez

d’effectuer

cette

opération.

Dans

ce

cas,

faites

glisser

et

déplacer

les

attributs

en

haut

de

l’en-tête

de

la

liste

portant

la

mention

Attribut

work.

26

IBM

Tivoli

Directory

Integrator

5.2

-

Guide

d’initiation

Page 39: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Vous

remarquerez

que

les

attributs

que

vous

ajoutez

à

la

mappe

d’entrée

apparaissent

à

la

fois

dans

la

liste

des

attributs

work

et

dans

la

case

Entrée

work

située

immédiatement

au-dessous

de

la

liste

de

connecteurs

de

la

liste

d’assemblage.

L’écran

Entrée

work

ressemble

à

une

fenêtre

dans

votre

flot

de

données.

Il

indique

les

attributs

en

cours

de

de

mappage

depuis

les

systèmes

connectés

(ou

ceux

que

vous

créez),

ainsi

que

le

nom

des

connecteurs

qui

en

sont

responsables.

Lorsque

vous

avez

terminé

le

mappage

de

votre

premier

connecteur,

vous

obtenez

le

résultat

suivant

:

Chapitre

3.

Présentation

d’IBM

Tivoli

Directory

Integrator

27

Page 40: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Vous

avez

réalisé

un

mappage

simple,

un

à

un,

d’un

connecteur

sur

la

ligne

d’assemblage.

Si

vous

devez

effectuer

un

mappage

plus

complexe,

les

boutons

mentionnés

ci-avant

et

situés

au-dessus

de

la

case

Attribut

work

entrent

en

action.

Par

exemple

:

Nouveau

Ce

bouton

vous

permet

d’ajouter

manuellement

des

attributs

qui

ne

seraient

pas

disponibles

dans

l’un

de

vos

systèmes

d’entrée

ou

que

vous

pourriez

avoir

besoin

de

calculer

à

partir

d’attributs

existants.

Supprimer

Permet

de

supprimer

un

ou

plusieurs

attributs

de

la

mappe.

Basculer...

Permet

de

basculer

de

la

sous-fenêtre

contenant

les

attributs

de

connecteur

disponibles

vers

une

autre

affichant

les

détails

du

traitement

actuellement

apporté

à

chaque

attribut

de

la

mappe.

Renommer...

Permet

de

modifier

le

nom

de

l’attribut.

Flèches

Haut

et

Bas

Ces

boutons

vous

permettent

de

changer

le

sens

d’exécution

des

connecteurs.

Rappelez-vous

que

la

ligne

d’assemblage

est

exécutée

du

haut

vers

le

bas

de

la

liste.

Copie

dans

la

bibliothèque

Lorsqu’un

connecteur

vous

satisfait,

vous

pouvez

le

copier

dans

la

bibliothèque

des

connecteurs

en

utilisant

ce

bouton.

28

IBM

Tivoli

Directory

Integrator

5.2

-

Guide

d’initiation

Page 41: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Chaque

fois

que

vous

sélectionnez

un

attribut

dans

la

mappe

d’entrée,

les

détails

du

mappage

correspondant

à

cet

attribut

apparaissent.

La

partie

supérieure

de

l’écran

Détails

comporte

une

case

à

cocher

marquée

Avancé.

Ainsi

que

vous

pouvez

le

constater,

elle

n’est

pas

cochée,

ce

qui

signifie

que

vous

utilisez

un

mappage

simple

pour

les

attributs.

Par

exemple,

IBM

Tivoli

Directory

Integrator

transfère

les

valeurs

des

attributs

correspondants

lus

depuis

le

système

connecté.

Cependant,

si

vous

souhaitez

convertir

les

données

entrantes

ou

manipuler

ces

valeurs,

vous

pouvez

écrire

le

script

en

mode

Avancé.

Après

que

vous

avez

sélectionné

le

mode

Avancé,

une

fenêtre

d’éditeur

de

script

apparaît,

vous

pouvez

ajouter

votre

propre

logique.

Si

vous

souhaitez

émuler

simplement

les

opérations

qu’IBM

Tivoli

Directory

Integrator

effectue

déjà

en

mode

simple,

la

case

peut

contenir

le

snippet

suivant

de

code

JavaScript

:

ret.value

=

conn.getAttribute("First");

Remarque

:

Lorsqu’IBM

Tivoli

Directory

Integrator

procède

à

un

mappage

simple,

il

copie

les

attributs,

comme

indiqué

ci-dessus,

mais

le

fait

dans

un

fichier

Java

natif

au

lieu

d’utiliser

le

moteur

de

script

appelé

au

moment

vous

sélectionnez

l’option

Mappage

avancé.

Si

un

mappage

simple

est

suffisant,

ne

choisissez

pas

le

mappage

avancé

;

laisser

IBM

Tivoli

Directory

Integrator

traiter

le

mouvement

des

données

s’avère

bien

plus

efficace.

Chapitre

3.

Présentation

d’IBM

Tivoli

Directory

Integrator

29

Page 42: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Cette

ligne

de

script

renvoie

l’attribut

nommé

First

de

la

mémoire

locale

du

connecteur

brut

(l’objet

conn).

Prenez

le

temps

d’observer

la

fenêtre

de

l’éditeur

de

script

IBM

Tivoli

Directory

Integrator

qui

apparaît

lorsque

vous

devez

écrire

des

scripts.

Cette

fenêtre

présente

un

certain

nombre

de

fonctions

d’éditeur

courantes

(dont

certaines

apparaissent

sous

forme

de

boutons

dans

la

ligne

située

au-dessus

de

la

fenêtre

de

l’éditeur).

Touches

de

déplacement

du

curseur

Permet

de

déplacer

le

curseur

dans

la

fenêtre

de

l’éditeur.

Pour

sélectionner

du

texte,

maintenez

appuyée

la

touche

Maj

en

même

temps

tout

en

déplaçant

le

curseur.

Si

vous

appuyez

sur

Ctrl

et

sur

les

touches

gauche

et

droite

de

déplacement

du

curseur,

le

curseur

se

déplace

d’un

mot

à

la

fois.

Pour

sélectionner

l’ensemble

des

mots

ou

des

lignes

de

script,

appuyez

simultanément

sur

les

touches

Maj

et

Ctrl.

Couper

Permet

de

couper

le

texte

sélectionné.

Cette

fonction

est

disponible

à

partir

du

premier

bouton

de

gauche

dans

la

ligne

située

au-dessus

de

la

fenêtre

de

l’éditeur

ou

à

l’aide

du

raccourci-clavier

Ctrl+X.

Copier

Permet

de

copier

la

sélection

courante.

Vous

pouvez

exécuter

cette

fonction

en

cliquant

sur

le

deuxième

bouton

à

gauche

dans

la

ligne

des

boutons

ou

en

appuyant

sur

Ctrl+C.

30

IBM

Tivoli

Directory

Integrator

5.2

-

Guide

d’initiation

Page 43: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Coller

Permet

de

coller

du

texte

dans

le

script

à

l’emplacement

du

curseur.

Vous

pouvez

cliquer

sur

le

troisième

bouton

à

partir

de

la

gauche

ou

appuyer

sur

Ctrl+V.

Annuler

Permet

d’annuler

la

dernière

opération

d’édition.

Il

s’agit

du

quatrième

bouton

à

gauche.

Répéter

Permet

de

rétablir

la

modification

que

vous

venez

d’annuler.

Cette

fonction

apparaît

dans

la

ligne

de

boutons,

à

droite

du

bouton

Annuler.

Rechercher

Permet

de

rechercher

le

texte

dans

votre

script.

Vous

pouvez

cliquer

sur

le

sixième

bouton

à

partir

de

la

gauche

ou

appuyer

sur

Ctrl+F.

Rechercher

suivant

Permet

de

répéter

la

dernière

recherche.

Cliquez

sur

le

dernier

bouton

de

la

ligne

ou

appuyez

sur

Ctrl+G.

Activer/Désactiver

retours

à

la

ligne

Active

et

désactive

les

retours

à

la

ligne

dans

la

fenêtre

de

l’éditeur.

Modifier

le

tampon

avec

un

éditeur

externe

Si

vous

avez

déclaré

un

éditeur

externe

à

l’aide

de

l’option

Fichier–>Préférences

de

l’onglet

Paramètres

du

programme

d’édition,

celui-ci

est

lancé

lorsque

vous

appuyez

sur

ce

bouton.

Le

contenu

du

tampon

d’édition

de

script

est

transféré

vers

l’éditeur

externe

et

les

résultats

de

votre

travail

sont

renvoyés

à

IBM

Tivoli

Directory

Integrator

lorsque

vous

avez

terminé.

Essayez

d’écrire

un

script

en

ajoutant

un

attribut

nommé

Nom_complet

que

vous

pouvez

calculer

à

l’aide

des

valeurs

des

autres

attributs

lus

dans

la

source

d’entrée.

Cliquez

sur

le

bouton

Nouveau

en

haut

de

la

mappe

d’entrée

Dans

la

boîte

de

dialogue

qui

s’ouvre,

entrez

le

nom

Nom_complet

et

cliquez

sur

OK.

IBM

Tivoli

Directory

Integrator

utilisera

automatiquement

le

mappage

simple

pour

récupérer

la

valeur

d’un

attribut

de

source

de

données

nommé

Nom_complet.

Chapitre

3.

Présentation

d’IBM

Tivoli

Directory

Integrator

31

Page 44: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Cette

opération

n’aboutit

pas

car

ces

informations

ne

sont

pas

disponibles

dans

le

fichier

d’entrée.

Vous

devez

donc

sélectionner

cette

nouvelle

entrée

dans

la

liste

Mappe

d’attributs

et

cocher

la

case

Mappage

avancé.

Vous

accédez

ainsi

à

la

fenêtre

de

l’éditeur

de

script.

Le

script

que

vous

utilisez

pour

créer

la

valeur

de

cet

attribut

est

le

suivant

:

gn

=

conn.getString("First");

sn

=

conn.getString("Last");

Ces

deux

premières

lignes

récupèrent

la

valeur

des

attributs

First

et

Last

sous

la

forme

d’une

chaîne,

et

la

stocke

dans

deux

nouvelles

variables

appelées

respectivement

gn

et

sn

:

ret.value

=

gn

+

"

"

+

sn;

La

dernière

instruction

renvoie

la

valeur

de

ces

deux

variables

locales

concaténées

et

séparées

par

un

seul

espace.

Remarque

:

Vous

pouvez

créer

cet

attribut

dans

le

connecteur

de

sortie.

Cependant,

comme

vous

en

aurez

besoin

par

la

suite

dans

la

ligne

d’assemblage,

placez-le

dans

le

connecteur

d’entrée.

Vous

avez

maintenant

terminé

d’alimenter

le

flot

de

données

en

entrée.

Vous

vous

êtes

connecté

à

la

source

d’entrée,

vous

avez

soumis

ligne

par

ligne

le

train

d’octets

à

l’interpréteur

CSV,

converti

ces

zones

en

objets

Java

et

transféré

ces

données

dans

la

ligne

d’assemblage.

Il

ne

vous

reste

plus

qu’à

ajouter

le

connecteur

de

sortie.

32

IBM

Tivoli

Directory

Integrator

5.2

-

Guide

d’initiation

Page 45: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Ajout

du

connecteur

de

sortie

Cliquez

sur

le

bouton

Ajouter

dans

la

barre

d’outils

en

bas

de

la

liste

des

connecteurs.

Nommez

le

connecteur

SortieXML.

Choisissez

de

nouveau

le

type

Système

de

fichiers

et

sélectionnez

le

mode

Ajout

uniquement

(seul

mode

de

sortie

pris

en

charge

par

le

connecteur

Système

de

fichiers).

Après

avoir

choisi

ce

connecteur

dans

la

liste

des

connecteurs,

configurez

les

paramètres

de

connexion

en

nommant

le

fichier

de

sortie

Sortie.xml

et

en

le

plaçant

dans

le

répertoire

dans

lequel

se

trouve

le

fichier

d’entrée.

Chapitre

3.

Présentation

d’IBM

Tivoli

Directory

Integrator

33

Page 46: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Cliquez

à

présent

sur

l’onglet

Interpréteur

et

sélectionnez

l’interpréteur

XML.

La

dernière

étape

consiste

à

indiquer

au

connecteur

SortieXML

les

attributs

qu’il

devra

écrire

dans

le

document

XML.

Cliquez

sur

l’onglet

Mappe

de

sortie

au-dessus

de

la

case

Attribut

conn

(qui

doit

être

vide)

et

mappez

les

attributs

de

la

ligne

d’assemblage

(par

exemple,

l’entrée

work)

vers

le

connecteur

(l’entrée

conn)

afin

de

permettre

au

connecteur

de

sortir

ces

valeurs.

Vous

remarquerez

que

l’onglet

Mappe

de

sortie

est

désactivé

car

ce

connecteur

est

en

mode

sortie

(Ajout

uniquement).

Les

attributs

disponibles

pour

le

mappage

apparaissent

dans

la

liste

portant

la

mention

Entrée

work,

à

gauche

de

la

sous-fenêtre

Détails

du

connecteur.

34

IBM

Tivoli

Directory

Integrator

5.2

-

Guide

d’initiation

Page 47: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

De

la

même

manière

que

pour

le

mappage

d’entrée,

déplacez

maintenant

les

éléments

de

la

liste

Entrée

work

vers

la

liste

Attribut

conn

(comme

précédemment,

vous

pouvez

avoir

à

les

déposer

sur

la

barre

de

titre).

Chapitre

3.

Présentation

d’IBM

Tivoli

Directory

Integrator

35

Page 48: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

A

présent,

vous

devez

rajouter

l’attribut

Mail

que

vous

avez

défini

à

la

page

6.

Comme

cet

attribut

n’existe

pas

dans

votre

source

d’entrée,

vous

devez

en

calculer

la

valeur.

Vous

remarquerez

que

la

liste

Entrée

work

inclut

un

attribut

nommé

FullName

(que

vous

avez

calculé

en

utilisant

First

et

Last).

Vous

pouvez

utiliser

cette

valeur

pour

créer

une

adresse

électronique

pour

chaque

entrée

que

vous

traitez.

Comme

il

est

courant

d’avoir

plusieurs

adresses

électroniques,

vous

pouvez

en

créer

deux,

courrier

devenant

alors

un

attribut

à

valeurs

multiples.

Pour

ce

faire,

cliquez

sur

le

bouton

Ajouter

un

attribut,

à

gauche

et

au-dessus

de

la

liste

Attribut

conn.

Une

boîte

de

dialogue

vous

demande

alors

de

nommer

le

nouvel

attribut.

Nommez-le

Courrier

et

cliquez

sur

OK.

Sélectionnez

le

nouveau

connecteur

dans

la

liste.

Cochez

la

case

Mappage

avancé

et

entrez

le

script

suivant

:

gn

=

work.getString("First");

cn

=

work.getString("FullName");

Ces

deux

premières

lignes

permettent

d’enregistrer

les

valeurs

des

attributs

First

et

FullName

dans

les

variables

locales.

Notez

la

manière

dont

vous

utilisez

l’objet

work

pour

accéder

aux

données

figurant

dans

la

ligne

d’assemblage

:

var

att

=

system.newAttribute("Mail");

36

IBM

Tivoli

Directory

Integrator

5.2

-

Guide

d’initiation

Page 49: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

La

ligne

suivante

utilise

un

appel

système

pour

créer

un

nouvel

attribut.

Attribuez-lui

un

nom

provisoire,

même

s’il

est

recommandé

de

le

nommer

d’après

l’attribut

vers

lequel

vous

le

mappez

:

att.addValue(gn

+

"@societe.com");

att.addValue(cn.replace("

",".")

+

"@societe.com");

Ces

deux

lignes

calculent

et

ajoutent

les

valeurs

à

cet

attribut,

qui

devient

dès

lors

un

attribut

à

valeurs

multiples.

Sur

la

deuxième

ligne,

vous

utilisez

la

fonction

de

chaîne

Java

.replace()

car

la

valeur

en

retour

de

.GetString()

est

un

objet

de

type

chaîne

Java.

Cet

appel

permet

de

remplacer

les

espaces

par

des

points

dans

le

nom.

Par

exemple,

″Peter

Belamy″

devient

″Peter.Belamy″.

ret.value

=

att;

Enfin,

l’attribut

que

vous

venez

de

créer

est

renvoyé

et

IBM

Tivoli

Directory

Integrator

convertit

l’objet

complexe

au

format

de

la

source

de

sortie.

Votre

première

implémentation

de

flot

de

données

est

prête

à

être

testée.

Exécution

de

votre

ligne

d’assemblage

La

ligne

d’assemblage

est

à

présent

terminée

et

prête

à

être

testée.

Cliquez

sur

le

bouton

Exécuter

dans

la

barre

d’outils

de

boutons

de

la

ligne

d’assemblage

en

haut

de

la

fenêtre

Détails

de

la

ligne

d’assemblage.

Lorsque

vous

demandez

à

IBM

Tivoli

Directory

Integrator

d’exécuter

une

ligne

d’assemblage,

le

système

démarre

une

instance

du

serveur

et

lui

transmet

la

configuration

en

cours.

Remarque

:

Vous

pouvez

démarrer

le

serveur

hors

de

Toolkit

IDE

et

lui

demander

d’utiliser

une

configuration

spécifique.

IBM

Tivoli

Directory

Integrator

crée

à

présent

une

nouvelle

sous-fenêtre,

nommée

ExecuteTask-AL,

qui

affiche

un

fichier

journal

du

démarrage

de

votre

nouvelle

ligne

d’assemblage.

Chapitre

3.

Présentation

d’IBM

Tivoli

Directory

Integrator

37

Page 50: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Excepté

la

ligne

Exécuter

le

code

de

sortie

en

bas

de

la

fenêtre

(signalant

simplement

que

le

serveur

s’est

arrêté

après

le

démarrage

de

la

ligne

d’assemblage

indiquée),

les

informations

figurant

dans

cette

fenêtre

se

divisent

en

trois

grandes

parties

:

v

Informations

relatives

à

la

version

du

serveur

que

vous

exécutez.

v

Description

de

l’environnement

dans

lequel

s’exécute

IBM

Tivoli

Directory

Integrator,

comprenant

la

machine

virtuelle

qu’il

doit

utiliser

et

le

répertoire

de

travail.

v

Informations

relatives

au

démarrage

de

votre

solution,

y

compris

:

Les

paramètres

utilisés

pour

le

démarrage

du

serveur

Le

fichier

de

configuration

utilisé

(qui,

en

l’occurrence,

a

la

forme

<stdin>,

indiquant

qu’il

a

été

transmis

au

serveur

d’exécution

depuis

l’IDE)

Les

messages

générés

au

cours

de

l’exécution

de

la

ligne

d’assemblage

et

de

ses

connecteurs

Vous

pouvez

également

envoyer

vous-même

des

messages

au

fichier

journal

en

utilisant

des

objets

et

fonctions

spéciauxIBM

Tivoli

Directory

Integrator

disponibles

lorsque

vous

écrivez

vos

scripts,

tels

que

la

fonction

task.logmsg(″placez_votre

_message_ici″).

En

bas

de

cette

dernière

section

figure

le

message

signalant

que

la

ligne

d’assemblage

(CSVversXML)

a

été

exécutée

sans

erreurs.

Cela

signifie

que

vous

pouvez

ouvrir

le

fichier

de

sortie

que

vous

avez

préalablement

défini

(voir

«Ajout

du

connecteur

de

sortie»

à

la

page

33).

Ouvrez

ce

fichier

(dans

un

navigateur,

par

exemple)

pour

vérifier

que

la

ligne

d’assemblage

a

bien

converti

les

données

d’entrée

CSV

en

document

XML.

38

IBM

Tivoli

Directory

Integrator

5.2

-

Guide

d’initiation

Page 51: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Même

les

attributs

Courrier

et

Nom_complet

y

figurent,

calculés

par

vos

snippets

de

script.

Chapitre

3.

Présentation

d’IBM

Tivoli

Directory

Integrator

39

Page 52: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Toutefois,

l’une

des

entrées

(Roger,

présentée

dans

la

capture

d’écran

précédente)

est

incomplète.

Il

lui

manque

les

attributs

Last

et

Title.

Si

vous

consultez

le

fichier

de

données

d’entrée

(voir

page

10),

vous

constaterez

que

ces

zones

ne

figurent

pas

dans

le

fichier

CSV

d’entrée.

La

meilleure

solution

consiste

à

éditer

le

fichier

CSV

et

à

ajouter

les

zones

manquantes.

Cependant,

peu

de

sources

de

données

vous

en

offrent

la

possibilité.

A

la

place,

vous

pouvez

filtrer

l’entrée

en

écrivant

le

script

d’un

crochet.

Remarque

:

Avant

d’apporter

des

améliorations

à

la

ligne

d’assemblage,

effectuez

l’une

des

opérations

suivantes

pour

enregistrer

votre

travail

:

v

Dans

la

barre

d’outils

principale,

cliquez

sur

Enregistrer.

v

Dans

le

menu

principal,

sélectionnez

Fichier–>Enregistrer.

v

Appuyez

sur

Ctrl+S.

Utilisation

des

crochets

Les

crochets

sont

des

points

de

cheminement

dans

l’exécution

de

la

ligne

d’assemblage

et

de

ses

connecteurs,

vous

pouvez

ajouter

votre

propre

logique.

Même

si

la

plupart

des

crochets

sont

associés

à

des

connecteurs,

plusieurs

apparaissent

dans

l’onglet

Crochets

de

la

ligne

d’assemblage.

Ces

crochets

sont

mis

en

application

au

début

et

à

la

fin

du

cycle

de

vos

flots

de

données

:

1.

Lancement

des

prologues.

a.

Si

des

scripts

de

bibliothèque

sont

configurés

comme

prologues

globaux

de

votre

ligne

d’assemblage,

ils

sont

exécutés.

b.

Il

existe

deux

crochets

de

prologue

de

ligne

d’assemblage

:

l’un

est

lancé

avant

que

les

connecteurs

n’initialisent

les

connexions

à

leurs

sources

de

données,

l’autre

après.

Puisque

vous

pouvez

contrôler

la

ligne

d’assemblage

et

ses

connecteurs

à

partir

de

vos

scripts,

vous

pouvez

reconfigurer

les

composants

et

même

modifier

le

flot

proprement

dit.

c.

Les

connecteurs

sont

à

présent

initialisés.

d.

Après

l’initialisation,

le

crochet

nommé

Prologue

démarre

s’il

est

activé.2.

A

présent,

le

flot

de

données

commence

et

le

contrôle

est

transféré

au

premier

connecteur.

Lorsqu’il

a

terminé,

le

traitement

passe

au

connecteur

suivant

de

la

ligne,

et

ainsi

de

suite

jusqu’à

ce

que

le

dernier

connecteur

ait

terminé.

Si

la

ligne

d’assemblage

comporte

des

itérateurs

(par

exemple,

des

connecteurs

en

mode

Itérateur),

le

contrôle

retourne

au

départ

et

la

ligne

d’assemblage

est

relancée

pour

l’entrée

suivante.

Bien

que

chaque

mode

de

connecteur

ait

son

propre

flot

intégré,

tous

les

flots

sont

cohérents

et

partagent

des

crochets

appropriés.

Par

exemple,

les

modes

Recherche,

Mise

à

jour

et

Suppression

sont

tous

câblés

de

la

même

manière

pour

le

traitement

des

recherches

(comme

vous

pouvez

le

constater

en

changeant

de

mode

pendant

que

vous

visualisez

l’onglet

Crochets).

Il

existe

une

description

graphique

de

ces

flots

sous

la

forme

d’organigrammes

des

modes

de

connecteur.

Vous

les

trouverez

dans

le

Guide

de

référence

d’IBM

Tivoli

Directory

Integrator

et

dans

un

guide

de

référence

rapide

séparé.

3.

Lorsque

toutes

les

itérations

sont

terminées

(par

exemple

lorsque

le

dernier

itérateur

atteint

la

fin

des

données),

l’épilogue

de

la

ligne

d’assemblage

est

exécuté.

4.

Enfin,

les

connecteurs

ferment

leur

connexion.

40

IBM

Tivoli

Directory

Integrator

5.2

-

Guide

d’initiation

Page 53: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Pour

revenir

à

notre

exemple,

vous

devez

vérifier

la

présence

de

données

manquantes

dans

votre

fichier

d’entrée

CSV.

Comme

cette

source

de

données

est

traitée

par

le

connecteur

nommé

Personnes_entrée,

sélectionnez-le

dans

la

liste

des

connecteurs,

puis

cliquez

sur

l’onglet

Crochets

(en

regard

de

la

mappe

d’attributs).

Vous

pouvez

ajouter

votre

logique

de

filtrage

dans

cette

zone.

Chaque

connecteur

dispose

de

trois

ensembles

de

crochets,

représentés

dans

l’arborescence

Crochets

par

des

dossiers

:

Dans

le

prologue

Ce

dossier

comporte

au

moins

deux

crochets

:

v

L’un

est

exécuté

après

le

prologue

de

la

ligne

d’assemblage

(Avant

initialisation).

v

L’autre

est

exécuté

juste

avant

le

prologue

de

la

ligne

d’assemblage

(Après

initialisation).

En

mode

Itérateur,

vous

pouvez

également

obtenir

des

crochets

supplémentaires

pour

avant

ou

après

l’opération

de

sélection

dès

que

le

connecteur

a

une

vue

des

données

à

partir

desquelles

il

effectuera

une

itération.

Flot

de

données

Crochets

démarrés

à

chaque

itération

de

la

ligne

d’assemblage,

chaque

fois

que

le

connecteur

est

exécuté.

Des

crochets

tels

que

Avant

exécution

et

Erreur

par

défaut

sont

communs

à

tous

les

modes

de

connecteur.

La

plupart

des

autres

connecteurs

sont

propres

au

mode.

Votre

connecteur

Personnes_entrée

étant

configuré

en

mode

Itérateur,

il

effectue

un

certain

nombre

d’opérations

GetNext

pour

extraire

les

données

d’entrée.

Le

mode

Chapitre

3.

Présentation

d’IBM

Tivoli

Directory

Integrator

41

Page 54: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Itérateur

vous

fournit

des

crochets

de

type

Avant

GetNext

et

Après

GetNext

pour

vous

permettre

d’encapsuler

cette

opération

de

lecture

dans

votre

propre

logique.

Après

épilogue

Ces

crochets

s’exécutent

une

fois,

à

la

fin

du

cycle

de

la

ligne

d’assemblage,

juste

après

l’épilogue

de

celle-ci.

Notez

que

chaque

connecteur

exécute

son

propre

cycle

Epilogue

(Avant

fermeture,

fermeture

de

la

connexion,

Après

fermeture)

dans

l’ordre

d’apparition

dans

la

ligne

d’assemblage

(lorsque

vous

rédigez

le

script

d’un

crochet,

n’en

tenez

pas

compte).

Le

connecteur

Personnes_entrée

étant

sélectionné,

cliquez

sur

le

crochet

Après

GetNext

figurant

dans

la

liste.

Entrez

le

script

suivant

dans

la

fenêtre

de

l’éditeur

à

droite

de

la

liste

des

crochets

:

Remarque

:

Si

une

sous-fenêtre

est

trop

petite

(comme

celle

de

l’éditeur

de

script),

vous

pouvez

la

redimensionner

en

déplaçant

une

ou

plusieurs

barres

de

séparation

à

l’aide

du

curseur.

sn

=

conn.getString("Last");

title

=

conn.getString("Title");

Les

deux

premières

lignes

extraient

et

enregistrent

les

valeurs

de

deux

attributs

disponibles

dans

le

connecteur

brut.

Comme

nous

l’avons

vu

au

sujet

du

mappage

d’attributs

(page

25),

chaque

connecteur

fait

appel

à

un

objet

de

stockage

local

42

IBM

Tivoli

Directory

Integrator

5.2

-

Guide

d’initiation

Page 55: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

qu’il

utilise

dans

ses

opérations

sur

les

données.

Cet

objet

est

référencé

au

moyen

de

la

variable

de

script

conn.

Dans

le

cas

de

l’exemple

précédent,

vous

pouvez

utiliser

les

crochets

Opération

GetNext

réussie

ou

Succès

par

défaut

pour

effectuer

le

filtrage.

Comme

ces

crochets

viennent

après

la

mappe

d’attributs

d’entrée,

ces

attributs

sont

mappés

vers

l’entrée

work

et

vous

pouvez

écrire

votre

script

en

utilisant

à

la

place

la

variable

work.

if

(sn

==

null

||

title

==

null)

{

Vérifiez

si

la

valeur

renvoyée

pour

l’attribut

Last

ou

Title

est

nulle

(c’est-à-dire

qu’elle

n’existe

pas

dans

la

source

de

données

d’entrée).

Si

tel

est

le

cas,

les

trois

lignes

suivantes

sont

lancées.

Remarque

:

Vous

pouvez,

si

vous

le

souhaitez,

contrôler

l’existence

d’autres

zones

dans

une

version

finale

de

cette

ligne

d’assemblage.task.logmsg("-->

Enregistrement

ignoré

(données

manquantes)");

L’objet

de

tâche

vous

permet

d’accéder

aux

fonctions

de

la

ligne

d’assemblage,

telles

que

logmsg(),

qui

vous

permet

d’écrire

dans

un

fichier

journal

de

la

ligne

d’assemblage.

task.dumpEntry(conn);

Cette

fois,

vous

utilisez

la

fonction

(tâche)

dumpEntry()

de

la

ligne

d’assemblage

pour

écrire

dans

le

fichier

journal

le

contenu

de

l’objet

de

mémoire

locale

du

connecteur

brut

(conn).

Remarque

:

Conn

et

work

sont

des

objets

de

même

type,

si

bien

que

des

fonctions

telles

que

dumpEntry()

fonctionnent

aussi

bien

sur

les

deux.

system.skipEntry();

}

Enfin,

utilisez

la

fonction

skipEntry()

de

l’objet

système

pour

signaler

à

IBM

Tivoli

Directory

Integrator

d’ignorer

cet

élément

d’entrée,

de

redémarrer

en

haut

de

la

boucle

de

la

ligne

d’assemblage

et

de

lire

le

suivant.

Avant

de

tester

à

nouveau

la

ligne,

modifiez

légèrement

la

mappe

d’attributs

de

sortie.

Conversion

de

schéma

Dans

notre

exemple

(voir

page

6),

les

attributs

de

sortie

portent

le

même

nom

que

ceux

de

la

source

d’entrée.

Mais

imaginez

un

instant

que

la

spécification

appelle

des

attributs

de

sortie

devant

être

nommés

FirstName

et

LastName

:

FirstName

=DS1.First

LastName

=DS1.Last

FullName

=DS1.First+"

"+DS1.Last

Title

=DS1.Title

Mail

=<créé_à_partir_du_nom>

Grâce

à

IBM

Tivoli

Directory

Integrator,

le

mappage

des

noms

des

attributs

entre

les

schémas

est

simplifié.

Il

vous

suffit

de

mettre

à

jour

les

noms

de

ces

attributs

directement

dans

la

mappe

d’attributs

du

connecteur

de

sortie.

Sélectionnez

le

connecteur

SortieXML,

puis

cliquez

sur

l’attribut

à

modifier

dans

la

mappe

d’attributs

et

commencez

à

taper.

Chapitre

3.

Présentation

d’IBM

Tivoli

Directory

Integrator

43

Page 56: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Ne

vous

inquiétez

pas,

cela

n’affecte

pas

les

scripts

de

la

ligne

d’assemblage

:

ces

noms

sont

en

effet

modifiés

en

local

pour

la

phase

de

mappage

d’attributs

du

connecteur

de

sortie.

La

lecture

des

attributs

First

et

Last

s’effectue

correctement

et

ces

derniers

sont

disponibles

dans

la

ligne

d’assemblage.

Remarque

:

Dans

la

mesure

IBM

Tivoli

Directory

Integrator

cible

la

zone

de

saisie,

même

si

vous

basculez

sur

un

autre

connecteur

ou

une

autre

ligne

d’assemblage,

vous

pouvez

rester

en

mode

édition

pour

le

nom

de

l’attribut.

Pour

quitter

le

mode

édition,

sélectionnez

un

autre

attribut

dans

la

même

mappe

ou

appuyez

sur

Entrée

pour

informer

IBM

Tivoli

Directory

Integrator

que

vous

avez

terminé.

Laissez

ces

modifications

(même

si

elles

ne

font

pas

partie

des

spécifications

initiales),

puis

relancez

la

ligne

d’assemblage.

A

la

fin

de

l’exécution

d’IBM

Tivoli

Directory

Integrator,

retournez

à

la

fenêtre

du

navigateur

de

sortie

et

cliquez

sur

le

bouton

Réinitialiser.

Si

vous

avez

fermé

cette

fenêtre,

vous

devez

répéter

les

étapes

suivies

pour

l’ouverture

du

fichier

de

sortie

après

la

première

exécution

(voir

«Exécution

de

votre

ligne

d’assemblage»

à

la

page

37).

44

IBM

Tivoli

Directory

Integrator

5.2

-

Guide

d’initiation

Page 57: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Lorsque

ce

fichier

est

à

nouveau

affiché,

vérifiez

que

Roger

(autrefois

placé

entre

Jill

et

Gregory)

n’y

figure

plus.

Notez

également

les

changements

apportés

à

deux

des

des

noms

d’attributs.

Enregistrez

de

nouveau

votre

configuration

(Ctrl+S)

et

passez

à

l’étape

suivante,

à

savoir

la

collecte

de

données

d’une

troisième

source.

Ajout

du

connecteur

de

jointure

Les

fichiers

Tutorial

comprennent

une

base

de

données

simple

regroupant

les

personnes

redevables

d’une

dette.

Utilisez

cette

source

pour

envoyer

les

informations

relatives

aux

débiteurs

dans

le

document

XML

de

sortie.

La

première

étape

consiste

à

ajouter

un

troisième

connecteur

à

l’aide

du

bouton

Ajouter

dans

la

barre

d’outils

de

la

ligne

d’assemblage.

Nommez

ce

connecteur

Débiteurs

et

choisissez

le

connecteur

BTree

Object

DB.

Ce

connecteur

doit

être

en

mode

Recherche

car

vous

cherchez

les

enregistrements

correspondant

aux

données

de

la

ligne

d’assemblage.

Dès

que

vous

ajoutez

un

nouveau

connecteur

à

la

liste,

IBM

Tivoli

Directory

Integrator

le

place

à

la

fin

de

la

ligne

d’assemblage.

Cependant,

cela

ne

peut

fonctionner

car

vous

devez

effectuer

la

collection

des

données

après

l’entrée

(itération)

mais

avant

le

connecteur

de

sortie.

Pour

ce

faire,

sélectionnez

le

connecteur

Débiteurs

et

cliquez

sur

le

bouton

Haut

de

la

barre

d’outils

du

flot

de

données

de

la

ligne

d’assemblage.

Chapitre

3.

Présentation

d’IBM

Tivoli

Directory

Integrator

45

Page 58: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

46

IBM

Tivoli

Directory

Integrator

5.2

-

Guide

d’initiation

Page 59: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Cela

permet

de

déplacer

le

connecteur

d’un

cran

au-dessus,

afin

qu’il

soit

exécuté

après

Personnes_entrée,

mais

avant

SortieXML.

Sélectionnez

à

présent

l’onglet

Configurer...

pour

configurer

ce

connecteur.

Entrez

le

chemin

d’accès

du

fichier

de

données.

Vous

devez

choisir

un

nom

différent

de

celui

mentionné

ci-dessus,

selon

l’emplacement

d’installation

d’IBM

Tivoli

Directory

Integrator

(vous

remarquerez

que

le

fichier

de

base

de

données

est

lui-même

nommé

Débiteurs.dat).

Dans

la

zone

Nom

d’attribut

clé,

indiquez

le

nom

de

l’attribut

qui

identifie

de

manière

unique

ces

enregistrements.

Dans

la

base

de

données

tutorial,

il

s’agit

de

l’attribut

Nom_complet

(voilà

pourquoi

vous

avez

créé

un

attribut

comportant

un

nom

similaire

dans

le

connecteur

d’entrée).

Pour

tester

ce

connecteur,

sélectionnez

l’onglet

Schéma

puis

les

boutons

Connecter

et

Suivant

comme

vous

l’avez

fait

pour

Personnes_entrée.

Vous

pouvez

également

accéder

directement

à

l’onglet

Mappe

d’entrée

et

utiliser

le

bouton

Reconnaissance

rapide.

Chapitre

3.

Présentation

d’IBM

Tivoli

Directory

Integrator

47

Page 60: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Ce

bouton

commande

au

connecteur

de

se

connecter

à

sa

source,

d’effectuer

une

opération

GetNext

sur

l’ensemble

de

données

et

d’examiner

l’entrée

renvoyée.

Les

attributs

trouvés

s’affichent

dans

la

fenêtre

Attributs

de

connecteur

disponibles,

prêts

à

être

mappés.

Maintenant,

même

si

cela

ne

permet

pas

de

découvrir

tous

les

attributs

définis

dans

le

schéma

de

la

source

de

données

(utilisez

pour

cela

le

bouton

Déterminer

le

schéma

de

la

source

de

données

de

l’onglet

Schéma),

cela

suffit

pour

continuer

le

travail.

Vous

devez

à

présent

définir

la

mappe

d’attributs

afin

que

les

informations

soient

disponibles

sur

la

ligne

d’assemblage.

Cliquez

sur

l’onglet

en

regard

du

schéma

pour

accéder

à

la

sous-fenêtre

Mappe

d’entrée,

puis

glissez

Montant

et

DateDuPrêt

de

la

liste

des

attributs

de

connecteurs

disponibles

vers

la

case

Attribut

work.

Remarque

:

Comme

vous

le

constaterez

dans

la

section

suivante,

la

zone

Nom_complet

de

la

source

de

données

vous

permet

de

configurer

les

critères

de

recherche.

Cependant,

il

est

inutile

d’ajouter

un

attribut

dans

la

mappe

d’attributs

pour

l’utiliser

dans

la

recherche

;

il

suffit

qu’il

soit

disponible

dans

la

source

de

données.

48

IBM

Tivoli

Directory

Integrator

5.2

-

Guide

d’initiation

Page 61: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Configuration

des

critères

de

lien

Configuré

en

mode

Recherche,

le

nouveau

connecteur

Débiteurs

effectue

une

recherche

sur

les

entrées

spécifiques

de

sa

source

de

données

afin

de

trouver

une

occurrence

pour

l’entrée

figurant

dans

la

ligne

d’assemblage.

Vous

définissez

les

détails

de

cette

recherche

d’occurrence

dans

les

Critères

de

lien

du

connecteur.

Vous

avez

probablement

remarqué

l’apparition

du

nouvel

onglet

Critères

de

lien

à

côté

de

l’onglet

Mappe

de

sortie

dès

que

vous

avez

ajouté

le

connecteur

Débiteurs

(et

vérifié

qu’il

était

bien

en

mode

Recherche).

Si

vous

sélectionnez

cet

onglet,

l’écran

Critères

de

lien

apparaît.

Vous

pouvez

y

définir

la

manière

dont

le

connecteur

effectue

sa

recherche.

Rappelez

la

fonction

IBM

Tivoli

Directory

Integrator

pour

écrire

directement

le

script

d’une

mappe

d’attributs.

Cette

opération

obéit

au

même

principe.

Lorsque

vous

cochez

la

case

Créer

des

critères

à

l’aide

d’un

script

personnalisé

(en

regard

de

la

barre

d’outils

Critères

de

lien),

une

fenêtre

d’édition

s’ouvre,

dans

laquelle

vous

pouvez

définir

l’appel

de

recherche

spécifique

à

la

source

de

données.

Il

peut

s’agir

d’une

instruction

SELECT

SQL

pour

un

connecteur

JDBC

ou

d’un

appel

de

recherche

LDAP

si

vous

êtes

connecté

à

un

annuaire.

Chapitre

3.

Présentation

d’IBM

Tivoli

Directory

Integrator

49

Page 62: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Sachez

toutefois

que,

à

l’instar

du

mappage

d’attributs,

IBM

Tivoli

Directory

Integrator

peut

créer

la

commande

API

pour

la

source

de

données

sous-jacente

et

rendre

la

solution

davantage

indépendante

de

la

technologie.

Cliquez

sur

le

bouton

Ajouter

nouveaux

critères

de

lien

de

la

barre

d’outils

Critères

de

lien,

en-dessous

de

l’onglet

Configurer...

Lorsque

la

boîte

de

dialogue

Critères

de

lien

apparaît,

vous

devez

choisir

un

attribut

du

schéma

détecté

par

IBM

Tivoli

Directory

Integrator

dans

la

source

de

données.

Sélectionnez

ensuite

une

opération

de

comparaison

(telle

que

égal

ou

contient).

La

dernière

zone

vous

permet

d’indiquer

l’attribut

de

la

ligne

d’assemblage

à

comparer.

Cliquez

sur

OK

lorsque

vous

avez

terminé.

50

IBM

Tivoli

Directory

Integrator

5.2

-

Guide

d’initiation

Page 63: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Remarque

:

Le

symbole

du

dollar

($)

face

à

l’attribut

Nom_complet

de

la

ligne

d’assemblage

permet

à

IBM

Tivoli

Directory

Integrator

d’extraire

la

première

valeur

de

cet

attribut

(qui

peut

comporter

un

nombre

de

valeurs

indéfini)

qu’il

utilisera

pour

la

création

des

critères

de

lien.

Si

vous

souhaitez

récupérer

n’importe

quelle

valeur

d’un

attribut

à

valeurs

multiples,

remplacez

$

par

le

symbole

at

(@).

A

la

fermeture

de

la

boîte

de

dialogue,

vous

retournez

à

l’écran

de

la

ligne

d’assemblage.

Sélectionnez

le

connecteur

SortieXML

pour

mettre

à

jour

sa

mappe

d’attributs

afin

d’inclure

les

nouvelles

données

collectées

dans

la

ligne.

Faites

glisser

les

nouveaux

attributs

Montant

et

DateDuPrêt

depuis

la

case

Entrée

Work

jusqu’à

la

case

Attribut

conn.

Chapitre

3.

Présentation

d’IBM

Tivoli

Directory

Integrator

51

Page 64: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Enregistrez

votre

travail

et

relancez

la

ligne

d’assemblage.

Que

se

passe-t-il

?

La

ligne

d’assemblage

a

planté

!

En

effet,

vous

n’avez

pas

tenu

compte

de

l’éventualité

le

connecteur

de

recherche

de

débiteur

ne

parvient

pas

à

trouver

52

IBM

Tivoli

Directory

Integrator

5.2

-

Guide

d’initiation

Page 65: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

des

entrées

dans

sa

base

de

données

indexées

sur

l’attribut

Nom_complet.

Heureusement,

IBM

Tivoli

Directory

Integrator

a

à

sa

disposition

un

certain

nombre

de

solutions

pour

traiter

ce

problème.

Si

le

cas

se

présente,

vous

devez

programmer

un

crochet

pour

y

remédier.

Vous

devez

décider

de

l’action

à

entreprendre

:

v

Vous

pouvez

choisir

d’ignorer

l’éventuelle

absence

des

entrées

dans

la

base

de

données

Débiteurs.dat.

Dans

ce

cas,

vous

pouvez

en

aviser

le

programme

;

votre

page

de

sortie

contiendra

toutes

les

entrées,

certaines

contenant

les

informations

sur

leurs

dettes

et

d’autres

non.

v

Vous

pouvez

choisir

d’afficher

les

personnes

débitrices

uniquement.

Dans

ce

cas,

vous

devez

demander

au

système

d’ignorer

les

personnes

qui

ne

comportent

aucune

entrée

dans

la

table

(par

exemple,

sans

dettes).

Dans

tous

les

cas

de

figure,

vous

devez

activer

le

crochet

En

cas

de

non

concordance

dans

le

connecteur

Débiteurs.

1.

Allez

dans

ce

connecteur

et

cliquez

sur

l’onglet

Crochets.

2.

Cliquez

sur

le

crochet

En

cas

de

non

concordance

dans

l’arborescence

présentée.

Une

fenêtre

d’éditeur

de

script

s’affiche.

3.

Cochez

la

case

Activé,

enregistrez

votre

travail

et

relancez

la

ligne

d’assemblage.

En

activant

simplement

le

crochet,

vous

commandez

à

IBM

Tivoli

Directory

Integrator

de

ne

rien

faire

si

aucune

donnée

correspondante

n’est

trouvée.

Chapitre

3.

Présentation

d’IBM

Tivoli

Directory

Integrator

53

Page 66: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

La

ligne

d’assemblage

ne

plante

pas

lorsque

vous

la

relancez

et

la

sortie

de

journal

se

présente

de

la

manière

suivante

:

Vous

pouvez

voir

les

messages

et

le

vidage

d’entrée

que

vous

avez

codés

dans

votre

script

de

filtrage

(dans

le

crochet

Après

GetNext

de

Personnes_entrée),

ainsi

que

le

message

indiquant

qu’aucune

erreur

n’a

été

rencontrée

cette

fois.

Remarque

:

L’ordre

dans

lequel

apparaissent

les

attributs

de

chaque

entrée

n’est

pas

important

et

peut

être

différent

de

celui

présenté

dans

les

captures

d’écran

du

présent

document.

Votre

fichier

de

sortie

XML

fait

apparaître

également

deux

modifications

importantes

:

v

Les

deux

nouvelles

zones

Débiteurs

sont

à

présent

visibles

dans

la

page

de

sortie.

v

Le

nombre

d’attributs

par

entrée

XML

a

varié

car

la

ligne

d’assemblage

n’a

pas

trouvé

d’informations

de

créance

pour

tous

les

débiteurs.

Lorsque

le

connecteur

Recherche

(Débiteurs)

ne

trouve

pas

les

informations

correspondantes

dans

la

base

de

données,

il

passe

automatiquement

au

gestionnaire

d’erreurs

de

la

ligne

d’assemblage

qui,

du

fait

de

l’absence

de

code

particulier,

est

alors

renvoyé

du

crochet.

Il

supprime

tout

de

même

la

condition

d’erreur,

ce

qui

permet

au

traitement

de

continuer,

même

s’il

manque

certains

attributs.

Cela

peut

engendrer

des

incidents

au

bas

de

la

ligne,

ce

qui

n’est

pas

le

cas

dans

la

situation

présente.

54

IBM

Tivoli

Directory

Integrator

5.2

-

Guide

d’initiation

Page 67: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Que

se

passe-t-il

si

vous

vous

intéressez

aux

seuls

débiteurs

?

Dans

ce

cas,

vous

devez

ajouter

ce

snippet

de

script

au

crochet

En

cas

de

non

concordance

dans

le

connecteur

Débiteurs

:

system.skipEntry();

Souvenez-vous

du

filtrage

de

l’entrée

Roger

au

cours

de

l’entrée

initiale.

Il

est

possible

que

les

personnes

filtrées

à

l’entrée

soient

débitrices,

mais

la

ligne

d’assemblage

ne

les

associe

jamais

avec

ces

enregistrements.

Pour

pallier

cette

situation,

vous

pouvez

créer

des

valeurs

par

défaut

pour

les

attributs

manquants

du

premier

connecteur.

IBM

Tivoli

Directory

Integrator

offre

de

nombreuses

manières

de

traiter

les

valeurs

manquantes.

Maintenant

que

vous

avez

vu

comment

décrire

les

systèmes

et

les

flots

de

données

qui

constituent

votre

solution

d’intégration,

il

est

temps

de

voir

comment

IBM

Tivoli

Directory

Integrator

vous

permet

de

détecter

et

d’envoyer

des

événements

de

modification

dans

votre

infrastructure.

Chapitre

3.

Présentation

d’IBM

Tivoli

Directory

Integrator

55

Page 68: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Gestionnaires

d’événements

Le

troisième

et

dernier

type

de

composant

dans

IBM

Tivoli

Directory

Integrator

est

le

gestionnaire

d’événements.

Comme

son

nom

l’indique,

ce

composant

vous

permet

de

créer

des

solutions

d’intégration

déclenchées

par

des

événements,

en

temps

réel.

Les

gestionnaires

d’événements

vous

permettent

de

vous

brancher

aux

systèmes

et

services,

puis

d’attendre

une

notification

d’événement.

Citons

par

exemple

l’arrivée

de

courrier

électronique

dans

une

boîte

aux

lettres

POP3/IMAP,

un

fichier

apparaissant

dans

une

URL

FTP

et

des

modifications

apportées

à

un

annuaire.

Vous

pouvez

configurer

des

gestionnaires

d’événements

pour

exécuter

une

grande

variété

d’actions

basées

sur

le

type

d’événement

intercepté

:

v

Le

transfert

d’informations

par

un

ou

plusieurs

interpréteurs

v

Le

lancement

de

lignes

d’assemblage

avec

des

paramètres

d’événements

qui

doivent

exécuter

leur

travail

v

L’appel

de

bibliothèques

ou

de

programmes

externes

En

d’autres

termes,

toutes

les

tâches

qu’ils

doivent

effectuer

pour

l’interprétation

et

la

transmission

des

événements.

A

l’instar

des

autres

composants,

la

plupart

des

gestionnaires

d’événements

fonctionnent

de

la

même

manière.

Cependant,

certains

sont

mis

en

oeuvre

entièrement

au

moyen

d’un

script

(par

exemple,

le

gestionnaire

d’événements

d’unité

d’exécution

générique)

ou

ont

besoin

d’une

interface

spécialisée

pour

la

configuration

(par

exemple,

le

gestionnaire

d’événements

Services

Web).

Dans

un

souci

de

simplicité,

nous

prendrons

le

gestionnaire

de

type

standard

dans

notre

exemple.

Lorsqu’un

gestionnaire

d’événements

intercepte

un

événement,

il

convertit

les

paramètres

d’événement

en

objets

Java

et

les

enregistre

dans

un

objet

de

stockage

local.

Cet

objet

est

semblable

aux

objets

work

et

conn

que

vous

avez

utilisés

dans

la

section

précédente.

Dans

le

cas

des

gestionnaires

d’événements,

cette

benne

Java

est

nommée

événement.

En

plus

de

ces

paramètres

d’événement,

vous

récupérez

parfois

des

attributs

provenant

de

l’événement,

comme

c’est

le

cas

d’un

événement

de

modification

provenant

d’un

annuaire

LDAP.

Pour

éviter

de

mélanger

le

contenu

des

données

et

les

paramètres,

tous

ces

objets

de

stockage

(y

compris

work

et

conn)

gèrent

les

valeurs

des

données

dans

des

attributs

et

les

paramètres

dans

des

propriétés.

Tout

comme

les

attributs,

les

propriétés

sont

des

vecteurs

de

valeurs

de

données,

à

ceci

près

qu’elles

n’ont

qu’une

seule

valeur

et

sont

généralement

des

chaînes.

Lorsque

vous

videz

un

objet

d’entrée

dans

le

journal

(par

exemple,

à

l’aide

de

la

fonction

task.dumpEntry()),

une

section

séparée

apparaît,

indiquant

les

attributs

et

propriétés

dans

la

sortie

du

journal.

Pour

définir

la

réaction

d’un

gestionnaire

d’événements

à

différents

événements,

créez

un

ensemble

de

règles

de

condition-action

basées

sur

les

valeurs

des

propriétés

et

des

attributs

provenant

du

système

connecté.

Les

gestionnaires

d’événements

sont

généralement

utilisés

pour

transmettre

le

contrôle

à

une

ou

plusieurs

lignes

d’assemblage

qui

propagent

les

événements.

Toutefois,

puisque

vous

pouvez

les

écrire

sous

forme

de

scripts

et

qu’ils

offrent

un

grand

nombre

de

fonctionnalités,

ils

peuvent

également

effectuer

automatiquement

un

travail

considérable.

56

IBM

Tivoli

Directory

Integrator

5.2

-

Guide

d’initiation

Page 69: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Pour

un

début,

l’un

des

gestionnaires

d’événements

les

plus

faciles

à

mettre

en

oeuvre

est

le

gestionnaire

d’événements

HTTP.

Utilisez-le

donc

pour

créer

un

serveur

Web

simple.

Vous

devez

créer

deux

nouveaux

fichiers

dans

le

répertoire

examples/Tutorial

:

index.html

et

OtherPage.html.

Pour

connaître

le

contenu

de

ces

fichiers,

voir

Annexe

A,

«index.html

et

OtherPage.html»,

à

la

page

71.

Ouvrez

la

page

index.html

dans

un

navigateur.

Cette

page

est

votre

page

Web

principale.

Elle

contient

des

liens.

Le

lien

du

haut

contient

une

référence

à

une

deuxième

page

Web

(OtherPage.html)

et

celui

du

bas

fait

référence

à

StartAL.

Le

dernier

lien

permet

de

lancer

la

ligne

d’assemblage

que

vous

venez

de

créer.

Chapitre

3.

Présentation

d’IBM

Tivoli

Directory

Integrator

57

Page 70: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

La

première

étape

consiste

à

créer

un

gestionnaire

d’événements

HTTP

et

à

le

configurer

comme

serveur

Web.

Ajoutez

à

présent

le

nouveau

gestionnaire

d’événements

à

votre

configuration

en

utilisant

l’option

de

menu

Objet–>Nouveau

gestionnaire

d’événements,

ou

bien

cliquez

sur

le

dossier

Gestionnaire

d’événements

avec

le

bouton

droit

de

la

souris

et

sélectionnez

Nouveau

gestionnaire

d’événements

...

dans

le

menu

contextuel.

Nommez

ce

nouveau

gestionnaire

d’événements

WebServer.

IBM

Tivoli

Directory

Integrator

affiche

l’écran

de

détails

du

gestionnaire

d’événements.

58

IBM

Tivoli

Directory

Integrator

5.2

-

Guide

d’initiation

Page 71: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

De

la

même

manière

que

l’écran

Détails

de

la

ligne

d’assemblage,

le

gestionnaire

d’événements

offre

lui-même

un

ensemble

d’onglets

:

Crochets

Les

gestionnaires

d’événements

disposent

d’un

ensemble

de

crochets

similaires

à

ceux

d’une

ligne

d’assemblage

:

v

Prologue

v

Epilogue

v

Demande

d’arrêt

Notez

que

les

crochets

Prologue

et

Epilogue

d’un

gestionnaire

d’événements

démarrent

chaque

fois

qu’un

événement

est

détecté.

Mappe

d’actions

La

mappe

d’actions

vous

permet

de

définir

vos

règles

de

condition-action.

Config

Comme

de

nombreux

gestionnaires

d’événements

gèrent

des

notifications

d’événements

provenant

de

systèmes

ou

d’unités,

vous

devez

configurer

des

paramètres

de

connexion.

Commencez

par

sélectionner

l’onglet

Config

pour

configurer

votre

gestionnaire

d’événements

HTTP.

Cet

onglet

vous

permet

de

modifier

le

type

de

gestionnaire

d’événements,

de

sélectionner

le

langage

de

script

à

utiliser

et

de

définir

les

paramètres

de

connexion.

Configurez

le

gestionnaire

d’événements

pour

qu’il

écoute

le

port

88

de

votre

machine

en

entrant

ce

numéro

de

port

dans

le

paramètre

Port

HTTP.

Chapitre

3.

Présentation

d’IBM

Tivoli

Directory

Integrator

59

Page 72: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Sélectionnez

la

case

En-têtes

en

tant

que

propriétés

pour

commander

au

gestionnaire

d’événements

d’enregistrer

toutes

les

valeurs

d’en-tête

TCP

et

HTTP

en

tant

que

propriétés

dans

l’objet

événement.

Passons

à

présent

à

l’onglet

Mappe

d’actions.

Cet

écran

est

divisé

en

trois

sous-fenêtres

:

Mappe

d’actions,

Conditions

et

Eléments

d’action,

chacune

comportant

une

rangée

de

boutons

pour

créer,

supprimer

et

modifier

l’ordre

des

éléments

figurant

dans

la

liste

correspondante.

A

chaque

événement,

le

gestionnaire

d’événements

procède

comme

suit

:

1.

Exécute

le

crochet

Prologue.

2.

Transfère

le

contrôle

au

premier

élément

de

mappe

d’actions

activé

et

évalue

les

conditions.

3.

Si

les

conditions

évaluées

sont

True

(ou

si

aucune

condition

n’est

définie

pour

cet

élément

de

mappe

d’actions),

le

gestionnaire

d’événements

lance

les

actions

qui

figurent

dans

l’onglet

Condition

vraie.

Si

les

conditions

évaluées

sont

False,

le

gestionnaire

d’événements

lance

les

actions

Condition

fausse.

Les

erreurs

sont

traitées

dans

l’onglet

En

cas

d’erreur.

4.

Une

fois

les

actions

terminées,

le

contrôle

passe

au

prochain

élément

de

mappe

d’actions

et

l’étape

3

est

répétée

pour

cet

élément.

Cependant,

si

la

case

Consommer

est

cochée

pour

cet

élément

de

mappe

d’actions,

le

traitement

prend

fin

pour

cet

événement,

même

si

une

seule

action

est

exécutée,

puis

le

contrôle

passe

à

l’étape

suivante

(le

crochet

Epilogue).

5.

Lance

le

crochet

Epilogue.

6.

Le

gestionnaire

d’événements

attend

l’événement

suivant.

60

IBM

Tivoli

Directory

Integrator

5.2

-

Guide

d’initiation

Page 73: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Créez

un

nouvel

élément

de

mappe

d’action

en

appuyant

sur

le

bouton

Ajouter

nouvel

élément

de

mappe

d’actions

et

nommez-le

DumpEventToLog.

Ne

créez

aucune

condition

pour

cet

élément

de

mappe

d’actions.

Ainsi,

le

gestionnaire

d’événements

lance

toujours

les

actions

définies

dans

l’onglet

Condition

vraie.

Sélectionnez

le

nouvel

élément

de

mappe

d’actions

puis

l’onglet

Condition

vraie

et

ajoutez

une

nouvelle

action.

Chapitre

3.

Présentation

d’IBM

Tivoli

Directory

Integrator

61

Page 74: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Comme

vous

pouvez

le

voir

dans

la

boîte

de

dialogue

de

sélection

Action

dans

cette

capture

d’écran,

la

liste

présente

un

choix

d’actions

standard

:

v

Appel

d’un

ou

de

plusieurs

interpréteurs

v

Rédaction

de

votre

propre

script

personnalisé

v

Ajout

et

suppression

de

propriétés

et

d’attributs

d’événement

v

Exécution

d’une

ligne

d’assemblage

v

Arrêt

du

gestionnaire

d’événements

Sélectionnez

l’action

Vider

l’objet

d’événement

et

appuyez

sur

OK.

Vous

êtes

à

présent

prêt

pour

tester

le

gestionnaire

d’événements

en

sélectionnant

le

bouton

Exécuter.

Lorsque

le

gestionnaire

d’événements

a

démarré

sur

le

port

88,

ouvrez

une

fenêtre

du

navigateur

et

entrez

l’URL

suivante

dans

la

zone

d’adresse

:

http://localhost:88

La

fenêtre

du

navigateur

n’affiche

rien

mais

si

vous

ouvrez

de

nouveau

IBM

Tivoli

Directory

Integrator,

vous

constaterez

que

le

gestionnaire

d’événements

a

intercepté

l’événement

et

les

différents

paramètres

d’événement

ont

été

vidés

dans

le

journal,

comme

IBM

Tivoli

Directory

Integrator

en

avait

reçu

l’ordre.

62

IBM

Tivoli

Directory

Integrator

5.2

-

Guide

d’initiation

Page 75: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Le

vidage

du

contenu

de

l’objet

d’événement

est

un

moyen

rapide

d’identifier

visuellement

les

paramètres

renvoyés

par

l’événement,

que

vous

pouvez

utiliser

dans

la

définition

des

conditions.

Pour

ce

faire,

utilisez

la

propriété

http.base

mise

en

évidence

dans

la

capture

d’écran

précédente.

Avant

que

les

modifications

que

vous

allez

apporter

au

gestionnaire

d’événements

ne

prennent

effet,

vous

devez

arrêter

l’instance

en

cours

en

sélectionnant

le

bouton

Arrêter

ou

en

fermant

la

sous-fenêtre

Exécuter.

Revenez

au

gestionnaire

d’événements

pour

créer

un

nouvel

élément

de

mappe

d’actions

que

vous

nommerez

StartAL.

Sélectionnez

ce

nouvel

élément

de

mappe

d’actions

et

cliquez

sur

le

bouton

Ajouter

nouvelle

condition.

Chapitre

3.

Présentation

d’IBM

Tivoli

Directory

Integrator

63

Page 76: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Comme

d’habitude,

IBM

Tivoli

Directory

Integrator

permet

de

traiter

des

situations

complexes

avec

un

script

personnalisé.

Comme

vous

n’avez

pas

besoin

de

cette

flexibilité

dans

le

cas

présent,

sélectionnez

Condition

simple.

Le

système

affiche

à

présent

une

boîte

de

dialogue

Condition.

64

IBM

Tivoli

Directory

Integrator

5.2

-

Guide

d’initiation

Page 77: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Entrez

http.base

dans

la

zone

Nom

de

l’attribut/de

la

propriété

puis

sélectionnez

l’opérateur

contient

dans

la

liste

déroulante.

Dans

la

zone

Valeur,

entrez

le

texte

indiqué

entre

guillemets

″StartAl″.

Vous

commandez

ainsi

au

gestionnaire

d’événements

de

vérifier

que

la

propriété

http.base

contient

le

texte

″StartAL″.

Comme

vous

n’avez

pas

sélectionné

la

case

Sensible

à

la

casse,

la

casse

n’affecte

pas

le

résultat

de

cette

condition.

Maintenant,

il

ne

vous

reste

plus

qu’à

indiquer

au

gestionnaire

d’événements

ce

qu’il

doit

faire

lorsque

votre

condition

est

satisfaite.

Avec

l’élément

de

mappe

d’actions

StartAL

toujours

sélectionné,

ajoutez

une

nouvelle

action

à

l’onglet

de

dossier

Condition

vraie

et

sélectionnez

l’action

Exécuter

la

ligne

d’assemblage.

Chapitre

3.

Présentation

d’IBM

Tivoli

Directory

Integrator

65

Page 78: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Pour

ouvrir

la

boîte

de

dialogue

des

détails

d’une

action,

cliquez

deux

fois

sur

l’action.

Dans

la

liste

déroulante,

sélectionnez

votre

ligne

d’assemblage

CSVversXML,

puis

cochez

la

case

nommée

Attendre

la

fin.

Cette

option

commande

au

gestionnaire

d’événements

de

marquer

une

pause

jusqu’à

ce

que

vous

ayez

terminé

votre

ligne

d’assemblage,

ce

qui

vous

évite

de

la

lancer

plusieurs

fois

en

parallèle

66

IBM

Tivoli

Directory

Integrator

5.2

-

Guide

d’initiation

Page 79: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

accidentellement.

Une

fois

que

vous

avez

entré

les

détails

de

cette

action,

fermez

la

boîte

de

dialogue

à

l’aide

du

bouton

de

sous-fenêtre

Fermer

(voir

la

figure

dans

la

capture

d’écran

précédente).

Relancez

le

gestionnaire

d’événements.

Attendez

qu’il

démarre

avant

d’ouvrir

la

fenêtre

du

navigateur.

Vous

devez

accéder

à

la

même

machine

avec

le

même

numéro

de

port

(http://localhost:88)

mais,

cette

fois,

en

ajoutant

votre

texte

de

condition

(startAL)

à

la

fin

de

l’URL

:

http://localhost:88/startAL

Vous

avez

sans

doute

remarqué

que

votre

navigateur

n’est

pas

réapparu

tout

de

suite.

En

effet,

le

gestionnaire

d’événements

attendait

la

fin

de

l’exécution

de

la

ligne

d’assemblage

après

l’avoir

lancée.

Si

vous

revenez

à

IBM

Tivoli

Directory

Integrator,

vous

constaterez

dans

la

sortie

du

journal

que

le

gestionnaire

d’événements

a

exécuté

la

ligne

d’assemblage

après

avoir

vidé

l’objet

d’événement.

Jusqu’ici,

tout

s’est

bien

déroulé

mais

votre

gestionnaire

d’événements

ne

fonctionne

toujours

pas

comme

un

serveur

Web.

Pour

ajouter

cette

fonctionnalité,

vous

devez

ajouter

du

code

supplémentaire

à

l’onglet

Condition

fausse

de

votre

élément

de

mappe

d’actions

StartAL.

Avec

cet

élément

sélectionné,

ajoutez

l’action

Script

personnalisé

à

l’onglet

Condition

fausse

(cliquez

deux

fois

sur

la

nouvelle

action

pour

ouvrir

l’écran

des

détails).

Vous

pouvez,

si

vous

le

souhaitez,

remonter

la

barre

de

diviseur

entre

Actions

et

Conditions

pour

avoir

plus

de

place

pour

écrire

votre

script.

Chapitre

3.

Présentation

d’IBM

Tivoli

Directory

Integrator

67

Page 80: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Entrez

à

présent

le

script

suivant

dans

la

fenêtre

de

l’éditeur

pour

l’action

suivante

:

//

D’abord,

nous

allons

récupérer

la

propriété

http.base

(renvoyée

sous

//

la

forme

d’un

objet

de

chaîne

Java).

La

deuxième

ligne

au-dessous

//

définit

une

nouvelle

variable

avec

le

chemin

d’accès

complet

de

//

l’emplacement

des

fichiers

Tutorial

HTML

sur

votre

machine.

//

base

=

event.getProperty("http.base");

path

=

"C:/Program

Files/IBM/IBMDirectoryIntegrator/examples/Tutorial/";

//

Vous

pouvez

utiliser

la

fonction

de

chaîne

Java

endsWith()

pour

vérifier

//

l’extension

du

fichier

demandé

par

le

navigateur.

Vous

configurez

ensuite

//

les

propriétés

du

message

HTTP

que

le

gestionnaire

d’événements

renverra

//

au

navigateur.

//

if

(

base.endsWith(".gif")

)

event.setProperty

("http.content-type",

"image/gif")

else

if

(

base.endsWith(".jpg")

||

base.endsWith(".jpeg")

)

event.setProperty

("http.content-type",

"image/jpeg")

else

event.setProperty

("http.content-type",

"text/html");

//

S’il

ne

s’agit

pas

d’une

requête

de

racine

ou

nulle,

ajoutez

le

nom

de

//

notre

page

Web

principale

("index.html").

//

if

(

base

==

"/"

)

base

=

"/"

+

"index.html";

68

IBM

Tivoli

Directory

Integrator

5.2

-

Guide

d’initiation

Page 81: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

//

A

présent,

nous

allons

créer

un

nouvel

objet

de

fichier

Java

portant

le

//

nom

du

fichier

qui

a

été

demandé

et

auquel

a

été

ajoutée

au

début

la

//

variable

de

chemin

créée

précédemment.

var

file

=

new

java.io.File(chemin

+

base);

//

A

ce

niveau,

nous

allons

écrire

le

nom

du

fichier

dans

le

journal.

task.logmsg

("Demande

de

fichier

:

"

+

fichier

);

//

Enfin,

nons

pouvons

utiliser

la

fonction

exists()

pour

voir

si

le

fichier

a

été

//

trouvé.

Si

tel

est

le

cas,

il

est

renvoyé

à

la

propriété

http.body.

Sinon,

nous

//

définissons

l’état

pour

que

le

navigateur

affiche

l’erreur

standard

404.

//

if

(

file.exists()

)

event.setProperty

("http.body",

fichier);

else

event.setProperty

("http.status",

"NON

TROUVE");

Jusqu’alors,

c’est

le

snippet

le

plus

long.

Pourtant,

cela

ne

représente

pas

beaucoup

de

code

si

l’on

considère

que

vous

avez

déjà

créé

un

serveur

Web.

Lancez

de

nouveau

le

gestionnaire

d’événements

et

entrez

http://localhost:88

dans

votre

navigateur.

La

page

Web

déjà

consultée

s’affiche.

En

fait,

le

gestionnaire

d’événements

a

pris

en

charge

deux

événements

:

d’abord,

il

a

renvoyé

la

page

index.html

puis,

lorsque

le

navigateur

a

commencé

à

fournir

la

page

HTML,

il

a

détecté

une

image

GIF

et

a

effectué

une

demande

au

serveur

également.

Si

vous

consultez

la

sortie

du

journal,

vous

verrez

cet

événement

supplémentaire.

Essayez

d’accéder

à

l’autre

page

puis

revenez.

Votre

serveur

Web,

aussi

simple

soit-il,

peut

prendre

en

charge

toutes

les

pages

disponibles.

Si

vous

entrez

l’URL

d’un

fichier

qui

n’existe

pas

(par

exemple,

http://localhost:88/BadPage.html),

le

gestionnaire

d’événements

renvoie

un

message

d’erreur

Fichier

non

trouvé

dans

le

navigateur.

En

bas

de

la

page

principale

se

trouve

le

second

lien

que

vous

avez

vu

précédemment.

Si

vous

immobilisez

le

curseur

dessus,

vous

verrez

qu’il

désigne

l’URL

http://localhost:/StartAL.

Si

vous

cliquez

sur

ce

lien,

la

condition

précédemment

définie

est

remplie

et

la

ligne

d’assemblage

est

lancée.

Félicitations

!

Vous

venez

de

terminer

votre

formation

de

base

avec

IBM

Tivoli

Directory

Integrator.

Vous

pouvez

à

présent

envisager

de

créer

vos

propres

solutions.

Bien

entendu,

il

reste

du

chemin

à

parcourir

et

il

existe

encore

un

grand

Chapitre

3.

Présentation

d’IBM

Tivoli

Directory

Integrator

69

Page 82: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

nombre

de

fonctionnalités

à

découvrir.

Comme

avec

tous

les

outils

de

développement,

le

savoir-faire

vient

avec

l’expérience.

Considérations

finales

IBM

Tivoli

Directory

Integrator

crée

des

flots

de

données

rapidement

et

facilement

certes,

mais

la

qualité

de

la

solution

finale

dépend

de

la

valeur

de

vos

spécifications.

En

supprimant

la

plateforme

et

les

protections

de

technologie

du

fournisseur

qui

réduisent

votre

vision

et

votre

imagination,

IBM

Tivoli

Directory

Integrator

constitue

une

aide

précieuse.

Lorsque

vous

vous

heurtez

à

un

problème

d’intégration

au

niveau

du

flot

de

données,

vous

réduisez

la

complexité.

Cela

permet

d’augmenter

la

capacité

de

votre

carte

mère,

en

termes

de

vitesse

de

déploiement,

de

précision

de

la

solution,

de

résistance,

de

maintenabilité,

etc.

En

réalité,

lorsque

vous

adoptez

le

principe

simplifier

et

résoudre,

vous

considérez

votre

installation

et

ses

possibilités

d’intégration

dans

une

toute

autre

perspective.

La

spécificité

d’IBM

Tivoli

Directory

Integrator

va

bien

plus

loin

que

l’exécution

et

le

déploiement

de

votre

solution.

A

mesure

que

vos

exigences

commerciales

et

technologiques

évoluent,

IBM

Tivoli

Directory

Integrator

vous

permet

d’améliorer

et

d’élargir

votre

solution

afin

de

répondre

aux

nouvelles

demandes.

Voilà

le

secret

d’IBM

Tivoli

Directory

Integrator

:

l’implémentation

incrémentale.

Vous

pouvez

développer

votre

solution

d’intégration

(et

votre

infrastructure)

pour

l’adapter

à

vos

besoins

et

à

son

environnement.

La

perception

est

la

réalité

et

votre

perception

est

conditionnée

(et

limitée)

par

les

outils

que

vous

utilisez.

Le

choix

est

simple.

Vous

pouvez

continuer

d’accepter

la

réalité

telle

que

vous

la

percevez

en

réduisant

la

vision

de

votre

infrastructure

d’intégration

pour

l’adapter

aux

outils

que

vous

utilisez

ou

changer

d’outils.

70

IBM

Tivoli

Directory

Integrator

5.2

-

Guide

d’initiation

Page 83: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Annexe

A.

index.html

et

OtherPage.html

Commencez

par

créer

deux

nouveaux

fichiers

pour

mettre

en

oeuvre

les

exemples

figurant

dans

ce

manuel

:

index.html

et

OtherPage.html.

Créez

ces

fichiers

dans

le

répertoire

examples/Tutorial.

index.html

Vous

trouverez

ci-dessous

le

contenu

du

fichier

index.html.

Déplacez

par

copie

et

collage

ce

code

dans

un

éditeur

ordinaire,

par

exemple,

le

Bloc-notes

(Notepad)

et

enregistrez

le

fichier

sous

le

nom

index.html

:

<html>

<head>

<title>IBM

Tivoli

Directory

Integrator</title>

</head>

<body>

<h1>Cet

exemple

de

site

Web

est

motorisé

par

<br>IBM

Tivoli

Directory

Integrator</h1>

<br>

<br>

<br>

<br>

Cliquez

sur

<a

href="OtherPage.html">ici</a>

pour

accéder

à

l’autre

page.

<br>

<br>

<br>

<br>

Cliquez

sur

<a

href="StartAL">ici</a>

pour

exécuter

notre

ligne

d’assemblage

<i>Tutorial1</i>.

</body>

</html>

OtherPage.html

Vous

trouverez

ci-dessous

le

contenu

du

fichier

OtherPage.html.

Déplacez

par

copie

et

collage

ce

code

dans

un

éditeur

ordinaire,

par

exemple,

le

Bloc-notes

(Notepad)

et

enregistrez

le

fichier

sous

le

nom

OtherPage.html:

<html>

<head>

<title>IBM

Tivoli

Directory

Integrator

-

Page

2</title>

</head>

<body>

<h1>...et

voici

l’autre

page.</h1>

</div>

<br>

<br>

<br>

<br>

<br>

<br>

Cliquez

sur

<a

href="index.html">ici</a>

pour

revenir

à

la

page

principale.

</body>

</html>

©

Copyright

IBM

Corp.

2002,

2003

71

Page 84: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

72

IBM

Tivoli

Directory

Integrator

5.2

-

Guide

d’initiation

Page 85: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

Annexe

B.

Remarques

Le

présent

document

peut

contenir

des

informations

ou

des

références

concernant

certains

produits,

logiciels

ou

services

IBM

non

annoncés

dans

ce

pays.

Pour

plus

de

détails,

référez-vous

aux

documents

d’annonce

disponibles

dans

votre

pays,

ou

adressez-vous

à

votre

partenaire

commercial

IBM.

Toute

référence

à

un

produit,

logiciel

ou

service

IBM

n’implique

pas

que

seul

ce

produit,

logiciel

ou

service

puisse

être

utilisé.

Tout

autre

élément

fonctionnellement

équivalent

peut

être

utilisé,

s’il

n’enfreint

aucun

droit

d’IBM.

Il

est

de

la

responsabilité

de

l’utilisateur

d’évaluer

et

de

vérifier

lui-même

les

installations

et

applications

réalisées

avec

des

produits,

logiciels

ou

services

non

expressément

référencés

par

IBM.

IBM

peut

détenir

des

brevets

ou

des

demandes

de

brevet

couvrant

les

produits

mentionnés

dans

le

présent

document.

La

remise

de

ce

document

ne

vous

donne

aucun

droit

de

licence

sur

ces

brevets

ou

demandes

de

brevet.

Si

vous

désirez

recevoir

des

informations

concernant

l’acquisition

de

licences,

veuillez

en

faire

la

demande

par

écrit

à

l’adresse

suivante

:

IBM

EMEA

Director

of

Licensing

IBM

Europe

Middle-East

Africa

Tour

Descartes

92066

Paris-La

Défense

Cedex

50

FrancePour

le

Canada,

veuillez

adresser

votre

courrier

à

:IBM

Director

of

Commercial

Relations

IBM

Canada

Ltd

3600

Steeles

Avenue

East

Markham,

Ontario

L3R

9Z7

Canada

Les

informations

sur

les

licences

concernant

les

produits

utilisant

un

jeu

de

caractères

double

octet

peuvent

être

obtenues

par

écrit

à

l’adresse

suivante

:

IBM

World

Trade

Asia

Corporation

Licensing

2-31

Roppongi

3-chome,

Minato-ku

Tokyo

106,

Japon

Le

paragraphe

suivant

ne

s’applique

ni

au

Royaume-Uni,

ni

dans

aucun

pays

dans

lequel

il

serait

contraire

aux

lois

locales

:

LE

PRESENT

DOCUMENT

EST

LIVRE

«EN

L’ETAT».

IBM

DECLINE

TOUTE

RESPONSABILITE,

EXPLICITE

OU

IMPLICITE,

RELATIVE

AUX

INFORMATIONS

QUI

Y

SONT

CONTENUES,

Y

COMPRIS

EN

CE

QUI

CONCERNE

LES

GARANTIES

DE

VALEUR

MARCHANDE

OU

D’ADAPTATION

A

VOS

BESOINS.

Certaines

juridictions

n’autorisent

pas

l’exclusion

des

garanties

implicites,

auquel

cas

l’exclusion

ci-dessus

ne

vous

sera

pas

applicable.

Le

présent

document

peut

contenir

des

inexactitudes

ou

des

coquilles.

Il

est

mis

à

jour

périodiquement.

Chaque

nouvelle

édition

inclut

les

mises

à

jour.

IBM

peut

apporter

sans

préavis

des

améliorations

et/ou

des

modifications

aux

produits

et

logiciels

décrits

dans

ce

document.

Les

références

à

des

sites

Web

non

IBM

sont

fournies

à

titre

d’information

uniquement

et

n’impliquent

en

aucun

cas

une

adhésion

aux

données

qu’ils

©

Copyright

IBM

Corp.

2002,

2003

73

Page 86: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

contiennent.

Les

éléments

figurant

sur

ces

sites

Web

ne

font

pas

partie

des

éléments

du

présent

produit

IBM

et

l’utilisation

de

ces

sites

relève

de

votre

seule

responsabilité.

IBM

pourra

utiliser

ou

diffuser,

de

toute

manière

qu’elle

jugera

appropriée

et

sans

aucune

obligation

de

sa

part,

tout

ou

partie

des

informations

qui

lui

seront

fournies.

Les

licenciés

souhaitant

obtenir

des

informations

permettant

:

(i)

l’échange

des

données

entre

des

logiciels

créés

de

façon

indépendante

et

d’autres

logiciels

(dont

celui-ci),

et

(ii)

l’utilisation

mutuelle

des

données

ainsi

échangées,

doivent

adresser

leur

demande

à

:

IBM

Corporation

Department

MU5A46

11301

Burnet

Road

Austin,

TX

78758

U.S.A.

Ces

informations

peuvent

être

soumises

à

des

conditions

particulières,

prévoyant

notamment

le

paiement

d’une

redevance.

Le

logiciel

sous

licence

décrit

dans

ce

document

et

tous

les

éléments

sous

licence

disponibles

s’y

rapportant

sont

fournis

par

IBM

conformément

aux

dispositions

de

l’ICA,

des

Conditions

internationales

d’utilisation

des

logiciels

IBM

ou

de

tout

autre

accord

équivalent.

Les

données

de

performance

indiquées

dans

ce

document

ont

été

déterminées

dans

un

environnement

contrôlé.

Par

conséquent,

les

résultats

peuvent

varier

de

manière

significative

selon

l’environnement

d’exploitation

utilisé.

Certaines

mesures

évaluées

sur

des

systèmes

en

cours

de

développement

ne

sont

pas

garanties

sur

tous

les

systèmes

disponibles.

En

outre,

elles

peuvent

résulter

d’extrapolations.

Les

résultats

peuvent

donc

varier.

Il

incombe

aux

utilisateurs

de

ce

document

de

vérifier

si

ces

données

sont

applicables

à

leur

environnement

d’exploitation.

Les

informations

concernant

des

produits

non

IBM

ont

été

obtenues

auprès

des

fournisseurs

de

ces

produits,

par

l’intermédiaire

d’annonces

publiques

ou

via

d’autres

sources

disponibles.

IBM

n’a

pas

testé

ces

produits

et

ne

peut

confirmer

l’exactitude

de

leurs

performances

ni

leur

compatibilité.

Elle

ne

peut

recevoir

aucune

réclamation

concernant

des

produits

non

IBM.

Toute

question

concernant

les

performances

de

produits

non

IBM

doit

être

adressée

aux

fournisseurs

de

ces

produits.

Le

présent

document

peut

contenir

des

exemples

de

données

et

de

rapports

utilisés

couramment

dans

l’environnement

professionnel.

Ces

exemples

mentionnent

des

noms

fictifs

de

personnes,

de

sociétés,

de

marques

ou

de

produits

à

des

fins

illustratives

ou

explicatives

uniquement.

Toute

ressemblance

avec

des

noms

de

personnes,

de

sociétés

ou

des

données

réelles

serait

purement

fortuite.

LICENCE

SUR

LES

DROITS

D’AUTEUR

:

Le

présent

logiciel

contient

des

exemples

de

programmes

d’application

en

langage

source

destinés

à

illustrer

les

techniques

de

programmation

sur

différentes

plateformes

d’exploitation.

Vous

avez

le

droit

de

copier,

de

modifier

et

de

distribuer

ces

exemples

de

programmes

sous

quelque

forme

que

ce

soit

et

sans

paiement

d’aucune

redevance

à

IBM,

à

des

fins

de

développement,

d’utilisation,

de

vente

ou

de

distribution

de

programmes

d’application

conformes

aux

interfaces

de

74

IBM

Tivoli

Directory

Integrator

5.2

-

Guide

d’initiation

Page 87: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

programmation

des

plateformes

pour

lesquels

ils

ont

été

écrits

ou

aux

interfaces

de

programmation

IBM.

Ces

exemples

de

programmes

n’ont

pas

été

rigoureusement

testés

dans

toutes

les

conditions.

Par

conséquent,

IBM

ne

peut

garantir

expressément

ou

implicitement

la

fiabilité,

la

maintenabilité

ou

le

fonctionnement

de

ces

programmes.

Vous

avez

le

droit

de

copier,

de

modifier

et

de

distribuer

ces

exemples

de

programmes

sous

quelque

forme

que

ce

soit

et

sans

paiement

d’aucune

redevance

à

IBM,

à

des

fins

de

développement,

d’utilisation,

de

vente

ou

de

distribution

de

programmes

d’application

conformes

aux

interfaces

de

programmation

IBM.

Toute

copie

totale

ou

partielle

de

ces

programmes

exemples

et

des

oeuvres

qui

en

sont

dérivées

doit

comprendre

une

notice

de

copyright,

libellée

comme

suit

:

©

(nom

de

votre

société)

(année).

Des

segments

de

code

sont

dérivés

des

Programmes

exemples

d’IBM

Corp.

©

Copyright

IBM

Corp.

_entrez

l’année

ou

les

années_.

All

rights

reserved.

Si

vous

visualisez

ces

informations

en

ligne,

il

se

peut

que

les

photographies

et

illustrations

en

couleur

n’apparaissent

pas

à

l’écran.

Déclaration

de

composants

fournis

par

un

tiers

Déclaration

Apache

Le

présent

produit

comprend

des

logiciels

développés

par

la

société

The

Apache

Software

Foundation

(http://www.apache.org/).

Les

composants

Apache

comprennent

les

bibliothèques

Xerces,

Xalan,

XML4J

et

Log4J,

fournies

au

format

code

objet.

Ce

code

objet

provient

du

site

Web

Apache

et

n’a

pas

été

modifié.

Licence

Apache

Apache

Software

License,

Version

1.1

Copyright

(c)

1999-2003

The

Apache

Software

Foundation.

All

rights

reserved.

Redistribution

and

use

in

source

and

binary

forms,

with

or

without

modification,

are

permitted

provided

that

the

following

conditions

are

met:

1.

Redistributions

of

source

code

must

retain

the

above

copyright

notice,

this

list

of

conditions

and

the

following

disclaimer.

2.

Redistributions

in

binary

form

must

reproduce

the

above

copyright

notice,

this

list

of

conditions

and

the

following

disclaimer

in

the

documentation

and/or

other

materials

provided

with

the

distribution.

3.

The

end-user

documentation

included

with

the

redistribution,

if

any,

must

include

the

following

acknowledgment:

″This

product

includes

software

developed

by

the

Apache

Software

Foundation

(http://www.apache.org/).″

Alternately,

this

acknowledgment

may

appear

in

the

software

itself,

if

and

wherever

such

third-party

acknowledgments

normally

appear.

4.

The

names

″Xerces″,

″Xalan″,

″log4j″,

″mx4j″

and

″Apache

Software

Foundation″

must

not

be

used

to

endorse

or

promote

products

derived

from

this

software

without

prior

written

permission.

For

written

permission,

please

contact

[email protected].

5.

Products

derived

from

this

software

may

not

be

called

″Apache″,

nor

may

″Apache″

appear

in

their

name,

without

prior

written

permission

of

the

Apache

Software

Foundation.

Annexe

B.

Remarques

75

Page 88: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

THIS

SOFTWARE

IS

PROVIDED

″AS

IS″

AND

ANY

EXPRESSED

OR

IMPLIED

WARRANTIES,

INCLUDING,

BUT

NOT

LIMITED

TO,

THE

IMPLIED

WARRANTIES

OF

MERCHANTABILITY

AND

FITNESS

FOR

A

PARTICULAR

PURPOSE

ARE

DISCLAIMED.

IN

NO

EVENT

SHALL

THE

APACHE

SOFTWARE

FOUNDATION

OR

ITS

CONTRIBUTORS

BE

LIABLE

FOR

ANY

DIRECT,

INDIRECT,

INCIDENTAL,

SPECIAL,

EXEMPLARY,

OR

CONSEQUENTIAL

DAMAGES

(INCLUDING,

BUT

NOT

LIMITED

TO,

PROCUREMENT

OF

SUBSTITUTE

GOODS

OR

SERVICES;

LOSS

OF

USE,

DATA,

OR

PROFITS;

OR

BUSINESS

INTERRUPTION)

HOWEVER

CAUSED

AND

ON

ANY

THEORY

OF

LIABILITY,

WHETHER

IN

CONTRACT,

STRICT

LIABILITY,

OR

TORT

(INCLUDING

NEGLIGENCE

OR

OTHERWISE)

ARISING

IN

ANY

WAY

OUT

OF

THE

USE

OF

THIS

SOFTWARE,

EVEN

IF

ADVISED

OF

THE

POSSIBILITY

OF

SUCH

DAMAGE.

This

software

consists

of

voluntary

contributions

made

by

many

individuals

on

behalf

of

the

Apache

Software

Foundation.

For

more

information

on

the

Apache

Software

Foundation,

please

see

http://www.apache.org

Déclaration

Rhino

IBM

Tivoli

Directory

Integrator

utilise

le

code

objet

Rhino

(JavaScript

pour

Java).

Le

code

source

associé

à

Rhino

est

disponible

à

partir

du

site

http://www.mozilla.org/rhino/download.html

et

est

soumis

aux

dispositions

de

Netscape

Public

License

1.1

(http://www.mozilla.org/MPL/NPL-1.1.html).

Le

code

source

Rhino

trouvé

sur

le

site

Web

Mozilla

n’a

pas

été

modifié

en

générant

le

code

objet

utilisé

pour

IBM

Tivoli

Directory

Integrator.

Marques

Les

termes

qui

suivent

sont

des

marques

d’International

Business

Machines

Corporation

aux

Etats-Unis

et/ou

dans

certains

autres

pays

:

IBM

DB2

Notes

Lotus

Domino

Tivoli

Java,

JavaScript

et

toutes

les

marques

et

logos

incluant

Java

sont

des

marques

de

Sun

Microsystems,

Inc.

aux

Etats-Unis

et/ou

dans

certains

autres

pays.

Microsoft

et

Windows

sont

des

marques

de

Microsoft

Corporation.

UNIX

est

une

marque

enregistrée

de

The

Open

Group

aux

Etats-Unis

et/ou

dans

certains

autres

pays.

D’autres

sociétés

sont

propriétaires

des

autres

marques,

noms

de

produits

ou

logos

qui

pourraient

apparaître

dans

ce

document.

76

IBM

Tivoli

Directory

Integrator

5.2

-

Guide

d’initiation

Page 89: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation
Page 90: IBM Tivoli Directory Integrator 5.2 - Guide d'initiation

���

SC11-2083-00