工作流程處理序參考 workflow-process-reference
AEM提供了幾個可用於建立工作流程模型的流程步驟。 您也可以為內建步驟未涵蓋的任務新增自訂流程步驟(請參閱 建立工作流程模型)。
程式特性 process-characteristics
對於每個處理步驟,將說明下列特性。
Java™類別或ECMA路徑 java-class-or-ecma-path
處理步驟是由Java™類別或ECMAScript所定義。
- 對於Java™類別處理程式,會提供完整類別名稱。
- 對於ECMAScript程式,會提供指令碼的路徑。
裝載 payload
裝載是工作流程例項作用所在的實體。 裝載是由啟動工作流程執行個體的內容隱含選取。
例如,如果工作流程套用至AEM頁面 P 則 P 會隨著工作流程的進行而在不同步驟之間傳遞,每個步驟會選擇性地對其執行動作 P 以某種方式進行。
在最常見的情況下,有效負載是存放庫中的JCR節點(例如AEM頁面或資產)。 JCR節點承載會以字串形式傳遞,且是JCR路徑或JCR識別碼(UUID)。 有時有效負載可能是JCR屬性(作為JCR路徑傳遞)、URL、二進位物件或通用Java™物件。 對裝載採取動作的個別程式步驟通常會預期某種型別的裝載,或根據裝載型別採取不同的動作。 對於下述每個程式,都會說明預期的裝載型別(若有)。
引數 arguments
有些工作流程處理會接受管理員在設定工作流程步驟時指定的引數。
引數會輸入為中的單一字串 程式引數 中的屬性 屬性 工作流程編輯器的窗格。 對於下述的每個程式,引數字串的格式都以簡單的EBNF文法加以說明。 例如,下列表示引數字串包含一或多個以逗號分隔的引數對,其中每一對都包含名稱(即字串)和值(以雙冒號分隔):
args := name '::' value [',' name '::' value]*
name := /* A string */
value := /* A string */
逾時 timeout
在此逾時期間後,工作流程步驟不再運作。 有些工作流程會遵循逾時,有些則不適用並被忽略。
權限 permissions
傳遞至的工作階段 WorkflowProcess
由工作流程服務的服務使用者提供支援,其在存放庫的根目錄擁有下列許可權:
jcr:read
rep:write
jcr:versionManagement
jcr:lockManagement
crx:replicate
如果該許可權集對您的而言並不足夠 WorkflowProcess
實作,則它必須使用具備所需許可權的工作階段。
建議方法是使用以必要但最小許可權子集建立的服務使用者。
WorkflowProcess
實作後,和可以擁有存放庫的完整存取權,而無需定義特定ACL。-
使用Web主控台(
/system/console/configMgr
找到 AdobeGranite工作流程設定服務 -
啟用 工作流程處理舊模式
WorkflowProcess
並再次提供整個存放庫不受限制的存取。工作流程控制程式 workflow-control-processes
下列程式不會對內容執行任何動作。 它們用於控制工作流程本身的行為。
AbsoluteTimeAutoAdvancer (絕對時間自動提前器) absolutetimeautoadvancer-absolute-time-auto-advancer
此 AbsoluteTimeAutoAdvancer
(絕對時間自動提前器)程式的行為與 自動提前器,但會在指定時間和日期逾時,而非在指定時間長度後逾時。
- Java™類別:
com.adobe.granite.workflow.console.timeout.autoadvance.AbsoluteTimeAutoAdvancer
- 裝載:無。
- 引數:無。
- 逾時:達到設定的時間和日期時,處理會逾時。
自動提前器(自動提前器) autoadvancer-auto-advancer
此 AutoAdvancer
程式會自動前進到工作流程的下一步。 如果有多個可能的下一步(例如,如果有OR分割),則此程式會沿著以下方向推進工作流程 預設路由,如果已指定,則不會進階工作流程。
-
Java™類別:
com.adobe.granite.workflow.console.timeout.autoadvance.AutoAdvancer
-
裝載:無。
-
引數:無。
-
逾時:程式在設定時間長度後逾時。
ProcessAssembler (程式組合器) processassembler-process-assembler
此 ProcessAssembler
流程會在單一工作流程步驟中依序執行多個子流程。 若要使用 ProcessAssembler
,請在您的工作流程中建立此型別的單一步驟,並設定其引數以指示您要執行的子程式的名稱和引數。
-
Java™類別:
com.day.cq.workflow.impl.process.ProcessAssembler
-
裝載:DAM資產、AEM頁面或無裝載(取決於子程式的需求)。
-
引數:
args := arg [',' arg]
arg := processname ['::' processargs]
processname := /* A fully qualified Java Class or absolute
repository path to an ECMAScript */
processargs := processarg [';' processarg]*
processarg := '[' nobracketprocessarg ']' | nobracketprocessarg
nobracketprocessarg := listitem [':' listitem]*
listitem := /* A string */
- 逾時:已遵守。
例如:
- 從資產中擷取中繼資料。
- 建立三種指定大小的縮圖。
- 假設資產原本不是JPEG或PNG (在此情況下不會建立GIF),從資產建立JPEG影像。
- 設定資產的上次修改日期。
com.day.cq.dam.core.process.ExtractMetadataProcess,
com.day.cq.dam.core.process.CreateThumbnailProcess::[140:100];[48:48];[319:319:false],
com.day.cq.dam.core.process.CreateWebEnabledImageProcess::dimension:1280:1280;mimetype:image/jpeg,
com.day.cq.dam.core.process.AssetSetLastModifiedProcess
基本流程 basic-processes
下列程式會執行簡單工作或作為範例。
/libs
路徑。/libs
下次升級執行個體時會被覆寫(並在套用hotfix或feature pack時可能被覆寫)。刪除 delete
指定路徑的專案即被刪除。
-
ECMAScript路徑:
/libs/workflow/scripts/delete.ecma
-
裝載: JCR路徑
-
引數:無
-
逾時:已忽略
空位 noop
這是Null程式。 它不執行任何操作,但會記錄偵錯訊息。
-
ECMAScript路徑:
/libs/workflow/scripts/noop.ecma
-
裝載:無
-
引數:無
-
逾時:已忽略
rule-false rule-false
這是傳回的Null程式 false
於 check()
方法。
-
ECMAScript路徑:
/libs/workflow/scripts/rule-false.ecma
-
裝載:無
-
引數:無
-
逾時:已忽略
範例 sample
這是ECMAScript程式的範例。
-
ECMAScript路徑:
/libs/workflow/scripts/sample.ecma
-
裝載:無
-
引數:無
-
逾時:已忽略
鎖定程式 lockprocess
鎖定工作流程的裝載。
-
Java™類別:
com.day.cq.workflow.impl.process.LockProcess
-
裝載: JCR_PATH和JCR_UUID
-
引數: 無
-
逾時: 已忽略
此步驟在下列情況下不會產生任何影響:
- 承載已鎖定
- 裝載節點不包含jcr:content子節點
UnlockProcess unlockprocess
解鎖工作流程的裝載。
-
Java™類別:
com.day.cq.workflow.impl.process.UnlockProcess
-
裝載: JCR_PATH和JCR_UUID
-
引數: 無
-
逾時: 已忽略
此步驟在下列情況下不會產生任何影響:
- 承載已解鎖
- 裝載節點不包含jcr:content子節點
版本設定流程 versioning-processes
下列程式會執行版本相關工作。
CreateVersionProcess createversionprocess
建立工作流程裝載(AEM頁面或DAM資產)的版本。
-
Java™類別:
com.day.cq.wcm.workflow.process.CreateVersionProcess
-
裝載:參照頁面或DAM資產的JCR路徑或UUID
-
引數:無
-
逾時:已尊重