1、Wonderware? FactorySuite?Recipe Manager 用戶指南修訂版 A最后修訂日期：2002 年 11 月 11 日Invensys Systems, Inc.保留所有權(quán)利。未經(jīng) Invensys Systems, Inc. 公司事先書面許可，不得以電子、機(jī)械、影印、錄制或其它任何方式復(fù)制、傳輸本文任何部分或?qū)⑵鋬Υ嬷翙z索系統(tǒng)。使用本文所含信息不應(yīng)承擔(dān)任何版權(quán)或?qū)＠?zé)任。雖然在本文的編制過程中已采取一切預(yù)防措施，但錯誤或疏漏在所難免，商和作者對此概不承擔(dān)任何責(zé)任。對于因使用本文所含信息而導(dǎo)致的任何損害，亦不承擔(dān)任何賠償責(zé)任。本文所含信息如有變更，恕不另行，亦不代表

2、Invensys Systems, Inc.公司一方的承諾。本文所述軟件系在遵守許可證或保密協(xié)議的前提下提供。本軟件的使用或復(fù)制須遵從這些協(xié)議規(guī)定的各項條款。? 2002 Invensys Systems, Inc. 版權(quán)所有。保留所有權(quán)利。Invensys Systems, Inc. 33 Commercial StreetFoxboro, MA 02035(949) 727-3200商標(biāo)本書所有作為商標(biāo)或服務(wù)標(biāo)志的專門名詞均采用大寫字母印刷。Invensys Systems, Inc. 公司并不保證此類信息的準(zhǔn)確性。使用本書中的任何術(shù)語不應(yīng)視

3、為會影響任何商標(biāo)或服務(wù)標(biāo)志的有效性。Alarm Logger、 ActiveFactory、 ArchestrA、 Avantis、 DBDump、DBLoad、 DTAnalyst、 FactoryFocus、 FactoryOffice、 FactorySuite、hotlinks、 InBatch、 InControl、 IndustrialRAD、 IndustrialSQL Server、InTouch、 InTrack、 MaintenanceSuite、 MuniSuite、 QI Analyst、SCADAlarm、 SCADASuite、 SuiteLink、 SuiteVo

4、yager、 WindowMaker、WindowViewer、 Wonderware 以及 Wonderware Logger 均為 Invensys plc、其分支及加盟機(jī)構(gòu)的商標(biāo)。所有其它品牌可能是其相應(yīng)所有者的商標(biāo)。3目錄目錄第 1 章 : Recipe Manager 簡介5關(guān)于本手冊5技術(shù)支持6FactorySuite 許可證7Recipe Manager 程序7配方模板文件7運行 Recipe Manager8配方模板共同特點9第 2 章 : 使用 Recipe Manager11配置配方模板首選項11新建配方模板文件12編輯配方模板文件17第 3 章 : 使用配方函數(shù)23配方函

5、數(shù)23配方參數(shù)24使用配方函數(shù)25合并配方函數(shù)26嵌套配方26給配方應(yīng)用安全設(shè)置27第 4 章 : 配方函數(shù)疑難排解29函數(shù)疑難排解29顯示錯誤碼消息31第 5 章 : 在其它 Windows 應(yīng)用程序中創(chuàng)建配方 33使用 Excel 處理配方模板文件33使用記事本處理配方模板文件35索引37InTouch Recipe Manager 用戶指南4目錄InTouch Recipe Manager 用戶指南Recipe Manager 簡介5第1章Recipe Manager 簡介在制造業(yè)中，配方用于描述許多不同的事物。例如，面包房有餅干的基礎(chǔ)配方，列出制作餅干的必需成分，以及許多諸如胡桃、水果

6、、巧克力片等可選成分，這些選擇性成分加上基本成分，就可以制作出各種不同風(fēng)味的餅干。在鋼鐵廠里，配方可以是機(jī)器設(shè)置參數(shù)的集合。在批處理程序中，配方可以用來描述批處理過程中的各種不同實例。 InTouch Recipe Manager 結(jié)合基本 InTouch QuickScript 函數(shù)使用，可處理所有這些情形。Wonderware Recipe Manager 附加產(chǎn)品包括兩個元件：“配方管理器”和一系列配方函數(shù)。 Recipe Manager 是用于創(chuàng)建配方模板文件的一個獨立可執(zhí)行程序。配方函數(shù)在 InTouch QuickScripts 中用于訪問配方模板文件。通過使用配方函數(shù)， InTo

7、uch 可以選擇、加載、修改、創(chuàng)建及刪除配方模板文件中包含的配方。目錄?關(guān)于本手冊技術(shù)支持FactorySuite 許可證Recipe Manager 程序運行 Recipe Manager關(guān)于本手冊本手冊由邏輯上相互連貫的多個章節(jié)組成，介紹建立 “配方模板”的方方面面。本書采用 “過程化”的格式編寫而成，用有標(biāo)號的步驟闡述如何執(zhí)行大多數(shù)的功能或任務(wù)。如果您在線閱讀本手冊，則看到綠色文本時，可單擊該文本以 “跳轉(zhuǎn)” 到所引用的部分或章節(jié)。跳轉(zhuǎn)到另一節(jié)或另一章之后，如果您想要返回原來的章節(jié)，請使用所提供的 “后退”選項。InTouch Recipe Manager 用戶指南6第 1 章提示 這些

