Retrieving Information on Maturity State (INFRAMaturityStateInformation)

An opening ID is an entry point used to customize business logic. The Retrieving Information on Maturity State (INFRAMaturityStateInformation) opening lets you declare the states that are frozen, meaning that the components cannot be modified any longer.

Note: For more information about customization by business rules, see Installation and Setup: Customize: Behavior: Data Setup: Customization by Business Rules.

This page discusses:

General Information

This opening ID is invoked by the session to determine if a component is read-only because of its state. It is used to:

  • Customize the Update and Edit Links commands so that they do not modify any objects that are in the maturity states you declared as frozen.
  • Map maturity states between two different 3DEXPERIENCE environments when exporting or importing 3D XML files.

The table below provides you with information related to the definition of the Opening ID.

Opening ID: INFRAMaturityStateInformation
Customization intent: Computation
Execution context: Client

Input Objects

Input objects must be of the following types:

  • ThisObject: Feature
  • Parameters corresponds to the context object.

Context Object Parameters

Parameter NameTypeRead/WriteComments
StateString ReadName of the state. A state is linked to a policy determined in Data Setup.
PolicyStringReadPolicy name.
IsFrozenBooleanWriteTRUE or FALSE.

Use this parameter to declare frozen maturity states when customizing the Update and Edit Links commands.

MetaStateNameStringWriteName of the meta state. The values are the following:
  • MS_Private: The author proposes the current iteration of the data to external review/validation. Used while in “Private” mode, the object is often “Frozen” so as to make sure the review occurs on stable data. If the object is found defective by the reviewers, it is demoted to “InWork” and may be completely redesigned.
  • MS_InWork: The object is being created or modified by its author. The data may be modified in any way at any time. The use of "InWork” data is often restricted to the author and his/her team.
  • MS_Frozen: The object cannot be modified anymore.
  • MS_Released: The object has passed validation and is now available for general use. Used when the object is definitively frozen. If a problem appears, the object is not demoted, but a new revision is created.
  • MS_Obsolete: The object is obsolete, old usages and references to the object are still supported, but no new ones should be created. Used when the object is frozen. Usually a new “released” revision of the object has been built before making the current one obsolete

Use this parameter to declare frozen maturity states when mapping maturity states between two different 3DEXPERIENCE environments.

Sample 1

This example shows you how to declare maturity states as frozen to prevent the Update and Edit Links commands from modifying objects that are in these maturity states.

let stateName=""
let isFrozen=false

/* We consider that by default a state is not frozen */
stateName=Parameters->GetAttributeString("State")

/* Here we list the possible states that are frozen  */
if (stateName=="Frozen" or stateName=="Final")
  isFrozen=true

/* We valuate the output parameter with this result  */
Parameters->SetAttributeBoolean("IsFrozen",isFrozen)

Sample 2

This example shows you how to declare maturity states as frozen when mapping maturity states to import/export 3D XML files between two different 3DEXPERIENCE environments.

let stateName=""
let metaName=""

/* We consider that by default a state is not frozen */
stateName=Parameters->GetAttributeString("State")

/* Here we list the possible states that are frozen  */
if (stateName=="Frozen" or stateName=="Final")
   metaName = " MS_Released"

/* We valuate the output parameter with this result  */
Parameters->SetAttributeString("MetaStateName",metaName)