Forms JEE 워크플로우 | 사용자 데이터 처리

AEM Forms JEE 워크플로우는 비즈니스 프로세스를 디자인, 제작 및 관리하는 툴을 제공합니다. 워크플로우 프로세스는 지정된 순서로 실행되는 일련의 단계로 구성됩니다. 각 단계에서는 사용자에게 작업을 할당하거나 이메일 메시지를 보내는 등 특정 작업을 수행합니다. 프로세스는 자산, 사용자 계정 및 서비스와 상호 작용할 수 있으며 다음 방법 중 하나를 사용하여 트리거할 수 있습니다.

  • AEM Forms Workspace에서 프로세스 시작
  • SOAP 또는 RESTful 서비스 사용
  • 적응형 양식 제출
  • 감시 폴더 사용
  • 이메일 사용

AEM Forms JEE 워크플로우 프로세스 만들기에 대한 자세한 내용은 워크벤치 도움말을 참조하십시오.

사용자 데이터 및 데이터는저장

프로세스가 트리거되고 진행되면 프로세스 참가자에 대한 데이터, 프로세스와 연관된 양식에서 참가자가 입력한 데이터 및 양식에 추가된 첨부 파일을 캡처합니다. 데이터는 AEM Forms JEE 서버 데이터베이스에 저장되며, 구성된 경우 첨부 파일과 같은 일부 데이터는 GDS(Global Document Storage) 디렉토리에 저장됩니다. GDS 디렉토리는 공유 파일 시스템 또는 데이터베이스에 구성할 수 있습니다.

사용자 데이터액세스 및 삭제

프로세스가 트리거되면 고유한 프로세스 인스턴스 ID 및 긴 라이프타임 호출 ID가 생성되어 프로세스 인스턴스와 연결됩니다. 오래 지속되는 호출 ID를 기반으로 프로세스 인스턴스의 데이터에 액세스하고 삭제할 수 있습니다. 프로세스 개시자 또는 작업을 제출한 프로세스 참가자의 사용자 이름으로 프로세스 인스턴스의 긴 기간 호출 ID를 정의할 수 있습니다.

그러나 다음 시나리오에서는 이니시에이터에 대한 프로세스 인스턴스 ID를 식별할 수 없습니다.

  • 감시 폴더를 통해 트리거된 프로세스:감시 폴더에 의해 프로세스가 트리거되는 경우 해당 이니시에이터를 사용하여 프로세스 인스턴스를 식별할 수 없습니다. 이 경우 사용자 정보는 저장된 데이터로 인코딩됩니다.
  • 게시 AEM 인스턴스에서 시작된 프로세스:AEM 게시 인스턴스에서 트리거된 모든 프로세스 인스턴스는 이니시에이터에 대한 정보를 캡처하지 않습니다. 그러나 사용자 데이터는 워크플로우 변수에 저장되는 프로세스와 연관된 형태로 캡처될 수 있습니다.
  • 이메일을 통해 시작된 프로세스:보낸 사람의 이메일 ID는 tb_job_instance 데이터베이스 테이블의 불투명한 물방울 열에서 속성으로 캡처되므로 직접 쿼리할 수 없습니다.

워크플로 개시자 또는 참가자가이라고 알려진 경우 프로세스 인스턴스 ID 식별

