资料内容分析intouchref

1、利。Invensys Systems, Inc. 公司事先保留所，不得以电或将其子、机械、影印、录制或其它任何方式、传输本文储存至检索系统。使用本文所含信息不需承担任何或专利责任。虽然在本文的编制过程中已采取一切预防措施，但错误或疏漏在所难免， 商和作者对此概不承担任何责任。对于因使用本文所含信息而导致的任何损害，亦不承担任何赔偿责任。本文所含信息变更，恕不另行通知，这些信息亦不代表 InvensysSystems, Inc. 公司一方的承诺。本文所述软件系在遵守证或协议的前提下提供。本软件的使用或须遵从这些协议规定的各项条款。© 2002, 2005 Invensys System

2、s, Inc.所有。保留所利。Invensys Systems, Inc.26561 Rancho Parkway South Lake Forest, CA 92630 U.S.A. (949) 727-3200商标本文所提及且已知为商标或服务标志的所有术语均采用首字母大写形式。Invensys Systems, Inc. 公司无法证实此类信息的准确性。使用本文中的任何术语不应视为会影响任何商标或服务标志的有效性。Alarm Logger、 ActiveFactory、 ArchestrA、 Avantis、 DBDump、DBLoad、 DT Analyst、 FactoryFocus、

3、FactoryOffice、 FactorySuite、FactorySuite A2、 InBatch、 InControl、 IndustrialRAD、 IndustrialSQL Server、 InTouch、 InTrack、 MaintenanceSuite、 MuniSuite、 QI Analyst、SCADAlarm、 SCADASuite、 SuiteLink、 SuiteVoyager、 WindowMaker、WindowViewer、 Wonderware 以及 Wonderware Logger 均为 Invensys plc、其分支及加盟机构的商标。所有其它品牌

4、可能是其相应所有者的商标。3目录目录简介17文档惯例17关于本手册18技术支持19FactorySuite证19第 1 章: 系统标记名21$AccessLevel22$ApplicationChanged23$ApplicationVersion23$ChangePassword24$ConfigureUsers24$Date25$DateString25$DateTime25$Day26$False26$HistoricalLogging.26$Hour27$InactivityTimeout27$InactivityWarning28$Language28$LogicRunning28$

5、Minute29$Month29$Msec29$NewAlarm30$ObjHor30$ObjVer30$Operator31$OperatorDomain31$OperatorDomainEntered32$OperatorEntered32$OperatorName32$PasswordEntered33$Second33$StartDdeConversations33$System34$Time34InTouch 参考指南4目录$TimeString34$VerifiedUserName35$Year35第 2 章: 点域及属性37标记名类型37记名38记名38内存类I/O间接 离散型、

6、间接模拟型、间接消息型39其它各种类型的标记名39标记名类型与点域用法表40.Ack45.AckDev46.AckDsc47.AckROC48.AckValue49.Alarm50.AlarmAccess51.AlarmAckM.52.AlarmClass53.AlarmComment54.AlarmDate55.AlarmDev56.AlarmDevCount57.AlarmDevDeadband57.AlarmDevUnAckCount58.AlarmDisabled58.AlarmDsc59.AlarmDscCount59.AlarmDscDisabled60.AlarmDscEnabl

7、ed60.AlarmDscInhibitor61.AlarmDscUnAckCount61.AlarmEnabled62.AlarmGroup62.AlarmGroupSel63.AlarmHiDisabled63.AlarmHiEnabled64.AlarmHiHiDisabled64.AlarmHiHiEnabled65.AlarmHiHiInhibitor66.AlarmHiInhibitor67InTouch 参考指南5目录.AlarmLimit68.AlarmLoDisabled68.AlarmLoEnabled69.AlarmLoInhibitor70.AlarmLoLoDisab

8、led.71.AlarmLoLoEnabled71.AlarmLoLoInhibitor72.AlarmMajDevDisabled73.AlarmMajDevEnabled73.AlarmMajDevInhibitor.74.AlarmMinDevDisabled75.AlarmMinDevEnabled75.AlarmMinDevInhibitor76.AlarmName77.AlarmOprName77.AlarmOprNode78.AlarmPri79.AlarmProv79.AlarmROC80.AlarmROCCount81.AlarmROCDisabled81.AlarmROCE

