Définir la valeur de l’élément de données JSON dans AEM Forms Workflow

Lorsqu’un formulaire adaptatif est acheminé vers différents utilisateurs et utilisatrices dans le workflow AEM, il est nécessaire de masquer ou désactiver certains champs ou panneaux en fonction de la personne qui le visualise. Pour répondre à ces cas d’utilisation, nous définissons généralement la valeur d’un champ masqué. En fonction des valeurs de ce champ masqué, les règles métier peuvent être créées pour masquer/désactiver les panneaux ou champs appropriés.

Dans OSGi AEM Forms : nous devons créer un lot OSGi personnalisé pour définir la valeur de l’élément de données JSON. Le lot est fourni dans le cadre de ce tutoriel.

Nous utilisons l’étape du processus dans le workflow AEM. Nous associons le lot OSGi « Set Value of Element in Json » à cette étape de processus.

Nous devons transmettre deux arguments au lot de définition de valeur. Le premier est le chemin d’accès à l’élément dont la valeur doit être définie. Le deuxième argument est la valeur qui doit être définie.

Par exemple, dans la capture d’écran ci-dessus, nous définissons la valeur de l’élément initialStep sur « N ».

afData.afUnboundData.data.initialStep,N

Dans notre exemple, nous avons un simple formulaire de demande de congés. L’initiateur ou l’iniatrice de ce formulaire saisit son nom et ses dates de congés. Lors de l’envoi, ce formulaire est envoyé à la personne « responsable » pour examen. Lorsque la personne responsable ouvre le formulaire, les champs du premier panneau sont désactivés. C’est parce que nous avons défini la valeur de l’élément d’étape initial dans les données JSON sur N.

En fonction de la valeur des champs de l’étape initiale, nous affichons le panneau d’approbation dans lequel la personne « responsable » peut approuver ou rejeter la demande.

Veuillez consulter les règles définies par rapport à « Étape initiale ». En fonction de la valeur du champ initialStep, nous récupérons les détails de l’utilisateur ou de l’utilisatrice à l’aide du modèle de données de formulaire, nous renseignons les champs appropriés et masquons/désactivons les panneaux appropriés.

Pour déployer les ressources sur votre système local :

• Téléchargez et déployez DevelopingWithServiceUserBundle

• Téléchargez et déployez le lot setvalue. Il s’agit du lot OSGI personnalisé qui vous permet de définir les valeurs d’un élément dans les données json envoyées.

• Téléchargez et extrayez les contenus du fichier zip.

  • Pointez votre navigateur sur le gestionnaire de packages.
    • Importez et installez le fichier SetValueOfElementInJSONDataWorkflow.zip. Ce package contient les exemples de modèle de workflow et de modèle de données de formulaire associés au formulaire.

• Pointez votre navigateur sur Formulaires et documents.

• Cliquez sur Créer | Charger un fichier.

• Chargez le fichier TimeOffRequestForm.zip.
  Ce formulaire a été créé avec AEM Forms 6.4. Vérifiez que vous utilisez AEM Forms 6.4 ou une version ultérieure.

• Ouvrez le formulaire.

• Renseignez les champs Dates de début et de fin et envoyez le formulaire.

• Accédez à « Boîte de réception ».

• Ouvrez le formulaire associé à la tâche.

• Notez que les champs du premier panneau sont désactivés.

• Le panneau d’approbation ou de refus de la demande est maintenant visible.