...
This function adds a new System Custom Item during the initialization phase of the server and returns its ID. Compared to a normal custom item, a system custom item can be placed anywhere in the item tree. In general, this function shall be used within the OnInitEvent “OnInitEvent” callback only. Compared to the function nxa“nxa.AddSysCustomItemAddSysCustomItem”, the flags for Persistent, Historical, and Synchronziation can also be set.
Example
The following code creates an item within the branch NETx\XIO\My:
| Code Block |
|---|
nxa.AddExtSysCustomItem("MyItem1", "Test", nxa.access.All, nxa.type.Integer, false, false, false, "°C", 0, 100, "\\", "XIO", "My") |
...
Signature
string nxa.AddExtSysCustomItem (string, string, nxa.access, nxa.type, bool, bool, bool, string, number, number, string, string, string, ..., string)
Parameters
Name | Type | Mandatory/Optional | Description |
|---|---|---|---|
string | M | name of the custom item | |
string | M | description of the custom item | |
nxa.access | M | access rights of the custom item | |
nxa.type | M | the data type of the custom item | |
bool | O | sets the persistent flag (optional) | |
bool | O | sets the historical flag (optional) | |
bool | O | sets the synchronize flag (optional) | |
string | O | engineering units of the custom item (optional) | |
number | O | minimum value that is allowed for the custom item (optional) | |
number | O | maximum value that is allowed for the custom item (optional) | |
string | O | delimiter that is used to build the item ID (optional) | |
string | O | path1 (optional) | |
string | O | path2 (optional) | |
... | |||
string | O | pathN (optional) |
Return
Type | Description |
|---|---|
string | itemID of the new Custom Item |