Component:

S_Update_Aspect_Knowledge

part of C_WissDB_DL_API

Abstract:

This is the function to update the B_WissDB_Database with respect to the knowledge classification schema (which is based on so-called Aspects: read section 2.2 in D_ (WissDB/ Result/ WissDB/ Design/ Data Model).

Parameters:

§      In: Update

        Is ASCII text of type B_Aspect_Update.

§      In: Request

        Must be CREATE, or REPLACE, or FORGET.

        Value CREATE means: Return with RC_seeAppErrors if at least one of the locators in Aspect is in use already.

§      Out: AppErrors

        If the value of B_WissDB_Database did not change, users should find a description here telling them why.

        Describe an AppError here if Request = CREATE though Update is containing lines with a minus sign in column 1.

        Describe an AppError here if Request = FORGET though Update is containing lines with a plus sign in column 1.

        Create a warning whenever an object to be deleted does not exist.

§      Out: ReturnCode is one of the following values:

–      RC_ok

–      RC_syserror

–      RC_seeAppErrors

–      RC_seeWarnings

Has to:

Implement the required update of the B_WissDB_Database.

RC_ok is allowed only if the Update requested could be implemented fully. If the ReturnCode is different from RC_ok, the value of the knowledge base did not change.

Because of:

Applications of C_WissDB_DL_API need a way to update the B_WissDB_Database with respect to aspects to be supported.