8、 “提示”告訴您如何更簡便快捷地實現(xiàn)某項功能或完成某項任務(wù)。InTouch 用戶指南將幫助您熟悉 WindowMaker 開發(fā)環(huán)境及其工具 （如需有關(guān)詳細(xì)信息，請參閱第 1 章 “WindowMaker 程序元素”）。若要了解如何使用窗口、圖形對象、向?qū)Ъ?ActiveX 控件等，請閱讀第 2 章 “使用 WindowMaker”。如需有關(guān)編寫 InTouch QuickScripts 的詳細(xì)信息，請參閱第 6 章 “在 InTouch 中創(chuàng)建 QuickScript”。此外， InTouch 參考指南還會為您提供具有一定深度的參考資料，向您介紹有關(guān) InTouch QuickScript 語

9、言與函數(shù)、系統(tǒng)標(biāo)記名以及標(biāo)記名點域的詳細(xì)信息。如需有關(guān)運行時環(huán)境 (WindowViewer) 的詳細(xì)信息，請參閱在線 InTouch運行時用戶指南。如需有關(guān)附加程序 SPC Pro 的詳細(xì)信息，請參閱 SPC Pro 用戶指南。如需有關(guān)附加程序 SQL Access Manager 的詳細(xì)信息，請參閱 SQL Access Manager 用戶指南。FactorySuite 系統(tǒng)管理員指南還為您提供有關(guān) FactorySuite 中的一般組件、系統(tǒng)要求、聯(lián)網(wǎng)注意事項、產(chǎn)品集成以及技術(shù)支持等方面的完整信息。FactorySuite 軟件包還包含全部 FactorySuite 組件的聯(lián)機(jī)手冊。備

10、注 若要查看或打印聯(lián)機(jī)手冊，您必須安裝 Adobe Acrobat Reader（4.0或更高版本）。假設(shè)本手冊假設(shè)您：?熟悉 Windows 2000 和 （或） Windows NT 操作系統(tǒng)工作環(huán)境。了解如何使用鼠標(biāo)、 Windows 菜單、選擇選項及訪問聯(lián)機(jī) “幫助”。具備使用編程語言或宏語言的經(jīng)驗。若要取得最佳效果，您最好應(yīng)理解一些編程概念，如變量、語句、函數(shù)及方法。?技術(shù)支持Wonderware 提供許多技術(shù)支持選項，以回答有關(guān) Wonderware 產(chǎn)品及其實施的各種問題。在聯(lián)系技術(shù)支持之前，請參閱您的用戶指南中的相關(guān)章節(jié)，尋求使用Recipe Manager 時所遇問題的可能解

11、答。如果您認(rèn)為有必要求助于技術(shù)支持，請?zhí)峁┮韵滦畔ⅲ篒nTouch Recipe Manager 用戶指南Recipe Manager 簡介71.2.3.軟件序列號。所運行的 InTouc本。所用操作系統(tǒng)的類型與版本。例如， Microsoft Windows NT 4.0 版工作站。所遇系統(tǒng)錯誤消息的準(zhǔn)確描述。Wonderware Logger、Microsoft Diagnostic utility (MSD) 或任何其它診斷應(yīng)用程序提供的所有相關(guān)輸出列表。您嘗試解決問題的方法細(xì)節(jié)及其結(jié)果。有關(guān)如何重現(xiàn)問題的細(xì)節(jié)。如果所遇問題是老問題，且該問題仍然存在，請?zhí)峁┲付ǖ摹癢onderware

12、技術(shù)支持”案例號。.8.如需有關(guān) “技術(shù)支持”的詳細(xì)信息，請參閱聯(lián)機(jī) FactorySuite 系統(tǒng)管理員指南。FactorySuite 許可證要查看您的 FactorySuite 系統(tǒng)許可證信息，請從 WindowMaker “幫助” 菜單的關(guān)于對話框啟動許可證查看程序。要打開許可證實用程序1. 在 WindowMaker 的幫助菜單上，選擇關(guān)于命令。2. 單擊查看許可證。此時會出現(xiàn)許可證實用程序 - LicView 對話框。如需有關(guān)許可證查看實用程序的詳細(xì)信息，請參閱 FactorySuite 系統(tǒng)管理員指南。Recipe Manager 程序Recipe Manager 程

13、序采用類似于電子表格的用戶界面，可供您創(chuàng)建與維護(hù)配方模板文件。雖然配方模板文件可以使用任何電子表格或字處理程序來創(chuàng)建，但如果使用 Recipe Manager，通過它提供的一些快捷方式與有條不紊的操作過程，則創(chuàng)建配方模板文件的任務(wù)會變得更為簡便，發(fā)生錯誤的可能性也大為降低。配方模板文件所有配方都定義并存儲在配方模板文件中。這些文件包含下面的信息：?配方中可以使用的所有成分名稱及其數(shù)據(jù)類型。將 InTouch 標(biāo)記名與配方成分值相關(guān)聯(lián)的 “單元名”。包含配方實例所用的每種成分的數(shù)量或值的 “配方名”。InTouch Recipe Manager 用戶指南8第 1 章配方模板文件包括下面三個模板模

