把用户归档中的重复的函数组合到一个函数里

Siemens - Automation and Drives - Service& Support - Aut. 第1页 共3页2005-05-31 2:06 自动化系统 SIMATIC HMI人机界面 HMI 软件 SCADA 系统 SIMATIC WinCC SIMATIC WinCC 选件 用户归档 常问问题 样本程序：把用户归档中的重复的函数组合到一个函数里 订货号:订货号: 6AV637.WINCC SIMATIC HMI SOFTWARE 6AV6371-1CB06-0DX0WinCC/User Archive V6.0 SP3 6AV638.WINCC SIMATIC HMI SOFTWARE 2 问题：问题： 如何能减小用户归档存取所用的脚本代码的体积？ 解答：解答： 如果编程了存取用户归档的脚本，对于管理任务来说，就是一大段代码。而该代码对于存取所有的用户 归档的代码是一样的。下面的例子说明如何把管理任务组合到一个函数中。 就标准的编程方法来说，该脚本的结构看起来如下： 生成分类和过滤的条件生成分类和过滤的条件1. 设置到用户归档的一个连接设置到用户归档的一个连接 uaConnect uaQueryArchiveByName 出错则返回 2. 设置分类和过滤的条件 设置分类和过滤的条件 uaArchiveSetFilter uaArchiveSetSort 3. 打开询问打开询问 uaArchiveOpen 4. 通过询问进行实际工作通过询问进行实际工作 读，写，删除，插入等其它动作 5. 清除到用户归档的连接清除到用户归档的连接 uaArchiveClose uaReleaseArchive uaDisconnect 6. 如果，编程中在一个函数里对每一点都作故障检查，函数就变得非常大且不清晰。 当仔细看一下上面的程序结构，可看出每一次只有第1点和第5点有变化只有第1点和第5点有变化。 其它几点，不管用户归档的结构是什么，是不变的其它几点，不管用户归档的结构是什么，是不变的。 可以把上面的结构分成 3 个函数。 第 1 点实施与任务有关的函数。它生成过滤和分类条件。1. 一个通用函数包含了所有的管理动作。该函数应用于所有的用户归档所有的用户归档。这个函数接收一个回 调函数作为参数。这个回调函数或是为询问中的每个条目所调用，或为全部的用户归档仅调 用一次。 2. 这个回调函数处理第 5 点的动作。3. 这一段表明，你无须担心管理上的问题。只需编程一个生成询问的函数和一个处理归档条目的，与归档 有关的函数。 下例中使用的是函数 uaUtilityEnumRecordsuaUtilityEnumRecords。 函数描述：函数描述： BOOL uaUtilityEnumRecords(BOOL uaUtilityEnumRecords( Siemens - Automation and Drives - Service& Support - Aut. 第2页 共3页2005-05-31 2:06 Const char* pszArchiveName , const char* lpszFilter, const char* lpszSort, BOOL ( UserFunc )( UAHARCHIVE* phUA, void* pUserData ), void* pUserData ) Const char* pszArchiveName , const char* lpszFilter, const char* lpszSort, BOOL ( UserFunc )( UAHARCHIVE* phUA, void* pUserData ), void* pUserData ) 参数：参数： pszArchiveNamepszArchiveName:指针指向一个以 0 结束的字符串。该字符串含有归档的名字（与 出现在用户归档编辑器里的一样）。 lpszFilter:lpszFilter:指针指向一个以 0 结束的字符串。该字符串含有找到归档的过滤 条件。指针也可以是 ZERO。 lpszSort:lpszSort:指针指向一个以 0 结束的字符串。该字符串含有找到归档的分类 条件。指针也可以是 ZERO。 UserFunc:UserFunc:回调函数名。如果传输一个滤波器的话，对每个条目都调用该函 数。如果不传输一个滤波器的话，该函数只对全部归档调用一 次。 该函数必须属于下面的类型： BOOL ( UserFunc )( UAHARCHIVE* phUA, void* pUserData )BOOL ( UserFunc )( UAHARCHIVE* phUA, void* pUserData ). pUserData:pUserData:指针指向用户数据。该指针被不经修改递送至回调函数。 返回值：返回值： 如果下面的条件满足，函数返回值为TRUE： 在建立连接和清除连接的过程中没有出现故障。 回调函数返回的一直是值TRUE。 否则，返回值为FALSE。 函数：函数： uaUtilityEnumRecordsuaUtilityEnumRecords 函数执行以下各步： 建立到用户归档的连接。1. 如果过滤和分类条件已经被传输，设置过滤和分类条件。2. 打开询问。3. 如滤波器还没有设置，函数调用回调函数，但是带一个到归档的“句柄”“句柄”。 如滤波器已存在，则在询问每个条目的一个循环循环里调用回调函数，但是带一个到一个条目的“句 柄”。 一旦回调函数返回值FALSE，则循环终止。 一旦回调函数返回值FALSE，则循环终止。函数 uaUtilityEnumRecordsuaUtilityEnumRecords 然后返回值 FALSE。 4. 在处理了回调函数后，到归档的连接被设置好。5. 下面的PDF文件中可看到函数的源码： uaUtilityEnumRecords_1.pdf ( 7 KB ) 回调函数的接口：回调函数的接口： phUA:phUA:指针指向一个用户归档的句柄。该“句柄”可以指向全部归档或仅仅 指向一个条目。 pUserData:pUserData:指向用户数据的指针。 返回值：返回值： Siemens - Automation and Drives - Service& Support - Aut. 第3页 共3页2005-05-31 2:06 如果出现故障，函数应该返回FALSE。 样本项目：样本项目： 该样本项目演示了函数uaUtilityEnumRecordsuaUtilityEnumRecords的应用。样本项目用WinCC V5.0生成。也可在WinCC V 4.02里使用该函数。 样本项目里包含了一个名叫“JobData”的用户归档样例。归档有两列。一列为产品的名称，另一列为产 品数量。在起始图像里有 4 个访问归档的按钮。 “插入作业”按钮在归档里插入一新行。 InsertButton_1.pdf ( 3 KB ) “更改作业”按钮为指定的作业 ID 设置数量。 Change_Job_Button_1.pdf ( 3 KB ) “取得具有最大量的作业”按钮为带规定的最大数量的作业提供名称。 Get_biggestJob_Button_1.pdf ( 3 KB ) “插入部件量的预置号”按钮为每个作业设置规定量。 Preset_No_of_PartsButton_1.pdf ( 3 KB ) 下面