アダプティブフォームコアコンポーネントを確認および有効にする enable-headless-adaptive-forms-on-aem-forms-cloud-service

バージョン
記事リンク
AEM 6.5
ここをクリックしてください
AEM as a Cloud Service
この記事

アダプティブフォームコアコンポーネントとヘッドレスアダプティブフォームは、ほとんどの AEM Forms as a Cloud Service のお客様に対して既に有効になっています。これにより、AEM Forms Cloud Service インスタンスを使用して、コアコンポーネントベースのアダプティブフォームとヘッドレスフォームを複数のチャネルに作成、公開、配信できます。

アダプティブフォームコアコンポーネントが有効になっているかどうかを確認する check-if-enabled

イネーブルメント手順に従う前に、お使いの環境でアダプティブフォームコアコンポーネントが既になっているかどうかを確認します。

新しい AEM Forms as a Cloud Service プログラムの場合

新しい AEM Forms as a Cloud Service プログラムを作成すると、アダプティブフォームコアコンポーネントとヘッドレスアダプティブフォームが、お使いの環境で既に有効になっています。

既存の Cloud Service 環境の場合

既存の Cloud Service 環境で、コアコンポーネントベースのアダプティブフォームを作成するオプションが提供されている場合は、アダプティブフォームコアコンポーネントとヘッドレスアダプティブフォームがお使いの環境で既に有効になっています。

リポジトリを確認して検証

お使いの環境でアダプティブフォームのコアコンポーネントが有効になっていることを確認するには:

  1. AEM Forms as a Cloud Service リポジトリを複製します。

  2. AEM Forms Cloud Service Git リポジトリの [AEM Repository Folder]/all/pom.xml ファイルを開きます。

  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 アーティファクトを見つけます

    これらの依存関係が存在する場合、お使いの環境でアダプティブフォームのコアコンポーネントが有効になります。

手動でのイネーブルメントが必要な場合 when-manual-enablement-needed

コアコンポーネントが有効になっていない古い Forms as a Cloud Service プログラムがある場合にのみ(上記の確認で確認済み)、アダプティブフォームコアコンポーネントの依存関係を AEM as a Cloud Service リポジトリに手動で追加し、リポジトリを Cloud Service 環境にデプロイする必要があります。

手動イネーブルメント手順
note warning
WARNING
上記の検証の確認で、アダプティブフォームコアコンポーネントがお使いの環境で有効になっていないことが確認された場合にのみ、次の手順に従います。

AEM Forms as a Cloud Service 環境でアダプティブフォームコアコンポーネントとヘッドレスアダプティブフォームを有効にするには、以下の手順をリスト順に実行します。

コアコンポーネントとヘッドレスアダプティブフォームの有効化

​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 Code。

  2. [AEM Repository Folder]\pom.xml ファイルを編集用に開きます。

  3. core.forms.components.versioncore.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 に置き換えます。
    ${appId} を見つけるには、[AEM Repository Folder]/all/pom.xml ファイル内で -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 アーキタイププロジェクトフォルダー(]\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 で web サイトの開発時間を短縮しメンテナンスコストを削減するための、標準化された web コンテンツ管理(WCM)コンポーネントのセットです。

コアコンポーネントの有効化に関しては、どのような機能が追加されますか? core-components-capabilities

お使いの環境でアダプティブフォームのコアコンポーネントを有効にすると、空白のコアコンポーネントベースのアダプティブフォームテンプレートと Canvas 3.0 テーマが環境に追加されます。お使いの環境でアダプティブフォームのコアコンポーネントを有効にすると、次の操作を実行できます。

アダプティブフォームコアコンポーネントを手動で有効にする必要があるかどうかを知るには、どうすればよいですか? manual-enablement-needed-faq

ほとんどのお客様は、アダプティブフォームコアコンポーネントが既に有効になっています。 次の場合にのみ手動で有効にする必要があります。

  1. コアコンポーネントが自動的に含まれる前に作成した、古い Forms as a Cloud Service プログラムがある
  2. アダプティブフォームコアコンポーネントが有効になっているかどうかを確認するの節の検証の確認では、必要な依存関係がリポジトリにないことが確認される

不明な場合は、上記のアダプティブフォームコアコンポーネントが有効になっているかどうかを確認するの節の検証手順に従ってください。

プロジェクトでコアコンポーネントベースのフォームがレンダリングされないのはなぜですか?

コアコンポーネントベースのフォームは、Forms コアコンポーネントパッケージとプロジェクトアーキタイプに含まれるバージョン間のバージョン不一致が原因でレンダリングに失敗する場合があります。この問題は、通常、プロジェクトアーキタイプで指定されたバージョンが、Forms コアコンポーネントパッケージにバンドルされているバージョン以降である場合に発生します。この問題を解決するには、次のいずれかの操作を行います。

  • プロジェクトアーキタイプでは、Forms コアコンポーネントパッケージの下位バージョンを使用します。
  • 必要なバージョンが既に Forms に含まれているので、AEM as a Cloud Service コアコンポーネントの依存関係をプロジェクトアーキタイプから削除します。Forms コアコンポーネントパッケージは、リリース 20133 以降の AEM as a Cloud SDK にバンドルされています(例:AEM SDK v2025.3.20133.20250325T063357Z-250300)。
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab