Version Namers

The Version Namer object determines the naming convention of versions associated with a node in the Process Framework. For the example design namer implementation, the IMMPxSDEVersionNamer interface gets the parent version and uses it to generate a name for a new version. The default naming scheme is the version prefix and the Node ID. An administrator may set the version prefix by node type on the Node Types tab in the Process Framework Administration tool. IMMPxSDEVersionNamer retrieves the Node ID from the MM_PX_VERSIONS table (Figure 1).

In the example in Figure 1, a design node is named based on the parent or base version (WR177), the design node prefix from the Process Framework Administration tool (DN), and the Node ID (169).

To create a custom version namer, implement IMMPxSDEVersionNamer and IMMRegInCat. All custom version namers must implement IMMRegInCat in order to register the control in the MMProcessMgrNamer component category.

The optional IMMPxDisplayName interface allows you to specify a display name for the version namer. This name is used in the Process Framework Administration Tool when assigning a version namer to a node type on the Node Types tab (Figure 2). If IMMPxDisplayName is not implemented, the version namer's prog ID is displayed.

Interfaces:
    IMMPxSDEVersionNamer
    IMMRegInCat
    IMMPxDisplayName

Component Category:
MMProcessMgrNamer

Figure 1, MM_PX_VERSIONS table

Implement a Version Namer

To ensure your custom namer appears on the Node Types tab in the Process Framework Administration tool, it must be registered in the M&M Process Framework Namer (MMProcessMgrNamer) component category. This is easily done by utilizing the IMMRegInCat interface.

Version Namers and Deleters are implemented the same way. Once you have created and registered the object(s), open the Process Framework Administration tool. Information is available in the online help for the application. On the Node Types tab, you may select your custom version namer in the Version Namer field (see Figure 2). All namers registered to the MMProcessMgrNamer component category are listed in this field. You may also manually enter the custom namer's progID in the Version Namer field.

Figure 2, Node Types tab in the Process Framework Administration Tool