REFORMAT
La fonction REFORMAT renvoie un objet type obtenu par le remplacement de la syntaxe du type en entrée par la syntaxe du type en sortie.
Le caractère de début et le caractère de fin du type en sortie sont construits. Les règles de résultat du contenu sont déterminées en fonction du type en entrée et du type en sortie. Les groupes et les éléments sont utilisés avec REFORMAT.
REFORMAT ne peut pas être utilisé en tant qu'argument pour une fonction, un opérateur ou une mappe fonctionnelle.
- Syntaxe :
- REFORMAT (expression-objet-unique)
- Signification :
- REFORMAT (type-à-convertir)
- Renvoie :
- Un objet type
REFORMAT renvoie un objet type dont le contenu correspond à l'objet type en entrée, mais dont la syntaxe correspond à l'objet type en sortie. Le tableau suivant détaille les résultats attendus, en fonction de l'entrée et de la sortie.
| Type d'entrée | Type de sortie | Résultat |
|---|---|---|
| Groupe | Groupe | Le contenu de chaque composant en sortie est obtenu à partir du contenu du composant du groupe en entrée correspondant. Par exemple, le composant en sortie 1 est mappé avec le composant en entrée 1, le composant en sortie 2 est mappé avec le composant en entrée 2, etc. Les composants de ces groupes doivent être des éléments et non pas un groupe. Si un composant en sortie n'est pas associé à un composant en entrée, les occurrences requises du composant en sortie sont construites en tant que valeurs "none". Si un composant en entrée n'est pas associé à un composant en sortie, les données de ce composant en entrée ne sont pas prises en compte. Lorsqu'une occurrence de composant est construite, le délimiteur (s'il existe) du groupe en sortie contenu est construit et un objet du type en sortie du composant est construit à partir du type en entrée correspondant, à l'aide de l'algorithme REFORMAT. |
| Groupe | Elément | Texte d'un contenu du groupe en entrée correspondant. |
| Elément | Groupe | Le contenu de l'élément en entrée est appliqué comme s'il s'agissait du premier composant du groupe en sortie. |
| Elément | Elément | Le contenu de l'élément en entrée est appliqué au contenu de l'élément en sortie. |
Exemples
- MyXMLPurchaseOrder = REFORMAT(MyCOBOL_PurchaseOrder)
Cette fonction est utile lorsque la même structure de type peut provenir de différents schémas, tels que différentes versions du même EDI ou lors de la conversion de formats traditionnels en XML.