Exemple Visual Basic .NET
L'exemple suivant illustre comment exécuter un fichier d'exécution de mappage (.mfx) à partir d'un code VB.NET. Sous Windows, les fichiers d'exemple sont disponibles à l'emplacement suivant : C:\Program Files\Altova\MapForceServer2026\etc\Examples.
Conditions préalables
•MapForce Server est installé et mis sous licence
•Si vous créez un nouveau projet Visual Studio, ajoutez une référence à l'assembly de MapForce Server (voir Interface .NET). Vous pouvez sauter cette étape si vous exécutez l'exemple API MapForce Server existant, parce que l'exemple référence déjà l'assembly de MapForce Server.
•Sur le menu Build de Visual Studio, cliquer sur Configuration Manager et définir une plateforme de build correcte, par exemple Debug | x86 (ou Debug | x64, le cas échéant). Ne pas utiliser "Any CPU" en tant que plateforme.
•Si vous avez installé MapForce Server 64-bit, alors l'application qui appelle l'API (comme l'échantillon ci-dessous) doit aussi être construite pour la plateforme 64-bit dans Visual Studio. De même, le chemin vers le programme d'exécution de MapForce Server doit être ajusté conformément au code.
La solution d'exemple se trouve dans le répertoire "Program Files", qui nécessite des droits administratifs. Vous devrez soit exécuter Visual Studio en tant qu'administrateur, soit copier la solution dans un fichier différent dans lequel vous n'avez pas besoin de droits d'administrateur. |
Exécuter le fichier .mfx
Le code ci-dessous exécute trois fichiers d'exécution de serveur (.mfx). La table ci-dessous recense les fichiers d'entrée attendus par chaque fichier .mfx, et la sortie qui sera créée après l'exécution.
Fichier d'exécution (.mfx) | Entrée | Sortie |
|---|---|---|
TokenizeString.mfx | AltovaTools.xml | AltovaToolsFeatures.csv |
SimpleTotal.mfx | ipo.xml | String |
ClassifyTemperatures.mfx | Temperatures.xml | Temperatures_out.xml |
Si vous disposez de Altova MapForce, vous pouvez également consulter les mappages originaux à partir desquels les fichiers .mfx ont été compilés pour mieux les comprendre. Ils sont appelés TokenizeString1.mfd, SimpleTotal.mfd et ClassifyTemperatures.mfd, respectivement. Vous trouverez les mappages dans les répertoires suivants : C:\users\<user>\Altova\MapForce2026\MapForceExamples.
L'exemple ci-dessous procède comme suit :
•Il crée une nouvelle instance de Altova.MapForceServer.Server. Il s'agit de l'objet avec lequel vous travaillerez par la suite.
•Il définit un répertoire de travail dans lequel l'exécution aura lieu. Les fichiers d'entrée sont censés exister dans ce répertoire si vous vous y référez comme utilisant un chemin relatif. Des fichiers de sortie seront aussi créés dans ce répertoire.
•Il exécute le fichier TokenizeString.mfx. Le chemin vers ce fichier est fourni en tant qu'un argument pour la méthode Run (veuillez noter que le chemin est relatif au répertoire de travail qui a été défini précédemment). En cas d'exécution réussie, un fichier .csv représentant la sortie de mappage sera créé dans le répertoire de travail.
•Il exécute SimpleTotal.mfx. Le chemin de fichier est également relatif au répertoire de travail. Ce mappage produit une sortie de string, nous appelons donc la méthode GetOutputParameter pour obtenir la sortie de string.
•Il exécute ClassifyTemperatures.mfx. Ce mappage attend un paramètre en tant qu'entrée, qui a été fourni avec l'aide de la méthode AddParameter
Option Explicit On 'Le ServerPath doit être défini avant toute autre propriété, car il réinitialise le serveur et réinitialise toutes les propriétés. |