워크플로 인스턴스 관리 administering-workflow-instances

워크플로 콘솔은 워크플로 인스턴스가 예상대로 실행되도록 관리하기 위한 몇 가지 도구를 제공합니다.

다양한 콘솔을 사용하여 워크플로를 관리할 수 있습니다. 전역 탐색을 사용하여 도구 창을 연 다음 워크플로 ​를 선택합니다.

워크플로 인스턴스 상태 모니터링 monitoring-the-status-of-workflow-instances

워크플로 인스턴스 일시 중단, 재시작 및 종료 suspending-resuming-and-terminating-a-workflow-instance

보관된 워크플로 보기 viewing-archived-workflows

워크플로 인스턴스 실패 해결 fixing-workflow-instance-failures

워크플로가 실패하면 AEM은 실패 콘솔을 제공하므로 원래 원인을 처리하고 나면 이를 조사하고 적절한 조치를 취할 수 있습니다.

실패를 조사한 다음 그 직후에 워크플로를 다시 시작하거나 종료하려면 다음 단계를 사용하십시오.

정기적인 워크플로 인스턴스 제거 regular-purging-of-workflow-instances

워크플로 인스턴스 수를 최소화하면 워크플로 엔진의 성능이 향상되므로 완료되었거나 실행 중인 워크플로 인스턴스를 저장소에서 정기적으로 제거할 수 있습니다.

수명 및 상태에 따라 워크플로 인스턴스를 제거하도록 Adobe Granite 워크플로 제거 구성 ​을 구성합니다. 또한 모든 모델 또는 특정 모델의 워크플로 인스턴스를 제거할 수 있습니다.

여러 서비스 구성을 생성하여 서로 다른 기준을 충족하는 워크플로 인스턴스를 제거할 수도 있습니다. 예를 들어 특정 워크플로 모델의 인스턴스가 예상 시간보다 오래 실행될 때 해당 인스턴스를 제거하는 구성을 생성할 수 있습니다. 저장소 크기를 최소화하기 위해 특정 일수가 지난 후 완료된 모든 워크플로를 제거하는 다른 구성을 생성할 수도 있습니다.

서비스를 구성하려면 웹 콘솔 또는 저장소에 OSGi 구성을 추가할 수 있습니다. 다음 표에서는 두 가지 방법에 필요한 속성을 설명합니다.

받은 편지함의 최대 크기 설정 setting-the-maximum-size-of-the-inbox

웹 콘솔 또는 저장소에 OSGi 구성을 추가하여 Adobe Granite 워크플로 서비스 ​를 구성하여 받은 편지함의 최대 크기를 설정할 수 있습니다. 다음 표에서는 두 메서드에 대해 구성하는 속성을 설명합니다.

고객 소유 데이터 스토어에 워크플로 변수 사용 using-workflow-variables-customer-datastore

워크플로에서 처리된 데이터는 Adobe 제공 스토리지(JCR)에 저장됩니다. 이 데이터는 기본적으로 중요할 수 있습니다. 모든 사용자 정의 메타데이터/데이터를 Adobe 제공 스토리지가 아닌 자체 관리 스토리지에 저장할 수 있습니다. 이 섹션에서는 이러한 변수를 외부 스토리지로 설정하는 방법에 대해 설명합니다.

메타데이터의 외부 스토리지를 사용하도록 모델 설정 set-model-for-external-storage

워크플로 모델 수준에서는 모델(및 런타임 인스턴스)에 메타데이터의 외부 스토리지가 있음을 나타내는 플래그가 제공됩니다. 워크플로 변수는 외부 스토리지로 표시된 모델의 워크플로 인스턴스에 대해 JCR에서 유지되지 않습니다.

userMetadataPersistenceEnabled 속성은 워크플로 모델의 jcr:content 노드 ​에 저장됩니다. 이 플래그는 워크플로 메타데이터에서 cq:userMetaDataCustomPersistenceEnabled ​로 유지됩니다.

아래 일러스트레이션에서는 워크플로에 플래그를 설정하는 방법을 보여 줍니다.

외부 스토리지의 메타데이터를 위한 API apis-for-metadata-external-storage

변수를 외부에 저장하려면 워크플로에서 표시하는 API를 구현합니다.

UserMetaDataPersistenceContext

다음 샘플은 API 사용 방법을 보여 줍니다.

@ProviderType
public interface UserMetaDataPersistenceContext {

    /**
     * Gets the workflow for persistence
     * @return workflow
     */
    Workflow getWorkflow();

    /**
     * Gets the workflow id for persistence
     * @return workflowId
     */
    String getWorkflowId();

    /**
     * Gets the user metadata persistence id
     * @return userDataId
     */
    String getUserDataId();
}

UserMetaDataPersistenceProvider

/**
 * This provider can be implemented to store the user defined workflow-data metadata in a custom storage location
 */
@ConsumerType
public interface UserMetaDataPersistenceProvider {

   /**
    * Retrieves the metadata using a unique identifier
    * @param userMetaDataPersistenceContext
    * @param metaDataMap of user defined workflow data metaData
    * @throws WorkflowException
    */
   void get(UserMetaDataPersistenceContext userMetaDataPersistenceContext, MetaDataMap metaDataMap) throws WorkflowException;

   /**
    * Stores the given metadata to the custom storage location
    * @param userMetaDataPersistenceContext
    * @param metaDataMap metadata map
    * @return the unique identifier that can be used to retrieve metadata. If null is returned, then workflowId is used.
    * @throws WorkflowException
    */
   String put(UserMetaDataPersistenceContext userMetaDataPersistenceContext, MetaDataMap metaDataMap) throws WorkflowException;
}