Référence sur les étapes du processus basé sur l’utilisation de Forms on OSGi forms-centric-workflow-on-osgi-step-reference

Titre : Titre de la tâche. Le titre s’affiche dans la boîte de réception AEM.

Description : Explication 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 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 de formulaire adaptatif s’affiche et une icône par défaut s’affiche pour le 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 : Élevée, Moyenne et Faible. La valeur par défaut est Moyenne.

Date d’échéance : Indiquez le nombre de jours ou d’heures après lesquels la tâche est marqué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 : Nombre d’heures avant que la tâche ne soit terminée. Le nombre d’heures 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 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’emplacement [apps]/fd/dashboard/scripts/timeoutHandler peuvent être sélectionnés. Le chemin d’accès 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 ou un document de PDF non interactif.

Utiliser le formulaire adaptatif : spécifiez la méthode pour localiser le formulaire adaptatif d’entrée. Vous pouvez utiliser le formulaire adaptatif disponible à un chemin absolu, envoyé en tant que charge utile au workflow, ou disponible à un chemin calculé à l’aide d’une variable. Vous pouvez utiliser une variable de type chaîne pour spécifier le chemin d’accès.

Chemin d’accès du formulaire adaptatif  : indiquez le chemin d’accès du formulaire adaptatif. Le champ est disponible lorsque vous utilisez l’option de formulaire adaptatif ou de formulaire adaptatif en lecture seule dans le champ Type conjointement avec l’option de chemin d’accès absolu dans le champ Utiliser le formulaire adaptatif .

Chemin du PDF : Spécifiez le chemin d’accès d’un document de PDF non interactif. Le champ apparaît lorsque vous sélectionnez un document PDF non interactif dans le champ Type. Le chemin d’accès est toujours relatif à la charge. Par exemple, [Répertoire_Charge_utile]/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 avez besoin d’une option Document d’enregistrement activée ou de formulaires adaptatifs basés sur un modèle de formulaire pour utiliser l’option Chemin du PDF .

Pour la tâche terminée, effectuez le rendu du formulaire adaptatif comme: 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 de PDF. Vous avez besoin d’une option Document d’enregistrement activée ou de formulaires adaptatifs basés sur un modèle de formulaire pour générer le formulaire adaptatif en tant que document d’enregistrement.

Informations à préremplir : Les champs suivants répertoriés ci-dessous servent d’entrées à la tâche :

• Chemin du fichier de données : Chemin du fichier de données d’entrée (.json ou .xml). Le chemin d’accès est toujours relatif à la charge. Par exemple, le fichier contient les données envoyées pour le formulaire via une application de boîte de réception AEM. Voici un exemple de chemin d’accès : [Répertoire_Charge_utile]/workflow/data.
• Chemin d’accès de la pièce jointe : 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. Voici un exemple de chemin d’accès : [Répertoire_Charge_utile]/attachments/

Informations envoyées : les champs répertoriés ci-dessous servent d’emplacement de sortie pour la tâche :

• Chemin du fichier de données : Chemin du fichier de données (.json ou .xml). Le fichier de données contient des informations envoyées via le formulaire associé. Le chemin d’accès est toujours relatif à la charge. Par exemple, [Répertoire_Charge_utile]/Workflow/data, où les données correspondent à un fichier.
• Chemin d’accès de la pièce jointe : Chemin d’accès pour enregistrer les pièces jointes de formulaire fournies dans une tâche.
• Chemin du document d’enregistrement : Chemin d’accès pour enregistrer un fichier de document d’enregistrement. Par exemple,[ Répertoire_Charge_utile]/DocumentofRecord/credit-card.pdf. Le document d’enregistrement n’est pas généré si le champ de chemin d’accès est vide. Le chemin d’accès est toujours relatif à la charge.

Options d’affectation : Indiquez 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 la variable À un utilisateur ou à un groupe de manière dynamique est sélectionnée dans le champ Options d’affectation . Vous pouvez utiliser un ECMAScript ou un service pour sélectionner dynamiquement un utilisateur ou un groupe. Pour plus d’informations, voir Affectation dynamique d’un workflow aux utilisateurs et Création d’une étape de participant dynamique Adobe Experience Manager personnalisée.

Participants : le champ est disponible lorsque l’option com.adobe.granite.workflow.core.process.RandomParticipantChooser est 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.

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.

Notifier le cessionnaire par courrier électronique : Sélectionnez cette option pour envoyer des notifications par courrier électronique à la personne désignée. Ces notifications sont envoyées lorsqu’une tâche est assignée à un utilisateur. Avant d'utiliser cette option, activez les notifications depuis AEM console web. Pour obtenir des instructions détaillées, voir configurer des notifications électroniques pour l’étape Affecter une tâche