14、板定義您將使用 “模板定義”去定義配方包含的所有成分。每個配方成分都需要一個數(shù)據(jù)類型。數(shù)據(jù)類型可以是 “模擬”、“離散”或 “消息”型。您將使用 “單元定義”模板來關(guān)聯(lián) InTouch 標(biāo)記名和配方成分。您可以創(chuàng)建許多不同的加載定義。這些定義被稱作單元。 RecipeLoad() 函數(shù)使用這些定義將特定的配方實例加載到關(guān)聯(lián)的 InTouch 標(biāo)記名中?！皢卧x”既可以包含所有成分名，也可以只包含其中的一部分。備注 為單元定義的標(biāo)記名可以是 “內(nèi)存”型，能在 InTouch 窗口查看和 （或）編輯；也可以是 I/O 型，能直接加載到 PLC。每個模板文件均保存為 .CSV （逗號分隔變量）文件

15、格式。因此，您可以在任何支持 .CSV 文件格式的軟件中創(chuàng)建、打開或編輯配方模板定義。例如，“記事本”或 Microsoft Excel。配方定義您可以使用配方定義模板來為配方中的每個實例定義配方名稱，以及實例中每種成分所需的數(shù)量。配方實例可以通過配方函數(shù)在運行時修改、創(chuàng)建或刪除。運行 Recipe ManagerRecipe Manager 是 Wonderware InTouch 的一個附加程序。當(dāng)您安裝Recipe Manager 時，它會自動添加到 WindowMaker 的 “應(yīng)用程序瀏覽器”中。因此，您可以在 WindowMaker 內(nèi)運行 Recipe Manager 程序。如需

16、有關(guān) “應(yīng)用程序瀏覽器”的詳細(xì)信息，請參閱 InTouch 用戶指南。要運行 Recipe Manager1.運行 InTouch WindowMaker，在 “應(yīng)用程序瀏覽器”中單擊應(yīng)用程序，然后雙擊 Recipe Manager。InTouch Recipe Manager 用戶指南Recipe Manager 簡介92.在文件菜單上，單擊新建。此時會出現(xiàn)三個 Recipe Manager 模板。配方模板共同特點這三個模板具有以下共同特點：InTouch Recipe Manager 用戶指南特點描述輸入框文本輸入框用于為所選單元輸入數(shù)據(jù)。提示 選定某個單元時，它的內(nèi)容會顯示在文本輸入框中

17、。選擇 / 自動調(diào)整模板大小單擊一次即可選擇整個模板。雙擊可以將模板中所有列的大小自動調(diào)整為最長項目的寬度。選擇 / 自動調(diào)整列大小單擊一次即可選擇整個列。雙擊可以將列的大小自動調(diào)整為最長項目的寬度。備注 模板定義模板中的項目類型列不能自動調(diào)整大小。選擇行選擇相應(yīng)的行。10第 1 章InTouch Recipe Manager 用戶指南使用 Recipe Manager11第2章使用 Recipe ManagerRecipe Manager 使用三種不同的模板來創(chuàng)建配方。您可以為模板配置首選項。本章向您介紹配置配方模板首選項及創(chuàng)建配方的程序。目錄?配置配方模板首選項新建配方模板文件編輯配方模板

18、文件配置配方模板首選項在開始定義配方之前，您必須為配方模板的缺省值配置首選項。配置首選項時，您需要指定每個配方模板中項目、單元和配方名的最大數(shù)目。要配置首選項1.在選項菜單上，單擊首選項。此時會出現(xiàn)首選項對話框。2.在最大項目框中，輸入您想要允許在模板定義模板中使用的項目名數(shù)目。在最大單元框中，輸入您想要允許在單元定義模板中使用的單元數(shù)目。3.InTouch Recipe Manager 用戶指南12第 2 章4.在最大配方框中，輸入允許在配方定義模板中使用的配方數(shù)目。提示 以上三項的最大值為 9999。不過，數(shù)目越大，它影響系統(tǒng)響應(yīng)時間的程度也就越高。5.單擊確定。注意！ 您在首選項對話框中

19、設(shè)置的值將應(yīng)用于您創(chuàng)建的所有配方模板文件。您修改這些值時，現(xiàn)有的全部配方模板文件也會被修改。要打開 “按下回車鍵自下”功能：在選項菜單上，單擊按下回車鍵自下。提示 按下回車鍵自下選項簡化了在配方模板中輸入數(shù)據(jù)的過程。打開此選項時，每次在模板中執(zhí)行輸入后，可按下 ENTER 鍵讓光標(biāo)移到同一列中的下一個單元。要關(guān)閉 “按下回車鍵自下”功能：在選項菜單上，再次單擊按下回車鍵自下。新建配方模板文件創(chuàng)建配方模板文件時，您可以使用以下三個模板：InTouch Recipe Manager 用戶指南模板描述模板定義用于定義配方中的所有成分。每個配方成分均須指定一種數(shù)據(jù)類型。數(shù)據(jù)類型可以是 “模擬”、“離散

