Créer des types d'actifs communautaires

Les types d'actifs communautaires sont similaires au types définis au niveau du référentiel, à ceci près qu'ils sont spécifiques à une communauté. Les administrateurs de référentiels créent des types d'actifs à l'échelle du référentiel et précisent dans leur définition s'ils sont visibles par toutes les communautés ou seulement par un ensemble spécifique de communautés.

Avant de commencer

Pour créer un type d'actif de communauté, vous devez être administrateur de référentiels ou de communautés.

Pourquoi et quand exécuter cette tâche

En savoir plus sur les types d'actifs :
Les utilisateurs et les administrateurs ont recours aux types d'actifs pour une multitude de raisons, dont :
  • s'aligner sur la structure interne de leur entreprise
  • permettre aux utilisateurs de filtrer une recherche par type d'actif.
  • placer une contrainte sur un actif. Par exemple, vous pouvez définir qu'un actif contienne un type de fichier spécifique en tant qu'artefact ou qu'il soit lié à un autre actif d'une certaine manière.
  • attribuer automatiquement des catégories à l'actif en fonction du contenu d'artefacts XML.
  • créer des règles qui permettent d'indexer les artefacts XML et de les rechercher à l'aide de mots clés.
  • consulter des statistiques indiquant combien il existe d'actifs de chaque type dans un référentiel
  • déclencher un processus de révision personnalisée qui est attribuée à des types d'actifs spécifiques dans une communauté.
  • attribuer des rôles de communauté à appliquer à des actifs d'un type spécifique.
Lors de la création d'un type d'actif, posez-vous les questions suivantes :
  • Qui utilisera l'actif ?
  • Comment l'actif sera-t-il utilisé ?
  • Quels artefacts l'actif doit-il inclure ?
  • Quelles informations descriptives l'actif doit-il inclure ?
  • Quelles informations seront nécessaires aux utilisateurs pour trouver et utiliser l'actif ?
  • Quels actifs sont liés à l'actif et quelles sont les relations ?
  • Les artefacts de l'actif incluront-ils du contenu XML ? Si oui, voulez-vous attribuer automatiquement des catégories en fonction de ce contenu XML ?

Pour créer un type d'actif similaire à un type existant, cliquez sur Dupliquer. Le type d'actif existant est alors dupliqué par cette action et vous pouvez en modifier le nom et les détails en cliquant sur les éléments appropriés.

Pour personnaliser un type d'actif de niveau référentiel existant pour votre communauté, ouvrez le type d'actif et sélectionnez Remplacer la configuration du type d'actif global. Le type d'actif au niveau du référentiel existant est remplacé par le nouveau type d'actif au niveau de la communauté uniquement pour cette communauté.

Important : Dans le référentiel, les types d'actifs sont présentés par ordre alphabétique. Lorsque vous créez des types d'actifs similaires, répondant aux besoins d'un domaine ou d'un département particulier, nommez-les en leur donnant le même préfixe afin qu'ils apparaissent ensemble dans la liste et soient plus facilement trouvés par les utilisateurs. Ainsi, pour les types d'actifs de services, vous pouvez créer les noms de types suivants :
  • Service
  • Conception de service
  • Modèle de service
  • Implémentation de service
  • Test de service
  • Résultats des tests de services

Procédure

