次の方法で共有


フォーム送信の検証をカスタマイズする

マーケティングおよびイベント登録フォームでのクライアント側の検証は、顧客から送信されたデータの有効性を確認するのに役立ちます。 ただし、場合によっては、より複雑な検証が必要になることがあります。 たとえば、送信されたデータと、システムに既に存在するデータを比較する必要がある場合があります。 この記事では、複雑な検証を容易にするために、バックエンドで送信されたデータを検証し、追加のデータ処理ロジックをトリガーするカスタム プラグインを構築する方法について詳しく説明します。

プラグインの作成

ヒント

このカスタムプラグインの例は、reCAPTCHAキーのバックエンド検証を構築する方法を示しています。 これは、検証フローのヒントとして役立ちます。 reCAPTCHAをフォームに統合する場合は、事前構築済みのプラグインを使用し、 このガイドに従ってください

プラグイン用の Visual Studio プロジェクトを作成する

  1. Visual Studio を開き、.NET Framework 4.6.2 を使用した新しいクラス ライブラリ プロジェクトを作成します。
  2. ソリューション エクスプローラー で、管理 NuGet パッケージ を選択して Microsoft.CrmSdk.CoreAssemblies をインストールします。

プラグイン クラスを作成する

  1. Class1.csCustomValidationPlugin.cs に名称変更します。

  2. CustomValidationPlugin クラスを IPlugin インターフェイスを継承させ、Execute メソッドを追加します。

    public class CustomValidationPlugin : IPlugin
    {
       public void Execute(IServiceProvider serviceProvider)
       {
    
       }
    }
    
  3. コンテキストとトレース サービスを取得するには、execute メソッドに次のコードを追加します。

    public void Execute(IServiceProvider serviceProvider)
    {
       // get tracing service
       ITracingService tracingService =
       (ITracingService)serviceProvider.GetService(typeof(ITracingService));
    
       // get plugin execution context
       IPluginExecutionContext context = (IPluginExecutionContext)
       serviceProvider.GetService(typeof(IPluginExecutionContext));
    }
    
  4. このコードを追加して、フォーム送信パラメーター文字列を取得します。 これは、ユーザーがフォームで送信したフィールドを表す JSON エンコード文字列です。 このプロセスでは、文字列を取得し、後で定義する逆シリアル化ヘルパー メソッドと FormSubmissionRequest クラスを使用して逆シリアル化します。 このコードは、fields 配列に g-recaptcha-response のキーが含まれていることを確認します。 reCAPTCHA キーが見つからない場合は、処理中のフォームに recaptcha 要素が含まれていなかったため、検証をスキップして返されます。

    var requestString = (string)context.InputParameters["msdynmkt_formsubmissionrequest"];
    var requestObject = Deserialize<FormSubmissionRequest>(requestString);
    if (!requestObject.Fields.TryGetValue("g-recaptcha-response", out string recaptchaToken))
    {
       tracingService.Trace("g-recaptcha-response was not present in form submission");
       return;
    }
    
  5. g-recaptcha-token の値が null または空の場合、次のコードを返すように追加します。

    if (String.IsNullOrEmpty(recaptchaToken))
    {
       tracingService.Trace($"g-recaptcha-response value not found");
       return;
    }
    
  6. 次のコードを追加して、Google API に対して Google キャプチャ トークンを検証します。

    string url = "https://www.google.com/recaptcha/api/siteverify";
    using (HttpClient client = new HttpClient())
    {
       var content = new FormUrlEncodedContent(new Dictionary<string, string>
       {
          {"secret", "your_secret_key"},
          {"response", recaptchaToken}
       });
    
       try
       {
          var response = client.PostAsync(url, content).Result;
          if (!response.IsSuccessStatusCode)
          {
             tracingService.Trace($"Request Failed: ({response.StatusCode}){response.Content}");
             return;
          }
    
          var responseString = response.Content.ReadAsStringAsync().Result;
    
          gRecaptchaResponse = Deserialize<GRecaptchaResponse>(responseString);
    
          var resp = new ValidateFormSubmissionResponse()
          {
             IsValid = isValid,
             ValidationOnlyFields = new List<string>() { "g-recaptcha-response" }
          };
          context.OutputParameters["msdynmkt_validationresponse"] = Serialize(resp);
        }
        catch (Exception e)
        {
           tracingService.Trace($"{e.Message}");
        }
    }
    

    最初に URL が定義され、次に HttpClient のインスタンスが作成されます。 前の手順で取得した FormUrlEncodedContent と、Google から提供された秘密鍵を含む recaptchaToken オブジェクトが作成されます。 次に POST リクエストが送信され、ステータス コードがチェックされ、成功しなかった場合は返されます。 成功した場合は、後で定義される逆シリアル化 ヘルパー メソッドと GRecaptchaResponse を使用して、応答を逆シリアル化します。 次に、新しい ValidateFormSubmissionResponse オブジェクトを作成し、それをシリアル化して、出力パラメータ msdynmkt_validationresponse の値として設定します。これは、投稿を受け入れるか拒否するかを決定するために使用する Microsoft サービスの 1 つです。 g-recaptcha-response 文字列を ValidationOnlyFields リストに追加すると、ユーザー インターフェイスのフォーム送信でこのフィールドが非表示になります。

  7. 次のコードを追加して、シリアル化および逆シリアル化ヘルパー メソッドを定義します。

    private T Deserialize<T>(string jsonString)
    {
       serializer = new DataContractJsonSerializer(typeof(T));
       T result;
       using (MemoryStream stream = new MemoryStream(Encoding.UTF8.GetBytes(jsonString)))
       {
          result = (T)serializer.ReadObject(stream);
       }
       return result;
    }
    
    private string Serialize<T>(T obj)
    {
        string result;
        serializer = new DataContractJsonSerializer(typeof(T));
        using (MemoryStream memoryStream = new MemoryStream())
        {
           serializer.WriteObject(memoryStream, obj);
           result = Encoding.Default.GetString(memoryStream.ToArray());
        }
        return result;
    }
    
  8. 次のコードを追加して、JSON 文字列オブジェクトのシリアル化と逆シリアル化に必要なクラスを定義します。

    public class FormSubmissionRequest
     {
         public Dictionary<string, string> Fields { get; set; }
     }
    
     public class GRecaptchaResponse
     {
         public bool success { get; set; }
     }
    
     public class ValidateFormSubmissionResponse
     {
         public bool IsValid { get; set; }
         public List<string> ValidationOnlyFields { get; set; }
     }
    

