Ajouter un champ virtuel (CMS012)

Cette procédure définit les champs virtuels.

Dans la gestion de sortie, si les informations requises dans la sortie XML ne sont pas contenues dans une table de base de données, la dernière solution pour ajouter des champs est d'utiliser des champs virtuels. Un champ virtuel est défini par fichier imprimante et par section XML.

Une fois les champs virtuels créés, des champs peuvent être sélectionnés dans un élément à partir du programme (CMS009).

Les champs virtuels sont également utilisés dans ces programmes :
  • Catégorie navigateur information. Ouvrir (CMS010)
  • 'Groupe d'états ad hoc. Ouvrir' (AHS100)

Ces types de champs virtuels suivants peuvent être définis :

  • Champs calculés
  • Description provenant de CSYTAB
  • Nom provenant de CSYTAB
  • Conversion de devise
  • Formule logique
  • Conversion de date
  • Fusionner des données
  • Sous-chaîne
  • Traduction des données du message métier
Dans la création d'états ad hoc, un type supplémentaire de champ virtuel peut être défini :
  • Traduction des données du message métier
  1. Démarrez (CMS006), choisissez la structure XML et utilisez l'option 11 (Section de structure XML. Ouvrir élément) pour démarrer le programme (CMS007).
  2. Choisissez la structure et utilisez l'option 11 (Section de structure XML. Ouvrir élément) dans (CMS007) pour démarrer le programme (CMS009).
  3. Cliquez sur Champs virtuels pour démarrer le programme Champs virtuels. Connecter (CMS012).

Suivez les étapes suivantes pour créer un champ calculé :

  1. Spécifiez l'ID du champ virtuel (convention d'appellation = &XXXX). Utilisez l'option 1='Créer'.
  2. Précisez l'en-tête de colonne en spécifiant une description ou un ID de message. Si vous spécifiez une description, cette dernière peut être définie par langue en cliquant sur le bouton Langue. Si vous spécifiez un ID de message, M3 affiche automatiquement l'en-tête de colonne dans la langue M3 de l'utilisateur final.
  3. Sélectionnez le type de champ virtuel 1 ('Calcul').
  4. Précisez la séquence de calcul. Le champ est utilisé si d'autres champs virtuels sont utilisés en tant qu'objets dans la formule de calcul. Le champ virtuel actuel doit disposer d'une séquence de calcul supérieure aux champs virtuels servant d'objets dans la formule de calcul.
  5. Indiquez le nombre de décimales en précisant la valeur requise (0-4) ou en sélectionnant un code d'information de champ.
  6. Spécifiez la formule de calcul en saisissant un opérateur (+, –, /, *), un objet (champ issu de la table principale, d'une table liée, de champs de sous-total personnalisés ou d'un autre champ virtuel) et un facteur.
  7. Appuyez sur Entrée.

Suivez les étapes suivantes pour créer un champ pour une description ou un nom :

  1. Spécifiez l'ID du champ virtuel (convention d'appellation = &XXXX). Utiliser l'option 1 (Créer)
  2. Précisez l'en-tête de colonne en spécifiant une description ou un ID de message. Si vous spécifiez une description, cette dernière peut être définie par langue en cliquant sur le bouton Langue. Si vous spécifiez un ID de message, M3 affiche automatiquement l'en-tête de colonne dans la langue M3 de l'utilisateur final.
  3. Sélectionnez le type de champ virtuel 3 (Description) ou 4 (Nom) dans CSYTAB.
  4. Précisez l'option de lecture pour le champ de clé CTDIVI (Société). Cette option doit normalement être laissée vide.
  5. Précisez l'option de lecture pour le champ de clé CTSTCO (Valeur constante). Cette option doit normalement être définie sur 'Egal à'. La valeur correspond normalement aux 4 dernières positions pour le champ.
  6. Précisez l'option de lecture pour le champ de clé CTSTKY (Valeur clé). Cette option doit normalement être définie sur 'Egal à'. L'objet est normalement le champ.
  7. Précisez l'option de lecture pour le champ de clé CTLNCD (Langue). Cette option doit normalement être laissée vide.
  8. Appuyez sur Entrée.

Une fonction de saisie rapide permet aussi de définir un champ virtuel pour le champ Nom à partir de la table système liée (CSYTAB). Cliquez sur 'Table système lié', précisez la valeur Clé (par exemple, MMCUCD pour le nom du code devise basé sur MITMAS), puis cliquez sur OK.

Suivez les étapes suivantes pour créer un champ destiné à la conversion des devises :

  1. Spécifiez l'ID du champ virtuel (convention d'appellation = &XXXX). Utiliser l'option 1 (Créer)
  2. Précisez l'en-tête de colonne en spécifiant une description ou un ID de message. Si vous spécifiez une description, cette dernière peut être définie par langue en cliquant sur le bouton Langue. Si vous spécifiez un ID de message, M3 affiche automatiquement l'en-tête de colonne dans la langue M3 de l'utilisateur final.
  3. Sélectionnez le type de champ virtuel 5 (Conversion de devise).
  4. Précisez l'option de lecture pour la valeur de base. Il s'agit de la valeur à convertir.
  5. Précisez l'option de lecture pour la société de base. La société peut être définie comme étant 'Egal à' un objet société, ou trouvée via un champ d'établissement ou de dépôt.
  6. Précisez l'option de lecture pour le type Taux. Si 'Valeur vide' est sélectionné, le type de taux 01 est utilisé.
  7. Précisez l'option de lecture pour la devise source. Il s'agit de la devise de la valeur de base avant la conversion.
  8. Précisez l'option de lecture pour la devise cible. Il s'agit de la devise de la valeur de base après la conversion.
  9. Appuyez sur Entrée.

