워크플로우 모델 만들기

사용자가 워크플로우를 시작할 때 실행되는 일련의 단계를 정의하는 워크플로우 모델을 만듭니다. 워크플로우가 일시적인지 또는 여러 리소스를 사용하는지 여부와 같은 모델 속성을 정의할 수도 있습니다.

사용자가 워크플로우를 시작하면 인스턴스가 시작됩니다.이것은 Sync에 변경 내용을 적용할 때 만들어진 해당 런타임 모델입니다.

새 워크플로 만들기

새 워크플로우 모델을 처음 만들면 다음과 같은 내용이 포함됩니다.

• 흐름 시작 및 흐름 끝 단계입니다.

  워크플로우의 시작과 끝을 나타냅니다. 이러한 단계는 필수이며 편집하거나 제거할 수 없습니다.

• 참가자 단계 이름 1단계​의 예

  이 단계는 작업 항목을 워크플로우 개시자에게 할당하도록 구성됩니다. 이 단계를 편집하거나 삭제하고 필요에 따라 단계를 추가합니다.

편집기로 새 워크플로우를 만들려면:

1. 워크플로우 모델 콘솔을 엽니다.도구, 워크플로, 모델 또는 다음 예와 같은 방법으로

   http://localhost:4502/aem/workflow

2. 만들기​를 선택하고 모델 만들기​를 선택합니다.

3. 워크플로우 모델 추가 대화 상자가 나타납니다. 완료​를 선택하기 전에 제목 및 이름(선택 사항)을 입력합니다.

4. 새 모델은 워크플로우 모델 콘솔에 나열됩니다.

5. 새 작업 흐름을 선택한 다음 편집​​을 사용하여 구성에 대해 엽니다.

   

워크플로우 편집

기존 워크플로우 모델을 편집하여 다음을 수행할 수 있습니다.

• 단계 및 해당 매개 변수 정의

• 스테이지, 워크플로우가 일시적 및/또는 여러 리소스를 사용하는지 여부를 비롯한 워크플로우 속성 구성

기본값 또는 기존(즉시 사용) 작업 과정을 편집하면 변경 전에 safe copy가 수행되도록 하는 추가 단계가 있습니다.

작업 과정 업데이트가 완료되면 동기화​를 사용하여 런타임 모델 생성​해야 합니다. 자세한 내용은 워크플로우 동기화를 참조하십시오.

워크플로우 동기화 - 런타임 모델 생성

동기화 (편집기 도구 모음의 오른쪽)는 런타임 모델을 생성합니다. 런타임 모델은 사용자가 워크플로우를 시작할 때 실제로 사용되는 모델입니다. 변경 내용 동기화​를 수행하지 않으면 변경 내용을 런타임에 사용할 수 없습니다.

사용자(또는 다른 사용자)가 작업 과정을 변경할 때는 개별 대화 상자(예: 단계)에 고유한 저장 옵션이 있는 경우에도 동기화​를 사용하여 런타임 모델을 생성해야 합니다.

변경 내용이 런타임(저장된) 모델과 동기화되면 동기화된​이 대신 표시됩니다.

일부 단계에는 필수 필드와/또는 유효성 검사가 내장되어 있습니다. 이러한 조건이 충족되지 않으면 Sync​를 시도할 때 오류가 표시됩니다. 예를 들어 참가자 단계에 대해 정의된 참가자가 없을 경우:

처음에 대한 기본 또는 이전 워크플로우 편집

편집을 위해 기본값 및/또는 레거시 모델을 여는 경우:

• 단계 브라우저는 사용할 수 없습니다(왼쪽).

• 도구 모음(오른쪽)에 사용할 수 있는 편집 작업이 있습니다.

• 처음에는 모델 및 해당 속성이 다음과 같이 읽기 전용 모드로 표시됩니다.

  • 기본 워크플로우는 /libs에 있습니다.
  • 기존 워크플로우는 /etc에 있습니다.

편집​을 선택하면 다음 작업이 수행됩니다.

• 워크플로우의 복사본을 /conf으로 가져옵니다.
• 단계 브라우저 사용 가능
• 변경을 수행할 수 있도록 설정