Modèle de courrier électronique HTML: Sélectionnez le modèle d'email de l'email de notification. Pour modifier un modèle, modifiez le fichier situé à l’emplacement /libs/fd/dashboard/templates/email/htmlEmailTemplate.txt dans le référentiel crx-repository.

Autoriser la délégation à : La boîte de réception AEM fournit à l’utilisateur connecté une option lui permettant de déléguer le processus affecté à un autre utilisateur. Vous êtes autorisé à déléguer au sein du même groupe ou à l’utilisateur du workflow d’un autre groupe. Si la tâche est affectée à un seul utilisateur et que la fonction Autoriser la délégation aux membres du groupe désigné est sélectionnée, puis il n’est pas possible de déléguer la tâche à un autre utilisateur ou groupe.

Actions par défaut : Les actions Envoyer, Enregistrer et Réinitialiser prêtes à l’emploi 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 branche à différents 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é.

Titre  : indiquez le titre de l’itinéraire. Il s’affiche dans AEM boîte de réception.

Icône Coral: Spécifiez l’attribut HTML d’une icône de corail. La bibliothèque Adobe CoralUI fournit un vaste ensemble d’icônes tactiles. Vous pouvez choisir et utiliser une icône pour l’itinéraire. Elle s’affiche avec le titre dans la boîte de réception AEM.

Autoriser les personnes désignées à ajouter des commentaires: Sélectionnez cette option pour activer les commentaires pour la tâche. Une personne désignée peut ajouter les commentaires dans AEM boîte de réception au moment de l’envoi de la tâche.

Autoriser les personnes désignées à 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.

Chemin de sortie des pièces jointes de la tâche: Indiquez l’emplacement du dossier de pièces jointes. L’emplacement est relatif à la charge utile.

Utilisation de métadonnées personnalisées : Sélectionnez cette option pour activer le champ de métadonnées personnalisé. Les métadonnées personnalisées sont utilisées dans les modèles de courrier électronique.

Métadonnées personnalisées : sélectionnez une métadonnée personnalisée pour les modèles de courrier électronique. Les métadonnées personnalisées sont disponibles dans le référentiel crx-repository sous apps/fd/dashboard/scripts/metadataScripts. Le chemin d’accès spécifié n’existe pas dans le référentiel crx. Un administrateur crée le chemin d’accès avant de l’utiliser. Vous pouvez également utiliser un service pour les métadonnées personnalisées. Vous pouvez également étendre l’interface WorkitemUserMetadataService afin de fournir des métadonnées personnalisées.

Afficher les données des étapes précédentes  : sélectionnez cette option pour permettre aux personnes désignées d’afficher les personnes désignées précédentes, les actions déjà effectuées sur la tâche, les commentaires ajoutés à la tâche et le document d’enregistrement de la tâche terminée, le cas échéant.

Afficher les données des étapes suivantes : sélectionnez cette option pour permettre à la personne actuellement désignée d’afficher l’action effectuée et les commentaires ajoutés à la tâche par les personnes désignées suivantes. Elle permet également à la personne désignée actuelle d’afficher un document d’enregistrement de la tâche terminée, le cas échéant.

Visibilité du type de données : Par défaut, une personne désignée peut afficher un document d’enregistrement, les personnes désignées, l’action entreprise et les commentaires ajoutés par les personnes désignées précédentes et suivantes. Utilisez l’option de visibilité du type de données pour limiter le type de données visibles pour les personnes désignées.

Littéral  : utilisez cette option lorsque vous connaissez la valeur exacte à spécifier. Par exemple, example@example.com.

Métadonnées de workflow : Utilisez l’option lorsque la valeur à utiliser est enregistrée dans une propriété de métadonnées de workflow. Après avoir sélectionné l’option, saisissez le nom de la propriété de métadonnées dans la zone de texte vide sous l’option Métadonnées de processus . Par exemple, emailAddress.

URL de la ressource : utilisez cette option pour inclure un lien web d’une communication interactive à l’e-mail. Après avoir sélectionné cette option, recherchez et sélectionnez la communication interactive à inclure. La ressource peut se trouver sur le serveur de création ou de publication.

Image : Utilisez l’option pour incorporer une image dans le courrier électronique. Après avoir sélectionné cette option, recherchez et sélectionnez l’image. L’option image est disponible uniquement pour les balises d’image (<img src="*" />) disponibles dans le modèle d’email.

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é.

