Configurar el archivo mapping.xml

El archivo de correlaciones mapping.xml contiene correlaciones entre tipos de activo de Rational Asset Manager y objetos de modelo empresarial de WDRR.

Utilice el archivo mapping.xml y realice actualizaciones de este archivo para garantizar la sincronización entre elementos de Rational Asset Manager y elementos de WSRR.

Hay varios tipos de correlaciones definidas en el archivo, por ejemplo para tipos de activos, relaciones y atributos. El archivo de correlaciones también contiene desencadenantes, que son sucesos que se invocan durante operaciones de guardar, entradas de estado o acciones manuales que se han configurado para una política.

Hay una política SOA que se proporciona con Rational Asset Manager. Esta política lee el archivo de correlaciones y ejecuta los desencadenantes definidos para la acción manual, la entrada de estado o el suceso de guardar. La política de SOA se configura en cada estado del ciclo de vida de SOA y tiene una propiedad de configuración de conexión WSRR para asociar con una conexión WSRR determinada.

El archivo de correlaciones contiene dos elementos principales, correlaciones y desencadenantes:

Correlaciones

Los elementos de correlación correlacionan cada tipo de activo con un objeto de WSRR.
  • id – ID del elemento de correlación. Cada elemento tiene un ID exclusivo.
  • wsrrType – Objeto del modelo empresarial de WSRR
  • ramType – Tipo de activo de RAM
  • extends – El elemento de correlación soporta la herencia. El valor de extends es el identificador de otro elemento de correlación que se está ampliando.
  • ramCategory – Si se define ramCategory, el objeto de modelo empresarial de WSRR se correlacionará con ramType que se clasificará como ramCategory.
<Mapping id="SPEC" wsrrType="&GEP63;SchemaSpecification" ramType="Specification" extends="ASSET" ramCategory="Software Development/Kind/Schema">
   </Mapping>
Los elementos de correlación correlacionan tipos de activo, relaciones y atributos:
  • Atributo
    • wsrrName – Nombre de atributo de WSRR
    • ramName – Nombre de atributo de RAM
    • type – Tipo de atributo
    <Attribute wsrrName="gep63_versionAvailabilityDate" ramName="Availability Date" type="date"/>
  • Relación
    • Correlacionar relación de RAM con relación de WSRR:
      • wsrrName – Nombre de relación de WSRR
      • ramName – Nombre de relación de RAM
      <Relationship wsrrName="gep63_interfaceSpecifications" ramName="specification"/>
    • Correlacionar etiqueta de RAM con relación de WSRR:
      • wsrrName – Nombre de relación de WSRR
      • ramArtifactLabel – Etiqueta de artefacto de RAM
      <Relationship wsrrName="gep63_charter" ramArtifactLabel="Charter"/>

Desencadenantes

Los desencadenantes son sucesos que se invocan durante las operaciones de guardado, entrada de estado o acciones manuales que haya configurado para una política. Por ejemplo:

<Trigger source="RAM" type="Release" state="Identified">
<Rule ruleType="CATEGORIZATION" target="RAM" categoryValue="Software Development/Kind/Process" />
<Action target="WSRR" action="create"/> 
</Trigger>
  • Desencadenante de acción manual: este desencadenante se invoca cuando se intenta cambiar el estado del activo. Por ejemplo, el desencadenante siguiente se invoca para el tipo de activo “Business Solution” en el estado ”Proposed” y la transición (o acción) es ”Revise.”
    • <Trigger source="RAM" type="Business Solution" state="Proposed" transition="Revise">
      </Trigger>
  • Desencadenante de guardar o de entrada de estado: este desencadenante se invoca cuando se guarda un activo en un estado determinado o cuando el activo entra por primera vez en un estado determinado. Por ejemplo, el desencadenante siguiente se invoca para un activo de tipo Business Solution cuando el activo se guarda con el estado “Rejected” o el activo entra en el estado “Rejected”:
    • <Trigger source="RAM" type="Business Solution" state="Rejected"> 
      </Trigger> 
