Novell Confidential Manual (FRA) 28 October 2003
4
Personnalisation du pilote DirXML pour fichier texte délimité
Le pilote DirXML
®
pour fichier texte délimité inclut un exemple de configuration que vous pouvez utiliser comme point de départ de votre déploiement.
La plupart des déploiements nécessitent que vous modifiez l’exemple de configuration. Par exemple, vous devez personnaliser le pilote si vous souhaitez effectuer une synchronisation des données unidirectionnelle ou si les attributs que vous synchronisez sont différents des huit fournis dans l’exemple.
Cette section comprend les rubriques de personnalisation suivantes :
« Configuration des paramètres du pilote », page 29
« Configuration de la synchronisation des données », page 37
« Personnalisation du traitement des fichiers à l’aide des interfaces Java », page 38
Remarque : lorsque vous personnalisez la synchronisation des données, vous devez travailler dans le cadre des normes et conventions prises en charge pour les systèmes d’exploitation et les comptes en cours de synchronisation. Les données qui contiennent des caractères valides dans un environnement, mais pas dans un autre, provoquent des erreurs.
Configuration des paramètres du pilote
Lorsque vous modifiez les paramètres du pilote, vous adaptez le comportement de celui-ci à votre environnement réseau. Ainsi, il se peut que l’intervalle d’interrogation par défaut du canal Éditeur soit trop court pour la synchronisation. Le fait de rallonger cet intervalle peut permettre d’améliorer les performances réseau tout en assurant une synchronisation appropriée.
Ces paramètres se répartissent de la manière suivante :
Pilote (reportez-vous à « Configuration du pilote », page 31 ).
Canal Abonné (reportez-vous à « Configuration de l’objet Abonné », page 32
).
Canal Éditeur (reportez-vous à
« Configuration de l’objet Éditeur », page 34 ).
Pour configurer les paramètres du pilote :
1
2
Dans iManager, sélectionnez Gestion DirXML > Présentation.
À l’aide de la fonctionnalité Parcourir ou Rechercher, trouvez l’ensemble pilote DirXML pour fichier texte délimité.
Personnalisation du pilote DirXML pour fichier texte délimité
29
Novell Confidential Manual (FRA) 28 October 2003
La figure suivante illustre l’utilisation de la fonctionnalité Rechercher.
3
Pour avoir un aperçu du pilote, cliquez sur son icône (Texte délimité).
4
Pour accéder à la page de configuration du pilote, cliquez encore une fois sur l’icône du pilote.
30
Guide d’implémentation du pilote DirXML pour fichier texte délimité
Novell Confidential Manual (FRA) 28 October 2003
5
Allez jusqu’à la section Paramètres de pilote, apportez vos modifications, puis cliquez sur OK.
Pour modifier la section Paramètres de pilote, reportez-vous à « Configuration du pilote », page 31 .
Pour modifier la section Configuration de l’objet Abonné, reportez-vous à « Configuration de l’objet Abonné », page 32 .
Pour modifier la section Configuration de l’objet Abonné, reportez-vous à « Configuration de l’objet Éditeur », page 34 .
Configuration du pilote
La figure ci-dessous illustre la configuration du pilote, ainsi que les valeurs par défaut de l’exemple de configuration.
Délimiteur de champ
Délimiteur de champ indique le caractère utilisé pour séparer les valeurs des champs dans les fichiers d’entrée. Vous devez indiquer un caractère.
Si la valeur d’un champ d’entrée contient ce caractère, placez tout le contenu du champ entre guillemets pour empêcher que ce caractère soit considéré comme un séparateur.
Remarque : en cas d’utilisation d’un canal Abonné, si vous remplacez ce séparateur par un caractère autre que la virgule, le séparateur utilisé dans les fichiers de sortie ne change pas automatiquement. Pour changer le séparateur dans les fichiers de sortie, modifiez la feuille de style de transformation de la sortie. Le séparateur est assigné à une variable située au début de la feuille de style.
Nom des champs
Nom des champs est une liste de noms d’attributs séparés par des virgules et qui sont susceptibles d’être mentionnés dans la règle d’assignation de schéma. Dans les fichiers d’entrée, l’ordre et le positionnement des champs des enregistrements doivent correspondre à ceux des noms de cette liste.
Personnalisation du pilote DirXML pour fichier texte délimité
31
Novell Confidential Manual (FRA) 28 October 2003
Par exemple, si vous listez huit noms de champ dans ce paramètre, chaque enregistrement de fichiers d’entrée doit comporter huit champs séparés par le caractère délimiteur. Sous NetWare
® et Windows, consultez par exemple le fichier sample.csv situé dans le répertoire delimitedtext/ samples. Sous Solaris et Linux, le fichier sample.csv se trouve dans le répertoire /usr/lib/dirxml/ rules/delim.
Le tableau suivant liste les valeurs par défaut :
Paramètre
Nom des champs (Champ1, Champ2,
Champ3...)
Exemple de valeur de configuration
LastName,FirstName,Title,Email,WorkPhone,Fax,
WirelessPhone,Description
Nom de classe d’objet
Nom de classe d’objet est le nom de classe Novell
®
eDirectory
TM
à utiliser lors de la création d’objets conformément aux fichiers d’entrée.
Autoriser le pilote à lire ses propres données en sortie
Ce paramètre vous permet d’éviter de créer une situation dans laquelle le pilote écrit des fichiers de sortie qui sont immédiatement lus comme fichiers d’entrée du même pilote.
Par défaut, ce paramètre est égal à Non. Par défaut, le pilote ne se chargera pas si toutes les conditions suivantes sont réunies :
Vous avez à la fois un canal Abonné et un canal Éditeur.
Les répertoires d’entrée et de sortie sont les mêmes.
Les extensions des fichiers d’entrée et de sortie sont les mêmes.
Définissez ce paramètre sur la valeur Yes si vous souhaitez utiliser les données de sortie du canal
Abonné comme données d’entrée de ce même canal dans le but de détecter les événements eDirectory qui déclencheront d’autres modifications dans eDirectory. Par exemple, définissez ce paramètre sur Yes si vous souhaitez que l’attribut Full Name soit mis à jour chaque fois que les attributs Given Name, Surname ou Initials le sont.
Configuration de l’objet Abonné
La figure ci-dessous illustre la configuration du canal Abonné, ainsi que les valeurs par défaut de l’exemple de configuration.
32
Guide d’implémentation du pilote DirXML pour fichier texte délimité
Novell Confidential Manual (FRA) 28 October 2003
Chemin d’accès au fichier de sortie
Chemin d’accès au fichier de sortie indique le répertoire dans lequel les fichiers de sortie sont créés sur le système de fichiers local. Une erreur se produit si ce répertoire n’existe pas.
Plate-forme
Windows
Solaris ou Linux
NetWare
Exemple de valeur de configuration
c:\csvsample\output
/csvsample/output
Indiquez le volume (par exemple, sys:csvsample\output)
Extension du fichier de sortie
Les fichiers de sortie ont un nom unique qui se termine par les caractères indiqués pour le paramètre d’extension du fichier cible. Si les fichiers de sortie d’un canal Abonné sont utilisés comme fichiers d’entrée du canal Éditeur d’un autre pilote DirXML pour fichier texte délimité, l’extension du fichier cible doit correspondre à l’extension du fichier source du deuxième pilote.
Codage des caractères du fichier cible
Lorsque le paramètre Codage des caractères du fichier cible est laissé vide, le codage des caractères Java par défaut défini dans vos paramètres régionaux est utilisé.
Pour utiliser un codage autre que le codage par défaut de vos paramètres régionaux, entrez l’un des noms canoniques listés dans la table des codages pris en charge (http://java.sun.com/j2se/1.4.2/ docs/guide/intl/encoding.doc.html) .
Remarque : les canaux Éditeur et Abonné peuvent utiliser différents codages de caractères.
Nombre maximal de transactions par fichier de sortie
Ce paramètre détermine le nombre maximal de transactions écrites dans un seul fichier de sortie.
Lorsque cette limite est atteinte, le fichier se ferme et un nouveau fichier est créé pour les transactions suivantes. Laissez ce paramètre vide ou affectez-lui la valeur zéro si vous ne souhaitez pas limiter le nombre de transactions qui peuvent être écrites dans un fichier. Pour plus d’informations, reportez-vous au Temps maximal en secondes avant la purge de toutes les transactions.
Temps maximal en secondes avant la purge de toutes les transactions
Si aucune nouvelle transaction n’a été écrite dans le fichier de sortie dans le délai spécifié pour ce paramètre, le fichier se ferme. En cas de nouvelles transactions, un nouveau fichier de sortie est créé. Laissez ce paramètre vide ou affectez-lui la valeur zéro si vous ne souhaitez pas limiter la durée d’attente avant la fermeture du fichier de sortie.
Heure (locale) de la purge de toutes les transactions
Si vous affectez une valeur à ce paramètre, le fichier de sortie courant se ferme chaque jour à l’heure indiquée. Les transactions suivantes seront écrites dans un nouveau fichier. Ce paramètre n’exclut pas l’application des paramètres Nombre maximal de transactions par fichier de sortie ou
Temps maximal en secondes avant la purge de toutes les transactions comme seuils pour le fichier de sortie. Si vous utilisez ce paramètre et que vous ne voulez qu’un fichier par jour, affectez la valeur zéro aux deux autres paramètres. Le format de ce paramètre peut être HH:MM:SS
(sur 24 heures) ou H:MM:SS AM/PM. Vous devez indiquer une heure, mais les minutes et les secondes sont facultatives. Ce paramètre prend comme référence l’heure locale ; il ne tient compte d’aucune autre information sur le fuseau horaire incluse dans la valeur.
Personnalisation du pilote DirXML pour fichier texte délimité
33
Novell Confidential Manual (FRA) 28 October 2003
Remarque : les trois paramètres précédents (Nombre maximal de transaction par fichier de sortie, Temps maximal en secondes avant la purge de toutes les transactions, Heure de la purge de toutes les transactions) peuvent tous être utilisés pour limiter le nombre des transactions ou le temps d’attente avant fermeture du fichier en l’absence d’une nouvelle transaction.
Un fichier de sortie ouvert et dans lequel le pilote pour fichier texte délimité peut encore écrire ne doit pas être considéré comme étant finalisé, ni être ouvert dans le cadre d’un autre processus, tant que le pilote ne l’a pas fermé. C’est la raison pour laquelle l’un des trois paramètres précédents doit être défini pour garantir que les fichiers de sortie ne restent pas ouverts indéfiniment. Pour éviter cette situation, si les trois paramètres sont vides ou ont la valeur zéro, le pilote affecte automatiquement la valeur 1 au paramètre Nombre maximal de transactions par fichier de sortie.
Configuration de l’objet Éditeur
Le tableau ci-dessous liste les paramètres du canal Éditeur, ainsi que leurs valeurs par défaut dans l’exemple de configuration.
Paramètre
Chemin d’accès au fichier source
Extension du fichier source
Codage des caractères du fichier source
(laisser vide par défaut)
Extension du nouveau nom du fichier source
(laisser vide pour supprimer un fichier)
.bak
Fréquence d’interrogation (en secondes) 10
Exemple de valeur de configuration
Sous Windows : c:\csvsample\input
Sous Solaris et Linux : /usr/lib/dirxml/rules/delim
Pour NetWare, vous devez préciser le volume (par exemple, sys:csvsample\input)
.csv
[vide]
Chemin d’accès au fichier source
Le canal Éditeur recherche de nouveaux fichiers d’entrée dans le chemin d’accès au fichier source
(répertoire situé sur le système de fichiers local).
Extension du fichier source
Le canal Éditeur utilise uniquement les fichiers qui ont l’extension indiquée pour ce paramètre.
Une fois les fichiers traités, la valeur définie pour le paramètre Extension du nouveau nom du fichier source est ajoutée au nom du fichier, de sorte que le canal Éditeur ne traite pas deux fois le même fichier. Si le paramètre Extension du nouveau nom du fichier source n’est pas défini, le fichier source sera supprimé après avoir été traité.
Codage des caractères du fichier source
Lorsque le paramètre Codage des caractères du fichier source est laissé vide, le codage des caractères Java par défaut défini dans vos paramètres régionaux est utilisé.
Pour utiliser un codage autre que le codage par défaut de vos paramètres régionaux, entrez l’un des noms canoniques listés dans la table des codages pris en charge (http://java.sun.com/j2se/1.4.2/ docs/guide/intl/encoding.doc.html) .
34
Guide d’implémentation du pilote DirXML pour fichier texte délimité
Novell Confidential Manual (FRA) 28 October 2003
Si le paramètre Extension du fichier source est .xml, le paramètre Codage des caractères du fichier source peut être défini selon deux modes :
Si une valeur est indiquée pour le paramètre Codage des caractères du fichier source, elle est utilisée.
Si le paramètre est laissé vide, et si le document XML indique une déclaration de codage telle qu’elle est décrite dans la Recommandation XML du W3C (http://www.w3.org/TR/RECxml#charencoding) au paragraphe 4.3.3, cette déclaration de codage est prise en charge par l’analyseur XML du moteur DirXML.
L’analyseur XML de DirXML prend en charge les codages de caractères suivants :
UTF-8
UTF-16
ISO-8859-1
US-ASCII
Remarque : les canaux Éditeur et Abonné peuvent utiliser différents codages de caractères.
Extension du nouveau nom du fichier source
Pour plus d’informations sur l’extension du nouveau nom du fichier source, reportez-vous à
Extension du fichier source dans cette section (
« Configuration de l’objet Éditeur », page 34 ).
Important : si vous remplacez la valeur par défaut, veillez à utiliser uniquement des caractères valides dans les noms de fichiers sur votre plate-forme. En cas d’utilisation de caractères non valides, l’opération de réassignation de nom échoue et le pilote traite continuellement le même fichier.
Fréquence d’interrogation
Lorsque le canal Éditeur a terminé le traitement de tous les fichiers source, il attend le nombre de secondes défini pour ce paramètre avant de rechercher d’autres fichiers source à traiter.
Configuration de la synchronisation unidirectionnelle
Si la synchronisation des données est unidirectionnelle, vous devez désactiver le canal inutilisé.
Pour désactiver un canal, supprimez les filtres du canal inutilisé et n’indiquez pas de chemin d’accès au répertoire d’entrée ou de sortie, selon le canal.
Par exemple, si vous n’avez besoin que d’un canal Éditeur :
1
Dans l’éditeur Filtre de iManager, supprimez les filtres de l’objet Abonné.
1a
Par exemple, sélectionnez le filtre Given Name.
Personnalisation du pilote DirXML pour fichier texte délimité
35
Novell Confidential Manual (FRA) 28 October 2003
1b
Sélectionnez Ignorer dans la section S’abonner.
Comme le montre la figure suivante, le canal Abonné du filtre est désactivé.
2
3
Cliquez sur OK pour enregistrer les modifications.
Dans la section Paramètres du pilote, recherchez Configuration de l’objet Abonné et supprimez le chemin indiqué pour le chemin d’accès des fichiers de sortie.
Si vous n’utilisez que le canal Abonné, supprimez les filtres de l’objet Éditeur, ainsi que le chemin spécifié pour le chemin d’accès au fichier source dans la page Paramètres de pilote.
Configuration pour les fichiers XML au format XDS
Vous pouvez, pour ce pilote, utiliser des fichiers XML au format XDS au lieu de fichiers CSV.
Puisque, en règle générale, vous utiliserez ce pilote avec un seul des deux canaux (Éditeur ou
Abonné), ne suivez que la procédure appropriée.
Utilisation du canal Éditeur
Pour que le pilote accepte les données d’entrée au format XML, choisissez l’extension .xml pour le fichier d’entrée.
36
Guide d’implémentation du pilote DirXML pour fichier texte délimité
