Schéma Rational DOORS

Le schéma Rational DOORS est étroitement lié à la structure du module Rational DOORS.

Vous pouvez utiliser un schéma prédéfini qui est générique et valide pour tous les modules formels de Rational DOORS. Utilisez ce schéma prédéfini lorsque vous utilisez la vue intégrale ou des attributs prédéfinis de la vue qui ne nécessitent pas d'attributs définis par l'utilisateur extraits. Si des attributs définis par l'utilisateur sont requis, utilisez l'assistant de reconnaissance de schéma de Document Studio pour créer un schéma Rational DOORS.

Requêtes et attributs du schéma prédéfini

Les requêtes et les attributs suivants se trouvent dans le schéma prédéfini.
Tableau 1. Requêtes et attributs
Requête Résultats Attributs
Module Entité unique, module spécifié dans la configuration de la source de données
  • Name : nom du module
  • Description : Description du module
  • Baseline : version du module
Module/Attribute Liste des attributs au niveau module du module
  • Name : nom de l'attribut
  • _value : valeur de l'attribut
Module/Discussion Liste des discussions du module Non applicable
Module/Discussion/Attribute Liste des attributs d'une discussion
  • Name : nom de l'attribut
  • _value : valeur de l'attribut
Module/Discussion/Comment Liste des commentaires d'une discussion
  • State
  • Text
  • Changed Status
  • Created On
Module/View Résultat unique, vue définie pour chaque source de données Rational DOORS dans la spécification de document
  • Name : nom de la vue
Module/View/Column Liste des noms d'en-tête de colonne de la vue sélectionnée
Remarque : Cette requête permet d'extraire la structure de la vue, telle que les informations sur les colonnes, sans extraire les données de la vue. Pour plus d'informations sur les données de colonne, voir Module/Object/Column.
  • Column Text : si cet attribut est utilisé dans un canevas, un message <attribut de données introuvable> est généré dans la sortie
  • Main : indique si la colonne est la colonne principale ou non.
  • Name : nom de la colonne
  • Attribute : l'attribut de la colonne ne correspond pas à l'attribut Rational DOORS sur lequel cette colonne est basée, mais à une construction Rational Publishing Engine. L'attribut est renseigné lors de la phase d'exécution avec une valeur de texte de colonne unique. Vous ne pouvez pas extraire les informations relatives à un attribut sous-jacent ou un script DXL d'une colonne de l'attribut.
  • _value : vide
Module/Object Liste de tous les objets avec la version spécifiée des modules filtrés et triés par la vue sélectionnée. Tout attribut élevé par l'utilisateur dans l'assistant de reconnaissance de schéma.
  • Object Identifier
  • Object Text
  • Object Heading
  • Absolute Number
  • Object Level
Module/Object/Attribute Liste des attributs de l'objet si la requête est dans le contexte d'une requête module/objet. Sinon, la liste de tous les attributs de tous les objets du module est incluse.
  • Name : nom de l'attribut
  • _value : valeur de l'attribut
Module/Object/Column Données de colonne de la vue sélectionnée de l'objet en cours
  • Column Text : données de la colonne
  • Main : indique si la colonne est la colonne principale ou non.
  • Name : nom de la colonne
  • Attribute : l'attribut de la colonne ne correspond pas à l'attribut Rational DOORS sur lequel cette colonne est basée, mais à une construction Rational Publishing Engine. L'attribut est renseigné lors de la phase d'exécution avec une valeur de texte de colonne unique. Vous ne pouvez pas extraire les informations relatives à un attribut sous-jacent ou un script DXL d'une colonne de l'attribut.
  • _value : vide
Module/Object/Table Résultat unique (table Rational DOORS) si l'objet correspond à un en-tête de table. Aucun résultat n'est inclus si l'objet actuel ne correspond pas à une table Rational DOORS. Non applicable
Module/Object/Table/Row Lignes de la table Non applicable
Module/Object/Table/Row/object Collection d'objets ; cellules de la ligne actuelle. Même liste d'attributs que pour la requête module/objet.
  • Object Identifier
  • Object Text
  • Object Heading
  • Absolute Number
  • Object Level
Module/Object/External Link Collection de liens externes de l'objet
  • URL : URL de l'entité externe liée et autres attributs tels que définis dans Rational DOORS
Module/Object/Link Liste des liens Rational DOORS de l'objet Non applicable
Module/Object/Link/Attribute Liste d'attributs du lien
  • Name : nom de l'attribut
  • _value : vide
Module/Object/Link/Linked Object Liste des objets liés Non applicable

Images

Les images sont extraites d'un module Rational DOORS avec les valeurs de l'attribut. Vous ne pouvez pas interroger que les images.

Pour configurer la taille des images extraites, spécifiez les propriétés Largeur max. de l'image et Hauteur max. de l'image. Ces propriétés peuvent être spécifiées dans deux endroits :
  • Les informations sur le format de l'élément définissent la taille des images contenues dans cet élément de canevas. Disponibles uniquement pour les éléments de canevas de texte.
  • Les métadonnées de spécification de document définissent la taille des images dans tous les canevas. Les valeurs de format d'élément remplacent ces valeurs globales.

Objets OLE

