Les concepteurs de rapport peuvent utiliser Document Studio pour importer des schémas de
source de données et générer des canevas de rapport.
Les fonctions de l'application
Requirements Management (RM) sont fournies sous licence en tant que IBM® Rational DOORS Next
Generation.
Les informations relatives à l'intégration de l'application RM s'appliquent à Rational DOORS Next Generation et à des
versions spécifiques de IBM Rational Requirements Composer.
Avant de commencer
Conseil : L'installation de
Rational Publishing Engine
inclut un ensemble d'exemples de rapport. Avant de commencer à publier des documents,
vous pouvez explorer cet exemple de scénario de génération de documents. Voir
Création de l'exemple de canevas REST.
Familiarisez-vous avec
le service REST de l'application RM et les différentes URL nécessaires à l'extraction de données
de l'application RM lors de l'utilisation de
Rational Publishing Engine. Pour rechercher le centre de documentation de votre version de l'application RM, voir la documentation du produit
Rational DOORS Next Generation.
Pourquoi et quand exécuter cette tâche
Les données sont extraites à l'aide de l'API REST.
Cette interface est installée et implémentée avec l'application de source de données et elle fonctionne indépendamment de
Rational Publishing Engine.
Pour plus d'informations sur l'API REST d'une source de données, consultez la
documentation de cette source de données.
Procédure
- Pour un aperçu du processus de développement de canevas, voir Conception de canevas de document. Commencez à planifier la structure de votre document et les données qui pourraient y être incluses. Par exemple, déterminez si le document
final sera généré à partir d'un ou de plusieurs fichiers de canevas contenant chacun des éléments de contenu réutilisables.
- Dans l'application Document Studio,
créez un canevas de document.
- Identifiez un schéma de source de données de votre source de données. Pour ajouter des éléments de données spécifiques de votre projet d'application RM,
entrez l'URL au format suivant :
- https://server:port/rm/publish/artifact
Exemple :
- https://server:port/rm/publish/resources
- Ajoutez un schéma de source de données à votre canevas de document. Pour l'application RM, vous pouvez effectuer les étapes suivantes :
- Dans Document Studio, cliquez sur .
- Dans la zone Prédéfinies, sélectionnez Texte DNG ou
Module DNG.
- Dans Type, sélectionnez le type de schéma dans la liste. Pour l'application RM, sélectionnez XML générique.
- Editez la zone Schéma si nécessaire ou cliquez sur Parcourir pour sélectionner le
chemin d'accès au fichier de schéma. Exemple :
https://serveur:port/rm/publish/artefact?metadata=schema.
Pour CLM 6.0.2 et versions ultérieures, vous pouvez obtenir le lien permanent en cliquant sur l'icône Afficher le lien permanent à la fin de l'élément de navigation de l'artefact dans Rational DOORS Next Generation. L'URL apparaît dans la fenêtre Afficher le lien permanent. Collez l'URL dans la zone Schéma et ajoutez &metadata=schema à la fin de l'URL.
- Cliquez sur Suivant, puis sur Terminer.
- Si la ressource se trouve sur un serveur sécurisé, indiquez le nom de l'Utilisateur.
- Si la ressource se trouve sur un serveur sécurisé, indiquez le Mot de passe.
- Sélectionnez le Type d'authentification dans la liste. Pour l'application RM, le type d'authentification est OAuth. Si vous ne sélectionnez pas OAuth, chaque type d'authentification est testé jusqu'à ce que le
type correct soit trouvé, ce qui peut accroître la durée de génération de document.
- Ajoutez des éléments au canevas. Rational Publishing Engine
contient un ensemble complet d'éléments de canevas que vous pouvez utiliser pour
structurer votre document. Vous pouvez faire glisser des éléments dans l'éditeur de
contenu de canevas.
Par exemple, vous pouvez ajouter un élément Conteneur qui contiendra plusieurs paragraphes.
Chaque
paragraphe peut être contrôlé par une condition de test qui ne l'associe qu'à des données
spécifiques. Pour plus d'informations, voir
Eléments de canevas dans la vue Palette
et Ajout d'éléments à un canevas.
- Eléments de table
- Lorsque les données tabulaires sont saisies depuis l'application RM, les largeurs doivent être spécifiées pour chaque colonne,
tout comme les cellules, et non pour le tableau afin qu'elles soient traitées par Rational Publishing Engine.
- Utilisez des requêtes,
des attributs
et des variables
pour ajouter des données à un canevas. Ces éléments précisent les éléments d'informations générés dans
le rapport.
- Ajoutez un formatage et du style aux
éléments afin de contrôler leur mode d'affichage dans la sortie.
- Créez des filtres afin d'affiner les données qui sont extraites et placées dans le rapport. Vous pouvez utiliser des filtres, qui sont des versions détaillées de l'identificateur URI de source de données générale, pour pointer vers des sous-ensembles spécifiques de données, de sorte que Rational Publishing Engine ne tente pas d'extraire plus d'informations que nécessaire de la source de données lors de la génération de rapport. Ces filtres doivent être suffisamment larges pour extraire
toutes les données nécessaires référencées par le canevas. Sinon, le rapport généré ne
peut pas inclure de données complètes. Pour plus d'informations, voir Rational Requirements Composer data
sources.
- Créez des tris afin d'organiser les données dans votre rapport.