20、”或 “消息”。單元定義用于關(guān)聯(lián) InTouch 標(biāo)記名與配方成分。您可以創(chuàng)建許多不同的單元定義。 Recipe Manager RecipeLoad() QuickScript 函數(shù)使用這些定義， 將特定的配方實例加載到各種不同的 InTouch 標(biāo)記元定義可以包含所有成分名，也可以只包含其中一部分。配方定義定義每個配方的名稱及所用每個配方成分所需的量。使用 Recipe Manager13要定義 “模板定義”：1.在文件菜單上，單擊新建。此時會出現(xiàn)三個 Recipe Manager 模板。提示 如果您右擊文本輸入框，則會出現(xiàn)一個菜單，顯示出可應(yīng)用于所選文本的各個命令。2.3.單擊模板定義模

21、板的標(biāo)題欄以將它激活，并將它置于窗口前端。在項目名列的單元中，給每個配方成分輸入任意一個名稱。提示 每個單元只能輸入一種成分。如果 ENTER 鍵已設(shè)置為按下回車鍵自下，則在輸入每種成分后，按下 ENTER 鍵可向下移動到下一個單元。4.在項目類型列的單元中為相應(yīng)配方成分輸入一個有效的項目類型。提示 有效的項目類型有：“模擬”、“離散”或 “消息”。您只要在單元中輸入類型的第一個字母，然后按下 ENTER。Recipe Manager 將自動填入其余部分。要定義 “單元定義”：1.單擊單元定義模板的標(biāo)題欄以便將它激活，并將它置于窗口前端。InTouch Recipe Manager 用戶指南1

22、4第 2 章提示 單元定義模板顯示先前輸入的模板定義模板中的項目名和項目類型信息。2.在單元名 行 在每個列標(biāo)題 （單元 1、單元 2 等）下方的單元格中中，輸入要定義的每個單元的名稱。提示 您可以使用模板上的滾動條來瀏覽配方數(shù)據(jù)。項目名和項目類型列不能移動。因此，在添加配方實例后，主配方消息仍保持可見狀態(tài)。3.在單元 # 列的單元中，為項目名列中每個相應(yīng)配方成分輸入 InTouch標(biāo)記名。提示 如果 WindowMaker 正在運行，請雙擊單元以顯示 “標(biāo)記瀏覽器”。要訪問 “標(biāo)記瀏覽器”， WindowMaker 必須正在運行。4.在 “標(biāo)記瀏覽器”上雙擊所需的標(biāo)記名以便將其插入到單元格，

23、或者是選擇標(biāo)記名，然后單擊確定。提示 給單元定義的標(biāo)記名可以是 “內(nèi)存”型標(biāo)記名，此種標(biāo)記名可以在 InTouch 窗口中查看或編輯；也可以是 IO 型標(biāo)記名，此種標(biāo)記名可直接加載到 PLC。如需有關(guān) “標(biāo)記瀏覽器”的詳細(xì)信息，請參閱 InTouch 用戶指南。對每個 “單元名”重復(fù)此過程。5.InTouch Recipe Manager 用戶指南使用 Recipe Manager15備注 在 InTouch QuickScript 中使用 RecipeLoad() 函數(shù)時，必須指定“配方名”和 “單元名”。執(zhí)行 QuickScript 時，該 “配方名”定義包含的值將加載到 “單元名”指定的

24、標(biāo)記名中。要定義 “配方定義”1.單擊配方定義模板的標(biāo)題欄以將它激活，并將它置于窗口前端。如果無法訪問，請使用窗口菜單選項來選擇模板。提示 配方定義模板會顯示先前定義的模板定義模板中的項目名和項目類型信息。2.在配方名 行 在每個配方列標(biāo)題 （配方 1、配方 2 等）下方的單元中中，輸入要定義的每個配方的名稱。提示 您可以使用模板上的滾動條來瀏覽配方數(shù)據(jù)。項目名和項目類型列不能移動。因此，在添加配方實例后，主配方消息仍保持可見狀態(tài)。3.在配方 # 列單元中，為項目名列中每個相應(yīng)的配方成分輸入值。InTouch Recipe Manager 用戶指南16第 2 章提示 在 InTouch Qui

25、ckScript 中執(zhí)行 RecipeLoad() 函數(shù)時，這些值將加載到 InTouch 標(biāo)記名中。此程序的 InTouch 配方函數(shù)部分會直接讀取或?qū)懭肱浞侥０逦募?。因此，不必運行 Recipe Manager 程序，便可在 InTouch QuickScript 中正確執(zhí)行配方函數(shù)。注意！ 如果 InTouch 目前正在使用該配方模板文件，新建的任何配方或?qū)ΜF(xiàn)有配方所作的任何更改均不能寫入配方模板文件。 Recipe Manager 只創(chuàng)建配方模板文件。在創(chuàng)建之后，應(yīng)關(guān)閉 Recipe Manager。4.在文件菜單上，單擊保存以保存配方模板文件。要打開現(xiàn)有的配方模板文件1.在文件菜單上

