Action – promoteItem

AML Query

<!-- SOAP_ACTION = PromoteItem, ApplyAML, or ApplyItem -->
<AML>
  <Item type="{Item Type}" action="promoteItem" id="{ID of Item}">
    <state>{Name of the new state}</state>
    <comments>{Additional comments to store in history.  Optional.}</comments>
  </Item>
</AML>

Example (Input):

<AML>
  <Item type="Sourcing List" action="promoteItem" id="F0DA7AC31E3341B0B033F0ABF2B807EB">
    <state>Evaluating</state>
    <comments>Some comments</comments>
  </Item>
</AML>

Example (Result):

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
  <SOAP-ENV:Body>
    <ApplyItemResponse>
      <Result>Ok.</Result>
    </ApplyItemResponse>
    <Message>
      <event name="ids_modified" value="F0DA7AC31E3341B0B033F0ABF2B807EB|..." />
    </Message>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Pipeline

The context item for a Life Cycle promotion method looks like the following:

<Item type="" typeId="" id="" action="">
  <!-- Item Properties -->
  <transition>
    <Item type="Life Cycle Transition" id="31B3EFD665294DDD88AE962868B21621">
      <from_state keyed_name="Preliminary" type="Life Cycle State">A29C9720FF0D4950A140A90BEEA903DA</from_state>
      <to_state keyed_name="In Review" type="Life Cycle State">E4F115AAA1FA4D9FB053915171F49007</to_state>
      <role keyed_name="Aras PLM" type="Identity">56A96DA9E981481688563E2D14D5D878</role>
    </Item>
  </transition>
</Item>

The context item for an onAfterPromote method on the ItemType looks like the following. Transition information can be obtained from the OnAfterPromoteEventArgs.

<Item type="" idlist="" action="get" />

🪲 In Aras 11sp9, there is a bug where the to_state contains the string Aras.Server.Core.LifeCycleStateInfo instead of the ID.