wincc flexible系统函数用法(3)

4、GetDataRecordFromPLC
应用：将给定的配方数据记录从PLC传送到HMI设备的存储介质中。
参数：
Recipe number/name
要传送其配方数据记录的配方的编号或名称。
Data record number/name
从PLC传送到HMI设备数据介质的配方数据记录的编号或名称。
Overwrite
确定是否覆盖具有相同名称的现有配方数据记录：
0 (hmiOverwriteForbidden) = 否：不覆盖配方数据记录。传送过程将不会执行。
1 (hmiOverwriteAlways) = 是：无提示直接覆盖配方数据记录。
2 (hmiOverwriteWithPrompting) = 经确认后：确认后才覆盖配方数据记录。
Output status message
确定传送之后是否输出状态消息：
0 (hmiOff) = 关：不输出状态消息。
1 (hmiOn) = 开：输出状态消息。
Processing status
返回系统函数的处理状态。例如，可以使用返回值延迟执行其它系统函数，直到本系统函数已经成功完成。
2 = 系统函数正在执行。
4 = 系统函数已经成功完成。
12 = 因为出现了错误，系统函数未执行。

5、GetDataRecordName
应用：在给定的变量中写入给定配方和配方数据记录的名称。
说明：如果配方或配方数据记录不存在，则将通配符(“###”)写入该变量。
参数：
Recipe number
其名称将被写入给定变量的配方的编号。
Data record number
其名称将被写入给定变量的配方数据记录的编号。
Recipe name
要写入配方名称的变量。该变量必须为STRING类型。
Data record name
要写入配方数据记录名的变量。该变量必须为STRING类型。
Processing status
返回系统函数的处理状态。例如，可以使用返回值延迟执行其它系统函数，直到本系统函数已经成功完成。
2 = 系统函数正在执行。
4 = 系统函数已经成功完成。
12 = 因为出现了错误，系统函数未执行。
 
6、GetDataRecordTagsFromPLC

应用：将装载到PLC中的配方数据记录的值传送给配方变量。
例如，在设备上进行交互操作期间，使用该系统函数。
参数：
Recipe number/name
要将其值从PLC写入变量的配方数据记录的编号或名称。
Processing status
返回系统函数的处理状态。例如，可以使用返回值延迟执行其它系统函数，直到本系统函数已经成功完成。
2 = 系统函数正在执行。
4 = 系统函数已经成功完成。
12 = 因为出现了错误，系统函数未执行。

7、ImportDataRecords
应用：从CSV文件中导入配方的一条或全部数据记录。
说明：如果将存储卡用作文件位置，则按如下方式指定文件位置：“\StorageCard\<文件名>”。

8、LoadDataRecord
应用：将给定的配方数据记录从HMI设备的存储介质装载到配方变量中。
例如，可使用该系统函数在配方画面中显示配方数据记录。

9、SaveDataRecord
应用：将配方变量的当前值作为数据记录保存到HMI设备的存储介质中。
例如，可使用该系统函数来保存配方画面中的配方数据记录。
参数：
Recipe number/name
要将配方数据记录保存到其中的配方的编号或名称。
Data record number/name
要保存的配方数据记录的编号或名称。
Overwrite
指定是否覆盖现有的数据记录：
0 (hmiOverwriteForbidden) = 否：不覆盖配方数据记录，也不保存该数据记录。
1 (hmiOverwriteAlways) = 是：不进行确认提示即覆盖配方数据记录。
2 (hmiOverwriteWithPrompting) = 经确认后：只有经用户确认后才会覆盖配方数据记录。
Output status message
确定在保存之后是否输出状态报表：
0 (hmiOff) = 关：不输出状态消息。
1 (hmiOn) = 开：输出状态消息。
Processing status
返回系统函数的处理状态。例如，可以使用返回值延迟执行其它系统函数，直到本系统函数已经成功完成。
2 = 系统函数正在执行。
4 = 系统函数已经成功完成。
12 = 因为出现了错误，系统函数未执行。

10、SetDataRecordTagsToPLC
应用：将配方变量的值传送到PLC。该配方变量包含显示在HMI设备上的数据记录的值。

参数：
Recipe number/name
要将其配方数据记录传送到PLC的配方的编号或名称。
Processing status
返回系统函数的处理状态。例如，可以使用返回值延迟执行其它系统函数，直到本系统函数已经成功完成。
2 = 系统函数正在执行。
4 = 系统函数已经成功完成。
12 = 因为出现了错误，系统函数未执行。

11、SetDataRecordToPLC
应用：将给定的配方数据记录从HMI设备的数据介质直接传送到与HMI设备相连的PLC。
说明：配方数据记录的值不需要显示在HMI设备上。

参数：
Recipe number/name
要将其配方数据记录传送到PLC的配方的编号或名称。
Data record number/name
要传送到PLC的配方数据记录的编号或名称。
Output status message
确定传送之后是否输出状态消息：
0 (hmiOff) = 关：不输出状态消息。
1 (hmiOn) = 开：输出状态消息。
Processing status
返回系统函数的处理状态。例如，可以使用返回值延迟执行其它系统函数，直到本系统函数已经成功完成。
2 = 系统函数正在执行。
4 = 系统函数已经成功完成。
12 = 因为出现了错误，系统函数未执行。

12、SetRecipeTags
应用：将配方变量的状态从“在线”改为“离线”，反之亦然。
该系统函数用于例如在启动设备时需要对配方数据记录值进行精确调整的时候。
参数：
Recipe number/name
要保存其配方数据记录的配方的编号或名称。
Status
确定配方变量的状态：
0 (hmiOnline) = 在线：配方变量的数值改变立即传送到与 HMI 设备相连的 PLC。
1 (hmiOffline) = 离线：只在执行了如“SetDataRecordTagsToPLC”系统函数时，配方变量的数值改变才传送到与 HMI 设备相连的 PLC。
Output status message
确定在保存之后是否输出状态报表：
0 (hmiOff) = 关：不输出状态消息。
1 (hmiOn) = 开：输出状态消息。
Processing status
返回系统函数的处理状态。例如，可以使用返回值延迟执行其它系统函数，直到本系统函数已经成功完成。
2 = 将要执行系统函数。
4 = 系统函数已经成功完成。
12 = 系统函数因出现错误而未执行。

八、其它函数

1、ControlSmartServer
应用：启动或停止。.
参数  Mode    指定是启动还是停止。
-1 (hmiToggle) = 切换：在两种模式之间切换。
0 (hmiStop) = 停止：停止
1 (hmiStart) = 启动：启动

2、ControlWebServer
应用：启动或停止Web服务器。
参数   Mode    指定是启动还是停止Web服务器。
-1 (hmiToggle) = 切换：在两种模式之间切换。
0 (hmiStop) = 停止：停止Web服务器
1 (hmiStart) = 启动：启动Web服务器

3、Encode
应用：修改传送给自动化系统 (AS) 的变量的“String”数据类型。WinCC flexible 的变量数据类型“String”转换为 AS 的数据类型“Array of byte”。其结果会写入变量。
参数   Byte array (输出)  包含转换值的变量。
说明：Byte array 必须是字符串长度的两倍。添加两个附加数组元素用于结尾零位。例如，当字符串长度为 120 个字符时，Byte array 必须包含 242 个数组元素。
如果大小不够，字符将被截断或者无法转换。

4、EncodeEx
应用：修改传送给自动化系统 (AS) 的变量的“String”数据类型。WinCC flexible 的变量数据类型“String”转换为 AS 的数据类型“Array of byte”。其结果会写入变量。

与 Encoding 系统函数相比，该函数允许定义 Line break 参数。使用 Line break 参数可以删除分行符或使用预定义的字符替换分行符。
参数  Byte array（输出）  包含转换值的变量。
说明：Byte array 必须是字符串长度的两倍。添加两个附加数组元素用于结尾零位。例如，当字符串长度为 120 个字符时，Byte array 必须包含 242 个数组元素。
如果大小不够，字符将被截断或者无法转换。

5、LookupText
应用：从文本列表中标识一个条目。结果取决于值和所选定的运行系统语言。结果保存到数据类型为“String”的变量中。
参数
Output text（输出）
将结果写入其中的变量。
Value
定义列表条目值的变量。
Language
定义标识列表条目所使用的运行系统语言。
变量
包含该语言的变量。输入代表国家/地区标识号的十进制值作为运行系统语言的选择，例如，1031 代表德语 - 标准，1033 代表英语 - 美国。详细的介绍可从 VBScript 基础“Locale identifier (LCID) diagram”中获得。
运行语言
语言代号按照 VBScript 参考，例如“de-DE”为德语（德国）或“en-US”为英语（美国）。此选择取决于激活何种运行系统语言。
Text list
定义文本列表。列表条目从文本列表中读取。

6、OpenInternetExplorer
应用：在HMI设备上打开Internet Explorer。
如果在调用系统函数时Internet Explorer已打开，那么Internet Explorer会关闭并再次打开。
说明：Internet Explorer将数据临时保存在HMI设备DRAM文件系统中，例如，上一次调用的网站。该数据可使用系统函数“BackupRAMFileSystem”保存，这样在重启动HMI设备后其依然可用。
参数  Start page   启动 Internet Explorer 时载入的页面，例如 www.pw0.cn。

7、SendEMail
应用：从HMI设备发送电子邮件到给定地址。
例如，该系统函数用于在维修时将报警直接传递给维修技术人员。
说明：需要选件“SmrtService”来实现。为了能够象电子邮件一样发送报警，HMI系统必须具有一个可由其随意支配的电子邮件客户端。文本”参数的变量值不能为空。如果该值为空，则无法执行函数。
参数
Address
收件人的电子邮箱地址。
Subject
电子邮件的主题信息。
Text
要用电子邮件发送的文本。
Return address
该电子邮件的收件人应将回复发送到的电子信箱地址。

8、SetDaylightSaving
应用：系统函数“SetDaylightSaving”可将 HMI 设备的设置从夏时制更改为标准时间，反之亦然。
执行该系统函数后，时间设置将立即生效。
说明：系统函数“SetDaylightSaving”不支持未使用夏令时的时区。
HMI 设备相关性
系统函数“SetDaylightSaving”在 HMI 设备 OP 73micro、TP 170micro 和 TP177micro 上不可用。
Windows 7
如果基于 PC 的 HMI 设备使用 Windows 7，则不支持系统函数“SetDaylightSaving”。

9、ShowSoftwareVersion
应用：隐藏或显示运行系统软件的版本号。
例如，如果在维修期间需要所使用的运行系统软件的版本，可以使用该系统函数。
参数  Display mode   确定是否显示版本号：
0 (hmiOff) = 关：不显示版本号
1 (hmiOn) = 开：显示版本号
-1 (hmiToggle) = 切换：在两种模式之间切换。

10、StartProgram
应用：在 HMI 设备上启动指定程序。
运行系统软件仍然在后台运行。继续输出报警，且数据继续被更新。
当退出给定的应用程序时，在执行系统函数期间被激活的画面将显示在 HMI 设备上。
例如，可以在 HMI 设备上使用该系统函数编辑 MS Excel 中的配方数据记录。
说明：如果在 HMI 设备上安装了 Windows CE，则在组态期间，必须检查是否可以用该系统函数启动所期望的应用程序。
该系统函数允许在 Windows CE 的“执行”对话框中启动所有应用程序。
将要启动的应用程序必须安装在 HMI 设备上。
参数   Program name    要启动的程序的名称和路径。此参数区分大小写。

11、StopRuntime
应用：退出运行系统软件，从而退出运行在HMI设备上的项目。
参数    Mode    确定在退出运行系统后操作系统是否关闭。
0 (hmiStopRuntime) = 运行系统：操作系统不关闭
1 (hmiStopRuntimeAndOperatingSystem) = 运行系统和操作系统：操作系统关闭(对于WinCE不适用)

12、UpdateTag
应用：从PLC读取带有指定更新标识符的变量的当前值。
参数   Update ID  为将要更新的变量分配的更新标识符。

设置
1、ChangeConnection
应用：断开与正在使用的 PLC 的连接，然后建立一个与给定 PLC 的新连接。
“ChangeConnection”函数用于将 HMI 设备与不同地址的 PLC 互连。
说明：请注意以下事项：
更改为另一个地址时，确保此地址还未被另一个 HMI 设备使用。
支持以下地址类型：
MPI 地址
PROFIBUS 地址
IP 地址
支持以下 PLC 类型：
SIMATIC S7 300/400
SIMATIC S7 200
SIMATIC S7-NC
SIMOTION
这种更改只能在子网内进行。

2、SetConnectionMode
说明：只有在 HMI 设备上设置了“在线”运行模式后，才能建立至 PLC 的连接。可以使用系统函数“SetDeviceMode”实现此操作。

3、SetDeviceMode
应用：切换 HMI 设备上的运行模式。可以有下列操作类型：“在线”、“离线”和“传送”
说明：如果将 PC 用作 HMI 设备，则当传送完成后切换运行模式时，退出运行系统软件。

4、SetLanguage
应用：连接或断开给定的连接。

5、SetScreenKeyboardMode
应用：允许或禁止HMI设备上屏幕键盘的自动显示。
该系统函数也可用于避免显示画面键盘，因为外部键盘已连接到操作员设备。
说明：要在 HMI 设备而不是触摸面板设备上启用系统函数“SetScreenKeyboardMode”(“SetScreenKeyboardMode”)，请在设备设置的“运行系统设置”对话框中选择“使用画面键盘”复选框。

6、SetWebAccess
应用：确定使用Internet对运行系统应用程序的访问模式。

系统

1、BackupRAMFileSystem
应用：将RAM文件系统备份到HMI设备的存储介质中。
重启动HMI设备后，数据被自动重新装载到RAM文件系统中。
应用程序(例如Internet Explorer)将数据(例如最近访问的网址)临时保存到操作员设备的DRAM文件系统。
 
2、OpenCommandPrompt
应用：打开Windows系统提示。
例如，该函数用来复制文件或调用其它应用程序。

3、OpenControlPanel
应用：打开一个显示Windows CE控制面板的窗口。不能在PC上使用此系统函数。
除其它功能外，此系统函数还允许您在基于Windows CE的HMI设备上设置以下内容：
选择打印机
选择传送属性
执行备份函数和恢复函数
组态屏幕保护程序
组态闪存

4、OpenScreenKeyboard
应用：隐藏或显示屏幕键盘。
屏幕键盘保持打开直到它被明确关闭。这样，屏幕键盘也可用于其它应用程序。
参数：
Display mode
指定使用屏幕键盘打开的窗口是最小化还是最大化：
0 (hmiScreenKeyboardMinimized) = 最小化
1 (hmiScreenKeyboardMaximized) = 最大化

用户管理
1、ExportImportUserAdministration
应用：将当前激活项目的用户管理中的全部用户导出到给定文件，或者将用户从给定文件导入到当前激活的项目中。
用户、用户口令和权限都保存在用户管理中。
在导入时，将覆盖所有用户。导入的用户立即生效。
说明：如果将存储卡用作文件位置，则文件位置表示如下：“\StorageCard\<文件名>”。

2、GetGroupNumber
应用：读取登录到HMI设备的用户所属组的编号，并将其写入给定的变量。

3、GetPassword
应用：在给定的变量中写入当前登录到HMI设备的用户的口令。

4、GetUserName
应用：在给定的变量中写入当前登录到HMI设备的用户的用户名。
如果给出的变量具有控制连接，则用户名在PLC上也可用。该系统函数将使诸如执行某些功能与用户有关的版本成为可能
说明：除了域以外，还将输出 SIMATIC Logon 用户的名称。

5、Logoff
应用：在HMI设备上注销当前用户

6、Logon
应用：在HMI设备上登录当前用户

7、ShowLogonDialog
应用：在HMI设备上打开用户可用于登录到HMI设备的对话框。
 
用于画面对象的键盘操作

1、AlarmViewAcknowledgeAlarm
应用：确认在给定报警视图中选择的报警。
当不能使用ActiveX控件的集成按钮时，使用该系统函数。
参数：Screen object
在其中触发事件的报警画面的名称。

2、AlarmViewEditAlarm
应用：对给定报警画面内选择的全部报警，触发“编辑”事件。
当不能使用ActiveX控件的集成按钮时，使用该系统函数。
可以在“编辑”事件上依次组态系统函数。例如，可以切换到出现报警的过程画面。
说明：如果要编辑的报警尚未被确认，则在调用该系统函数时自动确认。
参数：Screen object
在其中触发事件的报警画面的名称。

3、AlarmViewShowOperatorNotes
应用：在给定报警画面中显示组态好的所选报警的操作员注释。
参数：Screen object
在其中触发事件的报警画面的名称。

4、RecipeViewBack
应用：返回到给定配方视图中的上一个选择列表。
如果配方选择显示在HMI设备上，则系统函数无效。运行时，选择列表的操作顺序：

配方选择
RecipeDataRecordSelection
RecipeDataRecordValues
该系统函数在组态了简单配方视图后使用。在简单配方视图中，每次只在操作员设备上显示一个选择列表。系统函数“RecipeViewOpen”用于显示配方数据记录值。
参数：Screen object
在其中触发命令的配方视图的名称。

5、RecipeViewDeleteDataRecord
参数：Screen object
配方视图的名称，在其中显示来自PLC的配方数据记录。

6、RecipeViewGetDataRecordFromPLC
应用：将PLC中当前装载的数据记录传送至HMI设备并在配方视图中显示
参数：Screen object
配方视图的名称，在其中显示来自PLC的配方数据记录。

7、RecipeViewMenu
应用：打开指定简单配方视图的菜单。
该系统函数只能用于简单配方视图。
参数：Screen object
要打开菜单的配方视图的名称。

8、RecipeViewNewDataRecord
应用：在给定配方视图中创建新数据记录。
参数：Screen object
在其中创建新配方数据记录的配方视图的名称。
 
9、RecipeViewOpen
应用：显示给定配方视图中的数据记录值。如果配方数据记录值已显示在操作员设备上，系统函数不被执行。
该系统函数在组态了简单配方视图后使用。在简单配方视图中，每次只在操作员设备上显示一个选择列表。系统函数“RecipeViewBack”用于显示前一选择列表。
参数：Screen object
要显示其配方数据记录的配方视图的名称。