...
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 callback only. Compared to the function nxa.AddSysCustomItem, the flags for Persistent, Historical, and Synchronziation can also be set.
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 |