Skip to main content

Model Transmutations

Latest release: 2.8.0


Run transmuters to modify or update your model. Transmuters are designed to be idempotent, so you can run the transmutations each time you want to update your model after a change.

Some of the use-cases are:

  • Create a DataElement needed for a feature to work
  • Configure your models with a certain recommended feature
  • Automatically create useful model additions, such as FindersFinderA search specification combining field-operator pairs to execute standard data queries on a DataElement.

Usage​

To run a transmuter, use the expanders-maven-plugin:

mvn expanders:transmute-model -Dtransmutation=CreateFlowEnvironment

This run the transmutation on all valid elements in the model. You can also define a targetElement to run it on a single element or, using wildcards, on a subset of elements.

mvn expanders:transmute-model -Dtransmutation=CreateFlowEnvironment -DtargetElement=space::Starship
mvn expanders:transmute-model -Dtransmutation=CreateFlowEnvironment -DtargetElement=space::*

Examples​

TransmutationElement TypeDescription
AddTaskLoggingelements::FlowElementAdd a TaskStatus DataElement for the target FlowElement unless it has the option excludeStatuses.
AddWorkflowClaimselements::FlowElementConfigure the Claims feature for for the target FlowElement.
CreateFlowEnvironmentelements::DataElementAdd a FlowElement and status fieldFieldA property of a DataElement expanded to a database column and user interface input element. for the target DataElement.
CreateLinkFieldFindersFinderA search specification combining field-operator pairs to execute standard data queries on a DataElement.elements::DataElementCreate a FinderFinderA search specification combining field-operator pairs to execute standard data queries on a DataElement. for each LinkField on the target DataElement.