Настройка файла mapping.xml

Файл отображения mapping.xml содержит отображения типов ресурсов Rational Asset Manager на объекты модели бизнес-процесса.

Для синхронизации элементов Rational Asset Manager и элементов WSRR применяется файл mapping.xml, в который можно вносить изменения.

В этом файле определены различные типы отображений: для типов ресурсов, взаимосвязей и атрибутов. Он также содержит триггеры - события, которые вызываются во время операций для сохранения, входа в состояние или выполняемых вручную действий, настроенных для стратегии.

Вместе с Rational Asset Manager поставляется стратегия SOA. Она считывает файл отображения и запускает триггеры, определенные для выполняемого вручную действия, входа в состояние или события сохранения. Стратегия SOA настраивается для каждого состояния жизненного цикла SOA; для связи с определенным соединением WSRR в ней предусмотрено свойство конфигурации соединения WSRR.

Файл отображения содержит два основных элемента - отображения и триггеры:

Отображения

Элементы mapping отображают каждый тип ресурса на объект WSRR.
  • id – ИД элемента mapping. Каждый элемент mapping имеет уникальный ИД.
  • wsrrType – объект модели бизнес-процесса WSRR
  • ramType – тип ресурса RAM
  • extends – для элемента Mapping поддерживается наследование. Значение extends - это ИД другого (расширяемого) элемента mapping.
  • ramCategory – если параметр ramCategory определен, то объект модели бизнес-процесса WSRR отображается на ramType, который классифицируется как ramCategory.
<Mapping id="SPEC" wsrrType="&GEP63;SchemaSpecification" ramType="Specification" extends="ASSET" ramCategory="Software Development/Kind/Schema">
   </Mapping>
Элементы Mapping отображает типы ресурсов, взаимосвязи и атрибуты:
  • Attribute
    • wsrrName –имя атрибута WSRR
    • ramName – имя атрибута RAM
    • type – тип атрибута
    <Attribute wsrrName="gep63_versionAvailabilityDate" ramName="Availability Date" type="date"/>
  • Relationship
    • Отображение взаимосвязи 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>
  • Триггер выполняемого вручную действия - это триггер, который вызывается при переходе ресурса в другое состояние. Например, следующий триггер вызывается для типа ресурса “Business Solution” (Бизнес-решение) в состоянии ”Proposed” (Предложено) при переходе (или действии) ”Revise” (Исправить).
    • <Trigger source="RAM" type="Business Solution" state="Proposed" transition="Revise">
      </Trigger>
  • Триггер сохранения или входа в состояние - это триггеры, который вызывается во время сохранения ресурса в определенном состоянии или при первом входе ресурса в это состояние. Например, следующий триггер вызывается для ресурса типа Бизнес-решение, когда ресурс либо сохраняется в состоянии “Rejected” (Отклонен), либо входит в состояние “Rejected” (Отклонен):
    • <Trigger source="RAM" type="Business Solution" state="Rejected"> 
      </Trigger> 
Триггеры содержат два дочерних элемента - правила и действия:
  • Rule: правило задает условие (или набор условий), которое должно удовлетворяться, чтобы выполнялись действия, определенные в триггерах.

    Правило может быть простым или сложным.

    Пример простого правила:
    <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"/>
  • Action: действия, которые выполняются при вызове триггера, если выполнены правила. Существуют три типа действий, поддерживаемых файлом конфигурации:
    • Создание или обновление объекта 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" />

Комментарии