자동 양식 전환 서비스 구성

이 도움말은 AEM 관리자가 PDF forms을 적응형 양식으로 자동 전환하도록 Automated forms conversion 서비스를 구성하는 방법에 대해 설명합니다. 이 도움말은 조직의 IT 및 AEM 관리자를 위한 것입니다. 제공된 정보는 이 도움말을 읽는 사람이 다음 기술을 잘 알고 있다는 가정을 기반으로 합니다.

  • Adobe Experience Manager 및 AEM 패키지 설치, 구성 및 관리,

  • Linux® 및 Microsoft® Windows® 운영 체제 사용,

  • SMTP 메일 서버 구성

온보딩

이 서비스는 AEM 6.4 Forms 및 AEM 6.5 Forms On-Premise 기간제 고객과 Adobe 관리 서비스 기업 고객에게 무료로 제공됩니다. Adobe 영업팀 또는 Adobe 담당자에게 문의하여 서비스 액세스 권한을 요청할 수 있습니다. 이 서비스는 AEM Forms as a Cloud Service 고객이 무료로 이용할 수 있고 미리 활성화되어 있습니다.

Adobe는 조직에 대한 액세스 권한을 활성화하고 조직의 책임자로 지정된 사람에게 필요한 권한을 제공합니다. 책임자는 해당 서비스에 연결할 조직의 AEM Forms 개발자(사용자)에게 액세스 권한을 부여할 수 있습니다.

전제 조건

automated forms conversion 서비스를 사용하려면 다음 항목이 필요합니다.

  • 조직에 대해 automated forms conversion 서비스가 활성화되어 있습니다
  • 전환 서비스에 대한 관리자 권한이 있는 Adobe ID 계정
  • 최신 AEM 서비스 팩 또는 최신 업데이트를 사용하는 Cloud Service 작성자 인스턴스로서 AEM 6.4, AEM 6.5 또는 AEM Forms을 실행 중입니다.
  • Forms-user 그룹의 멤버인 AEM 사용자(AEM 인스턴스)입니다

환경 설정

서비스를 사용하기 전에 AEM 작성자 인스턴스를 준비하여 Adobe 클라우드에서 실행되는 서비스에 연결합니다. 나열된 순서로 다음 단계를 수행하여 서비스에 대한 인스턴스를 준비합니다.

  1. AEM 6.4, AEM 6.5 또는 온보드 AEM Forms을 Cloud Service으로 다운로드하여 설치합니다
  2. 최신 AEM 서비스 팩 다운로드 및 설치
  3. 최신 AEM Forms 추가 기능 패키지를 다운로드하여 설치합니다
  4. (선택 사항) 최신 커넥터 패키지 다운로드 및 설치
  5. 사용자 지정 테마 및 템플릿 만들기

AEM 6.4 또는 AEM 6.5 또는 온보드 AEM Forms을 Cloud Service으로 다운로드하여 설치합니다.

automated forms conversion 서비스는 AEM 작성자 인스턴스에서 실행됩니다. AEM 작성자 인스턴스를 설정하려면 AEM 6.4, AEM 6.5 또는 Cloud Service으로 AEM Forms이 필요합니다.

(AEM 6.4 및 AEM 6.5만 해당) AEM 최신 서비스 팩을 다운로드하여 설치합니다

최신 AEM 서비스 팩 다운로드 및 설치. 자세한 지침은 또는 AEM 6.4 서비스 팩 릴리스 노트 또는 AEM 6.5 서비스 팩 릴리스 노트를 참조하십시오.

(AEM 6.4 및 AEM 6.5만 해당) AEM Forms 추가 기능 패키지를 다운로드하여 설치합니다

AEM 인스턴스에는 기본 양식 기능이 포함되어 있습니다. 전환 서비스에는 AEM Forms의 전체 기능이 필요합니다. AEM Forms의 모든 기능을 이용할 수 있도록 AEM Forms 추가 기능 패키지를 다운로드하여 설치합니다. 전환 서비스를 설정하고 실행하려면 패키지가 필요합니다. 자세한 지침은 데이터 캡처 기능 설치 및 구성을 참조하십시오.

노트

추가 기능 패키지를 설치한 후 필수 설치 후 구성을 수행해야 합니다.

사용자 지정 테마 및 템플릿 만들기

