Configurer le fichier mapping.xml

Le fichier de mappage mapping.xml contient le mappage entre des types d'actif Rational Asset Manager et des objets de modèle de gestion WSRR.

L'utilisation du fichier mapping.xml et ses mises à jour permettent d'assurer la synchronisation entre des éléments de Rational Asset Manager et des éléments WSRR.

Plusieurs types de mappages sont définis dans le fichier, tels que les types d'actifs, de relations et d'attributs. Le fichier de mappage contient également des déclencheurs, qui sont des événements appelés lors d'opérations d'enregistrement, d'entrées d'état ou d'actions manuelles configurées pour une stratégie.

Une stratégie SOA est fournie avec Rational Asset Manager. Elle lit le fichier de mappage et exécute les déclencheurs définis pour l'action manuelle, l'entrée d'état ou l'événement d'enregistrement. La stratégie SOA est configuré sur chaque état du cycle de vie SOA et dispose d'une propriété de configuration de connexion WSRR à associer à une connexion WSRR spécifique.

Le fichier de mappage contient deux éléments primaires, des mappages et des déclencheurs :

Mappages

Les éléments de mappage mappent chaque type d'actif à un objet WSRR.
  • id – ID de l'élément de mappage. Chaque élément de mappage a un ID unique.
  • wsrrType – Objet de modèle de gestion WSRR
  • ramType – Type d'actif RAM
  • extends – L'élément de mappage prend en charge l'héritage. La valeur de l'agrandissement correspond à l'ID d'un autre élément de mappage étendu.
  • ramCategory – Si ramCategory est défini, l'objet de modèle de gestion WSRR est mappé vers ramType, qui est classé comme ramCategory.
<Mapping id="SPEC" wsrrType="&GEP63;SchemaSpecification" ramType="Specification" extends="ASSET" ramCategory="Software Development/Kind/Schema">
   </Mapping>
Les éléments de mappage mappent des types d'actif, des relations et des attributs :
  • Attribut
    • wsrrName – Nom de l'attribut WSRR
    • ramName – Nom de l'attribut RAM
    • type – Type de l'attribut
    <Attribute wsrrName="gep63_versionAvailabilityDate" ramName="Availability Date" type="date"/>
  • Relation
    • Mappage de la relation RAM vers la relation WSRR :
      • wsrrName – Nom de la relation WSRR
      • ramName – Nom de la relation RAM
      <Relationship wsrrName="gep63_interfaceSpecifications" ramName="specification"/>
    • Mappage de l'intitulé RAM vers la relation WSRR :
      • wsrrName – Nom de la relation WSRR
      • ramArtifactLabel – Intitulé de l'artefact RAM
      <Relationship wsrrName="gep63_charter" ramArtifactLabel="Charter"/>

Déclencheurs

Les déclencheurs sont des événements appelés lors d'opérations d'enregistrement, d'entrées d'état ou d'actions manuelles configurées pour une stratégie. Par exemple :

<Trigger source="RAM" type="Release" state="Identified">
<Rule ruleType="CATEGORIZATION" target="RAM" categoryValue="Software Development/Kind/Process" />
<Action target="WSRR" action="create"/> 
</Trigger>
  • Déclencheur Action manuelle – les déclencheurs qui sont appelés lorsqu'une tentative est effectuée pour modifier l'état de l'actif. Par exemple, le déclencheur suivant est appelé pour le type d'actif “Business Solution” avec l'état ”Proposed” et la transition (ou action) ”Revise”.
    • <Trigger source="RAM" type="Business Solution" state="Proposed" transition="Revise">
      </Trigger>
  • Déclencheur Enregistrer ou Entrée de l'état – il s'agit des déclencheurs qui sont appelés lors d'un enregistrement ou d'une entrée d'un actif dans un état spécifique. Par exemple, le déclencheur suivant est appelé pour un actif de type Business Solution lorsque l'actif est enregistré dans l'état “Rejeté” ou lorsque l'actif prend l'état “Rejeté” :
    • <Trigger source="RAM" type="Business Solution" state="Rejected"> 
      </Trigger> 
