Previous Topic Next topic Print topic


Get All Properties Action

The Get All Properties action is a special action of an element type that returns all properties of a specific element or list of elements. Use it to ensure that all required element properties are available before any other action executes on the element.

The main purpose of this action is to improve performance when working with element lists. It often requires one service to receive a list of elements with a few basic properties, and a second service to retrieve all properties of a specific element. Using both services in a single “Get Element List” action would often cause an immense I/O overhead. As a result, the Get All Properties action executes automatically before any other action executes on an element. Once the Get All Properties action successfully executes it does not execute again automatically. You can subsequently execute it manually from the element’s context menu.

To update the element’s properties, the action contains at least one tool with UPDATE or TOOL-DEFINED resource processing. See Tool-defined Resource Operations for more information.

If you allow multi-selections in the model, it is recommended you support mass processing for the Get All Properties action. If executed automatically, the Workflow Manager only adds elements to the mass processing context that require updates to their properties. See Mass Processing Overview for more information.

Note: When designing a custom tool to return all properties of a specific element type, it is not enough to only return “missing” properties of the element (properties which were not returned when the element list was generated). This is not recommended, since the “Get All Properties” action can not be used to refresh elements in this case. As the name suggests, “Get All Properties” actions should always return all available properties for the corresponding element type.
Previous Topic Next topic Print topic