마이그레이션 유틸리티는 적응형 Forms 에셋, 클라우드 구성, 및 서신 관리 에셋 이전 버전에서 사용된 형식에서 Adobe Experience Manager(AEM) 6.5 Forms에서 사용된 형식으로 변환되었습니다. 마이그레이션 유틸리티를 실행하면 다음 항목이 마이그레이션됩니다.
위치 외 업그레이드가 있는 경우 서신 관리 에셋의 경우 에셋을 가져올 때마다 마이그레이션을 실행할 수 있습니다. 서신 관리 마이그레이션의 경우 Forms 호환성 패키지가 설치되어 있어야 합니다.
다음을 수행할 수 있습니다. 업그레이드 AEM Forms 6.4, 6.3 또는 6.2에서 최신 버전의 AEM Forms 6.5로 마이그레이션하거나 새로 설치하십시오. 이전 설치를 업그레이드했는지 새로 설치했는지 여부에 따라 다음 중 하나를 수행해야 합니다.
바로 업그레이드할 수 있는 경우
원본 위치 업그레이드를 수행한 경우 업그레이드된 인스턴스에 이미 에셋과 문서가 있습니다. 그러나 에셋 및 문서를 사용하기 전에 AEMFD 호환성 패키지 (서신 관리 호환성 패키지 포함)
그런 다음 다음을 수행하여 에셋 및 문서를 업데이트해야 합니다. 마이그레이션 유틸리티 실행.
잘못된 설치가 있는 경우
잘못된(새로운) 설치인 경우 에셋 및 문서를 사용하기 전에 AEMFD 호환성 패키지 (서신 관리 호환성 패키지 포함).
그런 다음 새 설정에서 자산 패키지(zip 또는 cmp)를 가져온 다음, 다음과 같이 자산 및 문서를 업데이트해야 합니다. 마이그레이션 유틸리티 실행. Adobe은 마이그레이션 유틸리티를 실행한 후에만 새 설정에서 에셋을 만들 것을 권장합니다.
기한: 이전 버전과의 호환성 관련 crx-repository에 있는 몇 개의 폴더의 위치가 변경됩니다. 종속성(사용자 정의 라이브러리 및 에셋)을 이전 설정에서 새 환경으로 수동으로 내보내고 가져옵니다.
서신 관리 자산의 경우:
/content/apps/cm/layouts/fragmentlayouts/1001
끝 /content/apps/cm/modules/fragmentlayouts
. 에셋의 데이터 사전 참조는 이름 대신 데이터 사전의 경로를 표시합니다.에셋에서 를 변경하거나 에셋을 작성하기 전에 마이그레이션 유틸리티를 실행하십시오. Adobe은 변경 작업을 수행하거나 에셋을 작성한 후 유틸리티를 실행하지 않는 것을 권장합니다. 마이그레이션 프로세스가 실행되는 동안 서신 관리 또는 적응형 Forms Assets 사용자 인터페이스가 열리지 않도록 하십시오.
마이그레이션 유틸리티를 처음 실행하면 다음과 같은 경로와 이름으로 로그가 만들어집니다. \[aem-installation-directory]\cq-quickstart\logs\aem-forms-migration.log
. 이 로그는 서신 관리 및 적응형 Forms 마이그레이션 정보(예: 에셋 이동)로 계속 업데이트됩니다.
마이그레이션 유틸리티를 실행하기 전에 crx 저장소를 백업했는지 확인하십시오.
브라우저 세션에서 AEM 작성자 인스턴스에 관리자로 로그인합니다.
브라우저에서 다음 URL을 엽니다.
https://[호스트 이름]:[포트]/[context_path]/libs/fd/foundation/gui/content/migration.html
브라우저에는 네 가지 옵션이 표시됩니다.
마이그레이션을 수행하려면 다음을 수행하십시오.
마이그레이션하려면 assets, AEM Forms Assets 마이그레이션 을 탭하고 다음 화면에서 을 탭합니다. 마이그레이션 시작. 다음 항목이 마이그레이션됩니다.
에셋을 마이그레이션하는 동안 "다음에 대한 충돌 발견…"과 같은 경고 메시지가 표시될 수 있습니다. 이러한 메시지는 적응형 양식의 일부 구성 요소에 대한 규칙을 마이그레이션할 수 없음을 나타냅니다. 예를 들어, 구성 요소에 규칙과 스크립트가 모두 있는 이벤트가 있는 경우, 스크립트 후에 규칙이 발생하면 구성 요소에 대한 규칙 중 어느 것도 마이그레이션되지 않습니다. 다음을 수행할 수 있습니다. 규칙 편집기를 열어 이러한 규칙 마이그레이션 를 참조하십시오.
적응형 양식 사용자 지정 구성 요소를 마이그레이션하려면 다음을 누릅니다. 적응형 Forms 맞춤형 구성 요소 마이그레이션 그리고 사용자 지정 구성 요소 마이그레이션 페이지에서 을 누릅니다. 마이그레이션 시작. 다음 항목이 마이그레이션됩니다.
적응형 양식 템플릿을 마이그레이션하려면 다음을 누르십시오. 적응형 Forms 템플릿 마이그레이션 그리고 사용자 지정 구성 요소 마이그레이션 페이지에서 을 누릅니다. 마이그레이션 시작. 다음 항목이 마이그레이션됩니다.
/apps
또는 /conf
AEM 템플릿 편집기 사용.터치 지원 UI가 포함된 새로운 컨텍스트 인식 클라우드 서비스 패러다임을 사용하도록 AEM Forms 클라우드 구성 서비스를 마이그레이션합니다(아래) /conf
). AEM Forms 클라우드 구성 서비스를 마이그레이션할 때에서 클라우드 서비스 /etc
이동 위치: /conf
. 기존 경로를 사용하는 클라우드 서비스 사용자 지정이 없는 경우(/etc
), Adobe은 6.5로 업그레이드한 후 마이그레이션 유틸리티를 실행할 것을 권장합니다. 추가 작업에는 클라우드 구성 Touch UI를 사용하십시오. 기존 클라우드 서비스 사용자 정의가 있는 경우 마이그레이션된 경로에 맞게 사용자 정의가 업데이트될 때까지 업그레이드된 설정에서 클래식 UI를 계속 사용합니다(/conf
) 그런 다음 마이그레이션 유틸리티를 실행합니다.
마이그레이션하려면 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
마이그레이션 프로세스가 진행될 때 브라우저 창에 다음 항목이 표시됩니다.
마이그레이션 유틸리티는 실행 시 다음을 수행합니다.
마이그레이션 유틸리티 실행이 완료되면 하우스키핑 작업.
이러한 구성 요소는 적응형 Forms 편집기의 규칙 편집기에서 열어 마이그레이션할 수 있습니다.
사용자 지정 구성 요소에서 규칙 및 스크립트(6.3에서 업그레이드하는 경우 필요하지 않음)를 마이그레이션하려면 적응형 Forms 사용자 지정 구성 요소 마이그레이션 을 탭하고 다음 화면에서 마이그레이션 시작 을 탭합니다. 다음 항목이 마이그레이션됩니다.
규칙 편집기(6.1 FP1 이상)를 사용하여 생성된 규칙 및 스크립트
6.1 및 이전 버전의 UI에서 스크립트 탭을 사용하여 작성된 스크립트
템플릿을 마이그레이션하려면(6.3 및 6.4에서 업그레이드하는 경우 필요하지 않음) 적응형 Forms 템플릿 마이그레이션 을 탭하고 다음 화면에서 마이그레이션 시작 을 탭합니다. 다음 항목이 마이그레이션됩니다.
이전 템플릿 - AEM 6.1 Forms 또는 이전 버전을 사용하여 /apps에 생성된 적응형 양식 템플릿. 여기에는 템플릿 구성 요소에서 정의된 스크립트가 포함됩니다.
새 템플릿 - 아래의 템플릿 편집기를 사용하여 만든 적응형 양식 템플릿 /conf
. 여기에는 규칙 편집기를 사용하여 만든 규칙과 스크립트의 마이그레이션이 포함됩니다.
마이그레이션 유틸리티를 실행한 후 다음 하우스키핑 작업을 수행하십시오.
레이아웃 및 조각 레이아웃의 XFA 버전이 3.3 이상인지 확인합니다. 이전 버전의 레이아웃 및 단편 레이아웃을 사용하는 경우 편지 렌더링에 문제가 있을 수 있습니다. 이전 XFA 버전을 최신 버전으로 업데이트하려면 다음 단계를 완료하십시오.
마이그레이션 전에 이전 시스템에 게시된 모든 자산을 게시합니다. 마이그레이션 유틸리티는 작성자 인스턴스의 자산만 업데이트하며 게시 인스턴스의 자산을 업데이트하려면 자산을 게시해야 합니다.
AEM Forms 6.4 및 6.5에서 양식 사용자 그룹의 일부 권한이 변경되었습니다. 모든 사용자가 스크립트가 포함된 XDP 및 적응형 Forms을 업로드하거나 코드 편집기를 사용할 수 있도록 하려면 해당 사용자를 forms-power-users 그룹에 추가해야 합니다. 마찬가지로 템플릿 작성자는 더 이상 규칙 편집기에서 코드 편집기를 사용할 수 없습니다. 사용자가 코드 편집기를 사용할 수 있도록 하려면 af-template-script-writers 그룹에 추가합니다. 그룹에 사용자를 추가하는 방법에 대한 지침은 사용자 및 사용자 그룹 관리.