Pour créer ou modifier un type d'actif :

  1. Connectez-vous à l'application Web d'.
  2. Cliquez sur Administration.
  3. Cliquez sur le nom de la communauté.
  4. Cliquez sur l'onglet Types d'actif.
  5. Sélectionnez un type d'actif à modifier ou créer un type d'actif :
    • Pour modifier un type d'actif existant, cliquez sur son nom. Si vous êtes dans l'incapacité de modifier un type d'actif existant, cela signifie que sa portée n'est pas limitée spécifiquement à votre communauté ; dans ce cas, demandez à votre administrateur de référentiels de faire le nécessaire.
    • Pour créer un type d'actif, cliquez sur Nouveau type d'actif.
  6. Décrivez le type d'actif :
    1. Dans la zone Nom, entrez un nom.
    2. Dans la zone Description, entrez une description explicite. Lorsqu'un utilisateur soumettra un nouvel actif en utilisant l'assistant Soumettre un actif, il verra cette description en sélectionnant ce type d'actif et en cliquant sur l'icône d'aide de la zone Type, sur la page Décrire.
  7. Si vous modifiez un type d'actif disponible pour plusieurs communautés, afin de personnaliser davantage le type d'actif pour cette communauté, vous pouvez cocher la case Remplacer la configuration du type d'actif global. Le type d'actif au niveau du référentiel existant est remplacé par le nouveau type d'actif au niveau de la communauté uniquement pour cette communauté.
  8. Facultatif : Définissez le schéma de catégorie disponible du type d'actif. Vous pouvez autoriser tout ou une sélection limitée des catégories disponibles dans le référentiel.
    1. Cliquez sur l'onglet Définition de la portée .
    2. Pour autoriser l'application à l'actif de toutes les catégories, dans la section Définition de la portée, sélectionnez Utiliser tous les schémas de catégories.
    3. Pour n'autoriser qu'une sous-section des schémas de catégories, sélectionnez Utiliser uniquement les schémas de catégories sélectionnés, puis sélectionnez un ou plusieurs schémas.
  9. Facultatif : Définissez une contrainte d'artefact en spécifiant une plage quantifiable d'artefacts obligatoires et conformes à une extension, un format ou un libellé spécifique.
    1. Cliquez sur l'onglet Contraintes.
    2. Dans la section Contraintes d'artefact, cliquez sur Nouvelle contrainte d'artefact.
    3. Sélectionnez la plage d'artefacts requis, choisissez le type de restriction et entrez une valeur pour le type d'artefact dont la présence est imposée. Par exemple, si vous créez un actif d'un type du nom de Présentation, vous pouvez spécifier que l'actif contienne au moins un artefact avec une extension .ppt. Le format est le contexte du fichier ; par exemple, une présentation ou un modèle de processus. L'extension de fichier est le type de fichier ; par exemple, .txt, .xml ou .ppt. Le format est défini automatiquement en fonction du type MIME du fichier.
  10. Facultatif : Définissez des contraintes de relation.
    1. Cliquez sur l'onglet Contraintes.
    2. Dans la section Contraintes de relations, cliquez sur Nouvelle contrainte de relation.
    3. Spécifiez une plage quantifiable, puis sélectionnez le type d'actif qui doit se conformer à la relation que vous choisissez.
    4. Si vous souhaitez limiter les actifs de ce type pour que seules les contraintes de relation définies ici soient utilisées, sélectionnez l'option Autoriser uniquement ces relations. Lorsque des utilisateurs soumettent ou modifient des actifs de ce type, ils ne peuvent pas sélectionner d'autres relations.
  11. Facultatif : Ajoutez des attributs d'actif pour permettre aux utilisateurs d'entrer des informations supplémentaires ou de choisir des valeurs prédéfinies sur l'actif. Ces attributs sont classés en deux colonnes qui sont visibles sur la page Détails généraux d'un actif. Les attributs qui sont déplacés dans la section Attributs masqués ne sont pas visibles sur la page Détails généraux de l'actif.
    1. Cliquez sur l'onglet Contraintes.
    2. Ajoutez des contraintes d'attribut à chaque section. Les sections sont divisées en colonnes : Colonne 1, Colonne 2 et Attributs masqués. Vous pouvez organiser les attributs en deux colonnes pour regrouper les attributs dans la page Détails généraux d'un actif. Les attributs contenus dans la section Attributs masqués ne sont pas visibles dans la page Détails généraux des actifs. Pour ajouter une contrainte d'attribut :
      1. Déplacez le curseur sur le nom de la section et cliquez sur l'icône Insérer.
      2. Cliquez sur Ajouter des contraintes d'attribut.
      3. Entrez un nom dans le filtre et sélectionnez l'attribut ou maintenez la touche CTRL enfoncée pour sélectionner plusieurs attributs et cliquez sur Ajouter et fermer.
    3. Choisissez les contraintes d'attribut obligatoires.
      1. Déplacez le curseur sur le nom de l'attribut et cliquez sur l'icône Editer. Si l'icône Editer ne s'affiche pas, l'attribut est déjà obligatoire et ne peut pas être modifié.
      2. Cochez la case L'attribut est obligatoire.
      3. Cliquez sur OK.
    4. Créez des groupes dans chaque section.
      1. Déplacez le curseur sur chaque section et cliquez sur l'icône Insérer.
      2. Cliquez sur Ajouter un groupe d'attributs.
      3. Entrez un nom pour le groupe et cliquez sur Ajouter et fermer.
    5. Réorganiser les attributs dans un ordre logique et des groupements pour les utilisateurs d'actifs. Pour déplacer un attribut dans une section ou un groupe différent, cliquez sur l'attribut, maintenez le bouton de la souris enfoncé et déplacez le curseur à l'emplacement souhaité, puis relâchez le bouton pour libérer l'attribut.
  12. Facultatif : Définissez une expression XPATH et une règle qui appliquera automatiquement des catégories à un actif en fonction du contenu des artefacts XML que vous avez téléchargés vers l'actif.
    1. Cliquez sur l'onglet Catégorisation automatique.
    2. Cliquez sur Nouvelle catégorisation d'artefacts XML.
    3. Pour remplir la section Mappages d'espace de noms et tester votre expression XPATH, téléchargez un exemple de document XML en le recherchant dans votre système de fichiers local et en cliquant sur Télécharger l'exemple. Si vous téléchargez plusieurs documents, seul le plus récent peut être utilisé. Le fichier d'exemple peut être réutilisé pour plusieurs actifs jusqu'à ce que vous fermiez votre session.
    4. Pour ajouter des types de fichiers d'artefacts avec du contenu XML, cliquez sur Ajouter un type de fichier, entrez une extension, puis cliquez sur OK.
    5. Cliquez sur Ajouter un mappage d'espace de noms, puis entrez le préfixe et l'URI des espaces de noms XML. Si vous avez téléchargé un fichier dans la section Exemple de fichier XML, vous pouvez cliquer sur Ajouter à partir de l'exemple pour en extraire toutes les informations d'espaces de noms. Vous pouvez modifier ou supprimer tous les mappages de la liste. L'espace de noms par défaut est signalé par le préfixe "default." Vous pouvez modifier ce mappage pour utiliser le nom effectif de l'élément dans votre expression XPATH ou vous pouvez utiliser "default" à la place de ce nom.
    6. Pour sélectionner une ou plusieurs catégories à appliquer automatiquement aux actifs de ce type s'ils contiennent des artefacts qui correspondent à l'expression XPATH que vous fournissez, cliquez sur Ajouter une catégorie et sélectionnez une ou plusieurs catégories dans la fenêtre Sélectionner des catégorisations. Cliquez sur Supprimer pour retirer une catégorie.
    7. Dans la zone Expression XPATH, entrez l'expression XPATH à utiliser pour effectuer des recherches dans les documents XML. Par exemple : /wsdl:definitions/@targetNameSpace
    8. Pour évaluer l'expression XPATH par rapport à votre fichier XML d'exemple, cliquez sur Tester l'exemple. Vous pouvez afficher les résultats de l'évaluation.
    9. Dans la zone Contient, entrez la valeur à laquelle l'expression XPATH doit correspondre. Par exemple : exemple.com
    Lorsque ce type d'actif est soumis, si les résultats de l'expression XPATH correspondent à la valeur de la zone Contient, les catégories que vous avez spécifiées s'appliquent à l'actif.
  13. Facultatif : Définissez la manière dont le contenu des artefacts XML est indexé et affiché dans les résultats de la recherche.
    1. Cliquez sur l'onglet Règles d'indexation de la recherche.
    2. Cliquez sur Nouvelle règle.
    3. Sélectionnez Règle d'artefact XML et cliquez sur OK. La page Règle d'indexation XML s'affiche.
    4. Dans la zone Nom, entrez le nom de la règle.
    5. Dans la zone Description, entrez un descriptif de la règle.
    6. Dans la zone Extensions de fichiers, entrez la liste des extensions des fichiers à indexer. Séparez les extensions par un espace, Par exemple : wsdl xml dita xsd
    7. Pour définir les éléments XML à indexer, dans la section Configuration de règle, cliquez sur Ajouter un élément.
    8. Dans la zone Elément, entrez l'élément XML que vous voulez indexer. Sélectionnez Indexer tous les attributs si vous voulez également indexer le contenu de tous les attributs de l'élément.
    9. Cliquez sur OK.
    10. Facultatif : Pour définir un ou plusieurs attributs spécifiques de l'élément à indexer, cliquez sur Ajouter un attribut, entrez le nom de l'attribut puis cliquez sur OK. Répétez l'opération pour chacun des attributs que vous voulez indexer.
    11. Cliquez sur OK. La page Type d'actif s'ouvre à nouveau. Cliquez sur le nom de la règle pour l'éditer ou cliquez sur Supprimer pour la supprimer.
  14. Cliquez sur OK pour enregistrer le type d'actif.

Résultats

Les types d'actifs personnalisés pour une communauté particulière se distinguent par une icône assortie de trois petits personnages.
Type d'actif communautaire reconnaissable aux trois personnages.

Commentaires