1. Sitecore Formsのチュートリアル

チュートリアル: 既存の正規表現の検証に基づくカスタム検証コントロールの作成

Version:
日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

Webフォームの検証により、Webサイトの訪問者がWebフォームのフィールドに正しい値を入力することが保証されます。 カスタム検証を実装する ことも、既存の検証に基づいて新しい検証データを作成することもできます。このチュートリアルでは、既存の正規表現の検証に基づいて名前検証ツールを追加する方法について説明します。このバリデータは、1行のテキストフィールドの入力文字列に有効な名前があるかどうかを検証します。

次の手順に従って、正規表現の検証に基づいて任意のバリデーターを作成します。正規表現パターンを設定するだけで、要件に基づいて入力を検証できます。

検証アイテムを作成する

検証アイテムを作成するには:

  1. コンテンツ エディタで、/sitecore/System/Settings/Forms/Validationsに移動します。

  2. Validationsを右クリックし、Insert, Insert From Templateをクリックします。

  3. Insert from Templateダイアログボックスで、 /System/Formsに移動し、Validationテンプレートをクリックします。

    Insert from Template dialog box with Validation template selected

  4. Item NameフィールドにName Validationと入力し、Insertをクリックします。

  5. 作成したアイテムをコンテンツ ツリーで選択した状態で、Contentタブをクリックし、SettingsセクションのTypeフィールドで、値を既存の正規表現検証クラスの種類名 ( Sitecore.ExperienceForms.Mvc.Models.Validation.RegularExpressionValidation,Sitecore.ExperienceForms.Mvcなど) に設定します。

  6. Messageフィールドに、Contains an invalid nameなどのエラー メッセージを入力します。

  7. Parametersフィールドで、名前を検証するための正規表現パターンを設定します。

    {"regularExpression":"^[a-zA-Z]*$"}
    Name Validation item settings

  8. 変更を保存します。

フィールド タイプの変更

新しい検証を使用するには、フィールド タイプを変更する必要があります。この手順では、例として1行のフィールド タイプを使用します。

フィールドタイプを変更するには:

  1. /sitecore/System/Settings/Forms/Field Types/Basic/Single-line textに移動します。

  2. ContentタブのSettingsセクションのAllowed Validationsフィールドで、作成した新しい検証項目 (つまり、Name Validation) をダブルクリックして、Selectedリストに移動します。

  3. 変更を保存します。

メモ

同じ検証タイプに基づくバリデータは、フォーム デザイナーによってフィールド上で同時に有効にすることはできません。たとえば、Email validatorとPhone number validatorはどちらも正規表現の検証に基づいており、特定のフィールドで同時に有効にすることはできません。フォーム デザイナーによってフィールドで同じタイプの検証が有効になっないようにするには、同じタイプのバリデーターを許可された検証リストに追加しないことをお勧めします。

この記事を改善するための提案がある場合は、 お知らせください!