프로덕션 모드(nosamplecontent run mode)에서 AEM 6.4 또는 AEM 6.5를 시작하면 참조 패키지가 설치되지 않습니다. 참조 패키지에는 샘플 테마 및 템플릿이 들어 있습니다. automated forms conversion 서비스를 사용하려면 PDF 양식을 적응형 양식으로 전환하려면 하나 이상의 테마와 하나의 템플릿이 필요합니다. 서비스를 사용하기 전에 사용자 정의 템플릿과 테마를 사용하려면 자신의 테마와 템플릿을 만들고 서비스 구성을 가리킵니다.

작성자 인스턴스에 AEM Forms 참조 자산 패키지를 다운로드하여 설치할 수도 있습니다. 일부 참조 테마 및 템플릿을 만듭니다.

서비스 구성

서비스를 구성하고 로컬 인스턴스를 Adobe 클라우드에서 실행되는 서비스와 연결하기 전에 서비스에 연결하는 데 필요한 개인 및 권한에 대해 알아봅니다. 이 서비스는 다음과 같은 두 가지 유형의 개인, 관리자 및 개발자를 사용합니다.

  • 관리자: 관리자는 조직의 Adobe 소프트웨어 및 서비스를 관리할 책임이 있습니다. 관리자는 조직의 개발자에게 Adobe Cloud에서 실행되는 Automated forms conversion 서비스에 연결할 수 있는 액세스 권한을 부여합니다. 조직에 대해 관리자가 프로비저닝되면 관리자는 ‘You now have administrator rights to manage Adobe software and services for your organization’ 제목이 있는 이메일을 받게 됩니다. 관리자의 경우, 사서함에서 이전에 언급된 제목이 있는 이메일을 확인하고 조직 개발자에게 액세스 권한 부여를 진행하십시오.

관리자 액세스 권한 부여 이메일

  • 개발자: 개발자는 로컬 AEM Forms 작성자 인스턴스를 Adobe 클라우드에서 실행되는 Automated forms conversion 서비스에 연결합니다. 관리자가 개발자에게 Automated forms conversion 서비스에 연결할 수 있는 권한을 부여하면, 이제 조직에 대한 Adobe API 통합을 관리할 개발자 액세스 권한이 있는 이메일이 개발자에게 전송됩니다. 개발자인 경우 사서함에서 이전에 언급된 제목이 있는 이메일을 확인하고 Adobe Cloud의 Automated forms conversion 서비스에 로컬 AEM 인스턴스를 연결합니다.

개발자 액세스 권한 부여 이메일

(AEM 6.4 및 AEM 6.5의 관리자에게만 해당) 조직의 개발자에게 액세스 권한을 부여합니다

Adobe이 조직에 대한 액세스를 활성화하고 관리자에게 필요한 권한을 제공하면 관리자는 Admin Console에 로그인하고(아래 세부 지침) 프로필을 만들고 프로필에 개발자를 추가할 수 있습니다. 개발자는 AEM Forms의 로컬 인스턴스를 Adobe 클라우드의 Automated forms conversion 서비스에 연결할 수 있습니다.

개발자는 전환 서비스를 실행하도록 지정된 조직의 구성원입니다. Adobe Automated forms conversion 서비스 프로필에 추가된 개발자만 Automated forms conversion 서비스를 사용할 수 있습니다. 아래 단계를 수행하여 프로필을 만들고 개발자를 추가합니다. 조직의 개발자에게 필요한 액세스 권한을 부여하려면 적어도 하나의 프로필이 필요합니다.

  1. Admin Console에 로그인합니다. automated forms conversion 서비스를 사용하여 로그인하려면 제공된 관리자의 Adobe ID​을 사용하십시오. 로그인할 다른 ID 또는 Federated ID은 사용하지 마십시오.

  2. Automated Forms Conversion 옵션을 클릭합니다.

  3. Products 탭에서 New Profile 을 클릭합니다.

  4. 프로필에 대해 Name, Display NameDescription​를 지정합니다. 클릭 Done. 프로필이 만들어집니다.

    새 프로필에 대한 세부 사항을 지정합니다.

  5. 프로필에 개발자를 추가합니다. 개발자를 추가하려면:

    1. Admin Console에서 개요 탭으로 이동합니다.
    2. 필요한 제품 카드에서 Assign Developers 을 클릭합니다.
    3. 개발자의 이메일 주소와 이름(선택 사항)을 입력합니다.
    4. 제품 프로필을 선택합니다. 탭하기 Save.

