安裝Workbench install-workbench
本檔案提供安裝和設定AEM Forms Workbench的說明。 安裝程式也會安裝Forms Designer。
誰應該閱讀此檔案? who-should-read-this-doc
本檔案適用於負責安裝、設定、管理或部署Workbench的管理員或開發人員。 此外也包含設定您的系統以支援升級AEM Forms程式的資訊。 所提供的資訊係基於以下假設:閱讀本檔案的任何人都熟悉Microsoft® Windows®作業系統。
其他資訊 additional-information
此表格中的資源可協助您進一步瞭解AEM Forms並開始使用。
安裝之前 before-you-install
Workbench安裝概述 workbench-installation-overview
Workbench是整合式開發環境(IDE),開發人員和表單作者可使用它來建立自動化的業務流程和表單。 它也用於管理流程和表單使用的資源和服務。
下圖說明Workbench安裝,包括:
- 使用Workbench的流程設計
- 使用設計工具的表單設計
系統必備條件 system-prerequisites
本節概述硬體與軟體需求以及支援的平台。
最低硬體與軟體需求 minimum-hardware-software-requirements
Workbench
建議最低需求如下:安裝所需的磁碟空間:
- 680 MB (僅適用於Workbench)。
- 2.15 GB的磁碟機,完整安裝Workbench、Designer和範例元件。
- 暫存安裝目錄為400 MB — 使用者\temp目錄為200 MB,Windows暫存目錄為200 MB。
- 硬體需求:Intel® Pentium® 4或AMD®同等處理器,1-GHz處理器。
- Java™ Runtime Environment (JRE) 7.0將51或更新版本更新至7.0。
- 最低1024 X 768畫素或更高的熒幕解析度,使用16位元或更高的色彩。
- 到AEM Forms伺服器的TCP/IPv4或TCP/IPv6網路連線。
- 安裝Visual C++可轉散發執行階段套件2012 32位元。
- 安裝Visual C++可轉散發執行階段套件2013 32位元。
支援平台 supported-platforms
若要檢視Workbench支援平台的完整清單,請前往 AEM Forms支援的平台.
設計工具安裝注意事項 designer-installation-considerations
依預設,Workbench安裝會包含對應的英文版Designer。 如果Workbench安裝應用程式在您的電腦上偵測到現有的Designer版本,安裝可能會終止,而且您必須先移除目前的Designer版本,才能繼續。
下表列出您在安裝Workbench時可能會遇到的可能Designer安裝案例,以及您必須執行的任何動作。
若要在Windows 10上解除安裝Designer (獨立) uninstall-designer-standalone-windows10
- 前往 「控制面板」 > 「程式」 > 「程式和功能」
- 在「目前安裝的程式」清單中,選取 Adobe設計工具.
- 按一下 解除安裝 然後按一下 是.
安裝Workbench installing-workbench
本章說明如何安裝Workbench。
安裝與執行Workbench installing-and-running-workbench
在安裝Workbench之前,您必須確定您的環境包含執行它所需的軟體和硬體(請參閱一節: 安裝之前)。
若要安裝及執行Workbench:
-
執行下列工作之一:
- 瀏覽至安裝媒體上的\workbench目錄,然後按兩下run_windows_installer.bat檔案。
- 將Workbench下載並解壓縮至您的檔案系統。 下載後,瀏覽至\workbench目錄,然後按兩下run_windows_installer.bat檔案。
note important IMPORTANT Workbench安裝程式只會從本機磁碟執行。 無法從遠端站台執行。 note note NOTE 如果您遇到「無法建立Java™虛擬機器器」錯誤,請建立名為_JAVA_OPTIONS的環境變數(值為 — Xmx512M)並執行安裝程式。 -
在「簡介」畫面上,按一下「下一步」。
-
閱讀「產品授權合約」,選取「我接受授權合約的條款」,然後按一下「下一步」。
-
(選擇性)如果您需要此工具來建立和修改表單,請選取「安裝Adobe設計工具」。
note note NOTE 您可以保持取消選取此選項,繼續使用隨Acrobat 10安裝的Designer。 -
接受列出的預設目錄,或按一下「選擇」並導覽至您要安裝Workbench的目錄,然後按一下「下一步」。
note note NOTE 安裝目錄路徑不應包含# (井號)和$ (美元)字元。 -
檢閱安裝前摘要,然後按一下安裝。 安裝程式會顯示安裝進度。
-
檢閱安裝摘要。 選取「啟動AEM Forms Workbench」 ,以啟動Workbench,然後按一下「下一步」 。
-
檢閱發行說明,然後按一下「完成」。
-
下列專案現在已安裝在您的電腦上:
- Workbench:若要從「開始」功能表執行Workbench,請選取「所有程式> AEM Forms > Workbench」 (如果您選擇儲存捷徑檔案夾)。 如需詳細資訊,請參閱 使用Workbench 檔案。
- 設計工具:您可以從Workbench內部存取Designer。 如需相關資訊,請參閱中的快速入門主題。 Designer說明.
- AEM FORMS SDK:如需使用SDK的詳細資訊,請參閱 使用AEM Forms程式設計.
升級流程 upgrading-processes
JEE程式上的AEM Forms可使用升級精靈升級到AEM Forms應用程式。 如需詳細資訊,請參閱Workbench說明中的升級舊版成品檔案。
設定並登入伺服器 configuring-and-logging-server
若要使用Workbench,您必須執行AEM Forms的執行個體(通常在個別的電腦上)。 您必須有使用者名稱和密碼才能登入AEM Forms,以及關於伺服器位置的詳細資訊。
設定逾時設定 configuring-timeout-settings
根據預設,Workbench會在兩小時後逾時,無論活動或非活動狀態為何。 若要編輯逾時設定,請參閱以下連結中的「設定使用者管理>設定進階系統屬性」: 管理主控台說明.
設定Workbench透過HTTPS連線 configuring-workbench-to-connect-over-HTTPS
若要透過HTTPS將Workbench連線至AEM Forms伺服器,您必須確保系統會將核發公開金鑰的憑證授權單位(CA)辨識為Workbench所信任。 如果無法辨識憑證來自信任的來源,您必須更新 [Workbench_HOME]/workbench/jre/lib/security目錄。
請確定您使用憑證中指定的名稱來連線至HTTPS。 此名稱通常是完整的主機名稱。
更新cacert檔案的方式:
-
確保您有安全通訊端層(SSL)憑證的副本。 請連絡設定SSL伺服器的管理員,或使用網頁瀏覽器匯出憑證。
note note NOTE 若要匯出憑證,請開啟網頁瀏覽器並登入管理主控台。 在瀏覽器中安裝憑證,然後從瀏覽器將憑證匯出至暫存位置(或直接匯出至 [Workbench_HOME]/workbench/jre/lib/security directory)。 -
將憑證複製到 [Workbench_HOME]/workbench/jre/lib/security目錄。
-
開啟命令提示視窗,瀏覽至 [Workbench_HOME]/workbench/jre/bin,然後輸入下列命令:
keytool -import -storepass changeit -file [Workbench_HOME]\workbench\jre\lib\security\ssl_cert_for_certname.cer -keystore [Workbench_HOME]\workbench\jre\lib\security\cacerts -alias example
其中:changeit
是cacerts金鑰存放區的預設密碼。- certname是您在步驟1中選取的憑證。
- 範例是您為憑證選擇的別名。 此值可以變更。
-
提示信任憑證時,輸入Yes並點選Enter金鑰。 keytool會繼續將cacerts檔案匯入 [Workbench_HOME]/workbench/jre/lib/security目錄。
-
關閉並重新啟動Workbench以套用變更。
設定動態產生之範本的快取設定 configuring-cache-settings-for-dynamically-generated-templates
如果您的應用程式透過自動更新XFA內容來即時產生唯一的範本,則應考慮快取作業的下列方面。 實際上,每個交易都使用新的唯一範本。
當表單產生器或輸出搜尋或更新特定表單範本之快取中的專案時,它會使用數個索引鍵值來找出存取的特定快取專案。
-
範本檔案名稱:用作快取表單主要唯一識別碼的範本的位置和檔案名稱。
-
時間戳記:範本檔案包含用於判斷表單上次更新時間的時間戳記。
-
範本UUID:設計工具會在每個範本中插入表單及其版本的唯一識別碼(UUID)。 每次更新表單時,都會更新內嵌的UUID。 例如,XDP範本可能顯示下列內容:
<?xml version="1.0" encoding="UTF-8"?>
<?xfa generator="AdobeAEM formsDesignerES_V8.2" APIVersion="2.6.7185.0"?><xdp:xdp xmlns:xdp=https://ns.adobe.com/xdp/ timeStamp="2008-07-29T21:22:12Z" uuid="823e538f-ff6c-4961-b759-f7626978a223"><template xmlns="https://www.xfa.org/schema/xfa-template/2.6/">
-
演算選項:在轉譯的表單快取中,快取內容會針對每組唯一轉譯選項個別儲存。
Forms服務會參考檔案名稱或存放庫位置來接收範本,或是以記憶體中的XML物件形式來接收範本。
- 參考傳遞的範本:使用內容根和表單名稱。 如果使用此方法在所有要求中傳遞不同檔案名稱的不重複範本,磁碟快取會無限成長,且永遠不會重複使用。 為了避免此問題,必須使用相同的檔案名稱傳遞唯一範本,以確保為所有請求更新相同的快取。
- 依據值傳遞的範本:使用範本位元組,以及使用inDataDoc引數的資料。 如果使用此方法傳遞具有不同UUID的不重複範本,磁碟快取會無限成長,而且永遠不會重複使用。 為避免發生此問題,應從所有範本中移除UUID屬性,以確保未建立範本的快取。 或者,傳遞相同的非Null UUID可讓您建立快取物件,但會確保隨著每個請求更新相同的快取。
為避免快取無限成長,請考慮以下因素,以使用新的AEM Forms API (即renderHTMLForm2和renderPDFForm2)呈現動態產生的範本。
使用新API時,範本會作為檔案物件傳遞,並根據是否被鈍化,在Forms服務中處理。
對於以UUID和內容根目錄作為快取索引鍵的鈍化檔案,請考慮以下方面:
- 系統不會為沒有UUID的被動式輸入範本建立快取。
- 如果傳遞了超過一個具有相同UUID和內容根目錄的被動式輸入範本,則會覆寫相同的快取。
對於檔案名稱和內容根目錄作為快取鍵的非鈍化檔案,請考慮以下方面:
-
對於非被動式輸入範本,快取取決於產生檔案的內容根目錄和檔案名稱。
相同的快取只會用於內容根目錄和範本檔案名稱相同的請求。
下列最佳實務可確保將動態產生的範本傳遞至Forms服務時,快取不會無休止地增加:- 請拆除UUID,或在所有動態產生的範本中傳遞相同的UUID。
- 從範本位元組或磁碟上的相同檔名產生檔案。
解除安裝Workbench uninstalling-workbench
使用[控制檯]中的[新增或移除程式]功能,您可以啟動[解除安裝程式]。 Workbench和Designer應用程式有不同的解除安裝程式。
設定AEM Forms XDC編輯器 configuring-aem-forms-xdc-editor
使用XDC編輯器,網路印表機管理員可以建立和修改XML Forms架構裝置組態(XDC)檔案。 XDC檔案說明印表機的功能,例如印表機語言或紙張大小與紙匣位置之間的關聯性。
在網路印表機管理員使用XDC編輯器之前,重新定位範例XDC檔案,並參閱使用XDC編輯器建立裝置設定檔。
取得範例XDC檔案:
- 在AEM Forms伺服器上,找到XDC資料夾,位於 [AEM Forms根目錄]\sdk\samples\Output\IVS.
- 將此資料夾的內容複製到可從Workbench或Eclipse系統存取的目錄中。
取得XDC編輯器說明:
- 前往AEM Forms檔案網站。
- 按一下 開發 標籤並導覽至使用XDC編輯器建立裝置設定檔。 下載xdc_editor_help_web.zip檔案,並按照Readme檔案提供的指示來安裝說明檔案。