AEM Forms 자산 및 문서 마이그레이션

마이그레이션 유틸리티는 적응형 Forms 자산, 클라우드 구성서신 관리 자산을 이전 버전에서 AEM 6.5 Forms에 사용된 형식으로 변환합니다. 마이그레이션 유틸리티를 실행하면 다음 항목이 마이그레이션됩니다.

  • 적응형 양식을 위한 사용자 지정 구성 요소
  • 적응형 양식 및 서신 관리 템플릿
  • 클라우드 구성
  • 서신 관리 및 적응형 양식 자산
노트

업그레이드가 부족한 경우, 서신 관리 자산의 경우 자산을 가져올 때마다 마이그레이션을 실행할 수 있습니다. 서신 관리 마이그레이션의 경우 Forms 호환성 패키지가 설치되어 있어야 합니다.

마이그레이션 방법

AEM Forms 6.4, 6.3 또는 6.2에서 최신 버전의 AEM Forms 6.5로 업그레이드하거나 새로 설치할 수 있습니다. 이전 설치를 업그레이드했는지 또는 새 설치를 수행했는지 여부에 따라 다음 중 하나를 수행해야 합니다.

즉각적인 업그레이드 시

즉석 업그레이드를 수행한 경우 업그레이드된 인스턴스에 이미 자산 및 문서가 있습니다. 그러나 자산 및 문서를 사용하려면 AEMFD 호환성 패키지(서신 관리 호환성 패키지 포함)를 설치해야 합니다

그런 다음 마이그레이션 유틸리티🔗를 실행하여 자산 및 문서를 업데이트해야 합니다.

부재 설치 시

자산 및 문서를 사용하기 전에 잘못된 설치(새로 고친)인 경우 AEMFD 호환성 패키지(서신 관리 호환성 패키지 포함)를 설치해야 합니다.

그런 다음 새 설정에서 자산 패키지(zip 또는 cmp)를 가져온 다음 마이그레이션 유틸리티🔗를 실행하여 자산 및 문서를 업데이트해야 합니다. Adobe은 마이그레이션 유틸리티를 실행한 후에만 새 설정에 새 자산을 만들 것을 권장합니다.

이전 버전과의 호환성 관련 변경 사항으로 인해 crx-repository에서 몇 개의 폴더 위치가 변경됩니다. 이전 설정에서 새 환경으로 종속성(사용자 지정 라이브러리 및 자산)을 수동으로 내보내고 가져옵니다.

마이그레이션을 계속 진행하기 전에 를 읽어 보십시오

