Les étapes de processus Forms effectuent des opérations spécifiques à AEM Forms dans un processus AEM. Ces étapes vous permettent de créer rapidement des formulaires adaptatifs à partir de processus basés sur l’utilisation de Forms on OSGi. Ces workflows peuvent être utilisés pour élaborer des workflows de révision et d'approbation de base, des processus d'entreprise internes et intermuraux. Vous pouvez également utiliser les étapes de processus Forms pour lancer les services de document, les intégrer au processus de signature Adobe Sign et effectuer d’autres opérations AEM Forms. Un module complémentaire AEM Forms est nécessaire pour utiliser ces étapes dans un processus.
L’étape Affecter une tâche crée une tâche et l’affecte à un utilisateur ou un groupe. Lors de l’affectation de la tâche, le composant spécifie également le formulaire adaptatif ou le fichier PDF non interactif de la tâche. Le formulaire adaptatif est requis pour accepter une saisie des utilisateurs et un fichier PDF non interactif ou un formulaire adaptatif en lecture seule est utilisé pour les processus de révision uniquement.
Vous pouvez également utiliser le composant pour contrôler le comportement de la tâche. Par exemple : lors de la création d’un document d’enregistrement automatique, lors de l’affectation de la tâche à un utilisateur ou un groupe spécifique, lors de l’indication du chemin d’accès des données envoyées, lors de l’indication du chemin d’accès des données pré-renseignées et des actions par défaut. L’étape Affecter une tâche possède les propriétés suivantes :
Titre : titre de la tâche. Le titre s’affiche dans la boîte de réception AEM.
Description : description des opérations en cours dans la tâche. Ces informations sont utiles pour d’autres développeurs de processus lorsque vous travaillez dans un environnement de développement partagé.
Chemin d’accès de la miniature : chemin d’accès de la miniature de la tâche. Si aucun chemin n’est spécifié, une miniature par défaut s’affiche pour un formulaire adaptatif et une icône par défaut s’affiche pour un document d’enregistrement.
Phase de processus : un processus peut se composer de plusieurs phases. Ces phases sont affichées dans la boîte de réception AEM. Vous pouvez définir ces phases dans les propriétés du modèle (Sidekick > Page > Propriétés de la page > Phases).
Priorité : la priorité sélectionnée s’affiche dans la boîte de réception AEM. Les options disponibles sont les suivantes : Elevée, Moyenne et Faible. La valeur par défaut est Moyenne.
Date d’expiration : spécifiez le nombre de jours ou d’heures restant avant que la tâche soit affichée comme En retard. Si vous sélectionnez Désactivé, la tâche n’est jamais marquée comme En retard. Vous pouvez également spécifier un gestionnaire de dépassement de délai pour effectuer des tâches spécifiées dès que la tâche est marquée comme En retard.
Jours : le nombre de jours restants pour terminer la tâche. Le nombre de jours est calculé à partir du jour de l’affectation de la tâche à un utilisateur. Si cette option est sélectionnée, si une tâche n’est pas terminée et dépasse le nombre de jours spécifié dans le champ Jours, un gestionnaire de dépassement de délai est déclenché après la date d’expiration.
Heures : le nombre d’heures restantes pour terminer la tâche. Le nombre d’heure est calculé à partir de l’heure de l’affectation de la tâche à un utilisateur. Si cette option est sélectionnée, si une tâche n’est pas terminée et dépasse pas le nombre d’heures spécifié dans le champ Heures, un gestionnaire de dépassement de délai est déclenché après l’heure de l’expiration.
Expiration après l’échéance : sélectionnez cette option pour activer le champ Sélection du gestionnaire de dépassement de délai.
Gestionnaire de dépassement de délai : sélectionnez le script à exécuter lorsque l’étape Affecter une tâche dépasse l’échéance. Les scripts placés dans le référentiel CRX à l’adresse [apps]/fd/tableau de bord/scripts/timeoutHandler peuvent être sélectionnés. Le chemin spécifié n’existe pas dans le référentiel CRX. Un administrateur crée le chemin d’accès avant de l’utiliser.
Sélectionner l’action et ajouter un commentaire depuis la dernière tâche dans Détails de la tâche : sélectionnez cette option pour afficher la dernière action qui a été effectuée et le dernier commentaire reçu dans la section Détails de la tâche.
Type : sélectionnez le type de document à remplir lors du lancement du processus. Vous pouvez choisir un formulaire adaptatif, un formulaire adaptatif en lecture seule, un document PDF non interactif, une interface utilisateur de l’agent de communication interactive ou un Document de Canal Web de communication interactive.
Utiliser un formulaire adaptatif : indiquez la méthode pour localiser le formulaire adaptatif d’entrée. Cette option est disponible si vous sélectionnez Formulaire adaptatif ou Formulaire adaptatif en lecture seule dans la liste déroulante Type. Vous pouvez utiliser le formulaire adaptatif envoyé au processus, disponible à un chemin absolu ou disponible à un chemin dans une variable. Vous pouvez utiliser une variable de type String pour spécifier le chemin d’accès.
Vous pouvez associer plusieurs formulaires adaptatifs à un processus. Par conséquent, vous pouvez spécifier un formulaire adaptatif au moment de l’exécution à l’aide des méthodes d’entrée disponibles.
Utiliser la communication interactive : indiquez la méthode de localisation de la communication interactive d’entrée. Vous pouvez utiliser la communication interactive envoyée au flux de travail, disponible à un chemin absolu ou disponible à un chemin dans une variable. Vous pouvez utiliser une variable de type String pour spécifier le chemin d’accès. Cette option est disponible si vous sélectionnez Interface utilisateur de l'agent de communication interactive ou Document de Canal Web de communication interactive dans la liste déroulante Type.
Pour accéder à l'interface utilisateur de l'agent de communications interactives dans AEM boîte de réception, vous devez disposer d'affectations de groupe cm-agent-users et de groupes workflow-users.
Formulaire adaptatif ou chemin de communication interactive : Spécifiez le chemin d’accès du formulaire adaptatif ou de la communication interactive. Vous pouvez utiliser le formulaire adaptatif ou la communication interactive envoyé au flux de travail, disponible à un chemin absolu, ou récupérer le formulaire adaptatif à partir d’un chemin stocké dans une variable de type de données de chaîne.
Sélectionnez le PDF d’entrée à l’aide de : spécifiez le chemin d’accès d’un document PDF non interactif. Le champ apparaît lorsque vous sélectionnez un document PDF non interactif dans le champ Type. Vous pouvez sélectionner le fichier PDF d’entrée à l’aide du chemin d’accès relatif à la charge utile, enregistré à un chemin absolu ou à l’aide d’une variable de type de données de Document. Par exemple, [Payload_Directory]/Workflow/PDF/credit-card.pdf. Le chemin n’existe pas dans le référentiel CRX. Un administrateur crée le chemin d’accès avant de l’utiliser. Vous devez activer l’option Document d’enregistrement ou posséder des formulaires adaptatifs basés sur un modèle de formulaire pour utiliser l’option Chemin d’accès du fichier PDF.
Une fois la tâche terminée, effectuer le rendu du formulaire adaptatif en tant que : lorsqu’une tâche est marquée comme terminée, vous pouvez effectuer le rendu du formulaire adaptatif en tant que formulaire adaptatif en lecture seule ou document PDF. Vous devez activer l’option Document d’enregistrement ou posséder des formulaires adaptatifs basés sur un modèle de formulaire pour effectuer le rendu du formulaire adaptatif en tant que Document d’enregistrement.
Pré-renseigné : Les champs suivants répertoriés ci-dessous servent d’entrées à la tâche :
Sélectionnez le fichier de données d’entrée à l’aide de : Chemin du fichier de données d’entrée (.json,). xml, .doc ou modèle de données de formulaire). Vous pouvez récupérer le fichier de données d’entrée à l’aide d’un chemin d’accès relatif à la charge utile ou récupérer le fichier stocké dans une variable de type de données Document, XML ou JSON. Par exemple, le fichier contient les données envoyées pour le formulaire via une application de boîte de réception AEM. Un exemple de chemin d’accès est [Payload_Directory]/workflow/data.
Sélectionnez les pièces jointes d’entrée à l’aide de : Les pièces jointes disponibles à l’emplacement sont jointes au formulaire associé à la tâche. Le chemin d’accès est toujours relatif à la charge. Un exemple de chemin est [Payload_Directory]/attachments/
Choisissez JSON d’entrée : sélectionnez un fichier JSON d’entrée à l’aide d’un chemin d’accès relatif à la charge utile ou stocké dans une variable de type de données Document, JSON ou Modèle de données de formulaire. Cette option est disponible si vous sélectionnez Interface utilisateur de l'agent de communication interactive ou Document de Canal Web de communication interactive dans la liste déroulante Type.
Sélectionnez un service de préremplissage personnalisé : sélectionnez le service de préremplissage pour récupérer les données et préremplissez le document de canal Web Interactive Communication ou l'interface utilisateur de l'agent.
Utilisez le service de préremplissage de la communication interactive sélectionnée ci-dessus : Utilisez cette option pour utiliser le service de préremplissage de la communication interactive définie dans la liste déroulante Utiliser la communication interactive.
Mappage d’attributs de requête : utilisez la section Mappage d’attributs de requête pour définir le nom et la valeur de l’attribut de requête. Récupérez les détails de la source de données en fonction du nom d’attribut et de la valeur spécifiés dans la requête. Vous pouvez définir une valeur d’attribut de requête à l’aide d’une valeur littérale ou d’une variable de type de données String.\
Les options de mappage du service de préremplissage et des attributs de requête ne sont disponibles que si vous sélectionnez Interface utilisateur de l’agent de communication interactive ou Document Web de communication interactive dans la liste déroulante Type.
Informations envoyées : les champs répertoriés ci-dessous servent d’emplacement de sortie pour la tâche :
Enregistrez le fichier de données de sortie à l’aide de : Enregistrez le fichier de données (.json,). xml, .doc ou modèle de données de formulaire). Le fichier de données contient des informations envoyées via le formulaire associé. Vous pouvez enregistrer le fichier de données de sortie à l’aide d’un chemin d’accès relatif à la charge utile ou le stocker dans une variable de type de données Document, XML ou JSON. Par exemple, [Payload_Directory]/Workflow/data, où les données sont un fichier.
Enregistrer les pièces jointes à l’aide : Enregistrez les pièces jointes au formulaire fournies dans une tâche. Vous pouvez enregistrer les pièces jointes à l’aide d’un chemin d’accès relatif à la charge utile ou le stocker dans une variable de tableau de type de données de Document.
Enregistrez le Document d’enregistrement à l’aide de : Path pour enregistrer un fichier Document d’enregistrement. Par exemple, [Payload_Directory]/DocumentofRecord/credit-card.pdf. Vous pouvez enregistrer le Document d’enregistrement à l’aide d’un chemin d’accès relatif à la charge utile ou le stocker dans une variable de type de données de Document. Si vous sélectionnez l’option Relative to Payload, le Document d’enregistrement n’est pas généré si le champ de chemin d’accès est laissé vide. Cette option est disponible uniquement si vous sélectionnez Formulaire adaptatif dans la liste déroulante Type.
Enregistrer les données de Canal Web à l’aide de : Enregistrez le fichier de données de Canal Web à l’aide d’un chemin d’accès relatif à la charge utile ou stockez-le dans une variable de type de données Document, JSON ou Modèle de données de formulaire. Cette option est disponible uniquement si vous sélectionnez Interface utilisateur de l’agent de communication interactif dans la liste déroulante Type.
Enregistrer le document PDF à l’aide de : Enregistrez le document PDF à l’aide d’un chemin d’accès relatif à la charge utile ou stockez-le dans une variable de type de données de Document. Cette option est disponible uniquement si vous sélectionnez Interface utilisateur de l’agent de communication interactif dans la liste déroulante Type.
Enregistrer le modèle de mise en page à l’aide de : Enregistrez le modèle de mise en page à l’aide d’un chemin d’accès relatif à la charge utile ou stockez-le dans une variable de type de données de Document. Le modèle de mise en page fait référence à un fichier XDP que vous créez à l’aide de Forms Designer. Cette option est disponible uniquement si vous sélectionnez Interface utilisateur de l’agent de communication interactif dans la liste déroulante Type.
Affectation > Options d’affectation : spécifiez la méthode d’affectation de la tâche à un utilisateur. Vous pouvez affecter la tâche de manière dynamique à un utilisateur ou un groupe à l’aide du script Programme de sélection des participants ou affecter la tâche à un utilisateur ou à un groupe AEM spécifique.
Programme de sélection des participants : cette option est disponible lorsque l’option Sélectionner de manière dynamique un utilisateur ou un groupe est activée dans le champ Options d’affectation. Vous pouvez utiliser un script ECMAScript ou un service pour sélectionner de manière dynamique un utilisateur ou un groupe. Pour plus d’informations, voir Affecter de manière dynamique un processus à des utilisateurs et Création d’une étape Participant dynamique Adobe Experience Manager personnalisé.
Participants : le champ est disponible lorsque l’option com.adobe.granite.workflow.core.process.RandomParticipantChooserest sélectionnée dans le champ Programme de sélection des participants. Le champ vous permet de sélectionner des utilisateurs ou des groupes pour l’option RandomParticipantChooser.
Destinataire : le champ est disponible lorsque le com.adobe.fd.workspace.step.service. VariableParticipantChooserest sélectionné dans le champ Chooserfield Participant. Ce champ vous permet de sélectionner une variable de type String pour définir la personne désignée.
Arguments : le champ est disponible lorsqu’un script autre que le script RandomParticipantChoose est sélectionné dans le champ Programme de sélection des participants. Le champ vous permet de fournir une liste d’arguments séparés par des virgules pour le script sélectionné dans le champ Programme de sélection des participants.
Utilisateur ou groupe : la tâche est affectée à l’utilisateur ou au groupe sélectionné. Cette option est disponible lorsque l’option À un utilisateur ou un groupe spécifique est activée dans le champ Options d’affectation. Le champ répertorie tous les utilisateurs et groupes du groupe d’utilisateurs du processus.
Le menu déroulant Utilisateur ou groupe liste les utilisateurs et les groupes auxquels l’utilisateur connecté a accès. L’affichage du nom d’utilisateur dépend de si vous disposez d’autorisations d’accès sur le noeud users dans crx-repository pour cet utilisateur particulier.
Avertir la personne désignée par courrier électronique : sélectionnez cette option pour envoyer des notifications électroniques à la personne désignée. Ces notifications sont envoyées lorsqu’une tâche est affectée à un utilisateur. Avant d’utiliser cette option, activez les notifications de la console Web AEM. Pour obtenir des instructions détaillées, consultez Configuration des notifications électroniques à l’étape Affecter une tâche
Modèle de courrier électronique HTML : sélectionnez un modèle de courrier électronique pour la notification électronique. Pour modifier un modèle, modifiez le fichier situé à l’emplacement /libs/fd/dashboard/templates/email/htmlEmailTemplate.txt dans le référentiel CRX.
Autoriser la délégation à : la boîte de réception AEM permet à l’utilisateur connecté de déléguer le processus affecté à un autre utilisateur. Vous pouvez déléguer la tâche au sein du même groupe ou à l’utilisateur du processus d’un autre groupe. Si la tâche est affectée à un utilisateur unique et que l’option Autoriser la délégation aux membres du groupe désigné est sélectionnée, vous ne pouvez pas déléguer la tâche à un utilisateur ou à un autre groupe.
Partager les paramètres : AEM boîte de réception propose des options permettant de partager une ou toutes les tâches de la boîte de réception avec d’autres utilisateurs :
Actions > Actions par défaut : Les actions Envoyer, Enregistrer et Réinitialiser sont disponibles. Par défaut, toutes les actions par défaut sont activées.
Variable d’itinéraire : nom de la variable d’itinéraire. La variable d’itinéraire capture les actions personnalisées qu’un utilisateur sélectionne dans la boîte de réception AEM.
Itinéraires : une tâche peut se composer de plusieurs itinéraires. Lorsque cette option est sélectionnée dans la boîte de réception AEM, l’itinéraire renvoie une valeur et les branches du processus en fonction de l’itinéraire sélectionné. Vous pouvez stocker des itinéraires dans une variable de tableau de type de données String ou sélectionner Literal pour ajouter manuellement des itinéraires.
Titre : Indiquez le titre de l'itinéraire. Il s’affiche dans la boîte de réception AEM.
Icône Corail : indiquez l’attribut HTML d’une icône corail. La bibliothèque Adobe CorelUI fournit un vaste ensemble d’icônes tactiles. Vous pouvez sélectionner et utiliser une icône pour l’itinéraire. Elle s’affiche avec le titre dans la boîte de réception AEM. Si vous stockez les itinéraires dans une variable, ils utilisent une icône de corail "Balises" par défaut.
Autoriser la personne désignée à ajouter des commentaires : sélectionnez cette option pour activer les commentaires pour la tâche. Une personne désignée peut ajouter des commentaires à partir de la boîte de réception AEM au moment de l’envoi de la tâche.
Enregistrer le commentaire dans la variable : Enregistrez le commentaire dans une variable de type de données String. Cette option s’affiche uniquement si vous cochez la case Autoriser la personne désignée à ajouter un commentaire.
Autoriser la personne désignée à ajouter des pièces jointes à la tâche : sélectionnez cette option pour activer les pièces jointes pour la tâche. Une personne désignée peut ajouter des pièces jointes à partir de la boîte de réception AEM au moment de l’envoi de la tâche.
Enregistrez les pièces jointes de la tâche de sortie à l’aide des éléments suivants : Spécifiez l’emplacement du dossier des pièces jointes. Vous pouvez enregistrer les pièces jointes de la tâche de sortie à l’aide d’un chemin d’accès relatif à la charge utile ou dans une variable de tableau de type de données de document. Cette option s’affiche uniquement si vous cochez la case Autoriser les personnes désignées à ajouter des pièces jointes à la tâche et sélectionnez Formulaire adaptatif, Formulaire adaptatif en lecture seule ou document PDF non interactif dans la liste déroulante Type. liste dans l’onglet Formulaire/Document.
Utilisez l’onglet Pièces jointes de l’interface utilisateur de l’agent au moment de l’exécution pour associer les pièces jointes à une communication interactive. Les pièces jointes associées s’affichent en tant que pièces jointes de tâche dans le panneau latéral après l’ouverture de la tâche dans un état Terminé.
Utilisez l’étape Envoyer un courrier électronique pour, par exemple, envoyer un courrier électronique avec un document d’enregistrement, un lien d’un formulaire adaptatif, un lien d’une communication interactive ou avec un document PDF joint. L’étape Envoyer un courrier électronique prend en charge le courrier électronique HTML. Les courriers électroniques HTML sont réactifs et s’adaptent à différents clients de messagerie et tailles d’écran. Vous pouvez utiliser un modèle de courrier électronique HTML pour définir l’aspect, le modèle de couleurs et le comportement du courrier électronique.
L’étape Envoyer un courrier électronique utilise le service de messagerie Day CQ pour envoyer des messages. Avant d’utiliser l’étape Envoyer un courrier électronique, assurez-vous que le service de messagerie est configuré. L’étape Envoyer un courrier électronique possède les propriétés suivantes :
Titre : le titre de l’étape permet d’identifier l’étape dans l’éditeur du processus.
Description : la description est utile pour d’autres développeurs de processus lorsque vous travaillez dans un environnement de développement partagé.
Objet du message électronique : L’objet peut être récupéré à partir des métadonnées d’un processus, spécifiées manuellement ou récupérées à partir de la valeur stockée dans une variable. Sélectionnez l’une des options suivantes :
Modèle de courrier électronique HTML : modèle HTML pour le courrier électronique. Vous pouvez spécifier des variables dans un modèle de courrier électronique. L’étape Envoyer un courrier électronique extrait et affiche toutes les variables incluses dans un modèle pour les entrées.
Métadonnées du modèle de courrier électronique : la valeur des variables de modèle de courrier électronique peut être une valeur spécifiée par l’utilisateur, le chemin d’accès d’un fichier sur l’auteur ou sur le serveur de publication, l’image ou une propriété de métadonnées de processus.
Littéral : utilisez cette option lorsque vous connaissez la valeur exacte à spécifier. Par exemple, example@example.com.
Métadonnées de processus : utilisez cette option lorsque la valeur à utiliser est enregistrée dans une propriété de métadonnées de processus. Après avoir sélectionné cette option, saisissez le nom de la propriété des métadonnées dans la zone de texte vide en dessous de l’option Métadonnées de processus. Par exemple, emailAddress.
URL du fichier : utilisez l’option pour incorporer un lien Web d’une communication interactive avec le courrier électronique. Après avoir sélectionné l’option, recherchez et choisissez la communication interactive à incorporer. Un actif peut résider sur le serveur de création ou de publication.
Image : utilisez cette option pour inclure une image au courrier électronique. Après avoir sélectionné cette option, recherchez et sélectionnez l’image. L’option image est uniquement disponible pour les balises d’image (<img src="*"/>) disponibles dans le modèle du courrier électronique.
Adresse électronique de l’expéditeur/du Destinataire : sélectionnez l’ option Littéral pour spécifier manuellement une adresse électronique ou sélectionnez l’option Récupérer à partir des métadonnées du flux de travail pour récupérer l’adresse électronique à partir d’une propriété de métadonnées. Vous pouvez également spécifier une liste de tableaux de propriété de métadonnées pour l’option Récupérer à partir des métadonnées de processus. Sélectionnez l'option Variable pour récupérer l'adresse de messagerie à partir de la valeur stockée dans une variable de type de données de chaîne.
Pièce jointe : la ressource disponible à l’emplacement spécifié est jointe au courrier électronique. Le chemin d’accès de l’actif peut être lié à la charge utile ou au chemin d’accès absolu. Un exemple de chemin d’accès est [Payload_Directory]/attachments/.
Sélectionnez l’option Variable pour récupérer le fichier joint stocké dans une variable de type de données Document, XML ou JSON.
Nom de fichier : nom du fichier de la pièce jointe au courrier électronique. L’étape de courrier électronique modifie le nom de fichier d’origine de la pièce jointe en le remplaçant par le nom de fichier spécifié. Le nom peut être spécifié manuellement ou récupéré à partir d’une propriété de métadonnées de processus ou d’une variable. Utilisez l’option Littéral lorsque vous connaissez la valeur exacte à spécifier. Utilisez l'option Variable pour récupérer le nom du fichier à partir de la valeur stockée dans une variable de type de données chaîne. Utilisez l’option Récupérer à partir des métadonnées de processus lorsque la valeur à utiliser est enregistrée dans une propriété de métadonnées de processus.
Lorsqu’un formulaire est rempli ou envoyé, vous pouvez conserver un enregistrement du formulaire, au format imprimé ou au format de document. On parle ici de document d’enregistrement (DOR). Vous pouvez utiliser l’étape Générer un document d’enregistrement pour créer une version PDF interactive ou en lecture seule d’un formulaire adaptatif. La version PDF contient des informations remplies dans le formulaire avec la mise en page du formulaire adaptatif.
L’étape Document d’enregistrement possède les propriétés suivantes :
Utiliser un formulaire adaptatif : Spécifiez la méthode pour localiser le formulaire adaptatif d’entrée. Vous pouvez utiliser le formulaire adaptatif envoyé au processus, disponible à un chemin absolu ou disponible à un chemin dans une variable. Vous pouvez utiliser une variable de type String pour spécifier le chemin d’accès dans le champ Sélectionner la variable à résoudre.
Vous pouvez associer plusieurs formulaires adaptatifs à un processus. Par conséquent, vous pouvez spécifier un formulaire adaptatif au moment de l’exécution à l’aide des méthodes d’entrée disponibles.
Chemin d’accès du formulaire adaptatif : indiquez le chemin d’accès du formulaire adaptatif. Le champ est disponible lorsque vous sélectionnez l'option Disponible à un chemin absolu dans le champ Utiliser le formulaire adaptatif.
Sélectionnez Données d’entrée à l’aide de : Chemin des données d’entrée pour le formulaire adaptatif. Vous pouvez conserver les données à un emplacement relatif à la charge utile, spécifier un chemin d’accès absolu aux données ou récupérer les données stockées dans une variable de type Document, JSON ou XML. Les données d’entrée sont fusionnées avec le formulaire adaptatif pour créer un document d’enregistrement.
Sélectionnez Input attachement path using: Path of the attachments. Ces pièces jointes sont incluses dans le document d’enregistrement. Vous pouvez conserver les pièces jointes à un emplacement relatif à la charge utile, spécifier un chemin absolu pour les pièces jointes ou récupérer les pièces jointes stockées dans une variable de tableau de type de données de Document.
Si vous spécifiez le chemin d’accès d’un dossier (des pièces jointes, par exemple), tous les fichiers directement disponibles dans le dossier sont joints au document d’enregistrement. Si des fichiers sont présents dans les dossiers directement disponibles dans le chemin d’accès de la pièce jointe spécifiée, les fichiers sont inclus dans le document d’enregistrement en tant que pièces jointes. Les dossiers présents dans les dossiers directement disponibles sont ignorés.
Enregistrer le Document d’enregistrement généré à l’aide des options ci-dessous : spécifiez l’emplacement de conservation d’un fichier d’enregistrement document. Vous pouvez remplacer le dossier de charge utile, placer le document d’enregistrement à un emplacement dans le répertoire de charge utile ou stocker le document d’enregistrement dans une variable de type de données Document.
Paramètre régional : spécifiez la langue du document d’enregistrement. Sélectionnez Literal pour sélectionner le paramètre régional dans une liste déroulante ou Variable pour récupérer le paramètre régional à partir de la valeur stockée dans une variable de type de données chaîne. Vous devez définir le code de la langue lors du stockage de la valeur de la langue dans une variable. Par exemple, spécifiez en_US pour l’anglais et fr_FR pour le français.
Vous pouvez utiliser l’intégration de données AEM Forms pour configurer des sources de données disparates et vous y connecter. Ces sources de données peuvent être une base de données, un service Web, un service REST, un service OData et une solution CRM. L’intégration de données AEM Forms vous permet de créer un modèle de données de formulaire regroupant plusieurs services afin d’effectuer des opérations de récupération, d’ajout et de mise à jour de données sur la base de données configurée. Vous pouvez utiliser l’étape Invoquer le service de modèle de données de formulaire pour sélectionner un modèle de données de formulaire (FDM) et utiliser les services du FDM pour récupérer, mettre à jour ou ajouter des données aux sources de données disparates.
Pour mieux comprendre les entrées des champs de l’étape, la table de base de données et le fichier JSON suivants sont utilisés à titre d’exemple :
Exemple de table CustomerDetails
Propriétés | Valeur |
Prénom |
Sarah |
Nom de famille | Rose |
ID de client | 1 |
Adresse électronique |
srose@we.info |
Exemple de fichier JSON
{
customer: {
firstName: "Sarah",
lastName:"Rose",
customerId: "1",
emailAddress:"srose@we.info"
},
insurance: {
customerId: "1",
policyType: "Premium,
policyNumber: "Premium-521499",
customerDetails: {
firstName: "Sarah",
lastName: "Rose",
customerId: "1",
emailAddress: "srose@we.info"
}
}
}
L’étape Invoquer le service de modèle de données de formulaire contient les champs suivants pour faciliter les opérations du modèle de données de formulaire :
Titre : titre de l’étape. Il permet d’identifier l’étape dans l’éditeur du processus.
Description : la description est utile pour d’autres développeurs de processus lorsque vous travaillez dans un environnement de développement partagé.
Chemin d’accès du modèle de données de formulaire : recherchez et sélectionnez un modèle de données de formulaire présent sur le serveur.
Service : liste des services fournit par le modèle de données de formulaire sélectionné.
Input for services > Fournir des données d’entrée à l’aide de métadonnées littérales, variables ou de flux de travail et d’un fichier JSON : Un service peut avoir plusieurs arguments. Sélectionnez l’option permettant d’obtenir la valeur des arguments de service à partir d’une propriété de métadonnées de flux de travail, d’un objet JSON, d’une variable ou de saisir directement la valeur dans la zone de texte fournie :
Input for services > Fournir des données d’entrée à l’aide d’une variable ou d’un fichier JSON : sélectionnez l’option permettant d’obtenir des valeurs pour tous les arguments à partir d’un fichier JSON enregistré à un chemin absolu, à un chemin relatif à la charge utile ou dans une variable.
Sélectionnez le document JSON d’entrée à l’aide de : Fichier JSON contenant des valeurs pour tous les arguments de service. Le chemin d’accès du fichier JSON peut être relatif à la charge utile ou à un chemin d’accès absolu. Vous pouvez également récupérer le document JSON d’entrée à l’aide d’une variable de type de données JSON ou Modèle de données de formulaire.
JSON Dot Notation : laissez le champ vide pour utiliser tous les objets du fichier JSON spécifié en tant qu’entrée pour les arguments de service. Pour lire un objet JSON spécifique à partir du fichier JSON spécifié en tant qu’entrée pour des arguments de service, spécifiez la notation par point pour l’objet JSON. Par exemple, si vous avez un fichier JSON identique à l’un des fichiers indiqué au début de la section, spécifiez insurance.customerDetails pour fournir tous les détails d’un client en tant qu’entrée du service.
Output of service > Map and write output values to variable or metadata : sélectionnez l’option permettant d’enregistrer les valeurs de sortie en tant que propriétés du noeud de métadonnées de l’instance de processus dans crx-repository. Spécifiez le nom de la propriété de métadonnées et sélectionnez l’attribut de sortie de service correspondant à mapper avec la propriété de métadonnées, par exemple, mappez la valeur numéro_de_téléphone renvoyé par le service de sortie avec la propriété numéro_de_téléphone des métadonnées du processus. De même, vous pouvez stocker la sortie dans une variable de type de données Long. Lorsque vous sélectionnez une propriété pour l'attribut de sortie Service à mapper, seules les variables capables de stocker les données de la propriété sélectionnée sont renseignées pour l'option Enregistrer la sortie dans.
Output of service > Save output to variable or a JSON file : sélectionnez l’option permettant d’enregistrer les valeurs de sortie dans un fichier JSON à un chemin absolu, à un chemin relatif à la charge utile ou dans une variable.
Enregistrez le document JSON de sortie à l’aide des options ci-dessous : Enregistrez le fichier JSON de sortie. Le chemin d’accès du fichier JSON peut être relatif à la charge utile ou à un chemin d’accès absolu. Vous pouvez également enregistrer le fichier JSON de sortie à l’aide d’une variable de type de données JSON ou Modèle de données de formulaire.
L’étape Signer le document vous permet d’utiliser Adobe Sign pour signer des documents. L’étape du Document de signature possède les propriétés suivantes :
Nom du contrat : indiquez le titre du contrat. Le nom du contrat devient une partie de l’objet et du corps du courrier électronique envoyé aux signataires. Vous pouvez soit stocker le nom dans une variable de type de données String, soit sélectionner Literal pour l’ajouter manuellement.
Paramètre régional : spécifiez la langue pour les options de messagerie et de vérification. Vous pouvez stocker le paramètre régional dans une variable de type de données String ou sélectionner Literal pour choisir le paramètre régional dans la liste des options disponibles. Vous devez définir le code de la langue lors du stockage de la valeur de la langue dans une variable. Par exemple, spécifiez en_US pour l’anglais et fr_FR pour le français.
Configuration cloud Adobe Sign : sélectionnez une configuration cloud Adobe Sign. Si vous n’avez pas configuré Adobe Sign pour AEM Forms, voir Intégrer Adobe Sign à AEM Forms.
Sélectionnez le Document à signer à l’aide de : Vous pouvez choisir un document d’un emplacement relatif à la charge utile, utiliser la charge utile comme document, spécifier un chemin absolu du document ou récupérer le document stocké dans une variable de type de données Document.
Jours avant l’échéance : un document est marqué comme dû (délai expiré) lorsqu’il n’y a plus aucune activité sur la tâche pour le nombre de jours spécifié dans le champ Jours avant l’échéance. Le nombre de jours est calculé à partir du jour de l’affectation du document à un utilisateur pour signature.
Fréquence des messages de rappel : vous pouvez envoyer un message de rappel à intervalle quotidien ou hebdomadaire. La semaine est calculée à compter du jour de l’affectation du document à un utilisateur pour signature.
Processus de signature : vous pouvez signer un document dans un ordre séquentiel ou parallèle. Dans un ordre séquentiel, un signataire à la fois reçoit le document à signer. Une fois que le premier signataire a terminé la signature du document, il est envoyé au signataire suivant, et ainsi de suite. Dans l’ordre parallèle, plusieurs signataires signent un document en même temps.
URL de redirection : spécifiez une URL de redirection. Une fois le document signé, vous pouvez rediriger la personne désignée vers une URL. En général, cette URL contient un message de remerciement ou des instructions supplémentaires.
Phase de processus : un processus peut se composer de plusieurs phases. Ces phases sont affichées dans la boîte de réception AEM. Vous pouvez définir ces phases dans les propriétés du modèle (Sidekick > Page > Propriétés de la page > Phases).
Sélectionner les signataires : indiquez la méthode utilisée pour sélectionner des signataires pour le document. Vous pouvez affecter de manière dynamique le processus à un utilisateur ou à un groupe ou ajouter manuellement les informations d’un signataire.
Script ou service pour sélectionner les signataires : cette option est disponible uniquement si l’option De manière dynamique est sélectionnée dans le champ Sélectionner les signataires. Vous pouvez spécifier un ECMAScript ou un service pour choisir les signataires et les options de vérification pour un document.
Détails du signataire : cette option est disponible uniquement si l’option Manuellement est sélectionnée dans le champ Sélectionner les signataires. Indiquez l’adresse électronique et choisissez une méthode de vérification facultative. Avant de sélectionner une méthode de vérification en 2 étapes, assurez-vous que l’option de vérification correspondante est activée pour le compte Adobe Sign configuré. Vous pouvez utiliser une variable de type String pour définir des valeurs pour les champs Courriel, Code de pays et Numéro de téléphone. Les champs Code de pays et Numéro de téléphone ne s’affichent que si vous sélectionnez Vérification téléphonique dans la liste déroulante Vérification en deux étapes.
Variable d’état : un document activé pour Adobe Sign stocke l’état de signature du document dans une variable de type de données String. Spécifiez le nom de la variable d’état (adobeSignStatus). Une variable d’état d’une instance est disponible dans CRXDE à l’adresse /etc/workflow/instances/<serveur>/<date-time>/<instance du modèle de flux de travail>/workItems/<noeud>/metaData contient l’état d’une variable.
Enregistrez le document signé à l’aide des options ci-dessous : indiquez l’emplacement où conserver les documents signés. Vous pouvez remplacer le fichier de charge utile, placer le document signé à un emplacement dans le répertoire de charge utile ou stocker le document signé dans une variable de type Document.
Les services de document AEM sont un ensemble de services permettant de créer, d’assembler et de sécuriser des documents PDF. AEM Forms fournit une étape de flux de travail AEM distincte pour chaque service de document.
À l’instar des autres étapes du processus AEM Forms, telles que Affecter une Tâche, Envoyer un courriel et Signer un Document, vous pouvez utiliser des variables dans toutes les étapes AEM services de Document. Pour plus d'informations sur la création et la gestion des variables, voir Variables dans AEM workflows.
Ajoute un horodatage à un document. Indiquez les détails du document, tels que le chemin d’accès du document d’entrée, le nom du document d’entrée, l’emplacement de stockage des données exportées. Vous pouvez choisir de remplacer un fichier de charge utile existant, de choisir un nom de fichier différent pour stocker des données dans un autre fichier sous le dossier de charge, de fournir un chemin d’accès absolu aux données ou de stocker des données dans une variable de type de données de Document.
Convertit un document PDF en liste d’images. Les formats d’image pris en charge sont JPEG, JPEG2000, PNG et TIFF. Les informations suivantes s’appliquent aux conversions en images TIFF :
Convertit un document PDF au format PDF/A à l’aide des options fournies. La version PDF/A du format PDF (Portable Document Format) est réservée à l’archivage et la conservation des documents à long terme.
Convertir des documents PDF en PostScript. Lors d’une conversion au format PostScript, vous pouvez indiquer le document source et choisir entre une conversion vers PostScript niveau 2 ou 3. Le document PDF à convertir en fichier PostScript ne doit pas être interactif.
Génère un document PDF à partir d’un fichier d’entrée. Le document d’entrée peut être relatif à la charge utile, avoir un chemin d’accès absolu, être la charge utile elle-même ou stocké dans une variable de type de données de Document.
Génère un document PDF à partir de l’URL fournie ou du fichier HTML et ZIP.
Exporte des données à partir d’un formulaire PDF ou d’un XDP. Vous devez saisir le chemin d’accès du document d’entrée et le format d’exportation des données. Les options Exporter le format de données sont Auto, XDP et XmlData.
Convertit un document PDF au format sélectionné.
Génère un PDF non interactif. Cette étape comprend différentes options de personnalisation.
Vous pouvez utiliser des variables pour spécifier le fichier de modèle pour les documents d’entrée. Stockez le chemin d’accès du fichier de modèle dans une variable de type de données String.
Fusionne les données de formulaire dans un formulaire PDF. Vous pouvez importer les données de formulaire dans un formulaire au format PDF.
Exécute le fichier DDX sur la carte spécifiée des documents d’entrée et renvoie les documents PDF ayant fait l’objet d’une manipulation.
Vous pouvez utiliser des variables pour spécifier le fichier DDX pour les documents d’entrée. Stockez le fichier DDX dans une variable de type de données Document ou XML.
Optimise les fichiers PDF en réduisant leur taille. Cette conversion a pour effet de réduire la taille des fichiers PDF par rapport à leur version d’origine. Cette opération permet également de convertir des documents PDF vers la version PDF spécifiée dans les paramètres d’optimisation.
Les paramètres d’optimisation spécifient comment les fichiers sont optimisés. Voici des exemples de paramètres :
Enregistre un formulaire créé dans Form Designer (XDP) dans un formulaire PDF.
Vous pouvez utiliser des variables pour spécifier le fichier de modèle pour les documents d’entrée. Stockez le chemin d’accès du fichier de modèle dans une variable de type de données String.
Chiffre, signe et certifie un document. AEM Forms prend en charge le chiffrement par mot de passe et au moyen d’un certificat. Vous pouvez également choisir entre plusieurs algorithmes pour signer des documents. SHA-256 et SH-512, par exemple. Vous pouvez également utiliser l’étape de processus pour étendre Reader aux documents PDF. L’étape de processus propose une option qui permet d’activer le décodage de code-barres, les signatures numériques, l’importation et l’exportation de données au format PDF et d’autres options.
Envoie un document directement à une imprimante. Cette étape prend en charge les systèmes d’accès aux imprimantes suivants :
L’étape génère une sortie PCL, PostScript, ZPL, IPL, TPCL ou DPL à partir d’une conception de formulaire et d’un fichier de données. Le fichier de données est fusionné avec la conception de formulaire et mis en forme pour l’impression. La sortie générée par cette étape peut être envoyée directement à une imprimante ou enregistrée en tant que fichier. Il est recommandé d’utiliser cette étape lorsque vous souhaitez utiliser des conceptions de formulaire ou des données d’une application. Si vos conceptions de formulaire ou conceptions de formulaire se trouvent sur le réseau, le système de fichiers local ou l’emplacement HTTP, utilisez l’opération generatePrintedOutput.
Par exemple, votre application nécessite la fusion d’une conception de formulaire avec un fichier de données. Les données contiennent des centaines d’enregistrements. En outre, la sortie doit être envoyée à une imprimante prenant en charge ZPL. La conception de formulaire et vos données d’entrée se trouvent dans une application. Utilisez l’opération generatePrintedOutput pour fusionner chaque enregistrement avec une conception de formulaire et envoyer la sortie à une imprimante prenant en charge ZPL.
L’étape Générer une sortie imprimée possède les propriétés suivantes :
Propriétés d’entrée
Sélectionnez le fichier de modèle à l’aide de : Spécifiez le chemin d’accès du fichier de modèle. Vous pouvez sélectionner le fichier de modèle à l’aide du chemin d’accès relatif à la charge utile, enregistré à un chemin absolu ou à l’aide d’une variable de type de données de Document. Par exemple, [Payload_Directory]/Workflow/data.xml. Si le chemin d’accès n’existe pas dans crx-repository, un administrateur peut créer le chemin d’accès avant de l’utiliser. De plus, vous pouvez également accepter la charge utile comme fichier de données d’entrée.
Sélectionnez le document de données à l'aide : Spécifiez le chemin d’accès d’un fichier de données d’entrée. Vous pouvez sélectionner le fichier de données d’entrée à l’aide du chemin d’accès relatif à la charge utile, enregistré à un chemin absolu ou à l’aide d’une variable de type de données de Document. Par exemple, [Payload_Directory]/Workflow/data.xml. Si le chemin d’accès n’existe pas dans crx-repository, un administrateur peut créer le chemin d’accès avant de l’utiliser.
Format d’imprimante : Valeur Format d’impression qui spécifie le langage de description de page à utiliser, lorsqu’un fichier XDC n’est pas fourni, pour générer le flux de sortie. Si vous fournissez une valeur littérale, sélectionnez l’une de ces valeurs :
Propriétés de sortie
Propriétés avancées
Sélectionnez l’emplacement racine de contenu à l’aide de : La racine de contenu est une valeur de chaîne qui spécifie l’URI, la référence absolue ou l’emplacement dans le référentiel pour récupérer les actifs relatifs utilisés par la conception de formulaire. Par exemple, si la conception de formulaire fait relativement référence à une image, comme …/myImage.gif, le fichier myImage.gif doit être situé dans repository://. La valeur par défaut est repository://, qui pointe vers le niveau racine du référentiel.
Lorsque vous sélectionnez une ressource dans votre application, le chemin d’accès de l’URI de la racine du contenu doit présenter la structure appropriée. Par exemple, si un formulaire est sélectionné à partir d’une application nommée SampleApp et placé dans SampleApp/1.0/forms/Test.xdp, l’URI de la racine du contenu doit être spécifié comme suit : repository://administrator@password/Applications/SampleApp/1.0/forms/ ou repository:/Applications/SampleApp/1.0/forms/ (lorsque l’autorité est nulle). Lorsque l’URI de la racine de contenu est spécifié de cette manière, les chemins d’accès de toutes les ressources référencées dans le formulaire seront résolus par rapport à cet URI.
Sélectionnez un fichier XCI à l’aide de : Les fichiers XCI servent à décrire les polices et les autres propriétés utilisées pour les éléments de conception de formulaire. Vous pouvez conserver un fichier XCI relatif à la charge utile, à un chemin d’accès absolu ou à l’aide d’une variable de type de données de Document.
Paramètres régionaux : Indique la langue utilisée pour générer le document PDF. Si vous fournissez une valeur littérale, sélectionnez une langue dans la liste ou l’une de ces valeurs :
Pour utiliser la valeur par défaut du serveur : (Par défaut) Utilisez le paramètre Paramètres régionaux configuré sur le serveur AEM Forms. Le paramètre régional est configuré à l’aide d’Administration Console. (Voir l’aide de Designer.)
Pour utiliser une valeur personnalisée : Tapez le code de paramètres régionaux dans la zone littérale ou sélectionnez une variable de chaîne contenant le code de paramètres régionaux. Pour obtenir une liste complète des codes des paramètres régionaux pris en charge, voir http://java.sun.com/j2se/1.5.0/docs/guide/intl/locale.doc.html.
Copies : Valeur entière qui spécifie le nombre de copies à générer pour la sortie. La valeur par défaut est 1.
Impression recto verso : Valeur de pagination qui spécifie si l’impression recto ou recto verso doit être utilisée. Les imprimantes prenant en charge PostScript et PCL utilisent cette valeur.Si vous fournissez une valeur littérale, sélectionnez l’une des valeurs suivantes :