M-Designer Utilisation en ligne de commande

De MappingDoc

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.