Configuration par défaut du pilote
Cette section donne des informations sur les éléments suivants :
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).
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é.
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 Personnalisation du pilote DirXML pour fichier texte délimité .
Assignation de schéma |
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. |
Transformation de l'entrée |
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. |
Transformation de la sortie |
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é. |
Création |
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. |
Concordance |
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. |
Placement |
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. |
Transformation de l'événement |
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 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).
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.