설명서AEM as a Cloud Service사용 안내서

적응형 Forms 핵심 구성 요소 확인 및 활성화 enable-headless-adaptive-forms-on-aem-forms-cloud-service

Last update: Wed Aug 27 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 적용 대상:
  • Experience Manager as a Cloud Service

작성 대상:

  • 관리자
  • 개발자
  • 사용자
버전
문서 링크
AEM 6.5
여기 클릭
AEM as a Cloud Service
이 문서

적응형 Forms 핵심 구성 요소 및 Headless 적응형 Forms은 대부분의 AEM Forms as a Cloud Service 고객에 대해 이미 활성화되어 있습니다. 이렇게 하면 AEM Forms Cloud Service 인스턴스를 사용하여 핵심 구성 요소 기반 적응형 Forms 및 Headless Forms을 만들고 게시하고 여러 채널에 전달할 수 있습니다.

적응형 Forms 핵심 구성 요소가 활성화되었는지 확인 check-if-enabled

활성화 단계를 수행하기 전에 적응형 Forms 핵심 구성 요소가 환경에 대해 이미 활성화되어 있는지 확인하십시오.

새로운 AEM Forms as a Cloud Service 프로그램의 경우

새로운 AEM Forms as a Cloud Service 프로그램을 만들 때 적응형 Forms 핵심 구성 요소 및 Headless 적응형 Forms이 이미 귀하의 환경에 대해 활성화되어 있습니다.

기존 Cloud Service 환경의 경우

기존 Cloud Service 환경에서 핵심 구성 요소 기반 적응형 Forms을 만들기 옵션을 제공하는 경우 적응형 Forms 핵심 구성 요소 및 Headless 적응형 Forms이 이미 해당 환경에 대해 활성화되어 있습니다.

저장소를 확인하여 확인

적응형 Forms 핵심 구성 요소가 환경에 대해 활성화되어 있는지 확인하려면 다음을 수행하십시오.

  1. AEM Forms as a Cloud Service 저장소를 복제합니다.

  2. [AEM Repository Folder]/all/pom.xml AEM Forms Cloud Service Git 저장소 파일을 엽니다.

  3. 다음 종속성을 검색합니다.

    • 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

    all/pom.xml에서 core-forms-components-af-core 아티팩트 찾기

    이러한 종속성이 있는 경우 환경에 대해 적응형 Forms 핵심 구성 요소가 활성화됩니다.

수동 활성화가 필요한 경우 when-manual-enablement-needed

핵심 구성 요소가 활성화되지 않은(위의 확인에 의해 확인된) 이전 Forms as a Cloud Service 프로그램이 있는 경우에만 적응형 Forms 핵심 구성 요소 종속성을 AEM as a Cloud Service 저장소에 수동으로 추가하고 저장소를 Cloud Service 환경에 배포해야 합니다.

수동 지원 단계
note warning
WARNING
위의 확인 결과, 적응형 Forms 핵심 구성 요소가 환경에 대해 활성화되지 않은 경우 이 단계만 수행합니다.

AEM Forms as a Cloud Service 환경을 위한 적응형 Forms 핵심 구성 요소 및 Headless 적응형 Forms을 활성화하려면 나열된 순서로 다음 단계를 수행하십시오.

핵심 구성 요소 및 Headless 적응형 양식 사용

​1. AEM Forms as a Cloud Service Git 저장소 복제 clone-git-repository

  1. Cloud Manager에 로그인하고 조직과 프로그램을 선택합니다.

  2. 프로그램 개요 페이지에서 파이프라인 카드로 이동한 다음 저장소 정보 액세스 버튼을 클릭하여 Git 저장소에 액세스하고 관리합니다. 페이지에는 다음 정보가 포함됩니다.

    • Cloud Manager Git 저장소의 URL.
    • Git 저장소(사용자 이름 및 암호) 및 Git 사용자 이름의 자격 증명입니다.

    암호 생성 ​을 클릭하여 암호를 보거나 생성합니다.

  3. 로컬 컴퓨터에서 터미널 또는 명령 프롬프트를 열고 다음 명령을 실행합니다.

    code language-shell 
    git clone [Git Repository URL]

    메시지가 표시되면 자격 증명을 제공합니다. 저장소를 로컬 컴퓨터에 복제합니다.

​2. Git 저장소에 적응형 양식 핵심 구성 요소 종속성 추가 add-adaptive-forms-core-components-dependencies

  1. 일반 텍스트 코드 편집기에서 Git 저장소 폴더를 엽니다. 예: VS 코드.

  2. 편집할 [AEM Repository Folder]\pom.xml 페이지를 엽니다.

  3. core.forms.components.version, core.forms.components.af.version 및 core.wcm.components.version 구성 요소의 버전을 핵심 구성 요소 설명서에 지정된 버전으로 바꿉니다. 구성 요소가 없으면 이러한 구성 요소를 추가합니다.

    code language-xml 
    <!-- 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>

    최신 버전의 양식 핵심 구성 요소 멘션

  4. [AEM Repository Folder]\pom.xml 파일의 종속성 섹션에서 다음 종속성을 추가하고 파일을 저장합니다.

    code language-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 -->

  5. 편집할 [AEM Repository Folder]/all/pom.xml 페이지를 엽니다. <embeddeds> 섹션에서 다음 종속성을 추가하고 파일을 저장합니다.

    code language-xml 
    <!-- 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 note
    NOTE
    ${appId}를 appId로 바꿉니다.
    [AEM Repository Folder]/all/pom.xml 파일에서 ${appId}를 찾으려면 -packages/application/install 용어를 검색합니다. -packages/application/install 용어 앞의 텍스트는 ${appId}입니다. 예: 다음 코드 myheadlessform은 ${appId}입니다.
    code language-none 
    



