적응형 양식 핵심 구성 요소 활성화
- 적용 대상:
- Experience Manager as a Cloud Service
작성 대상:
- 관리자
- 개발자
- 사용자
버전 | 문서 링크 |
---|---|
AEM 6.5 | 여기 클릭 |
AEM as a Cloud Service | 이 문서 |
AEM Forms as a Cloud Service에서 적응형 Forms 핵심 구성 요소를 활성화하면 AEM Forms Cloud Service 인스턴스를 사용하여 적응형 Forms 및 Headless Forms 기반의 핵심 구성 요소를 만들고, 게시하고, 여러 채널에 전달할 수 있습니다. Headless Adaptive Forms를 사용하려면 적응형 양식 핵심 구성 요소 활성화 환경이 필요합니다.
고려 사항
-
새로운 AEM Forms as a Cloud Service 프로그램을 만들 때 내 환경에 맞는 적응형 양식 핵심 구성 요소 및 Headless 적응형 양식이 이미 활성화되어 있습니다.
-
핵심 구성 요소가 임베드되지 않은 이전 Forms as a Cloud Service 프로그램이 있는 경우 AEM as a Cloud Service 저장소에 적응형 양식 핵심 구성 요소 종속성을 추가하고 Cloud Service 환경에 저장소를 배포하여 Headless 적응형 양식을 활성화할 수 있습니다.
-
기존 Cloud Service 환경에서 핵심 구성 요소 기반 적응형 Forms을 만들 수 있는 옵션을 제공하는 경우 적응형 Forms 핵심 구성 요소 및 Headless 적응형 Forms은 이미 해당 환경에 대해 활성화되어 있으며, 적응형 Forms의 Headless 표현이 필요한 모바일, 웹, 기본 앱 및 서비스와 같은 채널에 Headless 양식으로 핵심 구성 요소 기반 적응형 Forms을 제공할 수 있습니다.
적응형 양식 핵심 구성 요소 및 Headless 적응형 양식 활성화
AEM Forms as a Cloud Service 환경에 맞게 적응형 양식 핵심 구성 요소와 Headless 적응형 양식을 활성화하려면 나열된 순서대로 다음 단계를 수행하십시오.
1. AEM Forms as a Cloud Service Git 저장소 복제
-
Cloud Manager에 로그인하고 조직과 프로그램을 선택합니다.
-
프로그램 개요 페이지에서 파이프라인 카드로 이동한 다음 저장소 정보 액세스 버튼을 클릭하여 Git 저장소에 액세스하고 관리합니다. 페이지에는 다음 정보가 포함됩니다.
- Cloud Manager Git 저장소의 URL.
- Git 저장소(사용자 이름 및 암호) 및 Git 사용자 이름의 자격 증명입니다.
암호 생성 을 클릭하여 암호를 보거나 생성합니다.
-
로컬 컴퓨터에서 터미널 또는 명령 프롬프트를 열고 다음 명령을 실행합니다.
git clone [Git Repository URL]
메시지가 표시되면 자격 증명을 제공합니다. 저장소를 로컬 컴퓨터에 복제합니다.
2. Git 저장소에 적응형 양식 핵심 구성 요소 종속성 추가
-
일반 텍스트 코드 편집기에서 Git 저장소 폴더를 엽니다. 예: VS 코드.
-
편집할
[AEM Repository Folder]\pom.xml
페이지를 엽니다. -
core.forms.components.version
,core.forms.components.af.version
및core.wcm.components.version
구성 요소의 버전을 핵심 구성 요소 설명서에 지정된 버전으로 바꿉니다. 구성 요소가 없으면 이러한 구성 요소를 추가합니다.<!-- Replace the version with the latest released version at https://github.com/adobe/aem-core-forms-components/tags --> <properties> <core.wcm.components.version>2.22.10</core.wcm.components.version> <core.forms.components.version>2.0.18</core.forms.components.version> <core.forms.components.af.version>2.0.18</core.forms.components.af.version> </properties>
-
[AEM Repository Folder]\pom.xml
파일의 종속성 섹션에서 다음 종속성을 추가하고 파일을 저장합니다.<!-- WCM Core Component Examples Dependencies --> <dependency> <groupId>com.adobe.cq</groupId> <artifactId>core.wcm.components.examples.ui.apps</artifactId> <type>zip</type> <version>${core.wcm.components.version}</version> </dependency> <dependency> <groupId>com.adobe.cq</groupId> <artifactId>core.wcm.components.examples.ui.content</artifactId> <type>zip</type> <version>${core.wcm.components.version}</version> </dependency> <dependency> <groupId>com.adobe.cq</groupId> <artifactId>core.wcm.components.examples.ui.config</artifactId> <version>${core.wcm.components.version}</version> <type>zip</type> </dependency> <!-- End of WCM Core Component Examples Dependencies --> <!-- Forms Core Component Dependencies --> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-core</artifactId> <version>${core.forms.components.version}</version> </dependency> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-apps</artifactId> <version>${core.forms.components.version}</version> <type>zip</type> </dependency> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-af-core</artifactId> <version>${core.forms.components.version}</version> </dependency> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-af-apps</artifactId> <version>${core.forms.components.version}</version> <type>zip</type> </dependency> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-examples-apps</artifactId> <type>zip</type> <version>${core.forms.components.version}</version> </dependency> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-examples-content</artifactId> <type>zip</type> <version>${core.forms.components.version}</version> </dependency> <!-- End of AEM Forms Core Component Dependencies -->
-
편집할
[AEM Repository Folder]/all/pom.xml
페이지를 엽니다.<embeddeds>
섹션에서 다음 종속성을 추가하고 파일을 저장합니다.<!-- WCM Core Component Examples Dependencies --> <!-- inside plugin config of filevault-package-maven-plugin --> <!-- embed wcm core components examples artifacts --> <embedded> <groupId>com.adobe.cq</groupId> <artifactId>core.wcm.components.examples.ui.apps</artifactId> <type>zip</type> <target>/apps/${appId}-vendor-packages/content/install</target> </embedded> <embedded> <groupId>com.adobe.cq</groupId> <artifactId>core.wcm.components.examples.ui.content</artifactId> <type>zip</type> <target>/apps/${appId}-vendor-packages/content/install</target> </embedded> <embedded> <groupId>com.adobe.cq</groupId> <artifactId>core.wcm.components.examples.ui.config</artifactId> <type>zip</type> <target>/apps/${appId}-vendor-packages/content/install</target> </embedded> <!-- embed forms core components artifacts --> <embedded> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-af-apps</artifactId> <type>zip</type> <target>/apps/${appId}-vendor-packages/application/install</target> </embedded> <embedded> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-af-core</artifactId> <target>/apps/${appId}-vendor-packages/application/install</target> </embedded> <embedded> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-examples-apps</artifactId> <type>zip</type> <target>/apps/${appId}-vendor-packages/content/install</target> </embedded> <embedded> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-examples-content</artifactId> <type>zip</type> <target>/apps/${appId}-vendor-packages/content/install</target> </embedded>
NOTE
${appId}
를 appId로 바꿉니다.[AEM Repository Folder]/all/pom.xml
파일에서${appId}
를 찾으려면-packages/application/install
용어를 검색합니다.-packages/application/install
용어 앞의 텍스트는${appId}
입니다. 예: 다음 코드myheadlessform
은${appId}
입니다.com.myheadlessform myheadlessform.ui.apps zip /apps/myheadlessform-packages/application install
-
[AEM Repository Folder]/all/pom.xml
파일의<dependencies>
섹션에서 다음 종속성을 추가하고 파일을 저장합니다.<!-- Other existing dependencies --> <!-- wcm core components examples dependencies --> <dependency> <groupId>com.adobe.cq</groupId> <artifactId>core.wcm.components.examples.ui.apps</artifactId> <type>zip</type> </dependency> <dependency> <groupId>com.adobe.cq</groupId> <artifactId>core.wcm.components.examples.ui.config</artifactId> <type>zip</type> </dependency> <dependency> <groupId>com.adobe.cq</groupId> <artifactId>core.wcm.components.examples.ui.content</artifactId> <type>zip</type> </dependency> <!-- forms core components dependencies --> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-af-apps</artifactId> <type>zip</type> </dependency> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-examples-apps</artifactId> <type>zip</type> </dependency> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-examples-content</artifactId> <type>zip</type> </dependency>
-
편집할
[AEM Repository Folder]/ui.apps/pom.xml
을 엽니다.af-core bundle
종속성을 추가하고 파일을 저장합니다.<dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-af-core</artifactId> </dependency>
NOTE
다음 적응형 양식 핵심 구성 요소 아티팩트가 프로젝트에 포함되지 않았는지 확인합니다.<dependency>
<groupId>com.adobe.aem</groupId>
<artifactId>core-forms-components-apps</artifactId>
</dependency>
및<dependency>
<groupId>com.adobe.aem</groupId>
<artifactId>core-forms-components-core</artifactId>
</dependency>
-
파일을 저장하고 닫습니다.
3. 업데이트된 코드 빌드 및 배포
업데이트된 코드를 로컬 개발 및 Cloud Service 환경에 배포하여 두 환경 모두에서 핵심 구성 요소를 활성화합니다.
로컬 개발 환경에서 업데이트된 코드 빌드 및 배포
-
명령 프롬프트 또는 터미널을 엽니다.
-
Git 저장소 프로젝트의 루트 디렉터리로 이동합니다.
-
다음 명령을 실행하여 환경에 맞는 패키지를 빌드합니다.
mvn clean install
패키지가 정상적으로 빌드되면 [Git 저장소 폴더]\all\target[appid].all-[version].zip에서 찾을 수 있습니다.
-
패키지 관리자를 사용하여 로컬 개발 환경에서 [AEM Archetype 프로젝트 폴더]\all\target[appid].all-[version].zip 패키지를 배포합니다.
AEM Forms as a Cloud Service 환경에서 업데이트된 코드 빌드 및 배포
-
터미널 또는 명령 프롬프트를 엽니다.
-
[AEM Repository Folder]
로 이동하고 나열된 순서대로 다음 명령을 실행합니다.git add pom.xml git add all/pom.xml git add ui.apps/pom.xml git commit -m "Added dependencies for Adaptive Forms Core Components" git push origin
-
파일이 Git 저장소에 커밋되면 파이프라인을 실행합니다.
파이프라인 실행이 성공하면 해당 환경에 맞는 적응형 양식 핵심 구성 요소가 활성화됩니다. 또한 적응형 양식(핵심 구성 요소) 템플릿 및 Canvas 3.0 테마가 Forms as a Cloud Service 환경에 추가되면 핵심 구성 요소 기반 적응형 양식을 사용자 정의하고 만들 수 있는 옵션이 제공됩니다.
자주 묻는 질문
핵심 구성 요소란 무엇입니까?
핵심 구성 요소는 AEM에서 개발 시간을 가속화고 웹 사이트의 유지 관리 비용을 절감할 수 있는 표준화된 웹 콘텐츠 관리(WCM) 구성 요소입니다.
핵심 구성 요소를 활성화하는 경우 추가되는 모든 기능은 무엇입니까?
내 환경에 맞는 적응형 양식 핵심 구성 요소가 활성화되면 빈 핵심 구성 요소 기반 적응형 양식 템플릿 및 Canvas 3.0 테마가 해당 환경에 추가됩니다. 내 환경에 맞는 적응형 양식 핵심 구성 요소가 활성화되면 다음과 같은 작업을 수행할 수 있습니다.
내 환경에 맞는 적응형 양식 핵심 구성 요소가 활성화되어 있습니까?
내 환경에 맞는 적응형 양식 핵심 구성 요소가 활성화되어 있는지 확인하려면:
-
[AEM Repository Folder]/all/pom.xml
AEM Forms Cloud Service Git 저장소 파일을 엽니다. -
다음 종속성을 검색합니다.
- core-forms-components-af-core
- core-forms-components-core
- core-forms-components-apps
- core-forms-components-af-apps
- core-forms-components-examples-apps
- core-forms-components-examples-content
종속성이 있는 경우 내 환경에 맞는 적응형 양식 핵심 구성 요소가 활성화됩니다.
프로젝트에서 핵심 구성 요소 기반 양식을 렌더링하지 못하는 이유는 무엇입니까?
Forms 핵심 구성 요소 패키지와 Project Archetype에 포함된 버전 간의 버전 불일치로 인해 핵심 구성 요소 기반 양식이 렌더링되지 않을 수 있습니다. 이 문제는 일반적으로 Project Archetype에 지정된 버전이 Forms 핵심 구성 요소 패키지와 함께 번들로 제공되는 버전보다 높거나 같을 때 발생합니다. 이 문제를 해결하려면 다음 중 하나를 수행합니다.
- Project Archetype에서 더 낮은 버전의 Forms 핵심 구성 요소 패키지를 사용합니다.
- 필요한 버전이 Forms에 이미 포함되어 있으므로 Project Archetype에서 AEM as a Cloud Service 핵심 구성 요소 종속성을 제거합니다. Forms 핵심 구성 요소 패키지는 릴리스 20133(예:
AEM SDK v2025.3.20133.20250325T063357Z-250300
)부터 AEM as a Cloud SDK과 함께 번들로 제공됩니다.