WINCC中使用C脚本获得操作记录的方法(原创)

  • 格式:doc
  • 大小:354.00 KB
  • 文档页数:9

技术总结C脚本获得操作记录的方法版本日期作者校对批准说明0目录1应用范围 (3)1.1详述 (3)1.2适用的系统 (4)2硬、软件配置 (4)3解决方法 (4)附件附件文档号说明1 应用范围1.1 详述在生产中,有很多时候需要记录操作员的操作,以便进行事故分析。

WINCC本身提供了一些对象可以产生操作记录,但是在复杂的情况下是无法兼顾既获得操作记录又满足特殊操作的要求。

这时,可以使用C脚本来获得操作记录。

目前,在WINCC中以下对象可以很方便地获得操作记录:●任何对象,将Event\Direct Connection\Operator Input Message选中。

图1 通过DirectConnection获得操作记录的组态●Check Box对象和Option Group对象,将property\Operator Input Message属性选择为yes。

图2 Check Box对象和Option Group对象获得操作记录的组态●IO Field对象和Slider对象:将property\Operator Input Message属性选择为yes;或将property\Operator Activities Report属性选择为yes。

Operator Input Message和Operator ActivitiesReport的区别是后者可以输入操作理由,确认之后操作记录的Comment中可以查看到操作理由。

图3 IO Field对象和Slider对象获得操作记录的组态以上方法可以快捷地实现获取操作记录的功能,但是在某些情况下,功能要求更复杂,通过以上方法并不能满足要求。

比如:操作员操作一个启动按钮,要求系统能够记录操作员操作信息。

在单步操作的情况下,通过Direct Connection能够很方便地实现这一功能。

但是在两步操作的情况下,需要操作员先确认,在得到确认之后操作才能生效,由于Direct Connection并没有提供操作确认功能,显然通过Direct Connection并不能满足要求。

在这一的情况下,可以考虑采用C脚本来实现这一功能,通过MessageBox()函数来完成操作确认的功能,然后通过特别的函数来使系统产生操作记录。

1.2 适用的系统该方法适用于安装有WINCC的系统中。

2 硬、软件配置安装有WINCC软件,无版本限制。

3 解决方法通过C脚本产生操作记录主要完成两部分组态工作,首先要在Alarm Logging中组态消息类型和定制消息内容;然后编写C脚本来产生操作记录。

第一步:在Alarm Logging中组态消息类型和定制消息内容。

1.新建消息并定义消息类型。

系统产生的消息(包括了操作记录)和定制的消息都存储在Alarm Logging中,编号从1000000开始的消息为系统使用的消息,不能组态。

如果需要定制消息,可以使用1~1000000之间的消息号。

在WINCC explorer中打开Alarm Logging,新建一条消息,消息号为1,打开该消息的属性对话框,如图4所示。

在Parameters一栏中,将Class和Type都选为Operator Input Message,保留其余默认设置。

图4 消息的参数组态2.定制操作记录的内容。

每条操作记录都在单独的消息行中显示,消息行的内容取决于选定的消息块,每个选定的消息块组成消息行中的一列。

如图5所示,系统提供了三种不同类型的消息块:①系统块显示预定义的消息,如日期、时间、持续时间、注释…;②用户文本块允许最多为一条消息指定十个可定义文本,包含操作来源、操作内容、时间等信息。

③过程值块:系统提供了十个过程值,通过过程值块可以在消息行中显示已定义的标签值。

并非消息块中每一项都需要在消息中显示,可以在系统图形文件@AlarmOperation.pdl 中进行定制。

图5 消息块类型通常,在进行事故分析时,需要了解操作日期、时间、操作来源以及操作内容。

前面提到,系统块提供了操作日期和时间信息,只需要选中这两个选项,无需特别的组态。

因此,定制操作记录只需要再对操作来源和操作内容进行组态就可以了。

先来了解下通过Direction Connection产生的操作记录的内容,如图6所示:操作来源中显示的是变量名称,变量包含了工厂层级信息。

操作内容中包含了用户名、新值和旧值的信息。

变量名、用户名、新值和旧值可以从过程值块的变量中获得。

先对过程值模块中10个过程值的用处作如表1中的定义:图6 操作记录列表过程值 1 2 3 4 5 6 7 8 9 10用处消息号变量的新值变量的旧值备用备用当前登录的用户名变量名备用备用备用表1 过程值块变量用处的定义在进行上述的定义之后,进入消息组态对话框,选择Text一栏,进行用户文本块的定义,如图7所示:图7 用户文本块的组态用户文本块中的内容可以手动输入,也可以通过点击右边的进入文本组态对话框进行消息格式的组态,如图8所示:图8 用户文本块中输出格式的组态到这里,我们就完成了在Alarm Logging中操作记录的组态工作,接下来就要进行C脚本的编写了。