com.myheadlessform

myheadlessform.ui.apps

zip

/apps/myheadlessform-packages/application install

  6. [AEM Repository Folder]/all/pom.xml 파일의 <dependencies> 섹션에서 다음 종속성을 추가하고 파일을 저장합니다.

    code language-xml 
            <!-- 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>

  7. 편집할 [AEM Repository Folder]/ui.apps/pom.xml을 엽니다. af-core bundle 종속성을 추가하고 파일을 저장합니다.

    code language-xml 
        <dependency>
    <groupId>com.adobe.aem</groupId>
    <artifactId>core-forms-components-af-core</artifactId>
    </dependency>
    note note
    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>

  8. 파일을 저장하고 닫습니다.

​3. 업데이트된 코드 빌드 및 배포

업데이트된 코드를 로컬 개발 및 Cloud Service 환경에 배포하여 두 환경 모두에서 핵심 구성 요소를 활성화합니다.

로컬 개발 환경에서 업데이트된 코드 빌드 및 배포 core-components-on-aem-forms-local-sdk

  1. 명령 프롬프트 또는 터미널을 엽니다.

  2. Git 저장소 프로젝트의 루트 디렉터리로 이동합니다.

  3. 다음 명령을 실행하여 환경에 맞는 패키지를 빌드합니다.

    code language-shell 
        mvn clean install

    패키지가 정상적으로 빌드되면 [Git 저장소 폴더]\all\target[appid].all-[version].zip에서 찾을 수 있습니다.

  4. 패키지 관리자를 사용하여 로컬 개발 환경에서 [AEM Archetype 프로젝트 폴더]\all\target[appid].all-[version].zip 패키지를 배포합니다.

AEM Forms as a Cloud Service 환경에서 업데이트된 코드 빌드 및 배포 core-components-on-aem-forms-cs

  1. 터미널 또는 명령 프롬프트를 엽니다.

  2. [AEM Repository Folder]로 이동하고 나열된 순서대로 다음 명령을 실행합니다.

    code language-shell 
     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

  3. 파일이 Git 저장소에 커밋되면 파이프라인을 실행합니다.

    파이프라인 실행이 성공하면 해당 환경에 맞는 적응형 양식 핵심 구성 요소가 활성화됩니다. 또한 적응형 양식(핵심 구성 요소) 템플릿 및 Canvas 3.0 테마가 Forms as a Cloud Service 환경에 추가되면 핵심 구성 요소 기반 적응형 양식을 사용자 정의하고 만들 수 있는 옵션이 제공됩니다.

자주 묻는 질문 faq

핵심 구성 요소란 무엇입니까? core-components

핵심 구성 요소는 AEM에서 개발 시간을 가속화고 웹 사이트의 유지 관리 비용을 절감할 수 있는 표준화된 웹 콘텐츠 관리(WCM) 구성 요소입니다.

핵심 구성 요소를 활성화하는 경우 추가되는 모든 기능은 무엇입니까? core-components-capabilities

내 환경에 맞는 적응형 양식 핵심 구성 요소가 활성화되면 빈 핵심 구성 요소 기반 적응형 양식 템플릿 및 Canvas 3.0 테마가 해당 환경에 추가됩니다. 내 환경에 맞는 적응형 양식 핵심 구성 요소가 활성화되면 다음과 같은 작업을 수행할 수 있습니다.

적응형 Forms 핵심 구성 요소를 수동으로 활성화해야 하는지 어떻게 알 수 있습니까? manual-enablement-needed-faq

대부분의 고객은 이미 적응형 Forms 핵심 구성 요소를 활성화했습니다. 다음 경우에만 수동으로 활성화하면 됩니다.

  1. 핵심 구성 요소가 자동으로 포함되기 전에 생성된 이전 Forms as a Cloud Service 프로그램이 있습니다
  2. 적응형 Forms 핵심 구성 요소가 활성화되어 있는지 확인 섹션에서 확인 검사를 통해 필요한 종속성이 저장소에서 누락되었음을 확인합니다

확실하지 않은 경우 위의 적응형 Forms 핵심 구성 요소가 활성화되었는지 확인 섹션의 확인 단계를 따르십시오.

프로젝트에서 핵심 구성 요소 기반 양식을 렌더링하지 못하는 이유는 무엇입니까?

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과 함께 번들로 제공됩니다.
Related Articles
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab