安裝Workbench

本檔案提供安裝和設定AEM Forms Workbench的指示。 安裝程式也會安裝Forms Designer。

誰應閱讀本檔案?

本檔案適用於負責安裝、設定、管理或部署Workbench的管理員或開發人員。 此外也包含設定系統以支援升級版AEM Forms程式所需的資訊。 提供的資訊基於以下假設:閱讀本文檔的任何人都熟悉Microsoft® Windows®作業系統。

其他資訊

此表格中的資源可協助您進一步了解及開始使用AEM Forms。

關於後述資訊:

請參閱

Workbench的程式資訊

Workbench說明

關於AEM Forms及其如何與其他Adobe產品整合的一般資訊

AEM Forms概述

AEM Forms提供的所有檔案

AEM Forms檔案

有關此產品版本的補丁程式更新、技術說明和其他資訊

聯絡Adobe企業支援

注意

AEM Forms不再使用Flex Workspace。 此功能適用於AEM Forms版本。

安裝之前

Workbench安裝概觀

Workbench是整合式開發環境(IDE),開發人員和表單作者可使用此環境建立自動化的業務流程和表單。 它還用於管理流程和表單使用的資源和服務。

下圖說明Workbench安裝,包括:

  • 使用Workbench進行流程設計
  • 使用設計工具進行表單設計
注意

AEM Forms伺服器需要個別的安裝程式。 如需詳細資訊,請參閱JEE上的AEM Forms安裝檔案。

default-render-form

系統先決條件

本節概述硬體和軟體需求以及支援的平台。

最低硬體和軟體需求

Workbench
建議最低要求如下:要安裝的磁碟空間:

  • 僅適用於Workbench的680 MB。
  • 在單個驅動器上安裝2.15 GB,以完整安裝Workbench、Designer和示例元件。
  • 400 MB用於臨時安裝目錄 — 用戶\temp目錄為200 MB,Windows臨時目錄為200 MB。
注意

如果所有這些位置都駐留在單個驅動器上,則安裝期間必須有1.5 GB的可用空間。 安裝完成後,將刪除複製到臨時目錄的檔案。

  • 硬體需求:英特爾®奔騰® 4或AMD等效處理器,1 GHz。
  • Java™ Runtime Environment(JRE)7.0將51或更新版本更新到7.0。
  • 16位顏色或更高,最低1024 X 768像素或更高的監視器解析度。
  • TCP/IPv4或TCP/IPv6與AEM Forms伺服器的網路連接。
  • 安裝Visual C++ Redistributable運行時包2012 32位。
  • 安裝Visual C++ Redistributable運行時包2013 32位。
注意

您必須擁有管理權限才能安裝Workbench。 如果您使用非管理員帳戶進行安裝,安裝程式會提示您輸入適當帳戶的憑證。

支援平台

請參閱Workbench支援平台的完整清單,網址為 AEM Forms支援平台.

設計工具安裝考量事項

依預設,Workbench安裝包含對應的僅限英文版Designer。 如果Workbench安裝應用程式在您的電腦上檢測到現有版本的Designer,則安裝可能會終止,並且您必須先刪除當前版本的Designer,然後才能繼續。
下表列出了安裝Workbench時您可能遇到的可能Designer安裝方案以及您必須執行的任何操作的完整清單。

當前安裝的Designer版本

必要動作

Acrobat Pro或Acrobat Pro Extended(包括Designer)

無.
Workbench安裝會在您電腦上偵測隨Acrobat Pro或Acrobat Pro Extended安裝的Designer例項。
不同版本的Designer可以共存於同一系統,例如Workbench 6.4的Designer 6.4.x和Workbench 6.5的Designer 6.5.0.x。不需要卸載隨Acrobat 10 Pro或Acrobat 10 Pro Extended或更高版本安裝的Designer版本。

設計人員(獨立)

無.
Workbench隨附的Designer版本僅提供英文版。
Workbench安裝程式不會重新安裝新版本的Designer。 將會修補隨Workbench安裝程式提供的更新版本。 這也可讓您在Workbench中使用本地化版本的Designer。

