Utilisation des lignes de commande

L’Utilitaire Monarch admet le recours aux lignes de commande, spécifiquement pour les fonctions de préparation des fichiers, invocables de manière récurrente.

L’exécution d'une commande d’Utilitaire Monarch prise en charge s’effectue selon la procédure suivante.

Procédure à suivre :

1. Ouvrez l’invite de commandes Windows.

2. Allez à C:\Program Files\Altair Monarch 2021\.

3. Exécutez la fonction comme suit : monarchutility.automation.exe <commande>

Exemple : monarchutility.automation.exe "C:\Monarch Classic\Monarch Utility\Command Line\Source" "-f:*.dpwx;" -isf /ccw /all /skipw

Commandes prises en charge

Remplacement d’une chaîne

Commande : <fichier source> <fichier cible> /cr <chaîne recherchée> <chaîne de remplacement>

où :

/cr représente la commande « exécuter un remplacement de chaîne ».

<chaîne recherchée> = la chaîne à remplacer. La chaîne doit être présentée entre guillemets.

<chaîne de remplacement> = la chaîne devant remplacer la chaîne recherchée. La chaîne doit être présentée entre guillemets. Cet argument est facultatif. En son absence, la chaîne recherchée est supprimée.

/chset – <jeu de caractères> – La valeur ansi ou ascii indique le jeu de caractères à utiliser pour les chaînes et le fichier d’entrée. Cet argument est facultatif. En son absence, la valeur /chset:ascii est présumée.

 

Exemple : « c:\test\test.prn" "c:\test\test1.prn" /cr "./n/n" ".00" /chset:ansi

Remarque : Il est possible de procéder en boucle à travers un dossier entier, par script séquentiel. Un fichier séquentiel contenant la ligne suivante exécute la commande de recherche-remplacement sur chaque fichier doté de l’extension .prn dans le dossier c:\test :

FOR %%f IN ("c:\test\*.prn") DO "c:\monarchutility.automation.exe" %%f %%f /cr "./n/n" ".00" /chset:ansi

 

Insertion de sauts de ligne dans les fichiers à flux continu

Commande : <fichier source> <fichier cible> /nr <longueur de segment>

où :

/nr représente la commande « exécuter une insertion de sauts de ligne ».

<longueur de segment> = longueur des nouvelles lignes.

 

Exemple : "c:\test\test.prn" "c:\test\test1.prn" /nr 500

 

Insertion de sauts de ligne dans les fichiers à longueur de ligne supérieure à 4 000 caractères

Commande : <fichier source> <fichier cible> /lr <longueurs de ligne>

où :

/lr représente la commande « exécuter de longues lignes ».

<longueurs de ligne> = longueurs de ligne séparées par un espace.

 

Exemple : "c:\test\test.prn" "c:\test\test1.prn" /lr 2000 2000 2000

 

Préparation de format EDI

Commande : <fichier source> <fichier cible> /edi <paramètres>

où :

/edi représente la commande « exécuter la transformation edi et les paramètres de détection automatique ».

 

Les paramètres suivants peuvent être spécifiés après /edi :

séparateur de segments – /segd:caractère (ex.: /segd:’ )

séparateur d’éléments – /elem:caractère (ex.: /elem:: )

séparateur de sous-éléments – /sube:caractère (ex.: /sube:+ )

caractère d’échappement – /rele:caractère (ex.: /rele:? ) Cet argument est facultatif. Tous les autres sont obligatoires si la syntaxe de détection automatique est omise.

L’argument de fichier cible est facultatif et l’ordre des paramètres est indifférent. Au besoin, les caractères peuvent être présentés entre guillemets. Par exemple : /sube:" "

 

Exemple : "c:\test\test.prn" "c:\test\test1.prn" /edi /segd:’ /elem:: /sube:+

Exécuté en ligne de commande, l’Utilitaire Monarch renvoie un zéro après exécution complète réussie. En cas d’erreur, l’utilitaire renvoie la valeur 1. Sous exécution en fichier séquentiel, le code peut tester le renvoi de la valeur 1 et agir en conséquence.

 

Convertir des modèles ou projets texte/XML au format binaire

Un seul fichier

Commande : <fichier source> <fichier cible> /cnv

Exemple : "c:\test\test.xmod" "c:\test\test.dmod" /cnv

