Création de règles pour les fichiers et les dossiers

Vous pouvez créer des règles pour définir le contenu et les métadonnées d'actifs en vue d'effectuer une mise à jour par lots.

Pourquoi et quand exécuter cette tâche

Après avoir spécifié les répertoires qui contiennent les fichiers et les dossiers à partir desquels vous souhaitez créer des actifs, vous devez créer des règles définissant le contenu et les métadonnées des actifs. Vous pouvez définir ces informations soit en créant un fichier manifest.rmd qui contient les définitions des règles, soit en créant une série de règles. Pour savoir comment créer un fichier manifest.rmd, consultez la rubrique Créer un fichier manifest.rmd.
Lorsque vous créez des règles, il est souvent possible de spécifier un fichier texte dans un répertoire rempli de données qui créent les règles pour vous. Aidez-vous du guide suivant pour créer ces fichiers texte pour chaque type de règle. Ces fichiers texte peuvent porter un nom quelconque.
Tableau 1. Guide de référence des fichiers texte
Types de métadonnées d'actif Description Exemple
Attributs Ce fichier texte doit obéir à la syntaxe suivante : une paire nom=valeur par ligne. Runtime context=Eclipse v3.3

Server context=WebSphere Application Server v7.0

Catégories Ce fichier texte doit obéir à la syntaxe suivante : une seule entrée schéma/catégorie/sous-catégorie par ligne. Chaque entrée doit contenir un schéma, une catégorie et au moins une sous-catégorie. Automobile/Modèle/Marques étrangères/Honda/Civic
Description Le contenu entier du fichier texte devient la description de l'actif. Cet actif décrit toutes les exigences logicielles de l'édition v8.0.
Propriétaires Ce fichier texte doit contenir un ID unique par ligne. Il ne s'agit pas d'un ID utilisateur, mais plutôt d'un code ou d'un numéro unique décrivant votre identité dans un registre d'utilisateurs. jdupont ou

3F4467A

Actifs apparentés Ce fichier texte contient une entrée typeRelation:guid/version par ligne. Container:{0000-1111-2222-3333}/1.0

Contains:{1111-2222-3333-4444}/1.1

Communauté, Nom, Description abrégée, Type d'actif, Version La première ligne du fichier texte de chacun de ces éléments doit être la valeur de l'élément correspondant. Ma communauté

Procédure

