AEM Forms 작업 공간에서 타사 애플리케이션 통합 integrating-third-party-applications-in-aem-forms-workspace

CAUTION
AEM 6.4가 확장 지원이 종료되었으며 이 설명서는 더 이상 업데이트되지 않습니다. 자세한 내용은 기술 지원 기간. 지원되는 버전 찾기 여기.

AEM Forms workspace에서는 양식 및 문서에 대한 작업 지정 및 완료 활동 관리를 지원합니다. 이러한 양식 및 문서는 XDP, PDF, HTML 또는 Flex 형식으로 렌더링된 XDP Forms, Flex® 양식 또는 안내서(더 이상 사용되지 않음)일 수 있습니다.

이러한 기능은 더욱 향상되었습니다. 이제 AEM Forms에서는 AEM Forms 작업 공간과 유사한 기능을 지원하는 타사 애플리케이션과의 공동 작업을 지원합니다. 이 기능의 일반적인 부분은 작업의 할당 및 후속 승인 워크플로입니다. AEM Forms은 AEM Forms 엔터프라이즈 사용자를 위한 단일 통합 경험을 제공하므로 지원되는 응용 프로그램에 대한 모든 작업 지정 또는 승인을 AEM Forms 작업 공간을 통해 처리할 수 있습니다.

예를 들어 서신 관리를 AEM Forms 작업 영역과의 통합을 위한 샘플 후보로 간주하겠습니다. 서신 관리에는 '편지'의 개념이 있는데, 이를 렌더링하고 작업을 허용합니다.

서신 관리 자산 만들기 create-correspondence-management-assets

먼저 AEM Forms 작업 공간에 렌더링되는 샘플 서신 관리 템플릿을 만듭니다. 자세한 내용은 편지 템플릿 만들기.

URL에서 서신 관리 템플릿에 액세스하여 서신 관리 템플릿을 성공적으로 렌더링할 수 있는지 확인합니다. URL의 패턴은 과 유사합니다 https://[server]:[port]/lc/content/cm/createcorrespondence.html?cmLetterId=encodedLetterId&cmUseTestData=1&cmPreview=0;

여기서 encodedLetterId 는 URL로 인코딩된 문자 ID입니다. Workbench에서 작업 공간 작업에 대한 렌더링 프로세스를 정의할 때 동일한 문자 ID를 지정합니다.

AEM Workspace에서 편지를 렌더링하고 제출할 작업 만들기 create-a-task-to-render-and-submit-a-letter-in-aem-workspace

이러한 단계를 실행하기 전에 다음 그룹의 구성원인지 확인합니다.

  • cm-agent-users
  • 작업 공간 사용자

자세한 내용은 사용자 추가 및 구성.

다음 단계를 사용하여 AEM Workspace에서 편지를 렌더링하고 제출할 작업을 만듭니다.

  1. Workbench를 시작합니다. 로컬 호스트에 관리자로 로그인합니다.

  2. 파일 > 새로 만들기 > 응용 프로그램을 클릭합니다. 응용 프로그램 이름 필드에 를 입력합니다. CMDemoSample 그런 다음 완료를 클릭합니다.

  3. 선택 CMDemoSample/1.0 마우스 오른쪽 단추 클릭 NewProcess. 이름 필드에 를 입력합니다. CMRenderer 그런 다음 완료를 클릭합니다.

  4. 시작 지점 활동 선택기를 끌어서 구성합니다.

    1. 프레젠테이션 데이터에서 CRX 자산 사용을 선택합니다.

      useacrxasset

    2. 자산을 찾습니다. 양식 자산 선택 대화 상자에서 편지 탭에 서버의 모든 문자가 나열됩니다.

      레터탭

    3. 적절한 문자를 선택하고 를 클릭합니다 확인.

  5. 작업 프로필 관리를 클릭합니다. 작업 프로필 관리 대화 상자가 나타납니다. 렌더링 프로세스 및 제출 프로세스가 적절히 선택되어 있는지 확인합니다.

  6. 데이터 XML 파일로 편지를 열려면 데이터 준비 프로세스에서 적절한 데이터 파일을 찾아 선택합니다.

  7. 확인을 클릭합니다.

  8. 시작 지점 출력 및 작업 첨부에 대한 변수를 정의합니다. 정의된 변수에는 시작 지점 출력 및 작업 첨부 데이터가 포함됩니다.

  9. (선택 사항) 워크플로우에서 다른 사용자를 추가하려면 활동 선택기를 끌어서 구성하고 사용자에게 할당합니다. 사용자 지정 래퍼(아래 제공된 샘플)를 작성하거나 DSC(아래 제공)를 다운로드하여 설치하여 편지 템플릿, 시작 지점 출력 및 작업 첨부 파일을 추출합니다.

    샘플 사용자 지정 래퍼는 아래에 나와 있습니다.

    code language-java
    public LetterInstanceInfo getLetterInstanceInfo(Document dataXML) throws Exception {
    try {
    if(dataXML == null)
    throw new Exception("dataXML is missing");
    
    CoreService coreService = getRemoteCoreService();
    if (coreService == null)
    throw new Exception("Unable to retrive service. Please verify connection details.");
    Map<String, Object> result = coreService.getLetterInstanceInfo(IOUtils.toString(dataXML.getInputStream(), "UTF-8"));
    LetterInstanceInfo letterInstanceInfo = new LetterInstanceInfo();
    
    List<Document> attachmentDocs = new ArrayList<Document>();
    List<byte[]> attachments = (List<byte[]>)result.get(CoreService.ATTACHMENT_KEY);
    if (attachments != null){
    for (byte[] attachment : attachments)
    { attachmentDocs.add(new Document(attachment)); }
    
    }
    letterInstanceInfo.setLetterAttachments(attachmentDocs);
    
    byte[] updateLayout = (byte[])result.get(CoreService.LAYOUT_TEMPLATE_KEY);
    if (updateLayout != null)
    { letterInstanceInfo.setLetterTemplate(new Document(updateLayout)); }
    
    else
    { throw new Exception("template bytes missing while getting Letter instance Info."); }
    
    return letterInstanceInfo;
    } catch (Exception e)
    { throw new Exception(e); }
    
    }
    

    파일 가져오기
    DSC 다운로드: DSC 샘플은 DSCSample.zip 위에 첨부된 파일입니다. 다운로드 및 압축 해제 DSCSample.zip 파일. DSC 서비스를 사용하려면 먼저 구성해야 합니다. 자세한 내용은 DSC 서비스 구성.

    활동 정의 대화 상자에서 getLetterInstanceInfo와 같은 적절한 활동을 선택하고 를 클릭합니다 확인.

  10. 애플리케이션을 배포합니다. 확인 메시지가 표시되면 자산을 저장합니다.

  11. 의 AEM Forms 작업 공간에 로그인합니다. https://[server]:[port]/lc/content/ws.

  12. 추가한 작업을 엽니다(CMRenderer). 서신 관리 편지가 나타납니다.

    cminworkspace

  13. 필요한 데이터를 입력하고 편지를 제출하십시오. 창이 닫힙니다. 이 프로세스에서는 작업이 9단계의 워크플로우에 지정된 사용자에게 할당됩니다.

    note note
    NOTE
    편지에 필수 변수가 모두 채워질 때까지 제출 단추가 활성화되지 않습니다.
recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da