Skip to content

AML Actions

Eric Domke edited this page Jan 12, 2018 · 31 revisions
Action Description
ActivateActivity
add, AddItem ➡️ Add the Item as an instance of an ItemType.
AddHistory
ApplyUpdate
BuildProcessReport Builds an HTML-formatted report for a workflow process
CancelWorkflow
checkImportedItemType
closeWorkflow
copy
copyAsIs, copyAsNew
create This will act as a get if the Item exists, otherwise acts as an add.
delete Delete all versions of the Item. The purge and delete are the same for non-versioned items.
edit ➡️ This will lock, update, and unlock the Item.
EmailItem
EvaluateActivity ➡️
exportItemType Removed in Aras v11
get, recache ➡️ Gets the Item(s) and its configuration based on the AML Item configuration used to query the database.
getAffectedItems Returns a flat list of all items that reference a particular item. Similar to the getItemWhereUsed; however, this method will return the relationship item associated with an item while the where used action does not <Item type="Part" id="..." action="getAffectedItems" />
getItemAllVersions Get all versions (i.e. generations) of an item. It requires an id attribute and does not respect the select attribute. Another way to do this is to search for generations > 0.
getItemConfig This will return the Item configuration as described by the standard AML query. The AML in and out are no different than the standard action="get". The getItemConfig is optimized by limiting the logic done between the SQL call and the AML result. The performance improvement is gained by limiting the features typically available in Innovator GetItem (no server events or access checking on the sub level Items).
getHistoryItems Obsolete in 9.3
GetInheritedServerEvents (:heavy_plus_sign: Added in Aras v11)
getItemLastVersion ➡️
getItemNextStates ➡️ Returns a list of Life Cycle Transition items representing the transitions that the authenticated user has permissions to perform.
getItemRelationships
GetItemRepeatConfig ➡️ This will allow deep recursive queries and is useful in multi-Part BOM's with repeating relationships.
getItemWhereUsed ➡️
GetMappedPath Returns the base directory on the server combined with the path specified in the path attribute Example (Input): <Item action="GetMappedPath" path="Solutions/PLM/images/Icons/16x16/16x16_Part.gif" />
getPermissions ➡️
getRelatedItem
GetUpdateInfo
instantiateWorkflow ➡️
lock This will lock the Item and is the same as the Item.lockItem() IOM method.
merge This will act as an edit if the Item exists, otherwise acts as an add.
New Workflow Map
promoteItem ➡️ Promotes the item to the new state specified by the state property.
purge Delete the version of the Item.
replicate
resetAllItemsAccess, resetItemAccess
resetLifecycle
setDefaultLifecycle
skip
startWorkflow ➡️
unlock This will lock the Item and is the same as the Item.unlockItem() method.
update ➡️ Updates the Item. It is important to note, that the Item must be locked. Also, if the Item is versionable and is being updated for the first time since being locked, the update versions the Item and applies the update to the new version, unless the version="0" attribute is specified, which disables the versioning.
ValidateWorkflowMap
version ➡️ Creates a new version of an item. The new item remains locked.

Core Aras Methods

Action Description
GetItemsForStructureBrowser ➡️ Gets the structure browser data
Run Report ➡️ Run a report
Clone this wiki locally