在Windows 10上卸載Designer(獨立)

  1. 前往 「控制面板」 > 「程式」 > 「程式和功能」
  2. 在當前安裝的程式清單中,選擇 Adobe設計工具.
  3. 按一下 解除安裝 然後按一下 .

安裝Workbench

本章說明如何安裝Workbench。

安裝和執行Workbench

安裝Workbench之前,您必須確定您的環境包含執行Workbench所需的軟體和硬體(請參閱區段: 安裝之前)。

要安裝並運行Workbench,請執行以下操作:

  1. 執行下列任務之一:

    • 導覽至安裝媒體上的\workbench目錄,然後按兩下run_windows_installer.bat檔案。
    • 將Workbench下載並解壓縮至您的檔案系統。 下載後,導航到\workbench目錄,然後按兩下run_windows_installer.bat檔案。
    重要

    Workbench安裝程式只會從本機磁碟執行。 無法從遠程站點運行。

    注意

    如果遇到「無法建立Java虛擬機」錯誤,請建立名為_JAVA_OPTIONS的環境變數(值為 — Xmx512M),然後運行安裝程式。

  2. 在「簡介」畫面上,按一下「下一步」 。

  3. 閱讀產品許可協定,選擇「我接受許可協定的條款」,然後按一下「下一步」。

  4. (可選)如果需要此工具來建立和修改表單,請選擇「安裝Adobe設計器」。

    注意

    若要繼續使用與Acrobat 10一起安裝的Designer,請將此選項保留為取消選取。

  5. 接受列出的預設目錄,或按一下「選擇」,導覽至您要安裝Workbench的目錄,然後按一下「下一步」。

    注意

    安裝目錄路徑不應包含#(井號)和$(井號)字元。

  6. 查看預安裝摘要,然後按一下「安裝」。 安裝程式顯示安裝進度。

  7. 查看安裝摘要。 選取「啟動AEM Forms Workbench」以啟動Workbench,然後按一下「下一步」。

  8. 檢閱發行說明,然後按一下完成。

  9. 您的電腦現在安裝了下列項目:

    • Workbench:若要從「開始」功能表執行Workbench,請選取「所有程式> AEM Forms > Workbench」(如果您選擇將快捷方式資料夾儲存在此處)。 如需詳細資訊,請參閱 使用Workbench 檔案。
    • 設計工具:您可以從Workbench記憶體取「設計工具」。 如需詳細資訊,請參閱 設計工具說明.
    • AEM Forms SDK:如需使用SDK的詳細資訊,請參閱 使用AEM Forms進行程式設計.

升級程式

JEE上的AEM Forms程式可使用升級精靈升級至AEM Forms應用程式。 如需詳細資訊,請參閱Workbench說明中的升級舊成品檔案。

配置和登錄伺服器

若要使用Workbench,您必須有執行中的AEM Forms例項,通常是在個別電腦上。 您必須有使用者名稱和密碼才能登入AEM Forms,以及伺服器位置的詳細資訊。

注意

如果您將AEM Forms配置為使用EMC Documentum或IBM FileNet儲存庫提供程式,並且要登錄到儲存庫,而不是在AEM Forms管理控制台中配置為預設的儲存庫,請提供用戶名為username@Repository。

配置超時設定

依預設,無論活動或閒置,Workbench都會在兩小時後逾時。 要編輯超時設定,請參閱 管理控制台說明.

設定Workbench以透過HTTPS連線

若要透過HTTPS將Workbench連線至AEM Forms伺服器,您必須確定核發公開金鑰的憑證授權單位(CA)會被Workbench認可。 如果未將憑證辨識為來自信任的來源,您必須更新位於 [Workbench_HOME]/workbench/jre/lib/security目錄。

注意

[Workbench_HOME] 代表您安裝Workbench的目錄。 預設位置為C:\Program Files (x86)\Adobe Experience Manager forms Workbench。

請使用憑證中指定的名稱來連線至HTTPS。 此名稱通常是完全限定的主機名稱。

