Configurando o Arquivo mapping.xml

O arquivo de mapeamento mapping.xml contém o mapeamento entre os tipos de recurso do Rational Asset Manager e os objetos de modelo de negócios do WSRR.

Use o arquivo mapping.xml e faça as atualizações nele para assegurar a sincronização entre os elementos no Rational Asset Manager e no WSRR.

Há vários tipos de mapeamento definidos no arquivo, como tipos de recurso, relacionamentos e atributos. O arquivo de mapeamento também contém acionadores, que são eventos que são chamados durante as operações de salvamento, entrada de estado ou ações manuais configuradas para uma política.

Há uma política SOA que é fornecida com o Rational Asset Manager. Ela lê o arquivo de mapeamento e executa os acionadores definidos para a ação manual, entrada de estado ou evento de salvamento. A política SOA é configurada em cada estado do ciclo de vida SOA e possui uma propriedade de configuração de conexão do WSRR para ser associada a uma conexão WSRR específica.

O arquivo de mapeamento contém dois elementos, mapeamento e acionadores principais.

Mapeamentos

Os elementos de mapeamento mapeiam cada tipo de recurso para um objeto do WSRR.
  • id – O ID do elemento de mapeamento. Cada elemento de mapeamento possui um ID exclusivo.
  • wsrrType – objeto de modelo de negócios WSRR
  • ramType – Tipo de Recurso RAM
  • extends – O elemento de mapeamento suporta herança. O valor das extensões é o ID do outro elemento de mapeamento que está sendo estendido.
  • ramCategory – se ramCategory for definido, o objeto de modelo de negócios WSRR será mapeado para o ramType que será classificado como ramCategory.
<Mapping id="SPEC"
wsrrType="&GEP63;SchemaSpecification" ramType="Specification"
extends="ASSET" ramCategory="Software Development/Kind/Schema">
   </Mapping>
Os elementos de mapeamento mapeiam tipos de recurso, relacionamentos e atributos:
  • Atributo
    • wsrrName – nome do atributo WSRR
    • ramName – nome do atributo RAM
    • type – tipo de atributo
    <Attribute
    wsrrName="gep63_versionAvailabilityDate" ramName="Availability Date"
    type="date"/>
  • Relacionamento
    • Mapeie o relacionamento RAM para o relacionamento WSRR:
      • wsrrName – nome do relacionamento WSRR
      • ramName – nome do relacionamento RAM
      <Relationship wsrrName="gep63_interfaceSpecifications"
      ramName="specification"/>
    • Mapeie o rótulo RAM para o relacionamento WSRR:
      • wsrrName – nome do relacionamento WSRR
      • ramArtifactLabel – Rótulo do artefato RAM
      <Relationship wsrrName="gep63_charter"
      ramArtifactLabel="Charter"/>

Acionadores

Os acionadores são eventos que são chamados durante as operações de salvamento, entrada de estado ou ações manuais configuradas para uma política. Por exemplo:

<Trigger source="RAM" type="Release" state="Identified">
<Rule ruleType="CATEGORIZATION" target="RAM"
categoryValue="Software Development/Kind/Process" />
<Action target="WSRR" action="create"/> 
</Trigger>
  • Acionador de ação manual – os acionadores que são chamados quando é executada uma tentativa de transição do estado do recurso. Por exemplo, o seguinte acionador é chamado para o tipo de recurso “Solução de Negócios” no estado ”Proposto” e a transição (ou a ação) é ”Revisar.”
    • <Trigger source="RAM" type="Business Solution"
      state="Proposed" transition="Revise">
      </Trigger>
  • Acionador de entrada de salvamento ou de estado – Estes são os acionadores que são chamados quando um recurso é salvo em um estado específico ou quando ele entra pela primeira vez em um estado específico. Por exemplo, o seguinte acionador é chamado para um tipo de recurso Solução de Negócios quando um dos recursos é salvo no estado “Rejeitado” ou quando o recurso entra no estado “Rejeitado”:
    • <Trigger source="RAM" type="Business Solution"
      state="Rejected"> 
      </Trigger> 
