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 :

Pour configurer les paramètres du pilote :

  1. Dans iManager, sélectionnez Gestion DirXML > Présentation.

  2. À l'aide de la fonctionnalité Parcourir ou Rechercher, trouvez l'ensemble pilote DirXML pour fichier texte délimité.

    La figure suivante illustre l'utilisation de la fonctionnalité Rechercher.


    Les options Rechercher et Parcourir permettant de trouver un ensemble de pilotes

  3. Pour avoir un aperçu du pilote, cliquez sur son icône (Texte délimité).


    L[apos ]icône du pilote Texte délimité

  4. Pour accéder à la page de configuration du pilote, cliquez encore une fois sur l'icône du pilote.


    L[apos ]icône du pilote Texte délimité

  5. Allez jusqu'à la section Paramètres de pilote, apportez vos modifications, puis cliquez sur OK.


    La section Paramètres de pilote

    Pour modifier la section Paramètres de pilote, reportez-vous à Configuration du pilote.

    Pour modifier la section Configuration de l'objet Abonné, reportez-vous à Configuration de l'objet Abonné.

    Pour modifier la section Configuration de l'objet Abonné, reportez-vous à Configuration de l'objet Éditeur.


Configuration du pilote

La figure ci-dessous illustre la configuration du pilote, ainsi que les valeurs par défaut de l'exemple de configuration.


Les boîtes de modification de Configuration du pilote


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.

NOTE:  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.

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 Exemple de valeur de configuration

Nom des champs (Champ1, Champ2, Champ3...)

LastName,FirstName,Title,Email,WorkPhone,Fax,
WirelessPhone,Description

Nom de classe d'objet

Nom de classe d'objet est le nom de classe Novell® eDirectoryTM à 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 :

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.


Les boîtes de modification de Configuration de l[apos ]objet Abonné


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 Exemple de valeur de configuration

Windows

c:\csvsample\output

Solaris ou Linux

/csvsample/output

NetWare

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.

NOTE:  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.

NOTE:  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 Exemple de valeur de configuration

Chemin d'accès au fichier source

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)

Extension du fichier source

.csv

Codage des caractères du fichier source (laisser vide par défaut)

[vide]

Extension du nouveau nom du fichier source (laisser vide pour supprimer un fichier)

.bak

Fréquence d'interrogation (en secondes)

10

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.

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 :

NOTE:  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).

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é.

    1. Par exemple, sélectionnez le filtre Given Name.


      L[apos ]éditeur Filtre

    2. Sélectionnez Ignorer dans la section S'abonner.


      L[apos ]option Ignorer de la section Abonné.

      Comme le montre la figure suivante, le canal Abonné du filtre est désactivé.


      Un canal Abonné désactivé

  2. Cliquez sur OK pour enregistrer les modifications.

  3. 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.


    Aucune valeur dans Chemin d[apos ]accès au fichier 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.


Utilisation du canal Abonné

Pour que le pilote génère des données de sortie au format XDS, supprimez du canal Abonné les feuilles de style de transformation d'événement et de transformation de sortie.

  1. Dans iManager, sélectionnez Administration eDirectory > Supprimer l'objet.

  2. Recherchez puis sélectionnez l'objet SubscriberEventTransformSS du pilote.

  3. Cliquez sur OK.

  4. Cliquez sur Répéter la tâche.

  5. Recherchez puis sélectionnez l'objet OutputTransformSS du pilote.

  6. Cliquez deux fois sur OK.