Show Menu
화제×

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

마이그레이션 유틸리티는 응용 양식 자산 , 클라우드 구성 통신 관리 자산을 이전 버전에서 사용된 형식에서 AEM 6.5 양식에 사용된 형식으로 변환합니다. 마이그레이션 유틸리티를 실행할 때 마이그레이션되는 항목은 다음과 같습니다.
  • 적응형 양식을 위한 사용자 정의 구성 요소
  • 적응형 양식 및 커뮤니케이션 관리 템플릿
  • 클라우드 구성
  • 통신 관리 및 적응형 양식 에셋
오프라인 업그레이드의 경우, 통신 관리 자산의 경우, 에셋을 가져올 때마다 마이그레이션을 실행할 수 있습니다. 통신 관리 마이그레이션의 경우 양식 호환성 패키지를 설치해야 합니다.

마이그레이션 방법

AEM Forms 6.4, 6.3 또는 6.2에서 최신 버전의 AEM Forms 6.5로 업그레이드하거나 새로 설치할 수 있습니다. 이전 설치를 업그레이드했는지 또는 새로 설치했는지 여부에 따라 다음 중 하나를 수행해야 합니다.
업그레이드 시
직접 업그레이드를 수행한 경우 업그레이드된 인스턴스에는 이미 에셋과 문서가 있습니다. 그러나 에셋 및 문서를 사용하려면 먼저 AEMFD 호환성 패키지 aem-forms-releases.html (통신 관리 호환성 패키지 포함)를 설치해야 합니다.
그런 다음 마이그레이션 유틸리티를 실행하여 에셋과 문서를 업데이트해야 합니다 .
잘못 설치하는 경우
에셋 및 문서를 사용하기 전에 제대로 설치되지 않은(신규) 설치인 경우 AEMFD 호환성 패키지 (통신 관리 호환성 패키지 포함)를 설치해야 합니다.
그런 다음 새 설정에서 자산 패키지(zip 또는 cmp)를 가져온 다음 마이그레이션 유틸리티를 실행하여 자산 및 문서를 업데이트해야 합니다 . 마이그레이션 유틸리티를 실행한 후에만 새 에셋을 새로 만드는 것이 좋습니다.
이전 버전과의 호환성 관련 변경 사항으로 인해 crx-repository에서 몇 개의 폴더 위치가 변경됩니다. 이전 설정에서 기존 환경으로의 종속성(사용자 정의 라이브러리 및 자산)을 수동으로 내보내고 가져옵니다.

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

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

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

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

