Difference between revisions of "Global Object Edit"

From Control Solutions IoTServer Documentation
Jump to navigation Jump to search
(Created page with "'''Number''' – (REQUIRED) The local object number being defined (first object is 1). '''Type''' – Valid parameters for type, referring to native data type, are as follows...")
 
 
(9 intermediate revisions by the same user not shown)
Line 1: Line 1:
'''Number''' – (REQUIRED) The local object number being defined (first object is 1).
+
[[File:Global object edit 1.jpg]]
 +
 
 +
'''Number''' – The local object number being defined (first object is 1).
 +
 
 +
[[File:Global object edit 2.jpg]]
 +
 
 +
'''Name''' – Arbitrary name for the data object, generally visible in web UI’s. CSV import will insert “Object name N” if omitted.
 +
 
 +
'''Description''' – Arbitrary description of the object provided by the user. CSV import will insert “Object N description” if omitted.
 +
 
 +
[[File:Global object edit 3.jpg]]
  
 
'''Type''' – Valid parameters for type, referring to native data type, are as follows (CSV will assume integer if omitted):
 
'''Type''' – Valid parameters for type, referring to native data type, are as follows (CSV will assume integer if omitted):
Line 18: Line 28:
 
'''Length''' – If type is “char”, then this specifies how many character long the string is. Not used for any type other than char. Length should be an integer. CSV import will assume maximum permitted value if omitted.
 
'''Length''' – If type is “char”, then this specifies how many character long the string is. Not used for any type other than char. Length should be an integer. CSV import will assume maximum permitted value if omitted.
  
'''Name''' – Arbitrary name for the data object, generally visible in web UI’s. CSV import will insert “Object name N” if omitted.
+
[[File:Global object edit 4.jpg]]
 
 
'''Desc''' – Arbitrary description of the object provided by the user. CSV import will insert “Object N description” if omitted.
 
  
 
'''Location''' – Arbitrary location string further documenting the object. CSV import will insert “Location N” if omitted.
 
'''Location''' – Arbitrary location string further documenting the object. CSV import will insert “Location N” if omitted.
Line 26: Line 34:
 
'''Units''' – Arbitrary units string further documenting the object. CSV import will insert “No units” if omitted.
 
'''Units''' – Arbitrary units string further documenting the object. CSV import will insert “No units” if omitted.
  
'''Refresh''' – A timeout in seconds, if nonzero. If the object is not updated within this amount of time, its state will be changed to “stale”. If zero, the timeout feature is disabled and the object will never become stale. Timeout should be an integer. Will default to zero.  
+
[[File:Global object edit 5a.jpg]]
 +
 
 +
'''Refresh Timeout''' – A timeout in seconds, if nonzero. If the object is not updated within this amount of time, its status will be changed to “stale”. If zero, the timeout feature is disabled and the object will never become stale. Timeout should be an integer. Will default to zero.
 +
 
 +
'''Default on Timeout''' - Check to set object to default value upon refresh timeout (in addition to setting status to "stale"). This is especially useful for SNMP table walks of alarm tables to cause object value to return to zero when alarm is no longer found to exist. 
 +
 
 +
[[File:Global object edit 5b.jpg]]
 +
 
 +
'''Default Value''' – Default value to be applied upon startup if requested, may be integer or real (but not character). Will default to zero.
 +
 
 +
'''Default On Startup''' – Check to indicate that this object should be set to the default value at startup.
 +
 
 +
'''Is Persistent''' – Check to indicate this object is “persistent”, which means saved in non-volatile memory. This non-volatile memory is implemented as a database stored in Flash memory. Upon startup, the object will assume its last known value as found in the database. Any changes to the object’s value will be recorded in the database for future use. If not persistent, objects will start up with a value of zero, unless the "default on start" has been selected.
  
'''DefValue''' – Default value to be applied upon startup if requested, may be integer or real (but not character). Will default to zero.  
+
NOTE: You would not normally select both "default on startup" and "is persistent" because these will contradict each other.  
  
'''DefOnStart''' – Flag set to “Y” to indicate that this object should be set to the default value at startup, or “N” otherwise (“N” assumed if omitted).
+
[[File:Global object edit 6.jpg]]
  
'''Persistent''' – Flag set to “Y” to indicate this object is “persistent”, which means saved in non-volatile memory. This non-volatile memory is implemented as a database stored in Flash memory. Upon startup, the object will assume its last known value as found in the database. Any changes to the object’s value will be recorded in the database for future use. If not persistent, set flag to “N” (“N” assumed if omitted).
+
To add or insert new objects, enter a number of objects to add, and select a starting point. Then click the Add button.

Latest revision as of 14:06, 20 May 2019

Global object edit 1.jpg

Number – The local object number being defined (first object is 1).

Global object edit 2.jpg

Name – Arbitrary name for the data object, generally visible in web UI’s. CSV import will insert “Object name N” if omitted.

Description – Arbitrary description of the object provided by the user. CSV import will insert “Object N description” if omitted.

Global object edit 3.jpg

Type – Valid parameters for type, referring to native data type, are as follows (CSV will assume integer if omitted):

Type label Description
Int 32-bit integer
Int64 64-bit integer
Real Floating point (double precision)
Char ASCII character string

Length – If type is “char”, then this specifies how many character long the string is. Not used for any type other than char. Length should be an integer. CSV import will assume maximum permitted value if omitted.

Global object edit 4.jpg

Location – Arbitrary location string further documenting the object. CSV import will insert “Location N” if omitted.

Units – Arbitrary units string further documenting the object. CSV import will insert “No units” if omitted.

Global object edit 5a.jpg

Refresh Timeout – A timeout in seconds, if nonzero. If the object is not updated within this amount of time, its status will be changed to “stale”. If zero, the timeout feature is disabled and the object will never become stale. Timeout should be an integer. Will default to zero.

Default on Timeout - Check to set object to default value upon refresh timeout (in addition to setting status to "stale"). This is especially useful for SNMP table walks of alarm tables to cause object value to return to zero when alarm is no longer found to exist.

Global object edit 5b.jpg

Default Value – Default value to be applied upon startup if requested, may be integer or real (but not character). Will default to zero.

Default On Startup – Check to indicate that this object should be set to the default value at startup.

Is Persistent – Check to indicate this object is “persistent”, which means saved in non-volatile memory. This non-volatile memory is implemented as a database stored in Flash memory. Upon startup, the object will assume its last known value as found in the database. Any changes to the object’s value will be recorded in the database for future use. If not persistent, objects will start up with a value of zero, unless the "default on start" has been selected.

NOTE: You would not normally select both "default on startup" and "is persistent" because these will contradict each other.

Global object edit 6.jpg

To add or insert new objects, enter a number of objects to add, and select a starting point. Then click the Add button.