Traiter plusieurs fichiers d'entrée ou de sortie dynamiquement
Vous pouvez configurer MapForce pour qu'il traite plusieurs fichiers (par exemple, tous les fichiers dans un répertoire) lorsque le mappage est en cours. L'utilisation de cette fonction vous permettra de résoudre les tâches suivantes :
•Fournir dans le mappage une liste des fichiers d'entrée à traiter
•Générer en tant que sortie de mappage une liste des fichiers au lieu du fichier de sortie unique
•Générer une application de mappage dans laquelle les noms du fichier d'entrée et de sortie sont tous les deux définis au moment du runtime
•Convertir un ensemble de fichiers dans un autre format
•Partager un fichier volumineux (ou une base de données) dans des parties plus petites
•Fusionner plusieurs fichiers en un grand fichier (ou les charger dans une base de données)
Vous pouvez configurer un composant MapForce pour traiter plusieurs fichiers d'une des manières suivantes :
•Fournir le chemin vers le(s) fichier(s) d'entrée ou de sortie en utilisant des caractères génériques au lieu d'un nom de fichier fixe, dans les paramètres de composant (voir Changer les paramètres du composants). Concrètement, vous pouvez saisir les caractères génériques * et ? dans le dialogue Paramètres de composant, afin que MapForce résolve le chemin correspondant lorsque le mappage est exécuté.
•Connecter une séquence au nœud racine d'un composant. Celle-ci fournit le chemin dynamiquement (par exemple, le résultat de la fonction replace-fileext). Lorsque le mappage est exécuté, MapForce lira dynamiquement tous les fichiers d'entrée ou générer dynamiquement tous les fichiers de sortie.
Selon les objectifs que vous souhaitez atteindre, vous pouvez utiliser soit une de ces approches ou les deux sur le même mappage. Néanmoins, il n'est pas efficace d'utiliser les deux approches en même temps sur le même composant. Pour indiquer à MapForce quelle approche vous souhaitez utiliser pour un composant particulier, cliquer sur la touche Fichier ( 
) ou Fichier/String ( 
) disponible à côté du nœud racine d'un composant. Cette touche vous permet de spécifier le comportement suivant :
Utiliser les noms de fichier depuis les Paramètres de composant | Si le composant doit traiter un ou plusieurs fichiers d'instance, cette option indique à MapForce de traiter le(s) nom(s) de fichier définis dans le dialogue Paramètres de composant.
Si vous choisissez cette option, le nœud de racine ne nécessite pas de connecteur d'entrée, étant donné que cela n'est pas utile.
Si vous n'avez pas spécifié de fichiers d'entrée ou de sortie dans le dialogue Paramètres de composant, le nom du nœud racine est Fichier : (défaut). Sinon, le nœud racine affiche le nom du fichier d'entrée, suivi par un point-virgule ( ;), suivi par le nom du fichier de sortie.
Si le nom de l'entrée est le même qu'avec celui du fichier de sortie, il sera affiché en tant que nom du nœud racine.
Veuillez noter que vous pouvez choisir soit cette option ou l'option Utiliser les noms de fichier dynamiques fournis par le mappage. |
Utiliser les noms de fichier dynamiques fournis par le mappage | Cette option indique à MapForce de traiter le(s) nom(s) de fichier que vous définissez dans la zone de mappage, en connectent les valeurs au nœud de racine du composant.
Si vous choisissez cette option, le nœud de racine reçoit un connecteur d'entrée auquel vous pouvez connecter des valeurs qui fournissent dynamiquement les noms de fichier à traiter pendant l'exécution de mappage. Si vous avez aussi défini les noms de fichier dans le dialogue Paramètres de composant, ces valeurs sont ignorées.
Lorsque cette option est sélectionnée, le nom du nœud de racine est affiché en tant que Fichier : <dynamic>.
Cette option est exclusive mutuellement avec l'option Utiliser les noms de fichier depuis les Paramètres de composant. |
Parser strings vers XML, Parser strings vers JSON, Parser strings vers CSV, Parser Strings vers FLF, Parse strings vers EDI | Lorsqu'elle est activée, cette option permet au composant d'accepter une valeur de string en tant qu'entrée dans le nœud de racine et de la convertir dans une structure XML, JSON, CSV, FLF ou EDI, respectivement. Pour plus d'informations, voir Parser et sérialiser les strings. |
Sérialiser XML vers Strings, Sérialiser JSON vers Strings, Sérialiser CSV vers Strings, Sérialiser FLF vers Strings, Sérialiser EDI vers Strings | Lorsqu'elle est activée, cette option permet au composant d'accepter une structure en tant qu'entrée, et de la convertir en un string. La structure d'entrée peut être XML, JSON, CSV, Champ de longueur fixe, ou EDI, respectivement. Pour plus d'informations, voir Parser et sérialiser les strings. |
Plusieurs fichiers d'entrée ou de sortie peuvent être définis pour les composants suivants :
•Fichiers XML
•Fichiers texte (CSV*, fichiers FLF* et fichiers FlexText**)
•Documents EDI**
•Feuilles de calcul Excel**
•Documents XBRL**
•Fichiers JSON**
•Fichiers Protocol Buffers**
* Nécessite MapForce Professional Edition
** Nécessite MapForce Enterprise Edition
La table suivante illustre la prise en charge pour les fichiers d'entrée et de sortie dynamiques et les caractères génériques dans les langages MapForce.
Langage cible | Nom de fichier d'entrée dynamique | Prise en charge de caractère générique pour le nom de fichier d'entrée | nom de fichier de sortie dynamique |
XSLT 1.0 | * | N'est pas pris en charge par XSLT 1.0 | N'est pas pris en charge par XSLT 1.0 |
XSLT 2.0 | * | *(1) | * |
XQuery | * | *(1) | N'est pas pris en charge par XQuery |
C++ | * | * | * |
C# | * | * | * |
Java | * | * | * |
BUILT-IN | * | * | * |
Légende :
* | Pris en charge |
(1) | XSLT 2.0, XSLT 3.0 et XQuery utilisent la fonction fn:collection. La mise en place dans les moteurs Altova XSLT 2.0, XSLT 3.0 et XQuery résolvent des caractères génériques. D'autres moteurs peuvent se comporter différemment. |