Utiliser les fichiers IDoc SAP

Les fichiers IDoc SAP se composent de champs de données regroupés dans des segments. Ces segments sont hiérarchisés entre eux.

ClosedExemple de hiérarchie

Un médecin prescrit un traitement à un patient hospitalisé. Cette ordonnance doit parvenir à la pharmacie de l’hôpital. Dans ce cas, un IDoc peut être envoyé depuis un programme situé près du patient vers un programme de la pharmacie. Supposons que l’IDoc comporte une hiérarchie de quatre niveaux de segments :

Nom du patient : Johnson

Diagnostic : croup

Diagnostic : fracture du tibia

Type de visite : admission

Traitement : codéine

Traitement : paracétamol

Type de visite : contrôle

Traitement : naproxène

Niveau 1 : Comporte des données qui ne changeront pas pendant plusieurs années, comme le nom du patient ou son adresse.

Niveau 2 : Comporte des données qui ne changeront pas pour une pathologie donnée, mais qui seront modifiées d’une pathologie à une autre (par exemple, le nom médecin ayant émis le premier diagnostic ou le diagnostic même). Un même patient peut inclure plusieurs segments de deuxième niveau.

Niveau 3 : Comporte des données susceptibles d’être modifiées d’une visite à l’autre, mais pas pour une même visite à l’hôpital, par exemple le type de visite (admission ou suivi) et le médecin traitant. Un patient peut se rendre plusieurs fois à l’hôpital pour une même pathologie.

Niveau 4 : Comporte des données qui seront modifiées d’une ordonnance à une autre, par exemple le médecin ayant établi l’ordonnance, les médicaments ou leur dosage. Un médecin peut prescrire plusieurs médicaments pour un même patient au cours d’une visite.

ClosedIntégration avec SAP

Les Systèmes, Applications et Produits de traitement de données (SAP) désignent une application de flux de travail conçue pour permettre l’échange d’informations entre une application tierce et des bases de données incompatibles, ainsi que l’automatisation du traitement et de la gestion des commandes, du service clients, de la gestion de la chaîne d’approvisionnement et des systèmes de gestion des inventaires des grandes entreprises. BarTender utilise les IDocs pour déplacer les données des bases de données SAP vers les éléments à imprimer.

Les utilisateurs de SAP peuvent choisir d’imprimer à partir de BarTender ou de SAP. Lors de l’impression d’éléments à l’aide de BarTender, les informations sont envoyées de SAP à BarTender. Les différentes méthodes d’envoi de données par SAP incluent :

À l’impression d’éléments qui utilisent un système SAP, BarTender envoie à SAP un ensemble de commandes de formatage appelé modèle de code d’imprimante. Le modèle est associé aux données et envoyé à l’imprimante. Reportez-vous au livre blanc Méthodes d’intégration SAP pour consulter une comparaison complète des différences entre l’impression des éléments depuis BarTender et depuis le système SAP.

ClosedTravailler avec des fichiers IDoc

IDoc est le nom d’une méthode de regroupement de champs de données en segments régis par des relations hiérarchiques. SAP gère une bibliothèque de types de fichier mais vous pouvez créer des types de fichier IDoc personnalisés pour répondre à vos exigences. Un fichier IDoc est un message contenant des données et envoyé à BarTender depuis un programme connecté à SAP. Vous pouvez ajouter un fichier IDoc à votre document BarTender à l'aide de l'assistant de configuration de base de données et configurer la connexion dans la boîte de dialogue Configuration de base de données. Vous pouvez aussi créer des fichiers IDoc personnalisés dans la boîte de dialogue Définitions des types IDoc et relier des définitions de type à un fichier Parser à l’aide de la boîte de dialogue Configuration des définitions IDoc.

SAP est une marque déposée de SAP Aktiengesellschaft.

ClosedTypes de fichier IDoc et définitions de segment

Un IDoc étant un message, les programmes émetteurs et récepteurs doivent utiliser une convention commune pour localiser chaque information dans un IDoc donné. SAP AG a donc défini plusieurs centaines de types de fichier IDoc ainsi qu’un grand nombre de types de segment.

Le programme émetteur doit élaborer un IDoc de type donné conformément à ces définitions et le programme récepteur, comme celui-ci, doit respecter ces définitions lors de l’analyse du fichier IDoc. Ainsi, l’identification d’un fichier Parser est l’une des étapes de la configuration de BarTender pour permettre l’utilisation des fichiers IDoc.

Les noms des types de fichier IDoc se composent de six lettres et de deux chiffres. SHPMNT01 est un IDoc qui comporte un message concernant la livraison. SAP révise parfois les définitions IDoc ; les deux chiffres situés à la fin du nom permettent d’identifier cette modification.

Les noms de segment peuvent se terminer par un nombre à trois chiffres. Par exemple, E2KNA1M001 est un segment du type IDoc DEBMAS02 (maîtres client).

Les utilisateurs équipés de SAP peuvent créer des types de fichier IDoc et de segments personnalisés.

Les noms de segment définis par SAP AG commencent toujours par un « E », tandis que les noms de segment personnalisés commencent toujours par la lettre « Z ».

ClosedFichiers Parser