Vous pouvez extraire des objets imbriqués, tels que des objets OLE (Object linking and embedding), d'une source de données Rational DOORS. Les objets OLE sont toujours affichés comme images dans les sorties HTML, PDF et XSL-FO car ces formats ne prennent pas en charge les objets OLE.
Pour une sortie Microsoft Word, vous devez définir la propriété OLEs as static images dans la section des métadonnées de la spécification de document.
  • Si la propriété OLEs as static images a la valeur true, les objets OLE sont inclus dans le document de sortie comme images statiques. Si les objets OLE sont inclus dans le document de sortie comme images statiques, le document est autonome.
  • Si la propriété OLEs as static images a la valeur false, un dossier ref est généré au même emplacement que le document de sortie Microsoft Word. Si les objets OLE ne sont pas inclus dans le document de sortie comme images statiques, le document n'est pas autonome car le dossier ref distinct est requis.
Le dossier ref contient les fichiers .rtf des objets OLE. Pour chaque objet OLE exporté, la sortie Microsoft Word comporte une zone incluse pointant vers un fichier .rtf. IBM® Rational Publishing Engine ne pouvant pas mettre à jour les zones Microsoft Word, les zones incluses ne sont pas visibles lorsque le document Microsoft Word est ouvert. Pour les rendre visibles, effectuez l'une des actions suivantes :
Tableau 2. Actions
Action Résultat
Sélectionnez l'intégralité du contenu du document et utilisez la fonction Mettre à jour les champs de Microsoft Word. Les objets OLE sont affichés dans le document. Ce document n'est pas autonome.
Utilisez la macro updateFields fournie par Rational Publishing Engine. Les objets OLE sont affichés dans le document. Ce document n'est pas autonome.
Utilisez la macro insertOLEs fournie par Rational Publishing Engine. Les objets OLE sont affichés dans le document. Ce document est autonome.
Utilisez les macros rpe ou insertOLEs fournies par Rational Publishing Engine. Les objets OLE sont affichés dans le document. Ce document est autonome.
Remarque : Si vous déplacez un document qui n'est pas autonome vers un autre ordinateur, vous ne pouvez pas modifier les objets OLE. Pour éviter ce problème, exécutez les macros rpe ou insertOLEs.

Tableaux

Les tables Rational DOORS ne sont pas extraites automatiquement ; vous devez les interroger de manière explicite. Cette approche manuelle offre un contrôle précis sur le format de la table. La table est créée uniquement pour les objets Rational DOORS qui démarrent une table.

Exemple de requête qui extrait une table :

Container DOORS 1 $1 Module/Object
Paragraph
Text
Module/Object/Object/Text
Table DOORS 1 $2 Module/Object/Table
Row DOORS 1 $3 Module/Object/Table/Row
Cell DOORS 1 $4 Module/Object/Table/Row/Object
Text
Module/Object/Table/Row/Object/Object Text

Remarque : Les cellules de tableau n'ont pas de type dédié dans le schéma Rational DOORS. Pour extraire le contenu des cellules, utilisez la requête Module/Object/Table/Row/Object. Les objets correspondant à des cellules de tableau possèdent un attribut Object Text qui combine Object Heading et Object Text.

Liens externes

La requête Module/Object/External Link extrait les informations relatives aux liens Rational DOORS. Ces informations comprennent l'URL de l'entité externe et un ensemble d'autres attributs définis pour le lien externe.

Liens internes

Utilisez des requêtes pour extraire les informations relatives aux liens internes de Rational DOORS. Les liens internes créent un lien entre des informations connexes. Par exemple, créez un lien d'une exigence utilisateur aux fonctions de conception. Vous pouvez interroger des liens d'objet ou des objets liés.

Extraction récursive

Pour suivre les liens Rational DOORS de manière récursive, affectez à la propriété Niveau récursif une valeur non nulle dans la vue Propriétés. De la sorte, les liens sont suivis de l'objet initial et tous ses objets liés jusqu'au niveau récursif spécifié.

Remarque : Le suivi des liens est un long processus. Chaque objet comportant généralement de nombreux liens, le nombre d'objets traités augmente de manière exponentielle avec chaque niveau. Pour gagner du temps, utilisez le filtre natif afin de réduire le nombre de liens suivis.

Filtrage natif

Vous pouvez définir des filtres natifs sur les requêtes de lien. L'utilisation de ces filtres permet de réduire le nombre de liens à traiter et donc de réduire la durée de génération du document.

Filtrage par sens

La syntaxe de filtrage de tous les liens en entrée ou en sortie est la suivante :

Link direction in|out

Filtrage par module de lien

La syntaxe permettant de filtrer tous les liens via un module de lien est la suivante : Link module chemin_et_nom_module_lien

Le filtre est sensible à la casse.

L'exemple suivant filtre tous les liens d'un Module de lien 1 :

Link module /Demo/Car/Link Module 1

Filtrage par module cible

La syntaxe permettant de filtrer tous les liens à destination ou en provenance d'un module spécifié est la suivante : Link analyze module chemin_et_nom_module_cible

L'exemple suivant filtre tous les liens entre le module analyze et le module system requirement : Link analyze module /Demo/Car/System Requirements

Combinaison du filtrage de liens natif

Vous pouvez combiner les filtres dans un onglet de filtre natif. Chaque filtre doit se trouver sur sa propre ligne.
Par exemple, dans l'onglet Filtre natif, entrez le filtre comme suit :

Link direction out.
Link analyze module /Demo/Car/System Requirements.

Ce qui ne peut pas être extrait

Une source de données Rational DOORS dans Rational Publishing Engine est définie par un module, une version de référence, une vue. Vous ne pouvez pas interroger la liste des versions de référence ou la liste des vues du module. La source de données Rational DOORS est définie par le module, la version de référence, la vue. Il est possible d'extraire les données de plusieurs modules, versions de référence ou vues de l'une des manières suivantes :

Commentaires