Altova FlowForce Server 2025 Advanced Edition

Mappage de MapForce comme tâche planifiée

Ce tutoriel affichera comment déployer un mappage d’Altova MapForce sur FlowForce Server et comment exécuter ce mappage comme tâche planifiée. La présentation sommaire est décrite ci-dessous :

1.Nous déploierons un mappage MapForce sur FlowForce Server. Après avoir configuré tous les paramètres de déploiement pertinents, le navigateur affichera la page de configuration de la tâche qui inclura déjà le mappage déployé comme étape d’exécution.

2.Ensuite, nous ajouterons une étape d’exécution qui vérifiera si le chemin pour la sortie de mappage existe.

3.Dans la prochaine étape, nous ajouterons une étape conditionnelle qui créera un répertoire pour la sortie de mappage si ce répertoire n’existe pas.

4.Ensuite, nous configurerons un timer qui déclenchera la tâche selon un calendrier spécifique.

5.Nous sélectionnerons également un identifiant de mot de passe existant, avec lequel la tâche sera exécutée.

6.Une fois que la tâche a été exécutée, nous vérifierons le répertoire de sortie pour le fichier produit par le mappage.

Licences requises

Notez que vous devez avoir les licences suivantes pour cette configuration de la tâche : MapForce Enterprise Edition, MapForce Server Advanced Edition et FlowForce Server.

Mise en place

Cette sous-section décrit des instructions étape-par-étape sur comment créer la tâche décrite ci-dessus. La mise en œuvre de ce scénario est aussi affichée dans le fichier GIF en bas de ce chapitre.

Étape 1 : Déployer le mappage MapForce sur FlowForce Server

Pour ce tutoriel, nous utiliserons un exemple qui est envoyé avec MapForce :

<Documents>\Altova\MapForce2025\MapForceExamples\BookCatalogPDFToXML.mfd

Ouvrez ce fichier dans MapForce et procédez comme suit :

1.Ouvrez le menu Fichier et sélectionnez Déployer sur FlowForce Server.

2.Dans le dialogue Déployer Mappage qui s’ouvre, saisissez les détails de connexion pertinents.

3.Laissez le chemin par défaut du mappage déployé et les autres paramètres par défaut tel quel.

4.Cliquez sur OK.

5.Le mappage déployé s’ouvrira sur la page de configuration de la tâche de l’interface d’administration FlowForce Server, comme une étape d’exécution. Cliquez sur l’icône plus à côté du paramètre Répertoire de travail et saisissez le chemin suivant : C:\Test\FlowForceServer\MapOutput. Il s’agit du chemin où le fichier produit par le mappage sera enregistré.

Étape 2 : Ajouter des étapes d’exécution qui vérifient si un chemin existe

Dans la prochaine étape, nous voulons vérifier si le répertoire de sortie qui stocker le fichier produit par le mappage existe. À cette fin, suivez la étapes ci dessous :

1.Cliquez sur l’icône plus au-dessus de l’étape avec un mappage déployé et sélectionnez Nouvelle Étape d’exécution. Le bloc d’étape d’exécution apparaîtra.

2.Parcourez pour la fonction /system/shell/commandline dans le champ Exécuter fonction. Cette fonction de système peut exécuter des commandes shell et fichiers batch.

3.Saisissez la commande suivante avant le paramètre de la Commande :

IF EXIST C:\Test\FlowForceServer\MapOutput (ECHO true) ELSE (ECHO false)

Cette commande vérifie si le répertoire de sortie existe. Si le répertoire existe, la commande renverra true ; autrement, la commande renverra false.

4.Tapez la sortie du type dans Assigner le résultat au champ. Ce faisant, nous assignons le résultat de l’étape à la valeur sortie de type result. Assigner le résultat d’étape est nécessaire, car de cette façon, nous serons capable d’utiliser le résultat de cette étape à la prochaine étape.

Étape 3 : Ajouter une Étape Choisir

Puis, nous devons ajouter une étape conditionnelle qui créera le répertoire de sortie s’il n’existe pas. Suivez les étapes ci-dessous :

1.Ajouter une Étape Choisir comme suit : Cliquez sur l’icône plus après la première étape d’exécution et sélectionnez Nouvelle étape Choisir. Le bloc Choisir apparaîtra.