26、，單擊打開。此時會出現(xiàn)打開配方模板對話框。2.找到并選擇配方的文件，然后單擊打開，或雙擊該文件名。此時會出現(xiàn)該文件中的三個配方模板。InTouch Recipe Manager 用戶指南使用 Recipe Manager17要刪除配方模板文件1.在文件菜單上，單擊刪除。此時會出現(xiàn)刪除配方模板對話框。2.找到并選擇配方的 .CSV 文件，然后單擊打開，或雙擊該文件名。此時會出現(xiàn)一個消息框，要求您確認(rèn)刪除。備注 打開的配方模板文件無法刪除。編輯配方模板文件您可以通過多種方式來編輯現(xiàn)有的配方模板文件。其中最簡單的方法是使用編輯菜單命令。通過使用這些命令，您可以清除、填充、插入或刪除配方模板文件中所選

27、的一個單元或一定范圍內(nèi)的多個單元。InTouch Recipe Manager 用戶指南18第 2 章要清除選定范圍內(nèi)的單元1.選擇數(shù)據(jù)范圍。2.在編輯菜單上，單擊清除。此時會出現(xiàn)一個消息框，要求您確認(rèn)清除選定范圍內(nèi)的單元。單擊是?，F(xiàn)在選定范圍內(nèi)的數(shù)據(jù)會被清除掉。3.要向右、向下、向左或向上填充這些命令用于將所選范圍內(nèi)的單元中所包含的數(shù)據(jù)復(fù)制到鄰近范圍的單元中。1.選擇要復(fù)制的單元或單元范圍。然后，選擇要將數(shù)據(jù)復(fù)制到其中的鄰近范圍單元。（左側(cè)、右側(cè)、向上或向下）。提示 所選的范圍必須具有相同的大小。InTouch Recipe Manager 用戶指南使用 Recipe Manager192.

28、在編輯菜單上，選擇相應(yīng)的填充命令。此時數(shù)據(jù)會被復(fù)制到所選范圍的單元中。3.在編輯菜單上，指向向右填充，此時所選的數(shù)據(jù)會自右填充。提示 如果數(shù)據(jù)所復(fù)制到的新列不足以容納最長的輸入項，只要雙擊列標(biāo)題，即可將該列的寬度更改為最長輸入項的寬度。InTouch Recipe Manager 用戶指南20第 2 章要插入行您可以在模板定義模板中插入行。1.2.單擊項目 # 以便在模板定義中選擇要在它上方插入新行的的行。在編輯菜單上，單擊插入。此時新的一行會插入所選行的上方。備注 已經(jīng)達(dá)到為 Recipe Manager 的首選項配置的最大值之后，此命令將進(jìn)入非活動狀態(tài)。您必須關(guān)閉當(dāng)前模板文件，增大給配方模

29、板文件指定的添加 “項目 / 單元 / 配方”的數(shù)值。修改首選項時，所作的更改將應(yīng)用于現(xiàn)有的全部配方模板文件。3.后續(xù)各行將自動重新編號。提示 模板定義中插入和刪除的所有項也會自動反映到配方定義和單元定義模板。備注 您不能在配方定義或單元定義模板中插入行。要插入列您可以在配方定義或單元定義模板中插入列。InTouch Recipe Manager 用戶指南使用 Recipe Manager211.2.單擊單元 # 以便在單元定義中選擇要在它旁邊插入新列的的列。在編輯菜單上，單擊插入。此時新的一列會插入所選列的旁邊。3.在編輯菜單上，單擊插入。此時一個新的空白列會插入至所選列的左側(cè)。InTouc

30、h Recipe Manager 用戶指南22第 2 章提示 在本例中，注意 Mixer 1 的數(shù)據(jù)現(xiàn)在已移動到至單元 3 列，一個空白列已作為單元 2 插入。要刪除列您可以從配方定義或單元定義模板中刪除列。1.單擊單元 # 列標(biāo)題以選擇要刪除的列。2.在編輯菜單上，單擊刪除。此時會出現(xiàn)一個消息框，要求您確認(rèn)刪除操作。單擊是。現(xiàn)在該列會從模板中刪除掉。3.提示 在本例中，刪除單元 2 列時，單元 3 列中的 Mixer 2 數(shù)據(jù)將移到單元 2 列中。要刪除行您可以從模板定義模板中刪除行。1.2.單擊項目 # 行標(biāo)題以選擇要刪除的行。例如：在編輯菜單上，單擊刪除。此時會出現(xiàn)一個消息框，要求您確認(rèn)

31、刪除操作。單擊是?，F(xiàn)在該行會從模板中刪除掉。3.提示 例如，在上面的對話框中，如果刪除了項目 1 行，則項目 2 行中的數(shù)據(jù)會移到項目 1 行中。InTouch Recipe Manager 用戶指南23使用配方函數(shù)第3章使用配方函數(shù)InTouch 使用配方函數(shù)與配方模板文件執(zhí)行交互操作。這些函數(shù)是標(biāo)準(zhǔn)InTouch QuickScript 函數(shù)的擴(kuò)展，可用在任何腳本中。通過使用它們， 您可以從 InTouch Recipe 應(yīng)用程序中選擇、修改、插入或刪除現(xiàn)有配方模板文件中的記錄。目錄?配方函數(shù)配方參數(shù)使用配方函數(shù)嵌套配方給配方應(yīng)用安全設(shè)置配方函數(shù)本節(jié)列出所有的 “配方函數(shù)”。配方函數(shù)的一般