更新快取檔案:

  1. 確保您有安全套接字層(SSL)證書的副本。 請聯絡設定SSL伺服器的管理員,或使用網頁瀏覽器匯出憑證。

    注意

    若要匯出憑證,請開啟Web瀏覽器並登入管理主控台,在瀏覽器中安裝憑證,然後將憑證從瀏覽器匯出至暫時儲存位置(或直接匯出至 [Workbench_HOME]/workbench/jre/lib/security directory)。

  2. 將憑證複製到 [Workbench_HOME]/workbench/jre/lib/security目錄。

  3. 開啟命令提示窗口,導航到 [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中選取的憑證。
    • 您為憑證選擇的別名就是範例。 此值可以變更
  4. 提示您信任證書時,鍵入Yes並按一下Enter鍵。 鍵工具會繼續將快取檔案匯入至 [Workbench_HOME]/workbench/jre/lib/security目錄。

  5. 關閉並重新啟動Workbench以套用變更。

配置動態生成模板的快取設定

如果您的應用程式透過自動更新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物件的值,接收範本。

  • 參考傳遞的範本:使用內容根和表單名稱。 如果使用此方法在每個請求中傳遞了檔案名不同的唯一模板,則磁碟快取將不斷增長,並且永遠不會重複使用。 為避免發生此情況,應以相同檔案名稱傳遞唯一範本,以確保所有要求都更新相同的快取。
  • 按值傳遞的模板:使用使用theinDataDoc參數傳遞的模板位元組以及資料。 如果使用此方法傳遞了具有不同UUID的唯一模板,則磁碟快取將不斷增長,並且永遠不會重複使用。 為避免此情況,應從所有範本中移除UUID屬性,以確保不會為範本建立快取。 或者,傳遞相同的非空UUID可以建立快取物件,但可確保每個請求都更新相同的快取。

為避免快取無休止地成長,請使用新AEM Forms API來轉譯動態產生的範本(即renderHTMLForm2和renderPDFForm2),請考量下列因素。

使用新API時,範本會以檔案物件的形式傳遞,這會根據是否鈍化在Forms服務中處理。

對於以UUID和內容根作為快取鍵的鈍化文檔,請考慮以下方面:

  • 沒有UUID的鈍化輸入範本不會建立快取。
  • 如果傳遞了多個具有相同UUID和內容根的鈍化輸入模板,則覆蓋相同的快取。

對於檔案名和內容根作為快取鍵的未鈍化文檔,請考慮以下方面:

  • 對於未鈍化的輸入模板,快取取決於生成文檔的內容根和檔案名。
    只有具有相同內容根和範本檔案名稱的請求,才會使用相同的快取。
    下列最佳實務可確保在動態產生的範本傳遞至Forms服務時,快取不會無休止地成長:
    • 移除UUID,或在所有動態產生的範本中傳遞相同的UUID。
    • 從模板位元組或從磁碟上的相同檔案名生成文檔。

解除安裝Workbench

使用「控制面板」中的「添加或刪除程式」功能啟動「卸載程式」。 Workbench和Designer應用程式有個別的解除安裝程式。

設定AEM Forms XDC編輯器

使用XDC編輯器,網路打印機管理員可以建立和修改XML Forms體系結構設備配置(XDC)檔案。 XDC檔案描述了打印機的功能,如打印機語言或紙張大小與紙盒位置之間的關聯。

在網路打印機管理員使用XDC編輯器之前,請重新定位示例XDC檔案,並參閱使用XDC編輯器建立設備配置檔案。

若要取得範例XDC檔案:

  1. 在AEM Forms伺服器上,在 [AEM Forms根]\sdk\samples\Output\IVS。
  2. 將此資料夾的內容複製至可從Workbench或Eclipse系統存取的目錄。

取得XDC編輯器說明:

  1. 前往AEM Forms檔案網站。
  2. 按一下 開發 標籤,並導覽至使用XDC編輯器建立裝置設定檔。 下載xdc_editor_help_web.zip檔案,並按照自述檔案中提供的說明安裝幫助檔案。

本頁內容