서신 관리 자산의 경우:

  • 이전 플랫폼에서 가져온 자산의 경우 속성이 추가됩니다. fd:version=1.0
  • AEM 6.1 Forms이므로 주석을 즉시 사용할 수 없습니다. 이전에 추가된 주석은 자산에서 사용할 수 있지만 인터페이스에 자동으로 표시되지 않습니다. AEM Forms 사용자 인터페이스에서 extendedProperties 속성을 사용자 정의하여 주석을 표시해야 합니다.
  • LiveCycle ES4와 같은 일부 이전 버전에서는 Flex RichTextEditor를 사용하여 텍스트가 편집되었지만 AEM 6.1 Forms으로 HTML 편집기가 사용됩니다. 이러한 글꼴, 글꼴 크기 및 글꼴 여백의 렌더링 및 모양 때문에 작성자 사용자 인터페이스의 이전 버전과 다를 수 있습니다. 그러나 문자를 렌더링할 때 문자가 동일하게 표시됩니다.
  • 텍스트 모듈의 목록이 개선되어 이제 다르게 렌더링됩니다. 시각적인 차이가 있을 수 있습니다. 텍스트 모듈에서 목록을 사용하는 문자를 렌더링하고 보는 것이 좋습니다.
  • 이미지 컨텐츠 모듈은 DAM 자산으로 변환되고 레이아웃 및 조각이 마이그레이션 중에 양식에 추가되므로, 이러한 모듈에 대한 Updated By 속성이 Admin으로 변경됩니다.
  • 자산의 버전 기록은 마이그레이션되지 않으며 마이그레이션 후에는 사용할 수 없습니다. 후속 버전 기록 후 마이그레이션은 유지 관리됩니다.
  • 게시 준비 상태는 AEM 6.1 Forms 이후 더 이상 사용되지 않으므로 게시 준비 상태의 모든 자산은 수정됨 상태로 변경됩니다.
  • 사용자 인터페이스가 AEM Forms 6.3에서 업데이트되므로 사용자 지정을 수행하는 단계도 다릅니다. 6.3 이전 버전에서 마이그레이션하는 경우 사용자 지정을 재실행해야 합니다.
  • 레이아웃 조각이 /content/apps/cm/layouts/fragmentlayouts/1001에서 /content/apps/cm/modules/fragmentlayouts로 이동합니다. 자산의 데이터 사전 참조는 이름 대신 데이터 사전의 경로를 표시합니다.
  • 텍스트 모듈에서 정렬에 사용되는 모든 탭 공간을 재조정해야 합니다. 자세한 내용은 서신 관리 - 텍스트 배열 탭 간격 사용을 참조하십시오.
  • Asset Composer 구성이 서신 관리 구성에 변경되었습니다.
  • 자산은 기존 텍스트 및 기존 목록과 같은 이름의 폴더 아래로 이동합니다.

마이그레이션 유틸리티 사용

마이그레이션 유틸리티 실행

자산을 변경하거나 자산을 만들기 전에 마이그레이션 유틸리티를 실행합니다. 변경하거나 자산을 만든 후에는 유틸리티를 실행하지 않는 것이 좋습니다. 마이그레이션 프로세스가 실행되는 동안 서신 관리 또는 적응형 Forms 자산 사용자 인터페이스가 열리지 않았는지 확인하십시오.

마이그레이션 유틸리티를 처음 실행하면 다음과 같은 경로 및 이름으로 로그가 생성됩니다. [aem-installation-directory]\cq-quickstart\logs\aem-forms-migration.log 이 로그는 자산 이동과 같은 서신 관리 및 적응형 Forms 마이그레이션 정보로 계속 업데이트됩니다.

노트