모델에 단계 추가

수행할 활동을 나타내려면 모델에 단계를 추가해야 합니다. 각 단계는 특정 활동을 수행합니다. 표준 AEM 인스턴스에서 여러 단계 구성 요소를 선택할 수 있습니다.

모델을 편집할 때 사용 가능한 단계가 단계 브라우저의 다양한 그룹에 표시됩니다. 예:

모델에 단계를 추가하려면 다음을 수행합니다.

1. 편집할 기존 워크플로우 모델을 엽니다. 워크플로우 모델 콘솔에서 필요한 모델을 선택한 다음 편집.

2. 단계 브라우저를 엽니다.상단 도구 모음의 맨 왼쪽에 있는 사이드 패널 켜기/끄기 를 사용합니다. 여기에서 다음을 수행할 수 있습니다.

   • 필터 를 참조하십시오.
   • 드롭다운 선택기를 사용하여 선택 사항을 특정 단계 그룹으로 제한합니다.
   • 해당 단계에 대한 자세한 내용을 표시하려면 설명 표시 아이콘 을 선택합니다.

   

3. 적절한 단계를 모델의 필요한 위치로 드래그합니다.

   예: 참가자 단계.

   흐름에 추가되면 단계를 구성할 수 있습니다.

   

4. 필요에 따라 단계 또는 기타 업데이트를 추가합니다.

   런타임에 단계는 모델에 나타나는 순서대로 실행됩니다. 단계 구성 요소를 추가한 후 모델의 다른 위치로 드래그할 수 있습니다.

   기존 단계를 복사, 잘라내기, 붙여넣기, 그룹 또는 삭제할 수도 있습니다.를 페이지 편집기와 함께 사용합니다.

   분할된 단계는 도구 모음 옵션을 사용하여 축소/확장할 수도 있습니다.

5. 런타임 모델을 생성하기 위해 동기화(편집기 도구 모음)로 변경 사항을 확인합니다.

   자세한 내용은 워크플로우 동기화를 참조하십시오.

워크플로우 단계 구성

Configure​을 하고 단계 속성 대화 상자를 사용하여 워크플로우 단계의 동작을 사용자 정의할 수 있습니다.

1. 다음 단계 중 하나에 대해 단계 속성 대화 상자를 열려면:

   • 워크플로우 모델의 단계를 누르고 구성 요소 도구 모음에서 구성​을 선택합니다.
   • 단계를 두 번 클릭합니다.
   노트

   AEM과 함께 설치되는 기본 단계 구성 요소에 대한 자세한 내용은 워크플로 단계 참조를 참조하십시오.

2. 필요에 따라 단계 속성​을 구성합니다.사용 가능한 속성은 단계 유형에 따라 다르며, 사용 가능한 여러 탭이 있을 수도 있습니다. 예를 들어, 기본 참가자 단계​는 Step 1 새 워크플로우에 있습니다.

   

3. 확인 표시로 업데이트를 확인합니다.

4. 런타임 모델을 생성하기 위해 동기화(편집기 도구 모음)로 변경 사항을 확인합니다.

   자세한 내용은 워크플로우 동기화를 참조하십시오.

임시 워크플로 만들기

새 모델을 만들거나 기존 모델을 편집할 때 일시적 워크플로우 모델을 만들 수 있습니다.

1. 편집에 대한 워크플로우 모델을 엽니다.

2. 도구 모음에서 워크플로우 모델 속성​을 선택합니다.

3. 대화 상자에서 임시 워크플로 활성화(또는 필요한 경우 비활성화):

   

4. 저장 및 닫기;로 변경 내용을 확인합니다.그 뒤에 동기화(편집기 도구 모음)가 나타나 런타임 모델을 생성합니다.

   자세한 내용은 워크플로우 동기화를 참조하십시오.

Touch UI에서 워크플로우 모델을 사용할 수 있도록 설정

워크플로우 모델이 클래식 UI에 있지만 터치 UI의 타임라인 레일에 있는 선택 팝업 메뉴에 없는 경우 구성에 따라 사용 가능하게 만듭니다. 다음 단계는 활성화 요청​이라는 워크플로우 모델을 사용하는 것을 보여줍니다.

