Component:

S_Ensure_Association

part of C_WissDB_DL_API

Abstract:

This is the functions to create a new instance of type R_Is_related_to.

Parameters:

§      In: Locator_A

        Is an instance of type E_KnowledgeItem.A_Loc.

§      In: Locator_B

        Is an instance of type E_KnowledgeItem.A_Loc.

§      In: CorrelationType

        Is an instance of type D_Correlation .

§      Out: AppErrors

        Must not be empty if the correlation could not be created (and did not yet exist).

§      Out: ReturnCode is one of the following values:

–      RC_ok

–      RC_syserror

–      RC_seeAppErrors

Has to:

Ensure the existence of a relationship X satisfying

–      X.a_A = Locator_A

–      X.a_B = Locator_B

–      X.a_Correlation = CorrelationType

Please note:  If exactly this relationship already exists, the function is to return RC_ok.

Because of:

C_WissDB_API needs a way to create associations of type R_Is_related_to.