9、nabled82.AlarmROCInhibitor83.AlarmROCUnAckCount83.AlarmState84.AlarmTime84.AlarmTotalCount85.AlarmType85.AlarmUnAckCount86.AlarmUserDefNum187.AlarmUserDefNum288.AlarmUserDefStr89.AlarmValDeadband90.AlarmValue.90.AlarmValueCount91.AlarmValueUnAckCount91.Caption92.ChartLength93.ChartStart94.Comment94.

10、DevTarget95.DisplayMode95.Enabled96InTouch 参考指南6目录.EngUnits97.Freeze97.HiHiLimit98.HiHiSet98.HiHiStatus99.HiLimit99.HiSet100.HiStatus100.ListChanged101.ListCount101.ListIndex102.LoLimit102.LoLoLimit103.LoSet103.LoLoSet104.LoLoStatus105.LoStatus.106.MajorDevPct106.MajorDevSet107.MajorDevStatus.107.Ma

11、xEU108.MaxRange109.MaxRaw110.MinEU111.MinorDevPct112.MinorDevSet112.MinorDevStatus113.MinRange114.MinRaw115.Name116.NewIndex118.NextPage118.Normal119.NumAlarms119.OffMsg120.OnMsg120.PageNum121.Pen1-.Pen8121.PendingUpdates124.PrevPage124.PriFrom125.PriTo125.ProvidersReq126InTouch 参考指南7目录.ProvidersRet

12、126.Quality127.QualityLimit130.QualityLimitString130.QualityStatus131.QualityStatusString131.QualitySubstatus132.QualitySubstatusString132.QueryState133.QueryType133.RawValue134.ReadOnly134.Reference135.ReferenceComplete135.ROCPct.136.ROCSet.136.ROCStatus137.ScooterLockLeft137.ScooterLockRight.138.S

13、cooterPosLeft139.ScooterPosRight140.Successful141.SuppressRetain141.TagID142.TimeDate142.TimeDateString142.TimeDateTime143.TimeDay143.TimeHour143.TimeMinute144.TimeMonth144.TimeMsec145.TimeSecond145.TimeTime146.TimeTimeString146.TimeYear146.TopIndex147.TotalPages147.UnAck148.UpdateCount.149.UpdateIn

14、Progress150.UpdateTrend151.Value151InTouch 参考指南8目录.Value152.Visible153第 3 章: InTouch QuickScript 函数155Abs()156Ack()156ActivateApp()157AddPermission()157almAckAll()158almAckDisplay()158almAckGroup()159almAckPriority()159almAckRecent()160almAckSelect()160almAckSelectedGroup()161almAckSelectedPriority(

15、)161almAckSelectedTag()162almAckTag()162almDefQuery()163almMoveWindow()163almQuery()164almSelectAll()165almSelectGroup()165almSelectionCount()166almSelectItem()166almSelectPriority()166almSelectTag()167almSetQueryByName()167almShowStats()168almSuppressAll()168almSuppressDisplay()168almSuppressGroup(

16、)169almSuppressPriority()169almSuppressRetain()170almSuppressSelected()170almSuppressSelectedGroup()171almSuppressSelectedPriority()171almSuppressSelectedTag()172almSuppressTag()172almUnSelectAll()173almUnSuppressAll()173AnnotateLayout()174InTouch 参考指南9目录关于 APU 函数175APUFindAlarmGroupInstance()176APU

17、FindFileInstance()177APUFindPrinterInstance()178APUGarmGroupText()179APUGetConfigurationFilePath()180APUGetInstanceCount()181APUGetPrinterJobCount()182APUGetPrinterName()183APUGetPrinterStatus()184APUGetQueryAlarmState()185APUGetQueryFromPriority()185APUGetQueryProcessingState()186APUGetQueryToPrior

18、ity()186APUIsInstanceUsed()187APUSarmGroupText()187APUSetQueryAlarmState()188APUSetQueryFromPriority()188APUSetQueryToPriority()189APUSetTimeoutValues()190APUStartInstance()191APUStartQuery()192APUStopInstance()193APUStopQuery()193APUTranslateErrorCode()194ArcCos()194ArcSin()195ArcTan()195AttemptInv

