You use the mapping.xml file and make updates to it to ensure synchronization between elements in Rational Asset Manager and WSRR elements.
There are several types of mappings defined in the file such as for asset types, relationships, and attributes. The mapping file also contains triggers, which are events that are invoked during operations for save, state entrance or manual actions you've configured for a policy.
There is a SOA policy that is provided with Rational Asset Manager. It reads the mapping file and runs the triggers defined for the manual action, state enter or save event. The SOA policy is configured on every state of the SOA lifecycle and has a WSRR connection configuration property to associate with a specific WSRR connection.
The mapping file contains two primary elements, mappings and triggers:
<Mapping id="SPEC" wsrrType="&GEP63;SchemaSpecification" ramType="Specification" extends="ASSET" ramCategory="Software Development/Kind/Schema"> </Mapping>
<Attribute wsrrName="gep63_versionAvailabilityDate" ramName="Availability Date" type="date"/>
<Relationship wsrrName="gep63_interfaceSpecifications" ramName="specification"/>
<Relationship wsrrName="gep63_charter" ramArtifactLabel="Charter"/>
Triggers are events that are invoked during operations for save, state entrance or manual actions you've configured for a policy. For example:
<Trigger source="RAM" type="Release" state="Identified"> <Rule ruleType="CATEGORIZATION" target="RAM" categoryValue="Software Development/Kind/Process" /> <Action target="WSRR" action="create"/> </Trigger>
<Trigger source="RAM" type="Business Solution" state="Proposed" transition="Revise"> </Trigger>
<Trigger source="RAM" type="Business Solution" state="Rejected"> </Trigger>
A rule can be a simple rule, or a complex rule.
<Rule ruleType="CATEGORIZATION" target="RAM" categoryValue="Software Development/Kind/Process" />
A complex rule can be created by using “AND” or “OR” operators to Simple Rules.
<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>
categoryValue ="Software Development/Kind/Web Application"
<Rule ruleType="CATEGORIZATION" target="RAM" categoryValue="Software Development/Kind/Web Application" />
<Rule ruleType="ARTIFACT" target="RAM" countType="EXACTLY" count="1" artifactMatchType="LABEL_OF" artifactMatchTypeValue="Charter" />
relatedAssetType="Implementation"
relationshipName="implementation"
<Rule target="RAM" ruleType="RELATIONSHIP" countType="ATLEAST" count="1" relatedAssetType="Implementation" relationshipName="implementation" />
<Rule target="RAM" ruleType="ATTRIBUTE" attributeName="Custom Attribute" attributeValue="Value 1" />
<Rule ruleType="WSRR_STATE" target="WSRR" state="&GEPLifecycle;PlanReview"/>
<Action target="WSRR" action="create"/>
<Action target="WSRR" transition="&GEPLifecycle;ProposeCharter" state="&GEPLifecycle;CharterReview"/>
<Action target="RAM" action="create" type="Release" relationshipName="release" />