From OpenSCADAWiki
Jump to: navigation, search
(Importing a new version from external source)
(Importing a new version from external source)
Line 9: Line 9:
 
* ''bool toStart( );'' — Sign: "Start the archive when starting the system".
 
* ''bool toStart( );'' — Sign: "Start the archive when starting the system".
 
* ''bool startStat( );'' — Status: "Archive started".
 
* ''bool startStat( );'' — Status: "Archive started".
* ''string DB( ) const;'' — DB address of the values' archive.
+
* ''string DB( bool qTop = false ) const;'' — Storage address of the values' archive, ''qTop'' for the storage queue top.
 
* ''string tbl( );'' — DB table of the values' archive.
 
* ''string tbl( );'' — DB table of the values' archive.
* ''string fullDB( );'' — Full name of the DB table of the values' archive.
+
* ''string fullDB( bool qTop = false );'' — Full name of the storage table of the values' archive, ''qTop'' for the storage queue top.
 
* ''int64_t end( const string &arch = BUF_ARCH_NM );'' — End of the archive time at whole (arch="") or the specified archiver, buffer (arch="<bufer>").
 
* ''int64_t end( const string &arch = BUF_ARCH_NM );'' — End of the archive time at whole (arch="") or the specified archiver, buffer (arch="<bufer>").
 
* ''int64_t begin( const string &arch = BUF_ARCH_NM );'' — Start of the archive time at whole (arch="") or the specified archiver, buffer (arch="<bufer>").
 
* ''int64_t begin( const string &arch = BUF_ARCH_NM );'' — Start of the archive time at whole (arch="") or the specified archiver, buffer (arch="<bufer>").
Line 24: Line 24:
 
* ''void setSrcMode( SrcMode vl = SaveCur, const string &isrc = "<*>", bool noex = false );'' — Setting the linkage mode with the data source.
 
* ''void setSrcMode( SrcMode vl = SaveCur, const string &isrc = "<*>", bool noex = false );'' — Setting the linkage mode with the data source.
 
* ''void setToStart( bool vl );'' — Setting the sign: "Start the archive when starting the system".
 
* ''void setToStart( bool vl );'' — Setting the sign: "Start the archive when starting the system".
* ''void setDB( const string &idb );'' — Setting the DB address of the values' archive.
+
* ''void setDB( const string &vl, bool qTop = false );'' — Setting the storage address of the values' archive, ''qTop'' for the storage queue top.
 
* ''void setValType( TFld::Type vl );'' — Setting the type of the archived value.
 
* ''void setValType( TFld::Type vl );'' — Setting the type of the archived value.
 
* ''void setHardGrid( bool vl );'' — Setting the using of the hard grid in the archive buffer.
 
* ''void setHardGrid( bool vl );'' — Setting the using of the hard grid in the archive buffer.

Revision as of 11:49, 14 September 2021