プラグインの署名とビルド

  1. プロジェクト上で右クリックし、ソリューション エクスプローラープロパティ を選択します。
  2. 署名 タブで、アセンブリに署名する チェック ボックスを選択します。
  3. <New...> を選択します。
  4. キー ファイル名を入力し、キー ファイルをパスワードで保護する の選択を解除します。
  5. プロジェクトをビルドします。
  6. プラグイン アセンブリ CustomValidationPlugin.dll は、\bin\Debug にあります。

プラグインの登録

  1. PluginRegistration.exe を開きます。
  2. 新しいつながりの作成 を選択します。
  3. Office 365 を選択します。
  4. ログインを選択します。
  5. 登録を選択して、新しいアセンブリの登録 を選択します。 登録を選択して、新しいアセンブリの登録 を選択します。
  6. 手順 1 で (...) ボタンを選択し、前の手順でビルドした dll を選択します。
  7. 選択したプラグインの登録 を選択します。

ステップの登録

  1. 登録されたアセンブリの一覧から、CustomValidationPlugin を選択します。
  2. 新しい手順を登録する を選択します。
  3. メッセージ・テキスト・フィールドに msdynmkt_validateformsubmission を入力します。
  4. 実行モード同期 に設定されていることを確認してください。 実行モード が 同期 に設定されていることを確認してください。
  5. 実行順序10 に設定されていることを確認してください。
  6. 実行のイベント パイプライン ステージオペレーション後 に設定されていることを確認してください。
  7. 新しい手順を登録する を選択します。

結論

data-validate-submission 属性を持つフォームが送信されると、カスタム プラグインが実行され、Google サービスで reCAPTCHA レスポンスが検証されます。 カスタムプラグインは、デフォルトの Microsoft 検証プラグインの後に実行されます。 フォームに Microsoft キャプチャ フィールドがない場合、Microsoft プラグインは IsValid:false を設定し、IsValid:true で上書きしない限り、送信は失敗します。

検証のフロー。