OSGi上的Forms中心工作流程 — 步驟參考 forms-centric-workflow-on-osgi-step-reference
您可以使用工作流程模型,將商業邏輯轉換為自動化重複式處理。 模型可協助您定義並執行一系列步驟。 您也可以定義模型屬性,例如工作流程是暫時的或使用多個資源。 您可以在模型中包含各種AEM Workflow步驟來達成商業邏輯。
Forms Workflow步驟 forms-workflow-steps
Forms Workflow步驟會在AEM工作流程中執行AEM Forms專屬的操作。 這些步驟可讓您在OSGi上快速建立以最適化表單為基礎的Forms工作流程。 這些工作流程可用於開發基本的稽核和核准工作流程、內部和跨防火牆的業務流程。 您也可以使用Forms Workflow步驟來啟動檔案服務、與Adobe Sign簽名工作流程整合,以及執行其他AEM Forms作業。 您需要AEM Forms附加元件才能在工作流程中使用這些步驟。
以Forms為中心的工作流程步驟會在AEM工作流程中執行AEM Forms特定的操作。 這些步驟可讓您在OSGi上快速建立以Adaptive Forms為基礎的Forms工作流程。 這些工作流程可用於開發基本的稽核和核准工作流程、內部和跨防火牆業務流程。
指派任務步驟 assign-task-step
指派任務步驟會建立任務並將其指派給使用者或群組。 在指派工作的同時,元件也會指定工作的調適型表單或非互動式PDF。 自適應表單需要接受使用者的輸入且非互動式PDF,或唯讀自適應表單用於僅稽核工作流程。
您也可以使用元件來控制工作的行為。 例如,建立自動記錄檔案、將任務指派給特定使用者或群組、指定提交資料的路徑、指定要預先填入的資料路徑,以及指定預設動作。 「指派工作」步驟具有以下屬性:
-
標題: 工作標題。 標題會顯示在AEM收件匣中。
-
描述: 說明正在工作執行的作業。 當您在共用開發環境中工作時,此資訊對於其他流程開發人員很有用。
-
縮圖路徑: 工作縮圖的路徑。 若未指定路徑,則會針對最適化表單顯示預設縮圖,而針對記錄檔案,則會顯示預設圖示。
-
工作流程階段: 一個工作流程可以有多個階段。 這些階段會顯示在「AEM收件匣」中。 您可以在模型的屬性(「Sidekick>頁面>頁面屬性>階段」)中定義這些階段。
-
優先順序: 選取的優先順序會顯示在AEM收件匣中。 可用的選項為「高」、「Medium」和「低」。 預設值為Medium。
-
到期日: 指定工作被標示為逾期的天數或小時數。 如果您選取 關閉,則不會將工作標示為逾期。 您也可以指定逾時處理常式,以便在工作逾期後執行特定工作。
-
天: 工作要完成之前的天數。 將任務指派給使用者後會計入的天數。 如果任務未完成並超過「天數」欄位中指定的天數,則如果選取,逾時處理常式會在到期日之後觸發。
-
小時: 完成工作之前的小時數。 將任務指派給使用者後會計入小時數。 如果任務未完成並超過時數欄位中指定的時數,則如果選取,逾時處理常式會在到期時數之後觸發。
-
到期日之後逾時: 選取此選項以啟用[逾時處理常式]選取欄位。
-
逾時處理常式: 選取指派工作步驟超過到期日時要執行的指令碼。 放置在CRX儲存庫中[apps]/fd/dashboard/scripts/timeoutHandler的指令碼可供選取。 crx-repository中不存在指定的路徑。 管理員會在使用之前建立路徑。
-
在任務詳細資訊中反白上一個任務的動作和註解: 選取此選項可顯示上一個在任務詳細資訊區段上採取的動作和收到的註解。
-
型別: 選擇工作流程啟動時要填寫的檔案型別。 您可以選擇最適化表單、唯讀最適化表單、非互動式PDF檔案、互動式通訊代理程式UI或互動式通訊Web Channel檔案。
-
使用最適化表單: 指定尋找輸入最適化表單的方法。 如果您從「型別」下拉式清單中選取「最適化表單」或「唯讀最適化表單」,即可使用此選項。 您可以使用提交至工作流程的最適化表單、在絕對路徑提供的表單,或在變數中的路徑提供的表單。 您可以使用字串型別的變數來指定路徑。
您可以將多個最適化表單與一個工作流程建立關聯。 因此,您可以使用可用的輸入法,在執行階段指定調適型表單。 -
使用互動式通訊: 指定尋找輸入互動式通訊的方法。 您可以使用提交至工作流程的互動式通訊、位於絕對路徑或位於變數路徑中的通訊。 您可以使用字串型別的變數來指定路徑。 如果您從「型別」下拉式清單中選取「互動式通訊代理程式UI」或「互動式通訊Web Channel檔案」,即可使用此選項。
-
自適應表單或互動式通訊路徑:指定自適應表單或互動式通訊的路徑。 您可以使用提交至工作流程的最適化表單或互動式通訊(可在絕對路徑中使用),或從儲存在字串資料型別變數中的路徑擷取最適化表單。
-
選擇輸入PDF,使用: 指定非互動式PDF檔案的路徑。 當您在「型別」欄位中選擇非互動式PDF檔案時,該欄位可供使用。 您可以使用相對於承載的路徑、以絕對路徑儲存的路徑,或使用Document資料型別的變數來選取輸入PDF。 例如,[Payload_Directory]/Workflow/PDF/credit-card.pdf。 crx-repository中不存在該路徑。 管理員會在使用之前建立路徑。 您需要啟用記錄檔案選項或表單範本式最適化表單,才能使用「PDF路徑」選項。
-
針對已完成的工作,將調適型表單轉譯為:當工作標示為完成時,您可以將調適型表單轉譯為唯讀的調適型表單或PDF檔案。 您需要啟用記錄檔案選項或表單範本式最適化表單,才能將最適化表單呈現為記錄檔案。
-
已預先填入: 下列欄位可作為工作的輸入專案:
-
使用 選取輸入資料檔:輸入資料檔的路徑(.json、.xml、.doc或表單資料模型)。 您可以使用相對於承載的路徑來擷取輸入資料檔案,或擷取儲存在Document、XML或JSON資料型別變數中的檔案。 例如,檔案包含透過AEM收件匣應用程式為表單提交的資料。 範例路徑為[Payload_Directory]/workflow/data。
-
選擇輸入附件,使用: 此位置可用的附件已附加至與工作關聯的表單。 路徑可以是相對於承載或擷取儲存在ArrayList of Document型別變數中的附件。 範例路徑為[Payload_Directory]/attachments/。 您可以指定相對於承載放置的附件,或使用檔案型別(「陣列清單」>「檔案」)變數來指定最適化表單的輸入附件。
- 選擇輸入JSON: 使用相對於承載或儲存在Document、JSON或表單資料模型資料型別變數中的路徑來選取輸入JSON檔案。 如果您從「型別」下拉式清單中選取「互動式通訊代理程式UI」或「互動式通訊Web Channel檔案」,即可使用此選項。
- 選擇自訂預填服務: 選取預填服務以擷取資料,並預填互動式通訊Web Channel檔案或代理程式UI。
- 使用以上選取之互動式通訊的預填服務: 使用此選項以使用互動式通訊下拉式清單中定義的互動式通訊的預填服務。
- 要求屬性對應: 使用[要求屬性對應]區段來定義要求屬性🔗的名稱和值。 根據請求中指定的屬性名稱和值從資料來源擷取詳細資料。 您可以使用常值或String資料型別的變數來定義請求屬性值。
您必須從「型別」下拉式清單中選取「互動式通訊代理程式UI」或「互動式通訊Web Channel檔案」,才能使用預填服務和要求屬性對應選項。
-
-
提交的資訊: 下列欄位可作為工作的輸出位置:
-
儲存輸出資料檔案,使用: 儲存資料檔案(.json,。 xml、.doc或表單資料模型)。 資料檔案包含透過相關表單提交的資訊。 您可以使用相對於承載的路徑來儲存輸出資料檔案,或將其儲存在Document、XML或JSON資料型別的變數中。 例如,[Payload_Directory]/Workflow/data,其中資料是檔案。
-
儲存附件使用: 儲存工作所提供的表單附件。 您可以使用相對於承載的路徑來儲存附件,或將其儲存在Document資料型別陣列的變數中。
-
儲存記錄檔案使用: 儲存記錄檔案檔案的路徑。 例如,[Payload_Directory]/DocumentofRecord/credit-card.pdf。 您可以使用相對於承載的路徑來儲存記錄檔案,或將其儲存在Document資料型別的變數中。 如果您選取 相對於承載 選項,如果路徑欄位留空,則不會產生記錄檔案。 只有在從「型別」下拉式清單中選取「最適化表單」時,才能使用此選項。
-
使用以下專案儲存Web Channel資料: 使用相對於承載的路徑儲存Web Channel資料檔案,或將其儲存在Document、JSON或Form Data Model資料型別的變數中。 只有從「型別」下拉式清單中選取「互動式通訊代理程式UI」,才能使用此選項。
-
使用以下專案儲存PDF檔案: 使用相對於承載的路徑儲存PDF檔案,或將其儲存在Document資料型別的變數中。 只有從「型別」下拉式清單中選取「互動式通訊代理程式UI」,才能使用此選項。
-
儲存配置範本,使用: 使用相對於承載的路徑儲存配置範本,或將其儲存在Document資料型別的變數中。 配置範本參考您使用Forms Designer建立的XDP檔案。 只有從「型別」下拉式清單中選取「互動式通訊代理程式UI」,才能使用此選項。
-
-
受指派人>指派選項: 指定將工作指派給使用者的方法。 您可以使用「參與者選擇器」指令碼,以動態方式將工作指派給使用者或群組,或將工作指派給特定的AEM使用者或群組。
-
參與者選擇器: 在[指派選項]欄位中選取 動態至使用者或群組 選項時,即可使用此選項。 您可以使用ECMAScript或服務來動態選取使用者或群組。 如需詳細資訊,請參閱動態指派工作流程給使用者和建立自訂Adobe Experience Manager動態參與者步驟。
-
參與者: 在 參與者選擇器 欄位中選取 com.adobe.granite.workflow.core.process.RandomParticipantChooser 選項時,即可使用此欄位。 欄位可讓您為RandomParticipantChooser選項選取使用者或群組。
-
受指派人: 在 參與者選擇器 欄位中選取 com.adobe.fd.workspace.step.service.VariableParticipantChooser 時,該欄位可供使用。 欄位可讓您選取字串資料型別的變數以定義受託人。
-
引數: 在「參與者選擇器」欄位中選取RandomParticipantChoose指令碼以外的指令碼時,該欄位可供使用。 欄位可讓您針對「參與者選擇器」欄位中所選的指令碼,提供以逗號分隔的引數清單。
-
使用者或群組: 工作已指派給選取的使用者或群組。 在 指派選項 欄位中選取 至特定使用者或群組選項 時,即可使用此選項。 欄位會列出工作流程 — 使用者群組的所有使用者和群組。
使用者或群組 下拉式功能表會列出登入使用者有權存取的使用者和群組。 使用者名稱顯示取決於您是否具有該特定使用者crx-repository中 使用者 節點的存取許可權。 -
傳送通知電子郵件:選取此選項可將電子郵件通知傳送給受指派人。 這些通知會在任務指派給使用者或群組時傳送。 您可以使用 收件者電子郵件地址 選項來指定擷取電子郵件地址的機制。
-
收件者電子郵件地址:您可以將電子郵件地址儲存在變數中、使用常值來指定永久電子郵件地址,或使用受指派人設定檔中指定的受指派人預設電子郵件地址。 您可以使用常值或變數來指定群組的電子郵件地址。 變數選項有助於動態擷取和使用電子郵件地址。 使用受指派人的預設電子郵件地址 選項僅適用於單一受指派人。 在此情況下,會使用儲存在受指派人使用者設定檔中的電子郵件地址。
-
HTML電子郵件範本:選取通知電子郵件的電子郵件範本。 若要編輯範本,請在crx-repository中修改位於/libs/fd/dashboard/templates/email/htmlEmailTemplate.txt的檔案。
-
允許委派給: AEM收件匣為登入的使用者提供將指派的工作流程委派給其他使用者的選項。 您可以委派給相同群組內的工作流程使用者,或委派給其他群組的工作流程使用者。 如果任務指派給單一使用者,並且選取了 允許委派給受指派人群組 成員選項,則無法將任務委派給其他使用者或群組。
-
共用設定: AEM Inbox提供選項來與其他使用者共用收件匣中的單一或所有工作:
- 選取 允許受指派人在收件匣 中明確共用選項時,使用者可以按一下工作並與其他AEM使用者共用。
- 選取 允許受分派者透過收件匣共用來共用 選項,且使用者共用其收件匣專案或允許其他使用者存取其收件匣專案時,只有上述選項啟用的工作才會與其他使用者共用。
-
動作>預設動作: 現成可用的送出、儲存和重設動作。 預設會啟用所有預設動作。
-
路由變數: 路由變數的名稱。 路由變數會擷取使用者在AEM收件匣中選取的自訂動作。
-
路由: 任務可以分支到不同的路由。 在AEM收件匣中選取時,路由會傳回值,且工作流程會根據選取的路由進行分支。 您可以將路由儲存在String資料型別陣列中,或選取 常值 以手動新增路由。
-
標題:指定路由的標題。 它會顯示在AEM收件匣中。
-
Coral圖示:指定Coral圖示的HTML屬性。 AdobeCorelUI資料庫提供了一組數量龐大的「觸控優先」圖示。 您可以選擇並使用路由的圖示。 它會與標題一起顯示在AEM收件匣中。 如果您將路由儲存在變數中,路由會使用預設的「標籤」珊瑚圖示。
-
允許受分派者新增註解:選取此選項可啟用工作的註解。 受指派人可以於任務提交時,從AEM收件匣新增註解。
-
將註解儲存在變數: 將註解儲存在String資料型別的變數中。 只有在選取 允許受分派者新增註解 核取方塊時,才會顯示此選項。
-
允許受分派者將附件新增至工作:選取此選項以啟用工作的附件。 受指派人可以於任務提交時,從AEM收件匣新增附件。
-
使用 儲存輸出工作附件:指定附件資料夾的位置。 您可以使用相對於承載的路徑或在檔案資料型別陣列的變數中儲存輸出工作附件。 只有當您選取 允許受分派者將附件新增至工作 核取方塊,並從 表單/檔案 索引標籤中的 型別 下拉式清單中選取 最適化表單、唯讀最適化表單 或 非互動式PDF檔案 時,才會顯示此選項。
- 使用自訂中繼資料: 選取此選項可啟用自訂中繼資料欄位。 自訂中繼資料用於電子郵件範本。
- 自訂中繼資料: 選取電子郵件範本的自訂中繼資料。 自訂中繼資料可在crx-repository的apps/fd/dashboard/scripts/metadataScripts取得。 crx-repository中不存在指定的路徑。 管理員會在使用之前建立路徑。 您也可以使用自訂中繼資料的服務。 您也可以擴充WorkitemUserMetadataService介面以提供自訂中繼資料。
- 顯示先前步驟的資料:選取此選項可讓受指派人檢視先前的受指派人、已對任務採取的動作、新增至任務的註解,以及已完成任務的記錄檔案(若有)。
- 顯示後續步驟的資料: 選取此選項可讓目前的受指派人檢視後續受指派人採取的動作及新增至工作的註解。 也可讓目前的受分派者檢視已完成工作的記錄檔案(若有)。
- 資料型別的可見性: 依預設,受指派人可以檢視記錄檔案、受指派人、採取的動作,以及先前和後續受指派人已新增的註解。 使用資料型別可見性選項來限制受指派人可見的資料型別。
傳送電子郵件步驟 send-email-step
使用電子郵件步驟來傳送電子郵件,例如,含有記錄檔案的電子郵件、最適化表單的連結、互動式通訊的連結,或含有附加PDF檔案的電子郵件。 傳送電子郵件步驟支援HTML電子郵件。 HTML電子郵件會迅速回應,並因應收件者的電子郵件使用者端和熒幕大小。 您可以使用HTML電子郵件範本來定義電子郵件的外觀、色彩配置和行為。
電子郵件步驟使用Day CQ Mail Service傳送電子郵件。 在使用電子郵件步驟之前,請確定已設定電子郵件服務。 電子郵件步驟有下列屬性:
標題: 步驟的標題可協助識別工作流程編輯器中的步驟。
說明: 當您在共用開發環境中工作時,說明對於其他程式開發人員很有用。
電子郵件主旨: 主旨可從工作流程中繼資料中擷取、手動指定,或從儲存在變數中的值中擷取。 從下列選項中選取:
- 常值 — 手動指定主旨。
- 從工作流程中繼資料擷取 — 從中繼資料屬性擷取主旨。
- 變數 — 從儲存在字串資料型別變數中的值擷取主旨。
HTML電子郵件範本:電子郵件的HTML範本。 您可以在電子郵件範本中指定變數。 「電子郵件步驟」會擷取並顯示範本中包含的所有變數以供輸入。
電子郵件範本中繼資料: 電子郵件範本變數的值可以是使用者指定的值、作者或發佈伺服器上的資產路徑、影像,或工作流程中繼資料屬性。
-
常值: 當您知道要指定的確切值時,請使用選項。 例如,example@example.com。
-
工作流程中繼資料: 當要使用的值儲存在工作流程中繼資料屬性時,請使用選項。 選取選項後,在工作流程中繼資料選項下方的空白文字方塊中輸入中繼資料屬性名稱。 例如,emailAddress。
-
資產URL: 使用選項,將互動式通訊的網頁連結內嵌至電子郵件。 選取選項後,瀏覽並選擇要內嵌的互動式通訊。 資產可位於作者或發佈伺服器上。
-
影像: 使用選項將影像內嵌至電子郵件。 選取選項後,瀏覽並選擇影像。 影像選項僅適用於電子郵件範本中可用的影像標籤(<img src="*"/>)。
寄件者/收件者的電子郵件地址: 選取 常值 選項,以手動指定電子郵件地址,或選取 從工作流程中繼資料擷取 選項,以從中繼資料屬性擷取電子郵件地址。 您也可以為 從工作流程中繼資料擷取 選項指定中繼資料屬性陣列清單。 選取 變數 選項,以從字串資料型別變數中儲存的值擷取電子郵件地址。
檔案附件: 指定位置可用的資產已附加至電子郵件。 資產的路徑可以是相對於承載或絕對路徑。 範例路徑為[Payload_Directory]/attachments/。
選取 變數 選項,以擷取儲存在Document、XML或JSON資料型別變數中的檔案附件。
檔案名稱: 電子郵件附件檔案的名稱。 「電子郵件步驟」會將附件的原始檔案名稱變更為指定的檔案名稱。 您可以手動指定名稱,或從工作流程中繼資料屬性或變數中擷取名稱。 當您知道要指定的確切值時,請使用 常值 選項。 使用 變數 選項,從儲存在字串資料型別變數中的值擷取檔案名稱。 當要使用的值儲存在工作流程中繼資料屬性中時,使用 從工作流程中繼資料擷取 選項。
產生記錄檔案步驟 generate-document-of-record-step
填寫或提交表單時,您可以以列印或檔案格式保留表單記錄。 這稱為記錄檔案(DoR)。 您可以使用「產生記錄檔案」步驟來建立最適化表單的唯讀或互動式PDF版本。 PDF版本包含填寫至表單的資訊以及最適化表單的版面。
記錄檔案步驟具有以下屬性:
使用最適化表單:指定尋找輸入最適化表單的方法。 您可以使用提交至工作流程的最適化表單、在絕對路徑提供的表單,或在變數中的路徑提供的表單。 您可以使用String資料型別的變數,在 選取要解析的變數 欄位中指定路徑。
您可以將多個最適化表單與一個工作流程建立關聯。 因此,您可以使用可用的輸入法,在執行階段指定調適型表單。
自適應表單路徑:指定自適應表單的路徑。 當您從 使用最適化表單 欄位中選取 在絕對路徑上可用 選項時,該欄位可供使用。
選擇輸入資料,使用: 最適化表單的輸入資料路徑。 您可以將資料保留在相對於承載的位置、指定資料的絕對路徑,或擷取儲存在Document、JSON或XML資料型別變數中的資料。 輸入資料會與最適化表單合併,以建立記錄檔案。
選擇輸入附件路徑,使用: 附件路徑。 這些附件包含在記錄檔案中。 您可以將附件保持在相對於承載的位置、指定附件的絕對路徑,或擷取儲存在「檔案」資料型別陣列中的附件。
如果您指定資料夾的路徑(例如附件),資料夾中直接可用的所有檔案都會附加至記錄檔案。 如果在指定附件路徑中直接可用的資料夾中有任何檔案可用,則這些檔案會作為附件包含在記錄檔案中。 如果在直接可用的資料夾中有任何資料夾,則會略過這些資料夾。
使用以下選項儲存產生的記錄檔案: 指定保留記錄檔案檔案的位置。 您可以選擇覆寫裝載資料夾、將記錄檔案放在裝載目錄內的某個位置,或將記錄檔案儲存在Document資料型別的變數中。
地區設定:指定記錄檔案的語言。 選取 常值 以從下拉式清單中選取地區設定,或選取 變數 以從字串資料型別變數中儲存的值擷取地區設定。 在變數中儲存地區設定的值時,定義地區設定代碼。 例如,指定 en_US 代表英文,指定 fr_FR 代表法文。
啟動表單資料模型服務步驟 invoke-form-data-model-service-step
您可以使用AEM Forms資料整合來設定並連線至不同的資料來源。 這些資料來源可以是資料庫、Web服務、REST服務、OData服務和CRM解決方案。 AEM Forms資料整合可讓您建立包含各種服務的表單資料模型,以在已設定的資料庫上執行資料擷取、新增、更新操作。 您可以使用 啟動資料模型服務步驟 來選取表單資料模型(FDM),並使用FDM的服務來擷取、更新或新增資料至不同的資料來源。
為說明步驟欄位的輸入,以下資料庫表格和JSON檔案為範例:
範例CustomerDetails資料表
範例JSON檔案
{
customer: {
firstName: "Sarah",
lastName:"Rose",
customerId: "1",
emailAddress:"srose@we.info"
},
insurance: {
customerId: "1",
policyType: "Premium,
policyNumber: "Premium-521499",
customerDetails: {
firstName: "Sarah",
lastName: "Rose",
customerId: "1",
emailAddress: "srose@we.info"
}
}
}
啟動表單資料模型服務步驟包含下列欄位,以方便表單資料模型操作:
-
標題: 步驟的標題。 它有助於識別工作流程編輯器中的步驟。
-
說明: 說明對於其他程式開發人員在您共用開發環境中工作時很有用。
-
表單資料模型路徑:瀏覽並選取伺服器上存在的表單資料模型。
-
服務:所選表單資料模型所提供的服務清單。
-
服務輸入>使用常值、變數或工作流程中繼資料以及JSON檔案來提供輸入資料:服務可以有多個引數。 選取選項,從工作流程中繼資料屬性、JSON物件、變數取得服務引數的值,或直接在提供的文字方塊中輸入值:
-
常值: 當您知道要指定的確切值時,請使用選項。 例如, srose@we.info。
-
變數: 使用選項來擷取儲存在變數中的值。
-
從工作流程中繼資料擷取: 當要使用的值儲存在工作流程中繼資料屬性時,請使用選項。 例如,emailAddress。
-
相對於承載:使用選項來擷取儲存在相對於承載路徑中的檔案附件。 選取選項並指定包含檔案附件的資料夾名稱,或在文字方塊中指定檔案附件名稱。
例如,如果CRX存放庫中的「相對於有效負載」資料夾在
attachment\attachment-folder
位置包含檔案附件,請在選取「相對於有效負載」選項後,在文字方塊中指定attachment\attachment-folder
。 -
JSON點標籤法: 當要使用的值位於JSON檔案中時,請使用選項。 例如,insurance.customerDetails.emailAddress。 JSON Dot Notation選項僅在選取「從輸入JSON對應輸入欄位」選項時可用。
-
從輸入JSON對應輸入欄位: 指定JSON檔案的路徑,以從JSON檔案取得某些服務引數的輸入值。 JSON檔案的路徑可以是相對於裝載、絕對路徑,或者您可以使用JSON或表單資料模型型別的變數來選取輸入JSON檔案。
-
-
服務輸入>使用變數或JSON檔案提供輸入資料: 選取選項,以從儲存在絕對路徑、相對於承載的路徑或變數中的JSON檔案取得所有引數的值。
-
使用 選取輸入JSON檔案:包含所有服務引數值的JSON檔案。 JSON檔案的路徑可以是相對於承載 的 或 絕對路徑。 您也可以使用JSON或表單資料模型資料型別的變數來擷取輸入JSON檔案。
-
JSON點標籤法: 將欄位保留空白,以使用指定JSON檔案的所有物件作為服務引數的輸入。 若要從指定的JSON檔案讀取特定JSON物件作為服務引數的輸入,請為JSON物件指定點標籤法。例如,如果您有和區段開頭所列出的JSON類似的JSON,請指定insurance.customerDetails以提供客戶的所有詳細資料作為服務的輸入。
-
服務輸出>對應輸出值並將輸出值寫入變數或中繼資料: 選取選項,將輸出值儲存為crx-repository中工作流程執行個體中繼資料節點的屬性。 指定中繼資料屬性的名稱,並選取對應的服務輸出屬性以與中繼資料屬性對應,例如,將輸出服務傳回的phone_number與工作流程中繼資料的phone_number屬性對應。 同樣地,您可以將輸出儲存在Long資料型別的變數中。 當您選取 要對映的服務輸出屬性 選項的屬性時,將輸出儲存至 選項只會填入能夠儲存所選屬性資料的變數。
-
服務輸出>將輸出儲存至變數或JSON檔案: 選取選項,將輸出值儲存在JSON檔案中的絕對路徑、相對於承載的路徑或變數中。
-
使用以下選項儲存輸出JSON檔案: 儲存輸出JSON檔案。 輸出JSON檔案的路徑可以是相對於承載或絕對路徑。 您也可以使用JSON或表單資料模型資料型別的變數儲存輸出JSON檔案。
簽署檔案步驟 sign-document-step
「簽署檔案」步驟可讓您使用Adobe Sign來簽署檔案。 「簽署檔案」步驟具有以下屬性:
-
合約名稱: 指定合約的標題。 協定名稱會成為傳送給收件者之電子郵件的主旨與內文的一部分。 您可以將名稱儲存在String資料型別的變數中,或選取 常值 以手動新增名稱。
-
地區設定: 指定電子郵件和驗證選項的語言。 您可以將地區設定儲存在String資料型別的變數中,或選取 常值 從可用選項清單中選擇地區設定。 在變數中儲存地區設定的值時,定義地區設定代碼。 例如,指定 en_US 代表英文,指定 fr_FR 代表法文。
-
Adobe Sign雲端設定:選擇Adobe Sign雲端設定。 如果您尚未設定適用於AEM Forms的Adobe Sign,請參閱將Adobe Sign與AEM Forms整合。
-
使用以下專案選取要簽署的檔案: 您可以從相對於承載的位置選擇檔案、使用承載作為檔案、指定檔案的絕對路徑,或擷取儲存在Document資料型別變數中的檔案。
-
選擇輸入附件路徑,使用: 附件路徑。 這些附件包含在簽署檔案中。 您可以將附件保持在相對於承載的位置、指定附件的絕對路徑,或擷取儲存在「檔案」資料型別陣列中的附件。
如果您指定資料夾的路徑(例如附件),資料夾中直接可用的所有檔案都會附加到「簽署檔案」。 如果任何檔案在指定附件路徑中直接可用的資料夾中可用,則這些檔案會以附件的形式包含在「簽署檔案」中。 如果在直接可用的資料夾中有任何資料夾,則會略過這些資料夾。
-
到截止日期: 在 到截止日期 欄位中指定的天數內沒有作業之後,檔案會標示為到期(已超過截止日期)。 將檔案指派給使用者簽署後,會計入的天數。
-
提醒電子郵件頻率: 您可以每日或每週傳送提醒電子郵件。 一週是從檔案指派給使用者供簽署之日開始計算。
-
簽章程式: 您可以選擇以循序或平行順序簽署檔案。 依序排列,一位收件者一次收到檔案以供簽署。 第一個收件者完成簽署檔案後,檔案會傳送給第二個收件者,依此類推。 多個收件者可同時以並行順序簽署檔案。
-
重新導向URL: 請指定重新導向URL。 檔案簽署後,您可以將受指派人重新導向至URL。 此URL通常包含感謝訊息或進一步說明。
-
工作流程階段: 一個工作流程可以有多個階段。 這些階段會顯示在「AEM收件匣」中。 您可以在模型的屬性(「Sidekick>頁面>頁面屬性>階段」)中定義這些階段。
-
選取收件者: 指定選擇檔案收件者的方法。 您可以動態地將工作流程指派給使用者或群組,或手動新增收件者的詳細資訊。 在下拉式清單中選取手動時,您會新增收件者詳細資訊,例如電子郵件、角色和驗證方法。
note note NOTE - 在「角色」區段中,您可以將收件者角色指定為「簽署者」、「核准者」、「接受者」、「已驗證的收件者」、「表單填寫者」及「委派者」。
- 如果您在「角色」選項中選取「委派者」,委派者可以將簽署任務指派給其他收件者。
- 如果您已設定Adobe Sign的驗證方法,則根據您的設定,您會選取驗證方法,例如以電話為基礎的驗證、以社交身分為基礎的驗證、以知識為基礎的驗證、以政府身分為基礎的驗證。
-
選取收件者的指令碼或服務: 只有當您在[選取收件者]欄位中選取[動態]選項時,才能使用此選項。 您可以指定ECMAScript或服務,以選擇檔案的收件者和驗證選項。
-
收件者詳細資料: 只有在[選取收件者]欄位中選取[手動]選項時,才能使用選項。 指定電子郵件地址並選擇選用的驗證機制。 在選取兩步驟驗證機制之前,請確定已針對已設定的Adobe Sign帳戶啟用對應的驗證選項。 您可以使用字串資料型別的變數來定義 電子郵件、國家代碼 和 電話號碼 欄位的值。 國碼 與 電話號碼 欄位只有在您從 2步驟驗證 下拉式清單中選取 電話驗證 時才會顯示。
-
狀態變數: 啟用Adobe Sign的檔案會將檔案的簽署狀態儲存在String資料型別的變數中。 指定狀態變數(adobeSignStatus)的名稱。 在CRXDE的/etc/workflow/instances/<server>/<date-time>/<workflow model>/workItems/<node>/metaData中可以使用執行個體的狀態變數,該變數包含變數的狀態。
-
已簽署檔案:您可以將已簽署檔案的狀態儲存至變數。 若要新增電子簽章稽核軌跡,以提高「已簽署檔案」的安全性與合法性,您可以包含「稽核報表」。 您可以使用變數或承載資料夾來儲存已簽署的檔案。
note note NOTE 「稽核報表」會附加至已簽署檔案的最後一頁。
檔案服務步驟 document-services-steps
AEM Document Services是一組用於建立、組合和保護PDF檔案的服務。 AEM Forms為每個檔案服務提供個別的AEM Workflow步驟。
與其他AEM Forms工作流程步驟(例如指派任務、傳送電子郵件和簽署檔案)類似,您可以在所有AEM檔案服務步驟中使用變數。 如需建立和管理變數的詳細資訊,請參閱AEM工作流程中的變數。
套用檔案時間戳記步驟 apply-document-time-stamp-step
新增時間戳記至檔案。 您可以提供檔案詳細資訊,例如,輸入檔案路徑、輸入檔名稱、儲存匯出資料的位置。 您可以選擇覆寫現有的裝載檔案、選擇不同的檔案名稱以將資料儲存在裝載資料夾下的不同檔案中、提供資料的絕對路徑,或以Document資料型別的變數儲存資料。
轉換為影像步驟 convert-to-image-step
將PDF檔案轉換為影像清單。 支援的影像格式為JPEG、JPEG2000、PNG和TIFF。 下列資訊適用於TIFF影像的轉換:
- 會產生多頁TIFF檔案。
- 部分註解未包含在TIFF影像中。 需要Acrobat產生其外觀的註解不包括在內。
轉換為PDF/A步驟 convert-to-pdf-a-step
使用提供的選項將PDF檔案轉換為PDF/A格式。 Portable Document Format (PDF)的PDF/A版本專門用於封存和長期儲存檔案。
轉換為PS步驟 convert-to-ps-step
將PDF檔案轉換為PostScript。 轉換為PostScript時,您可以使用轉換作業來指定來原始檔,以及是否要轉換為PostScript第2級或第3級。 您轉換成PostScript檔案的PDF檔案必須是非互動式的。
從指定的型別步驟建立PDF create-pdf-from-specified-type-step
從輸入檔案產生PDF檔案。 輸入檔案可以是相對於裝載、絕對路徑、本身裝載,或儲存在Document資料型別的變數中。
從URL/HTML/ZIP步驟建立PDF create-pdf-from-url-html-zip-step
從提供的URL、HTML和ZIP檔案產生PDF檔案。
匯出資料步驟 export-data-step
從PDF forms或XDP檔案匯出資料。 它需要您輸入「輸入檔案」的檔案路徑和「匯出資料格式」。 「匯出資料格式」的選項為Auto、XDP和XmlData。
指定型別步驟的Export PDF export-pdf-to-specified-type-step
將PDF檔案轉換為選取的格式。
產生非互動式PDF步驟 generatenoninteractive
產生非互動式PDF。 它提供各種自訂選項。
匯入資料步驟 import-data-step
將表單資料合併至PDF表單。 您可以將表單資料匯入PDF表單中。
叫用DDX步驟 invokeddx
在指定的輸入檔案對應上執行DDX檔案,並傳回操作的PDF檔案。
Optimize PDF步驟 optimize-pdf-step
透過縮小PDF檔案的大小來最佳化檔案。 此轉換的結果是PDF檔案可能小於其原始版本。 此操作也會將PDF檔案轉換為最佳化引數中所指定的PDF版本。
最佳化設定可指定檔案最佳化的方式。 以下是設定範例:
- 目標PDF版本
- 捨棄物件,例如JavaScript動作和內嵌的頁面縮圖
- 捨棄評論和檔案附件等使用者資料
- 捨棄無效或未使用的設定
- 壓縮未壓縮資料或使用更有效率的壓縮演演算法
- 移除內嵌字型
- 設定透明度值
呈現PDF表單步驟 renderpdf
將在Designer (XDP)表單中建立的表單轉譯為PDF表單。
安全檔案步驟 secure-document-step
加密、簽署及認證檔案。 AEM Forms同時支援密碼式和憑證式加密。 您也可以選擇簽署檔案的各種演演算法。 例如,SHA-256和SH-512。 您也可以使用工作流程步驟來讀取器擴充PDF檔案。 工作流程步驟提供啟用條碼解碼、數位簽章、匯入和匯出PDF資料的選項,以及其他選項。
傳送至印表機步驟 send-to-printer-step
將檔案直接傳送至印表機。 它支援下列列印存取機制:
- 直接存取印表機:安裝在同一部電腦上的印表機稱為直接存取印表機,而電腦則稱為印表機主機。 此型別的印表機可以是直接連線到電腦的本機印表機。
- 間接存取印表機:可從其他電腦存取安裝在列印伺服器上的印表機。 一般UNIX®列印系統(CUPS)和Line Printer Daemon (LPD)通訊協定等技術,可用於連線到網路印表機。 若要存取可間接存取的印表機,請指定列印伺服器的IP或主機名稱。 使用此機制,您可以在網路執行LPD時,將檔案傳送至LPD URI。 此機制可讓您將檔案路由到任何連線到執行LPD之網路的印表機。
產生列印輸出步驟 generatePrintedOutput
此步驟會產生PCL、PostScript、ZPL、IPL、TPCL或DPL輸出,並提供表單設計和資料檔案。 資料檔會與表單設計合併,並格式化以供列印。 此步驟產生的輸出可以直接傳送到印表機或另存為檔案。 當您想要使用表單設計或來自應用程式的資料時,建議您使用此步驟。 如果您的表單設計或表單設計位於網路、本機檔案系統或HTTP位置,請使用generatePrintedOutput操作。
例如,您的應用程式要求您將表單設計與資料檔案合併。 資料包含數百筆記錄。 此外,它要求將輸出傳送到支援ZPL的印表機。 表單設計和您的輸入資料都在應用程式中。 使用generatePrintedOutput作業將每個記錄與表單設計合併,並將輸出傳送到支援ZPL的印表機。
「產生列印輸出」步驟具有以下屬性:
輸入屬性
-
使用 選取範本檔案:指定範本檔案的路徑。 您可以使用相對於承載的路徑、以絕對路徑儲存的路徑,或使用Document資料型別的變數來選取範本檔案。 例如,[Payload_Directory]/Workflow/data.xml。 如果crx-repository中不存在路徑,管理員可以在使用之前建立路徑。 此外,您也可以接受裝載作為輸入資料檔案。
-
使用 選取資料檔案:指定輸入資料檔案的路徑。 您可以使用相對於承載的路徑、以絕對路徑儲存的路徑,或使用Document資料型別的變數來選取輸入資料檔案。 例如,[Payload_Directory]/Workflow/data.xml。 如果crx-repository中不存在路徑,管理員可以在使用之前建立路徑。
-
印表機格式:指定未提供XDC檔案時用來產生輸出資料流的頁面描述語言的列印格式值。 如果您提供常值,請選取下列其中一個值:
- 自訂PCL:使用選項為PCL指定自訂XDC檔案。
- 自訂PostScript:使用選項為PostScript指定自訂XDC檔案。
- 自訂ZPL:使用選項為ZPL指定自訂XDC檔案。
- 一般色彩PCL (5c):使用一般色彩PCL (5c)。
- 通用PostScript層級3:使用通用PostScript層級3。
- ZPL 300 DPI:使用ZPL 300 DPI。 使用zpl300.xdc。
- ZPL 600 DPI:使用ZPL 600 DPI。 使用zpl600.xdc檔案。
- 自訂IPL:使用選項為IPL指定自訂XDC檔案。
- IPL 300 DPI:使用IPL 300 DPI。 使用ipl300.xdc。
- IPL 400 DPI:使用IPL 400 DPI。 使用ipl400.xdc檔案。
- 自訂TPCL:使用選項為TPCL指定自訂XDC檔案。
- TPCL 305 DPI:使用TPCL 300 DPI。 使用tpcl305.xdc檔案。
- PCL 600 DPI:使用TPCL 600 DPI。 使用tpcl600.xdc檔案。
- 自訂DPL:使用選項來指定自訂XDC檔案DPL。
- DPL300DPI:使用DPL 300 DPI。 使用dpl300.xdc檔案。
- DPL406DPI:使用DPL 400 DPI。 使用dpl406.xdc。
- DPL600DPI:使用DPL 600 DPI。 使用dpl600.xdc。
輸出屬性
- 使用 儲存輸出檔案:指定儲存輸出檔案的位置。 您可以將輸出檔案儲存在相對於承載的位置、變數中,或指定絕對位置來儲存輸出檔案。 如果crx-repository中不存在路徑,管理員可以在使用之前建立路徑。
進階屬性
-
使用 選取內容根目錄位置:內容根目錄是字串值,會指定URI、絕對參照或存放庫中的位置,以擷取表單設計所使用的相對資產。 例如,如果表單設計相對參照影像(例如…/myImage.gif),myImage.gif必須位於repository://。 預設值為repository:// ,指向存放庫的根層級。
當您從應用程式中挑選資產時,內容根URI路徑必須具有正確結構。 例如,如果從名為SampleApp的應用程式中挑選表單,並將表單置於SampleApp/1.0/forms/Test.xdp,則內容根URI必須指定為repository://administrator@password/Applications/SampleApp/1.0/forms/或儲存庫:/Applications/SampleApp/1.0/forms/ (當authority為null)。 以這種方式指定內容根URI時,表單中所有參考資產的路徑都將針對此URI進行解析。
-
使用 選取XCI檔案: XCI檔案用於描述用於表單設計元素的字型和其他屬性。 您可以相對於承載將XCI檔案保留在絕對路徑上,或使用Document資料型別的變數。
-
地區設定:指定用來產生PDF檔案的語言。 如果您提供常值,請從清單中選取語言或選取下列其中一個值:
-
要使用伺服器預設值:
(預設)使用AEM Forms伺服器上設定的地區設定。 地區設定設定是使用Administration Console來設定。 (請參閱Designer說明。) -
若要使用自訂值:
在常值方塊中輸入地區設定代碼,或選取包含地區設定代碼的字串變數。 如需支援地區設定代碼的完整清單,請參閱https://java.sun.com/j2se/1.5.0/docs/guide/intl/locale.doc.html。
-
-
副本:指定輸出產生之副本數目的整數值。 預設值為 1。
-
雙面列印:指定使用雙面或單面列印的「分頁」值。 支援PostScript和PCL的印表機使用此值。 如果您提供常值,請選取下列其中一個值:
- 雙面長Edge:使用雙面列印,並使用長邊分頁列印。
- 雙面短Edge:使用雙面列印,並使用短邊分頁列印。
- 單面:使用單面列印。