edmiRemoteDeleteAggrValue

EdmiError   edmiRemoteDeleteAggrValue(SdaiServerContext  serverContextId, 
                                      SdaiAggr           aggrId,      
                                      SdaiAggrIndex      index,   
                                      SdaiOptions        options,
                                      SdaiInteger        *deletedElements, 
                                      SdaiInvocationId   *edmiInvocationId, 
                                      SdaiPrimitiveType  valueType,   
                                      ...);

Deletes the first element, or optionally all elements, with a specified data value, from an aggregate in the remote EDMdatabase. For ARRAY type aggregates, the elements them selves will not be deleted. However, their values will be set to indeterminate. This function is only applicable for persistent aggregates owned by application instances.

Arguments

Type	Name	Comment
SdaiServerContext	serverContextId	Context identification, from edmiDefineServerContext
SdaiAggr	aggrId	A numeric aggregateID that uniquely identifies the aggregate of interest in the remote EDMdatabase
SdaiAggrIndex	index	The index of the element in the aggregate to start reading from. This argument is only applicable for the ordered Array and List aggregates.
SdaiOptions	options	See description of available options below. Options may be joined by using the bitwise OR operator. Default behaviour is that only the first obtained matching element will be deleted.
SdaiInteger	deletedElements	A variable that will receive the number of elements that was deleted from the aggregate.
SdaiInvocationId	edmiInvocationId	Currently not used.
SdaiPrimitiveType	valueType	The primitive type of the aggregate element value to delete.

Return Value

Error rendering macro 'excerpt-include' : User 'null' does not have permission to view the page 'US:_r_EDMInterface'.

Options

Option	Comment
DELETE_ALL_ELEMENTS	Delete all elements with the specified value from the aggregate.

Example

 /*
 SCHEMA Employees 
 ENTITY person; 
 Name : STRING; 
 Age : INTEGER; 
 END_ENTITY; 
  
 ENTITY Manning; 
 DivisionStaff : ARRAY [0:4] OF SET OF person; 
 END_ENTITY; 
 END_SCHEMA; 
 */
 #define S_TECHNICAL_DIVISION 2
 EdmiError rstat;
 SdaiInteger nHits, index;
 SdaiServerContext myContext;
 SdaiInstance manningId, johnnyId;
 SdaiAggr parentAggrId, childAggrId;
 SdaiQueryResult qexRes;
  
 /* Create Server Context */
 rstat = edmiDefineServerContext("MyContext",
 "Johnny", "Supervisor", "cf37ftr", 
 "TCP", "9090", "MyServerHost", 
 NULL, NULL, NULL, NULL, NULL, &myContext); 
  
 /* Get the manningId instance. It is assumed that
 there is only one instance type Manning */ 
 index = 0;
 nHits = 1;
 rstat = edmiRemoteSelectInstances(myContext, "AdminRepository",
 "Employees", "Manning", NULL, ONLY_INSTANCE_IDS, 
 NULL, NULL, NULL, &index, &nHits, &qexRes,  
 NULL, NULL, NULL, NULL); 
 manningId = qexRes->instanceIds[0];
 edmiFreeQueryResult(qexRes);
  
 /* Get the parent aggregate Id */
 rstat = edmiRemoteGetAttrsBN(myContext, manningId, 0, 1, NULL,
 "DivisionStaff", sdaiAGGR, &parentAggrId); 
  
 /* Get the child aggregate with staff
 info for the technical division*/ 
 rstat = edmiRemoteGetAggrElement(myContext, parentAggrId,
 0, S_TECHNICAL_DIVISION, sdaiAGGR, 
 &childAggrId, NULL); 
  
 /* Delete johnny from set of
 tecnical division employees. */ 
 index = 0;
 nHits = 1;
 rstat = edmiRemoteSelectInstances(myContext, "AdminRepository",
 "Employees", "Person", "(NAME = 'Johnny') AND (AGE = 32)",  
 ONLY_INSTANCE_IDS, NULL, NULL, NULL, 
 &index, &nHits, &qexRes, NULL, NULL, NULL, NULL); 
 johnnyId = qexRes->instanceIds[0];
 edmiFreeQueryResult(qexRes);
  
 /* Delete Johnny from the aggregate of
 employees in the technical division */ 
 rstat = edmiRemoteDeleteAggrValue(myContext,
 childAggrId, 0, DELETE_ALL_ELEMENTS, 
 &nHits, NULL, sdaiINSTANCE, johnnyId); 
  
 if (nHits) {
 printf("\nJohnny is no longer an employee!"); 
 } else {
 printf("\nWarning! Could not find Johnny"); 
 }
 . . .

EDMsix

edmiRemoteDeleteAggrValue

Arguments

Return Value

Options

Example

See also

Filter by label