마이그레이션 유틸리티를 실행하기 전에 crx 저장소의 백업을 수행했는지 확인하십시오.

  1. 브라우저 세션에서 AEM 작성자 인스턴스에 관리자로 로그인합니다.

  2. 브라우저에서 다음 URL을 엽니다.

    https://[hostname]:[port]/[context_path]/libs/fd/foundation/gui/content/migration.html

    브라우저에는 네 가지 옵션이 표시됩니다.

    • AEM Forms 에셋 마이그레이션
    • 응용 Forms 사용자 지정 구성 요소 마이그레이션
    • 적응형 Forms 템플릿 마이그레이션
    • AEM Forms 클라우드 구성 마이그레이션
  3. 마이그레이션을 수행하려면 다음을 수행하십시오.

    • 자산​을 마이그레이션하려면 AEM Forms Assets 마이그레이션을 탭하고 다음 화면에서 마이그레이션 시작​을 탭합니다. 다음 항목이 마이그레이션됩니다.

      • 적응형 양식
      • 문서 조각
      • 테마
      • 편지
      • 데이터 사전
    노트

    자산 마이그레이션 중에 "충돌이 발견됨…"과 같은 경고 메시지가 표시될 수 있습니다. 이러한 메시지는 적응형 양식의 일부 구성 요소에 대한 규칙을 마이그레이션할 수 없음을 나타냅니다. 예를 들어 구성 요소에 규칙과 스크립트가 모두 있는 이벤트가 있는 경우, 스크립트 후에 규칙이 발생하는 경우 구성 요소에 대한 규칙 중 어느 것도 마이그레이션되지 않습니다. 하지만 이러한 규칙은 적응형 양식 작성에서 규칙 편집기를 열어 마이그레이션할 수 있습니다.

    이러한 구성 요소는 적응형 Forms 편집기의 규칙 편집기에서 열어 마이그레이션할 수 있습니다.

    • 사용자 지정 구성 요소에서 규칙 및 스크립트(6.3에서 업그레이드하는 경우 필요하지 않음)를 마이그레이션하려면 응용 Forms 사용자 지정 구성 요소 마이그레이션을 탭하고 다음 화면에서 마이그레이션 시작을 탭합니다. 다음 항목이 마이그레이션됩니다. >

    • 규칙 편집기를 사용하여 만든 규칙 및 스크립트(6.1 FP1 이상)

    • 6.1 및 이전 버전의 UI에서 스크립트 탭을 사용하여 작성된 스크립트

    • 템플릿을 마이그레이션하려면(6.3 및 6.4에서 업그레이드하는 경우 필요하지 않음) 적응형 Forms 템플릿 마이그레이션을 탭하고 다음 화면에서 마이그레이션 시작을 탭합니다. 다음 항목이 마이그레이션됩니다.

    • 이전 템플릿 - AEM 6.1 Forms 또는 이전 버전을 사용하여 /apps에서 만든 적응형 양식 템플릿입니다. 여기에는 템플릿 구성 요소에 정의된 스크립트가 포함됩니다.

    • 새 템플릿 - /conf 아래의 템플릿 편집기를 사용하여 만든 적응형 양식 템플릿입니다. 여기에는 규칙 편집기를 사용하여 만든 규칙 및 스크립트의 마이그레이션이 포함됩니다.

    • 적응형 양식 사용자 지정 구성 요소를 마이그레이션하려면 적응형 Forms 사용자 지정 구성 요소 마이그레이션​을 누르고 사용자 지정 구성 요소 마이그레이션 페이지에서 마이그레이션 시작​을 탭합니다. 다음 항목이 마이그레이션됩니다.

      • 응용 Forms용으로 작성된 사용자 지정 구성 요소
      • 구성 요소 오버레이(있는 경우).
    • 적응형 양식 템플릿을 마이그레이션하려면 적응형 Forms 템플릿 마이그레이션​을 누르고 사용자 지정 구성 요소 마이그레이션 페이지에서 마이그레이션 시작​을 누릅니다. 다음 항목이 마이그레이션됩니다.

      • AEM 템플릿 편집기를 사용하여 /apps 또는 /conf에서 만든 응용 양식 템플릿입니다.
    • AEM Forms Cloud 구성 서비스를 마이그레이션하여 터치 지원 UI(/conf%20%EC%95%84%EB%9E%98?lang=ko)를 포함하는 새로운 컨텍스트 인식 클라우드 서비스 패러다임을 활용합니다. AEM Forms Cloud Configuration 서비스를 마이그레이션하면 /etc의 클라우드 서비스가 /conf로 이동됩니다. 레거시 경로(/etc?lang=ko)에 의존하는 클라우드 서비스 사용자 지정 사항이 없는 경우 6.5로 업그레이드한 후 바로 마이그레이션 유틸리티를 실행하고 클라우드 구성 Touch UI를 사용하여 추가로 작업하는 것이 좋습니다. 기존 클라우드 서비스 사용자 지정 항목이 있는 경우, 마이그레이션된 경로(/conf?lang=ko)에 맞게 사용자 지정이 업데이트될 때까지 업그레이드된 설정에서 클래식 UI를 계속 사용한 다음 마이그레이션 유틸리티를 실행합니다.

    다음을 포함하는 AEM Forms 클라우드 서비스​를 마이그레이션하려면 AEM Forms Cloud 구성 마이그레이션(클라우드 구성 마이그레이션은 AEMFD 호환성 패키지와 독립적)을 탭하고 AEM Forms Cloud 구성 마이그레이션 을 탭한 다음, 구성 마이그레이션 페이지에서 마이그레이션 시작​을 탭합니다.

    • 양식 데이터 모델 클라우드 서비스

      • 소스 경로: /etc/cloudservices/fdm
      • Target 경로: /conf/global/settings/cloudconfigs/fdm
    • Recaptcha

      • 소스 경로: /etc/cloudservices/recaptcha
      • Target 경로: /conf/global/settings/cloudconfigs/recaptcha
    • Adobe Sign

      • 소스 경로: /etc/cloudservices/echosign
      • Target 경로: /conf/global/settings/cloudconfigs/echosign
    • Typekit 클라우드 서비스

      • 소스 경로: /etc/cloudservices/typekit
      • Target 경로: /conf/global/settings/cloudconfigs/typekit

    마이그레이션 프로세스가 진행되는 동안 브라우저 창에 다음 내용이 표시됩니다.

    • 자산이 업데이트되는 경우: 자산이 업데이트되었습니다.
    • 마이그레이션이 완료되면: 자산에 대한 마이그레이션을 완료했습니다.

    실행되면 마이그레이션 유틸리티가 다음을 수행합니다.

    • 자산에 태그를 추가합니다. 태그 "서신 관리 :"를 추가합니다. 마이그레이션된 자산" / "적응형 Forms : 마이그레이션된 자산". 마이그레이션된 자산으로 마이그레이션된 자산을 식별할 수 있도록 합니다. 마이그레이션 유틸리티를 실행하면 시스템의 모든 기존 자산이 마이그레이션됨으로 표시됩니다.
    • 태그 생성: 이전 시스템에 있는 카테고리 및 하위 카테고리는 태그로 만들어지면 이러한 태그는 AEM의 관련 서신 관리 자산과 연결됩니다. 예를 들어 편지 템플릿의 카테고리(클레임) 및 하위 카테고리(클레임)가 태그로 생성됩니다.
  4. 마이그레이션 유틸리티 실행이 완료되면 하우스키핑 작업으로 이동하십시오.