2.Dans le champ When, saisir l’expression suivante :

trim(content(stdout(output))) == 'false'

La fonction stdout prend le résultat produit par l’étape d’exécution précédente et sort un flux. La fonction content convertit stream en string. Ensuite, la fonction trim supprime tous les espaces avant et arrière du string.

La raison pour la conversion de la sortie en un string est que nous voulons vérifier si la sortie est égale au string false. Pour pouvoir comparer les deux parties de l’expression, nous devons devons nous assurer que les deux parties sont du même type de données.

La raison pour découper le string est que la sortie standard peut contenir des espaces avant et arrière qui sont préservés lorsque nous convertissons le stream en string. Sans la fonction trim, le résultat de la partie gauche de l’expression n’est éventuellement pas égal au string false.

3.Ajouter une étape d’exécution dans la partie When de l’étape Choisir : Cliquez l’icône plus et sélectionnez Nouvelle Étape d’exécution.

4.Parcourez pour la fonction /system/filesystem/mkdir dans le champ Exécuter fonction.

5.Ajouter le chemin suivant au paramètre Path : C:\Test\FlowForceServer\MapOutput.

6.Laissez la partie Otherwise du bloc Choisir tel quel.

Si le répertoire de sortie n’existe pas, l’étape Choisir la créera. Si le répertoire de sortie existe, l’étape Choisir ne sera pas exécutée, et l’exécution de la tâche sera traitée avec le mappage.

Étape 4 : Configurer un minuteur qui déclenchera la tâche

Puisque nous voulons exécuter une tâche selon un calendrier particulier, nous avons besoin de définir un minuteur qui déclenchera la tâche. Pour ajouter un minuteur, suivez les étapes suivantes :

1.Naviguez vers la section Déclencheurs de la page de configuration de la tâche et sélectionnez Nouveau Timer.

2.Définir l’option Exécuter comme jour de la semaine.

3.Définir le/s jour/s au cours desquels la tâche sera exécutée. Dans notre exemple, la tâche sera exécutée chaque vendredi.

4.Définir la date et l’heure dans le paramètre Start.

5.Veuillez vous assurer que la case à cocher Activée a été choisie.

Étape 5 : Ajouter un identifiant

Lorsque vous créez une tâche dans FlowForce Server, vous devez fournir les identifiants du compte d'utilisateur avec lesquels la tâche doit être exécutée.

Dans la section Identifiants, nous sélectionnerons un identifiant de mot de passe que nous avons créée avant ce tutoriel. Il s’agit d’un objet d’identifiant autonome que vous pouvez utiliser dans toute tâche. Les identifiants autonomes sont pratiques car vous pouvez les mettre à modifier à un endroit et ce changement affectera toutes les tâches qui utilisent la référence d’identifiant.

En alternative, vous pouvez préciser un identifiant local, en saisissant votre nom utilisateur et le mot de passe.

Pour plus d’information afin de savoir comment créer les types d’identifiants et instructions, voir Identifiants.

Étape 6 : Enregistrer la configuration de la tâche et vérifier la sortie

Pour enregistrer la configuration de la tâche, cliquez sur Enregistrer situé en bas de la page de configuration. Dès que le déclencheur déclenche, la tâche sera exécutée. Pour voir la sortie, naviguez vers C:\Test\FlowForceServer\MapOutput et vérifiez s’il contient BookList.xml. Vous pouvez aussi vérifier le journal pour les détails sur l’exécution de la tâche. Un extrait du fichier BookList.xml est donné ci-dessous :

<Author>Stephen King</Author>

</Book>

<Author>Ragnar Jonasson</Author>

</Book>

<Author>Ragnar Jonasson</Author>

</Book>

<Author>Stephen King</Author>

</Book>

<Author>Bram Stoker</Author>

</Book>

<Author>Charles Dickens</Author>

</Book>

<...>

</BookList>

Mise en œuvre affichée en GIF

Pour une démonstration rapide des étapes décrites dans ce tutoriel, cliquez sur le fichier GIF ci-dessous. Notez que seules les seules les étapes 1- 4 et 6 sont illustrées dans la GIF. Pour une illustration de l’Étape 5, voir le tutoriel Hello World.