Date: Fri, 29 Mar 2024 10:19:56 +0100 (CET) Message-ID: <1544551006.111618.1711703996310@srvdoc.doc.ipesoft.com> Subject: Exported From Confluence MIME-Version: 1.0 Content-Type: multipart/related; boundary="----=_Part_111617_1952177496.1711703996309" ------=_Part_111617_1952177496.1711703996309 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Content-Location: file:///C:/exported.html
The function D2_ArchArr provides a more effective access to histo= rical values of D2000 system.
D2_ArchArr
(archObjName,bt, et, step, at= tribute, bDirectionByRow, refresh)
archObjName | TEXT |
|
bt | ABS. TIME t= ype | Begin time of the archive block. |
et | ABS. TIME t= ype | End time of the archive block. |
step | INT type | Time step [s] within the archive block. |
attribute | TEXT type= td> | Required attribute of historical value. |
bDirectionByRow | BOOL type= td> | Time order of cells in matrix. |
refresh | Optional parameter. |
The procedure above has created a matrix containing selected cells.= Expression is the same in all the cells.
The function returns an array of required attributes of the archive valu= es (the parameter attribute =E2=80=93 see the function D2_GetValue) of defined historical value. The parameters bt and et defi= nes a time order of cells of the matrix. It is important only for matrix co= ntaining at once several rows and several columns. If the value of the para= meter is TRUE, the values (ascending order by time) are inserted into cells= row by row. Otherwise the values are inserted into cells column by column.=
The parameter refresh - see the function D2_GetValue.
Value time from the archive is defined by is defined by the relativ=
e position of the cell containing the function call and the matrix in which=
the cell is placed.
the times of individual values in cells, according the matrix range and = the parameter bDirectionByRow, will be as follows:
The return value of the function for all the values out of required inte= rval is an error message: #Value, or the value of the cell named = SUPP_NO_ARCH_DATA if exists (see the topic Predefined cells).