Un fichier Parser pour un type d’IDoc comporte les informations nécessaires à BarTender pour analyser les fichiers IDoc, par exemple les segments qui peuvent apparaître dans ce fichier, ceux pouvant être répétés, les champs de données qui apparaissent dans chaque segment, l’ordre des champs ou encore la longueur de chaque champ.

Vous pouvez associer un fichier Parser à un type d’IDoc particulier dans la boîte de dialogue Définition des types IDoc.

ClosedConvertir des données hiérarchiques IDoc en enregistrements de fichier plat

Les données d’un segment enfant étant toujours associées aux données de son segment parent, tout chemin sans embranchement dans l’arborescence d’un IDoc, d’un nœud supérieur à un nœud inférieur, peut être interprété comme un enregistrement semblable à ceux d’une base de données organisée en tables.

ClosedExemple

Prenons la hiérarchie de données suivante dans laquelle, pour des raisons de simplification, chaque segment est constitué d’un seul champ :

Nom du patient : Johnson

 

 

 

 

Diagnostic : croup

 

 

 

Diagnostic : fracture du tibia

 

 

 

 

Type de visite : admission

 

 

 

 

Traitement : codéine

 

 

 

Traitement : paracétamol

 

 

Type de visite : contrôle

 

 

 

 

Traitement : naproxène

Le patient Johnson a été traité à différentes reprises pour un croup et une fracture du tibia. (Les détails de la première infection ne sont pas décrits.) Lors de la première consultation à l’hôpital, le médecin prescrit de la codéine et du paracétamol. À la seconde consultation, le médecin prescrit du naproxène.

Le chemin allant de la fracture du tibia à la prescription de naproxène peut être réduit en un enregistrement de fichier plat comme suit :

Nom du patient

Diagnostic

Visite

Traitement

Johnson

fracture du tibia

contrôle

naproxène

Les deux autres chemins complets peuvent être réduits sous la forme des enregistrements suivants :

Nom du patient

Diagnostic

Visite

Traitement

Johnson

fracture du tibia

admission

codéine

Johnson

fracture du tibia

admission

paracétamol

Lorsque BarTender lit des données IDoc, il réduit les arborescences de données en enregistrements de fichier plat. Dans ces enregistrements, vous pouvez sélectionner les champs dont vous avez besoin pour les objets de votre modèle.

ClosedSegment maître

Vous ne créerez pas nécessairement d’élément à imprimer pour chacun des enregistrements pouvant être produits à partir de la hiérarchie de données d’un fichier IDoc. BarTender peut être configuré au moment de l’impression de manière à sélectionner uniquement les enregistrements définis, mais certains documents créés à partir des données d’un fichier IDoc n’utiliseront pas tous les enregistrements possibles, même dans les cas les plus courants. BarTender utilise le concept de Segment maître pour vous aider à produire uniquement les enregistrements dont vous avez besoin à partir d’un fichier IDoc.

Le Segment maître est le segment contenant les données essentielles pour votre création. BarTender produit un enregistrement unique pour chaque segment du fichier IDoc que vous avez désigné comme Segment maître.

ClosedExemple

Reprenons l’arborescence de données étudiée dans l'exemple initial. Si l’hôpital souhaite créer une étiquette pour chaque traitement prescrit, il définira le Segment maître au niveau 4. Dans ce cas, BarTender produirait trois enregistrements :

Nom du patient

Diagnostic

Visite

Traitement

Johnson

fracture du tibia

admission

codéine

Johnson

fracture du tibia

admission

paracétamol

Johnson

fracture du tibia

contrôle

naproxène

Supposons que l’hôpital conserve des fichiers distincts pour chaque visite de patient et souhaite créer des étiquettes pour ces dossiers. Une seule étiquette est requise pour chaque visite. Le Segment maître est défini au niveau 3 et BarTender produit alors deux enregistrements :

Nom du patient

Diagnostic

Visite

Traitement

Johnson

fracture du tibia

admission

codéine amidol

Johnson

fracture du tibia

contrôle

naproxène

Dans le premier de ces enregistrements, BarTender a inclus au Segment maître le champ Traitement provenant du niveau inférieur et a concaténé toutes les données issues des segments du niveau inférieur. Pour en savoir plus, reportez-vous à la boîte de dialogue Règles en cas de répétition de segments.

Comme BarTender produit un enregistrement pour chaque instance du Segment maître, il peut vous être utile de remplir l'énoncé suivant pour déterminer quel Segment maître utiliser :

Pour la création courante d’éléments à partir de cet IDoc, je souhaiterais un seul élément à imprimer par _____________.

Dans l’exemple précédent, si l’espace vierge est remplacé par « visite », il est probablement judicieux de choisir le niveau 3 comme niveau de Segment maître, mais s’il est remplacé par « traitement prescrit », il est préférable de choisir le niveau 4.

ClosedFichier de définitions IDoc SAP

Le fichier de définitions IDoc SAP comprend la liste des Types d’IDoc actuellement accessibles par BarTender, les fichiers IDoc par défaut, les alias et les fichiers Parser actuellement associés à chacun des types.

Vous pouvez modifier le fichier de définitions IDoc SAP à l’installation de BarTender sur un ordinateur supplémentaire, pour utiliser le même fichier de définitions IDoc SAP que les autres ordinateurs qui exécutent BarTender.

Rubriques connexes