자산을 변경하거나 자산을 만들기 전에 마이그레이션 유틸리티를 실행합니다. 에셋을 변경하거나 만든 후에는 유틸리티를 실행하지 않는 것이 좋습니다. 마이그레이션 프로세스가 실행되는 동안 통신 관리 또는 적응형 양식 자산 사용자 인터페이스가 열려 있지 않은지 확인하십시오.
처음 마이그레이션 유틸리티를 실행하면 다음과 같은 경로와 이름으로 로그가 생성됩니다.\[aem-installation-directory]\cq-quickstart\logs\aem-forms-migration.log. 이 로그는 자산 이동과 같은 통신 관리 및 적응형 양식 마이그레이션 정보로 계속 업데이트됩니다.
마이그레이션 유틸리티를 실행하기 전에 crx 저장소의 백업을 수행했는지 확인하십시오.
  1. 브라우저 세션에서 AEM 작성자 인스턴스에 관리자로 로그인합니다.
  2. 브라우저에서 다음 URL을 엽니다.
    https:// #: #/ #/libs/fd/foundation/gui/content/migration.html
    브라우저에는 다음 네 가지 옵션이 표시됩니다.
    • AEM Forms 에셋 마이그레이션
    • 적응형 양식 사용자 지정 구성 요소 마이그레이션
    • 적응형 양식 템플릿 마이그레이션
    • AEM Forms 클라우드 구성 마이그레이션
  3. 마이그레이션을 수행하려면 다음을 수행합니다.
    • 자산을 마이그레이션하려면 AEM Forms 자산 마이그레이션을 탭하고 다음 화면에서 마이그레이션 ​시작을 탭합니다 . 다음 항목이 마이그레이션됩니다.
      • 적응형 양식
      • 문서 조각
      • 테마
      • 편지
      • 데이터 사전
    자산 마이그레이션 중에는 "충돌 발견...에 대한 충돌"과 같은 경고 메시지가 표시될 수 있습니다. 이러한 메시지는 적응형 양식의 일부 구성 요소에 대한 규칙을 마이그레이션할 수 없음을 나타냅니다. 예를 들어 구성 요소에 규칙과 스크립트가 모두 있는 이벤트가 있는 경우, 스크립트 후에 규칙이 발생하는 경우 구성 요소에 대한 규칙 중 하나도 마이그레이션되지 않습니다. 그러나 이러한 규칙은 적응형 양식 작성에서 규칙 편집기를 열어 마이그레이션할 수 있습니다.
    이러한 구성 요소는 적응형 양식 편집기의 규칙 편집기에서 열어 마이그레이션할 수 있습니다.
    • 사용자 지정 구성 요소의 규칙 및 스크립트(6.3에서 업그레이드하는 경우 필요하지 않음)를 마이그레이션하려면 적응형 양식 사용자 지정 구성 요소 마이그레이션을 누르고 다음 화면에서 마이그레이션 시작을 누릅니다. 다음 항목이 마이그레이션됩니다.>
    • 규칙 편집기를 사용하여 만든 규칙 및 스크립트(6.1 FP1 이상)
       * 6.1 및 이전 버전의 UI에서 스크립트 탭을 사용하여 만든 스크립트
    
    
    • 템플릿을 마이그레이션하려면(6.3 및 6.4에서 업그레이드하는 경우 필요하지 않음) 적응형 양식 템플릿 마이그레이션을 탭하고 다음 화면에서 마이그레이션 시작을 탭합니다. 다음 항목이 마이그레이션됩니다.
    • 이전 템플릿 - AEM 6.1 Forms 또는 이전 버전을 사용하여 /apps 아래에 만들어진 적응형 양식 템플릿입니다. 여기에는 템플릿 구성 요소에 정의된 스크립트가 포함됩니다.
       * 새로운 템플릿 - /conf 아래에 템플릿 편집기를 사용하여 만든 적응형 양식 템플릿. 여기에는 규칙 편집기를 사용하여 만든 규칙 및 스크립트 마이그레이션이 포함됩니다.
    
    
    • 적응형 양식 사용자 지정 구성 요소를 마이그레이션하려면 적응형 양식 사용자 지정 구성 요소 마이그레이션을 누르고 사용자 지정 구성 요소 마이그레이션 페이지에서 마이그레이션 시작을 누릅니다 . 다음 항목이 마이그레이션됩니다.
      • 적응형 양식에 대해 작성된 사용자 정의 구성 요소
      • 구성 요소 오버레이(있는 경우)
    • 적응형 양식 템플릿을 마이그레이션하려면 적응형 양식 템플릿 마이그레이션을 누르고 사용자 지정 구성 요소 마이그레이션 페이지에서 마이그레이션 시작을 누릅니다 . 다음 항목이 마이그레이션됩니다.
      • AEM 템플릿 편집기를 사용하여 /apps 또는 /conf에서 만든 응용 양식 템플릿
    • AEM Forms Cloud 구성 서비스를 마이그레이션하여 터치 지원 UI(/conf 아래)를 포함하는 새로운 컨텍스트 인식 클라우드 서비스 패러다임을 활용할 수 있습니다. AEM Forms 클라우드 구성 서비스를 마이그레이션할 때 /etc의 클라우드 서비스가 /conf로 이동합니다. 기존 경로(/etc)에 따라 달라지는 클라우드 서비스 맞춤화가 없는 경우 6.5로 업그레이드한 후 바로 마이그레이션 유틸리티를 실행하고 추가 작업을 위해 클라우드 구성 터치 UI를 사용하는 것이 좋습니다. 기존 클라우드 서비스를 사용자 정의한 경우 마이그레이션된 경로(/conf)에 맞게 사용자 정의가 업데이트될 때까지 업그레이드된 설정에서 클래식 UI를 계속 사용한 다음 마이그레이션 유틸리티를 실행합니다. 다음을 포함하는 AEM Forms 클라우드 서비스를 ​마이그레이션하려면 AEM Forms 클라우드 구성 마이그레이션(클라우드 구성 마이그레이션은 AEMFD 호환성 패키지에 독립됨)을 탭하고 AEM Forms 클라우드 구성 마이그레이션을 탭한 다음 구성 마이그레이션 페이지에서 마이그레이션 시작을 탭합니다 .
    • 양식 데이터 모델 클라우드 서비스
      • 소스 경로:/etc/cloudservices/fdm
      • 타겟 경로:/conf/global/settings/cloudconfigs/fdm
    • Recaptcha
      • 소스 경로:/etc/cloudservices/recaptcha
      • 타겟 경로:/conf/global/settings/cloudconfigs/recaptcha
    • Adobe Sign
      • 소스 경로:/etc/cloudservices/echosign
      • 타겟 경로:/conf/global/settings/cloudconfigs/echosign
    • Typekit 클라우드 서비스
      • 소스 경로:/etc/cloudservices/typekit
      • 타겟 경로:/conf/global/settings/cloudconfigs/typekit 마이그레이션 프로세스가 수행되면 브라우저 창에 다음 내용이 표시됩니다.
    • 자산이 업데이트되는 경우:자산이 업데이트되었습니다.
    • 마이그레이션이 완료되면 다음을 수행합니다.에셋 마이그레이션을 완료했습니다. 실행 시 마이그레이션 유틸리티는 다음을 수행합니다.
    • 자산에 ​태그를 추가합니다.태그 "Correspondence Management :마이그레이션된 자산" / "적응형 양식:마이그레이션된 자산"을 참조하십시오. 마이그레이션된 자산을 사용하여 마이그레이션된 자산을 식별할 수 있습니다. 마이그레이션 유틸리티를 실행하면 시스템의 모든 기존 에셋이 마이그레이션됨으로 표시됩니다.
    • 태그 ​생성:이전 시스템에 있는 카테고리 및 하위 카테고리가 태그로 만들어진 다음 이러한 태그는 AEM의 관련 통신 관리 자산과 연결됩니다. 예를 들어 편지 템플릿의 카테고리(클레임) 및 하위 카테고리(클레임)는 태그로 생성됩니다.
  4. 마이그레이션 유틸리티 실행이 완료되면 정리 작업을 진행합니다.

