Les publipostages XML apportent une solution paramétrable à des utilisateurs n'utilisant ni Word, ni Crystal report, lors de l'étape 6/8 de l'assistant publipostage.  

Pré-requis

See also Reportez-vous à la documentation de Mise en oeuvre

Gestion de l'écran

En-tête

Le fichier XML peut être généré sur la machine cliente ou le serveur. Pour des fichiers volumineux, il est conseillé de procéder à une génération sur le serveur.

Deux paramétrages standards de publipostages XML sont fournis en standard :

  • MAILBPR : Adapté à l'extraction publipostage de type Tiers
  • MAILCCN : Adapté à l'extraction publipostage de type Interlocuteurs

Le fichier XML est totalement paramétrable en termes de contenu et de tags XML.

Le champ Nom désigne le nom donné au publipostage XML.

Le publipostage XML est soit de type Tiers, soit de type Interlocuteurs Il peut prendre une des deux valeurs du menu local 3021.

Le champ Objet XML prend le nom de la table sur laquelle s'appuie le publipostage XML.

L'Attribut d'ordre facilite la gestion du tri postal. C'est le reflet d'un tri basé sur le pays, l'état, le code postal, la ville...

Le champ Titre générique permet de donner un titre au publipostage XML.

Le champ Extraire la fonction du représentant permet de récupérer le code fonction du représentant renseigné au niveau du paramètre utilisateur AUSCRMA.

Nom (champ NUM)

Ce champ contient l'identifiant unique de chaque paramétrage de publipostage XML.

Il est limité à dix caractères.

Il conditionne également le nom de la balise XML qui sera utilisée en tant que racine du document généré.

Deux valeurs méritent une attention particulière :

MAILBPR : Cette valeur correspond au paramétrage standard proposé par défaut pour les publipostages de type

Tiers.

MAILCCN : Cette valeur correspond au paramétrage standard proposé par défaut pour les publipostages de type

Interlocuteurs.

Si ces deux publipostages sont modifiés, toute régénération du paramétrage standard entrainera une remise en

l'état initial de ces deux paramétrages.
Intitulé long (champ MXLDESAX3)
Intitulé court (champ MXLSHOAX1)
Type (champ TYP)

L'assistant publipostage permet deux type différents de mailings :

Des mailing Tiers.

Des mailing Interlocuteurs.

Une structure de paramétrage particulière est adaptée à chacun de ces deux types.
Objet XML (champ ROT)

Ce champ permet de saisir le nom de la balise XML qui sera utilisé comme noeud Tiers ou Interlocuteur selon le type du publipostage.
Attribut d'ordre (champ SRT)

Ce champ permet de définir le nom de l'attribut d'ordre de chaque enregistrement du publipostage.

Cet ordre disponible à partir d'une unique valeur numérique reflète un tri basé sur les informations suivantes :

Pays, Etat, Code postal, Ville, Destinataire
Titre générique (champ TTR)

Ce champ est utilisé uniquement pour les publipostages de type Tiers.

Il permet de définir le nom de la balise XML qui stockera le titre générique de l'interlocuteur destinataire.

Par exemple : Monsieur le Directeur Commercial.
Extraire la fonction du représentant (champ REPFNCFLG)

Cette option permet d'activer l'extraction de la fonction du représentant en charge du destinataire du mailing.

La fonction sera extraite dans deux balises dénommées :

AUSCRMA : Cette balise contient le code de la fonction du représentant.

AUSCRMACLA : Cette balise contient la fonction du représentant en clair dans la langue courante.

Onglet Paramétrage

On trouve dans cet onglet la combinaison entre la table, le champ standard ainsi que le tag XML.

Le tag XML est entièrement paramétrable. Il est possible de renseigner le nom exact du champ de la table, ou alors de renseigner une dénomination libre.

Exemple : Pour le champ BPAADD de la table BPADDRESS, il est possible de reprendre pour tag XML, l'exact intitulé de la table BPADDRESS - champ BPAADD, ou bien un intitulé libre et personnel. Le paramétrage assure le contrôle des doublons de tags. 

Tableau

Table (champ TAB)
Champ (champ FIE)
Tag XML (champ LBEXML)

Ce champ permet d'indiquer le nom de la balise XML qui contiendra l'information sélectionnée.

Le nom saisi doit respecter les spécifications XML en terme de format de nom des balises.

Un menu contextuel Nom par défaut permet d'activer l'extraction de l'information en utilisant le nom

du champ tel qu'il est défini dans X3.

Un second menu contextuel Extraire tous les champs permet d'un simple clic de générer un paramétrage

réalisant l'extraction de la totalité des champs proposés.

Il est à noter qu'il est interdit de saisir des doublons de balises XML dans un même paramétrage.

Dans le cas où des doublons sont détectés, ces derniers sont repérables de la manière suivante :

** BALISE **.
Action de déroutement STANDARD

Ce menu permet de récupérer pour tag XML le nom par défaut du champ de la table considérée.
Action de déroutement STANDARD

Ce menu permet de récupérer pour tags XML la totalité des noms de champs des tables considérées.

Boutons spécifiques

Copie

Barre de menus

En cas de modification de deux paramétrages XML, leur version standard peut être rétablie à tous moments, via ce menu.

Messages d'erreur

Outre les messages génériques, les messages d'erreur suivants peuvent apparaître lors de la saisie :

Des doublons de tags XML ont été détectés parmi la liste des champs.

Ce message apparaît si le système détecte des doublons de tags XML. Le doublon est alors identifié par des étoiles, tandis que le bouton  va repositionner le tag avec le nom du champ standard.

Tables mises en oeuvre

See also Reportez-vous à la documentation de Mise en oeuvre