All Frameworks Class Hierarchy This Framework Indexes Previous Next

CATLogicalModelerUseItf Interface CATILogRepresentationInstances

Usage: an implementation of this interface is supplied and you must use it as is. You should not reimplement it.

interface CATILogRepresentationInstances

Interface dedicated to manage the collections of Logical Representation Instances aggregated by a Logical Reference.

These Representation Instances can come from mono or multi-instantiable Representation References.

Method Index

o Add(CATILogRepresentationReference*,CATListValCATICkeParm_var&,CATILogRepresentationInstance*&): Instantiates a Logical Representation Reference under this Logical Reference.
o Count(int&): Retrieves the number of Logical Representation Instances aggregated by this Logical Reference.
o List(CATListValCATILogRepresentationInstance_var&): Lists the collection of Logical Representation Instances aggregated by this Logical Reference.
o Remove(CATILogRepresentationInstance*): Removes the given Logical Representation Instance that is aggregated by this Logical Reference.

Methods

o Add

public virtual Add(		`ipLogicalRepReferenceToInstantiate`,
		`iLFctAttributesValues`,
		`opLogicalRepInstance`)

Instantiates a Logical Representation Reference under this Logical Reference.
Role: This method creates a Logical Representation Instance from the given Logical Representation Reference and aggregates it under this Logical Reference.
The deployment type used to create the Logical Representation Instance corresponds to the same than the Logical Representation Reference to instantiate.

This API invokes the following Business Logic Openness:

PLMInstanceAggregationCheck
PLMIdentificationInitialization

For any information about Business Logic Openness, refer to the CAA Encyclopedia documentation: Reference \ Business Logic Openness section.

Parameters:

ipLogicalRepReferenceToInstantiate: The Logical Representation Reference to instantiate.
This Representation Reference must be multi-instantiable.
Input Parameter.
This parameter MUST NOT be provided by caller as NULL. This method returns an error otherwise.
iLFctAttributesValues: A list of functional attributes values (of the logical representation instance to create).
The compliancy of attributes values will be checked relatively to their definition in metadata (mandatory, size, type).
Input Parameter.
This list must be empty.
opLogicalRepInstance: [out, CATBaseUnknown#Release]
The created Logical Representation Instance.
Output parameter.
This parameter MUST be provided by caller as NULL. This method returns an error otherwise.
This parameter is returned to caller as NULL if method fails.
This parameter is valuated if method succeeds.

Returns:

S_OK if the method succeeds.
E_INVALIDARG if parameters provided are unexpected.
E_FAIL otherwise.

o Count

public virtual Count( oSize)

Retrieves the number of Logical Representation Instances aggregated by this Logical Reference.

Parameters:

oSize: The number of Logical Representation Instances.

Returns:

S_OK The method succeeds and the number of Logical Representation Instances is retrieved.
E_FAIL otherwise.

o List

public virtual List( oLLogRepInstances)

Lists the collection of Logical Representation Instances aggregated by this Logical Reference.

Parameters:

oLLogRepInstances: A list of Logical Representation Instances.
Output parameter.
This parameter MUST be provided by caller as empty. This method returns an error otherwise.
This parameter is valuated if method succeeds.

Returns:

S_OK if the method succeeds and the aggregated Logical Representation Instances (if exist) are retrieved.
E_INVALIDARG if the provided parameter is unexpected.
E_FAIL otherwise.

o Remove

public virtual Remove( ipLogicalRepInstanceToRemove)

Removes the given Logical Representation Instance that is aggregated by this Logical Reference.
Role: This method removes and deletes the given representation instance from the representation instances aggregated by the Logical Reference.
The given representation instance must be aggregated by this Logical Reference.

Parameters:

ipLogicalRepInstanceToRemove: The Logical Representation Instance to remove.
Input Parameter.
This parameter MUST NOT be provided by caller as NULL. This method returns an error otherwise.

Returns:

S_OK if the method succeeds and the Logical Representation Instance has been successfully removed.
E_INVALIDARG if the provided parameter is unexpected.
E_FAIL otherwise.

This object is included in the file: CATILogRepresentationInstances.h
If needed, your Imakefile.mk should include the module: CATLogicalModelerUseItf