19、isibleLogon()196ChangePassword()196ChangeWindowColor()197Cos()197DateTimeGMT()198DialogStringEntry()198DialogValueEntry()199DText()201EnableDisableKeys()201Exp()202FileCopy()202FileDelete()203FileMove()204FileReadFields()205FileReadMessage()206InTouch 参考指南10目录FileWriteFields()206FileWriteMessage()20

20、7GetAccountStatus()208GetNodeName()208GetPropertyD()209GetPropertyI()209GetPropertyM()210Hide210HideSelf211HTGetLastError()211HTGetPenName()212HTGetTimeAtScooter()212HTGetTimeStringAtScooter()213HTGetValue()214HTGetValueAtScooter()215HTGetValueAtZone()216HTScrollLeft()217HTScrollRight()217HTSelectTa

21、g()218HTSetPenName()218HTUpdateToCurrentTime()219HTZoomIn()219HTZoomOut()220InfoAppActive()220InfoAppTitle()221InfoDisk()222InfoFile()223InfoInTouchAppDir()224InfoResources()224Int()225InTouchVersion()225InvisibleVerifyCredentials()226IODisableFailover()226IOForceFailover()227IOGetAccessNameStatus()

22、227IOGetActiveSourceName()228IOGetApplication()228IOGetNode()228IOGetTopic()229IOReinitAccessName()229IOReinitialize()229IOSetAccessName()230IOSetItem()231InTouch 参考指南11目录IOSetRemoteReferences()232IOStartUninitConversations()232IsAnyAsyncFunctionBusy()233IsAssignedRole()234Log()234LogMessage()235Log

23、N()235Logoff()236LogonCurrentUser()236OpenWindowsList()236Pi()237PlaySound()237PostLogonDialog()238PrintHT()238PrintScreen().239PrintWindow()240ptGetTrendType()242ptLoadTrendCfg()242ptPanCurrentPen()243ptP(). 244ptPauseTrend()244ptSaveTrendCfg()245ptSetPen()245ptSetPenEx().245ptSetCurrentPen()246ptS

24、etTrend()246ptSetTimeAxis()247ptSetTimeAxisToCurrent()247ptSetTrendType()247ptZoomCurrentPen()248ptZoomTime()248QueryGroupMembership()249RecipeDelete()249RecipeGetMessage()250RecipeLoad()251RecipeSave()252RecipeSelectNextRecipe()253RecipeSelectPreviousRecipe()254RecipeSelectRecipe()255RecipeSelectUn

25、it()256ReloadWindowViewer()256RestartWindowViewer()257Round().257InTouch 参考指南12目录SendKeys258SetPropertyD()259SetPropertyI()260SetPropertyM()260SetWindowPrinter()261Sgn()261Show262ShowAt()263ShowHome263ShowTopLeftAt()264Sin()264SPCConnect()265SPCDatasetDlg()265SPCDisconnect()266SPCDisplayData()266SPC

26、LocateScooter()267SPCMoveScooter()267SPCSaveSample()267SPCSelectDataset()268SPCSelectProduct()268SPCSetControlLimits()268SPCSetMeasurement()269SPCSetProductCollected()269SPCSetProductDisplayed()270SPCSetRangeLimits()270SPCSetSpecLimits()270SQLAppendStatement()271SQLClearParam()271SQLClearStatement()

27、271SQLClearTable()272SQLCommit()273SQLConnect()274SQLCreateTable()276SQLDelete()277SQLDisconnect()277SQLDropTable()278SQLEnd()278SQLErrorMsg()278SQLExecute()279SQLFirst()279SQLGetRecord()280SQLInsert()280SQLInsertEnd()281InTouch 参考指南13目录SQLInsertExecute()281SQLInsertPrepare()282SQLLast()282SQLLoadSt

28、atement()283SQLManageDSN()283SQLNext()284SQLNumRows().284SQLPrepareStatement()285SQLPrev()285SQLRollback()286SQLSelect()287SQLSetParamChar()290SQLSetParamDate()290SQLSetParamDateTime()291SQLSetParamDecimal()291SQLSetParamFloat()292SQLSetParamInt()292SQLSetParamLong()292SQLSetParamNull()293SQLSetPara

29、mTime()294SQLSetStatement()295SQLTransact()296SQLUpdate()297SQLUpdateCurrent()298Sqrt().298StartApp299StringASCII()299StringChar()300StringCompare()300StringCompareEncrypted()301StringCompareNoCase()301StringFromGMTTimeToLocal()302StringFromIntg()303StringFromReal()304StringFromTime().305StringFromT

