Novell Confidential Manual (FRA) 28 October 2003
En utilisant les classes Java que vous écrivez, vous pouvez utiliser les interfaces pour personnaliser les processus de publication et d’abonnement des manières suivantes :
Processus
Publication
Publication
Publication
Interface
InputSorter
InputSource
PreProcessor
Abonnement PostProcessor
Description
Définit l’ordre de traitement de plusieurs fichiers d’entrée.
Le système sur lequel votre pilote est installé détermine l’ordre de traitement par défaut. Par exemple, sous NT, les fichiers sont traités dans l’ordre alphabétique. Vous pouvez utiliser InputSorter pour imposer l’ordre de traitement qui répond à vos besoins.
Donne à traiter au pilote des données autres que les fichiers qui se trouvent dans l’emplacement par défaut.
Par exemple, vous pouvez vérifier la présence de fichiers d’entrée sur un serveur FTP, puis les transférer vers le système de fichiers local pour traitement.
Relie directement au pilote les opérations de manipulation requises pour préparer les fichiers d’entrée au processus de traitement.
Avant que cette interface ne soit disponible, le prétraitement des fichiers s’effectuait indépendamment du pilote. Vous pouviez créer une application séparée destinée à gérer un autre répertoire de fichiers d’entrée, à modifier ces fichiers d’une certaine façon et à les copier dans le répertoire d’entrée défini pour le pilote. En créant une classe qui implémente l’interface
PreProcessor, vous pouvez faire ce type de prétraitement plus directement.
Relie directement au pilote les opérations de manipulation des données requise par l’application qui utilise les données de sortie de eDirectory.
Les améliorations apportées au pilote requièrent une programmation Java. Pour plus
d’informations, reportez-vous à « Personnalisation du traitement des fichiers à l’aide des interfaces Java », page 38 .
Pulsation du pilote
Le moteur DirXML accepte les documents de pulsation du pilote pour fichier texte délimité.
Vous pouvez configurer le pilote pour envoyer les documents.
Configuration par défaut du pilote
Cette section donne des informations sur les éléments suivants :
« Flux des données », page 11
« Types de fichiers pris en charge », page 13
Pour plus d’informations sur les notions de base relatives à Identity Manager, reportez-vous au
Nsure Identity Manager Administration Guide (Guide d’administration Nsure Identity Manager)
(http://www.novell.com/documentation/french/dirxml20/index.html) .
10
Guide d’implémentation du pilote DirXML pour fichier texte délimité
Novell Confidential Manual (FRA) 28 October 2003
Flux des données
Canaux Éditeur et Abonné
Le pilote pour fichier texte délimité prend en charge les canaux Éditeur et Abonné :
Le canal Éditeur lit les données des fichiers texte d’entrée enregistrés sur votre système de fichiers local, puis les envoie à l’annuaire eDirectory via le moteur DirXML.
Par défaut, le canal Éditeur réalise les actions suivantes :
1. Vérifie le répertoire d’entrée toutes les 10 secondes.
2. Traite tout fichier doté d’une extension .csv.
3. Modifie en .bak les extensions .csv des fichiers traités.
4. Répète ce processus jusqu’à ce que vous arrêtiez le pilote.
Le canal Abonné recherche les objets eDirectory ajoutés ou modifiés et crée sur votre système de fichiers local des fichiers de sortie qui rendent compte de ces modifications.
Par défaut, le canal Abonné garde chaque fichier de sortie ouvert jusqu’à ce qu’il contienne
200 transactions ou jusqu’à ce qu’un intervalle de 30 secondes se soit écoulé. Dès que l’une de ces deux limites est atteinte, le fichier de sortie, appelé numéro.csv est enregistré et un nouveau fichier de sortie est ouvert.
L’exemple de configuration fourni avec ce pilote inclut les canaux Éditeur et Abonné.
Mais, dans beaucoup de configurations, seul un flux de données unidirectionnel est requis.
Dans ces configurations, seul un canal Éditeur ou un canal Abonné est utilisé. L’autre canal est alors désactivé.
Présentation du pilote DirXML pour fichier texte délimité
11
Novell Confidential Manual (FRA) 28 October 2003
Règles
Les règles permettent de contrôler la synchronisation des données entre le pilote et eDirectory.
Le pilote pour fichier texte délimité est fourni avec un ensemble de règles préconfigurées détaillées dans le tableau suivant. Vous pouvez les personnaliser à l’aide de Novell iManager, comme nous l’expliquons au
Chapitre 4, « Personnalisation du pilote DirXML pour fichier texte délimité », page 29 .
Règle
Assignation de schéma
Transformation de l’entrée
Transformation de la sortie
Création
Concordance
Description
Configurée sur l’objet Pilote.
Assigne les propriétés d’utilisateur eDirectory aux attributs de l’application comme suit :
Surname > LastName
Given Name > FirstName
Title > Title
Internet EMail Address > Email
Telephone Number > WorkPhone
Facsimile Telephone Number > Fax mobile > WirelessPhone
Description > Description
Les attributs d’application correspondent à la séquence de valeurs dans le fichier, ou, s’ils existent, aux attributs associés à des éléments XDS <field> sans nom.
Configurée sur l’objet Pilote.
Si le document d’entrée est un document XML, aucune transformation n’est effectuée. Si le document est un fichier texte délimité, chaque enregistrement est transformé en élément add XDS pour les objets Utilisateur dont les attributs sont définis par l’assignation de schéma.
L’attribut CN de l’utilisateur est obtenu par la concaténation des valeurs de prénom et de nom.
Les associations sont définies sur la base de la valeur de l’attribut de message électronique de l’utilisateur.
Configurée sur l’objet Pilote.
Indique qu’une virgule est utilisée comme séparateur pour les fichiers de sortie et que le format de fichier CSV (Comma Separated Values) est utilisé.
Configurée sur le canal Éditeur.
Indique que, pour qu’un objet Utilisateur puisse être créé dans eDirectory, les attributs Given Name et Internet EMail Address doivent être définis.
Configurée sur le canal Éditeur.
Indique qu’un utilisateur dans eDirectory est identique à celui qui est spécifié dans le fichier d’entrée lorsque la valeur de Internet Email Address est la même aux deux endroits.
Dans le cas d’une correspondance, seuls les attributs modifiés sont mis à jour dans eDirectory.
12
Guide d’implémentation du pilote DirXML pour fichier texte délimité
Novell Confidential Manual (FRA) 28 October 2003
Règle
Placement
Transformation de l’événement
Description
Configurée sur le canal Éditeur.
Indique qu’un nouvel utilisateur est placé dans le conteneur Users\Active et nommé d’après l’attribut CN créé par la règle de transformation de l’entrée.
Vous devez créer un conteneur Users\Active à la racine de votre arborescence avant de démarrer le pilote.
Configurée sur le canal Abonné.
Si eDirectory indique un événement de modification ou de synchronisation, cet événement est transformé en élément instance qui peut servir à créer un enregistrement de sortie complet.
Types de fichiers pris en charge
L’exemple de configuration prend actuellement en charge deux types de fichiers :
Les fichiers CSV
Les fichiers XML au format XDS
Les fichiers CSV
Les fichiers CSV sont des fichiers texte qui contiennent des données divisées en champs et en enregistrements. Les champs sont séparés par une virgule et les enregistrements par un retour chariot.
Si la valeur d’un champ donné doit comporter une virgule ou un retour chariot, l’ensemble du champ doit être inclus entre guillemets.
Dans la mesure où, dans un fichier CSV, la signification de chaque champ est déterminée par sa position, chaque enregistrement doit avoir le même nombre de champs. Les champs peuvent être vides, mais chaque enregistrement doit avoir le même nombre de séparateurs.
Les fichiers XML au format XDS
Le format XDS est le sous-ensemble de formats XML possibles défini par Novell. Il s’agit du format initial des données eDirectory. En modifiant les règles par défaut et en changeant les feuilles de style, le pilote pour fichier texte délimité peut être configuré pour utiliser n’importe quel format XML.
Pour plus d’informations sur le format XDS, reportez-vous à NDS DTD Commands and Events
(Commandes et Événements DTD NDS) (http://developer.novell.com/ndk/doc/dirxml/ index.html?dirxmlbk/data/a5323rs.html) .
Pour plus d’informations sur la configuration du pilote en vue d’utiliser les fichiers XML au format
XDS, reportez-vous à la section
« Configuration pour les fichiers XML au format XDS », page 36
.
Présentation du pilote DirXML pour fichier texte délimité
13
Novell Confidential Manual (FRA) 28 October 2003
14
Guide d’implémentation du pilote DirXML pour fichier texte délimité
Novell Confidential Manual (FRA) 28 October 2003
2
Mise à niveau du pilote pour fichier texte délimité
Vous pouvez mettre à niveau le pilote DirXML
®
pour fichier texte délimité pendant ou après l’installation du moteur.
Pour mettre à niveau le moteur DirXML pour fichier texte délimité après avoir installé le moteur :
1
Exécutez le programme d’installation d’Identity Manager 2 à partir du CD Identity
Manager 2.0 ou de l’image de téléchargement.
Pour Windows* NT*, reportez-vous à « Installation sous Windows », page 18 .
Pour NetWare
®
, reportez-vous à
« Installation sous NetWare », page 19 .
Pour Solaris* ou Linux, reportez-vous à
« Installation sous Linux ou Solaris », page 21 .
2
Sélectionnez le pilote DirXML pour fichier texte délimité
Le nouveau pilote remplace le précédent. La configuration du précédent pilote étant conservée, il n’est pas nécessaire de configurer le nouveau pilote après son installation.
3
Redémarrez le pilote.
Important : l’exemple de fichier de configuration du pilote mis à jour a changé pour cette version d’Identity
Manager. Si votre configuration actuelle répond à vos besoins, vous n’avez pas à importer l’exemple de configuration. Si vous importez le nouvel exemple de configuration, un autre pilote pour fichier texte délimité avec un nouveau nom et un nouveau conteneur eDirectory sont spécifiés dans la règle de placement, ainsi que de nouveaux noms de règles.
Mise à niveau du pilote pour fichier texte délimité
15
Novell Confidential Manual (FRA) 28 October 2003
16
Guide d’implémentation du pilote DirXML pour fichier texte délimité