32、格式如下：RecipeFunction(Argument1, Argument2,.,ArgumentN)如需有關(guān)每個配方函數(shù)及其用法示例的詳細(xì)信息，請參閱 InTouch 參考指南。InTouch Recipe Manager 用戶指南函數(shù)描述RecipeDelete此函數(shù)用于從指定的配方模板文件刪除當(dāng)前定義的 “配方”名稱。RecipeGetMessage此函數(shù)用于將已執(zhí)行函數(shù)的錯誤碼寫入模擬型標(biāo)記名，相應(yīng)的錯誤碼消息寫入消息型標(biāo)記名。如需有關(guān)顯示錯誤代碼消息的詳細(xì)信息，請參閱第 4 章 “配方函數(shù)疑難排解”。24第 3 章配方參數(shù)下面介紹每個配方函數(shù)所需的參數(shù)。在腳本中輸入用英文引號括起

33、的參數(shù) （例如 Argument1）時，將使用完整的文字。如果沒有使用英文引號， Argument1 將被視為標(biāo)記名，系統(tǒng)會通過訪問 InTouch 標(biāo)記名目錄來獲取標(biāo)記名參數(shù) Argument1 的值。InTouch Recipe Manager 用戶指南函數(shù)描述RecipeLoad此函數(shù)用于將特定的配方加載到標(biāo)記名的特定單元中。如需有關(guān)標(biāo)記的詳細(xì)信息，請參閱InTouch 用戶指南。RecipeSave此函數(shù)用于將新近創(chuàng)建的配方或?qū)ΜF(xiàn)有配方所作的更改保存到指定的配方模板文件。RecipeSelectNextRecipe此函數(shù)用于選擇配方模板文件中當(dāng)前定義的下一個配方名。RecipeSele

34、ctPreviousRecipe此函數(shù)用于選擇配方模板文件中當(dāng)前定義的前一個配方名。RecipeSelectRecipe此函數(shù)用于選擇配方模板文件中當(dāng)前定義的特定配方名。RecipeSelectUnit此函數(shù)用于選擇當(dāng)前配方值所加載到的標(biāo)記元。如需有關(guān)合并函數(shù)的詳細(xì)信息，請參閱“合并配方函數(shù)”。25使用配方函數(shù)配方函數(shù)的參數(shù)可以是下面一項或多項：使用配方函數(shù)配方函數(shù)可自動插入 InTouch QuickScript。要將配方函數(shù)自動插入腳本1. 打開 QuickScript 編輯器，單擊附件，或在插入菜單上，選擇函數(shù)， 然后單擊附件。此時會出現(xiàn)選擇函數(shù)對話框，顯示已安裝的所有InTouch 附

35、加程序的全部函數(shù)。2. 單擊要插入 QuickScript 的配方函數(shù)。此時該對話框會關(guān)閉，函數(shù)將插入腳本中的光標(biāo)位置。如需有關(guān) InTouch QuickScript 的詳細(xì)信息，請參閱 InTouch 用戶指南第 6章 “在 InTouch 中創(chuàng)建 QuickScript”。InTouch Recipe Manager 用戶指南參數(shù)描述FileName此參數(shù)是函數(shù)所作用的配方模板文件的名稱。FileName 可以是字符串常量，也可以是 I/O 或內(nèi)存型 InTouch 標(biāo)記名。RecipeName此參數(shù)是函數(shù)要使用的指定配方模板文件定配方的名稱。 RecipeLoad()、 RecipeS

36、ave() 和RecipeDelete() 函數(shù)要求用戶提供 RecipeName。RecipeSelectRecipe() 函數(shù)將返回一個值給此參數(shù)。RecipeName 可以是字符串常量，也可以是 I/O 或內(nèi)存型 InTouch 標(biāo)記名。UnitName此參數(shù)是函數(shù)要使用的指定模板文件定單元的名稱。 RecipeLoad() 函數(shù)需要用戶提供 UnitName。RecipeSelectUnit() 函數(shù)將返回一個值給此參數(shù)。UnitName 可以是字符串常量，也可以是 I /O 或內(nèi)存型 InTouch 標(biāo)記名。Number如果函數(shù)的參數(shù)需填入字符，此字段可設(shè)置返回給參數(shù)的最大字符串長度

37、。在 InTouch 中，字符串（消息型）標(biāo)記名的最大長度可達(dá) 131 個字符。此參數(shù)一般設(shè)置為 131，除非您已減小 InTouch 標(biāo)記名的最大字符串長度。此參數(shù)可以是常量或 InTouch 模擬型標(biāo)記名。26第 3 章合并配方函數(shù)相同腳本中可使用多個配方函數(shù)。例如，要使用相同的按鈕選擇和加載配方，則可使用下列腳本：RecipeSelectRecipe(c:recipefile.csv, RecipeName, 131); RecipeLoad(c:recipefile.csv, Unit1, RecipeName);在 InTouch 應(yīng)用程序窗口中，單擊按鈕以顯示 “選擇配方”對話框。

