Tag Setting


Contents

  1. Display tag setting screen
  2. Tag setting list
  3. Engineering Value Conversion
  4. Page scroll button
  5. Sort
  6. Save setting to CSV
  7. Read and Merge CSV
  8. Save setting

Display Tag Setting Screen

You can move to this page by clicking the button in "Operation" in the device list button, or the "Tag setting" button in Device setting.



In "Tag setting", details of data that is sent from the device to the cloud can be set.

The tags set here can be used in the screen (page) editing environment. Refer to Here for the usage.


Tag Setting List

Cloud Key

This displays the cloud key of device data. For the cloud key setting, refer to the cloud key setting of the Device setting.

Extracting Column No.

This displays the extracting column number of device data. The extracting column number is the order of the data in the CSV data to be sent from the CONPROSYS device to the cloud.

Auto Name

This displays the name that is automatically generated on the device side of the device data.

Tag Name

This sets the tag name of the device data.
It is recommended to set the name of the data so that it is easy to use in the screen editing environment. Available letters are limited to numeric number and an underscore. The length of the name is up to 20 letters.

Setting without a tag name (blank) cannot be done.

In this document, device data is called a tag hereafter.

Refer Here for how to use the tag in the screen (page) editing environment .

Note: The tag name cannot be changed if the device is used as template.

Data Comment

This sets the data comment of the tag. The data comment appears when Device tree is shown.