Les déclencheurs contiennent deux éléments enfants, des règles et des actions :
  • Règle : Une règle spécifie la condition ou l'ensemble de conditions devant être remplies avant que les actions définies dans les déclencheurs puissent être exécutées.

    Une règle peut être une simple ou complexe.

    Exemple de règle simple :
    <Rule ruleType="CATEGORIZATION" target="RAM" categoryValue="Software Development/Kind/Process" />

    Une règle complexe peut être créée à l'aide des opérateurs “AND” ou “OR” des règles simples.

    Exemple de règle complexe :
    <Rule operator="OR"> <Rule ruleType="CATEGORIZATION" target="RAM" categoryValue="Software Development/Kind/Web Application" /> 
    <Rule ruleType="CATEGORIZATION" target="RAM" categoryValue="Software Development/Kind/Service" />
     <Rule ruleType="CATEGORIZATION" target="RAM" categoryValue="Software Development/Kind/Process" /> 
    </Rule>
    Les différents types de règles simples pris en charge sont les suivants :
    • CATEGORIZATION : Pour spécifier une règle de catégorisation, définissez les attributs suivants :
      • ruleType = "CATEGORIZATION"
      • target = "RAM"
      • categoryValue - Chemin de la catégorie. Par exemple :
        categoryValue ="Software Development/Kind/Web Application"
      Exemple de règle de catégorisation :
      <Rule ruleType="CATEGORIZATION" target="RAM" categoryValue="Software Development/Kind/Web Application" />
    • ARTIFACT : Pour spécifier une règle ARTIFACT, définissez les attributs suivants :
      • ruleType = "ARTIFACT"
      • target = "RAM"
      • countType – Peut être l'un des types suivants :
        • EXACTLY
        • ATMOST
        • ATLEAST
      • count – Valeur de type entier pour le nombre d'occurrences d'artefact.
      • artifactMatchType – Peut être l'un des types suivants :
        • FORMAT_OF – Format ou type d'artefact.
        • LABEL_OF – Artefact contenant un intitulé.
        • FILE_EXTENSION_OF – Extension de fichier de l'artefact.
        • FULL_FILE_NAME_OF – Nom de fichier entier de l'artefact.
      Exemple de règle d'artefact :
      <Rule ruleType="ARTIFACT" target="RAM" countType="EXACTLY" count="1" artifactMatchType="LABEL_OF" artifactMatchTypeValue="Charter" />
    • RELATIONSHIP : Pour spécifier une règle RELATIONSHIP, définissez les attributs suivants :
      • ruleType = "RELATIONSHIP"
      • target = "RAM"
      • countType – Peut être l'un des types suivants :
        • EXACTLY
        • ATMOST
        • ATLEAST
      • count – Valeur de type entier pour le nombre d'occurrences de la relation.
      • relatedAssetType – Type de l'actif associé, par exemple :
        relatedAssetType="Implementation"
      • relationshipName – Nom de la relation, par exemple :
        relationshipName="implementation"
      Exemple d'une règle de relation :
          <Rule target="RAM" ruleType="RELATIONSHIP" countType="ATLEAST" count="1" relatedAssetType="Implementation" relationshipName="implementation"   />
    • ATTRIBUTE
      • target = "RAM"
      • ruleType = "ATTRIBUTE"
      • attributeName – Nom de l'attribut.
      • attributeValue – Valeur de l'attribut.
      Exemple d'une règle d'actif :
      <Rule target="RAM" ruleType="ATTRIBUTE" attributeName="Custom Attribute" attributeValue="Value 1" />
    • WSRR_STATE – Etat de l'actif WSRR.
      • ruleType = "WSRR_STATE"
      • target = "WSRR"
      • state = Etat de l'actif WSRR.
      Exemple d'une règle d'état WSRR :
      <Rule ruleType="WSRR_STATE" target="WSRR" state="&GEPLifecycle;PlanReview"/>
  • Action : Des actions sont exécutées à l'appel du déclencheur si les règles sont valides. Il existe trois types d'actions prises en charge par le fichier de configuration :
    • Créer ou mettre à jour un objet WSRR
      • target="WSRR"
      • action – Les valeurs possibles sont les suivantes :
        • create – Crée l'objet WSRR. S'il existe déjà, l'objet WSRR est mis à jour.
        • update – Met à jour l'objet WSRR. Aucun objet n'est créé s'il n'existe pas d'objet WSRR correspondant.
      Exemple :
       <Action target="WSRR" action="create"/>
    • Transition d'un actif WSRR
      • target = "WSRR"
      • transition - Action de transition à exécuter sur l'objet WSRR.
      • state – Etat final de l'objet WSRR. Si l'objet est déjà passé par une phase de transition vers l'état final, la transition n'est pas exécutée.
      Exemple :
       <Action target="WSRR" 
      transition="&GEPLifecycle;ProposeCharter" 
      state="&GEPLifecycle;CharterReview"/>
    • Créer un actif RAM
      • target = "RAM"
      • action = "create"
      • type – Type d'actif RAM à créer.
      • relationshipName – Nom de la relation à associer à l'actif nouvellement créé et à l'actif.
      Exemple :
       <Action target="RAM" action="create" type="Release" relationshipName="release" />

Commentaires