安裝Workbench install-workbench

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

誰應該閱讀此檔案? who-should-read-this-doc

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

其他資訊 additional-information

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

關於後述資訊:
請參閱
Workbench的程式資訊
Workbench說明
有關AEM Forms以及它如何與其他Adobe產品整合的一般資訊
AEM Forms概觀
AEM Forms的所有可用檔案
AEM Forms檔案
此產品版本的修補程式更新、技術說明和其他資訊
聯絡Adobe企業支援
NOTE
AEM Forms已棄用Flex工作區。 它適用於AEM Forms版本。

安裝之前 before-you-install

Workbench安裝概述 workbench-installation-overview

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

下圖說明Workbench安裝,包括:

  • 使用Workbench的流程設計
  • 使用設計工具的表單設計
NOTE
AEM Forms伺服器需要單獨的安裝程式。 如需詳細資訊,請參閱JEE上的AEM Forms安裝檔案。

default-render-form

系統必備條件 system-prerequisites

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

最低硬體與軟體需求 minimum-hardware-software-requirements

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

  • 680 MB (僅適用於Workbench)。
  • 2.15 GB的磁碟機,完整安裝Workbench、Designer和範例元件。
  • 暫存安裝目錄為400 MB — 使用者\temp目錄為200 MB,Windows暫存目錄為200 MB。
NOTE
如果所有這些位置都位於單一磁碟機上,則安裝期間必須有1.5 GB的可用空間。 安裝完成時,會刪除複製到暫存目錄的檔案。
  • 硬體需求: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位元。
NOTE
您必須具有管理許可權才能安裝Workbench。 如果您使用非系統管理員帳戶進行安裝,安裝程式會提示您輸入適當帳戶的認證。

支援平台 supported-platforms

若要檢視Workbench支援平台的完整清單,請前往 AEM Forms支援的平台.

設計工具安裝注意事項 designer-installation-considerations

依預設,Workbench安裝會包含對應的英文版Designer。 如果Workbench安裝應用程式在您的電腦上偵測到現有的Designer版本,安裝可能會終止,而且您必須先移除目前的Designer版本,才能繼續。
下表列出您在安裝Workbench時可能會遇到的可能Designer安裝案例,以及您必須執行的任何動作。

目前安裝的設計工具版本
必要動作
Acrobat Pro或Acrobat Pro Extended (包含設計工具)
無。
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版本。
Designer (獨立)
無。
Workbench隨附的Designer版本僅限英文。
Workbench安裝程式不會重新安裝新版的Designer。 而是會修補與Workbench安裝程式隨附的更新版本。 這也可讓您在Workbench中使用本地化版本的Designer。

若要在Windows 10上解除安裝Designer (獨立) uninstall-designer-standalone-windows10

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

安裝Workbench installing-workbench

本章說明如何安裝Workbench。

安裝與執行Workbench installing-and-running-workbench

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

若要安裝及執行Workbench:

  1. 執行下列工作之一:

    • 瀏覽至安裝媒體上的\workbench目錄,然後按兩下run_windows_installer.bat檔案。
    • 將Workbench下載並解壓縮至您的檔案系統。 下載後,瀏覽至\workbench目錄,然後按兩下run_windows_installer.bat檔案。
    note important
    IMPORTANT
    Workbench安裝程式只會從本機磁碟執行。 無法從遠端站台執行。
    note note
    NOTE
    如果您遇到「無法建立Java™虛擬機器器」錯誤,請建立名為_JAVA_OPTIONS的環境變數(值為 — Xmx512M)並執行安裝程式。
  2. 在「簡介」畫面上,按一下「下一步」。

  3. 閱讀「產品授權合約」,選取「我接受授權合約的條款」,然後按一下「下一步」。

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

    note note
    NOTE
    您可以保持取消選取此選項,繼續使用隨Acrobat 10安裝的Designer。
  5. 接受列出的預設目錄,或按一下「選擇」並導覽至您要安裝Workbench的目錄,然後按一下「下一步」。

    note note
    NOTE
    安裝目錄路徑不應包含# (井號)和$ (美元)字元。
  6. 檢閱安裝前摘要,然後按一下安裝。 安裝程式會顯示安裝進度。

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

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

  9. 下列專案現在已安裝在您的電腦上:

    • 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,以及關於伺服器位置的詳細資訊。

NOTE
如果您已將AEM Forms設定為使用EMC Documentum®或IBM® FileNet Repository Provider ,而且您想登入儲存區域(AEM Forms管理主控台中設定為預設儲存區域以外的儲存區域),請以username@Repository格式提供使用者名稱。

設定逾時設定 configuring-timeout-settings

根據預設,Workbench會在兩小時後逾時,無論活動或非活動狀態為何。 若要編輯逾時設定,請參閱以下連結中的「設定使用者管理>設定進階系統屬性」: 管理主控台說明.

設定Workbench透過HTTPS連線 configuring-workbench-to-connect-over-HTTPS

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

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

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

更新cacert檔案的方式

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

    note note
    NOTE
    若要匯出憑證,請開啟網頁瀏覽器並登入管理主控台。 在瀏覽器中安裝憑證,然後從瀏覽器將憑證匯出至暫存位置(或直接匯出至 [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金鑰。 keytool會繼續將cacerts檔案匯入 [Workbench_HOME]/workbench/jre/lib/security目錄。

  5. 關閉並重新啟動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檔案

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

取得XDC編輯器說明

  1. 前往AEM Forms檔案網站。
  2. 按一下 開發 標籤並導覽至使用XDC編輯器建立裝置設定檔。 下載xdc_editor_help_web.zip檔案,並按照Readme檔案提供的指示來安裝說明檔案。
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2