30、imeLocal()306StringInString()307StringLeft()308StringLen()308StringLower()309StringMid()309StringReplace()310StringRight()311InTouch 参考指南14目录StringSpace()311StringTest()312StringToIntg()313StringToReal()313StringTrim()314StringUpper()315SwitchDisplayLanguage()315Tan()316Text()316Trunc()317TseGetClie

31、ntId()317TseGetClientNodeName()317TseQueryRunningOnClient()318TseQueryRunningOnConsole()318UTCDateTime()319wcAddItem()319wcClear()320wcDeleteItem()320wcDeleteSelection()321wcErrorMessage()321wcFindItem()322wcGetItem()323wcGetItemData()323wcInsertItem()324wcLoadList()324wcLoadText()325wcSaveList()326

32、wcSaveText()327wcSetItemData()328WindowState()329WWControl()329WWExecute()330WWIsDayLightSaving()331WWMoveWindow()331WWPoke()332WWRequest()333WWStringFromTime()334第 4 章: OLE 自动化与 InTouch335OLE 自动化元素335InTouch OLE 自动化客户端扩展336InTouch 自动化表.336InTouch 参考指南15目录创建对象：OLE_CreateObject339管理对象：OLE_ReleaseObje

33、ct339测试有效对象：OLE_IsObjectValid340获取属性值340设置属性342调用方法343InTouch 错误处理345常见自动化对象错误347附录 A: QuickScript 函数疑难排解349窗口控件和分布式的错误消息349配方函数疑难排解350打印实用程序函数的错误消息352SPC DDE 项目名353SPC和显示 DDE 项目353SPC 当前样本 DDE 项目355SPC 手工输入 DDE 项目358SPC 选择 DDE 项目359SQL函数疑难排解361特定的数据库错误消息363索引365InTouch 参考指南16目录InTouch 参考指南17简介简介本参考

34、指南按字母表顺序编排，向您介绍 InTouch套件中每个标记名点域 ( field)、窗口控件属性、对象属性、系统标记名以及QuickScript 函数的详细信息。其中包括 Recipe Manager、 SPC Pro 和SQL Access Manager 等 InTouch 附加。本参考指南由以下各章组成：第 1 章 “系统标记名”，详细介绍预定义的所有 InTouch 系统标记名。备注 所有系统标记名均以号 ($) 开头。第 2 章“点域”，详细介绍标记名、分布式、窗口控件、系统、历史趋势及其它对象的标记名点域。第 3 章 “InTouch QuickScript 函数”，详细介绍内置

35、的 InTouchQuickScript 函数 （字及其它函数）。、数学、系统、历史、窗口控件、分布式第 4 章 “OLE 自动化与 InTouch”简要介绍 “OLE 自动化”结构。文档惯例为方便参考，在每个系统标记名、属性、点域及函数的表格字段中，都列出用途类别 （、应用程序等）。InTouch 参考指南惯例示例描述.ChartStart通常，粗体文字表示点域、系统标记名或函数。Tagname在语法中，斜体字母表示您提供的信息的占位符。 .HiLimit | .HiHiLimit 在语法中，大括号和竖杠表示从两个或多个项目中作出的选择。ErrorMessage=方括号中的项目是可选项。18

36、开始之前关于本手册如果您联机阅读本手册，看到绿色文本时，可单击该文本以 “跳转”到所的部分或章节。跳转到另一节或另一，如果您想要返回原来的章节，请使用所提供的 “后退”选项。提示 这些 “提示”告诉您如何更简便快捷地完成某项功能或任务。InTouch 用户指南帮助您熟悉 WindowMaker 开发环境及其工具 （如需有关详细信息，请阅读第 1 章 “WindowMaker 程序元素”）。要了解如何使用窗口、图形对象、向导及 ActiveX 控件等，请阅读第 2 章 “使用WindowMaker”。如需有关编写 InTouch QuickScript 的详细信息，请阅读第 6 章 “在 InT

