Vous pouvez générer un document à partir de Launcher et de Document
Studio.
Avant de commencer
Chaque canevas est associé à une spécification de document vide par défaut. Lorsque vous prévisualisez
ou publiez un canevas à partir de l'application Document Studio, cette spécification de document vide peut être personnalisée ou utilisée sans
personnalisation pour générer la sortie.
Document Studio conserve le canevas synchronisé avec la spécification de document par défaut lorsque vous ouvrez ou sauvegardez le canevas.Remarque : Ces
instructions s'appliquent à la plupart des sources de données, mais pas à toutes.
Pour accéder aux instructions spécifiques à une source de données, consultez la documentation
Intégration de votre source de données.
Pourquoi et quand exécuter cette tâche
Il existe plusieurs méthodes pour la génération de documents :
- Vous pouvez générer des documents à partir des applications Launcher ou Document Studio. La tâche ci-dessous décrit comment générer des documents
à partir de l'interface utilisateur de l'application.
- Depuis l'emplacement d'une spécification de document sur un système de fichiers, vous pouvez cliquer avec le bouton droit sur le fichier et sélectionner Publier avec Rational
Publishing Engine.
Toutes les erreurs sont supprimées pour la génération du document.
- Vous pouvez également publier des documents à partir des interfaces utilisateur de Rational
DOORS et de Rational Tau lorsque ces extensions sont installées.
Il n'y a pas aucune différence entre la génération de documents à partir de l'application Launcher ou de l'application Document Studio. Lorsque vous utilisez l'assistant pour générer des
documents, les mêmes options sont fournies dans les applications.
Toutefois, dans l'application Launcher, vous avez la possibilité de configurer des détails pour la génération de document dans les vues Spécification de document et Propriétés sans utiliser l'assistant.
Procédure
Pour générer des documents à partir de l'application Launcher ou Document
Studio :
- Dans Launcher ou Document Studio, cliquez sur .
Vous pouvez aussi cliquer sur l'icône
Configurer et générer le document dans la barre d'outils.
Un assistant de configuration s'ouvre pour vous permettre d'effectuer des sélections supplémentaires pour la génération de document avant la génération de ce ce dernier. La barre de progression affiche les informations qui doivent être
configurées dans cinq sections :
- Canevas
- Sources de données
- Variables
- Sortie
- Récapitulatif
Vous pouvez cliquer sur une section ou un élément dans la barre de progression afin d'accéder à cette page dans l'assistant.
Conseil : Dès lors qu'au moins
une source de données et un format de sortie sont sélectionnés, vous pouvez cliquer sur Terminer à tout moment
pour lancer la génération de document ou cliquer sur Suivant afin de poursuivre avec l'assistant de
configuration.
- Dans la section Canevas, les canevas déjà répertoriés dans
la spécification de document sont affichés.
Pour ajouter un canevas, procédez comme suit :
- Sélectionnez l'emplacement des canevas à ajouter.
- A partir de la bibliothèque centrale : Permet de sélectionner des canevas
stockés dans le composant Gestion centralisée
- A partir d'un fichier local ou distant : Pour sélectionner un canevas
local ou distant, vous pouvez entrer l'URL d'un canevas ou cliquer sur
Parcourir pour choisir un canevas.
- Sélectionnez un ou plusieurs canevas à ajouter.
- Si vous avez sélectionné A partir de la bibliothèque centrale et sélectionné
des canevas du composant Gestion centralisée, cliquez sur Ajouter la sélection afin d'ajouter ces canevas à la spécification de document.
- Si vous avez sélectionné A partir d'un fichier local ou distant et entré
l'URL d'un canevas individuel, cliquez sur Ajouter une adresse URL afin d'ajouter le
canevas à la spécification de document.
- Si vous avez sélectionné A partir d'un fichier local ou distant et cliqué sur Parcourir pour ajouter des canevas, lorsque vous cliquez sur Ouvrir,
les canevas sont ajoutés à la spécification de document.
- Facultatif : Répétez cette opération pour ajouter des canevas supplémentaires à partir d'autres emplacements.
- Facultatif : Réorganisez les canevas dans la spécification de document
en sélectionnant un canevas et en cliquant sur Haut ou Bas.
- Cliquez sur Suivant .
- Dans la section Sources de données, configurez chaque source
de données.
Remarque : - S'il existe une valeur par défaut pour une source de données, ou si une valeur URI par défaut a déjà été entrée, la source de données s'affiche telle qu'elle a été
configurée et la valeur par défaut est utilisée dans la sortie à moins qu'une autre valeur soit sélectionnée.
- Si vous allez plus loin que la section Sources de données et cliquez sur Retour afin d'apporter des modifications supplémentaires à une source de données, la section s'ouvre toujours sur la première source de données de la liste.
- Sélectionnez une source de données à l'un des emplacements suivants :
- Configuration manuelle : Permet de sélectionner une source de données locale ou distante car il n'existe aucune autre information de configuration pour cette source de
données dans la couche de configuration ou dans le composant Gestion centralisée
- Utilisation des valeurs de source de données provenant de la bibliothèque centrale :
Permet de sélectionner une source de données stockées dans le composant Gestion centralisée
- Charger à partir de la couche de configuration: Permet de sélectionner
une valeur des métadonnées de configuration qui ont été entrées pour la source de données dans le canevas
- En fonction de la sélection que vous avez effectuée à l'étape précédente, vous pouvez sélectionner une valeur pour la source de données en entrant une URL, en cliquant sur Parcourir pour en sélectionner une, ou encore sélectionner une valeur de la couche de configuration.
- Entrez un nom d'utilisateur et un mot de passe pour l'authentification auprès de l'application source de données.
- Sélectionnez un type d'authentification. Si vous ne sélectionnez pas de type, chaque type est testé jusqu'à ce que le
type correct soit trouvé, ce qui peut accroître la durée de génération de document.
- Auto
- De base
- Formulaire
- OAuth
- OAuth-OSLC
- Facultatif : Entrez un en-tête Accept. La valeur par défaut est application/xml,
*/*.
- Facultatif : Si vous voulez appliquer les données d'identification que vous avez entrées à chaque
source de données, sélectionnez l'option Appliquer ces valeurs de nom d'utilisateur et de mot de passe à chaque source de données configurée ou non configurée.
- Cliquez sur Suivant.
- Dans la section Variables,
configurez chaque variable.
Remarque : - S'il existe une valeur par défaut pour une variable, celle-ci s'affiche telle qu'elle est
configurée et la valeur par défaut est utilisée dans la sortie à moins qu'une autre valeur soit sélectionnée.
- Si vous allez plus loin que la section Variables et cliquez sur Retour afin d'apporter des modifications supplémentaires à une variable, la section s'ouvre toujours sur la première variable de la liste.
- Dans le menu déroulant, sélectionnez l'une des options ci-dessous :
- Configuration manuelle : Permet d'entrer une valeur pour la variable car il n'existe aucune autre information de configuration pour cette variable
dans la couche de configuration ou dans le composant Gestion centralisée
- A partir de la couche de configuration : Permet de sélectionner une valeur à partir des métadonnées de configuration que vous avez saisies pour la variable dans votre canevas.
- En utilisant les valeurs de variable provenant de la bibliothèque centrale : Permet de sélectionner une variable stockée dans le composant Gestion centralisée.
- Entrez ou sélectionnez une valeur pour la configuration.
- Cliquez sur Suivant .
- Dans la section Sortie,
sélectionnez les types de sortie à générer :
- Microsoft Word
- PDF
- HTML
- XSL-FO
- PDF existant
- Facultatif : Pour Emplacement de sauvegarde,
cliquez sur Parcourir afin de sélectionner un chemin de sauvegarde du fichier de chaque type de sortie. Si l'emplacement de sauvegarde de la sortie n'est pas spécifié, le fichier est généré
dans l'emplacement temporaire.
- Facultatif : Pour Feuille de style,
cliquez sur Parcourir afin de sélectionner une feuille de style à utiliser pour chaque
type de sortie lors de la génération de la sortie.
- Facultatif : Sortie Microsoft Word
uniquement : Pour Macro, entrez le nom de la
macro qui figure dans la feuille de style.
- Facultatif : Pour indiquer des métadonnées supplémentaires ou configurer d'autres propriétés de document qui ne sont pas incluses dans l'assistant, cliquez sur Modifier les propriétés de métadonnées.
- Cliquez sur Suivant.
- Vérifiez que les informations sur le canevas et la sortie dans la fenêtre récapitulative sont correctes.
- Sélectionnez une action à effectuer lorsque vous cliquez sur Terminer :
- Exécuter la génération de document : génère les types de
sortie que vous avez spécifiés.
- Exécuter la génération de document et fermer RPE :
génère les types de sortie que vous avez spécifiés et ferme l'application Rational
Publishing Engine
une fois que vous avez quitté la fenêtre Résultats.
- Fermer cet assistant et ouvrir le client RPE : ouvre
la spécification de document avec les détails que vous avez entrés dans l'application Launcher.
- Cliquez sur Terminer.
Conseil : Si vous générez le document à distance, vous pouvez fermer l'application Document Studio ou Launcher avant que la génération de document ne soit terminée sans en interrompre le processus. Si vous générez le document localement, ne fermez pas Document Studio ni Launcher avant que la génération ne soit terminée.
Résultats
La spécification de document est chargée dans Launcher et génère ou sauvegarde le document en fonction de la sélection effectuée.