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

文档号版本日期页数1588930702645版本日期作者校对批准说明0技术总结C脚本获得操作记录的方法文档号版本日期页数1588930702645目录1应用范围.....................................................................................................................................................31.1详述...................................................................................................................................................31.2适用的系统........................................................................................................................................42硬、软件配置..............................................................................................................................................43解决方法.....................................................................................................................................................4附件附件文档号说明文档号版本日期页数15889307026451应用范围1.1详述在生产中，有很多时候需要记录操作员的操作，以便进行事故分析。WINCC本身提供了一些对象可以产生操作记录，但是在复杂的情况下是无法兼顾既获得操作记录又满足特殊操作的要求。这时，可以使用C脚本来获得操作记录。目前，在WINCC中以下对象可以很方便地获得操作记录：任何对象，将Event\DirectConnection\OperatorInputMessage选中。图1通过DirectConnection获得操作记录的组态CheckBox对象和OptionGroup对象，将property\OperatorInputMessage属性选择为yes。图2CheckBox对象和OptionGroup对象获得操作记录的组态IOField对象和Slider对象：将property\OperatorInputMessage属性选择为yes；或将property\OperatorActivitiesReport属性选择为yes。OperatorInputMessage和OperatorActivities文档号版本日期页数1588930702645Report的区别是后者可以输入操作理由，确认之后操作记录的Comment中可以查看到操作理由。图3IOField对象和Slider对象获得操作记录的组态以上方法可以快捷地实现获取操作记录的功能，但是在某些情况下，功能要求更复杂，通过以上方法并不能满足要求。比如：操作员操作一个启动按钮，要求系统能够记录操作员操作信息。在单步操作的情况下，通过DirectConnection能够很方便地实现这一功能。但是在两步操作的情况下，需要操作员先确认，在得到确认之后操作才能生效，由于DirectConnection并没有提供操作确认功能，显然通过DirectConnection并不能满足要求。在这一的情况下，可以考虑采用C脚本来实现这一功能，通过MessageBox()函数来完成操作确认的功能，然后通过特别的函数来使系统产生操作记录。1.2适用的系统该方法适用于安装有WINCC的系统中。2硬、软件配置安装有WINCC软件，无版本限制。3解决方法通过C脚本产生操作记录主要完成两部分组态工作，首先要在AlarmLogging中组态消息类型和定制消息内容；然后编写C脚本来产生操作记录。第一步：在AlarmLogging中组态消息类型和定制消息内容。1．新建消息并定义消息类型。系统产生的消息（包括了操作记录）和定制的消息都存储在AlarmLogging中，编号从1000000开始的消息为系统使用的消息，不能组态。如果需要定制消息，可以使用1～1000000之间的消息号。在WINCCexplorer中打开AlarmLogging，新建一条消息，消息号为1，打开该消息的属性对话框，如图4所示。在Parameters一栏中，将Class和Type都选为OperatorInputMessage，保留其余默认设置。文档号版本日期页数1588930702645图4消息的参数组态2．定制操作记录的内容。每条操作记录都在单独的消息行中显示，消息行的内容取决于选定的消息块，每个选定的消息块组成消息行中的一列。如图5所示，系统提供了三种不同类型的消息块：①系统块显示预定义的消息，如日期、时间、持续时间、注释…；②用户文本块允许最多为一条消息指定十个可定义文本，包含操作来源、操作内容、时间等信息。③过程值块：系统提供了十个过程值，通过过程值块可以在消息行中显示已定义的标签值。并非消息块中每一项都需要在消息中显示，可以在系统图形文件@AlarmOperation.pdl中进行定制。图5消息块类型通常，在进行事故分析时，需要了解操作日期、时间、操作来源以及操作内容。前面提到，系统块提供了操作日期和时间信息，只需要选中这两个选项，无需特别的组态。因此，定制操作记录只需要再对操作来源和操作内容进行组态就可以了。文档号版本日期页数1588930702645先来了解下通过DirectionConnection产生的操作记录的内容，如图6所示：操作来源中显示的是变量名称，变量包含了工厂层级信息。操作内容中包含了用户名、新值和旧值的信息。变量名、用户名、新值和旧值可以从过程值块的变量中获得。先对过程值模块中10个过程值的用处作如表1中的定义：图6操作记录列表过程值12345678910用处消息号变量的新值变量的旧值备用备用当前登录的用户名变量名备用备用备用表1过程值块变量用处的定义在进行上述的定义之后，进入消息组态对话框，选择Text一栏，进行用户文本块的定义，如图7所示：图7用户文本块的组态用户文本块中的内容可以手动输入，也可以通过点击右边的进入文本组态对话框进行消息格式的组态，如图8所示：文档号版本日期页数1588930702645图8用户文本块中输出格式的组态到这里，我们就完成了在AlarmLogging中操作记录的组态工作，接下来就要进行C脚本的编写了。第二步：编写C脚本。C脚本中要做的工作主要有分两步，先是进行变量的赋值，然后再创建消息。1．变量的赋值。在触发消息的事件（如按钮的鼠标左键释放事件）的C脚本中定义变量并给变量赋值，根据表1中的定义，需要定义两个数组，一个是数值类型为Double，另一个数值类型为字符指针，前者用于存放消息号、变量的新值和旧值，后者用于存放当前登录的用户名和变量名。以下是按钮鼠标释放事件的C脚本程序。***************************************************************************#includeapdefap.hvoidOnLButtonUp(char*lpszPictureName,char*lpszObjectName,char*lpszPropertyName,UINTnFlags,intx,inty){//WINCC:TAGNAME_SECTION_START//syntax:#defineTagNameInActionDMTagName//nextTagID:1#defineApc_CurrentUserName@local::@CurrentUserName#defineVarAS_FAR05_1107_2/HS_806B//WINCC:TAGNAME_SECTION_END//定义消息号，并赋值intnMsgNr=1;intiNewValue=1;intiOldValue;intRetMsg;doubledValue[5]={0,0,0,0,0};//定义double型数组，对应过程值块的前5个变量char*lpszVal[5]={,,,,};//定义字符指针数组，对应过程值块的后5个变量//确认操作文档号版本日期页数1588930702645RetMsg=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脚本。***************************************************************************#ifndefRUN_ON_WEBNAVIGATOR#includeapdefap.h#pragmacode(ssmrt.dll)#includessmrt.h#pragmacode()#endifvoidOperationLog_V6(char*lpszPictureName,intnMsgNr,doubledValue[5],char*lpszVal[5]){BOOLbOkay;CMN_ERRORError;MSG_RTDATA_INSTANCECOMMENT_STRUCTMsgCreate;//定义为消息到达MsgCreate.dwMsgState=MSG_STATE_COME;//赋消息号给将要创建的消息MsgCreate.dwMsgNr=nMsgNr;//定义用到了过程值块中的哪些过程值MsgCreate.wPValueUsed=0x001F;//定义用到了用户文本块中的哪些选项MsgCreate.wTextValueUsed=0x03E0;//拷贝数值到消息块的过程值中MsgCreate.dPValue[0]=dValue[0];//@1%x@;xcanbereplacedbyd,fMsgCreate.dPValue[1]=dValue[1];//@2%x@;xcanbereplacedbyd,fMsgCreate.dPValue[2]=dValue[2];//@3%x@;xcanbereplacedbyd,fMsgCreate.dPValue[3]=dValue[3];//@4%x@;xcanbereplacedbyd,fMsgCreate.dPValue[4]=dValue[4];//@5%x@;xca