第二步:编写C脚本。

C脚本中要做的工作主要有分两步,先是进行变量的赋值,然后再创建消息。

1.变量的赋值。

在触发消息的事件(如按钮的鼠标左键释放事件)的C脚本中定义变量并给变量赋值,根据表1中的定义,需要定义两个数组,一个是数值类型为Double,另一个数值类型为字符指针,前者用于存放消息号、变量的新值和旧值,后者用于存放当前登录的用户名和变量名。

以下是按钮鼠标释放事件的C脚本程序。

***************************************************************************#include "apdefap.h"void OnLButtonUp(char* lpszPictureName, char* lpszObjectName, char* lpszPropertyName, UINT nFlags, int x, int y){// WINCC:TAGNAME_SECTION_START// syntax: #define TagNameInAction "DMTagName"// next TagID : 1#define Apc_CurrentUserName "@local::@CurrentUserName"#define Var "AS_FAR05_1107_2/HS_806B"// WINCC:TAGNAME_SECTION_END//定义消息号,并赋值int nMsgNr = 1;int iNewValue=1;int iOldValue;int RetMsg;double dValue[5] = {0,0,0,0,0}; //定义double型数组,对应过程值块的前5个变量char* lpszVal[5] = {"","","","",""}; //定义字符指针数组,对应过程值块的后5个变量//确认操作RetMsg = MessageBox (NULL, "确定要启动吗?", "启动确认", MB_OKCANCEL);if (RetMsg==IDOK){//获取旧值、赋予新值iOldValue=GetTagBit(Var);SetTagBitWait(Var,(WORD)iNewValue);//将用户名、变量名、消息号、新值和旧值放到定义的数组中lpszVal[0] = GetTagCharWait(Apc_CurrentUserName);lpszVal[1] =Var;dValue[0] = nMsgNr;dValue[1] = iNewValue;dValue[2] = iOldValue;//调用产生消息的函数OperationLog_V6(lpszPictureName,nMsgNr,dValue,lpszVal);}}************************************************************************************************2.创建消息。

消息创建函数需定义为全局脚本函数,主要将值传递给消息块的结构变量并创建消息。

以下是产生消息函数的C脚本。

***************************************************************************#ifndef RUN_ON_WEBNAVIGATOR#include "apdefap.h"#pragma code ("ssmrt.dll")#include "ssmrt.h"#pragma code ()#endifvoid OperationLog_V6(char* lpszPictureName, int nMsgNr,double dValue[5],char* lpszVal[5]) {BOOL bOkay;CMN_ERROR Error;MSG_RTDATA_INSTANCECOMMENT_STRUCT MsgCreate;//定义为消息到达MsgCreate.dwMsgState = MSG_STATE_COME;//赋消息号给将要创建的消息MsgCreate.dwMsgNr = nMsgNr;//定义用到了过程值块中的哪些过程值MsgCreate.wPValueUsed = 0x001F;//定义用到了用户文本块中的哪些选项MsgCreate.wTextValueUsed = 0x03E0;// 拷贝数值到消息块的过程值中MsgCreate.dPValue[0] = dValue[0]; // @1%x@ ; x can be replaced by d,fMsgCreate.dPValue[1] = dValue[1]; // @2%x@ ; x can be replaced by d,fMsgCreate.dPValue[2] = dValue[2]; // @3%x@ ; x can be replaced by d,fMsgCreate.dPValue[3] = dValue[3]; // @4%x@ ; x can be replaced by d,fMsgCreate.dPValue[4] = dValue[4]; // @5%x@ ; x can be replaced by d,fstrcpy(MsgCreate.mtTextValue[5].szText, lpszVal[0]); // @6%s@strcpy(MsgCreate.mtTextValue[6].szText, lpszVal[1]); // @7%s@strcpy(MsgCreate.mtTextValue[7].szText, lpszVal[2]); // @8%s@strcpy(MsgCreate.mtTextValue[8].szText, lpszVal[3]); // @9%s@strcpy(MsgCreate.mtTextValue[9].szText, lpszVal[4]); // @10%s@// 发送消息到Alarm LoggingbOkay = MSRTCreateMsgInstanceWithComment(0,&MsgCreate,&Error);if (!bOkay)printf("MSRTCreateMsgInstanceWithComment szErrorText = %s \r\n",Error.szErrorText );}后记:通过C脚本不仅可以产生操作记录,也可以产生报警记录、日志记录,只需要在Alarm Logging 中将消息类型改成对应的类型。