M-Designer Utilisation en ligne de commande
Sommaire
Utilisation de M-Designer en ligne de commande
M-designer.exe peut être exécuté en ligne de commande et appelé dans un script pour automatisation.
Génération en ligne de commande
Paramètres
- "-Generate" : Active la génération de la maquette, de l'association de projet ou du composant passé en paramètre.
- "-ProjectFile:" : Chemin complet du fichier .mpp de la maquette à générer.
- "-ProjectAsso:" : Chemin complet du fichier .mpa de l'association de projet à générer.
- "-MPWFile:" : Chemin complet du fichier .mpw du composant à générer.
- "-Mode:" : Définie le type de projet. Peut valoir SPOOL ou XML.
- "-FtpUse:" : Peut valoir 1 ou 0. Active la génération par FTP.
- "-SftpUse:" : Peut valoir 1 ou 0. Précise que la connexion se fera par SFTP.
- "-FtpFolder:" : Défini le chemin d’accès du serveur.
- "-FtpLogin:" : Défini le login de connexion.
- "-FtpPassword:" : Défini le mot de passe de connexion.
- "-FtpIPAddress:" : Défini l'adresse IP du serveur.
- "-GenColor:1:" : Génère en couleur (Défaut : Fond de page en Noir et blanc en XPS).
- "-Lang:XX:" : Spécifie le langage de génération 0 = PCL5 , 1 = PCL5 Optimisé , 2 = PCL5 Image , 3 = AFPDS , 4 = PDF , 5 = ZEBRA , 6 = DPL , 7 = IGP , 8 = TEC , 9 = IPL , 10 = F_D (plus supporté) , 11 = EPL , 12 = XPS
Exemples
- Génération d'un projet :
M-Designer.exe "-Hide" "-ProjectFile:c:\M-Designer\docpc\MyProject.mpp" "-Mode:SPOOL" "-Generate"
- Génération d'un composant :
M-Designer.exe "-Hide" "-MPWFile:c:\M-Designer\docpc\MyOverlay.mpw" "-Generate"
- Génération par FTP :
M-Designer.exe "-Hide" "-ProjectFile:c:\M-Designer\docpc\MyProject.mpp" "-Mode:SPOOL" "-Generate" "-FtpUse:1" "-SftpUse:1" "-FtpFolder:/home/mapping/import/" "-FtpLogin:MyLogin" "-FtpPassword:MyPassword" "-FtpIPAddress:123.123.123.123"
Importation de ressources en ligne de commande
Paramètres
- "-InFile" : Chemin complet du fichier à importer.
- "-ImportXML" : Importation d'un projet au format XML.
- "-ImportXPS" : Conversion d'un fichier XPS en maquette M-Designer.
- "-MemSpace" : Option pour l'importation de XPS. Conserve les espaces dans les zones mémoires.
- "-NoParagraph" : Option pour l'importation de XPS. Ne conserver pas les paragraphes.
- "-CarriageReturn" : Option pour l'importation de XPS. Gestion des retours à la ligne.
- "-StartMem:" : Option pour l'importation de XPS. Caractère marquant le début d'une zone variable.
- "-EndMem:" : Option pour l'importation de XPS. Caractère marquant la fin d'une zone variable.
- "-Format:" : Option pour l'importation de XPS. Nom du format de la maquette à créer.
- "-Save:" : Sauvegarde la maquette résultant de l'importation. Le nom du fichier sera nommé sou la forme FORMAT_SEQUENCE.mpp.
Génération de plusieurs projets
Pour ce faire nous pouvons utiliser un batch pouvant avoir pour information le contenu suivant : for %%X in ("%1\*.mpp") do ("C:\MAPPING\M-Designer\%2" "-Generate" "-ProjectFile:%%X" "-Hide" "-GenColor:1" "-Lang:12")
Pour l'exécuter il faudra simplement l'appeler de la façon suivant :
c:\MAPPING\M-Designer>generate.bat C:\git_drive\testing\tickets\advitam\data\import\docpc M-Designer_ONYX_9.2.7.exe
1er paramètre : le répertoire contenant les projets
2ième paramètre : Le binaire M-Designer.exe se situant dans le répertoire C:\MAPPING\M-Designer à utiliser
Génération de plusieurs composants
Pour ce faire nous pouvons utiliser un batch pouvant avoir pour information le contenu suivant : for %%X in ("%1\Composant*.mpw") do ("C:\MAPPING\M-Designer\%2" "-Generate" "-MPWFile:%%X" "-Hide" "-GenColor:1" "-Lang:12")
Attention : Tous les composants devront être préfixer du nom Composant
Pour l'exécuter il faudra simplement l'appeler de la façon suivant :
c:\MAPPING\M-Designer>generatecomp.bat C:\git_drive\testing\tickets\advitam\data\import\docpc M-Designer_ONYX_9.2.7.exe
1er paramètre : le répertoire contenant les composants
2ième paramètre : Le binaire M-Designer.exe se situant dans le répertoire C:\MAPPING\M-Designer à utiliser
Exemples
- Création d'une maquette à partir d'un fichier XPS :
M-Designer.exe "-Hide" "-InFile:c:\file.xps" "-ImportXPS" "-Format:IMPORTXPS" "-Save"
- Création d'une maquette à partir d'un fichier XML:
M-Designer.exe "-Hide" "-InFile:c:\file.xml" "-ImportXML" "-Save"
Codes de retour
Voici la liste des codes de retour M-Designer lorsque celui-ci est utilisé en ligne de commande.
0 : No error.
1 : An error occurred while writing to the Windows registry.
2 : .mpp file was not found.
3 : .mpp file can't be opened.
4 : .xml file can't be opened.
5 : An error occurred while creating the image (if the option to save the preview as an image is activated).
6 : Empty project, nothing to generate.
7 : Incorrect parameter.