Plusieurs fichiers

Commande : <dossier source> -f:<noms de fichier> -isf <dossier cible> -psf /cnv

Exemple : "c:\test\depuis" "-f:*.xmod;*.xprj;" -isf "c:\test\to" -psf /cnv

où :

<noms de fichier> – entrez le nom du fichier à utiliser (fichier de modèle ou projet particulier) ou entrez un caractère générique suivi de l’extension appropriée (*.dmod, par exemple).

-isf – incluez les fichiers compris dans tous les sous-dossiers du dossier source spécifié (facultatif).

-psf – préservez la structure du <dossier source> dans le <dossier cible> (facultatif).

 

Masquer les lignes d'échantillon

Commande : <dossier source> -f:<noms de fichier> -isf /rsl <paramètres>

où :

-f:<noms de fichier> – spécifie les fichiers à supprimer, p. ex., *.dmod (facultatif)

-isf – inclure les fichiers compris dans tous les sous-dossiers du dossier source spécifié (facultatif)

 

Les paramètres suivants peuvent être spécifiés après /rsl :

/skipm – ignorer les modèles contenant des masques en mode flottant ou regex (facultatif)

/skipw – ignorer les espaces de travail enregistrés par une version antérieure à celle du moteur actuel, c’est-à-dire moins que mineure (Majeure.Mineure.Correctif) (facultatif)

 

Exemple : "c:\test\modèlesEtEspacesTravail" "-f:*.dmod;*.dpwx;" -isf /rsl /skipm

 

Supprimer les identifiants des projets et des modèles

Commande : <dossier source> -f:<noms de fichier> -isf /rsl <paramètres>

où :

-f:<noms de fichier> – spécifie les fichiers à supprimer, p. ex., *.dmod (facultatif)

-isf – inclure les fichiers compris dans tous les sous-dossiers du dossier source spécifié (facultatif)

 

Les paramètres suivants peuvent être spécifiés après /ccpm :

/el – supprimer les mots de passe de recherche extérieure (facultatif)

/db – supprimer les mots de passe de base de données (facultatif)

/rpt – supprimer les mots de passe d’état (facultatif)

/http – supprimer les noms d'utilisateur et mots de passe HTTP (facultatif)

/ftp – supprimer les noms d'utilisateur et mots de passe FTP (facultatif)

/s3 – supprimer l’info de connexion Amazon S3 (facultatif)

/zip – supprimer les mots de passe des archives ZIP (facultatif)

/all – supprimer tous les identifiants (facultatif)

En l’absence d'indicateurs facultatifs, aucun identifiant n’est supprimé.  En présence d'indicateurs d'identifiant facultatifs, seuls ces identifiants sont supprimés.

 

Exemple : "c:\test\projetsEtModèles" "-f:*.dmod;*.dprj;" -isf /ccpm /db /rpt

 

Supprimer les identifiants des espaces de travail

Commande : <dossier source> -f:<noms de fichier> -isf /ccw <paramètres>

où :

-f:<noms de fichier> – spécifie les fichiers à supprimer, p. ex., *. dpwx (facultatif)

-isf – inclure les fichiers compris dans tous les sous-dossiers du dossier source spécifié (facultatif)

 

Les paramètres suivants peuvent être spécifiés après /ccw :

/skipw – ignorer les espaces de travail enregistrés par une version antérieure à celle du moteur actuel, c’est-à-dire moins que mineure (Majeure.Mineure.Correctif) (facultatif)

/user – supprimer les noms d'utilisateur (facultatif)

/at – supprimer les jetons d’accès (facultatif)

/sk – supprimer les clés secrètes (facultatif)

/ai – supprimer les ID de compte (facultatif)

/sae – supprimer les adresses électroniques de compte de service (facultatif)

/rt – supprimer les jetons d’actualisation (facultatif)

/all – supprimer tous les identifiants (facultatif)

 

Exemple : "c:\test\espacesDeTravail" -f:*.dpwx -isf  /ccw /user /sae /skipw

Les mots de passe sont toujours supprimés. En l’absence d'indicateurs facultatifs, seuls les mots de passe sont supprimés. En présence d'indicateurs facultatifs, seuls ceux spécifiés et les mots de passe sont supprimés.

 

AFFICHER les COMMANDES de l’Utilitaire Monarch

Commande : /?