Manual > Library Reference > Screen Library > Screen Library Reference > Trend Graph

Open parameters in trend graph

For information on how to call a screen library using open parameters, see "About open parameters of screen libraries".

This screen library provides the following open parameters.

name

Parameters

explanation

Show/hide setting button

IsConfig

Specifies whether to show or hide the settings button.

TRUE

Opens the screen with the settings button displayed.

FALSE

Opens the screen with the settings button hidden.

Enable/disable display state retention

EnabledSaveConfig

Specifies whether to enable or disable "Keep display state" in the settings menu.

TRUE

Enables the menu item.

FALSE

Disables the menu item.

If you specify SEARCH or FILTER in the Mode parameter to display your own pens, make sure to call this parameter as FALSE.

Real-time updates

IsRealTime

Specifies whether to display the trend graph in real time.

TRUE

Open a screen with real-time display enabled.

FALSE

Opens a screen with real-time display disabled.

Selection method

Mode

Specify the parameter selection mode as a string. If omitted, it will operate as "SELECT". For details, see "How to specify Mode parameters" at the bottom of this page.

SELECT

The screen will open as a normal trend screen, and the group and pen that meet the conditions specified by the GroupName, PenName, and DataSource parameters will be displayed with them selected.

A temporary group named "(INFO)" is generated at the top of the group combo box, and pens that meet the conditions specified by the GroupName, PenName, and DataSource parameters are added to this group and displayed. Other groups are displayed as usual. Note that if you specify this mode and open the trend graph screen, calling up "Pen Settings" in the settings menu will be disabled.

FILTER

A single temporary group named "(INFO)" is generated in the group combo box, and pens that meet the conditions specified by the GroupName, PenName, and DataSource parameters are added to this group and displayed. Other groups are not displayed. Note that if you specify this mode and open the trend graph screen, the "Pen Settings" option in the settings menu will be disabled.

If you specify SEARCH or FILTER for this parameter to display your own pens, make sure to call the EnabledSaveConfig parameter as FALSE.

Group Name

GroupName

Specify the group name you want to display in the graph as a string. This parameter is used in combination with the Mode parameter above. For details, see "How to specify the Mode parameter" at the bottom of this page. Note that if the DataSource parameter is specified, this parameter will be ignored.

If you want to specify only one group, write it as follows (the group name is an example).

"GroupName:group01"

If you want to specify multiple groups, separate them with commas as follows:

"GroupName:group01,group02,group03"

Pen name

PenName

Specify the pen name you want to display on the graph as a string. This parameter is used in combination with the Mode parameter above. For details, see "How to specify the Mode parameter" at the bottom of this page. Note that if the DataSource parameter is specified, this parameter will be ignored.

If you want to specify only one pen, write it as follows (note that the pen name is an example).

"PenName:pen01"

If you want to specify multiple pens, separate them with commas as follows:

"PenName:pen01,pen02,pen03"

Data Source Name

DataSource

Specify the data source name (data source path) you want to display on the graph as a string. The pen setting information is searched for based on the specified data source name, and all corresponding pens are displayed on the graph. When using this parameter, the pen information corresponding to the specified data source must be registered as a pen setting. This parameter is used in combination with the Mode parameter. For details, see "How to specify the Mode parameter" at the bottom of this page. Note that if this parameter is specified, GroupName and PenName will be ignored.

If you want to specify only one data source, write it as follows (※The data source name is an example).

"DataSource:T01" ・・・ Example of logger action etc.

"DataSource:Summary.RAW::T001" ・・・ Example of summary action

If you want to specify multiple data sources, separate them with commas as follows:

"DataSource:T01,T02,T03" ・・・ Example of logger action etc.

"DataSource:Summary.RAW::T001,Summary.RAW::T002,Summary.RAW::T003" ・・・ Example of summary action

Filter Color

FilterColor

If you specify "FILTER" for the Mode parameter, you can specify the pen display color as a string in RGB format. If a mode other than FILTER is specified, this parameter will be ignored.

If you specify only one as shown below, all pen colors will be displayed in the same color.

"FilterColor:#FF0000"

By specifying multiple colors separated by commas as shown below, you can specify the order in which the colors will be added to AddPen.

"FilterColor:#FF0000,#00FF00"

You can specify a color for each pen name by specifying the combination of "pen name:color format" as shown below.

"FilterColor:Pen 1:#FF0000,Pen 2:#00FF00,Pen 3:#FF0000"

Start time

StartDate

Specify the start date and time of the graph display period. Specify the date and time in the format specified in the _DeteTimeFormat custom property of the screen library.

If this parameter is not specified, the start date and time will be calculated and displayed from the date and time specified in EndDate and the number of seconds specified in TimeSpan.

End Time

EndDate

Specify the end date and time of the graph display period. Specify the date and time in the format specified in the _DeteTimeFormat custom property of the screen library.

If this parameter is not specified, the end date and time will be calculated and displayed from the date and time specified in StartDate and the number of seconds specified in TimeSpan.

Graph display span

TimeSpan

Specifies the time span of the graph display in seconds. If this parameter is not specified, the time span setting for the corresponding pen group will be used.

Pen list display

IsGridDisplay

Specifies whether to show or hide the pen list (pen grid) located at the bottom of the screen.