마이그레이션 유틸리티를 실행한 후 하우스키핑 작업

마이그레이션 유틸리티를 실행한 후 다음 하우스키핑 작업을 수행합니다.

  1. XFA 버전의 레이아웃 및 조각 레이아웃이 3.3 이상인지 확인합니다. 이전 버전의 레이아웃 및 조각 레이아웃을 사용하는 경우 편지를 렌더링하는 데 문제가 있을 수 있습니다. 이전 XFA 버전을 최신 버전으로 업데이트하려면 다음 단계를 수행하십시오.

    1. Forms 사용자 인터페이스에서 XFA를 zip 파일로 다운로드합니다.
    2. 파일을 추출합니다.
    3. 최신 디자이너에서 XFA 파일을 열고 저장합니다. XFA 버전이 최신 버전으로 업데이트됩니다.
    4. Forms 사용자 인터페이스에서 XFA를 업로드합니다.
  2. 마이그레이션 전에 이전 시스템에 게시된 모든 자산을 게시합니다. 마이그레이션 유틸리티는 작성자 인스턴스에서만 자산을 업데이트하고 자산을 게시해야 하는 게시 인스턴스의 자산을 업데이트합니다.

  3. AEM Forms 6.4 및 6.5에서 Forms 사용자 그룹의 일부 권한이 변경되었습니다. 사용자가 스크립트가 포함된 XDP 및 적응형 Forms을 업로드하거나 코드 편집기를 사용하려면 forms-power-users 그룹에 추가해야 합니다. 마찬가지로 템플릿 작성자가 더 이상 규칙 편집기에서 코드 편집기를 사용할 수 없습니다. 사용자가 코드 편집기를 사용할 수 있도록 af-template-script-writers 그룹에 사용자를 추가합니다. 그룹에 사용자를 추가하는 방법에 대한 지침은 사용자 및 사용자 그룹 관리를 참조하십시오.

이 페이지에서는