모든 사용자에 대해 위의 단계를 반복합니다. 개발자 추가에 대한 자세한 내용은 개발자 관리를 참조하십시오.

관리자가 Adobe I/O 프로필에 개발자를 추가하면 개발자에게 이메일을 통해 알림을 보냅니다. 이메일을 받은 후 개발자는 Adobe Cloud에서 로컬 AEM Forms 인스턴스를 Automated forms conversion 서비스와 연결할 수 있습니다.

(개발자만) 로컬 AEM Forms 인스턴스를 Adobe Cloud의 Automated forms conversion 서비스에 연결합니다

관리자가 개발자 액세스 권한을 제공하면 로컬 AEM Forms 인스턴스를 Adobe 클라우드에서 실행되는 Automated forms conversion 서비스에 연결할 수 있습니다. 나열된 순서로 다음 단계를 수행하여 AEM Forms 인스턴스를 서비스에 연결합니다.

이메일 알림 구성

automated forms conversion 서비스는 일 CQ 메일 서비스를 사용하여 이메일 알림을 보냅니다. 이러한 이메일 알림에는 성공적인 전환 또는 실패한 전환에 대한 정보가 포함되어 있습니다. 알림을 받지 않도록 선택하는 경우 다음 단계를 건너뜁니다. 다음 단계를 수행하여 Day CQ Mail Service를 구성합니다.

  • AEM 6.4 Forms 또는 AEM 6.5 Forms의 경우:

    1. http://localhost:4502/system/console/configMgr의 AEM 구성 관리자로 이동합니다.

    2. Day CQ Mail Service 구성을 엽니다. SMTP server host name, SMTP server portFrom address 필드의 값을 지정합니다. 클릭 Save.

      전자 메일 서비스 공급자 또는 IT 관리자에게 문의하여 SMTP 서버의 호스트 이름 및 포트에 대한 정보를 확인할 수 있습니다. 보낸 사람 필드에서 유효한 이메일 주소를 사용할 수 있습니다. 예: notification@example.com 또는 donotreply@example.com.

    3. Day CQ Link Externalizer 구성을 엽니다. Domains 필드에서 로컬, 작성자 및 게시 인스턴스에 대한 실제 호스트 이름 또는 IP 주소와 포트 번호를 지정합니다. 클릭 Save.

  • AEM Forms as a Cloud Service의 경우 지원 티켓을 로그하여 이메일 서비스를 활성화하십시오.

forms-users 그룹에 사용자 추가

서비스를 실행하도록 지정된 AEM 사용자의 프로필에 이메일 주소를 지정합니다. 사용자가 forms user 그룹의 구성원인지 확인합니다. 이메일은 전환을 실행하는 사용자의 이메일 주소로 전송됩니다. 사용자의 이메일 주소를 지정하고 사용자를 Forms 사용자 그룹에 추가하려면 다음을 수행합니다.

  1. AEM 관리자로 AEM Forms 작성자 인스턴스에 로그인합니다. 로그인하려면 로컬 AEM 자격 증명을 사용합니다. Adobe ID을 사용하여 로그인하지 마십시오. Adobe Experience Manager > Tools > Security > Users​를 누릅니다.

  2. 전환 서비스를 실행하도록 지정된 사용자를 선택하고 Properties​을(를) 누릅니다. 사용자 설정 편집 페이지가 열립니다.

  3. Email 필드에 전자 메일 주소를 지정하고 Save​을(를) 탭합니다. 전환이 성공적으로 완료되었거나 실패하면 지정된 이메일 주소로 이메일이 전송됩니다.

  4. 그룹 탭을 탭합니다. 그룹 선택 탭에서 forms-users 그룹을 입력하고 선택합니다. 저장 및 닫기​를 누릅니다. 이제 사용자가 forms-users 그룹의 구성원입니다.

(AEM 6.4 및 AEM 6.5에만 해당) 공개 인증서 받기