38、選擇配方之后，其名稱將返回給標(biāo)記名 RecipeName，腳本繼續(xù)執(zhí)行，將所選 RecipeName 加載到指定的單元名 Unit1。如需有關(guān) InTouch QuickScript 的詳細(xì)信息，請參閱 InTouch 用戶指南第 6章 “在 InTouch 中創(chuàng)建 QuickScript”。嵌套配方多個 配方模板文件可相互鏈接 （使用 InTouch QuickScript），以創(chuàng)建復(fù)雜的應(yīng)用程序。創(chuàng)建一些 配方模板文件 ，由它們定義與消息型標(biāo)記名關(guān)聯(lián)的 “成分名”，該消息型標(biāo)記名 （在 “單元名”中）可加載另一“配方名”，如此便可實現(xiàn)多個配方模板文件的相互鏈接。這樣，您便能創(chuàng)建主配方模板文

39、件 ，去定義諸如機(jī)器設(shè)置參數(shù)之類的對象，供不同配方文件中的不同配方使用。將此類信息保存在一個中心文件中，可大大減少發(fā)生變化時維護(hù)和 （或）更新數(shù)據(jù)所需的時間。在下面的 RECFILEA.CSV 文件示例中，“項目名” Setup 定義為消息型，此項目的單元包含消息型標(biāo)記名 Setup。每個配方均包含第二個配方名（定義在不同的配方文件中），選擇配方時，該配方名會加載到標(biāo)記名Setup 中。為此，輸入下面的腳本：RecipeName=Recipe2;InTouch Recipe Manager 用戶指南27使用配方函數(shù)RecipeLoad(c:reciperecfilea.csv, Review,

40、 RecipeName);執(zhí)行該腳本時，標(biāo)記名 Setup 的值變?yōu)?Setup3A，并加載到 Review 單元。通過執(zhí)行下面的腳本，在下一次加載配方的過程中將機(jī)器設(shè)置參數(shù)加載到為 PLC1 單元定義的標(biāo)記名時，標(biāo)記名 Setup 的值會被用作 “配方名”。RecipeLoad(c:recipemachine.csv, PLC1, Setup);給配方應(yīng)用安全設(shè)置訪問配方可通過在配方模板文件中定義 “項目名”來控制，您可以在其中給配方設(shè)置加載、保存和刪除等操作所需的最低安全訪問級別。在下面的 MACHINE.CSV 文件示例中，“項目名” SecurityLevel 定義為消息型，此項目的

41、Review 單元包含消息型標(biāo)記名 SecurityLevel。配方加載到Review 單元時，每個配方將定義一個加載到 SecurityLevel 標(biāo)記的值。如果需要，每次安全訪問級別對所選配方無效時，可顯示一個包含 “訪問被拒絕”消息的窗口。要完成這項工作，可以首先將所選配方加載到只包含模擬型標(biāo)記名的單元，對所選配方的安全級別值進(jìn)行驗證。InTouch Recipe Manager 用戶指南28第 3 章例如：RecipeSelectRecipe(c:recipemachine.csv, Review, RecipeName);此時會出現(xiàn)選擇配方對話框。選擇 “配方名”之后，它將返回給標(biāo)記

42、名RecipeName，腳本繼續(xù)執(zhí)行。IF SecurityLevel = $AccessLevel THEN; RecipeLoad(c:recipemachine.csv, PLC1RecipeName);ELSE Show Access Denied; ENDIF;執(zhí)行此腳本時，如果訪問級別大于或等于 7000，則所選配方值將加載到PLC1 單元的標(biāo)記名。否則會顯示訪問被拒絕窗口，配方將不會加載到PLC1。InTouch Recipe Manager 用戶指南29配方函數(shù)疑難排解第4章配方函數(shù)疑難排解本章介紹如何使用配方函數(shù)返回的 “錯誤碼”來排解配方應(yīng)用程序中的疑難問題。本章包含一個錯

43、誤碼列表，并介紹如何使用RecipeGetMessage() 函數(shù)顯示錯誤碼消息編號。目錄?函數(shù)疑難排解顯示錯誤碼消息函數(shù)疑難排解要檢索 “配方函數(shù)”的錯誤碼，需將它換算為 InTouch 模擬型標(biāo)記名。示例：ErrorCode = RecipeLoad(FileName, UnitName, RecipeName);如果執(zhí)行成功，則 RecipeLoad() 函數(shù)會將標(biāo)記名 ErrorCode 的值設(shè)置為0。如果 RecipeLoad() 執(zhí)行不成功，它會將模擬型標(biāo)記名 ErrorCode 設(shè)置為表示特定錯誤狀況的編號。下面列出可能的 “錯誤碼”，以及相應(yīng)的錯誤消息及其描述：InTouch