37、ouch 中创建 QuickScript”。如需有关运行时环境 (WindowViewer) 的详细信息，请参阅 InTouch Runtime 用户指南。如需有关附加程序 SPC Pro 的详细信息，请参阅 SPC Pro 用户指南。如需有关附加程序 Recipe Manager 的详细信息，请参阅 Recipe Manager用户指南。如需有关附加程序 SQL Access Manager 的详细信息，请参阅 SQL Access Manager 用户指南。FactorySuite 软件包中还包含了FactorySuite 组件的联机手册。备注 要查看或打印联机手册，必须安装 Adobe

38、Acrobat Reader。假设本手册假定您：熟悉 Windows 操工作环境。了解如何使用鼠标、 Windows 菜单、选择选项及助”。具备使用编程语言或宏语言的经验。要取得最佳效果，最好应理解 一些编程概念，如变量、语句、函数及方法。联机 “帮InTouch 参考指南19简介技术支持“Wonderware 技术支持”提供许多支持选项，可回答有关 Wonderware及其具体实施的任何疑问。在技术支持之前，请参阅 InTouch 用户指南 中相章节，以寻求您在使用 InTouch 系统时所遇问题的可能解决方案。如果您认为有必要求助于技术支持，请提供以下信息：..

39、软件序列号。运行的 InTouc本。所用操的类型与版本。所遇系统错误消息的准确描述。Log Viewer 或任何其它诊断应用程序提供的所有相关输出列表。尝试解决该问题的方法细节及其结果。有重现该问题的细节。如果所遇问题是老问题，且该问题仍然存在，请提供指定的“Wonderware 技术支持”案例号。FactorySuite证要查看 FactorySuite 系统证信息，请从 WindowMaker “帮助”菜单的关于框中启动证查看实用程序。要打开证实用程序1.2.在 WindowMaker 的帮助菜单上，选择关于命令。证。此时出现证实用程序 - LicView单击查看框。InTouch 参考指

40、南20开始之前InTouch 参考指南21系统标记名第1章系统标记名InTouch 提供了若干个预定义的系统标记名。这些标记名是 InTouch 内置的，您可以根据前面的号 ($) 符号来识别它们。在运行时， InTouch。任何可使用 InTouch 标记名或 QuickScript 中。通过这些标记名的值来回应系统的地方都可以使用系统标记名，如动画InTouch 参考指南22第 1 章$AccessLevelInTouch 参考指南定义当前登录的用户的级别。类别用法$AccessLevel附注这是一个只读标记名，它的值由指定给 InTouch 中当前登录用户配置文件的 “级别”来确定。这个

41、配置文件可以通过在WindowViewer 中选择配置用户菜单进行。9000 或更大的 $AccessLevel 值表示 “管理”权限，并且在WindowViewer 中启用 “”菜单，除此以外它的实际数值对于WindowViewer 而言没有任何意义。应用程序开发可以根据需要创建附加的。通过使用 $AccessLevel，可以在系统中进一步自定义。数据类型整型 （只读）有效值0 到 9999示例下列语句用在 “可视性”中，根据登录的用户的级别来确定是否让某个对象 （如按钮）变为可见：$AccessLevel >= 2000; 使用基于 $AccessLevel 的表，可以给对象设置一个

42、关联的“禁用”。 $AccessLevel < 5411;IF $AccessLevel <=500 THENShow "Access Denied" 弹出显示拒绝的窗口ELSEShow "Access Granted" 弹出显示的窗口ENDIF;另请参阅$Operator, $OperatorEntered, $PasswordEntered; $ConfigureUsers23系统标记名$ApplicationChanged$ApplicationVersionInTouch 参考指南包含应用程序的当前版本号。每次发生可以保存或撤消的更改

43、时，此数 字都会改变。类别应用程序用法$ApplicationVersion附注无数据类型实型 （只读）示例用在 “模拟显示”中的时候，此系统标记名显示 WindowViewer中运行的应用程序的当前版本。$ApplicationVersion另请参阅$ApplicationChanged指出 “网络应用程序开发”（Network Application Development，简称NAD）结构中的主应用程序已经发生改变。类别应用程序用法$ApplicationChanged附注每次通过选择 WindowMaker 中特别菜单上客户生成更新信号 时，此标记名便更改为 1。在应用程序更新之后，它