워크플로우 개시자 또는 참가자의 프로세스 인스턴스 ID를 식별하려면 다음 단계를 수행합니다.

  1. AEM Forms 서버 데이터베이스에서 다음 명령을 실행하여 edcprincipalentity 데이터베이스 테이블에서 워크플로 개시자 또는 참가자에 대한 주체 ID를 검색합니다.

    select id from edcprincipalentity where canonicalname='user_ID'
    

    쿼리는 지정된 user_ID에 대한 주체 ID를 반환합니다.

  2. (워크플로우 개시자)의 경우 다음 명령을 실행하여 tb_task 데이터베이스 테이블에서 이니시에이터의 주체 ID와 연관된 모든 작업을 검색합니다.

    select * from tb_task where start_task = 1 and create_user_id= 'initiator_principal_id'
    

    쿼리는 지정된 initiator_ principal_id에 의해 시작된 작업을 반환합니다. 작업은 두 가지 유형으로 구성됩니다.

    • 완료된 작업:이러한 작업이 제출되었으며 필드에 영숫자 값을 process_instance_id 표시합니다. 제출된 작업에 대한 모든 프로세스 인스턴스 ID를 기록해 두고 단계를 계속합니다.
    • 시작되었지만 완료되지 않은 작업:이러한 작업은 시작되었지만 아직 제출되지 않았습니다. 이러한 작업에 대한 process_instance_id 필드의 값은 0(영)입니다. 이 경우 해당 작업 ID를 메모하고 고아 작업을 사용한 작업을 참조하십시오.
  3. (워크플로우 참가자의 경우) 다음 명령을 실행하여 tb_assignment 데이터베이스 테이블에서 이니시에이터에 대한 프로세스 참가자의 주 ID와 연결된 프로세스 인스턴스 ID를 검색합니다.

    select distinct a.process_instance_id from tb_assignment a join tb_queue q on a.queue_id = q.id where q.workflow_user_id='participant_principal_id'
    

    쿼리는 참가자가 작업을 제출하지 않은 프로세스를 비롯하여 참가자와 연결된 모든 프로세스에 대한 인스턴스 ID를 반환합니다.

    제출된 작업에 대한 모든 프로세스 인스턴스 ID를 기록해 두고 단계를 계속합니다.

    process_instance_id이(가) 0(영)인 고아 작업 또는 작업의 경우 해당 작업 ID를 메모하고 고아 작업을(를) 참조하십시오.

  4. 프로세스 인스턴스 ID](/docs/experience-manager-64/forms/using/forms-workflow-jee-handling-user-data.html?lang=ko#purge) 섹션에 따라 워크플로우 인스턴스에서 사용자 데이터 제거 섹션의 지침을 따라 식별된 프로세스 인스턴스 ID에 대한 사용자 데이터를 삭제합니다.[

사용자 데이터가 원시 변수에 저장될 때 프로세스 인스턴스 ID 식별

워크플로우는 사용자 데이터가 데이터베이스에 blob로 저장된 변수에 캡처되도록 디자인할 수 있습니다. 이러한 경우 사용자 데이터가 다음 프리미티브 유형 변수 중 하나에 저장된 경우에만 쿼리할 수 있습니다.

  • 문자열:사용자 ID를 직접 포함하거나 하위 문자열로 포함하고 SQL을 사용하여 쿼리할 수 있습니다.
  • 숫자:사용자 ID를 직접 포함합니다.
  • XML:사용자 ID를 데이터베이스에서 텍스트 열로 저장된 텍스트 내의 하위 문자열로 포함하며 문자열처럼 쿼리할 수 있습니다.

원시 유형 변수에 데이터를 저장하는 워크플로우에 사용자의 데이터가 포함되어 있는지 확인하려면 다음 단계를 수행하십시오.

  1. 다음 데이터베이스 명령을 실행합니다.

    select database_table from omd_object_type where name='pt_<app_name>/<workflow_name>'
    

    쿼리는 지정된 응용 프로그램( app_name) 및 워크플로( workflow_name)에 대해 tb_<number> 형식의 표 이름을 반환합니다.

    노트

    작업 과정이 응용 프로그램 내의 하위 폴더 내에 중첩되는 경우 name 속성 값을 복잡할 수 있습니다. omd_object_type 데이터베이스 테이블에서 얻을 수 있는 워크플로우의 전체 경로를 정확하게 지정해야 합니다.

  2. tb_<number> 테이블 스키마를 검토합니다. 이 표에는 지정된 워크플로우에 대한 사용자 데이터를 저장하는 변수가 포함되어 있습니다. 표의 변수는 워크플로우의 변수에 해당합니다.

    사용자 ID를 포함하는 워크플로우 변수에 해당하는 변수를 식별하고 주목하십시오. 식별된 변수가 프리미티브 유형인 경우 쿼리를 실행하여 사용자 ID와 연결된 워크플로우 인스턴스를 결정할 수 있습니다.

  3. 다음 데이터베이스 명령을 실행합니다. 이 명령에서 user_var은 사용자 ID를 포함하는 프리미티브 유형 변수입니다.

    select process_instance_id from <tb_name> where <user_var>=<user_ID>
    

    쿼리는 지정된 user_ID에 연결된 모든 프로세스 인스턴스 ID를 반환합니다.

  4. 프로세스 인스턴스 ID](/docs/experience-manager-64/forms/using/forms-workflow-jee-handling-user-data.html?lang=ko#purge) 섹션에 따라 워크플로우 인스턴스에서 사용자 데이터 제거 섹션의 지침을 따라 식별된 프로세스 인스턴스 ID에 대한 사용자 데이터를 삭제합니다.[

프로세스 인스턴스 ID에 따라 워크플로우 인스턴스에서 사용자 데이터 제거

사용자와 연결된 프로세스 인스턴스 ID를 식별했으므로 다음을 수행하여 각 프로세스 인스턴스에서 사용자 데이터를 삭제합니다.

  1. tb_process_instance 테이블에서 프로세스 인스턴스에 대한 긴 기간 호출 ID 및 상태를 검색하려면 다음 명령을 실행합니다.

    select long_lived_invocation_id, status from tb_process_instance where id='process_instance_id'
    

    쿼리는 지정된 process_instance_id에 대한 긴 기간 호출 ID와 상태를 반환합니다.

  2. 올바른 연결 설정으로 ServiceClientFactory 인스턴스를 사용하여 공용 ProcessManager 클라이언트( com.adobe.idp.workflow.client.ProcessManager)의 인스턴스를 만듭니다.

    자세한 내용은 Class ProcessManager에 대한 Java API 참조를 참조하십시오.

  3. 워크플로우 인스턴스의 상태를 확인합니다. 상태가 2(COMPLETE) 또는 4(TERMINATED)가 아닌 경우 다음 방법을 호출하여 먼저 인스턴스를 종료합니다.

    ProcessManager.terminateProcess(<long_lived_invocation_id>).

  4. 다음 메서드를 호출하여 워크플로우 인스턴스를 삭제합니다.

    ProcessManager.purgeProcessInstance(<long_lived_invocation_id>)

    purgeProcessInstance 메서드는 구성된 경우 AEM Forms 서버 데이터베이스 및 GDS에서 지정된 호출 ID에 대한 모든 데이터를 삭제합니다.

고아 작업사용

고아 작업은 포함 프로세스가 시작되었지만 아직 제출되지 않은 작업입니다. 이 경우 process_instance_id0(영)입니다. 따라서 프로세스 인스턴스 ID를 사용하여 고아 작업에 대해 저장된 사용자 데이터를 추적할 수 없습니다. 하지만 고아 작업의 작업 ID를 사용하여 추적할 수 있습니다. 워크플로우 개시자 또는 참가자가 인 경우 프로세스 인스턴스 ID를 식별하는 설명에 따라 사용자의 tb_task 테이블에서 작업 ID를 식별할 수 있습니다.

작업 ID가 있으면 다음을 수행하여 GDS 및 데이터베이스의 고아 작업이 있는 연관된 파일 및 데이터를 제거합니다.

  1. 식별된 작업 ID에 대한 ID를 검색하려면 AEM Forms 서버 데이터베이스에서 다음 명령을 실행합니다.

    select id from tb_form_data where task_id=<task_id>
    

    쿼리는 ID 목록을 반환합니다. 결과에 반환된 각 ID( fd_id)에 대해 다음과 같이 세션 ID 문자열 목록을 만듭니다.

    • _ wfattach<task_id>
    • _wftask<fd_id>
    • _wftaskformid<fd_id>
  2. GDS가 파일 시스템을 가리키는지 또는 데이터베이스를 가리키는지에 따라 다음 단계 중 하나를 수행합니다.

    1. 파일 시스템의 GDS

      GDS 파일 시스템:

      1. 다음 세션 ID 문자열이 있는 파일을 확장자로 검색합니다.
      • _wfattach<task_id>

      • _wftask<fd_id>

      • _wftaskformid<fd_id>

        이러한 확장자가 있는 파일은 마커 파일입니다. 파일 이름과 함께 다음 형식으로 저장됩니다.

        <file_name_guid>.session<session_id_string>

      1. 파일 시스템에서 정확한 파일 이름이 <file_name_guid>인 모든 마커 파일 및 기타 파일을 삭제합니다.
    2. 데이터베이스의 GDS

      각 세션 ID에 대해 다음 명령을 실행합니다.

      delete from tb_dm_chunk where documentid in (select documentid from tb_dm_session_reference where sessionid=<session_id>)
      delete from tb_dm_session_reference where sessionid=<session_id>
      delete from tb_dm_deletion where sessionid=<session_id>
      
  3. 다음 명령을 실행하여 AEM Forms 서버 데이터베이스에서 작업 ID에 대한 데이터를 삭제합니다.

    delete from tb_task_acl where task_id=<task_id>
    delete from tb_task_attachment where task_id=<task_id>
    delete from tb_form_data where task_id=<task_id>
    delete from tb_assignment where task_id=<task_id>
    delete from tb_task where id=<task_id>
    

이 페이지에서는