API browser of labValidator100 COM module


/images/arrow_right.png IValidate::CalculateSum method space
Calculate the sum of all services that have been added through the AddService method.

Patch available for tariff 317!
If the dTotal argument is set to -4242 when calling CalculateSum then the expandChapter4Services feature is turned on for all sessions. This is equivalent to define a pseudo service using the setParameter mechanism mechanism.

If the service expansion is turned on then dependent on the supplied role/place the services 4707.00 ff. are automatically added in the correct form.
4707.00 ff. services inputted prior to calling CalculateSum are taken into account and are re-calculated and adjusted accordingly! Be sure to read all service positions back to the main program in such a case.
If this feature is not used and/or the role/place dependent rues are violated then either the error code "enQuantityRestriction" or "enLimitation4707Wrong" is set

space
/images/arrow_right.png Restful webservice calling syntax
[POST] /baseURL/IValidate/CalculateSum
[JSON input data] pIValidate: longValue,    //interface address
[JSON result data] pdTotal:
pbStatus:
doubleValue,
booleanValue
 
[HTTP result status] 200 Return status 200 signals a successful method call
204 Return status 204 (noContent) signals that the end of an iteration is reached
>= 400 Return status >= 400 signals an unsuccessful function call. The returned JSON{errorCode: code, errorText:"text"} supplies the error message the same as GetAbortInfo() would do.
space
/images/arrow_right.png C/C++ calling syntax
HRESULT CalculateSum( double
VARIANT_BOOL
*pdTotal,
*pbStatus);
[C/C++ return value] S_OK This value is returned if the function call was successful.
S_FALSE This value is returned if the end of an iteration is reached
E_name This value is returned if the function call was unsuccessful and an error exception was generated. Note that if you are using SmartPointers an exception is thrown under these conditions.
space
/images/arrow_right.png Calling argument description
[out] double *pdTotal Total of all services in CHF.
[out,retval] VARIANT_BOOL *pbStatus Return status. VARIANT_TRUE means S_OK, VARIANT_FALSE means S_FALSE (e.g. in an iterator) or an error (E_name).
In the later case check for possible errors with the GetAbortInfo method.
space