44、会重置为 0。此标记名用于维护分布式应用程序。数据类型离散型 （只读）示例如果用在 “数据改变” QuickScript 的标记名点域中，下列语句会执行 QuickScript 的主体。 QuickScript 的主体可能显示一个窗口，提醒用户重新启动 WindowViewer 以便使更改生效。$ApplicationChanged另请参阅$ApplicationVersion24第 1 章$ChangePassword$ConfigureUsersInTouch 参考指南显示普通的配置用户框。相当于选择 WindowViewer 中特别菜单上的，然后再选择改变口令。此函数仅在 “InTouc

45、h”下才起作用。类别用法$ConfigureUsers附注将此值设置为 1 时，可以显示配置用户框。关闭框之后，InTouch 会将该值自动重置为 0。要显示此框，用户的$AccessLevel 必须是 9000。将这个系统标记名设置为 1 以外的值没有意义，其结果尚未定义。仅有 "InTouch"类型提供此函数。数据类型离散型 （只写）有效值1示例您可以创建一个离散型按钮，供操作员打开改变口令框。该按钮应该附加一个 “离散按钮”，并选定了置位选项。按下该按钮时， $ConfigureUsers 会被设置为 1，从而显示配置用户框。另请参阅$Operator, $Opera

46、torEntered, $ChangePassword, $PasswordEntered,$AccessLevel显示改变口令框。相当于选择 WindowViewer 中特别菜单上的安全性，然后再选择改变口令。类别用法$ChangePassword附注将此值设置为 1 时，会显示改变口令框。关闭该框之后， InTouch 会自动将该值重置为 0。将此系统标记名设置为 1 以外的值没有意义，其结果尚未定义。数据类型离散型 （只写）有效值1示例您可以创建一个离散型按钮，供操作员打开改变口令框。该按钮应该附加一个 “离散按钮”，并选定了 “置位”选项。按下该按， $ChangePassword 会

47、被设置为 1，从而显示改变口令框。另请参阅$AccessLevel, $OperatorEntered, $PasswordEntered, $Operator,$ConfigureUsers25系统标记名$Date$DateString$DateTimeInTouch 参考指南包含自 1970 年 1 月 1 日以来以分数形式表示的天数。类别系统用法$DateTime附注无数据类型实型 （只读）示例dayvalue = 86400 * $DateTime;If StringFromTime(Dayvalue,4) = "Fri" THEN DisplayMessageTa

48、g = "It's Friday!"ENDIF;另请参阅$Date, $DateString, $Day, $Month, $Year, $Time, $TimeString包含系统 “短日期”格式的日期 （在 “区域和语言”设置中定义）。类别系统用法$DateString附注日期格式是通过 “Windows面板”设置的。数据类型内存消息 （只读）示例If StringRight($DateString,2)= "00" THEN LogMessage("The Year 2000!");ENDIF;另请参阅$Date, $D

49、ateTime, $Day, $Month, $Year, $Time, $TimeString包含自 1970 年 1 月 1 日以来的天数当中的整数部分。类别系统用法$Date附注无数据类型整型 （只读）示例StringFromTime($Date*86400)+($Time/1000),3); 返回当前时间 另请参阅$DateTime, $DateString, $Day, $Month, $Year26第 1 章$Day$False$HistoricalLoggingInTouch 参考指南和 （或）历史功能的启动与停止。相当于选择WindowViewer 中特别菜单上的重新启动历史，

50、或相当于选择WindowViewer 中特别菜单上的停止历史。类别历史用法$HistoricalLogging附注将此系统标记名设置为 0 时，可以停止历史 功能。将此值设置为 1 时，可重新启动历史 功能。除非在历史 属性 框中选定了允许历史 选项，否则不能使用 $HistoricalLogging “启动”历史功能。数据类型离散型 （读/ 写）示例IF (InfoDisk("C",4,$Second)/1024)<50 THEN 如果空闲空间不足 50MB，则关闭历史功能 $HistoricalLogging = 0;ENDIF;$False 用于在表中返回 FALSE 值。还可用于在从 InTouch 的较早版本移植应用，替换废弃 “系统”标记 - $AlarmPrinterError、$AlarmPrinterOffline、$AlarmPrinterOverflow 与 $AlarmPrinterNoPaper。类别系统用法$False附注$False 设置为 False。此标记只有在从 InTouch 的较早版本移植应用程序时才有效。数据类型离散型 （