The Data Comment can be obtained and displayed on the HMI by connecting to [dt:deviceid.cloudkey:Tagname#name].

Data comment can not be empty. The comment should be set within 40 letters, and double (") / single (') quotations, comma (,) cannot be used.

Data Type

This sets the data type of the tag. There are five types of data types that can be selected: 'Real', 'Integer', 'Unsigned Integer', 'Boolean', and 'String'.

Note: The data type cannot be changed if the device is used as template.

Data Size

You can edit the data size of the tag. The maximum data size depends on the data type of each tag. The maximum value for each data type is listed below.

The maximum value for each data type
Data TypeMaximum SizeRange
Real(numeric)4 (1 and 3 cannot be set)Before the decimal point, 131072 digits. After the decimal point, 16383 digits.
Intege(integer)2-2147483648 to +2147483647
Unsigned Integer(unsigned int)2-9223372036854775808 to +9223372036854775807
Boolean(boolean)1
String(text)128

The data size 1 here means one word. One word is two-byte.

*: When the number exceeds the total number of device data, or if it does not match the default data size, the setting will be limited in addition to the maximum values.

When the data size is changed, the data size of other tag within that range becomes 0, and the tag name becomes blank (null character). Tags whose data size is 0 cannot be edited.

Note: The data size cannot be changed if the device is used as template.

Unit

This sets the tag unit.

The unit should be set within 20 letters, and double (") /single (') quotations, comma (,) cannot be used.

The Unit can be obtained and displayed on the HMI by connecting to [dt:deviceid.cloudkey:Tagname#unit].

Engineering Value Conversion

You can edit the engineering value conversion of the tag. The engineering value conversion can be set when the data types are not 'True False' or 'String'.

Click button to display the editing window of engineering value conversion for the selected tag.

For the engineering value conversion editing, refer to Engineering Value Conversion formula.

Engineering Value Reversion

You can edit the engineering value reversion of the tag. Engineering value reversion can be set only when the data type is not 'Boolean ' or 'String', and the access type should 2 and 3.

Value Low Limit

Sets the lower limit of the value stored in the tag. The lower limit can be set when the data type is other than 'Boolean', 'String', or 'String(Direct)'.

Value High Limit

Sets the higher limit of the value stored in the tag. The higher limit can be set when the data type is other than 'Boolean', 'String', or 'String(Direct)'.


Input Formula for Engineering Value Conversion Formula

Assign to variable

Click “Assign to variable”, insert “data” meaning the raw data into the input area.

Operator

Click “Operator” to display the input panel of operators that can be used for Engineering Value Conversion.。

By clicking the operator on the panel, you can enter the selected operator into the input area of Engineering Value Conversion.

Function

Click “Function” to display the list of functions that can be used for Engineering Value Conversion.

By clicking the function, you can enter the selected function into the input area of Engineering Value Conversion. Currently, abs (absolute value function) is only supported.

Confirm

This confirms Engineering Value Conversion formula.

The confirmed contents are displayed below.

Cancel

This cancels entering the formula of Engineering Value Conversion.

OK

This completes the entering the formula of Engineering Value Conversion.

This cannot be clicked unless it is confirmed that there are no errors in the format of Engineering Value Conversion.


Sort

By clicking "Extracting Column No", "Tagname" etc. on the screen, you can rearrange the tag list in ascending or descending order in the column.

Page Scroll Button

button: This displays the previous page in the list.

button: This displays the next page in the list.

Quick Filter(c:t) Enter box：This displays the tag containing this string within its tag name in the list.

Also, you can separate them with colon and search those using cloud key.


Read and Merge CSV

To read the CSV settings, click the "Read and Merge CSV" button and select the file.

Refers to #device_id ,cloud_key ,tag_name_auto for merging. The contents to be read are information of tag_name,data_name,data_type,data_size,unit,calc_formula,calc_formula_reverse,data_lower_limit,data_upper_limit.

The only valid file is the UTF-8 csv file.

However, tag_name,data_type,data_size will not be read in if the device is used as template.


Save setting to CSV

Click "Save setting as CSV file" to get settings in CSV file.

File format is UTF-8 with BOM.

CSV format of tag setting is as following.

Column name in the first line Column index Description
#device_id 1 A string identifying a unique device in this project.
device_serial_no 2 A string of uppercase alphanumeric characters that identifies the device.
cloud_key 3 A string representing the cloud key (data group).
data_column_no 4 A numeric index represents the column number in the CSV data to be sent from the device to the server.
tag_name_auto 5 A string representing automatically generated name.
tag_name 6 A string representing the data as Tag Name.
data_name 7 A string representing Data Comment.
data_type 8 A numeric value that represents Data Type in tag settings.
  • 0:Real
  • 1:Integer
  • 2:Unsigned Integer
  • 3:Boolean
  • 4:String
  • 5:Value(Direct)
  • 6:String(Direct)
  • 7:Real(LE)
  • 8:Integer(LE)
  • 9:Unsigned Integer(LE)
data_size 9 A numeric value that represents Data Size in tag settings.
The values for which the data size can be set depend on the data type, and are as follows.
  • Real,Real(LE):2,4
  • Integer,Integer(LE):1,2
  • Unsigned Integer,Unsigned Integer(LE):1,2
  • Boolean:1
  • Value(Direct):1
  • String:1~128
  • String(Direct):1
unit 10 A string representing data Unit in tag settings.
calc_formula 11 A string representing Engineering Value Conversion in tag settings.
calc_formula_reverse 12 A string representing Engineering Value Reversion in tag settings.
This can be set only when the access type is Write or Read/Write.
access_type 13 A numeric value indicating Access Type displayed in the HMI device tree, which is supported as follows.
  • 1:Read

  • 2:Write

    data_type: Only Value(Direct) can be set.

  • 3:Read/Write

    data_type: Only Boolean or Value(Direct), String(Direct) can be set.
write_address 14 Specify the Modbus start address of CONPROSYS (M2M Gateway) that writes to PLC in decimal number.
When 0 is specified, it is assigned to 0x2000 of the input register of CONPROSYS, and data can be written from the Server to the PLC via CONPROSYS.
* The PLC setting of CONPROSYS is also required.
Please refer to the device setting of CONPROSYS for the setting method.
[Range] 0-10239 Empty string if not used
used_flag 15 A boolean value corresponding to the logger flag in the logger settings.
  • true:Enable logger flag
  • false:Disable logger flag
data_coefficient 16 A numeric value corresponding to Data Coefficient in the logger settigns.
data_sum_type 17 A numeric value corresponding to Data Aggregation Type in the logger settings.
  • 1:Accumulative
  • 2:Average
  • 3:Instant
  • 4:Last
data_value_type 18 A numeric value corresponding to Value Type in the logger settings.
  • 1:Straight
  • 2:Incremental
  • 3:Upper Limit
data_cycle_min_value 19 A numeric value corresponding to Min Accumulative Value in the logger settings.
data_cycle_max_value 20 A numeric value corresponding to Max Accumulative Value in the logger settings.
data_lower_limit 21 A numeric value corresponding to Value Low Limit in the tag settings.
data_upper_limit 22 A numeric value corresponding to Value High Limit in the tag settings.

Save Setting

"Save" button

This saves the page currently being edited. A warning message might be displayed according to the contents of change.

When the warning appears, check the contents. When you are certain that there is no problem, click “OK”. To cancel, click "Cancel" button or X button on the screen.

"Save and Exit" button

This saves the page currently being edited. A warning message might be displayed according to the contents of change.

When the warning appears, check the contents. When you are certain that there is no problem, click “OK”. To cancel, click "Cancel" button or X button on the screen.。

After completing the saving, it returns to the previous page from the current editing page.

"Cancel" button

This returns to the previous page from the current editing page.

Any unsaved edits will be discarded.