Sheet: 'ISM Maturity Levels'

1

Id

Required

• The identifier for the Maturity Level definition. There is a requirement that this value is unique within the collection of Maturity Levels in the target Class Library model.

• If zero, or a positive integer value, is specified, this value will represent the magnitude of the maturity level.

• If a non-zero, non-positive integer value is specified, SortOrder will have to be supplied with the value representing the magnitude of the maturity level.

• The value ‘{null}’ can be used for a maturity level definition representing "no maturity level selected" in the AVEVA ISM user interface.

2

Name

A human readable name for the Maturity Level definition.

3

Name

{language}

• A human readable name for the Maturity Level definition, in a specific language.

• The value for {language} is composed as {languageCode}-{countryCode} (see the Sheets and Column Headers for AVEVA ISM Intrinsic Definitions).

• This column can be repeated as many times as required, each with a different value for {language}

4

Description

An arbitrary description of the purpose/role of the Maturity Level.

5

Description

{language}

• An arbitrary description of the purpose/role of the Maturity Level, in a specific language.

• The value for {language} is composed as {languageCode}-{countryCode} (see the Sheets and Column Headers for AVEVA ISM Intrinsic Definitions).

• This column can be repeated as many times as required, each with a different value for {language}

6

Presence

• Not Applicable

• Optional

• Preferred

• Required

• When a Maturity Level is associated with an Sheet: 'ISM Attributes', or a Permissible Attribute, the Presence value of the Maturity Level takes precedence over the default Presence value of the attribute, depending on the maturity of a data object.

• As an example, assume an Attribute has 0, 5, and 8 as Permissible Maturity Levels. When a data object is at maturity 0-4, the Presence value defined for Maturity Level 0 will take precedence, when the data object is at maturity 5-7, the Presence value defined for Maturity Level 5 will take precedence, the Maturity Level with the closest match to the objects maturity will be considered the "ruling" Maturity Level for the object.

7

Discipline

When a Maturity Level is associated with an Sheet: 'ISM Attributes', or a Permissible Attribute, the Discipline value of the Maturity Level takes precedence over the default Discipline value of the attribute, depending on the maturity of a data object (see Presence above).

8

Aspect

Annotating a Maturity Level with an aspect is a way to associate the Maturity Level with a specific semantic definition. Application logic will look for these aspects, and apply associated processing rules. Definition of available aspect values is outside the scope of this document.

9

Obsolete

• true

• false

When evolving a Class Library over time, removing previously existing definitions might cause issues with consuming software systems (for example, they might not support deleting a Maturity Level that is in use for existing data). Obsoleting deprecated definitions might therefore be a less intrusive approach. How, or whether, obsoleting is implemented might vary across consuming software though.

10

Sort Order

- A signed integer value

• Decides on the order in which Maturity Levels are presented in the AVEVA ISM user interface.

• If the Id property is a non-zero, non-positive integer value, the value for SortOrder will represent the magnitude of the maturity level, and should have the value of zero or higher.

• Consuming software systems might also utilise this information to decide on in which order Maturity Level values are to be presented.