Utilisation du service Prefill dans Forms adaptatif

Vous pouvez préremplir les champs d’un formulaire adaptatif à l’aide de données existantes. Lorsqu’un utilisateur ouvre un formulaire, les valeurs de ces champs sont préremplies. Il existe plusieurs façons de préremplir les champs de formulaires adaptatifs. Dans cet article, nous allons examiner le préremplissage d’un formulaire adaptatif à l’aide du service de préremplissage AEM Forms.

Pour en savoir plus sur les différentes méthodes de préremplissage des formulaires adaptatifs, suivez cette documentation

Pour préremplir un formulaire adaptatif à l’aide du service de préremplissage, vous devez créer une classe qui implémente l’interface DataProvider. La méthode getPrefillData aura la logique de créer et de renvoyer des données que le formulaire adaptatif utilisera pour préremplir les champs. Cette méthode vous permet de récupérer les données de n’importe quelle source et de renvoyer le flux d’entrée du document de données. L’exemple de code suivant récupère les informations de profil utilisateur de l’utilisateur connecté et construit un document XML dont le flux d’entrée est renvoyé pour être utilisé par les formulaires adaptatifs.

Dans le fragment de code ci-dessous, nous avons une classe qui implémente l'interface DataProvider. Nous obtenons l'accès à l'utilisateur connecté, puis récupérons les informations de profil de l'utilisateur connecté. Nous créons ensuite un document XML avec un élément de noeud racine appelé "data" et ajoutons les éléments appropriés à ce noeud de données. Une fois le document XML créé, le flux d’entrée du document XML est renvoyé.

Cette classe est ensuite transformée en lot OSGi et déployée dans AEM. Une fois le lot déployé, ce service de préremplissage est alors disponible pour être utilisé comme service de préremplissage de votre formulaire adaptatif.

public class PrefillAdaptiveForm implements DataProvider {
 private Logger logger = LoggerFactory.getLogger(PrefillAdaptiveForm.class);

 public String getServiceName() {
  return "Default Prefill Service";
 }
 
 public String getServiceDescription() {
  return "This is default prefill service to prefill adaptive form with user data";
 }
 
 public PrefillData getPrefillData(final DataOptions dataOptions) throws FormsException {
  PrefillData prefillData = new PrefillData() {
   public InputStream getInputStream() {
    return getData(dataOptions);
   }
   
   public ContentType getContentType() {
    return ContentType.XML;
   }
  };
  return prefillData;
 }

 private InputStream getData(DataOptions dataOptions) throws FormsException {  
  try {
   Resource aemFormContainer = dataOptions.getFormResource();
   ResourceResolver resolver = aemFormContainer.getResourceResolver();
   Session session = resolver.adaptTo(Session.class);
   UserManager um = ((JackrabbitSession) session).getUserManager();
   Authorizable loggedinUser = um.getAuthorizable(session.getUserID());
   DocumentBuilderFactory docFactory = DocumentBuilderFactory.newInstance();
   DocumentBuilder docBuilder = docFactory.newDocumentBuilder();
   Document doc = docBuilder.newDocument();
   Element rootElement = doc.createElement("data");
   doc.appendChild(rootElement);
   Element firstNameElement = doc.createElement("fname");
   firstNameElement.setTextContent(loggedinUser.getProperty("profile/givenName")[0].getString());
     .
     .
     .
   InputStream inputStream = new ByteArrayInputStream(rootElement.getTextContent().getBytes());
   return inputStream;
  } catch (Exception e) {
   logger.error("Error while creating prefill data", e);
   throw new FormsException(e);
  }
 }
}

Pour tester cette fonctionnalité sur votre serveur, effectuez les opérations suivantes :

• Téléchargez et extrayez le contenu du fichier zip sur votre ordinateur.
• Assurez-vous que les informations profil de l'utilisateur sont complétées. Il s’agit d’une condition requise pour que l’échantillon fonctionne. L’exemple ne comporte aucune vérification d’erreur des propriétés de profil d’utilisateur manquantes.
• Déployez le lot à l’aide de la console Web AEM
• Créer un formulaire adaptatif à l’aide du schéma XSD
• Associez "Service de préremplissage personnalisé de formulaires Aem" au service de préremplissage de votre formulaire adaptatif.
• Faire glisser des éléments de schéma vers le formulaire
• Prévisualiser le formulaire