1. 모델이 터치 가능 UI에서 사용할 수 없는지 확인합니다. /assets.html/content/dam 경로를 사용하여 자산에 액세스합니다. 자산을 선택합니다. 왼쪽 레일에서 타임라인​을 엽니다. 워크플로우 시작​을 클릭하고 활성화 요청 모델이 팝업 목록에 없는지 확인합니다.

2. 도구 > 일반 > 태그 지정​을 탐색합니다. 워크플로​을 선택합니다.

3. 만들기 > 태그 만들기​를 선택합니다. 제목​을 DAM 및 이름​을 dam로 설정합니다. 제출​을 선택합니다.
   

4. 도구 > 워크플로우 > 모델​으로 이동합니다. 활성화 요청​을 선택한 다음 편집​을 선택합니다.

5. 편집​을 선택하고 워크플로우 모델 속성​을 엽니다. 기본 탭으로 이동합니다.

6. Workflow : DAM태그​]필드에[​을 추가합니다. 확인(확인 표시)을 사용하여 선택을 확인합니다.

7. 저장 및 닫기​로 태그 추가를 확인합니다.
   

8. 동기화​로 프로세스를 완료합니다. 이제 터치 가능 UI에서 워크플로우를 사용할 수 있습니다.

다중 리소스 지원 워크플로 구성

새 모델을 만들거나 기존 모델을 편집할 때 다중 리소스 지원에 대한 워크플로우 모델을 구성할 수 있습니다.

1. 편집에 대한 워크플로우 모델을 엽니다.

2. 도구 모음에서 워크플로우 모델 속성​을 선택합니다.

3. 대화 상자에서 다중 리소스 지원​을 활성화(또는 필요한 경우 비활성화):

   

4. 저장 및 닫기;로 변경 내용을 확인합니다.그 뒤에 동기화(편집기 도구 모음)가 나타나 런타임 모델을 생성합니다.

   자세한 내용은 워크플로우 동기화를 참조하십시오.

워크플로우 단계 구성(워크플로우 진행 표시)

워크플로우 단계 작업을 처리할 때 워크플로우의 진행 상태를 시각화할 수 있습니다.

사용할 수 있는 단계는 워크플로우 모델에서 정의됩니다.기존 워크플로우 모델을 업데이트하여 스테이지 정의를 포함할 수 있습니다. 워크플로우 모델에 대해 원하는 단계 수를 정의할 수 있습니다.

워크플로우에 대해 단계​를 정의하려면

1. 편집할 워크플로우 모델을 엽니다.

2. 도구 모음에서 워크플로우 모델 속성​을 선택합니다. 그런 다음 단계 탭을 엽니다.

3. 필요한 단계​를 추가(및 위치)합니다. 워크플로우 모델에 대해 원하는 단계 수를 정의할 수 있습니다.

   예:

   

4. 속성을 저장하려면 저장 및 닫기​를 클릭합니다.

5. 워크플로우 모델의 각 단계에 스테이지를 지정합니다. 예:

   

   스테이지를 둘 이상의 단계에 할당할 수 있습니다. 예:

   단계	단계
   1단계	만들기
   2단계	만들기
   3단계	리뷰
   4단계	승인
   5단계	승인
   6단계	완료

6. 런타임 모델을 생성하기 위해 동기화(편집기 도구 모음)로 변경 사항을 확인합니다.

   자세한 내용은 워크플로우 동기화를 참조하십시오.

패키지에서 워크플로우 모델 내보내기

1. 패키지 관리자를 사용하여 새 패키지를 만듭니다.

   1. 도구, 배포, 패키지​를 통해 패키지 관리자로 이동합니다.
   2. 패키지 만들기​를 클릭합니다.
   3. 패키지 이름 및 기타 세부 사항을 필요에 따라 지정합니다.
   4. 확인​을 클릭합니다.

2. 새 패키지의 도구 모음에서 편집​을 클릭합니다.

3. 필터 탭을 엽니다.

4. 필터 추가​를 선택하고 워크플로우 모델 디자인​의 경로를 지정합니다.

   /conf/global/settings/workflow/models/<*your-model-name*>

   완료​를 클릭합니다.

5. 필터 추가​를 선택하고 runtime 워크플로우 모델의 경로를 지정합니다.

   /var/workflow/models/<*your-model-name*>

   완료​를 클릭합니다.

6. 모델에서 사용하는 사용자 정의 스크립트에 대한 필터를 추가합니다.

7. 필터 정의를 확인하려면 저장​을 클릭합니다.

8. 패키지 정의의 도구 모음에서 빌드​를 선택합니다.

9. 패키지 도구 모음에서 다운로드​를 선택합니다.

워크플로우를 사용하여 양식 제출 처리

선택한 워크플로우에서 처리할 양식을 구성할 수 있습니다. 사용자가 양식을 제출하면 새 워크플로우 인스턴스가 양식 제출 데이터를 페이로드로 사용하여 만들어집니다.

양식에 사용할 워크플로우를 구성하려면 다음을 수행하십시오.

1. 새 페이지를 만들고 열어서 편집합니다.

2. 페이지에 양식 구성 요소를 추가합니다.

3. 페이지에 나타나는 양식 시작 구성 요소를 구성합니다.

4. 워크플로우 시작​을 사용하여 사용 가능한 워크플로우에서 원하는 워크플로우를 선택합니다.

   

5. 확인 표시를 사용하여 새 양식 구성을 확인합니다.

워크플로 테스트

다양한 페이로드 유형을 사용하기 위해 워크플로우를 테스트할 때 좋은 방법입니다.개발되는 유형과 다른 유형을 포함합니다. 예를 들어, 워크플로우를 통해 자산을 처리하려면 페이지를 페이로드로 설정하여 테스트하고 오류가 발생하지 않도록 하십시오.

예를 들어 다음과 같이 새 워크플로우를 테스트합니다.

1. 콘솔에서 워크플로우 모델을 시작합니다.

2. 페이로드​를 정의하고 확인합니다.

3. 워크플로우가 진행될 수 있도록 필요에 따라 조치를 취합니다.

4. 워크플로우가 실행되는 동안 로그 파일을 모니터링합니다.

로그 파일에 DEBUG 메시지를 표시하도록 AEM을 구성할 수도 있습니다. 자세한 내용은 로깅을 참조하고 개발이 완료되면 로그 수준​을 다시 정보​로 설정합니다.

예

예:게시 요청을 수락하거나 거부하기 위한 (단순) 워크플로우 만들기

워크플로우 만들기에 대한 몇 가지 가능성을 설명하기 위해 다음 예제에서는 Publish Example 워크플로우의 변형을 만듭니다.

1. 새 워크플로우 모델을 만듭니다.

   새 워크플로우에는 다음이 포함됩니다.

   • 플로우 시작
   • Step 1
   • 플로우 끝

2. Step 1 삭제(이 예제의 잘못된 단계 유형이므로):

   • 단계를 클릭하고 구성 요소 도구 모음에서 삭제​를 선택합니다. 동작을 확인합니다.

3. 단계 브라우저의 워크플로 선택에서 참가자 단계​을 워크플로로 드래그하고 흐름 시작​과 흐름 끝 사이에 배치합니다.

4. 속성 대화 상자를 열려면 다음 중 하나를 수행합니다.

   • 참가자 단계를 클릭하고 구성 요소 도구 모음에서 구성​을 선택합니다.
   • 참가자 단계를 두 번 클릭합니다.

5. 일반 탭에서 제목 및 설명 모두에 Validate Content를 입력합니다.

6. 사용자/그룹 탭을 엽니다.

   • 이메일​을 통해 사용자에게 알립니다.
   • 사용자/그룹 필드에 Administrator( admin)을 선택합니다.
   노트

   이메일을 전송하려면 메일 서비스 및 사용자 계정 세부 사항을 로 구성해야 합니다.

7. 확인 표시로 업데이트를 확인합니다.

   워크플로우 모델 개요로 돌아갑니다. 이 경우 참가자 단계의 이름이 Validate Content으로 바뀝니다.

8. Or Split​을 워크플로우로 드래그하여 Validate Content와 흐름 끝 사이에 배치합니다.

9. 구성을 위해 Or Split​을 엽니다.

10. 구성:

    • 일반:분기 2개 선택
    • 분기 1:기본 경로 를 선택합니다.
    • 분기 2:기본 라우트 가 선택되지 않았는지 확인합니다.

11. OR 분할​에 대한 업데이트를 확인합니다.

12. 참가자 단계​를 왼쪽 분기로 드래그하여 속성을 열고 다음 값을 지정한 다음 변경 사항을 확인합니다.

    • 제목: Reject Publish Request
    • 사용자/그룹:예를 들어 projects-administrators
    • 이메일을 통해 사용자에게 알림:사용자가 이메일을 통해 알림을 받게 하려면 활성화합니다.

13. 프로세스 단계​를 오른쪽 분기로 드래그하고 속성을 열고 다음 값을 지정한 다음 변경 사항을 확인합니다.

    • 제목: Publish Page as Requested
    • 프로세스:선택합니다 Activate Page. 이 프로세스는 선택한 페이지를 게시자 인스턴스에 게시합니다.

14. 런타임 모델을 생성하려면 동기화(편집기 도구 모음)를 클릭합니다.

    자세한 내용은 워크플로우 동기화를 참조하십시오.

    새로운 워크플로우 모델은 다음과 같습니다.

    

15. 사용자가 완료​콘텐츠 유효성 검사 단계로 이동할 때 페이지를 요청된 상태로 게시 또는 게시 요청 거부​를 선택할 수 있도록 이 워크플로우를 페이지에 적용합니다.

    

예:OR 분할 규칙 정의

또는 스플릿 단계를 통해 조건부 처리 경로를 워크플로우에 적용할 수 있습니다.

OR 규칙을 정의하려면

1. 두 개의 스크립트를 만들고 다음 아래에서 예를 들어 저장소에 저장합니다.

   /apps/myapp/workflow/scripts

   노트

   스크립트에는 부울 값을 반환하는 함수 check()가 있어야 합니다.

2. 워크플로우를 편집하고 OR 분할​을 모델에 추가합니다.

3. OR 분할​의 분기 1​의 속성을 편집합니다.

   • 값​을 true로 설정하여 이를 기본 경로​로 정의합니다.

   • 규칙​으로 스크립트 경로를 설정합니다. 예:

     /apps/myapp/workflow/scripts/myscript1.ecma

   노트

   필요한 경우 분기 주문을 전환할 수 있습니다.

4. OR 분할​의 분기 2​의 속성을 편집합니다.

   • 규칙​으로 다른 스크립트에 대한 경로를 설정합니다. 예:

     /apps/myapp/workflow/scripts/myscript2.ecma

5. 각 분기에서 개별 단계의 속성을 설정합니다. 사용자/그룹​이(가) 설정되어 있는지 확인합니다.

6. 런타임 모델에 대한 변경 사항을 유지하려면 동기화(편집기 도구 모음)를 클릭합니다.

   자세한 내용은 워크플로우 동기화를 참조하십시오.

함수 검사()

다음 샘플 스크립트는 노드가 /content/we-retail/us/en 아래에 있는 JCR_PATH이면 true을 반환합니다.

function check() {
    if (workflowData.getPayloadType() == "JCR_PATH") {
      var path = workflowData.getPayload().toString();
      var node = jcrSession.getItem(path);

      if (node.getPath().indexOf("/content/we-retail/us/en") >= 0) {
       return true;
      } else {
       return false;
      } 
     } else {
      return false;
     }
}

예:활성화 요청 사용자 지정

즉시 사용 가능한 워크플로우를 사용자 정의할 수 있습니다. 사용자 지정된 비헤이비어를 만들려면 해당 워크플로우의 세부 사항을 오버레이합니다.

예: 활성화 요청. 이 워크플로우는 사이트 내에 페이지를 게시하는 데 사용되며 컨텐츠 작성자에게 적절한 복제 권한이 없을 때 자동으로 트리거됩니다. 자세한 내용은 페이지 작성 사용자 정의 - 활성화 요청 사용자 정의를 참조하십시오.