Information about message (contribute)
This message has no documentation. If you know where or how this message is used, you can help other translators by adding documentation to this message.
Message definition (Documents/API)
'''Public methods:'''
* ''TVArchive( const string &id, const string &db, TElem *cf_el );'' — Initializing constructor of the archive, where ''id'' — archive ID, ''db'' — DB for storage and ''cf_el'' — DB structure of the values' archives.
* ''string id( );'' — Archive's ID.
* ''string name( );'' — Archive's name.
* ''string dscr( );'' — Archive's description.
* ''SrcMode srcMode( );'' — Linkage mode with the data source.
* ''AutoHD<TVal> srcPAttr( bool force = false, const string &ipath = "" );'' — Connect to associated attribute of parameter of data source.
* ''string srcData( );'' — Parameters of the data source, in the case of access mode to the parameter this is the address of the parameter.
* ''bool toStart( );'' — Sign: "Start the archive when starting the system".
* ''bool startStat( );'' — Status: "Archive started".
* ''string DB( bool qTop = false ) const;'' — Storage address of the values' archive, ''qTop'' for the storage queue top.
* ''string tbl( );'' — DB table of the values' archive.
* ''string fullDB( bool qTop = false );'' — Full name of the storage table of the values' archive, ''qTop'' for the storage queue top.
* ''int64_t end( const string &arch = ARCH_BUF );'' — End of the archive time at whole (arch="") or the specified archiver, buffer (arch="<bufer>").
* ''int64_t begin( const string &arch = ARCH_BUF );'' — Start of the archive time at whole (arch="") or the specified archiver, buffer (arch="<bufer>").
* ''int64_t period( const string &arch = ARCH_BUF );'' — Periodicity of the archive buffer or the specified archiver (microseconds).
* ''TFld::Type valType( bool full = false );'' — Type of the archived value. ''full'' — request full type, else only generic.
* ''bool hardGrid( );'' — Using of the hard grid in the archive buffer.
* ''bool highResTm( );'' — Using of the high-resolution time in the archive buffer (microseconds).
* ''bool fillLast( );'' — Fill pass points to a last value. Mostly the pass values fill by EVAL but sometime the source's data periodicity greater to the archive's one and it is normal.
* ''int size( );'' — Archive buffer size (units).
* ''void setName( const string &inm );'' — Setting the name of the archive.
* ''void setDscr( const string &idscr );'' — Setting the description of the archive.
* ''void setSrcMode( SrcMode vl = SaveCur, const string &isrc = "<*>", bool noex = false );'' — Setting the linkage mode with the data source.
* ''void setToStart( bool vl );'' — Setting the sign: "Start the archive when starting the system".
* ''void setDB( const string &vl, bool qTop = false );'' — Setting the storage address of the values' archive, ''qTop'' for the storage queue top.
* ''void setValType( TFld::Type vl );'' — Setting the type of the archived value.
* ''void setHardGrid( bool vl );'' — Setting the using of the hard grid in the archive buffer.
* ''void setHighResTm( bool vl );'' — Setting of using of the high-resolution time in the archive buffer (microseconds).
* ''void setFillLast( bool vl );'' — Set to fill pass points to a last value.
* ''void setSize( int vl );'' — Setting of the archive buffer size (units).
* ''void setPeriod( int64_t vl );'' — Setting the periodicity of the archive buffer.
* ''void start( );'' — Start of the archive.
* ''void stop( bool full_del = false );'' — Stop of the archive with it's completely deleting ''full_del''.
* ''TVariant getVal( int64_t *tm = NULL, bool up_ord = false, const string &arch = "", bool onlyLocal = false );'' — Request of the single value for the time ''tm'' and with the sign of the moving to the top ''up_ord'' from the specified archiver ''arch'', buffer (arch = "<bufer>") or from all archivers in the course of falling quality (arch =""). To process the request only by the local station ''onlyLocal'' is set.
* ''void getVals( TValBuf &buf, int64_t beg = 0, int64_t end = 0, const string &arch = "", int limit = 100000, bool onlyLocal = false );'' — Request of the values' frame ''buf'' for the time from ''beg'' to ''end'' from the specified archiver ''arch'', buffer (arch = "<bufer>") or from the all archivers in the course of falling quality (arch =""), limiting the size of the request ''limit'' of the record. To request only the local archives, without compensation gaps in the archives from the backup stations, set ''onlyLocal''.
* ''void setVals( TValBuf &buf, int64_t beg, int64_t end, const string &arch );'' — Set of the values' frame ''buf'' for the time from ''beg'' to ''end'' to the specified archiver ''arch'', buffer (arch = "<bufer">) or to all archivers (arch ="").
* ''void getActiveData( const int64_t &tm = 0 );'' — To interrogate the data source with forcing time-stamp to ''tm'' (not zero). Is used for periodic data acquisition by the active archives in the subsystem.
* ''void archivatorList( vector<string> &ls );'' — List of archivers which serves the archive.
* ''bool archivatorPresent( const string &arch );'' — Check the archiver for it's servicing of the given archive.
* ''void archivatorAttach( const string &arch );'' — Connecting the archive to be served by the specified archiver.
* ''void archivatorDetach( const string &arch, bool full = false );'' — Disabling this archive from the servicing of the specified archiver.
* ''void archivatorSort( );'' — Sort of the serving archivers in the order of decreasing quality.
* ''string makeTrendImg( int64_t beg, int64_t end, const string &arch, int hsz = 650, int vsz = 230 );'' — Building of the (pdf) image of the trend for the specified amount of time ''beg, end'' and for this archiver ''arch''.
* ''TArchiveS &owner( ) const;'' — Subsystem "Archives" - the owner of the archive of values.
Translation'''Public methods:'''
* ''TVArchive( const string &id, const string &db, TElem *cf_el );'' — Initializing constructor of the archive, where ''id'' — archive ID, ''db'' — DB for storage and ''cf_el'' — DB structure of the values' archives.
* ''string id( );'' — Archive's ID.
* ''string name( );'' — Archive's name.
* ''string dscr( );'' — Archive's description.
* ''SrcMode srcMode( );'' — Linkage mode with the data source.
* ''AutoHD<TVal> srcPAttr( bool force = false, const string &ipath = "" );'' — Connect to associated attribute of parameter of data source.
* ''string srcData( );'' — Parameters of the data source, in the case of access mode to the parameter this is the address of the parameter.
* ''bool toStart( );'' — Sign: "Start the archive when starting the system".
* ''bool startStat( );'' — Status: "Archive started".
* ''string DB( bool qTop = false ) const;'' — Storage address of the values' archive, ''qTop'' for the storage queue top.
* ''string tbl( );'' — DB table of the values' archive.
* ''string fullDB( bool qTop = false );'' — Full name of the storage table of the values' archive, ''qTop'' for the storage queue top.
* ''int64_t end( const string &arch = BUF_ARCH_NM );'' — End of the archive time at whole (arch="") or the specified archiver, buffer (arch="<bufer>").
* ''int64_t begin( const string &arch = BUF_ARCH_NM );'' — Start of the archive time at whole (arch="") or the specified archiver, buffer (arch="<bufer>").
* ''int64_t period( const string &arch = BUF_ARCH_NM );'' — Periodicity of the archive buffer or the specified archiver (microseconds).
* ''TFld::Type valType( bool full = false );'' — Type of the archived value. ''full'' — request full type, else only generic.
* ''bool hardGrid( );'' — Using of the hard grid in the archive buffer.
* ''bool highResTm( );'' — Using of the high-resolution time in the archive buffer (microseconds).
* ''bool fillLast( );'' — Fill pass points to a last value. Mostly the pass values fill by EVAL but sometime the source's data periodicity greater to the archive's one and it is normal.
* ''int size( );'' — Archive buffer size (units).
* ''void setName( const string &inm );'' — Setting the name of the archive.
* ''void setDscr( const string &idscr );'' — Setting the description of the archive.
* ''void setSrcMode( SrcMode vl = SaveCur, const string &isrc = "<*>", bool noex = false );'' — Setting the linkage mode with the data source.
* ''void setToStart( bool vl );'' — Setting the sign: "Start the archive when starting the system".
* ''void setDB( const string &vl, bool qTop = false );'' — Setting the storage address of the values' archive, ''qTop'' for the storage queue top.
* ''void setValType( TFld::Type vl );'' — Setting the type of the archived value.
* ''void setHardGrid( bool vl );'' — Setting the using of the hard grid in the archive buffer.
* ''void setHighResTm( bool vl );'' — Setting of using of the high-resolution time in the archive buffer (microseconds).
* ''void setFillLast( bool vl );'' — Set to fill pass points to a last value.
* ''void setSize( int vl );'' — Setting of the archive buffer size (units).
* ''void setPeriod( int64_t vl );'' — Setting the periodicity of the archive buffer.
* ''void start( );'' — Start of the archive.
* ''void stop( bool full_del = false );'' — Stop of the archive with it's completely deleting ''full_del''.
* ''TVariant getVal( int64_t *tm = NULL, bool up_ord = false, const string &arch = "", bool onlyLocal = false );'' — Request of the single value for the time ''tm'' and with the sign of the moving to the top ''up_ord'' from the specified archiver ''arch'', buffer (arch = "<bufer>") or from all archivers in the course of falling quality (arch =""). To process the request only by the local station ''onlyLocal'' is set.
* ''void getVals( TValBuf &buf, int64_t beg = 0, int64_t end = 0, const string &arch = "", int limit = 100000, bool onlyLocal = false );'' — Request of the values' frame ''buf'' for the time from ''beg'' to ''end'' from the specified archiver ''arch'', buffer (arch = "<bufer>") or from the all archivers in the course of falling quality (arch =""), limiting the size of the request ''limit'' of the record. To request only the local archives, without compensation gaps in the archives from the backup stations, set ''onlyLocal''.
* ''void setVals( TValBuf &buf, int64_t beg, int64_t end, const string &arch );'' — Set of the values' frame ''buf'' for the time from ''beg'' to ''end'' to the specified archiver ''arch'', buffer (arch = "<bufer">) or to all archivers (arch ="").
* ''void getActiveData( const int64_t &tm = 0 );'' — To interrogate the data source with forcing time-stamp to ''tm'' (not zero). Is used for periodic data acquisition by the active archives in the subsystem.
* ''void archivatorList( vector<string> &ls );'' — List of archivers which serves the archive.
* ''bool archivatorPresent( const string &arch );'' — Check the archiver for it's servicing of the given archive.
* ''void archivatorAttach( const string &arch );'' — Connecting the archive to be served by the specified archiver.
* ''void archivatorDetach( const string &arch, bool full = false );'' — Disabling this archive from the servicing of the specified archiver.
* ''void archivatorSort( );'' — Sort of the serving archivers in the order of decreasing quality.
* ''string makeTrendImg( int64_t beg, int64_t end, const string &arch, int hsz = 650, int vsz = 230 );'' — Building of the (pdf) image of the trend for the specified amount of time ''beg, end'' and for this archiver ''arch''.
* ''TArchiveS &owner( ) const;'' — Subsystem "Archives" - the owner of the archive of values.

