워크플로우 모델은 다양한 유형의 일련의 단계로 구성됩니다. 유형에 따라 이러한 단계를 매개 변수와 스크립트를 사용하여 구성하고 확장하여 필요한 기능과 컨트롤을 제공할 수 있습니다.
각 단계 구성 요소에는 단계 속성 필요한 속성을 정의하고 편집할 수 있는 대화 상자입니다.
대부분의 워크플로 단계 구성 요소에서 다음 속성을 조합하여 사용할 수 있습니다. 공통 속성 대화 상자의 탭:
제목
단계의 제목입니다.
설명
단계에 대한 설명입니다.
워크플로우 단계
을(를) 적용할 드롭다운 선택기 단계 단계로 이동합니다.
시간 초과
이후 단계가 "시간 초과"되는 기간입니다.
다음 중 하나를 선택할 수 있습니다. 끔, 즉시, 1시간, 6시간, 12시간, 24시간.
시간 초과 핸들러
단계 제한 시간이 초과되면 워크플로우를 제어하는 핸들러입니다. 예, Auto Advancer
핸들러 진행
실행 후 워크플로우를 자동으로 다음 단계로 이동하려면 이 옵션을 선택합니다. 선택하지 않은 경우 구현 스크립트는 워크플로우 개선을 처리해야 합니다.
에서 많은 워크플로우 단계 구성 요소에 대해 다음 속성을 사용할 수 있습니다. 사용자/그룹 속성 대화 상자의 탭:
사용자에게 이메일로 알립니다
사용자/그룹
다음 AND 분할 워크플로우에서 분할을 만들어 두 분기가 모두 활성화됩니다. 필요에 따라 각 분기에 워크플로 단계를 추가합니다. 이 단계를 통해 워크플로우에 여러 처리 경로를 도입할 수 있습니다. 예를 들어 특정 검토 단계를 동시에 수행하도록 하여 시간을 절약할 수 있습니다.
분할을 구성하려면 다음을 수행합니다.
편집 AND 분할 속성:
필요에 따라 분기에 워크플로우 단계를 추가합니다.
컨테이너 단계는 하위 워크플로우로 실행되는 다른 워크플로우 모델을 시작합니다.
이 컨테이너를 사용하면 워크플로우 모델을 재사용하여 일반적인 단계 시퀀스를 구현할 수 있습니다. 예를 들어 번역 워크플로 모델은 여러 편집 워크플로에서 사용할 수 있습니다.
단계를 구성하려면 다음 탭을 편집하고 사용합니다.
컨테이너
다음 이동 단계 워크플로 모델에서 실행할 다음 단계를 지정할 수 있습니다. 규칙 정의, 외부 스크립트 또는 ECMA 스크립트를 라우팅 표현식으로 지정하여 워크플로우 모델의 다음 단계를 평가할 수 있습니다.
다음 이동 단계 를 사용하면 워크플로우 모델에서 고급 라우팅 구조를 구현할 수 있습니다. 예를 들어 루프를 구현하려면 이동 단계 루프 조건을 평가하는 라우팅 표현식으로 워크플로우의 이전 단계를 실행하도록 정의할 수 있습니다.
단계를 구성하려면 다음 탭을 편집하고 사용합니다.
프로세스
대상 단계: 라우팅 표현식에 대한 조건을 평가한 후 실행할 단계를 선택합니다.
라우팅 표현식: 실행 여부를 결정하는 규칙 정의, 외부 스크립트 또는 ECMA 스크립트를 선택합니다. 대상 단계.
"for 루프"를 시뮬레이트하려면 발생한 루프 반복 횟수 카운트를 유지 관리해야 합니다.
예를 들어 여러 JCR 노드에서 작업을 수행하는 워크플로우를 구현하려면 루프 카운터를 노드의 인덱스로 사용할 수 있습니다. 카운트를 유지하려면 다음을 저장하십시오. integer
워크플로 인스턴스의 데이터 맵에 있는 값입니다. 카운트를 증가시키고 카운트를 종료 기준과 비교하려면 의 스크립트를 사용합니다. 이동 단계.
function check(){
var count=0;
var keyname="loopcount"
try{
if (workflowData.getMetaDataMap().containsKey(keyname)){
log.info("goto script: found loopcount key");
count= parseInt(workflowData.getMetaDataMap().get(keyname))+1;
}
workflowData.getMetaDataMap().put(keyname,count);
}catch(err) {
log.info(err.message);
return false;
}
if (parseInt(count) <7){
return true;
} else {
return false;
}
}
규칙 정의(Rule Definition)를 라우팅 표현식으로 사용하여 for 루프를 시뮬레이션할 수도 있습니다. 만들기 count 변수 Long 데이터 형식의 형식입니다. 사용 표현식 을 매핑 모드로 사용 변수 설정 값을 설정하는 단계 count 변수 대상 count + 1 를 실행할 때마다 변수 설정 단계.
다음에서 이동 단계, 사용 변수 설정 (으)로 대상 단계 및 count < 5 를 라우팅 표현식으로 사용하십시오.
다음 변수 설정 단계가 반복적으로 실행되어 값이 증가합니다. count 값이 5가 될 때까지 각 실행 시 1씩 변합니다.
다음 OR 분할 워크플로우에서 분할을 만들어 그 후에 하나의 분기만 활성화됩니다. 이 단계를 통해 조건부 처리 경로를 워크플로우에 도입할 수 있습니다. 필요에 따라 각 분기에 워크플로 단계를 추가합니다.
다음을 참조하십시오 OR 분할 단계
분할을 구성하려면 다음을 수행합니다.
편집 OR 분할 속성:
일반
분기 (x)
다음을 참조하십시오 OR 분할에 대한 규칙 정의.
필요에 따라 분기에 워크플로우 단계를 추가합니다.
A 참가자 단계 특정 작업에 대한 소유권을 지정할 수 있습니다. 사용자가 단계를 수동으로 승인한 경우에만 워크플로우가 진행됩니다. 이 워크플로는 누군가가 워크플로를 수행하도록 할 때 사용됩니다. 예를 들어 검토 단계입니다.
직접 관련되지는 않지만 작업을 할당할 때 사용자 인증을 고려해야 합니다. 사용자는 워크플로우 페이로드인 페이지에 액세스할 수 있어야 합니다.
단계를 구성하려면 다음 탭을 편집하고 사용합니다.
워크플로 개시자는 다음과 같은 경우에 항상 알림을 받습니다.
이메일 알림을 활성화하려면 일부 속성을 구성해야 합니다. 전자 메일 템플릿을 사용자 지정하거나 새 언어의 전자 메일 템플릿을 추가할 수도 있습니다. AEM에서 이메일 알림을 구성하려면 다음을 참조하십시오. 이메일 알림 구성.
사용 대화 상자 참가자 단계 작업 항목을 할당받은 사용자로부터 정보를 수집할 수 있습니다. 이 단계는 나중에 워크플로우에서 사용되는 소량의 데이터를 수집하는 데 유용합니다.
단계를 완료하면 작업 항목 완료 대화 상자에는 대화 상자에서 정의한 필드가 포함되어 있습니다. 필드에 수집된 데이터는 워크플로우 페이로드의 노드에 저장됩니다. 그런 다음 후속 워크플로우 단계에서 저장소에서 값을 읽을 수 있습니다.
단계를 구성하려면 작업 항목을 지정할 그룹이나 사용자를 지정하고 대화 상자에 대한 경로를 지정합니다.
단계를 구성하려면 다음 탭을 편집하고 사용합니다.
대화 상자
대화 상자를 만들려면 대화 상자를 만들어야 합니다.
워크플로 페이로드 또는 작업 항목 메타데이터에 위젯 데이터를 저장할 수 있습니다. 형식 name
위젯 노드의 속성은 데이터가 저장되는 위치를 결정합니다.
페이로드로 데이터 저장
위젯 데이터를 워크플로 페이로드의 속성으로 저장하려면 위젯 노드의 이름 속성 값에 다음 형식을 사용합니다.
./jcr:content/nodename
데이터가에 저장됩니다. nodename
페이로드 노드의 속성입니다. 노드에 해당 속성이 없으면 속성이 만들어집니다.
페이로드와 함께 저장되는 경우 동일한 페이로드를 사용하는 대화 상자의 후속 사용은 속성 값을 덮어씁니다.
작업 항목으로 데이터 저장
위젯 데이터를 작업 항목 메타데이터의 속성으로 저장하려면 이름 속성 값에 다음 형식을 사용합니다.
nodename
데이터가에 저장됩니다. nodename
작업 항목의 속성 metadata
. 대화 상자가 나중에 동일한 페이로드와 함께 사용되는 경우 데이터가 유지됩니다.
대화 상자 구조
대화 상자 참가자 단계의 대화 상자는 구성 요소 작성을 위해 만든 대화 상자와 유사합니다. 이러한 파일은 다음 위치에 저장됩니다.
/apps/myapp/workflow/dialogs
터치 사용이 가능한 표준 UI에 대한 대화 상자는 다음과 같은 노드 구조를 갖습니다.
newComponent (cq:Component)
|- cq:dialog (nt:unstructured)
|- content
|- layout
|- items
|- column
|- items
|- component0
|- component1
|- ...
다음을 참조하십시오 대화 상자 만들기 및 구성.
대화 상자 경로 속성
다음 대화 상자 참가자 단계 다음 포함: 대화 상자 경로 속성(속성 포함) 참가자 단계). 값 대화 상자 경로 속성은 다음에 대한 경로입니다. dialog
대화 상자의 노드.
예를 들어 대화 상자는 이라는 구성 요소에 포함되어 있습니다. EmailWatch
노드에 저장됩니다.
/apps/myapp/workflows/dialogs
터치 지원 UI의 경우 다음 값이 대화 상자 경로 속성:
/apps/myapp/workflow/dialogs/EmailWatch/cq:dialog
대화 상자 정의 예
다음 XML 코드 조각은 String
의 값 watchEmail
페이로드 콘텐츠의 노드 제목 노드는 텍스트 필드 구성 요소:
jcr:primaryType="nt:unstructured"
jcr:title="Watcher Email Address Dialog"
sling:resourceType="cq/gui/components/authoring/dialog">
<content jcr:primaryType="nt:unstructured"
sling:resourceType="granite/ui/components/foundation/container">
<layout jcr:primaryType="nt:unstructured"
margin="false"
sling:resourceType="granite/ui/components/foundation/layouts/fixedcolumns"
/>
<items jcr:primaryType="nt:unstructured">
<column jcr:primaryType="nt:unstructured"
sling:resourceType="granite/ui/components/foundation/container">
<items jcr:primaryType="nt:unstructured">
<title jcr:primaryType="nt:unstructured"
fieldLabel="Notification Email Address"
name="./jcr:content/watchEmails"
sling:resourceType="granite/ui/components/foundation/form/textfield"
/>
</items>
</column>
</items>
</content>
</cq:dialog>
터치 사용 UI에서 이 예제는 다음과 같은 대화 상자를 생성합니다.
다음 동적 참가자 단계 구성 요소는 과 유사합니다. 참가자 단계 참가자가 런타임에 자동으로 선택된다는 차이점이 있습니다.
단계를 구성하려면 참가자 선택기 대화 상자와 함께 작업 항목을 지정할 참여자를 식별합니다.
단계를 구성하려면 다음 탭을 편집하고 사용합니다.
참가자 선택기
대화 상자
참가자 선택기를 만듭니다. 따라서 모든 선택 논리나 기준을 사용할 수 있습니다. 예를 들어 참가자 선택기는 작업 항목이 가장 적은 사용자(그룹 내)를 선택할 수 있습니다. 의 다양한 인스턴스에서 사용할 참가자 선택기를 원하는 수만큼 만들 수 있습니다. 동적 참가자 단계 워크플로 모델의 구성 요소입니다.
작업 항목을 할당할 사용자를 선택하는 OSGi 서비스 또는 ECMAScript를 만듭니다.
ECMAscript
스크립트에는 사용자 ID를 로 반환하는 getParticipant 함수가 포함되어야 합니다. String
값. 사용자 지정 스크립트를 예를 들어 /apps/myapp/workflow/scripts
폴더 또는 하위 폴더를 생성합니다.
샘플 스크립트는 표준 AEM 인스턴스에 포함됩니다.
/libs/workflow/scripts/initiator-participant-chooser.ecma
의 아무 것도 변경하지 마십시오. /libs
경로.
그 이유는 의 콘텐츠가 /libs
는 다음에 인스턴스를 업그레이드할 때 덮어쓰기됩니다(그리고 핫픽스 또는 기능 팩을 적용할 때 덮어쓰기될 수 있음).
이 스크립트는 워크플로 개시자를 참가자로 선택합니다.
function getParticipant() {
return workItem.getWorkflow().getInitiator();
}
다음 워크플로우 개시자 참가자 선택기 구성 요소가 동적 참가자 단계 및 에서는 이 스크립트를 단계 구현으로 사용합니다.
OSGI 서비스
서비스는 다음을 구현해야 합니다. com.day.cq.workflow.exec.ParticipantStepChooser 인터페이스. 인터페이스는 다음 멤버를 정의합니다.
SERVICE_PROPERTY_LABEL
필드: 이 필드를 사용하여 참가자 선택기의 이름을 지정합니다. 이름은에서 사용 가능한 참가자 선택기 목록에 표시됩니다. 동적 참가자 단계 속성.
getParticipant
메서드: 동적으로 확인된 사용자 ID를 String
값.
다음 getParticipant
메서드는 동적으로 확인된 사용자 ID를 반환합니다. 이 ID는 그룹 ID 또는 사용자 ID일 수 있습니다.
단, 그룹 ID는 참가자 단계: 참가자 목록이 반환됩니다. 의 경우 동적 참가자 단계: 빈 목록이 반환되고 위임에 사용할 수 없습니다.
구현을 사용할 수 있는 대상 동적 참가자 단계 구성 요소를 사용하고, 서비스를 내보내는 OSGi 번들에 Java™ 클래스를 추가하고, 이 번들을 AEM 서버에 배포합니다.
임의 참가자 선택기 임의 사용자( )를 선택하는 샘플 서비스입니다. com.day.cq.workflow.impl.process.RandomParticipantChooser
). 다음 임의 참가자 선택 r 단계 구성 요소 샘플은 동적 참가자 단계 및 는 이 서비스를 단계 구현으로 사용합니다.
다음 Java™ 클래스는 ParticipantStepChooser
인터페이스. 클래스는 워크플로우를 시작한 참가자의 이름을 반환합니다. 이 코드는 샘플 스크립트와 동일한 논리(initiator-participant-chooser.ecma
)은 를 사용합니다.
다음 @Property
주석은 의 값을 SERVICE_PROPERTY_LABEL
필드 대상 Workflow Initiator Participant Chooser
.
package com.adobe.example;
import org.apache.felix.scr.annotations.Component;
import org.apache.felix.scr.annotations.Properties;
import org.apache.felix.scr.annotations.Property;
import org.apache.felix.scr.annotations.Service;
import org.osgi.framework.Constants;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import com.adobe.granite.workflow.WorkflowException;
import com.adobe.granite.workflow.WorkflowSession;
import com.adobe.granite.workflow.exec.ParticipantStepChooser;
import com.adobe.granite.workflow.exec.WorkItem;
import com.adobe.granite.workflow.metadata.MetaDataMap;
@Component
@Service
@Properties({
@Property(name = Constants.SERVICE_DESCRIPTION, value = "An example implementation of a dynamic participant chooser."),
@Property(name = ParticipantStepChooser.SERVICE_PROPERTY_LABEL, value = "Workflow Initiator Participant Chooser (service)") })
public class InitiatorParticipantChooser implements ParticipantStepChooser {
private Logger logger = LoggerFactory.getLogger(this.getClass());
public String getParticipant(WorkItem arg0, WorkflowSession arg1,
MetaDataMap arg2) throws WorkflowException {
String initiator = arg0.getWorkflow().getInitiator();
logger.info("Assigning Dynamic Participant Step work item to {}",initiator);
return initiator;
}
}
다음에서 동적 참가자 단계 속성 대화 상자, 참가자 선택기 목록에 항목 포함 Workflow Initiator Participant Chooser (script)
: 이 서비스를 나타냅니다.
워크플로우 모델이 시작되면 로그에는 워크플로우를 시작한 사용자와 작업 항목을 할당한 사용자의 ID가 표시됩니다. 이 예에서는 admin
사용자가 워크플로우를 시작했습니다.
13.09.2015 15:48:53.037 *INFO* [10.176.129.223 [1347565733037] POST /etc/workflow/instances HTTP/1.1] com.adobe.example.InitiatorParticipantChooser Assigning Dynamic Participant Step work item to admin
다음 양식 참가자 단계 작업 항목을 열 때 폼을 표시합니다. 사용자가 양식을 작성하여 제출하면 필드 데이터가 워크플로 페이로드의 노드에 저장됩니다.
단계를 구성하려면 작업 항목을 지정할 그룹이나 사용자를 지정하고 양식에 대한 경로를 지정합니다.
이 섹션에서는 다음을 다룹니다. 페이지 작성을 위한 기초 구성 요소의 Forms 섹션.
단계를 구성하려면 다음 탭을 편집하고 사용합니다.
에 사용할 양식 만들기 양식 참가자 단계 정상입니다. 단, 양식 참가자 단계의 양식에는 다음 구성이 있어야 합니다.
다음 양식 시작 구성 요소에 다음이 있어야 합니다. 작업 유형 속성이 로 설정됨 Edit Workflow Controlled Resource(s)
.
다음 양식 시작 구성 요소에는 다음 값이 있어야 합니다. Form Identifier
속성.
양식 구성 요소에는 요소 이름 속성을 필드 데이터가 저장되는 노드의 경로로 설정합니다. 경로는 워크플로 페이로드 콘텐츠에서 노드를 찾아야 합니다. 이 값은 다음 형식을 사용합니다.
./jcr:content/path_to_node
양식에는 다음이 포함되어야 합니다: 워크플로우 제출 단추 구성 요소. 구성 요소의 속성을 구성하지 않습니다.
워크플로우의 요구 사항에 따라 필드 데이터를 저장할 위치가 결정됩니다. 예를 들어 필드 데이터를 사용하여 페이지 콘텐츠의 속성을 구성할 수 있습니다. 의 다음 값 요소 이름 속성은 필드 데이터를 redirectTarget
의 속성 jcr:content
노드:
./jcr:content/redirectTarget
다음 예제에서는 필드 데이터를 의 콘텐츠로 사용합니다. 텍스트 페이로드 페이지의 구성 요소:
./jcr:content/par/text_3/text
첫 번째 예는 cq:Page
구성 요소가 렌더링됩니다. 두 번째 예는 페이로드 페이지에 텍스트 ID가 인 구성 요소 text_3
.
양식은 저장소의 어디에나 배치할 수 있지만 워크플로 사용자는 양식을 읽을 수 있는 권한이 있어야 합니다.
다음 임의 참가자 선택기 단계는 목록에서 임의로 선택된 사용자에게 생성된 작업 항목을 할당하는 참가자 선택기입니다.
단계를 구성하려면 다음 탭을 편집하고 사용합니다.
인수
다음 워크플로우 개시자 참가자 선택기 단계는 생성된 작업 항목을 워크플로를 시작한 사용자에게 할당하는 참가자 선택기입니다. 를 구성하는 속성 외에는 없습니다. 공통 속성.
단계를 구성하려면 다음 탭을 사용하여 편집합니다.
A 프로세스 단계 는 ECMAScript를 실행하거나 OSGi 서비스를 호출하여 자동 처리를 수행합니다.
단계를 구성하려면 다음 탭을 편집하고 사용합니다.
프로세스
프로세스: 실행할 프로세스 구현 드롭다운 메뉴를 사용하여 ECMAScript 또는 OSGi 서비스를 선택합니다. 다음에 대한:
핸들러 진행: 실행 후 자동으로 워크플로우를 다음 단계로 이동하려면 이 옵션을 선택합니다. 선택하지 않은 경우 구현 스크립트는 워크플로우 개선을 처리해야 합니다.
인수: 프로세스에 전달할 인수
변수 설정 단계에서는 변수의 값을 설정하고 값이 설정되는 순서를 정의할 수 있습니다. 변수는 변수 설정 단계에서 변수 매핑이 나열된 순서로 설정됩니다.
단계를 구성하려면 다음 탭을 편집하고 사용합니다.
매핑
변수 선택: 이 옵션을 사용하여 값을 설정할 변수를 선택합니다.
매핑 모드 선택: 변수에 대한 값을 설정하려면 매핑 모드를 선택합니다. 변수의 데이터 유형에 따라 다음 옵션을 사용하여 변수의 값을 설정할 수 있습니다.
값 지정: 변수에 매핑하려면 값을 지정합니다. 이 필드에서 지정하는 값은 매핑 모드에 따라 다릅니다.
매핑 추가: 이 옵션을 사용하여 더 많은 매핑을 추가하여 변수에 대한 값을 설정합니다.