공개 인증서를 사용하면 Adobe I/O 시 프로필을 인증할 수 있습니다.

  1. AEM Forms 작성자 인스턴스에 로그인합니다. 다음으로 이동 Tools> Security > Adobe IMS Configurations. 탭하기 Create. Adobe IMS Technical Account Configuration 페이지가 나타납니다.

    Adobe IMS 기술 계정 구성 페이지

  2. 클라우드 솔루션에서 Automated Forms Conversion Service 을 선택합니다.

  3. Create new certificate 확인란을 선택하고 별칭을 지정합니다. 별칭은 대화 상자의 이름으로 사용됩니다. 탭하기 Create certificate. 대화 상자가 나타납니다. 클릭 OK. 인증서가 만들어집니다.

  4. Download Public Key​을(를) 탭하고 AEM-Adobe-IMS.crt 인증서 파일을 컴퓨터에 저장합니다. 인증서 파일은 Adobe 개발자 콘솔에서 서비스 API를 구성하는 데 사용됩니다. 탭하기 Next.

  5. 아래에 을(를) 지정합니다.

    다른 필드는 비워 둡니다(나중에 제공). 페이지를 열어 두십시오.

(AEM 6.4 및 AEM 6.5만 해당) Adobe 개발자 콘솔에서 서비스 API를 구성합니다

automated forms conversion 서비스를 사용하려면 프로젝트를 만들고 Automated Forms Configuration Service API 를 Adobe 개발자 콘솔의 프로젝트에 추가합니다. 통합은 API 키, 클라이언트 암호, 페이로드(JWT)를 생성합니다.

  1. https://console.adobe.io/에 로그인합니다. 관리자가 Adobe I/O 콘솔에 로그인하여 사용할 수 있도록 제공한 Adobe ID 개발자 계정을 사용하십시오.

  2. 오른쪽 상단 모서리에서 조직을 선택합니다. 조직을 모르는 경우에는 관리자에게 문의하십시오.

  3. 탭하기 Create new project. 새 프로젝트를 시작할 화면이 나타납니다. 탭하기 Add API. 계정에 대해 모든 API 목록이 활성화된 화면이 나타납니다.

  4. Automated Forms Conversion service 을 선택하고 Next 을 누릅니다. API를 구성하는 화면이 나타납니다.

  5. Upload your public key 옵션을 선택하고 공개 인증서 가져오기 섹션에서 다운로드한 AEM-Adobe-IMS.crt 파일을 업로드하고 Next 를 탭합니다. 새 서비스 계정(JWT) 자격 증명 만들기 옵션이 나타납니다. 탭하기 Next.

  6. 제품 프로필을 선택하고 Save configured API 을 누릅니다. 조직 개발자에게 액세스 권한을 부여하는 동안 만든 프로필을 선택합니다. 선택할 프로필을 모를 경우 관리자에게 문의하십시오.

  7. 로컬 AEM 인스턴스를 Automated forms conversion 서비스에 연결하는 데 필요한 API 키, 클라이언트 암호 및 기타 정보를 보려면 Service Account (JWT) 을 누릅니다. 페이지의 정보는 로컬 시스템에서 IMS 구성을 만드는 데 사용됩니다.

  8. 로컬 인스턴스에서 IMS 구성 페이지를 엽니다. 공개 인증서 받기 섹션의 끝에서 페이지를 열어 두었습니다.

    제목, API 키, 클라이언트 암호 및 페이로드를 지정합니다

  9. Adobe IMS 기술 페이지에서 API 키 및 클라이언트 암호를 지정합니다. Adobe 개발자 콘솔 페이지의 서비스 계정(JWT)에 지정된 값을 사용합니다.

    노트

    페이로드의 경우 Adobe 개발자 콘솔의 서비스 계정(JWT) 페이지의 JWT 생성 탭에 제공된 코드를 사용합니다.

  10. 탭하기 Save. IMS 구성이 만들어집니다.

    주의

    IMS 구성을 하나만 만드십시오. 두 개 이상의 IMS 구성을 만들지 마십시오.

  11. IMS 구성을 선택하고 Check Health 을 누릅니다. 대화 상자가 나타납니다. 탭하기 Check. 연결에 성공하면 토큰이 검색되었습니다​라는 메시지가 나타납니다.

    연결에 성공하면 토큰이 검색되었습니다 라는 메시지가 나타납니다.



Cloud Service 구성

