Eléments XML

Fonctionnalités courantes employées pour tous les formats

• Type d'élément

  Les éléments de type 1 (élément de texte) contiennent les données ; les éléments de type 2 et 3 permettent de créer des sous-sections (définition des éléments de début/fin).

• Source données

  Option utilisée lorsque des éléments de texte constituent la source des données indiquant d'où les données doivent être extraites. La source de données la plus employée est la source 1 ('Champ') utilisée pour la recherche de données dans des tables ou des champs virtuels.

  La source des champs de données peut également être utilisée pour personnaliser les champs 'Objet', 'Texte d'e-mail' et 'Nom de fichier' dans 'Sélection support de sortie. Ouvrir' (MNS205) et 'Objet ctl support doc. Connecter support' (CRS949). Les valeurs de champ sont extraites du fichier XML configurable, puis stockées dans des constantes prédéfinies.

  Le tableau qui suit présente les constantes prédéfinies disponibles :

  Constantes	Description
  <CDTT>	Date et heure actuelles
  <STDT>	Date actuelle incluant les informations UTC
  <CSTI>	Heure actuelle incluant les informations UTC
  <USID>	ID utilisateur actuel
  <DIVI>	Société actuelle
  <PRTF>	Programme imprimante actuel
  <PGNM>	Programme de démarrage actuel
  <RLAY>	Format d'état (MNS210/B)
  <RPLY>	Format d'état (CMS025/B)
  <LITX>	Texte d'état dans le programme de démarrage
  <PFDS>	Description de fichier imprimante (CMS005/E)
  <XMLT>	Variante (CMS006/E)
  <XMDS>	Description (CMS004/B)
  <DODV>	Société programme imprimante

• Description

  Sert de description interne dans (CMS009) mais n'est jamais incluse dans le fichier XML.

• Nom d'élément

  Nom d'élément à exploiter dans le fichier XML ; il ne peut être modifié que pour les structures XML au format 3 (Ouvert). Voir ci-dessous pour le standard appliqué aux formats 1 et 2.