Os acionadores contêm dois elementos filhos, regras e ações:
  • Regra: Uma regra especifica a condição ou o conjunto de condições que devem ser atendidas antes que as ações definidas nos acionadores possam ser executadas.

    Uma regra pode ser uma regra simples ou uma regra complexa.

    Exemplo de Regra Simples:
    <Rule
    ruleType="CATEGORIZATION" target="RAM" categoryValue="Software
    Development/Kind/Process" />

    Uma regra complexa pode ser criada usando os operadores “AND” ou “OR” para as Regras Simples.

    Exemplo de Regra Complexa:
    <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>
    Os tipos diferentes de regras simples suportadas são:
    • CATEGORIZATION: Para especificar uma regra de categorização, configure os seguintes atributos:
      • ruleType = "CATEGORIZATION"
      • target = "RAM"
      • categoryValue - Caminho para a categoria. Por exemplo:
        categoryValue ="Software Development/Kind/Web Application"
      Exemplo de uma regra de categorização:
      <Rule
      ruleType="CATEGORIZATION" target="RAM" categoryValue="Software
      Development/Kind/Web Application" />
    • ARTIFACT: Para especificar a regra ARTIFACT, configure os seguintes atributos:
      • ruleType = "ARTIFACT"
      • target = "RAM"
      • countType – Pode ser um dos seguintes tipos:
        • EXACTLY
        • ATMOST
        • ATLEAST
      • count – Valor de número inteiro para o número de ocorrências do Artefato.
      • artifactMatchType – Pode ser um dos seguintes tipos:
        • FORMAT_OF – Formato ou tipo de artefato.
        • LABEL_OF – Artefato que contém rótulo.
        • FILE_EXTENSION_OF – Extensão do arquivo do artefato.
        • FULL_FILE_NAME_OF – Nome completo do arquivo do artefato.
      Exemplo de uma regra de artefato:
      <Rule
      ruleType="ARTIFACT" target="RAM" countType="EXACTLY" count="1"
      artifactMatchType="LABEL_OF" artifactMatchTypeValue="Charter" />
    • RELATIONSHIP: Para especificar uma regra RELATIONSHIP, configure os seguintes atributos:
      • ruleType = "RELATIONSHIP"
      • target = "RAM"
      • countType – Pode ser um dos seguintes tipos:
        • EXACTLY
        • ATMOST
        • ATLEAST
      • count – Valor de número inteiro para o número de ocorrências do relacionamento.
      • relatedAssetType – Tipo de recurso do recurso relacionado, como por exemplo:
        relatedAssetType="Implementation"
      • relationshipName – Nome do relacionamento, como por exemplo:
        relationshipName="implementation"
      Exemplo de uma regra de relacionamento:
          <Rule target="RAM"
      ruleType="RELATIONSHIP" countType="ATLEAST" count="1"
      relatedAssetType="Implementation" relationshipName="implementation"
      />
    • ATTRIBUTE
      • target = "RAM"
      • ruleType = "ATTRIBUTE"
      • attributeName – Nome do atributo.
      • attributeValue – Valor do atributo.
      Exemplo de uma regra de recurso:
      <Rule target="RAM" ruleType="ATTRIBUTE"
      attributeName="Custom Attribute" attributeValue="Value 1" />
    • WSRR_STATE – Estado do Recurso WSRR.
      • ruleType = "WSRR_STATE"
      • target = "WSRR"
      • state = Estado do recurso do WSRR.
      Exemplo de uma regra de estado WSRR:
      <Rule ruleType="WSRR_STATE"
      target="WSRR" state="&GEPLifecycle;PlanReview"/>
  • Action: As ações são executadas na chamada do acionador se as regras forem válidas. Há três tipos de ações suportadas pelo arquivo de configuração:
    • Criar ou atualizar um objeto do WSRR
      • target="WSRR"
      • action – Os valores possíveis são:
        • create – Cria o objeto do WSRR. Se ele já existir, ele atualiza o objeto do WSRR.
        • update – Atualiza o objeto do WSRR. Um não será criado se nenhum objeto do WSRR correspondente existir.
      Exemplo:
       <Action target="WSRR" action="create"/>
    • Transição de um recurso do WSRR
      • target = "WSRR"
      • transition - Ação de transição a ser executada no objeto do WSRR.
      • state – Estado final do objeto do WSRR. Se o objeto já transitou para o estado final, ele não executará a transição.
      Exemplo:
       <Action target="WSRR" 
      transition="&GEPLifecycle;ProposeCharter" 
      state="&GEPLifecycle;CharterReview"/>
    • Criar um recurso do RAM
      • target = "RAM"
      • action = "create"
      • type – Tipo de recurso do RAM a ser criado.
      • relationshipName – Nome do relacionamento para relacionar o recurso recém criado com o recurso.
      Exemplo:
       <Action
      target="RAM" action="create" type="Release"
      relationshipName="release" />

Feedback