PRODUCT_Functions (no NLS) Functions

The PRODUCT_Functions package provides functions you can use when manipulating the activation status of product instances.

This page discusses:

VPMInstance.GetEffectivity()

This function retrieves the activation status of a Product Modeler instance.

Note: You cannot use this function to retrieve an effectivity related to another configuration domain.

Signature

VPMInstance.GetEffectivity(oVariabilitySpace : String, oExpression : String)

Arguments

NameInput/OutputRequired?TypeComment
oVariabilitySpaceOutYesString Set to ActivateDeactivate. The string is empty if the activation status cannot be retrieved.
oExpressionOutYesString Set to TRUE is the instance is activated, or FALSE if the instance is deactivated. The string is empty if the activation status cannot be retrieved.

Example

VsName=""
Effectivity=""
ThisObject->GetEffectivity(VsName, Effectivity)

VPMInstance.SetEffectivity()

You can use this function to modify the activation status of a Product Modeler instance.

Note: You cannot use this function to modify an effectivity related to another configuration domain.

Signature

VPMInstance.SetEffectivity(iVariabilitySpace : String, iExpression : String, iAssociateToReference : Boolean) : Boolean

Arguments

NameInput/OutputRequired?TypeComment
iVariabilitySpaceInYesString Obsolete. Valued by the implementation to ActivateDeactivate.
iExpressionInYesString Set to TRUE to activate the instance, or to FALSE to deactivate the instance. Do not use lower-case true and false values (though currently supported).
iAssociateToReferenceInYesBooleanObsolete.

ReturnType

Boolean

TRUE if the required status has been set, FALSE if not.

Example

let res (Boolean)
 res = false
res =
ThisObject->SetEffectivity("ActivateDeactivate", "FALSE",
true)