Utiliser les actions pour valider et stocker les données de l’utilisateur final recueillies par les personnalisations de l’invite d’inscription (1)

Vous pouvez utiliser la Personnalisation de l’invite d’inscription avec le déclencheur pre-user-registration pour ajouter les données fournies par l’utilisateur final (comme le numéro de téléphone ou l’emplacement d’un utilisateur) de l’invite d’inscription à user_metadata. En option, vous pouvez valider ces données et afficher une erreur de validation dans l’invite.

• Le locataire a un Domaine personnalisé vérifié

• Le locataire a un Modèle de page défini

Utilisez la Management API pour insérer un champ personnalisé dans une invite à l’aide de l’un des Points d’entrée. Cet exemple ajoute le contenu suivant au point d’insertion ulp-container-form-content-start :

<div class="ulp-field">
  <label for="first-name">First Name</label>
  <input type="text" name="ulp-first-name" id="first-name">
</div>

Le résultat est une section First Name (Prénom) dans l’invite d’inscription :

Vous pouvez créer une action d’inscription personnalisée en allant sur Actions > Library (Bibliothèque) > Build Custom (Créer une action personnalisée).

Dans l’éditeur de code, mettez à jour le gestionnaire onExecutePreUserRegistration :

exports.onExecutePreUserRegistration = async (event, api) => {
  const firstName = event.request.body['ulp-first-name'];
  api.user.setUserMetadata("firstName", firstName);
};

En option, vous pouvez valider l’entrée de l’utilisateur et envoyer une erreur de validation en appelant la méthode api.validation.error, puis déployer l’action :

exports.onExecutePreUserRegistration = async (event, api) => {
  const firstName = event.request.body['ulp-first-name'];
  if(!firstName) {
    api.validation.error("invalid_payload", "Missing first name");
    return;
  }

  api.user.setUserMetadata("firstName", firstName);
};

Naviguez vers Actions > Flows (Flux) > Pre User Registration (Pré-enregistrement de l’utilisateur) > Add Action (Ajouter une action) > Custom (Personnalisée), puis faites glisser et déposez votre nouvelle action dans le flux d’enregistrement et sélectionnez Apply (Appliquer).

Créez un compte dans votre flux de test et laissez le champ First Name (Prénom) vide. Vous verrez une erreur lors de la soumission :

Après avoir saisi un nom dans le champ First Name (Prénom), vous pouvez soumettre le formulaire avec succès :

Naviguez vers User Management (Gestion des utilisateurs) > Users (Utilisateurs), puis confirmez que les données ont été sauvegardées en affichant l’onglet Details (Détails) :