Suivez les étapes suivantes pour créer un champ de formule logique :

  1. Spécifiez l'ID du champ virtuel (convention d'appellation = &XXXX). Utilisez l'option 1='Créer'.
  2. Précisez l'en-tête de colonne en spécifiant une description ou un ID de message. Si vous spécifiez une description, cette dernière peut être définie par langue en appuyant sur le bouton Langue. Si vous spécifiez un ID de message, M3 affiche automatiquement l'en-tête de colonne dans la langue M3 de l'utilisateur final.
  3. Sélectionnez le type de champ virtuel 6-'Formule logique'.
  4. Spécifiez le type logique pour la condition (alphanumérique ou numérique).
  5. Précisez le premier opérande (toujours un champ du groupe de champs).
  6. Indiquez la condition.
  7. Indiquez comme définir le deuxième opérande (champ du groupe de champs, valeur spécifique ou vide).
  8. Précisez comment combiner 2 ou 3 conditions différentes.
  9. Indiquez comme définir la valeur si la condition a la valeur true (champ du groupe de champs, valeur spécifique ou vide).
  10. Indiquez comme définir la valeur si la condition est la valeur false (champ du groupe de champs, valeur spécifique ou vide).
  11. Appuyez sur Entrée.

Suivez les étapes suivantes pour créer un champ destiné à la conversion des dates :

  1. Spécifiez l'ID du champ virtuel (convention d'appellation = &XXXX). Utilisez l'option 1='Créer'.
  2. Précisez l'en-tête de colonne en spécifiant une description ou un ID de message. Si vous spécifiez une description, cette dernière peut être définie par langue en appuyant sur le bouton Langue. Si vous spécifiez un ID de message, M3 affiche automatiquement l'en-tête de colonne dans la langue M3 de l'utilisateur final.
  3. Sélectionnez le type de champ virtuel 7-'Date'.
  4. Spécifiez la date de base (1-'Date actuelle', 2-'Objet', 3-'Date spécifique').
  5. Spécifiez le format de date (1-'Date AAAAMMJJ', 2-'Numéro du jour', 3-'Numéro du jour ouvré', 4-'Numéro jour banque').
  6. Appuyez sur Entrée.

Suivez ces étapes pour créer des données fusionnées

  1. Spécifiez l'ID du champ virtuel (convention d'appellation = &XXXX). Utilisez l'option 1='Créer'.
  2. Précisez l'en-tête de colonne en spécifiant une description ou un ID de message. Si vous spécifiez une description, cette dernière peut être définie par langue en cliquant sur le bouton Langue. Si vous spécifiez un ID de message, M3 affiche automatiquement l'en-tête de colonne dans la langue M3 de l'utilisateur final.
  3. Sélectionnez le type de champ virtuel 8 ('Fusionner données').
  4. Précisez la longueur de champ.
  5. Si nécessaire, choisissez une valeur pour le champ 'Conversion'. Ce champ contient trois options : 0 - Non utilisé, 1 - Hexadécimal et 2 - Base64.
  6. Renseignez le champ 'Source de données', 'Champ' ou 'Valeur'. Pour le format décimal et le format de date, ces informations sont basées sur les paramètres régionaux.
  7. Appuyez sur Entrée.

Suivez ces étapes pour créer une sous-chaîne

  1. Spécifiez l'ID du champ virtuel (convention d'appellation = &XXXX). Utilisez l'option 1='Créer'.
  2. Précisez l'en-tête de colonne en spécifiant une description ou un ID de message. Si vous spécifiez une description, cette dernière peut être définie par langue en cliquant sur le bouton Langue. Si vous spécifiez un ID de message, M3 affiche automatiquement l'en-tête de colonne dans la langue M3 de l'utilisateur final.
  3. Sélectionnez le type de champ virtuel 9 ('Sous-chaîne').
  4. Précisez la longueur de champ.
  5. Renseignez les valeurs 'Champ', 'Position début' et 'Position fin'.
  6. Appuyez sur Entrée.

Suivez ces étapes pour créer un champ de conversion de données de message

  1. Spécifiez l'ID du champ virtuel (convention d'appellation = &XXXX). Utilisez l'option 1='Créer'.
  2. Précisez l'en-tête de colonne en spécifiant une description ou un ID de message. Si vous spécifiez une description, cette dernière peut être définie par langue en appuyant sur le bouton Langue. Si vous spécifiez un ID de message, M3 affiche automatiquement l'en-tête de colonne dans la langue M3 de l'utilisateur final.
  3. Sélectionnez le type de champ virtuel 11= 'Conversion des données Business Message'.
  4. Appuyez sur Entrée pour créer le champ. 'Données de message. Convertir' (CRS882) sera affiché pour la saisie de la conversion de données de message.