• Etiquette

  Les étiquettes sont incluses dans le fichier XML. L'attribut 'Label' (défini dans l'écran F) contient les étiquettes traduites dans la langue adéquate (en fonction de l'utilisateur, client ou fournisseur).

  Remarque

  Pour les sections groupées (spécifiées sur (CMS007/E)), l'attribut 'Etiquette' est déplacé vers le niveau de section de groupement et n'est pas défini par élément dans l'écran F.

  Il existe différentes méthodes pour décider de la manière dont l'étiquette doit être paramétrée :

  • Option 1 – Aucune étiquette n'est incluse.
  • Option 2 – L'ID de message M3 standard est extrait de la table dont provient le champ. La traduction est extraite du fichier message MVXCON.
  • Option 3 – Un ID de message de remplacement M3 et un fichier de message peuvent être spécifiés. Si aucun fichier de message n'est spécifié, MVXCON est utilisé.
  • Option 4 – Un texte de remplacement peut être inclus. La traduction est spécifiée au moyen du bouton Langue. Le texte de remplacement peut contenir de 1 à 15 caractères.

    Une case à cocher 'Recourir au msg standard' est utilisée si aucune langue n'est définie pour le fichier imprimante dans le bouton Langue. Si cette case est cochée, 'ID de message standard' est utilisé en guise d'étiquette dans le fichier XML pour un champ, une section et une variante. Si la case n'est pas cochée, l'étiquette XML d'aucun champ, section ou variante ne sera pas renseignée.

  • Option 5 – Texte de l'étiquette extrait d'un autre champ. Option normalement employée si l'étiquette est définie de manière dynamique par la fonction de sortie (par exemple, segment comptable 1-7).
• Format de colonne

  Utilisé pour définir le format de cellule dans la sortie Excel (CSV).

  Vous pouvez définir le format des colonnes à l'aide des options suivantes :

  • Option 0 - Aucun, le format de cellule sera toujours défini sur 'Général'.
  • Option 1 - Selon la valeur de champ, le format de cellule sera défini sur 'Texte' si le type de données du champ est 'Chaîne' (voir (CMS009/E)). Sinon, le format de cellule sera défini sur 'Général'.
  • Option 2 - Texte, le format de cellule sera toujours défini sur 'Texte'.

  Même si plusieurs lignes sont activées dans 'Structure XML. Ouvrir' (CMS006/E), c'est toujours la première ligne qui détermine le format de cellule de la colonne entière.

  Remarque

  Cette fonctionnalité ne fonctionne que si un modèle Excel est utilisé. Il est donc nécessaire de spécifier un nom de feuille dans le programme 'Structure XML. Ouvrir' (CMS006/E) pour un seul fichier CSV et le programme 'Structure XML. Ouvrir section' (CMS007/E) pour plusieurs fichiers CSV.

• Code débit/crédit

  Indique si des informations liées aux codes de débit/crédit sont à inclure dans le fichier XML et à afficher uniquement pour les champs qui disposent d'un code égal à A01-'Devise' dans 'Groupe champs. Afficher champs autorisés' (CRS109/E).

  Si le champ Code débit/crédit est sélectionné en tant qu'attribut, la mention 'D-C' est incluse dans le fichier XML. Si la table M3 BE utilise un champ distinct pour le code D/C ; sinon, le code D/C est défini en fonction du montant et du paramètre dans Paramètres – Comptabilité générale (CRS750/E). Au préalable, pour que l'attribut soit inclus dans le fichier XML, la fonction de code débit/crédit doit être activée pour la société dans (CRS750/E).

• Masquer valeur zéro

  Option affichée uniquement pour les champs affichant le type de données 5 (Décimal).

  Les champs numériques qui sont nuls peuvent être inclus dans le fichier XML avec une valeur 0,00 ou rester vides. Si le champ 'Masquer valeur zéro' est sélectionné, la valeur zéro est incluse vierge. Sinon, 0,00 est utilisé.

• Attributs (écran F)

  L'écran F sert à définir les attributs des éléments. Vous pouvez défini jusqu'à sept attributs pour chaque élément.

  Les attributs 1 et 2 sont réservés et ne peuvent être modifiés.

  • Attribut 1 : Contient la valeur de l'étiquette (voir ci-dessus pour plus de détails).
  • Attribut 2 : Contient la valeur du code débit/crédit (voir ci-dessus pour plus de détails).

Format 1 – Document standard M3

Numéro de séquence d'élément

Utilisé comme séquence de l'élément dans une section du fichier XML. Le numéro de séquence est divisé en groupes :

Nom d'élément

Si la source de données est définie sur 1-'Champ', l'élément est défini avec ces règles :

• Pour les champs de base de données, il est défini comme étant égal au nom du champ de base de données de position 6, par exemple OAORNO ou MMITNO.
• Pour les champs virtuels, & est remplacé par VF, par exemple, VFCUCD ou VFACAM
• Pour les autres sources de données, le nom de l'élément est défini sur ZZxxxx, où xxxx est le suffixe prédéfini par source de données.

Exemple XML

Exemple XML avec trois éléments

<UIIVNO Label="N° facture">201401561</UIIVNO>

<VFORNO Label="N° CDV">1000025077</VFORNO>

<OAWHLO Label="Dépôt">110</OAWHLO>

Format 2 – Document standard M3

Les éléments de format d'état standard M3 sont structurés en lignes et en colonnes. Chaque colonne doit appartenir à une ligne. Dans (CMS009), les éléments de début (Start) et de fin (End) indiquent une ligne et tous les éléments situés entre eux appartiennent à cette ligne.

• Numéro de séquence d'élément

  Option permettant de mettre en séquence un élément dans un fichier XML et de décider à quelle ligne l'élément appartient.

  Une plage de numéros de séquence est réservée pour chaque ligne :

  Numéro de séquence d'élément	Réservé
  0002-0999	Réservé pour ligne 1
  1002-1999	Réservé pour ligne 2
  …	…
  8002-8999	Réservé pour ligne 9

• Ajouter ou supprimer des lignes

  L'ajout de lignes s'effectue par le biais de la touche de fonction F21='Ajouter une ligne qui permet de créer un élément de début/fin (Start/End) pour la ligne libre suivante. La touche de fonction F22-'Supprimer une ligne' est utilisée pour supprimer l'élément de début (Start), l'élément de fin (End), ainsi que tous les éléments Text entre, pour la ligne dotée du numéro le plus élevé.

• Numéro colonne

  Indique le numéro de colonne du champ dans une disposition ou format. Le numéro dans une ligne doit être unique. Le numéro de colonne fait partie du nom de l'élément. Toute modification manuelle du numéro entraîne une mise à jour du nom d'élément.

• Longueur de champ

  Indique l'espace requis pour un champ dans une disposition ou format. La valeur par défaut provient de la longueur de champ dans la table.

• Nom d'élément

  Option définie sur 'Cx' où 'x' désigne le numéro de colonne (voir N° de colonne plus haut).

• Etiquette supplémentaire

  Si un fichier a besoin d'une étiquette supplémentaire, elle est définie en spécifiant un ID de message M3 et un fichier de message. Si aucun fichier de message n'est spécifié, 'MVXCON' est utilisé. L'étiquette supplémentaire est ensuite intégrée au fichier XML convertie dans la langue adéquate (en fonction de l'utilisateur, client ou fournisseur).

• Désactiver un champ au niveau de l'exécution d'une tâche

  Il peut être nécessaire de désactiver des champs spécifiques afin qu'ils ne soient pas inclus dans le fichier XML pendant toute la durée de l'opération. Par exemple, le champ 'Code TVA' doit uniquement être inclus si la TVA est appliquée.

  Ceci est contrôlé à l'aide du paramètre Exécution désactivée. La décision de désactiver un champ est basée sur un champ virtuel provenant du type de section REPORT. Si le champ virtuel est vrai (valeur 1), le champ est considéré comme désactivé.

  Les options du paramètre Exécution désactivée sont les suivantes :

  • 1 = Aucun contrôle de désactivation
  • 2 = Contrôle de désactivation – champ toujours inclus dans le fichier XML mais valeur laissée vide si désactivation
  • 3 = Contrôle de désactivation et suppression – champ est supprimé du fichier XML si désactivation

Format 3 – Ouvert

Pour le format Ouvert, il n'existe aucune fonction supplémentaire ou d'autres restrictions.