Référence sur les étapes du workflow basé sur l’utilisation de Forms on OSGi forms-centric-workflow-on-osgi-step-reference
Vous utilisez des modèles de processus pour convertir une logique métier en processus répétitif automatisé. Un modèle permet de définir et d’exécuter une série d’étapes. Vous pouvez également définir des propriétés de modèle pour déterminer, par exemple, si le processus est transitoire ou s’il utilise plusieurs ressources. Vous pouvez inclure diverses étapes d’un processus AEM dans un modèle pour appliquer la logique métier.
Étapes de Forms Workflow forms-workflow-steps
Les étapes de Forms Workflow effectuent des opérations spécifiques à AEM Forms dans un workflow AEM. Ces étapes vous permettent de créer rapidement des formulaires adaptatifs à partir de workflows basés sur l’utilisation de Forms on OSGi. Ces workflows peuvent être utilisés pour développer des processus de révision et d’approbation de base, des workflows métier internes et sur le pare-feu. Vous pouvez également utiliser les étapes de Forms Workflow pour démarrer Document Services, intégrer le workflow de signature Adobe Sign et effectuer d’autres opérations liées à AEM Forms. Le module complémentaire AEM Forms est requis pour utiliser ces étapes dans un workflow.
Les étapes de workflows basés sur l’utilisation de Forms effectuent des opérations spécifiques à AEM Forms dans un workflow AEM. Ces étapes vous permettent de créer rapidement des formulaires adaptatifs à partir d’un workflow basé sur l’utilisation de Forms on OSGi. Ces workflows peuvent être utilisés pour développer des workflows de révision et d’approbation de base, des processus métier internes et sur le pare-feu.
Étape Affecter une tâche assign-task-step
L’étape Affecter une tâche crée une tâche et l’affecte à un utilisateur, à une utilisatrice 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 utilisatrices et un fichier PDF non interactif ou un formulaire adaptatif en lecture seule est utilisé pour les workflows 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, à une utilisatrice 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 vignette : chemin d’accès de la vignette de la tâche. Si aucun chemin n’est spécifié, une vignette 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 : Élevé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 ou une utilisatrice. 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’heures est calculé à partir de l’heure de l’affectation de la tâche à un utilisateur ou une utilisatrice. 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, un document de PDF non interactif, l’interface utilisateur de l’agent de communication interactive ou un document de canal web de communication interactive.
-
Utiliser le formulaire adaptatif : spécifiez 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 soumis au workflow, disponible au niveau d’un chemin absolu, ou disponible au niveau d’un chemin dans une variable. Vous pouvez utiliser une variable de type chaîne pour spécifier le chemin d’accès.
Vous pouvez associer plusieurs formulaires adaptatifs à un workflow. Par conséquent, vous pouvez spécifier un formulaire adaptatif au moment de l’exécution en utilisant les méthodes d’entrée disponibles. -
Utiliser la communication interactive : spécifiez la méthode pour localiser la communication interactive d’entrée. Vous pouvez utiliser la communication interactive soumise au workflow, disponible au niveau d’un chemin absolu ou disponible au niveau d’un chemin dans une variable. Vous pouvez utiliser une variable de type chaîne 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 du canal Web de communication interactive dans la liste déroulante Type.
-
Chemin d’accès du formulaire adaptatif ou de la communication interactive : spécifiez le chemin du formulaire adaptatif ou de la communication interactive. Vous pouvez utiliser le formulaire adaptatif ou la communication interactive qui est soumis au workflow, disponible au niveau d’un chemin d’accès absolu, ou récupérer le formulaire adaptatif à partir d’un chemin stocké dans une variable de type de données chaîne.
-
Sélectionner le fichier PDF d’entrée en utilisant : indiquez 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 Document. 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 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érempli : les champs répertoriés ci-dessous servent d’entrées à la tâche :
-
Sélectionnez le fichier de données d’entrée en utilisant : chemin d’accès 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. Voici un exemple de chemin d’accès : [Répertoire_Charge_utile]/workflow/data.
-
Sélectionner les pièces jointes d’entrée en utilisant : les pièces jointes disponibles à l’emplacement sont jointes au formulaire associé à la tâche. Le chemin d’accès peut être relatif à la payload ou récupérer les pièces jointes stockées dans une variable du type ArrayList du document. Voici un exemple de chemin d’accès : [Payload_Directory]/attachments/. Vous pouvez spécifier des pièces jointes placées par rapport à la payload ou utiliser une variable de type document (Liste de tableaux > Document) pour spécifier une pièce jointe d’entrée pour le formulaire adaptatif.
- Choisir JSON en entrée : sélectionnez un fichier JSON en entrée en utilisant un chemin d’accès relatif à la payload 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 du canal Web de communication interactive dans la liste déroulante Type.
- Sélectionner un service de préremplissage personnalisé : sélectionnez le service de préremplissage pour récupérer les données et préremplir le document du canal web de communication interactive ou l’interface utilisateur de l’agent.
- Utiliser 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 des noms des champs de la demande : utilisez la section Mappage des noms des champs de la demande pour définir le nom et la valeur de l’attribut de la demande. 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 Chaîne.
Les options de service de préremplissage et de mappage des noms des champs de la demande sont disponibles uniquement si vous sélectionnez l’interface utilisateur de l’agent de communication interactive ou le document du canal 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 :
-
Enregistrer le fichier de données de sortie en utilisant : enregistrer 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, [Répertoire_Charge_utile]/Workflow/data, où les données correspondent à un fichier.
-
Enregistrer les pièces jointes en utilisant : enregistrer les pièces jointes du formulaire fournies dans une tâche. Vous pouvez enregistrer les pièces jointes en utilisant un chemin d’accès relatif à la payload ou les stocker dans une variable de tableau de type de données Document.
-
Enregistrer le document d’enregistrement en utilisant : chemin d’accès pour enregistrer un fichier de document d’enregistrement. Par exemple,[ Répertoire_Charge_utile]/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 Document. Si vous sélectionnez l’option Relatif à la charge utile, le document d’enregistrement n’est pas généré si le champ de chemin d’accès est laissé vide. Cette option n’est disponible que si vous sélectionnez Formulaire adaptatif dans la liste déroulante Type.
-
Enregistrer les données du canal web en utilisant : enregistrez le fichier de données du canal web à l’aide d’un chemin d’accès relatif à la payload 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 l’interface utilisateur de l’agent de communication interactive dans la liste déroulante Type.
-
Enregistrer le document PDF en utilisant : enregistrez le document PDF à l’aide d’un chemin d’accès relatif à la payload ou stockez-le dans une variable de type de données Document. Cette option est disponible uniquement si vous sélectionnez l’interface utilisateur de l’agent de communication interactive dans la liste déroulante Type.
-
Enregistrer le modèle de mise en page en utilisant : enregistrez le modèle de mise en page à l’aide d’un chemin d’accès relatif à la payload ou stockez-le dans une variable de type de données Document. Le modèle de disposition 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 l’interface utilisateur de l’agent de communication interactive dans la liste déroulante Type.
-
-
Personne désignée > 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 ou des participantes : cette option est disponible lorsque l’option Sélectionner de manière dynamique un utilisateur, une utilisatrice ou un groupe est activée dans le champ Options d’affectation. Vous pouvez utiliser un ECMAScript ou un service pour sélectionner un utilisateur ou une utilisatrice, ou un groupe de manière dynamique. Pour en savoir plus, veuillez consulter 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, des utilisatrices ou des groupes pour l’option RandomParticipantChooser.
-
Personne désignée : ce champ est disponible lorsque l’option com.adobe.fd.workspace.step.service.VariableParticipantChooser est sélectionnée dans le champ Programme de sélection des participants ou des participantes. Ce champ vous permet de sélectionner une variable de type Chaîne 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 ou des participantes. 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 ou des participantes.
-
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 répertorie les utilisateurs et les groupes auxquels l’utilisateur connecté a accès. L’affichage du nom d’utilisateur dépend des autorisations d’accès sur le nœud users dans crx-repository pour cet utilisateur particulier. -
Envoyer une notification par e-mail : sélectionnez cette option pour envoyer des notifications par e-mail à la personne désignée. Ces notifications sont envoyées lorsqu’une tâche est affectée à un utilisateur ou à un groupe. Vous pouvez utiliser l’option Adresse électronique du destinataire pour spécifier le mécanisme de récupération de l’adresse électronique.
-
Adresse électronique du destinataire : vous pouvez stocker l’adresse électronique dans une variable, utiliser un littéral pour spécifier une adresse électronique permanente ou utiliser l’adresse électronique par défaut de la personne désignée spécifiée dans son profil. Vous pouvez utiliser le littéral ou une variable pour spécifier l’adresse électronique d’un groupe. L’option de variable permet de récupérer et d’utiliser de manière dynamique une adresse électronique. L’option Utiliser l’adresse électronique par défaut de la personne désignée n’est destinée qu’à une seule personne désignée. Dans ce cas, l’adresse électronique stockée dans le profil utilisateur de la personne désignée est utilisée.
-
Modèle d’e-mail HTML : sélectionnez le modèle de l’e-mail 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.
-
Autoriser la délégation à : la boîte de réception AEM permet à la personne connectée de déléguer le workflow affecté à un autre utilisateur ou à une autre utilisatrice. Vous pouvez déléguer au sein du même groupe ou à l’utilisateur ou l’utilisatrice du workflow d’un autre groupe. Si la tâche est affectée à un seul utilisateur ou une seule utilisatrice et que la fonction Autoriser la délégation aux membres du groupe désigné est sélectionnée, alors il n’est pas possible de déléguer la tâche à un autre utilisateur ou une autre utilisatrice ou un autre groupe.
-
Paramètres de partage : la boîte de réception AEM propose des options permettant de partager une ou toutes les tâches de la boîte de réception avec d’autres utilisateurs :
- Lorsque l’option Autoriser les personnes désignées à partager explicitement dans la boîte de réception est sélectionnée, la personne peut sélectionner la tâche dans la boîte de réception AEM et la partager avec un autre utilisateur ou une autre utilisatrice d’AEM.
- Lorsque l’option Autoriser les personnes désignées à partager via le partage de boîte de réception est sélectionnée et que les utilisateurs partagent leurs éléments de boîte de réception ou permettent à d’autres utilisateurs d’accéder à leurs éléments de boîte de réception, seules les tâches dont l’option mentionnée précédemment est activée sont partagées avec d’autres utilisateurs.
-
Actions et actions par défaut : les actions Prêt à l’emploi, 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 Chaîne ou sélectionner Littéral 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 Coral : spécifiez l’attribut HTML d’une icône Coral. 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. Si vous stockez les itinéraires dans une variable, ils utilisent une icône de corail Balises par défaut.
-
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 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 Chaîne. 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 en utilisant : 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 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 dans l’onglet Formulaire/Document.
- Utiliser des métadonnées personnalisées : sélectionnez cette option pour activer le champ de métadonnées personnalisées. 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. Cette option permet également à la personne actuellement désignée 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, des personnes désignées, une action effectuée et les commentaires des personnes désignées précédentes et suivantes qui ont été ajoutés. Utilisez l’option de visibilité du type de données pour limiter le type de données visibles pour les personnes désignées.
Étape Envoyer un e-mail send-email-step
Utilisez l’étape Envoyer un e-mail pour, par exemple, un e-mail avec un document d’enregistrement, un lien d’un formulaire adaptatif, un lien d’une communication interactive ou un document PDF joint. L’étape Envoyer un e-mail prend en charge l’e-mail HTML. Les e-mails HTML sont réactifs et s’adaptent à la taille de l’écran et au client de messagerie du ou de la destinataire. 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 e-mail, 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 workflow.
Description : la description est utile pour d’autres développeurs de processus lorsque vous travaillez dans un environnement de développement partagé.
Objet de l’e-mail : l’objet peut être récupéré à partir des métadonnées d’un workflow, spécifié manuellement ou récupéré à partir de la valeur stockée dans une variable. Faites votre choix parmi les options suivantes :
- Littéral : spécifiez manuellement un objet.
- Récupérer à partir des métadonnées du processus : récupérez l’objet d’une propriété de métadonnées.
- Variable : récupérez l’objet de la valeur stockée dans une variable de type de données Chaîne.
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 d’e-mail : la valeur des variables du modèle d’e-mail peut être une valeur spécifiée par l’utilisateur, le chemin d’accès d’un actif sur le serveur de création ou de publication, une image ou une propriété de métadonnées de workflow.
-
Littéral : utilisez cette option lorsque vous connaissez la valeur exacte à spécifier. Par exemple, example@example.com.
-
Métadonnées de workflow : utilisez cette 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 workflow. 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 cette option pour inclure une image à l’e-mail. 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 d’e-mail.
Adresse e-mail du destinataire/expéditeur : sélectionnez l’option Littéral pour spécifier manuellement une adresse e-mail ou sélectionnez l’option Récupérer à partir des métadonnées de processus pour récupérer l’adresse e-mail 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érez à partir des métadonnées de processus. Sélectionnez l’option Variable pour récupérer l’adresse électronique à partir de la valeur stockée dans une variable de type de données Chaîne.
Pièce jointe du fichier : la ressource disponible à l’emplacement spécifié est jointe à l’e-mail. Le chemin d’accès de l’actif peut être lié à la charge utile ou au chemin d’accès absolu. Voici un exemple de chemin d’accès : [Répertoire_Charge_utile]/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 Envoyer un courrier électronique remplace le nom de fichier original de la pièce jointe 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.
Etape Générer un document d’enregistrement generate-document-of-record-step
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 ». 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 disposition 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 soumis au workflow, disponible au niveau d’un chemin absolu, ou disponible au niveau d’un chemin dans une variable. Vous pouvez utiliser une variable de type de données Chaîne pour spécifier le chemin d’accès dans le champ Sélectionner la variable à résoudre.
Vous pouvez associer plusieurs formulaires adaptatifs à un workflow. Par conséquent, vous pouvez spécifier un formulaire adaptatif au moment de l’exécution en utilisant les 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 d’accès absolu dans le champ Utiliser le formulaire adaptatif.
Sélectionner le chemin d’accès des données d’entrée : chemin d’accès 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électionner le chemin de pièce jointe d’entrée en utilisant : chemin des pièces jointes. 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 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 Chemin d’accès du document d’enregistrement généré : spécifier l’emplacement pour conserver un fichier de document d’enregistrement. Vous pouvez remplacer le dossier de payload, placer le document d’enregistrement à un emplacement du répertoire de payload 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 Littéral 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 du paramètre régional lors du stockage de la valeur du paramètre régional dans une variable. Par exemple, spécifiez en_US pour l’anglais et fr_FR pour le français.
Étape Invoquer le service de modèle de données de formulaire invoke-form-data-model-service-step
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 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 expliquer les entrées des champs de l’étape, le tableau de base de données et le fichier JSON suivants servent d’exemple :
Exemple de tableau CustomerDetails
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é.
-
Entrée des services > Fournir des données d’entrée à l’aide d’un fichier JSON, de l’option Littéral,d’une variable, de métadonnées de processus : un service peut avoir plusieurs arguments. Sélectionnez cette option pour obtenir la valeur des arguments de service à partir d’une propriété de métadonnées de processus, d’un objet JSON ou d’une variable, ou saisissez directement la valeur dans la zone prévue à cet effet :
-
Littéral : utilisez cette option lorsque vous connaissez la valeur exacte à spécifier. Par exemple, srose@we.info.
-
Variable : utilisez cette option pour récupérer la valeur stockée dans une variable.
-
Récupérer à partir des métadonnées de workflow : utilisez cette option lorsque la valeur à utiliser est enregistrée dans une propriété de métadonnées de workflow. Par exemple, emailAddress.
-
Relatif à la charge : utilisez cette option pour récupérer le fichier joint enregistré dans un chemin d’accès relatif à la charge. Sélectionnez l’option et indiquez le nom du dossier contenant le fichier joint ou indiquez le nom du fichier joint dans la zone de texte.
Par exemple, si le dossier Relatif à la charge dans le référentiel CRX inclut un fichier joint à l’emplacement
attachment\attachment-folder
, spécifiezattachment\attachment-folder
dans la zone de texte après avoir sélectionné l’option Relatif à la charge. -
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 est uniquement disponible si l’option Mapper les champs d’entrée depuis le fichier JSON d’entrée 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, un chemin absolu, ou vous pouvez sélectionner un document JSON d’entrée à l’aide d’une variable de type JSON ou Modèle de données de formulaire.
-
-
Entrée des services et fournir des données d’entrée à l’aide d’une variable ou d’un fichier JSON : sélectionnez cette option pour obtenir des valeurs pour tous les arguments d’un fichier JSON enregistré à un chemin absolu, à un chemin relatif à la payload ou dans une variable.
-
Sélectionnez le document JSON d’entrée en utilisant : 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.
-
Sortie de service et mapper et écrire les valeurs de sortie dans les métadonnées : sélectionnez cette option pour enregistrer les valeurs de sortie en tant que propriétés du nœud de métadonnées de l’instance de workflow dans le référentiel crx. 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 Long. Lorsque vous sélectionnez une propriété pour l’attribut de sortie de 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.
-
Sortie de service et sélectionner l’option permettant d’enregistrer les valeurs de sortie dans un fichier JSON : sélectionnez l’option pour enregistrer les valeurs de sortie dans un fichier JSON à un chemin absolu, à un chemin relatif à la payload, ou dans une variable.
-
Enregistrer le document JSON de sortie à l’aide des options suivantes : 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.
Étape Signer le document sign-document-step
L’étape Signer le document vous permet d’utiliser Adobe Sign pour signer des documents. L’étape Signer le document 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 de l’e-mail envoyé aux signataires. Vous pouvez soit stocker le nom dans une variable de type de données Chaîne, soit sélectionner Littéral 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 Chaîne ou sélectionner Littéral pour choisir le paramètre régional dans la liste des options disponibles. Vous devez définir le code du paramètre régional lors du stockage de la valeur du paramètre régional 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électionner le document à signer en utilisant : vous pouvez choisir un document à partir d’un emplacement relatif à la payload, utiliser la payload comme document, spécifier un chemin d’accès absolu au document ou récupérer le document stocké dans une variable de type de données Document.
-
Sélectionnez le chemin de pièce jointe d’entrée en utilisant : chemin des pièces jointes. Ces pièces jointes sont incluses dans le document de signature. Vous pouvez conserver les pièces jointes à un emplacement relatif à la payload, 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 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 de signature. 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 ou à une utilisatrice pour signature.
-
Processus de signature : vous pouvez signer un document dans un ordre séquentiel ou parallèle. Dans un ordre séquentiel, un ou une destinataire à la fois reçoit le document pour signature. Une fois que le premier destinataire a terminé la signature du document, le document est envoyé au second destinataire, etc. Dans l’ordre parallèle, plusieurs destinataires 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 destinataires : indiquez la méthode utilisée pour sélectionner des destinataires pour le document. Vous pouvez affecter de manière dynamique le workflow à un utilisateur ou utilisatrice ou à un groupe ou ajouter manuellement les informations d’un ou une destinataire. Lorsque vous sélectionnez Manuellement dans la liste déroulante, vous ajoutez les détails du ou de la destinataire tels que l’e-mail, le rôle et la méthode d’authentification.
note note NOTE - Dans la section Rôle, vous pouvez indiquer le rôle du destinataire : signataire, approbateur, accepteur, destinataire certifié, utilisateur de formulaire et délégué.
- Si vous choisissez Délégué dans l'option Rôle, le délégué ou la déléguée peut affecter la tâche de signature à un autre ou une autre destinataire.
- Si vous avez configuré une méthode d’authentification pour Adobe Sign, en fonction de votre configuration, vous pouvez sélectionner une méthode d’authentification telle que l’authentification par téléphone, l’authentification basée sur les identités sociales ou gouvernementales et l’authentification basée sur les connaissances.
-
Script ou service pour sélectionner les destinataires : cette option n’est disponible que si vous sélectionnez Dynamique dans le champ Sélectionner les destinataires. Vous pouvez spécifier un script ECMAScript ou un service pour sélectionner des destinataires et des options de vérification pour un document.
-
Détails des destinataires : cette option est disponible uniquement si l’option Manuellement est sélectionnée dans le champ Sélectionner les destinataires. 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 Chaîne pour définir des valeurs pour les champs E-mail, Code de pays et Numéro de téléphone. Les champs Code pays et Numéro de téléphone s’affichent uniquement si vous sélectionnez Vérification téléphonique dans la liste déroulante de vérification en 2 étapes.
-
Variable de statut : le statut de signature d’un document activé par Adobe Sign est stocké dans une variable de type de données Chaîne. 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.
-
Document signé : vous pouvez enregistrer le statut du document signé dans la variable. Pour ajouter le journal d’audit des signatures électroniques afin d’accroître la sécurité et la légalité de votre document signé, vous pouvez inclure le rapport d’audit. Vous pouvez enregistrer le document signé à l’aide du dossier Variable ou Payload.
note note NOTE Le rapport d’audit est ajouté à la dernière page du document signé.
Étapes Document Services document-services-steps
AEM Document Services est un ensemble de services permettant de créer, d’assembler et de sécuriser des documents PDF. AEM Forms fournit une étape de workflow AEM distincte pour chaque service de document.
Comme pour d’autres étapes AEM Forms Workflow, telles qu’Affecter une tâche, Envoyer un e-mail et Signer un document, vous pouvez utiliser des variables dans toutes les étapes AEM Document Services. Pour plus d’informations sur la création et la gestion des variables, voir Variables dans les workflows AEM.
Appliquer l’étape d’horodatage du document apply-document-time-stamp-step
Ajoutez un horodatage à un document. Vous fournissez des détails sur le document, tels que le chemin du document d’entrée, le nom du document d’entrée et l’emplacement de stockage des données exportées. Vous pouvez choisir de remplacer un fichier de payload existant, de choisir un nom de fichier différent pour stocker les données dans un autre fichier sous le dossier de payload, de fournir un chemin d’accès absolu aux données ou de stocker les données dans une variable de type de données Document.
Etape Convertir en image convert-to-image-step
Convertit le 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 de TIFF :
- Un fichier TIFF de plusieurs pages est généré.
- Certaines annotations ne sont pas incluses dans les images TIFF. Les annotations qui nécessitent qu’Acrobat génère leur apparence ne sont pas incluses.
Étape Convertir en PDF/A convert-to-pdf-a-step
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.
Étape Convertir en PS convert-to-ps-step
Convertir des documents PDF en PostScript. Lors de la conversion au format PostScript, vous pouvez utiliser l’opération de conversion pour spécifier le document source et indiquer si vous souhaitez effectuer une conversion en PostScript de niveau 2 ou 3. Le document PDF que vous convertissez en fichier PostScript doit être non interactif.
Créer le PDF à partir de l’étape du type spécifié create-pdf-from-specified-type-step
Générez un document PDF à partir d’un fichier d’entrée. Le document d’entrée peut être relatif à la payload, comporter un chemin d’accès absolu, une payload elle-même ou être stocké dans une variable de type de données Document.
Créer le PDF à partir de l’étape URL/HTML/ZIP create-pdf-from-url-html-zip-step
Génère un document PDF à partir d’une URL, d’un HTML et d’un fichier ZIP fournis.
Étape Exporter les données export-data-step
Exporte les données depuis un fichier PDF forms ou XDP. Vous devez saisir le chemin d’accès au fichier du document d’entrée et le format d’export des données. Les options pour le Format d’export des données sont Auto, XDP et XmlData.
Étape Exporter un PDF vers le type spécifié export-pdf-to-specified-type-step
Convertit un document PDF en un format sélectionné.
Étape Générer un PDF non interactif generatenoninteractive
Générez un PDF non interactif. Cette étape comprend différentes options de personnalisation.
Étape Importer des données import-data-step
Fusionne les données de formulaire dans un formulaire PDF. Vous pouvez importer des données de formulaire dans un formulaire PDF.
Étape Invoquer DDX invokeddx
Exécute le fichier DDX sur la carte spécifiée des documents d’entrée et renvoie les documents PDF manipulés.
Étape Optimiser le PDF optimize-pdf-step
Optimise les fichiers PDF en réduisant leur taille. Le résultat de cette conversion est un fichier PDF moins volumineux que sa version d’origine. Cette opération convertit également les documents PDF vers la version PDF spécifiée dans les paramètres d’optimisation.
Les paramètres d’optimisation spécifient le mode d’optimisation des fichiers. Voici des exemples de paramètres :
- Version PDF cible :
- Ignorer les objets tels que les actions JavaScript et les miniatures de page incorporées
- Ignorer les données utilisateur telles que les commentaires et les pièces jointes
- Ignorer les paramètres non valides ou inutilisés
- Compresser les données non compressées ou utiliser des algorithmes de compression plus efficaces
- Supprimer les polices incorporées
- Définir les valeurs de transparence
Étape Rendre le formulaire PDF renderpdf
Rend un formulaire créé dans Form Designer (XDP) dans un formulaire PDF.
Étape Sécuriser le document secure-document-step
Chiffrez, signez et certifiez un document. AEM Forms prend en charge le chiffrement avec mot de passe et certificat. Vous pouvez également choisir entre différents algorithmes pour signer des documents. Par exemple, SHA-256 et SH-512. Vous pouvez également utiliser l’étape de workflow 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.
Étape Envoyer à l’imprimante send-to-printer-step
Envoyez un document directement à une imprimante. Ceci prend en charge les mécanismes d’accès à l’impression suivants :
- Imprimante à accès direct : une imprimante installée sur le même ordinateur est appelée imprimante à accès direct et l’ordinateur est appelé hôte d’imprimante. Ce type d’imprimante peut être une imprimante locale directement reliée à l’ordinateur.
- Imprimante à accès indirect : l’imprimante installée sur un serveur d’impression est accessible à partir d’autres ordinateurs. Les technologies de type CUPS (Common Unix® Printing System) et le protocole LPD (Line Printer Daemon) permettent de se connecter à une imprimante réseau. Pour accéder à une imprimante à accès indirect, vous devez indiquer l’adresse IP ou le nom d’hôte du serveur d’impression. Grâce à ce mécanisme, vous pouvez envoyer un document à un URI LPD lorsque le réseau dispose d’un LPD en cours d’exécution. Le mécanisme permet d’acheminer le document vers n’importe quelle imprimante connectée au réseau sur lequel un protocole LPD est exécuté.
Générer l’étape de sortie imprimée generatePrintedOutput
L’opération génère une sortie PCL, PostScript, ZPL, IPL, TPCL ou DPL à l’aide 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 opération peut être envoyée directement vers une imprimante ou enregistrée en tant que fichier. Il est recommandé d’utiliser cette opération lorsque vous souhaitez utiliser des conceptions de formulaire ou des données à partir d’une application. Si vos conceptions de formulaire se trouvent sur le réseau, un système de fichiers local ou un emplacement HTTP, utilisez l’opération generatePrintedOutput.
Par exemple, votre application requiert 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’opération Générer une sortie imprimée présente les propriétés suivantes :
Propriétés d’entrée
-
Sélectionner le fichier de modèle à l’aide de: spécifiez le chemin d’accès au fichier de modèle. Vous pouvez sélectionner le fichier de modèle à l’aide du chemin d’accès relatif à la payload, enregistré à un chemin d’accès absolu ou à l’aide d’une variable de type de données Document. Par exemple : [Payload_Directory]/Workflow/data.xml. Si le chemin d’accès n’existe pas dans le référentiel crx, un administrateur peut le créer avant de l’utiliser. De plus, vous pouvez également accepter la payload comme fichier de données d’entrée.
-
Sélectionner le document de données à l’aide de : 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 payload, enregistré à un chemin absolu ou à l’aide d’une variable de type de données Document. Par exemple : [Payload_Directory]/Workflow/data.xml. Si le chemin d’accès n’existe pas dans le référentiel crx, un administrateur peut le créer avant de l’utiliser.
-
Printer Format : une valeur Print Format qui spécifie la langue de description de page à utiliser lorsqu’un fichier XDC n’est pas fourni, afin de générer le flux de sortie. Si vous fournissez une valeur littérale, sélectionnez l’une de ces valeurs :
- Custom PCL : utilisez cette option pour spécifier un fichier XDC personnalisé pour PCL.
- Custom PostScript : utilisez cette option pour spécifier un fichier XDC personnalisé pour PostScript.
- ZPL personnalisé : utilisez cette option pour spécifier un fichier XDC personnalisé pour ZPL.
- Generic Color PCL (5c) : utilisez une couleur générique PCL (5c).
- Generic PostScript Level3 : utilisez PostScript Level 3 générique.
- ZPL 300 DPI : utilisez ZPL 300 DPI. Le fichier zpl300.xdc est utilisé.
- ZPL 600 DPI : utilisez ZPL 600 DPI. Le fichier zpl600.xdc est utilisé.
- Custom IPL : utilisez cette option pour spécifier un fichier XDC personnalisé pour IPL.
- IPL 300 DPI : utilisez IPL 300 DPI. Le fichier ipl300.xdc est utilisé.
- IPL 400 DPI : utilisez IPL 400 DPI. Le fichier ipl400.xdc est utilisé.
- Custom TPCL : utilisez cette option pour spécifier un fichier XDC personnalisé pour TPCL.
- TPCL 305 DPI : utilisez TPCL 300 DPI. Le fichier tpcl305.xdc est utilisé.
- PCL 600 DPI : utilisez TPCL 600 DPI. Le fichier tpcl600.xdc est utilisé.
- Custom DPL : utilisez l’option pour spécifier un DPL de fichier XDC personnalisé.
- DPL300DPI : utilisez DPL 300 DPI. Le fichier dpl300.xdc est utilisé.
- DPL406DPI : utilisez DPL 400 DPI. Le fichier dpl406.xdc est utilisé.
- DPL600DPI : utilisez DPL 600 DPI. Le fichier dpl600.xdc est utilisé.
Propriétés de sortie
- Enregistrer le document de sortie à l’aide de : indiquez l’emplacement d’enregistrement du fichier de sortie. Vous pouvez enregistrer le fichier de sortie à un emplacement relatif à la payload, dans une variable ou spécifier un emplacement absolu pour enregistrer le fichier de sortie. Si le chemin d’accès n’existe pas dans le référentiel crx, un administrateur peut le créer avant de l’utiliser.
Propriétés avancées
-
Sélectionner l’emplacement racine du contenu à l’aide de : la racine du 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 ressources relatives utilisées 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’URI racine du contenu doit avoir 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électionner un fichier XCI à l’aide de : les fichiers XCI sont utilisés pour 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 payload, à un chemin d’accès absolu ou à l’aide d’une variable de type de données Document.
-
Locale : définit 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 :
-
Utiliser le serveur par défaut : (par défaut) utilisez le paramètre Paramètre régional qui est configuré sur le serveur AEM Forms. Le paramètre Paramètre régional est configuré à l’aide de la console d’administration. (Voir l’aide de Designer.)
-
Pour utiliser une valeur personnalisée :
saisissez le code de paramètre régional dans la zone littérale ou sélectionnez une variable de chaîne contenant le code de paramètre régional. Pour obtenir une liste complète des codes des paramètres régionaux pris en charge, voir https://java.sun.com/j2se/1.5.0/docs/guide/intl/locale.doc.html.
-
-
Copies : une valeur entière qui spécifie le nombre de copies à générer pour la sortie. La valeur par défaut est 1.
-
Duplex Printing : une valeur Pagination qui spécifie l’utilisation de l’impression recto verso ou recto. Les imprimantes prenant en charge PostScript et PCL utilisent cette valeur. Si vous fournissez une valeur littérale, sélectionnez l’une de ces valeurs :
- Duplex Long Edge : utiliser l’impression recto verso et imprimer à l’aide de la pagination sur le bord long.
- Duplex Short Edge : utiliser l’impression recto verso et imprimer à l’aide de la pagination sur le bord court.
- Simplex : utiliser l’impression recto.