Assigns a value to a protected attribute.
Some system models are created and maintained by EDM and therefore the users need no write access to them. However, in these system models, some attributes may still be manipulated by selected users even if the model it self is open for read only. The ordinary operations such as e.g sdaiPutAttr and sdaiUnsetAttr, would return an error code if used on these attributes. To manipulate protected attributes one must use the protected-versions of the operations.
Header:
#include "sdai.h"
Prototype:
EdmiError edmiPutProtectedAttrBN(SdaiAppInstance appInstance,
SdaiString attributeName,
SdaiPrimitiveType valueType,
...); /* value */
Arguments:
appInstance |
A numeric instanceID that uniquely identifies the instance of interest in the EDMdatabase. |
attributeName |
The name of the protected attribute of interest. |
valueType |
The primitive type of the protected attribute. |
value |
The value to assign to the protected attribute. |
Returns:
A completion code of datatype EdmiError is the returned function value. The completion code has the following values:
Completion code = 0 : Operation successfully performed.
Completion code != 0: Error in operation. Completion code is an EDMinterface error code. Use edmiGetErrorText to get the error text corresponding to the error code.
Example:
EdmiError rstat;
SdaiModel modId, edmModId;
SdaiAggr adminAggrId;
SdaiInstance johnnyId, lucyId;
/* Get the sdaiModel Id */
modId = edmiGetModelBN("MyRepository", "MyModel");
/* Get Johnnys and lucys user Ids */
rstat = edmiGetUser("johnny", &johnnyId);
rstat = edmiGetUser("lucy", &lucyId);
/* Get the edm_model Id in the ExpressDataManager Model */
sdaiGetAttrBN(modId, "edm_model", sdaiINSTANCE, &edmModId);
/* Get the model administrator aggregate */
sdaiGetAttrBN(edmModId, "ADMINISTRATORS", sdaiAGGR, &adminAggrId);
/* Remove Lucy from list of model administrators */
rstat = edmiDeleteProtectedElement(adminAggrId, sdaiINSTANCE, lucyId);
/* Add Johnny to list of model administrators */
rstat = edmiAddProtectedElement(adminAggrId, sdaiINSTANCE, johnnyId);
/* Grant create_repository_rights to Johnny */
rstat = edmiPutProtectedAttrBN(johnnyId, "creating_repository_permission",
sdaiBOOLEAN, sdaiTRUE);
/* Remove the description of MyModel */
rstat = edmiUnsetProtectedAttrBN(edmModId, "description");
. . .