마이그레이션 유틸리티를 실행한 후 관리 작업

마이그레이션 유틸리티를 실행한 후 다음 정리 작업을 수행합니다. AEM Forms로 자산 가져오기 및 내보내기
  1. 레이아웃 및 조각 레이아웃의 XFA 버전이 3.3 이상인지 확인합니다. 이전 버전의 레이아웃 및 조각 레이아웃을 사용하는 경우 편지 렌더링에 문제가 있을 수 있습니다. 이전 XFA 버전을 최신 버전으로 업데이트하려면 다음 단계를 완료하십시오.
    1. 파일을 추출합니다.
    2. 최신 Designer에서 XFA 파일을 열고 저장합니다. XFA 버전이 최신 버전으로 업데이트됩니다.
    3. Forms 사용자 인터페이스에서 XFA를 업로드합니다.
  2. 마이그레이션하기 전에 이전 시스템에 게시된 모든 자산을 게시합니다. 마이그레이션 유틸리티는 작성 인스턴스에서만 자산을 업데이트하고 자산을 게시해야 하는 게시 인스턴스의 자산을 업데이트합니다.
  3. AEM Forms 6.4 및 6.5에서 양식 사용자 그룹의 일부 권한이 변경되었습니다. 사용자가 스크립트를 포함한 XDP 및 적응형 양식을 업로드하거나 코드 편집기를 사용할 수 있게 하려면 Forms-Power-users 그룹에 추가해야 합니다. 마찬가지로 템플릿 작성자는 더 이상 규칙 편집기에서 코드 편집기를 사용할 수 없습니다. 사용자가 코드 편집기를 사용할 수 있도록 af-template-script-writer 그룹에 추가합니다. 그룹에 사용자를 추가하는 방법에 대한 지침은 사용자 및 사용자 그룹 관리를 참조하십시오 .