Entrée pour les services > Fournir des données d’entrée à l’aide de littéraux, de métadonnées de workflow et d’un fichier JSON: Un service peut avoir plusieurs arguments. Sélectionnez l’option pour obtenir la valeur des arguments de service à partir d’une propriété de métadonnées de workflow, d’un objet JSON ou saisissez directement la valeur dans la zone de texte fournie :

• Littéral  : utilisez cette option lorsque vous connaissez la valeur exacte à spécifier. Par exemple, srose@we.info.
• Récupération à partir des métadonnées de workflow : Utilisez l’option lorsque la valeur à utiliser est enregistrée dans une propriété de métadonnées de workflow. Par exemple, emailAddress.
• JSON Dot Notation : utilisez cette option lorsque la valeur à utiliser figure dans un fichier JSON. Par exemple, insurance.customerDetails.emailAddress.L’option JSON Dot Notation n’est disponible que si l’option Mapper les champs de saisie depuis l’entrée JSON est sélectionnée.
• Mapper les champs de saisie depuis le fichier JSON d’entrée : spécifiez le chemin d’accès d’un fichier JSON pour obtenir la valeur d’entrée des arguments de service à partir du fichier JSON. Le chemin d’accès du fichier JSON peut être relatif à la charge utile ou à un chemin d’accès absolu.

Entrée pour les services > Fournir des données d’entrée à l’aide d’un fichier JSON : Sélectionnez l’option pour obtenir des valeurs pour tous les arguments d’un fichier JSON.

Chemin du fichier JSON d’entrée: Chemin du fichier JSON contenant les valeurs de 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.

Notation de point JSON : Laissez le champ vide pour utiliser tous les objets du fichier JSON spécifié comme 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.

Sortie de service > Mapper et écrire les valeurs de sortie sur les métadonnées : Sélectionnez l’option pour enregistrer les valeurs de sortie en tant que propriétés du noeud de métadonnées de l’instance de workflow dans le référentiel 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.

Sortie de service > Enregistrer la sortie au format JSON : Sélectionnez l’option pour enregistrer les valeurs de sortie dans un fichier JSON.

Chemin du fichier JSON de sortie : Chemin d’accès pour enregistrer 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.

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.

Paramètre régional : spécifiez la langue pour les options de messagerie et de vérification.

Configuration du cloud Acrobat Sign: Sélectionnez une configuration de cloud Acrobat Sign. Si vous n’avez pas configuré Acrobat Sign pour AEM Forms, reportez-vous à la section Intégration d’Acrobat Sign à AEM Forms.

Document à signer : Vous pouvez choisir un document à partir d’un emplacement relatif à la charge utile, utiliser la charge utile comme document ou spécifier un chemin d’accès absolu au document.

Input Attachment Path : Sélectionnez une pièce jointe. Ces pièces jointes sont incluses dans le document de signature. Vous pouvez conserver les pièces jointes à un emplacement relatif à la charge utile ou spécifier un chemin d’accès absolu aux pièces jointes.

Si vous spécifiez le chemin d’accès d’un dossier, par exemple des pièces jointes, 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 de signature en tant que pièces jointes. Les dossiers présents dans les dossiers directement disponibles sont ignorés.

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 choisir de signer un document dans un ordre séquentiel ou parallèle. Dans l’ordre séquentiel, un signataire reçoit le document à la fois pour signature. Une fois que le premier signataire a terminé la signature du document, le document est envoyé au second signataire, etc. 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 règle générale, cette URL contient un message de remerciement ou d’autres instructions.

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 n’est disponible que si l’option Dynamiquement est sélectionnée dans le champ Sélectionner les signataires . Vous pouvez spécifier un script ECMAScript ou un service pour sélectionner des signataires et des 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 un mécanisme de vérification en 2 étapes, assurez-vous que l’option de vérification correspondante est activée pour le compte Acrobat Sign configuré.

Variable d’état : Un document activé par Acrobat Sign stocke l’état de signature du document dans une variable. Spécifiez le nom de la variable d’état (adobeSignStatus). Une variable de statut d’une instance est disponible dans CRXDE à l’emplacement /etc/workflow/instances/<server>/<date-heure>/<instance de modèle de processus>/workItems/<node>/metaData. Elle contient le statut d’une variable.

Chemin du document signé : Indiquez l’emplacement où conserver les documents signés. Vous pouvez choisir de remplacer le fichier de charge utile ou de placer le document signé à un emplacement dans le répertoire de charge utile.