Public methods:

  • TVArchive( const string &id, const string &db, TElem *cf_el ); — Initializing constructor of the archive, where id — archive ID, db — DB for storage and cf_el — DB structure of the values' archives.
  • string id( ); — Archive's ID.
  • string name( ); — Archive's name.
  • string dscr( ); — Archive's description.
  • SrcMode srcMode( ); — Linkage mode with the data source.
  • AutoHD<TVal> srcPAttr( bool force = false, const string &ipath = "" ); — Connect to associated attribute of parameter of data source.
  • string srcData( ); — Parameters of the data source, in the case of access mode to the parameter this is the address of the parameter.
  • bool toStart( ); — Sign: "Start the archive when starting the system".
  • bool startStat( ); — Status: "Archive started".
  • string DB( bool qTop = false ) const; — Storage address of the values' archive, qTop for the storage queue top.
  • string tbl( ); — DB table of the values' archive.
  • string fullDB( bool qTop = false ); — Full name of the storage table of the values' archive, qTop for the storage queue top.
  • int64_t end( const string &arch = BUF_ARCH_NM ); — End of the archive time at whole (arch="") or the specified archiver, buffer (arch="<bufer>").
  • int64_t begin( const string &arch = BUF_ARCH_NM ); — Start of the archive time at whole (arch="") or the specified archiver, buffer (arch="<bufer>").
  • int64_t period( const string &arch = BUF_ARCH_NM ); — Periodicity of the archive buffer or the specified archiver (microseconds).
  • TFld::Type valType( bool full = false ); — Type of the archived value. full — request full type, else only generic.
  • bool hardGrid( ); — Using of the hard grid in the archive buffer.
  • bool highResTm( ); — Using of the high-resolution time in the archive buffer (microseconds).
  • bool fillLast( ); — Fill pass points to a last value. Mostly the pass values fill by EVAL but sometime the source's data periodicity greater to the archive's one and it is normal.
  • int size( ); — Archive buffer size (units).
  • void setName( const string &inm ); — Setting the name of the archive.
  • void setDscr( const string &idscr ); — Setting the description of the archive.
  • void setSrcMode( SrcMode vl = SaveCur, const string &isrc = "<*>", bool noex = false ); — Setting the linkage mode with the data source.
  • void setToStart( bool vl ); — Setting the sign: "Start the archive when starting the system".
  • void setDB( const string &vl, bool qTop = false ); — Setting the storage address of the values' archive, qTop for the storage queue top.
  • void setValType( TFld::Type vl ); — Setting the type of the archived value.
  • void setHardGrid( bool vl ); — Setting the using of the hard grid in the archive buffer.
  • void setHighResTm( bool vl ); — Setting of using of the high-resolution time in the archive buffer (microseconds).
  • void setFillLast( bool vl ); — Set to fill pass points to a last value.
  • void setSize( int vl ); — Setting of the archive buffer size (units).
  • void setPeriod( int64_t vl ); — Setting the periodicity of the archive buffer.
  • void start( ); — Start of the archive.
  • void stop( bool full_del = false ); — Stop of the archive with it's completely deleting full_del.
  • TVariant getVal( int64_t *tm = NULL, bool up_ord = false, const string &arch = "", bool onlyLocal = false ); — Request of the single value for the time tm and with the sign of the moving to the top up_ord from the specified archiver arch, buffer (arch = "<bufer>") or from all archivers in the course of falling quality (arch =""). To process the request only by the local station onlyLocal is set.
  • void getVals( TValBuf &buf, int64_t beg = 0, int64_t end = 0, const string &arch = "", int limit = 100000, bool onlyLocal = false ); — Request of the values' frame buf for the time from beg to end from the specified archiver arch, buffer (arch = "<bufer>") or from the all archivers in the course of falling quality (arch =""), limiting the size of the request limit of the record. To request only the local archives, without compensation gaps in the archives from the backup stations, set onlyLocal.
  • void setVals( TValBuf &buf, int64_t beg, int64_t end, const string &arch ); — Set of the values' frame buf for the time from beg to end to the specified archiver arch, buffer (arch = "<bufer">) or to all archivers (arch ="").
  • void getActiveData( const int64_t &tm = 0 ); — To interrogate the data source with forcing time-stamp to tm (not zero). Is used for periodic data acquisition by the active archives in the subsystem.
  • void archivatorList( vector<string> &ls ); — List of archivers which serves the archive.
  • bool archivatorPresent( const string &arch ); — Check the archiver for it's servicing of the given archive.
  • void archivatorAttach( const string &arch ); — Connecting the archive to be served by the specified archiver.
  • void archivatorDetach( const string &arch, bool full = false ); — Disabling this archive from the servicing of the specified archiver.
  • void archivatorSort( ); — Sort of the serving archivers in the order of decreasing quality.
  • string makeTrendImg( int64_t beg, int64_t end, const string &arch, int hsz = 650, int vsz = 230 ); — Building of the (pdf) image of the trend for the specified amount of time beg, end and for this archiver arch.
  • TArchiveS &owner( ) const; — Subsystem "Archives" - the owner of the archive of values.