Ajouter des blocs de texte personnalisés

Ce document définit les blocs de texte personnalisés.

Les blocs de texte personnalisés sont utilisés en tant qu’informations supplémentaires pour un fichier imprimante pouvant être associé dans une structure XML. La connexion peut être faite dans 'Structure XML. Ouvrir section' (CMS007) avec l'option 24 (Ajouter un bloc de texte personnalisé). Avant d’utiliser le bloc de texte personnalisé, les programmes suivants doivent être configurés :
Remarque

L'ajout de nouvelles sections peut avoir un impact considérable sur les performances de la fonction de sortie. De plus, cette fonction s’applique uniquement au type de fichier imprimante de type 1 (Document).

A. 'Groupe de clés texte XML. Ouvrir' (CMS034)

Ce programme définit les groupes clés. Les groupes de clés sont des enregistrements uniques dont la longueur est de 36 caractères. Chaque groupe de clés peut contenir quatre champs clés. Les champs du programme 'Champs de table. Ouvrir' (MNS121) peuvent être utilisés en tant que champs clés. Ces champs clés sont utilisés dans (CMS038).
Remarque

Vous ne pouvez pas utiliser le champ CONO comme champ clé.

Suivez ces étapes pour créer un groupe de clés :
  1. Démarrez (CMS034).
  2. Spécifiez le nom du groupe de clés. Utilisez l'option 1 (Créer).
  3. Dans le panneau E, indiquez la description. Il peut également être défini par langue en cliquant sur le bouton Langue.
  4. Précisez jusqu'à quatre champs clés. Ces champs clés indiquent un champ issu d’une table M3.
  5. Appuyez sur Entrée.

B. 'Texte personnalisé XML. Ouvrir' (CMS036).

Ce programme définit les identités de texte qui contiennent le bloc de texte affiché dans la structure XML. Les identités de texte peuvent être associées aux éléments suivants :
  • Identité de texte et langue
  • Identité de texte

    Champ de société unique utilisé (SNDI) pour (CMS036) activé.

Champs à prendre en compte dans (CMS036/B) :
  • Identité de texte : indique l’ID de texte. L’ID de texte est affecté à plusieurs dates et langues de début.
  • Date de début : indique la date à laquelle l’ID de texte peut être utilisé.
  • Langue : indique la langue utilisée pour la correspondance dans le champ 'Langue document XML'. La langue est la priorité à prendre en compte lors de la mise en correspondance d’un enregistrement d’identité de texte dans la structure XML.
Remarque

Les deux combinaisons sont indépendamment de la date de début. Lorsqu’une combinaison d’identités de texte ne contient pas de date de début valide ou est déjà postérieure à la date de fin, le bloc de texte n’est pas généré.

Champs à prendre en compte dans (CMS036/E) :
  • Description : décrit l’identité de texte et peut être traduit dans différentes langues via le bouton Langue.
  • Date fin valid : ce champ indique la dernière date de validité de l'enregistrement.
  • Type de texte : indique le type de texte dans la structure XML.
  • Ce champ indique le sous-type du texte. 1 (texte début) ou 2 (Texte fin).
  • Etiquette : indique l’étiquette du bloc de texte. Les étiquettes peuvent être classées comme (1) ID de message (2) Texte. Le texte d'étiquette peut être traduit en différentes langues via le bouton Langue.
  • Texte : un navigateur de texte dans lequel l’utilisateur doit fournir des informations. S’il n’est pas renseigné, le bloc de texte de la structure XML ne s’affiche pas même si des critères sont respectés.

