Novell Confidential Manual (FRA) 28 October 2003
Publication des données dans eDirectory
Le système SAP HR, en tant que source experte de données de ressources humaines, peut propager toutes les données des événements d’objet d’ajout, de suppression et de modification vers eDirectory. Le composant utilisé pour la propagation est le canal Éditeur.
Pour faire circuler les données depuis le système SAP HR, le pilote utilise la technologie ALE de
SAP pour publier les enregistrements des données de base du personnel, puis capture les modifications incrémentielles à l’aide de pointeurs de modification. Les fichiers IDoc de message
HRMD_A sont transportés par l’intermédiaire d’un port de fichier qui les stocke sur le système hôte SAP. Le pilote traite l’analyse et le filtrage du fichier IDoc, et assure la sécurité du transport des données vers eDirectory. Seuls les éléments de données spécialement sélectionnés par l’administrateur système sont transportés du système hôte à eDirectory.
Lecture de fichiers IDoc par le pilote
Le pilote lit uniquement les fichiers IDoc de sortie portant le numéro de client qui lui est réservé.
La confidentialité des autres fichiers IDoc pouvant être générés par une autre configuration de pilote est ainsi assurée. Seuls les attributs IDoc qui ont été définis dans le filtre Éditeur du pilote sont publiés dans eDirectory via le canal Éditeur.
Le format d’un fichier IDoc correctement publié via le canal Éditeur est le suivant :
<(I)nput or (O)utput>_<client number>_<consecutive IDoc number> (<(E)ntrée ou
(S)ortie>_<numéro de client>_<numéro de fichier IDoc consécutifs>)
Exemple :
O_300_0000000000001001.
Une fois que les attributs indiqués ont été publiés, le nom du fichier IDoc est modifié pour refléter l’état des processus de publication. Le pilote met en cache l’état de chaque événement et associe le statut aux informations relatives à l’objet dans le fichier IDoc. Si plusieurs objets sont traités depuis le fichier IDoc, il se peut que plusieurs fichiers de sortie soient créés avec différentes extensions.
Le tableau suivant liste les différents états des fichiers IDoc et les suffixes correspondants :
État IDoc
En cours de traitement mais non publié
Traité et publié
Traité avec une erreur ou un avertissement
Traité avec des données altérées ou incorrectes
Traité à la date affichée
Suffixe du nom de fichier
.proc
.done
.fail ou .warn
.bad
tampon horaire à 8 chiffres.futr
Il convient de déterminer l’opération requise, le cas échéant, une fois le fichier IDoc publié.
Remarque : traitement.
la suppression de l’extension du nom de fichier rend le fichier IDoc disponible pour un nouveau
14
Guide d’implémentation du pilote DirXML pour SAP HR
Novell Confidential Manual (FRA) 28 October 2003
Si une règle génère plusieurs événements à partir d’un seul objet, le pire état est mis en cache pour l’objet IDoc. Par exemple, si un IDoc contient des données pour l’objet Personne 00001234, et si ces données génèrent des événements pour l’Utilisateur eDirectory, son Métier et son Poste, trois
éléments <status> séparés sont renvoyés. Si deux de ces événements ont l’état Success (Réussi) et si le troisième a l’état Warning (Avertissement), c’est ce dernier qui est utilisé.
Une fois que tous les objets du fichier IDoc ont été traités, le pilote créé des fichiers de sortie basés sur l’état des événements. Si le fichier IDoc contient des événements dont l’état est Warning
(Avertissement), un fichier IDoc est généré qui contient tous les objets ayant cet état. Le nom est une concaténation du nom original du fichier IDoc et de l’extension « W.warn » (par exemple,
O_001_0002 devient O_001_0002W.warn). De la même manière, si le fichier original IDoc contient une erreur ou des événements dont l’état est Fatal, un fichier doté de l’extension « F.fail » sera généré contenant ces événements.
Pour traiter à nouveau le fichier IDoc, supprimez l’extension. L’utilisation du caractère X avant l’extension permet d’assurer que les événements du nouveau traitement n’écraseront pas les fichiers d’état des précédentes tentatives de traitement.
Types d’objets IDoc lus par le pilote
Les types d’objets varient selon les systèmes et peuvent inclure des objets tels que Personne,
Métier ou Unité organisationnelle. Le pilote permet à l’administrateur de configurer les types d’objets qui peuvent être traités.
Seuls les types d’objets indiqués dans la configuration et ceux qui figurent dans le filtre de publication sont traités. Le pilote analyse les données pour chaque objet et les transmet au moteur
DirXML en une seule transaction.
Remarque : si la connectivité SAP est indiquée, le pilote tente de remplir les valeurs vides de l’objet Éditeur en lisant les valeurs du serveur SAP. Cela ne se produit que si le moteur DirXML demande plus de données
(via une requête d’interrogation) lorsqu’il essaie de réaliser une opération d’événement d’ajout.
Assignation d’attributs de la base de données SAP HR à eDirectory
L’assignation de schéma permet à DirXML de convertir les éléments de données qui circulent entre la base de données SAP HR et eDirectory. Le schéma SAP HR est fondé sur le type de message SAP HRMD_A. L’assignation de schéma contient tous les attributs des divers infotypes de données dans les types de messages HRMD_A.
Plusieurs des infotypes HRMD_A pourraient être instanciés à plusieurs reprises dans les enregistrements de personnel HR. Les infotypes comme P0006 (Private Address - Adresse privée) et P0105 (Communication) peuvent servir plusieurs fois pour désigner des sous-types uniques.
L’infotype Private Address (Adresse privée) peut comporter, par exemple, les sous-types Home
(Domicile), Work (Travail) ou Temporary (Temporaire). L’infotype Communication peut contenir les sous-types Cell (Cellulaire), Pager (Alphapage), EMail (Adresse électronique), etc.
L’administrateur du système eDirectory peut configurer le pilote pour recevoir tous les sous-types voulus des infotypes P0006 et P0105. Les messages SAP HRMD_A qui sont générés par le système SAP HR sont postés sous forme de fichier texte. L’assignation de schéma contient aussi le décalage de position de fichier et la longueur de chaque attribut dans chaque segment des données d’infotype.
Ces informations sont présentées dans une assignation de schéma. Le format des éléments d’assignation est le suivant :
<Segment Infotype>:<Infotype Attribute>:<Infotype Subtype> ou none:
<Segment offset>:<Attribute length>
Présentation du pilote DirXML pour SAP HR
15
