{"id":16604,"date":"2017-10-06T13:56:20","date_gmt":"2017-10-06T05:56:20","guid":{"rendered":"http:\/\/localhost\/help\/?page_id=16604"},"modified":"2024-07-04T15:03:06","modified_gmt":"2024-07-04T07:03:06","slug":"editing-tags","status":"publish","type":"page","link":"https:\/\/oihelp.corporate.ifs.com\/help\/p2-server\/configuring-your-system\/editing-tags\/","title":{"rendered":"Editing Tags"},"content":{"rendered":"

<\/p>\n

This article applies to IFS OI Server versions 4.5.3 and later. For more, see Release History<\/a>.<\/p>\n

Every now and then, you may\u00a0need to edit a tag in your system after it has been fetched from the historian. You can edit\u00a0a tag using Server Management or the Import\/Export spreadsheet.<\/p>\n

Server Management<\/span><\/h2>\n

In IFS OI Server Management, editing a tag is performed through the Configuration \"configurationicon\"\u00a0menu option:<\/p>\n

Prerequisite Step<\/strong>: Creating a Tag Datasource<\/a><\/p>\n

1. Open IFS OI Server Management, and click the Configuration<\/strong>\u00a0icon.\u00a0<\/p>\n

2. Click Datasources<\/strong>.<\/p>\n

3. Click the datasource containing the tag you want to edit.<\/p>\n

\"\"<\/a>\u00a0<\/p>\n

4. On the Datasource page, click the tag you want to edit.\u00a0<\/p>\n

\"\"<\/a><\/p>\n

5. Edit the fields as required.<\/p>\n

You are able to edit the following fields:<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n
Name<\/strong><\/td>\n\n

Note that the name cannot contain reserved characters.<\/p>\n

See also<\/strong>: Reserved Characters & Keywords<\/a><\/span><\/em><\/p>\n<\/td>\n<\/tr>\n

Description<\/strong><\/td>\nFor the description, it's often useful to provide a broader explanation\u00a0of what the tag represents.<\/td>\n<\/tr>\n
Native Name<\/strong><\/td>\nThe unique name of the tag in its originating system.\u00a0Note that the native name cannot contain reserved characters.<\/td>\n<\/tr>\n
Display Range<\/strong><\/td>\nAllows consuming applications (e.g. IFS OI Explorer Trend) to tell what the expected minimum\/maximum value is for a tag. If supported, this information may be imported by the adaptor.<\/td>\n<\/tr>\n
Default Timebase<\/strong><\/td>\nThe time range that will be used by default when the tag is displayed in consuming applications, such as being added to a IFS OI Explorer trend. The default is 12 hours.\u00a0<\/td>\n<\/tr>\n
Interpolation<\/strong><\/td>\nThe type of interpolation to assume for the data returned by this tag. This affects how the data is displayed on a trend in IFS OI Explorer, and the default trace style. The default is Continuous.<\/p>\n

\"\"\u00a0Continuous<\/strong>:<\/em>\u00a0Allows a line to be drawn to connect data points on the trend. Use for continuous data, such as temperature, where values between the points can be reasonably predicted.<\/p>\n

\"\"\u00a0Discrete<\/strong>:<\/em> Use for discrete data points, such as laboratory data, where the result is only valid at that point in time.<\/p>\n

\"\"\u00a0Forward Extrapolated<\/strong><\/em>: The tag value is extrapolated forwards over the sample interval, until the next data point is reached. This is the most common method of extrapolation, and is often used when historians allow values accumulated over a sample period to be written to the beginning of the sample period.<\/p>\n

\"\"\u00a0Backward Extrapolated<\/strong><\/em>:\u00a0The tag value is extrapolated backwards over the sample interval, until the previous data point is reached. This is used when historians do not allow writing of values to the beginning of a sample period. When\u00a0values are accumulated over a sample period, they are written to the end of the sample period.<\/p>\n<\/td>\n<\/tr>\n

Decimal Places<\/strong><\/td>\nThe number of decimal places to display for the tag. An example of this being used is when the tag is displayed in the Status Tile of IFS OI Explorer. The default is 2.\u00a0<\/td>\n<\/tr>\n
Scan Rate<\/strong><\/td>\n\n

The scan rate supplied by the historian, which specifies the frequency with which the tag is updated with live values in the data source. Consuming applications can use this to limit the range of a raw fetch on data which has a high scan rate.\u00a0<\/p>\n

For\u00a0raw fetches<\/strong>, the number of data points a fetch will return is estimated using the tag\u2019s Scan Rate. The calculation is:<\/p>\n

Points requested = EndTime \u2013 StartTime \/ Scan Rate<\/p>\n

If the tag\u2019s Scan Rate is not configured, the Default Tag Scan Rate<\/a> from the datasource will be used. If neither of those has been configured, the system will assume a Scan Rate of 10 seconds.<\/p>\n<\/td>\n<\/tr>\n

Unit<\/strong><\/td>\n\n

The unit of measure for this tag. Select this from the drop-down list, which contains all units defined in the master list.\u00a0\u00a0<\/p>\n

See also<\/strong>: Creating a Master List of Units<\/a><\/span><\/em><\/p>\n<\/td>\n<\/tr>\n

Digital State Set<\/strong><\/td>\nIf this tag represents a digital state set, select it from the drop-down list.\u00a0<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

\"\"<\/a><\/p>\n

6. Click the Save<\/strong> button in the top right corner.<\/p>\n

\u00a0<\/p>\n

\n

Import\/Export Spreadsheet<\/span><\/h2>\n

The Import\/Export spreadsheet is generally only used to make bulk changes.<\/p>\n

For details on the spreadsheet and how to obtain it, see Exporting Your Configuration<\/a>.<\/p>\n

If you want to edit tags\u00a0as part of a bulk configuration, you can use the Tag<\/strong>\u00a0and Tag Property<\/strong> tabs in the Import\/Export spreadsheet<\/a>.\u00a0<\/p>\n

Look for the red\u00a0comment \"commentred\"\u00a0icon in the row headers, to get help with each column.<\/p>\n

DO NOT change anything in the Global Id field - this is the unique identifier for the tag that allows it to be tracked across systems, and when it is renamed. It is automatically generated by the system.\u00a0<\/p>\n

Tag Tab<\/h3>\n

The screenshot below shows an example of a configured tag (click to enlarge). The fields are the same as the ones in the first step of\u00a0configuring a tag in Server Management, using the above instructions on this page.<\/p>\n

\"\"<\/a><\/p>\n

Note: The choices for Default Timebase<\/em> and Interpolation<\/em> are available from drop-down lists on those cells.<\/p>\n

Dependencies<\/span><\/h4>\n

The Tag has dependencies on information from other tabs. Understanding these dependencies assists in resolving import errors.<\/p>\n

Read more: Understanding Object Dependencies<\/a><\/p>\n

Direct Dependencies<\/span><\/h5>\n

The Tag tab is directly dependent on 3 other tabs; Datasource, Unit and Digital State Set; because columns on the Tag tab directly reference columns on those tabs.<\/p>\n\n\n\n\n\n\n\n
This column<\/strong><\/td>\nOn this tab<\/strong><\/td>\nWhy you need to pay attention<\/strong><\/td>\n<\/tr>\n
Plain Symbol<\/td>\nUnit<\/td>\nRequired by the 'Unit' column on the Tag tab.<\/td>\n<\/tr>\n
Name<\/td>\nDigital State Set<\/td>\nRequired by the 'Digital State Set' column on the Tag tab.<\/td>\n<\/tr>\n
Datasource<\/td>\nDigital State Set<\/td>\nRequired by the 'Digital State Set Datasource' column on the Tag tab.<\/td>\n<\/tr>\n
Name<\/td>\nDatasource<\/td>\nRequired by the 'Datasource' column on the Tag tab.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
Cascading Dependencies<\/span><\/h5>\n

A cascading dependency exists when a dependent tab (above) has additional dependencies. \u00a0These are the columns that you need to pay attention to:<\/p>\n\n\n\n\n\n\n\n
This column<\/strong><\/td>\nOn this tab<\/strong><\/td>\nWhy you need to pay attention\u00a0<\/strong><\/td>\n<\/tr>\n
Digital State Set<\/td>\nDigital State<\/td>\nReferences the 'Name' column on the Digital State Set tab.<\/td>\n<\/tr>\n
Name<\/td>\nDatasource<\/td>\nReferences the 'Datasource' column on the Digital State Set tab.<\/td>\n<\/tr>\n
Datasource<\/td>\nDatasource Parameter<\/td>\nReferences the 'Name' column on the Datasource tab.<\/td>\n<\/tr>\n
Name<\/td>\nSystem<\/td>\nReferences the 'System' column on the Datasource tab.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Here is a diagram of the dependent tabs and columns. Use this to help you visualise how the dependencies work, and ensure all required columns are completed. Use the comments inside the spreadsheet to help you.<\/p>\n

\"\"<\/a><\/p>\n

Tag Property Tab<\/h3>\n

You can also use the Tag Property<\/strong> tab, if you need to edit any of the Tag Metadata. Tag metadata is not editable from within IFS OI Server Management.<\/p>\n

\"\"<\/a><\/p>\n

Dependencies<\/span><\/h4>\n

The Tag Property tab\u00a0has no dependencies on information from other tabs.\u00a0<\/p>\n

Related: Updating the Configuration<\/a><\/p>\n

\n

Release History<\/h2>\n