Suivez ces étapes pour créer un ID de texte :

  1. Démarrez le programme 'Texte personnalisé XML. Ouvrir' (CMS036).
  2. Dans le champ 'ID texte', saisissez l'ID de texte qu'il est possible d'attribuer à plusieurs dates de début afin de déterminer sa validité. Il est associé à un groupe de clés dans (CMS038).
  3. Dans le champ 'Date de début', précisez la date à partir de laquelle le texte est valide.
  4. Dans le champ 'Langue', indiquez la langue dans laquelle les documents externes sont à imprimer.
  5. Utilisez l'option 1 (Créer).
  6. Dans le panneau E, saisissez la description qui peut également être définie par langue en cliquant sur le bouton Langue.
  7. Dans le champ 'Date de fin', indiquez la dernière date de validité de l'enregistrement.
  8. Dans le champ 'Type de texte', spécifiez le type de texte à inclure dans le fichier XML.
  9. Dans le champ 'Emplacement texte', indiquez le sous-type du texte.

    Options de positionnement du texte :

    • 1='Avant' ; le texte est un texte de sous-type 'Texte avant'.
    • 2='Après' ; le texte est un texte de sous-type 'Texte après'.
  10. Précisez l'étiquette en spécifiant un ID de message ou un texte. Si vous spécifiez un ID de message, l'étiquette apparait automatiquement à la suite de la langue M3 de l'utilisateur final. Si vous spécifiez un texte, il peut également être défini par langue en appuyant sur le bouton Langue.
  11. Appuyez sur Entrée.
  12. Dans la fenêtre Texte M3, saisissez le texte. Ce texte indique le bloc de texte qui est affiché dans le fichier XML. Les champs 'Bloc de texte' et 'Langue' doivent être vides. Dans le cas contraire, une erreur se produit.
  13. Appuyez sur Entrée.
    Remarque

    Vous pouvez créer plusieurs ID de texte portant le même nom, uniquement si les dates de début sont différentes les unes des autres. Vous pouvez créer plusieurs ID de texte avec le même nom et la même date de début, uniquement si les langues sont différentes. Le bloc de texte personnalisé à utiliser est celui qui correspond au déclencheur de langue.

C. Texte XML personnalisé. Ouvrir champ clé (CMS038)

Ce programme définit l’ID de texte et la valeur du champ clé associé au groupe clé. Les valeurs de champ clé sont codées en dur. S’il existe des valeurs affectées aux champs clés dans (CMS038), le groupe de clés correspondant dans (CMS034) ne peut pas être modifié ou supprimé.
Remarque

Vous pouvez laisser les valeurs de champ clé et l’identité de texte vides même si cela n’est pas considéré comme une configuration générique. Les valeurs de champ doivent également être vides dans le fichier XML pour que le bloc de texte personnalisé s’affiche.

Dans 'Imprimer et Liste. Configurer' (CMS005), le champ 'Société unique utilisé' (SNDI) pour (CMS038) est activé.

Suivez ces étapes pour attribuer des valeurs clés à un ID de texte :
  1. Démarrez le programme (CMS038).
  2. Précisez l’identité de texte. Cet ID de texte est associé à un groupe de clés.
    Remarque

    La position de l’identité de texte varie en fonction de l’ordre de tri utilisé.

  3. Dans le champ 'Groupe clé', spécifiez l'ID de groupe de clés unique. Le champ est géré dans (CMS034).
  4. Cliquez sur Appliquer. Les étiquettes de colonne sont fondées sur les étiquettes des champs clés spécifiés dans le programme (CMS034).
  5. Dans le champ 'Valeur', précisez la valeur du champ clé à comparer à un objet ou une valeur dans le programme 'Contrôle section texte pers. XML. Ouvrir' (CMS033).
  6. Utilisez l'option 1 (Créer).
  7. Dans le panneau E, la valeur des champs clés est reproduite et ne peut pas être modifiée.
  8. Appuyez sur Entrée.

D. 'Contrôle section texte pers. XML. Ouvrir' (CMS033)

Ce programme permet de connecter le groupe de clés (CMS034) à une section XML de base (CMS007). Un objet, une valeur ou une combinaison d’objet et de valeur sont alors affectés par champ clé à comparer aux valeurs dans (CMS038). Une fois ces informations correspondent, le bloc de texte personnalisé devient disponible dans la structure XML.

Champs à prendre en compte dans (CMS033/B) :
  • Fichier imprimante : auquel le bloc de texte configurable est connecté.
  • Section XML : à laquelle le bloc de texte configurable est associé. Ce champ doit avoir une valeur supérieure à 100. Il est également partagé dans d'autres programmes CMS tels que 'Section XML. Ouvrir table' (CMS008) et 'Chps ss-totaux personnalisés. Connecter' (CMS018).