TRUE

Opens the screen with the pen list displayed.

FALSE

Hides pen loss.

Header Display

IsHeader

Specifies whether to show or hide the various operation UIs (combo boxes, edit boxes, buttons, etc.) located at the top of the screen.

TRUE

The screen opens with the various operation UI displayed at the top of the screen.

FALSE

Hides the various operation UIs at the top of the screen.

Library Unique Name

LibraryUniqueName

When registering multiple identical screen libraries at the same time, specify an identifier in this parameter. The specified identifier must be unique across the entire system.

How to specify the Mode parameter

Depending on the setting of the Mode parameter, the various behaviors when the GroupName, PenName, and DateSource parameters are specified will be as follows.

Mode parameter setting

Operation

SELECT

The screen opens as a normal trend screen, and the groups and pens that meet the conditions specified by the parameters are displayed in selected state.

Group Combo Box	Sets all groups registered in the trend pen settings as items in the combo box, and the group specified in the GroupName parameter will be selected. If the GroupName parameter is empty, the first group will be selected.
Pen Combo Box	Sets all pens in the group as items in the combo box, with the pen specified in the PenName parameter selected. If the PenName parameter is empty, the first pen is selected.
GroupName Parameter	Specifies the group name to be selected when displayed. If multiple group names are specified in the parameter, the first group name specified will be selected, and the second and subsequent names will be ignored.
PenName Parameter	Specifies the pen name to be selected when displayed. If multiple pen names are specified in the parameter, the first pen specified will be selected, and the second and subsequent pen names will be ignored.
DataSource Parameter	Specifies the data source name of the pen to be selected when displayed. If multiple data source names are specified in the parameter, the pen corresponding to the first data source specified will be selected, and the second and subsequent ones will be ignored.

A temporary group named "(INFO)" is created at the top of the group combo box, and pens that meet the conditions specified by the GroupName, PenName, and DataSource parameters are added to this group and displayed. Other groups are displayed as usual.

Group Combo Box

A temporary group named "(INFO)" will be generated at the beginning and all the corresponding pens will be displayed together. Other groups will be displayed as usual.

Pen Combo Box

Pens that meet the conditions will be added to the INFO group in the format [group name][pen name] and displayed. For other groups, only the pen name will be displayed as usual.

GroupName/PenName parameters

Specify the group name and pen name.

GroupName

Not specified

GroupName

Specified

PenName

Not specified

INFOThe screen will open with no pens added to the group.

Adds all pens registered in the specified group to the INFO group and opens the screen.

PenName

Specified

The pen that corresponds to the specified pen name will be added to the INFO group and the screen will open.

If pens with the same name are registered in multiple groups, only the pen that was registered first will be displayed in the pen settings.

Add a pen that meets the following conditions to the INFO group and open the screen.

•When GroupName and PenName are the same number

example)

GroupName: Group 1, Group 2, Group 3

PenName:pen1,pen1,pen5

INFO Group contents:

[Group 1][pen1]

[Group 2][pen1]

[Group 3] [pen5]

•When the number of GroupName and PenName are different

example)

GroupName: Group 1, Group 2

PenName:pen1,pen1,pen4,pen5

INFO Group contents:

[Group 1][pen1]

[Group 2][pen1]

[Group 1][pen4]

[Group 2] [pen5]

example)

GroupName: Group 1, Group 2

PenName:pen1,pen1,pen4,pen5,pen8

INFO Group contents:

[Group 1][pen1]

[Group 2][pen1]

[Group 1][pen4]

[Group 2] [pen5]

[Group 1] [pen8]

example)

GroupName: Group 1

PenName:pen1,pen2,pen4,pen5

INFO Group contents:

[Group 1][pen1]

[Group 1][pen2]

[Group 1][pen4]

[Group 1] [pen5]

example)

GroupName: Group 1, Group 2, Group 3

PenName:pen1

INFO Group contents:

[Group 1][pen1]

[Group 2][pen1]

[Group 3][pen1]

DataSource Parameter

Among the pen information registered in the pen settings of the trend, the pens that correspond to the specified data source are displayed on the graph. If the data source is a summary action, a fuzzy search is performed by replacing the summary section of the data source name (RAW, DAY, MONTH, YEAR, etc.) with a wildcard to display the corresponding pens. If multiple pens are applicable, only the pen with the highest priority is displayed, and the other pens are hidden (the "Display" checkbox is unchecked in the pen list at the bottom of the trend screen). Note that the priority is determined by the data source name that matches exactly, and the rest are prioritized in the order of registration of the pen settings.

FILTER

A single temporary group named "(INFO)" is created in the group combo box, and pens that meet the conditions specified by the GroupName, PenName, and DataSource parameters are added to that group and displayed. Other groups are not displayed.

Group Combo Box

Only the temporary group "(INFO)" is displayed. Other groups are not displayed.

Pen Combo Box

Pens that meet the conditions will be added to the INFO group and displayed in the format [group name][pen name].

GroupName/PenName parameters

Specify the group name and pen name. The method of specification and operation are the same as for SEARCH.

DataSource Parameter

Of the pen information registered in the pen settings of the trend, the pen that exactly matches the specified data source will be displayed on the graph. If multiple pens match, the pen registered first in the pen settings will be used.