Modeling Function Package Features

You must define a function package in the model before its tools can be used.

A function package must implement the AWM model extension point so that it can be selected in the model editor.

A function package can be added to the model by selecting Function Packages > New Child:


Function Package 1

Alternatively, click Tool Descriptors > New Child > Create Function Package.


Function Package 2

Creating a function package opens a dialog box that shows all available function packages which are installed in the IDE.

If the model already contains function packages, you can define linked element types, linked properties or select tools from these function packages.

In order to select a function package tool, click Tool Descriptors > New Child.


GUID-7C33B686-1DE7-431E-9EF4-86CDB3137CC6-low.jpg

The function package provider can define attributes for the function package which are shown in the Properties view when the function package is selected in the AWM model editor. See the individual function package description for more details.

Function package features can have references to other model objects like tool descriptor parameters or properties. Tool descriptor parameters are always automatically generated when a tool descriptor is created or changed. They can have specific conditions, so they are only created if certain tool attributes are set.

Other function package related features, like linked properties or linked element types can reference other model objects which require an ID to be defined before being created. Creating such a feature automatically opens an Enter Object IDs dialog in which referenced object IDs must be specified:


Enter Object IDs dialog

Once a referenced model object has been created by the function packages, other features of the package are able to automatically find and reuse it. For example, a linked element type and a linked property can reference the same property. Once any of the features have been defined, including the referenced property, defining other features automatically find and set the reference.

You can manually set and unset function package declarations on model objects by using the Declare Function Package <type> and Remove Function Package Declaration context menu actions, see Context Menu Actions in the AWM Model Editor for more information. Normally this is not required, since the declaration is automatically set on defining the function package feature, but there are some scenarios where setting the declaration manually might be useful.

The most common scenario is maintaining a model that was created with an older version of AWM, in which the function package features were not able to reference other model objects. The model might already contain features of a function package. For example, linked properties which contain references to manually created objects, for example, resource identifier properties. By setting the correct function package declaration, the model editor automatically finds and reuses the property on newly created function package features referencing it.