Champs à prendre en compte dans (CMS033/E) :
  • Groupe clé - indique l'ID de groupe de clés unique. Il est géré dans le programme (CMS034).
  • Section XML de base : indique la section XML de base à laquelle le bloc de texte configurable est associé.
Options pour configurer 'Contrôle section texte pers. XML. Ouvrir' (CMS033)
  • Utilisation de valeurs comme champs clés - Utilisé pour établir des valeurs codées en dur. Lorsque ces valeurs codées en dur correspondent à l’enregistrement dans (CMS038), le bloc de texte personnalisé s’affiche dans le fichier XML.
  • Utilisation d’objets comme champs clés : permet de définir des objets basés sur la valeur de champ de table disponible. Lorsque ces définitions d’objet correspondent aux enregistrements de la structure XML, le bloc de texte personnalisé s’affiche.
  • Utilisation à la fois des valeurs et des objets comme champs clés - permet de définir à la fois des objets et des valeurs pour les champs clés. Cette sélection suit le comportement qui correspond aux valeurs codées en dur dans '(CMS038) et si la valeur de l’objet correspond à la structure XML, le bloc de texte personnalisé s’affiche.
Suivez ces étapes pour attribuer un groupe clé à une section XML de base :
  1. Démarrez le programme (CMS033).
  2. Dans le champ 'Fichier imprimante', indiquez l'identificateur unique de la sortie XML configurable.
  3. Dans le champ 'Section XML', spécifiez la valeur de la section XML qui doit être supérieure à 100.
  4. Utilisez l'option 1 (Créer).
  5. Dans le panneau E, saisissez un ID de groupe de clés unique dans le champ 'Groupe clé'. Ce champ est géré dans (CMS034).
  6. Dans le champ 'Section XML de base', spécifiez la section XML de base prise en compte en tant que section parente. Lors de l'impression de la section XML de base, la section enfant est également imprimée.
  7. Spécifiez un objet, une valeur ou une combinaison d’objet et de valeur. Ce champ indique un champ clé dans une table M3. Ce champ indique la valeur du champ clé à comparer à une valeur dans le programme (CMS038).
  8. Appuyez sur Entrée.

E. Connecter le bloc de texte personnalisé à la structure XML dans (CMS007)

Après avoir créé les enregistrements pour le bloc de texte personnalisé, il peut être ajouté à la section XML basée dans (CMS007) et le fichier imprimante. Le bloc de texte configurable doit s’afficher dans la structure XML.
  1. Démarrez le programme 'Structure XML. Ouvrir' (CMS006), choisissez la structure XML et utilisez l'option 24='Structure XML. Ouvrir section' (CMS007).
  2. Sélectionnez une section pour inclure le bloc de texte personnalisé et utilisez l'option associée 24='Ajouter un bloc de texte personnalisé' dans (CMS007).
  3. Utilisez le navigateur M3 pour afficher la section et le groupe de clés créés dans le programme 'Contrôle section texte pers. XML. Ouvrir' (CMS033).
  4. Sélectionnez l’enregistrement où vous souhaitez ajouter la section dans la structure XML.
  5. Une fois connecté dans la structure XML, le bloc de texte personnalisé est disponible lorsque le fichier imprimante est généré.

Les mêmes identités de texte mais avec des dates de début différentes peuvent être créées dans 'Texte personnalisé XML. Ouvrir' (CMS036). les clés 'ID-texte' et 'Langue' sont les premières à correspondre, suivies des dates. Si un ID-texte et une langue correspondants sont trouvés mais que les dates ne sont pas valides, le renvoi à un enregistrement dont la langue est vierge n'est pas pris en compte. Au lieu de cela, le bloc de texte n'est pas affiché dans la structure XML.

Pour les ID-texte différents, la langue puis les dates sont prises en compte pour l'affichage du bloc de texte dans la structure XML. Mais s'il n'y a pas d'enregistrement correspondant dans la société, les ID-texte sont recherchés dans la société vierge.

Rubriques liées