AEM Forms のカスタム関数

最終更新日： 2024年11月19日
  • 適用対象：
  • Experience Manager 6.5

作成対象：

  • 管理者
  • ユーザー
  • 開発者

はじめに

AEM Forms 6.5 では、ルールエディターを使用した複雑なビジネスルールの定義に使用できる JavaScript 関数を定義する機能が導入されました。AEM Formsでは、すぐに使用できる多数のカスタム関数が用意されていますが、独自のカスタム関数を定義して複数のフォームで使用する必要があります。

カスタム関数は、指定された要件を満たすためにエントリ済みデータの操作と処理を容易にすることで、フォームの機能を拡張します。また、定義済みの条件に基づいてフォームの動作を動的に変更することもできます。
アダプティブフォームでは、アダプティブフォームのルールエディター内でカスタム関数を使用して、フォームフィールドに特定の検証ルールを作成できます。
ユーザーがメールアドレスを入力し、入力したメールアドレスが特定の形式（「@」記号とドメイン名を含む）に従っていることを確認するカスタム関数の使用について説明します。メールアドレスを入力として受け取り、有効な場合は true を返し、そうでない場合は false を返すカスタム関数「ValidateEmail」を作成します。

function ValidateEmail(inputText)
{
    var email = /^\w+([\.-]?\w+)*@\w+([\.-]?\w+)*(\.\w{2,3})+$/;
    if(inputText.value.match(email))
        {
            alert("Valid email address!");
            return true;
        }
    else
    {
        alert("Invalid email address!");
        return false;
    }
}

上記の例では、ユーザーがフォームを送信しようとすると、カスタム関数「ValidateEmail」が呼び出され、入力したメールアドレスが有効かどうかが確認されます。

カスタム関数の使用

アダプティブフォームでカスタム関数を使用すると、次のようなメリットがあります。

  • データの操作：カスタム関数は、フォームフィールドに対するエントリ済みデータを操作および処理します。
  • データの検証：カスタム関数を使用すると、フォームの入力に対してカスタムチェックを実行し、指定したエラーメッセージを提供できます。
  • 動的な動作：カスタム関数を使用すると、特定の条件に基づいてフォームの動的な動作を制御できます。例えば、フィールドの表示／非表示、フィールド値の変更、フォームロジックの調整を動的に行うことができます。
  • 統合：カスタム関数を使用して、外部 API またはサービスと統合できます。外部ソースからのデータの取得、外部 Rest エンドポイントへのデータの送信、外部イベントに基づくカスタムアクションの実行に役立ちます。