配置 mapping.xml 文件

mapping.xml 映射文件包含 Rational Asset Manager 资产类型和 WSRR 业务模型对象之间的映射。

可使用 mapping.xml 文件并对其进行更新,以确保 Rational Asset Manager 中的元素与 WSRR 元素同步。

在文件中为资产类型、关系和属性等定义有若干类型的映射。映射文件还包含触发器,触发器是指在进行已为策略配置的保存操作、状态进入或手动操作期间被调用的事件。

Rational Asset Manager 附带有 SOA 策略。 它会读取映射文件并运行为手动操作、状态进入或保存事件定义的触发器。SOA 策略基于 SOA 生命周期的每个状态来进行配置,并且包含用于与特定 WSRR 连接相关联的 WSRR 连接配置属性。

映射文件包含两种主元素,即映射和触发器:

映射

映射元素将各资产类型映射到 WSRR 对象。
  • id – 映射元素的标识。各映射元素都有唯一标识。
  • wsrrType – WSRR 业务模型对象
  • ramType – RAM 资产类型
  • extends – 映射元素支持继承。extends 的值为所扩展的其他映射元素的标识。
  • ramCategory – 如果定义了 ramCategory,那么会将 WSRR 业务模型对象映射到 ramType,后者将分类为 ramCategory。
<Mapping id="SPEC" wsrrType="&GEP63;SchemaSpecification" ramType="Specification" extends="ASSET" ramCategory="Software Development/Kind/Schema">
   </Mapping>
映射元素会映射资产类型、关系和属性:
  • 属性
    • wsrrName – WSRR 属性名称
    • ramName – RAM 属性名称
    • type – 属性类型
    <Attribute wsrrName="gep63_versionAvailabilityDate" ramName="Availability Date" type="date"/>
  • 关系
    • 将 RAM 关系映射到 WSRR 关系:
      • wsrrName – WSRR 关系名称
      • ramName – RAM 关系名称
      <Relationship wsrrName="gep63_interfaceSpecifications" ramName="specification"/>
    • 将 RAM 标签映射到 WSRR 关系:
      • wsrrName – WSRR 关系名称
      • ramArtifactLabel – RAM 工件的标签
      <Relationship wsrrName="gep63_charter" ramArtifactLabel="Charter"/>

触发器

触发器是指在进行已为策略配置的保存操作、状态进入或手动操作期间调用的事件。例如:

<Trigger source="RAM" type="Release" state="Identified">
<Rule ruleType="CATEGORIZATION" target="RAM" categoryValue="Software Development/Kind/Process" />
<Action target="WSRR" action="create"/> 
</Trigger>
  • 手动操作触发器 – 在尝试转换资产状态时调用的触发器。例如,对于处于“Proposed”状态的“Business Solution”资产类型和转换(或操作)为“Revise”时,会调用以下触发器。
    • <Trigger source="RAM" type="Business Solution" state="Proposed" transition="Revise">
      </Trigger>
  • 保存或状态进入触发器 – 这些是以特定状态保存资产或资产首次进入特定状态时调用的触发器。例如,在状态“Rejected”中保存资产或资产进入“Rejected”状态时,对于类型为 Business Solution 的资产会调用以下触发器:
    • <Trigger source="RAM" type="Business Solution" state="Rejected"> 
      </Trigger> 
触发器包含两种子元素,即规则和操作:
  • 规则:规则指定在能够执行触发器中定义的操作之前应满足的条件或条件集。

    规则可以是简单规则,也可以是复杂规则。

    简单规则示例:
    <Rule ruleType="CATEGORIZATION" target="RAM" categoryValue="Software Development/Kind/Process" />

    可以通过对简单规则使用“AND”或“OR”运算符来创建复杂规则。

    复杂规则示例:
    <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>
    所支持的不同类型的简单规则包括:
    • CATEGORIZATION:要指定分类规则,请设置下列属性:
      • ruleType = "CATEGORIZATION"
      • target = "RAM"
      • categoryValue - 类别的路径。例如:
        categoryValue ="Software Development/Kind/Web Application"
      分类规则示例:
      <Rule ruleType="CATEGORIZATION" target="RAM" categoryValue="Software Development/Kind/Web Application" />
    • ARTIFACT:要指定工件规则,请设置下列属性:
      • ruleType = "ARTIFACT"
      • target = "RAM"
      • countType – 可以是下列类型之一:
        • EXACTLY
        • ATMOST
        • ATLEAST
      • count – 表示工件出现次数的整数值。
      • artifactMatchType – 可以是下列类型之一:
        • FORMAT_OF – 工件的格式或类型。
        • LABEL_OF – 包含标签的工件。
        • FILE_EXTENSION_OF – 工件的文件扩展名。
        • FULL_FILE_NAME_OF – 工件的完整文件名。
      工件规则示例:
      <Rule ruleType="ARTIFACT" target="RAM" countType="EXACTLY" count="1" artifactMatchType="LABEL_OF" artifactMatchTypeValue="Charter" />
    • RELATIONSHIP:要指定关系规则,请设置下列属性:
      • ruleType = "RELATIONSHIP"
      • target = "RAM"
      • countType – 可以是下列类型之一:
        • EXACTLY
        • ATMOST
        • ATLEAST
      • count – 表示关系出现次数的整数值。
      • relatedAssetType – 相关资产的资产类型,例如:
        relatedAssetType="Implementation"
      • relationshipName – 关系的名称,例如:
        relationshipName="implementation"
      关系规则示例:
          <Rule target="RAM" ruleType="RELATIONSHIP" countType="ATLEAST" count="1" relatedAssetType="Implementation" relationshipName="implementation"   />
    • ATTRIBUTE
      • target = "RAM"
      • ruleType = "ATTRIBUTE"
      • attributeName – 属性名称。
      • attributeValue – 属性值。
      资产规则示例:
      <Rule target="RAM" ruleType="ATTRIBUTE" attributeName="Custom Attribute" attributeValue="Value 1" />
    • WSRR_STATE – WSRR 资产的状态。
      • ruleType = "WSRR_STATE"
      • target = "WSRR"
      • state = WSRR 资产的状态。
      WSRR 状态规则示例:
      <Rule ruleType="WSRR_STATE" target="WSRR" state="&GEPLifecycle;PlanReview"/>
  • 操作:如果规则有效,那么在调用触发器时会执行操作。有三种类型的操作受配置文件支持:
    • 创建或更新 WSRR 对象
      • target="WSRR"
      • action – 可能的值为:
        • create – 创建 WSRR 对象。如果 WSRR 对象已存在,那么会对其进行更新。
        • update – 更新 WSRR 对象。如果不存在对应的 WSRR 对象,将不会创建此对象。
      示例:
       <Action target="WSRR" action="create"/>
    • 转换 WSRR 资产
      • target = "WSRR"
      • transition - 要对 WSRR 对象执行的转换操作。
      • state – WSRR 对象的最终状态。如果已将对象转换为最终状态,那么对象不会执行转换。
      示例:
       <Action target="WSRR" 
      transition="&GEPLifecycle;ProposeCharter" 
      state="&GEPLifecycle;CharterReview"/>
    • 创建 RAM 资产
      • target = "RAM"
      • action = "create"
      • type – 要创建的 RAM 资产类型。
      • relationshipName – 用于将新创建的资产与该资产关联的关系名称。
      示例:
       <Action target="RAM" action="create" type="Release" relationshipName="release" />

反馈