Exécution de macros

Les macros permettent de mettre à jour les données dans la sortie Microsoft Word générée à partir de Rational Publishing Engine. Rational Publishing Engine met automatiquement à jour les zones Microsoft Word lors de la génération de documents. Si vous choisissez d'exécuter la macro plus tard, vous pouvez choisir d'exécuter la macro directement à partir de Rational Publishing Engine à l'aide de la propriété macro ou de l'ajouter comme commande de post-traitement pour l'exécuter sur la sortie générée.

Avant de commencer

Rational Publishing Engine est fourni avec trois fichiers qui contiennent des macros que vous pouvez utiliser. Dans le composant Gestion centralisée ou le répertoire %RPE_HOME%\utils\word\ de vos fichiers d'installation, vous pouvez trouver les fichiers suivants :
Tableau 1. Fichiers fournis avec Rational Publishing Engine, qui contiennent des macros
Nom et chemin du fichier Description
%RPE_HOME%\utils\word\rpe.dot

Feuille de style qui contient des macros.

%RPE_HOME%\utils\word\rpe_signed.dot

Feuille de style qui contient des macros.

%RPE_HOME%\utils\word\runmacro.vbs

Fichier script qui peut exécuter des macros.

Les fichiers rpe.dot et rpe_signed.dot contiennent tous deux les mêmes styles et macros, mais la version rpe_signed.dot contient une signature électronique pour la vérification de la source. Ces fichiers contiennent des macros qui peuvent imbriquer des objets OLE et mettre à jour les zones de sortie des éléments Table des matières, Table de figure et Table de table. La macro runmacro.vbs accepte entre 0 et 10 arguments pour la macro Microsoft Word. Vous pouvez utiliser ces macros ou enregistrer la vôtre.

Pourquoi et quand exécuter cette tâche

Lorsque vous utilisez la propriété macro, la macro est exécutée à partir de Rational Publishing Engine et les données sont mises à jour avant que la sortie ne soit générée. Lorsque vous utilisez la propriété post-command, la macro est exécutée par Microsoft Word pour mettre à jour les données une fois que la sortie a été générée.
Remarque : Si vous utilisez des variables dans votre argument de macro, vous devez utiliser la propriété post-command pour exécuter votre macro.

Exécution de la macro à l'aide de la propriété macro

Pourquoi et quand exécuter cette tâche

Les variables ne peuvent pas être utilisées dans votre argument.

Procédure

  1. Enregistrez ou spécifiez la macro dans le document Microsoft Word utilisé comme feuille de style.
  2. Dans l'application Programme de lancement, sélectionnez le canevas répertorié dans la vue de spécification de document.
  3. Si vous utilisez une feuille de style qui contient des macros, pour la propriété Feuille de style, entrez le chemin d'accès au document ou à la feuille de style qui contient la macro.
  4. Pour la propriété macro, entrez un argument. Exemple : nom_macro argument_macro
  5. Générez la sortie.

Résultats

La macro est exécutée à partir de Rational Publishing Engine et les données sont mises à jour avant que la sortie ne soit générée.

Exécution de la macro à l'aide de la propriété post-command

Pourquoi et quand exécuter cette tâche

Les noms de variable système, les noms de sortie et les variables de canevas peuvent être utilisés dans votre commande.

Procédure

  1. Enregistrez ou spécifiez la macro dans le document Microsoft Word utilisé comme feuille de style.
  2. Dans l'application Programme de lancement, sélectionnez le canevas répertorié dans la vue de spécification de document.
  3. Si vous utilisez une feuille de style qui contient des macros, pour la propriété Feuille de style, entrez le chemin d'accès au document ou à la feuille de style qui contient la macro.
  4. Pour la propriété post-commande, entrez un argument à l'aide de la commande cscript. La commande cscript permet de démarrer l'interpréteur de script de Windows pour exécuter la macro. Exemple : cmd /c cscript "RPE_HOME\utils\word\runmacro.vbs" "${Word}" nom_macro "${varA}"
    Remarque : Si votre argument contient des espaces, vous devez le mettre entre guillemets (" ").
  5. Générez la sortie. varA est remplacé par la valeur de la variable spécifiée dans le canevas.

Résultats

La macro est exécutée par Microsoft Word pour mettre à jour les données une fois que la sortie a été générée. varA est remplacé par la valeur de la variable spécifiée dans le canevas.

Retour d'informations