Pour créer des règles relatives au contenu et aux métadonnées d'un actif :

  1. Cliquez avec le bouton droit sur le chemin de répertoire et sélectionnez Ajouter une règle. Vous pouvez créer une règle d'actif ou une règle de communauté pour le répertoire. Ces règles s'appliqueront à tous les dossiers et archives présents dans le répertoire.
  2. Créez une règle d'actif, une règle de communauté ou les deux types de règle pour le répertoire. Aidez-vous du tableau suivant pour apprendre à créer des règles d'actif et de communauté.
    Option Description
    Règle d'actif
    1. Dans la section Type de règle, sélectionnez Actif et cliquez sur Suivant.
    2. Définissez la valeur de la règle en utilisant l'une des options suivantes :
      • Option 1 : cliquez sur Créer des actifs à l'aide de tous les dossiers et archives pour créer des actifs à partir des principaux dossiers et archives du répertoire.
      • Option 2 : cliquez sur Créer des actifs à l'aide des archives et dossiers correspondant à ce filtre et tapez une valeur de filtrage. Le contenu d'un fichier texte comportant cette valeur dans son nom deviendra des actifs. Cette valeur peut comporter les caractères spéciaux suivants : "*" représente un nombre quelconque de caractères, "?" représente un caractère, et "**" représente la totalité du contenu d'une arborescence de répertoires. Tout fichier ou dossier contenant cette valeur dans son nom deviendra un actif. Tout dossier ou archive qui correspond au critère de filtrage deviendra des actifs.
    3. Cliquez sur Terminer.
    Règle de communauté -

    Si vous ajoutez une règle de communauté au répertoire racine, tous les dossiers ou archives enfant seront ajoutés à cette communauté.

    1. Dans la section Type de règle, sélectionnez Communauté et cliquez sur Suivant.
    2. Définissez la valeur de la règle en utilisant l'une des options suivantes :
      • Option 1 : cliquez sur Créer des communautés à l'aide de tous les dossiers et archives pour définir des communautés d'après tous les dossiers et archives contenus dans ce répertoire. Les communautés prennent le nom de ces dossiers ou archives.
      • Option 2 : cliquez sur Créer des communautés à l'aide des archives et dossiers correspondant à ce filtre et tapez une valeur de filtrage. Cette valeur peut comporter les caractères spéciaux suivants : "*" représente un nombre quelconque de caractères, "?" représente un caractère, et "**" représente la totalité du contenu d'une arborescence de répertoires. Tout fichier ou dossier contenant cette valeur dans son nom deviendra une communauté. Le contenu d'un fichier texte comportant cette valeur dans son nom deviendra la communauté de l'actif.
      • Option 3 : cliquez sur Indiquer une communauté dans laquelle tous les actifs seront placés, puis tapez le nom de la communauté à laquelle vous voulez que tous les actifs du répertoire appartiennent.
    3. Cliquez sur Terminer.
  3. Après avoir créé des règles pour le répertoire, continuez à en créer pour les fichiers et les dossiers qu'il contient. Utilisez le tableau suivant pour vous aider à créer d'autres règles.
    Option Description
    Règle d'artefact -

    Créez une règle d'artefact pour chaque fichier, dossier ou archive. Créez autant de règles d'artefacts que nécessaire pour atteindre le niveau de spécificité que vous souhaitez définir pour votre actif. Vous pouvez également définir un artefact d'URL.

    1. Dans la section Type de règle, sélectionnez Artefact et cliquez sur Suivant.
    2. Définissez la valeur de la règle en utilisant l'une des options suivantes :
      • Option 1 : cliquez sur Créer des artefacts à l'aide de tous les fichiers et dossiers pour créer des artefacts à partir de tous les fichiers et dossiers de l'actif.
      • Option 2 : cliquez sur Créer des artefacts à l'aide de fichiers et de dossiers correspondant à ce filtre et tapez une valeur de filtrage. Cette valeur peut comporter les caractères spéciaux suivants : "*" représente un nombre quelconque de caractères, "?" représente un caractère, et "**" représente la totalité du contenu d'une arborescence de répertoires. Tout fichier ou dossier contenant cette valeur dans son nom deviendra un artefact.
      • Option 3 : cliquez sur Indiquer un artefact d'URL qui sera ajouté à tous les actifs pour ajouter un artefact d'URL. Tapez un nom pour l'URL, puis l'URL que vous voulez ajouter comme artefact. Cet artefact prend le nom que vous indiquez.
    3. Cliquez sur Terminer.
    Règle de type d'actif -

    Vous pouvez fournir un type d'actif pour chaque actif que vous définissez dans le répertoire.

    1. Dans la section Type de règle, sélectionnez Type d'actif et cliquez sur Suivant.
    2. Définissez la valeur de la règle en utilisant l'une des options suivantes :
      • Option 1 : cliquez sur Définir le type d'actif à l'aide d'un fichier correspondant au filtre et tapez une valeur de filtrage. Le contenu d'un fichier texte comportant cette valeur dans son nom deviendra le type d'actif de l'actif. Cette valeur peut comporter les caractères spéciaux suivants : "*" représente un nombre quelconque de caractères, "?" représente un caractère, et "**" représente la totalité du contenu d'une arborescence de répertoires. Tout fichier ou dossier contenant cette valeur dans son nom deviendra un type d'actif.
      • Option 2 : cliquez sur Indiquer un type d'actif qui sera appliqué à tous les actifs, puis tapez le nom du type d'actif que vous voulez appliquer aux actifs du répertoire pour lequel vous définissez des règles.
    3. Cliquez sur Terminer.
    Règle d'attribut -

    Les attributs spécifient le type d'informations que les utilisateurs peuvent inclure lorsqu'ils soumettent un actif.

    1. Dans la section Type de règle, sélectionnez Attribut et cliquez sur Suivant.
    2. Cliquez sur Ajouter des attributs à l'aide d'un fichier correspondant au filtre et tapez une valeur de filtrage. Cette valeur peut comporter les caractères spéciaux suivants : "*" représente un nombre quelconque de caractères, "?" représente un caractère, et "**" représente la totalité du contenu d'une arborescence de répertoires. Tout fichier ou dossier contenant cette valeur dans son nom deviendra un attribut.

      Le contenu d'un fichier texte comportant cette valeur dans son nom deviendra les attributs de l'actif. Ce fichier texte doit contenir des données respectant la syntaxe suivante : MotClé1 =MotClé2, où MotClé1 est le nom de l'attribut et MotClé2 sa valeur.

    3. Cliquez sur Terminer.
    Règle de catégorie -

    Les schémas de catégories vous aident à organiser les actifs dans le référentiel afin de permettre aux utilisateurs de les trouver et de les réutiliser.

    Si vous souhaitez définir la classification d'un actif en utilisant plusieurs catégories, vous devez créer plusieurs règles de catégorie pour cet actif.

    1. Dans la section Type de règle, sélectionnez Catégorie et cliquez sur Suivant.
    2. Définissez la valeur de la règle en utilisant l'une des options suivantes :
      • Option 1 : cliquez sur Ajouter des catégories à l'aide d'un fichier correspondant au filtre et tapez une valeur de filtrage. Cette valeur peut comporter les caractères spéciaux suivants : "*" représente un nombre quelconque de caractères, "?" représente un caractère, et "**" représente la totalité du contenu d'une arborescence de répertoires.

        Tout fichier ou dossier contenant cette valeur dans son nom deviendra une catégorie. Le contenu d'un fichier texte comportant cette valeur dans son nom deviendra la catégorie de l'actif.

        Ce fichier texte doit contenir des données respectant la syntaxe suivante : Catégorie1/Catégorie2/Catégorie3.

        Par exemple, si Catégorie1 a la valeur Automobile, Catégorie2 a la valeur Modèle et Catégorie3 a la valeur Marques étrangères, la catégorisation complète de cet actif sera Automobile/Modèle/Marques étrangères.

      • Option 2 : cliquez sur Indiquer une catégorie qui sera appliquée à tous les actifs et tapez des valeurs dans les champs suivants :
        • Schéma : la catégorie de plus haut niveau
        • Catégorie : un enfant du schéma
        • Sous-catégories : les enfants de la catégorie
        Par exemple :
        • Schéma : Automobile
        • Catégorie : Modèle
        • Sous-catégories : Etrangères/Honda
    3. Cliquez sur Terminer.
    Règle de communauté -

    Si vous ajoutez une règle de communauté au répertoire racine, tous les dossiers ou archives enfant seront ajoutés à cette communauté.

    1. Dans la section Type de règle, sélectionnez Communauté et cliquez sur Suivant.
    2. Définissez la valeur de la règle en utilisant l'une des options suivantes :
      • Option 1 : cliquez sur Créer des communautés à l'aide de tous les dossiers et archives pour définir des communautés d'après tous les dossiers et archives contenus dans ce répertoire. Les communautés prennent le nom de ces dossiers ou archives.
      • Option 2 : cliquez sur Créer des communautés à l'aide des archives et dossiers correspondant à ce filtre et tapez une valeur de filtrage. Cette valeur peut comporter les caractères spéciaux suivants : "*" représente un nombre quelconque de caractères, "?" représente un caractère, et "**" représente la totalité du contenu d'une arborescence de répertoires. Tout fichier ou dossier contenant cette valeur dans son nom deviendra une communauté. Le contenu d'un fichier texte comportant cette valeur dans son nom deviendra la communauté de l'actif.
      • Option 3 : cliquez sur Indiquer une communauté dans laquelle tous les actifs seront placés, puis tapez le nom de la communauté à laquelle vous voulez que tous les actifs du répertoire appartiennent.
    3. Cliquez sur Terminer.
    Règle de description -

    Cette règle définit la description de l'actif.

    1. Dans la section Type de règle, sélectionnez Description et cliquez sur Suivant.
    2. Définissez la valeur de la règle en utilisant l'une des options suivantes :
      • Option 1 : sélectionnez Définissez la description à l'aide d'un fichier correspondant au filtre et tapez une valeur de filtrage. Le contenu de tout fichier contenant cette valeur deviendra la description de l'actif.
      • Option 2 : sélectionnez Indiquer une description qui sera appliquée à tous les actifs et tapez une description pour l'actif.
    3. Cliquez sur Terminer.
    Règle de nom -

    Cette règle définit le nom de l'actif.

    1. Dans la section Type de règle, sélectionnez Nom et cliquez sur Suivant.
    2. Définissez la valeur de la règle en utilisant l'une des options suivantes :
      • Option 1 : cliquez sur Définir le nom à l'aide d'un fichier correspondant au filtre et tapez une valeur de filtrage. Cette valeur peut comporter les caractères spéciaux suivants : "*" représente un nombre quelconque de caractères, "?" représente un caractère, et "**" représente la totalité du contenu d'une arborescence de répertoires. Le contenu d'un fichier texte comportant cette valeur dans son nom deviendra un nom pour l'actif.
      • Option 2 : cliquez sur Indiquer un nom qui sera appliqué à tous les actifs et tapez un nom pour l'actif.
    3. Cliquez sur Terminer.
    Règle de propriétaire -

    Cette règle définit les noms des propriétaires de l'actif. Si, pour un actif, vous spécifiez des propriétaires qui n'existent pas encore dans le référentiel, ils seront créés en tant qu'utilisateurs du référentiel.

    1. Dans la section Type de règle, sélectionnez Propriétaire et cliquez sur Suivant.
    2. Définissez la valeur de la règle en utilisant l'une des options suivantes :
      • Option 1 : cliquez sur Ajouter des propriétaires à l'aide d'un fichier correspondant à un filtre et tapez une valeur de filtrage. Cette valeur peut comporter les caractères spéciaux suivants : "*" représente un nombre quelconque de caractères, "?" représente un caractère, et "**" représente la totalité du contenu d'une arborescence de répertoires. Tout fichier ou dossier contenant cette valeur dans son nom deviendra un propriétaire. Le contenu de tout fichier répondant à ce critère de filtrage définira les propriétaires de l'actif. Vous devez désigner les propriétaires par leur identificateur unique, lequel est défini soit dans un répertoire d'utilisateurs du système de fichiers, soit dans un annuaire LDAP. Ce fichier doit contenir un seul identificateur unique par ligne.
      • Option 2 : cliquez sur Indiquer un utilisateur qui deviendra le propriétaire de tous les actifs et tapez un identificateur unique défini soit dans un répertoire d'utilisateurs du système de fichiers, soit dans un annuaire LDAP.
    3. Cliquez sur Terminer.
    Règle d'actif apparenté -

    Cette règle définit tous les actifs apparentés.

    1. Dans la section Type de règle, sélectionnez Actif apparenté et cliquez sur Suivant.
    2. Définissez la valeur de la règle en utilisant l'une des options suivantes :
      • Option 1 : cliquez sur Ajouter des actifs apparentés à l'aide d'un fichier correspondant à un filtre et tapez une valeur de filtrage. Cette valeur peut comporter les caractères spéciaux suivants : "*" représente un nombre quelconque de caractères, "?" représente un caractère, et "**" représente la totalité du contenu d'une arborescence de répertoires.

        Le contenu d'un fichier texte comportant cette valeur dans son nom deviendra un actif apparenté de l'actif. Ce fichier texte doit contenir des données respectant la syntaxe suivante : TypeRelation:{GUID}/Version. Par exemple, si TypeRelation est 'dépendant', GUID est 000–111–222 et Version est 1.0, les actifs apparentés ont une relation de dépendance vis-à-vis de l'actif pour lequel vous définissez des règles dans la section source de l'éditeur, ils portent l'identificateur unique 000–111–222, qui leur a été attribué par Rational Asset Manager, et ont la version 1.0.

      • Option 2 : cliquez sur Indiquer un type de relation et des actifs qui seront apparentés à tous les actifs et tapez des valeurs dans les champs suivants.
        • Type de relation : type de relation des actifs que vous apparentez à l'actif sur lequel vous travaillez dans la section source de l'éditeur de mise à jour par lots.
        • ID unique : identificateur global unique (GUID), ou identificateur unique de l'actif apparenté.
        • Version : version des actifs apparentés.
        Par exemple :
        • Type de relation : Dépendant
        • ID unique : 000-111-222
        • Version : 1.0
    3. Cliquez sur Terminer.
    Règle de description abrégée -

    Cette règle définit la description courte de l'actif.

    1. Dans la section Type de règle, sélectionnez Description abrégée et cliquez sur Suivant.
    2. Définissez la valeur de la règle en utilisant l'une des options suivantes :
      • Option 1 : cliquez sur Définir la description abrégée à l'aide d'un fichier correspondant au filtre et tapez une valeur de filtrage. Cette valeur peut comporter les caractères spéciaux suivants : "*" représente un nombre quelconque de caractères, "?" représente un caractère, et "**" représente la totalité du contenu d'une arborescence de répertoires. Tout fichier ou dossier contenant cette valeur dans son nom deviendra une description courte. Le contenu de tout fichier contenant cette valeur deviendra la description abrégée de l'actif.
      • Option 2 : cliquez sur Indiquer une description courte qui sera appliquée à tous les actifs et tapez une description abrégée pour l'actif.
    3. Cliquez sur Terminer.
    Règle de version -

    Cette règle définit la version de l'actif.

    1. Dans la section Type de règle, sélectionnez Version et cliquez sur Suivant.
    2. Définissez la valeur de la règle en utilisant l'une des options suivantes :
      • Option 1 : cliquez sur Définir la version à l'aide d'un fichier correspondant au filtre et tapez une valeur de filtrage. Cette valeur peut comporter les caractères spéciaux suivants : "*" représente un nombre quelconque de caractères, "?" représente un caractère, et "**" représente la totalité du contenu d'une arborescence de répertoires. Tout fichier ou dossier contenant cette valeur dans son nom deviendra la version. Le contenu de tout fichier contenant cette valeur deviendra la version de l'actif.
      • Option 2 : cliquez sur Indiquer une version qui sera appliquée à tous les actifs et tapez une version pour l'actif.
    3. Cliquez sur Terminer.

Que faire ensuite

Après avoir défini les règles s'appliquant au contenu et aux métadonnées des actifs, vous pouvez corriger les éventuels problèmes affectant les actifs, sélectionner le référentiel et mettre à jour les actifs dans le référentiel.

Vos commentaires