AEM 인스턴스를 전환 서비스에 연결하는 Cloud Service 구성을 만듭니다. 또한 변환에 사용할 템플릿, 테마 및 양식 조각을 지정할 수 있습니다. 각 양식 세트에 대해 별도로 여러 클라우드 서비스 구성을 만들 수 있습니다. 예를 들어, 영업 부서 양식에 대해 별도의 구성과 고객 지원 양식에 대해 별도의 구성이 있을 수 있습니다. 클라우드 서비스 구성을 만들려면 다음 단계를 수행하십시오.

  1. AEM Forms 인스턴스에서 Adobe Experience Manager > Tools Cloud Services > Automate Forms Conversion Configuration​을(를) 탭합니다.

  2. Global 폴더를 탭하고 Create 키를 누릅니다. automated forms conversion 구성을 만드는 페이지가 나타납니다. 구성은 전역 폴더에 만들어집니다. 또한 존재하는 다른 폴더에 구성을 만들거나 구성에 대한 폴더를 만들 수도 있습니다.

  3. Create Automated Forms Conversion Configuration 페이지에서 다음 필드에 값을 지정하고 Next 을 누릅니다.

    필드 설명
    제목 구성에 대한 고유 제목입니다. 전환을 시작하는 데 사용되는 UI에 제목이 표시됩니다.
    이름 구성에 대한 고유 이름입니다. 구성은 지정된 이름으로 CRX-Repository에 저장됩니다. 이름은 제목과 같을 수 있습니다.
    축소판 그림 위치 구성에 대한 축소판의 위치입니다.
    서비스 URL Adobe Cloud에 있는 Automated forms conversion 서비스의 URL입니다. https://aemformsconversion.adobe.io/ URL을 사용하십시오.
    템플릿 변환된 양식에 적용할 기본 템플릿입니다. 변환을 시작하기 전에 항상 다른 템플릿을 지정할 수 있습니다. 템플릿에는 적응형 양식에 대한 기본 구조와 초기 컨텐츠가 포함되어 있습니다. 기본 제공 템플릿에서 템플릿을 선택할 수 있습니다. 사용자 지정 템플릿을 만들 수도 있습니다.
    테마 변환된 양식에 적용할 기본 테마입니다. 전환을 시작하기 전에 항상 다른 테마를 지정할 수 있습니다. 아이콘을 클릭하여 즉시 제공되는 테마를 선택할 수 있습니다. 사용자 지정 테마를 만들 수도 있습니다.
    기존 조각 기존 조각의 위치(있는 경우).
    사용자 지정 메타 모델 사용자 지정 메타 모델의 .schema.json 파일 경로입니다. 영어, 프랑스어, 독일어, 스페인어, 이탈리아어 및 포르투갈어 언어에 대해 별도의 메타 모델을 만들 수 있습니다.
  4. Create Automated Forms Conversion Configuration 페이지의 Advanced 탭에서 다음 필드에 대한 값을 지정합니다.

    필드 설명
    기록 문서 생성 변환된 양식에 대해 기록 문서를 자동으로 생성하는 옵션을 선택합니다. 옵션은 XFA 기반 양식(XDP 및 PDF forms)에만 제공됩니다. 이 옵션을 활성화하면 양식을 제출한 후 고객이 이후에 참조할 수 있도록 양식에 입력한 정보의 레코드를 인쇄나 문서 형식으로 유지할 수 있습니다. 이를 기록 문서라고 합니다.
    Analytics 활성화 (AEM 6.4 및 AEM 6.5만 해당) 전환된 모든 양식에서 Adobe Analytics을 활성화하는 옵션을 선택합니다. 옵션을 사용하기 전에 AEM Forms 인스턴스에 대해 Adobe Analytics이 활성화되어 있는지 확인하십시오.
    • 소스가 확장명이 .XDP인 XFA 기반 양식인 경우 출력 DOR가 XFA 레이아웃을 유지합니다. 그렇지 않으면 변환 서비스에서 기본 템플릿을 사용하여 다른 XFA 기반 양식에 대한 DOR를 생성합니다.
    • XFA 양식을 제출하면 양식의 제출 데이터가 XML 요소 또는 특성으로 저장됩니다. 예, <Amount currency="USD"> 10.00 </Amount>. 통화는 속성 및 통화 금액으로 저장되며, 10.00은 요소로 저장됩니다. 적응형 양식의 제출 데이터에는 속성이 없으며 요소만 있습니다. 따라서 XFA 기반 양식을 적응형 양식으로 변환할 때 적응형 양식 제출 데이터에는 그러한 각 속성에 대한 요소가 포함됩니다. 예를 들어
       {
          "Type": "Principal",
    
          "Amount": "10.00",
    
          "currency": "USD"
       }
    
  5. 탭하기 Create. 클라우드 구성이 만들어집니다. AEM Forms 인스턴스에서 기존 양식을 적응형 양식으로 전환할 준비가 되었습니다.

이 페이지에서는