Los desencadenantes contiene dos elementos hijo, reglas y acciones:
  • Regla: una regla especifica la condición o el conjunto de condiciones que se deberían cumplir para poder ejecutar las acciones definidas en los desencadenantes.

    Una regla puede ser simple o compleja.

    Ejemplo de regla simple:
    <Rule ruleType="CATEGORIZATION" target="RAM" categoryValue="Software Development/Kind/Process" />

    Puede crear una regla compleja añadiendo operadores “AND” u “OR” a reglas simples.

    Ejemplo de regla compleja:
    <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>
    Están permitidos los tipos siguientes de reglas simples:
    • CATEGORIZATION: para especificar una regla de categorización, establezca los siguientes atributos:
      • ruleType = "CATEGORIZATION"
      • target = "RAM"
      • categoryValue - Vía de acceso de la categoría. Por ejemplo:
        categoryValue ="Software Development/Kind/Web Application"
      Ejemplo de regla de categorización:
      <Rule ruleType="CATEGORIZATION" target="RAM" categoryValue="Software Development/Kind/Web Application" />
    • ARTIFACT: para especificar una regla de artefacto, defina los atributos siguientes:
      • ruleType = "ARTIFACT"
      • target = "RAM"
      • countType – Puede ser uno de los siguientes tipos:
        • EXACTLY
        • ATMOST
        • ATLEAST
      • count – Valor entero referente al número de apariciones del artefacto.
      • artifactMatchType – Puede ser uno de los siguientes tipos:
        • FORMAT_OF – Formato o tipo de artefacto.
        • LABEL_OF – Etiqueta de artefacto.
        • FILE_EXTENSION_OF – Extensión de archivo del artefacto.
        • FULL_FILE_NAME_OF – Nombre de archivo completo del artefacto.
      Ejemplo de una regla de artefacto:
      <Rule ruleType="ARTIFACT" target="RAM" countType="EXACTLY" count="1" artifactMatchType="LABEL_OF" artifactMatchTypeValue="Charter" />
    • RELATIONSHIP: para especificar una regla de relación, defina los atributos siguientes:
      • ruleType = "RELATIONSHIP"
      • target = "RAM"
      • countType – Puede ser uno de los tipos siguientes:
        • EXACTLY
        • ATMOST
        • ATLEAST
      • count – Valor entero del número de apariciones de la relación.
      • relatedAssetType – Tipo de activo del activo relacionado, por ejemplo:
        relatedAssetType="Implementation"
      • relationshipName – Nombre de la relación, por ejemplo:
        relationshipName="implementation"
      Ejemplo de regla de relación:
          <Rule target="RAM" ruleType="RELATIONSHIP" countType="ATLEAST" count="1" relatedAssetType="Implementation" relationshipName="implementation"   />
    • ATTRIBUTE
      • target = "RAM"
      • ruleType = "ATTRIBUTE"
      • attributeName – Nombre del atributo.
      • attributeValue – Valor del artefacto.
      Ejemplo de regla de activo:
      <Rule target="RAM" ruleType="ATTRIBUTE" attributeName="Custom Attribute" attributeValue="Value 1" />
    • WSRR_STATE – Estado del activo de WSRR.
      • ruleType = "WSRR_STATE"
      • target = "WSRR"
      • state = Estado del activo de WSRR.
      Ejemplo de una regla de estado de WSRR:
      <Rule ruleType="WSRR_STATE" target="WSRR" state="&GEPLifecycle;PlanReview"/>
  • Acción: las acciones se realizan cuando se invoca el desencadenante en caso de que las reglas sean válidas. El archivo de configuración puede contener tres tipos de acciones:
    • Crear o actualizar un objeto de WSRR
      • target="WSRR"
      • action – Los valores posibles son:
        • create – Crea el objeto de WSRR. Si el objeto ya existe, lo actualiza.
        • update – Actualiza el objeto de WSRR. No crea ninguno si no hay ningún objeto de WSRR correspondiente.
      Ejemplo:
       <Action target="WSRR" action="create"/>
    • Cambiar el estado de un activo de WSRR
      • target = "WSRR"
      • transition - La acción de transición se puede realizar en el objeto de WSRR.
      • state – Estado final del objeto de WSRR. Si el objeto ya se ha cambiado al estado final, no se realiza la transición.
      Ejemplo:
       <Action target="WSRR" 
      transition="&GEPLifecycle;ProposeCharter" 
      state="&GEPLifecycle;CharterReview"/>
    • Crear un activo de RAM
      • target = "RAM"
      • action = "create"
      • type – Tipo de activo de RAM que se creará.
      • relationshipName – Nombre de relación que se relacionará con el activo creado recientemente y con el activo.
      Ejemplo:
       <Action target="RAM" action="create" type="Release" relationshipName="release" />

Comentarios