- Vytvoril D2000 Dev Team na okt 13, 2017
CALCSTATFUNC action
CALCSTATFUNC archIdent, timeFromIdent_TmA, timeToIdent_TmA, statFuncIdent_Int, validPercIdent_Int, paramIdent, retValueIdent, statusIdent_Int [,archivInstance_Int]
| archIdent | in |
Reference to one value of historical value or
reference to object, values of which have
been archived. Warning: If the parameter is the reference to an object archived several times, there is not specified which one of the historical objects is to be used. |
| timeFromItemIdent_TmA | in | Identifier of AbsTime type - interval beginning. |
| timeToItemIdent_TmA | in | Identifier of AbsTime type - interval end. |
| statFunctIdent | in | Identifier of Int type - statistical function type. |
| validPercIdent | in | Identifier of Int type - validation criteria. |
| paramIdent | in | Identifier of Int or Real types - parameter for some types of functions. |
| retValueIdent | out | Identifier for calculation result. |
| statusIdent | out | Calculation (action) success. |
| archivInstance_Int | in | Optional identifier of Int type - identification of archive instance. If the parameter is not defined, the value 0 will replace it. |
- _ERR_TRANS_ABORT
- _ERR_TRANS_ERROR
- _ERR_TRANS_IGNORED
- _ERR_NO_ERROR
Set of implemented functions is equal with the functions, which may be configured for statistical archive (except the FILTER and EACOAVG functions). For the individual functions, there are predefined local constants in ESL.
The parameter validPerctIdent_Int represents Validation criteria used during the evaluation of the statistical function. It can get values within 1 .. 100 (the error ERR_RANGE_ERROR occurs if the condition is broken).
For some statistical function, it is required to enter the parameter paramIdent according to the table:
| Statistical function | Parameter description | ||||||||
| _STAT_F_INTEGRAL |
Integral time units. For individual types,
there are also established predefined local variables according to the table:
|
||||||||
|
_STAT_F_GE_TIME _STAT_F_GT_TIME _STAT_F_LE_TIME _STAT_F_LT_TIME _STAT_F_ADDITION_PARAM _STAT_F_INCREMENT_PARAM _STAT_F_DELTA_PARAM |
Compare value |
For the other statistical archive functions, the parameter paramIdent is not being evaluated.
Value of parameter archivInstance_Int defines the instance of archive which executes the request. If the parameter is not defined (or the value is 0), the active instance of archive will execute the request.
TIME _bt
TIME _et
REAL _retValue
INT _retCode
_bt := %StrToTime("8:01:00 16-10-2003")
_et := %StrToTime("8:02:00 16-10-2003")
CALCSTATFUNC H.ArchObj, _bt, _et, _STAT_F_SUM, 100, 0, _retValue, _retCode
IF _retCode = _ERR_NO_ERROR THEN
; calculation done
ELSE
; an error occurred
ENDIF
Related pages:
0 komentárov