44、Recipe Manager 用戶指南值錯誤消息描述0成功所調(diào)用的配方函數(shù)執(zhí)行成功。-1無這種配方模板指定的配方模板文件名不存在。-2View 沒有激活由于 WindowViewer 沒有運行，另一程序所調(diào)用的配方函數(shù)不能執(zhí)行。-3內(nèi)存不足沒有足夠內(nèi)存完成當(dāng)前任務(wù)。30第 4 章InTouch Recipe Manager 用戶指南值錯誤消息描述-4配方模板文件中的行太長配方模板文件中的某一行超出最大允許長度。-5配方文件內(nèi)的行被截斷配方模板文件中的某一行被截斷。-6不是有效的配方模板文件指定的文件名不是有效的 .CSV 配方模板文件。如需有關(guān) .CSV 文件的詳細(xì)信息，請參 閱 第 2 章

45、“ 使 用 Recipe Manager”。-7需要 “單元”或 “配方”配方模板文件缺少單元名或配方名。如需有關(guān)單元名或配方名的詳細(xì)信息，請參閱第 2 章 “使用 Recipe Manager”。-8在配方模板文件中未定義單元配方模板文件 “單元定義”模板中沒有定義任何單元。-9配方模板文件中未找到配方名配方模板文件中未定義指定的配方名。-10配方元定義模板文件中未定義指定的單元元名。-12需要 “模擬”、“離散”、“消息”配方模板文件中所輸入項目的類型 不正確。有效類型只限于 “模擬”、“離散”或 “消息”。-13標(biāo)記名的類型非 “模擬”、“離散”、“消息”型指定的標(biāo)記名就項目類型而言不正

46、確，例如，配方項目定義為 “模擬”，但在單元中卻為它定義了消息型標(biāo)記名。-14無效的離散值，需要0、 1在配方模板文件中為 “離散”量輸入的值不正確?！半x散”量的有效值僅限于 0 或 1。-15無法打開臨時文件無法打開臨時文件，可能是因為磁盤空間不足。-16保存配方模板文件時出現(xiàn)寫入錯誤保存配方模板文件時發(fā)生一個錯誤。31配方函數(shù)疑難排解顯示錯誤碼消息每個 “配方函數(shù)”均會返回一個編號，表示該函數(shù)的錯誤狀況。通過在InTouch Data Change 腳本中使用 RecipeGetMessage() 函數(shù)，可將相應(yīng)的錯誤碼寫入模擬型標(biāo)記名，并將關(guān)聯(lián)的錯誤碼消息寫入消息型標(biāo)記名。若要完成此項工

47、作，請使用下面的 Data Change 腳本：RecipeGetMessage(ErrorCode, ErrorMessage, 131);只要模擬型標(biāo)記名 ErrorCode 的值發(fā)生更改，此腳本便會自動執(zhí)行。此腳本執(zhí)行時， RecipeGetMessage() 函數(shù)將讀取標(biāo)記名 ErrorCode 的當(dāng)前值，并將與此數(shù)值關(guān)聯(lián)的消息返回給標(biāo)記名 ErrorMessage。InTouch Recipe Manager 用戶指南值錯誤消息描述-17用戶未作選擇用戶在選擇配方對話框中選擇了取消而不是配方名。-19其它應(yīng)用程序正在使用配方模板指定的配方模板文件已經(jīng)打開，因此 WindowViewe

48、r 無法訪問它。32第 4 章InTouch Recipe Manager 用戶指南在其它 Windows 應(yīng)用程序中創(chuàng)建配方33第5章在其它 Windows 應(yīng)用程序中創(chuàng)建配方配方模板文件以 .CSV （逗號分隔變量）的格式保存。因此，您可以在任何支持 .CSV 格式的 Windows 程序，如 Microsoft Excel 和Microsoft “記事本”中創(chuàng)建或編輯配方。目錄?使用 Excel 處理配方模板文件使用記事本處理配方模板文件使用 Excel 處理配方模板文件要在 Microsoft Excel 中打開現(xiàn)有的配方模板文件1.啟動 Excel。InTouch Recipe Ma

49、nager 用戶指南34第 5 章2.在文件菜單上，單擊打開。此時會出現(xiàn)打開對話框。3.找到并選擇 .csv 文件，然后單擊打開，或者雙擊文件名。此時該.csv 文件會打開。4.現(xiàn)在您可以編輯該 .csv 文件。備注 本用戶指南所用的 Excel 插圖是使用 7.0 版創(chuàng)建的。如果您使用的是其它版本，電子表格看上去可能會略有不同。InTouch Recipe Manager 用戶指南在其它 Windows 應(yīng)用程序中創(chuàng)建配方35要在 Excel 中創(chuàng)建新的配方模板文件1.2.3.啟動 Excel。在文件菜單上，單擊新建。此是會出現(xiàn)新建對話框。單擊工作簿圖標(biāo)打開一個空白電子表格。在電子表格中輸入數(shù)據(jù)。4.輸入時必須按上面的順序進(jìn)行。所有的 “單元名”在文件中必須先于 “配方名”定義。輸入所需的全部數(shù)據(jù)之后，必須用 .CSV 擴(kuò)展名保存電子表格，例如， reclist.csv。使用記事本處理配方模板文件要在 “Microsoft 記事本”中打開