Processus basé sur l’utilisation de Forms sur OSGi

Les entreprises collectent les données à partir de centaines, voire de milliers de formulaires, de différents systèmes principaux et de sources de données en ligne ou hors ligne. Elles disposent également d’un ensemble dynamique d’utilisateurs pour prendre des décisions concernant les données, qui impliquent les processus de révision et d’approbation itératifs.

Avec les processus de révision et d’approbation pour les publics internes et externes, les grandes entreprises sont soumises à des tâches répétitives : par exemple, la conversion d’un document PDF dans un autre format. Ces tâches prennent beaucoup de temps et mobilisent un grand nombre de ressources lorsqu’elles sont effectuées manuellement. Les entreprises ont également des obligations légales consistant à signer numériquement un document et à archiver des données de formulaire pour une utilisation ultérieure dans des formats prédéfinis…

Présentation du processus basé sur l’utilisation de Forms sur OSGi

Vous pouvez utiliser des processus AEM pour créer rapidement des processus basés sur des formulaires adaptatifs. Ces processus peuvent être utilisés pour la révision et l’approbation, les flux de processus d’entreprise, le démarrage de Documents Services, l’intégration du processus de signature Adobe Sign et des opérations similaires : par exemple, le traitement de l’application de cartes de crédit, les processus d’approbation de congés des employés et l’enregistrement d’un formulaire en tant que document PDF. De plus, ces processus peuvent être utilisés dans une entreprise ou sur le pare-feu réseau.

Avec le processus basé sur l’utilisation de Forms on OSGi, vous pouvez rapidement créer et déployer des processus pour différentes tâches sur la pile OSGi, sans avoir à installer la fonctionnalité Process Management complète sur la pile JEE. Le développement et la gestion des processus utilisent les fonctionnalités de boîte de messagerie AEM et AEM Workflow habituelles. Les processus forment la base de l’automatisation des processus réels d’entreprise, qui s’étendent sur plusieurs systèmes logiciels, réseaux, services et même organisations.

Une fois configurés, ces processus peuvent être déclenchés manuellement pour terminer une exécution ou un processus défini par programmation lorsque les utilisateurs envoient un formulaire ou une lettre Correspondence Management. Avec des fonctionnalités AEM Workflow améliorées, AEM Forms offre deux fonctionnalités distinctes mais similaires. Dans le cadre de votre stratégie de déploiement, vous devez décider laquelle vous convient le mieux. Référez-vous à la comparaison des workflows centrés sur les formulaires AEM sur OSGi et de la gestion des processus sur JEE. De plus, pour la topologie de déploiement, voir Topologies d’architecture et de déploiement pour AEM Forms.

Le processus basé sur l’utilisation de Forms sur OSGi étend la boîte de messagerie AEM et fournit des composants supplémentaires (étapes) pour que l’éditeur du processus AEM ajoute la prise en charge des processus AEM basés sur l’utilisation d’AEM Forms. La boîte de messagerie AEM étendue dispose de fonctionnalités similaires à celles de l’espace de travail AEM Forms. Avec la gestion des processus basés sur les utilisateurs (approbation, révision, etc.), vous pouvez utiliser des processus AEM pour automatiser les opérations liées à Document Services (par exemple, la génération de PDF) et à la signature de documents (Adobe Sign) par voie électronique.

Toutes les étapes des processus AEM Forms prennent en charge l’utilisation de variables. Les variables permettent aux étapes de processus de contenir et de transmettre des métadonnées entre les étapes au moment de l’exécution. Vous pouvez créer différents types de variables pour stocker différents types de données. Vous pouvez également créer des collections de variables pour stocker plusieurs instances de données associées et du même type. En règle générale, vous utilisez une variable ou une collection de variables lorsque vous devez prendre une décision en fonction de la valeur qu’elle contient ou pour stocker des informations dont vous aurez besoin ultérieurement dans un processus. Pour plus d’informations sur l’utilisation de variables dans ces composants (étapes) de processus basés sur Forms, voir Processus basé sur l’utilisation de Forms sur OSGi - Guide de référence des étapes. Pour plus d’informations sur la création et la gestion des variables, voir Variables dans les processus AEM.

Le diagramme suivant illustre le processus complet de création, d’exécution et contrôle d’un processus basé sur l’utilisation de Forms sur OSGi.

introduction-à-aem-forms-workflow

Avant de commencer

  • Un processus est une représentation d’un processus réel d’entreprise. Conservez votre processus réel d’entreprise et répertoriez les participants du processus d’entreprise qui sont prêts. Par ailleurs, préparez les éléments associés (formulaires adaptatifs, documents PDF, etc.) avant de créer un processus.
  • Un processus peut se composer de plusieurs étapes. Ces étapes sont répertoriées dans la boîte de réception AEM et facilitent la progression de rapport du processus. Divisez votre processus d’entreprise en étapes logiques.
  • Vous pouvez configurer l’étape de tâche affectée des processus AEM pour envoyer des notifications électroniques aux utilisateurs ou aux personnes désignées. Ainsi, autorisez les notifications électroniques.
  • Un processus peut également utiliser Adobe Sign pour les signatures numériques. Si vous envisagez d’utiliser Adobe Sign dans un processus, configure Adobe Sign pour AEM Forms avant de l’utiliser dans un processus.

Créer un modèle de processus

Un modèle de processus se compose de la logique et du flux d’un processus d’entreprise. Il se compose d’une série d’étapes. Ces étapes sont des composants d’AEM. Vous pouvez étendre les étapes de workflow avec des paramètres et des scripts pour proposer davantage de fonctionnalités et de contrôle, selon les besoins. AEM Forms fournit quelques étapes supplémentaires par rapport aux étapes AEM prêtes à l’emploi. Pour obtenir la liste détaillée des étapes AEM et AEM Forms, consultez Référence sur les étapes de processus AEM et Référence sur les étapes du processus basé sur l’utilisation de Forms on OSGi.

AEM fournit une interface utilisateur intuitive pour créer un modèle de processus en suivant les étapes de processus fournies. Pour des instructions détaillées pour créer un modèle de processus, voir Création de modèles de processus. L’exemple suivant fournit des instructions détaillées pour créer un modèle de processus pour un processus d’approbation et de révision :

REMARQUE

Vous devez être membre du groupe d’éditeurs de processus pour créer ou modifier un modèle de processus.

Création d’un modèle pour un processus d’approbation et de révision

Le processus d’approbation et de révision est destiné aux tâches qui nécessitent une intervention humaine pour une prise de décisions. L’exemple suivant crée un modèle de processus pour une demande de prêt immobilier à remplir par un conseiller bancaire. Une fois remplie, la demande est envoyée pour approbation. Par la suite, la demande approuvée est envoyée au demandeur pour les signatures électroniques à l’aide d’Adobe Sign.

L’exemple est disponible en tant que module joint ci-dessous. Importez et installez l’exemple à l’aide du gestionnaire de modules. Vous pouvez également effectuer les opérations suivantes afin de créer manuellement le modèle de processus de la demande :

Cet exemple crée un modèle de processus pour une demande de prêt immobilier à remplir par un conseiller bancaire. Une fois remplie, la demande est envoyée pour approbation. Par la suite, la demande approuvée est envoyée au client pour les signatures électroniques à l’aide d’Adobe Sign. Vous pouvez importer et installer l’exemple à l’aide du gestionnaire de modules.

Obtenir le fichier

  1. Ouvrez la console Modèles de processus. L’URL par défaut est https://[server]:[port]/libs/cq/workflow/admin/console/content/models.html/etc/workflow/models

  2. Sélectionnez Créer, puis Créer un modèle. La boîte de dialogue Ajouter un modèle de processus s’ouvre.

  3. Saisissez Titre et Nom (facultatif). par exemple, une demande de prêt immobilier. Appuyez sur Terminé.

  4. Sélectionnez le processus nouvellement créé et appuyez sur Modifier. Désormais, vous pouvez ajouter des étapes de processus pour créer une logique d’entreprise. Lorsque vous créez un modèle de processus pour la première fois, il contient :

    • les étapes : Début du processus et Fin du processus. Ces étapes définissent le début et la fin du processus. Ces étapes sont obligatoires et ne peuvent pas être modifiées ou supprimées.
    • Un exemple d’étape Participant, dont le nom est Étape 1. Cette étape est configurée pour affecter un élément de travail à l’utilisateur administrateur. Supprimez cette étape.

  5. Activez les notifications électroniques. Vous pouvez configurer le processus basé sur l’utilisation de Forms sur OSGi pour qu’il envoie des notifications électroniques aux utilisateurs ou personnes désignées. Effectuez les configurations suivantes pour activer les notifications électroniques :

    1. Accédez au gestionnaire de configuration AEM à l’adresse https://[server]:[port]/system/console/configMgr.
    2. Ouvrez la configuration du Service de messagerie Day CQ. Spécifiez une valeur pour les champs Nom d’hôte du serveur SMTP, Port du serveur SMTP et Adresse de l’expéditeur. Cliquez sur Enregistrer.
    3. Ouvrez la configuration de Day CQ Link Externalizer. Dans le champ Domaines, spécifiez le nom de hôte /l’adresse IP et le numéro de port réels pour les instances locale, de l’auteur et de publication. Cliquez sur Enregistrer.

  6. Créez des étapes de processus. Un processus peut se composer de plusieurs étapes. Ces étapes sont affichées dans la boîte de réception AEM et signalent la progression du processus.

    Pour définir une étape, appuyez sur l’icône info-circle pour ouvrir les propriétés de modèle de processus, ouvrez l’onglet Étapes, ajoutez des étapes au modèle de processus et appuyez sur Enregistrer et fermer. Pour l’exemple de demande de prêt immobilier, créez des étapes : demande de prêt, état de la demande de prêt, documents à signer et document de prêt signé.

  7. Glissez-déposez l’explorateur d’étapes Affecter une tâche dans le modèle de processus. Faites-en la première étape du modèle.

    Le composant de tâche affecte la tâche créée par processus à un utilisateur ou à un groupe. Lors de l’affectation de la tâche, vous pouvez utiliser le composant pour spécifier un formulaire adaptatif ou un fichier PDF non interactif pour 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 l’étape pour contrôler le comportement de la tâche. Par exemple, lors de la création d’un document d’enregistrement automatique, affectez la tâche à un utilisateur ou un groupe spécifique, le chemin des données envoyées, le chemin des données pré-renseignées et les actions par défaut. Pour obtenir des informations détaillées sur les options de l’étape d’affectation de tâche, consultez le document Référence sur les étapes du processus basé sur l’utilisation de Forms sur OSGi.

    workflow-editor

    Pour l’exemple de demande de prêt immobilier, configurez l’étape Affecter une tâche pour utiliser un formulaire adaptatif en lecture seule et afficher le document PDF une fois la tâche terminée. Par ailleurs, sélectionnez le groupe d’utilisateurs autorisé à approuver la demande de prêt. Dans l’onglet Actions, désactivez l’option Envoyer. Créez une variable actionTaken de type de données de chaîne et spécifiez la variable en tant que Variable d’itinéraire. par exemple, actionTaken. Ajoutez également les itinéraires Approuver et Refuser. Les itinéraires sont affichés sous forme d’actions distinctes (boutons) dans la boîte de réception AEM. Le processus sélectionne une branche en fonction de l’action (bouton) sélectionnée par l’utilisateur.

    Vous pouvez importer l’exemple de module, disponible pour téléchargement au début de la section, pour l’ensemble complet des valeurs de tous les champs de l’étape Affecter une tâche configurée, par exemple la demande de prêt immobilier.

  8. Faites glisser et déposez le composant Division OU de l’explorateur d’étapes vers le modèle de processus. L’étape de division OU divise le processus et une seule branche est active par la suite. Cette étape permet d’ajouter des chemins de traitement conditionnels dans le processus. Vous ajoutez des étapes de processus à chaque branche selon vos besoins.

    Vous pouvez définir l’expression de routage d’une branche à l’aide d’une définition de règle, d’un script ECMA ou d’un script externe.

    Utilisez l’éditeur d’expressions pour créer des expressions de routage pour les branches 1 et 2. Ces expressions de routage permettent de sélectionner une branche en fonction de l’action de l’utilisateur dans la boîte de réception AEM.

    Expression de routage pour la branche 1

    Lorsqu’un utilisateur clique sur le bouton Approuver dans la boîte de réception AEM, la Branche 1 est activée.

    OU Exemple de fractionnement

    Expression de routage pour la branche 2

    Lorsqu’un utilisateur clique sur Refuser dans la boîte de réception AEM, la Branche 2 est activée.

    OU Exemple de fractionnement

    Pour plus d’informations sur la création d’expressions de routage à l’aide de variables, consultez Variables dans les processus AEM Forms.

  9. Ajoutez d’autres étapes de processus pour créer une logique d’entreprise.

    Pour l’exemple de prêt immobilier, ajoutez un document d’enregistrement généré, deux étapes Affecter une tâche et une étape de signature de document pour la Branche 1 du modèle, comme affiché dans l’image ci-dessous. Une étape Affecter une tâche consiste à afficher et envoyer des documents de prêt à signer au demandeur et un autre composant de tâche consiste à afficher les documents signés. Ajoutez également un composant Affecter une tâche à la branche 2. Il est activé lorsqu’un utilisateur clique sur Refuser dans la boîte de réception AEM.

    Pour obtenir l’ensemble complet des valeurs de tous les champs des étapes Affecter une tâche, de l’étape Document d’enregistrement et de l’étape Signer le document configurées pour l’exemple de demande de prêt immobilier, importez l’exemple de package, disponible au téléchargement au début de cette section.

    Le modèle de processus est prêt. Vous pouvez lancer le processus via différentes méthodes. Pour plus de détails, voir Lancement d’un processus basé sur l’utilisation de Forms sur OSGi.

    workflow-editor-mortgage

Créer une demande de processus basée sur l’utilisation de Forms

La demande est le formulaire adaptatif associé au processus. Lorsqu’une demande est envoyée via la boîte de réception, elle lance le processus associé. Pour rendre un processus Forms disponible en tant que demande dans la boîte de réception AEM et l’application AEM Forms, procédez comme suit pour créer une demande de processus :

REMARQUE

Vous devez être membre du groupe administrateur-fd pour être en mesure de créer et de gérer les demandes de processus.

  1. Sur votre instance de création AEM, accédez à tools-1 > Formulaires > Gérer la demande de processus et appuyez sur Créer.
  2. Dans la fenêtre Créer la demande de processus, saisissez des données dans les champs suivants et appuyez sur Créer. Une nouvelle demande est créée et est répertoriée dans l’écran Demandes de processus.
Champ Description
Titre Le titre est visible dans la boîte de réception AEM et permet aux utilisateurs de sélectionner une demande. Assurez-vous qu’il soit descriptif. Par exemple, Demande d’ouverture de compte d’épargne.
Nom Indiquez le nom de la demande. Tous les caractères autres que les lettres, chiffres, tirets et traits de soulignement ont été remplacés par des tirets.
Description La description est visible dans la boîte de réception AEM. Fournissez des informations détaillées sur la demande dans les champs de description. Par exemple, Objectif de la demande.
Formulaire adaptatif

Spécifiez le chemin d’un formulaire adaptatif. Lorsqu’un utilisateur commence une demande, le formulaire adaptatif spécifié est affiché.

Remarque : Les demandes de processus ne prennent pas en charge les formulaires et documents PDF de plus d’une page ou qui nécessitent un défilement sur l’iPad d’Apple. Lorsqu’une demande est ouverte sur un iPad d’Apple et que la longueur du formulaire adaptatif ou du document PDF dépasse une page, les champs de formulaire et le contenu de la deuxième page sont perdus.
Groupes d’accès

Sélectionnez un groupe. La demande est visible dans la boîte de réception AEM uniquement pour les membres du groupe sélectionné. L’option Accès au groupe permet de sélectionner tous les groupes du groupe d’utilisateurs du processus.


Service de préremplissage Sélectionnez un service de préremplissage pour le formulaire adaptatif.
Modèle de workflow Sélectionnez un modèle de processus pour la demande. Un modèle de processus se compose de la logique et du flux de processus d’entreprise.
Chemin d’accès au fichier de données Spécifiez le chemin du fichier de données dans le référentiel crx. Le chemin est relatif à la charge utile de formulaire adaptatif et contient le nom du fichier de données. Intégrez toujours le nom complet du fichier, y compris son extension, le cas échéant. Par exemple, [charge utile]/data.xml.
Chemin d’accès de la pièce jointe Spécifiez le chemin du fichier de pièces jointes dans le référentiel crx. Le chemin d’accès de la pièce jointe est relatif à l’emplacement de la charge utile. Par exemple, [charge utile]/data.xml.
Chemin d’accès du document d’enregistrement Spécifiez le chemin d’accès du fichier Document d’enregistrement dans le référentiel crx. Le chemin est relatif à l’emplacement de la charge utile du formulaire adaptatif. Intégrez toujours le nom complet du fichier, y compris son extension, le cas échéant. Par exemple, [charge utile]/DOR/creditcard.pdf.

Lancement d’un processus basé sur l’utilisation de Forms sur OSGi

Vous pouvez lancer ou de déclencher un processus basé sur l’utilisation de Forms en :

Envoyer une demande depuis la boîte de réception AEM

La demande de processus que vous avez créée est disponible en tant qu’application dans la boîte de réception. Les utilisateurs qui sont membres du groupe d’utilisateurs de processus peuvent renseigner et envoyer la demande qui déclenche le processus associé. Pour plus d’informations sur l’utilisation de la boîte de réception AEM pour envoyer des demandes et gérer des tâches, voir Gestion des applications et des tâches Forms dans la boîte de réception AEM.

Envoyant une demande depuis l’application AEM Forms

L’application AEM Forms se synchronise avec un serveur AEM Forms et vous permet de modifier les données de formulaire, les tâches, les demandes de processus et les informations enregistrées (brouillons/modèles) dans votre compte. Pour plus d’informations, consultez Application AEM Forms et les articles connexes.

Envoi d’un formulaire adaptatif

Vous pouvez configurer des actions d’envoi d’un formulaire adaptatif pour démarrer un processus lors de l’envoi du formulaire adaptatif. Les formulaires adaptatifs fournissent l’action d’envoi Appeler un processus AEM pour démarrer un processus lors de l’envoi d’un formulaire adaptatif. Pour obtenir des informations détaillées sur l’action d’envoi, voir Configuration de l’action d’envoi. Pour envoyer un formulaire adaptatif via l’application AEM Forms, activez la synchronisation avec l’application AEM Forms dans les propriétés du formulaire adaptatif.

Vous pouvez configurer la synchronisation, l’envoi et le déclenchement d’un processus depuis l’application AEM Forms. Pour plus de détails, consultez la section Utilisation d’un formulaire.

Utilisation d’un dossier de contrôle

Un administrateur (un membre du groupe administrateur-fd) peut configurer un dossier réseau pour exécuter un processus préconfiguré lorsqu’un utilisateur y place un fichier (tel qu’un fichier PDF). Une fois que le processus est terminé, vous pouvez enregistrer le fichier de sortie dans un dossier de sortie spécifié. Un tel fichier est appelé Dossier de contrôle. Effectuez la procédure suivante pour configurer un dossier de contrôle afin de lancer un processus :

  1. Sur votre instance d’auteur AEM, accédez à Outils-1 > Formulaires > Configurer le dossier de contrôle.  Une liste de dossiers de contrôle déjà configurés s’affiche.
  2. Appuyez sur Nouveau. Une liste des champs s’affiche. Spécifiez une valeur pour les champs suivants afin de configurer un dossier de contrôle pour un processus :
Champ Description
Nom Indiquez le nom du dossier de contrôle. Ce champ prend uniquement en charge les caractères alphanumériques.
Chemin Spécifiez l’emplacement physique du dossier de contrôle. Dans un environnement organisé en grappes, utilisez un dossier réseau partagé accessible à partir du noeud de la grappe AEM.
Traiter les fichiers avec Sélectionnez l’option Workflow.
Modèle de processus Sélectionnez un modèle de processus.
Modèle de fichier de sortie Indiquez la structure de répertoires pour les fichiers de sortie et les répertoires. Vous pouvez également spécifier un modèle pour les fichiers de sortie et les répertoires.

  1. Appuyez sur Avancé. Spécifiez une valeur pour le champ suivant puis cliquez sur Créer. Le dossier de contrôle est configuré pour lancer un processus. Désormais, chaque fois qu’un fichier est placé dans le répertoire d’entrée du dossier de contrôle, le processus spécifié est déclenché.

    Champ Description
    Filtre de mappeur de charge Lorsque vous créez un dossier de contrôle, il crée une structure de dossier dans le référentiel crx. La structure de dossier peut servir de charge utile au processus. Vous pouvez écrire un script pour mapper un processus AEM pour accepter les entrées de la structure du dossier de contrôle. Une implémentation prête à l’emploi est disponible et répertoriée dans le Filtre de mappeur de charge. Si vous ne disposez pas d’une implémentation personnalisée, choisissez l’implémentation par défaut.

    L’onglet Avancé contient davantage de champs. La plupart de ces champs contiennent une valeur par défaut. Pour en savoir plus sur tous les champs, voir l’article Création ou configuration d’un dossier de contrôle.

Envoi d’une communication interactive ou d’une lettre

Vous pouvez associer et exécuter un workflow basé sur l’utilisation de Forms sur OSGi lors de l’envoi d’une communication interactive ou d’une lettre. Dans le système de gestion de contenu, les workflows sont utilisés pour le post-traitement de communications interactives et de lettres. par exemple, l’envoi de courriers électroniques, l’impression, la télécopie ou l’archivage des lettres finales. Pour les étapes détaillées, voir Post-traitement des communications interactives et des lettres.

Autres configurations

Configuration du service de messagerie

Vous pouvez utiliser les étapes Affecter une tâche et Envoyer un courrier électronique des processus AEM pour envoyer un courrier électronique. Effectuez les étapes suivantes pour spécifier les serveurs de messagerie et les autres configurations requises pour l’envoi de courriers électroniques :

  1. Accédez au gestionnaire de configuration AEM à l’adresse https://[server]:[port]/system/console/configMgr.
  2. Ouvrez la configuration du Service de messagerie Day CQ. Spécifiez une valeur pour les champs Nom d’hôte du serveur SMTP, Port du serveur SMTP et Adresse de l’expéditeur. Cliquez sur Enregistrer.
  3. Ouvrez la configuration de Day CQ Link Externalizer. Dans le champ Domaines, spécifiez le nom de hôte /l’adresse IP et le numéro de port réels pour les instances locale, de l’auteur et de publication. Cliquez sur Enregistrer.

Purge des instances de processus

Réduire le nombre d’instances de processus améliore les performances du moteur de processus. Vous pouvez donc purger régulièrement les instances de processus terminées ou en cours d’exécution du référentiel. Pour plus d’informations, consultez Purge régulière des instances de processus purge des instances de processus.

Paramétrer les données sensibles aux variables de workflow et les stocker dans des magasins de données externes

Toutes les données envoyées à partir de formulaires adaptatifs vers des workflows Experience Manager peuvent avoir des PII (informations d’identification personnelles) ou SPD (données personnelles sensibles) des utilisateurs et utilisatrices finaux de votre entreprise. Toutefois, il n’est pas obligatoire de stocker vos données dans le Référentiel JCR d’Adobe Experience Manager. Vous pouvez externaliser le stockage des données des utilisateurs et utilisatrices finaux dans votre stockage de données géré (par exemple, le stockage Azure Blob) en paramétrant les informations dans variables de workflow.

Dans un workflow Adobe Experience Manager Forms, les données sont traitées et transmises par une série d’étapes de workflow au moyen de variables de workflow. Ces variables sont des propriétés nommées ou des paires clé-valeur stockées dans le nœud de métadonnées des instances de workflow ; par exemple, /var/workflow/instances/<serverid>/<datebucket>/<uniquenameof model>_<id>/data/metaData. Ces variables de workflow peuvent être externalisées dans un référentiel autre que JCR, puis traitées par des workflows Adobe Experience Manager. Adobe Experience Manager fournit une API UserMetaDataPersistenceProvider pour stocker les variables de workflow dans votre stockage externe géré. Pour en savoir plus sur l’utilisation de variables de workflow pour les magasins de données détenus par les client(e)s dans Adobe Experience Manager, reportez-vous à Administration des variables de workflow pour les magasins de données externes.
Adobe fournit l’exemple suivant pour stocker des variables d’un mappage de métadonnées de workflow vers le stockage Azure Blob, à l’aide de l’API UserMetaDataPersistenceProvider. Sur les lignes similaires, vous pouvez utiliser l’exemple comme guide d’utilisation de l’API [UserMetaDataPersistenceProvider] afin d’externaliser les variables de workflow de tout autre stockage de données externe vers Adobe Experience Manager et les gérer.

REMARQUE

Lorsque vous stockez vos variables de workflow dans un stockage de données externe, reportez-vous aux conseils de la section consignes relatives au stockage de données externe des workflows.

Installer l’exemple d’implémentation de l’API de workflow

Pour stocker des variables de workflow dans votre stockage Azure Blob géré :

  1. Installez l’exemple d’API de workflow UserMetaDataPersistenceProvider comme suit :

    1. Dans le répertoire racine du projet, exécutez la commande mvn clean install avec Maven 3.

    2. Pour déployer le lot et le module de contenu à créer, exécutez mvn clean install -PautoInstallPackage.

    3. Pour déployer uniquement le lot vers l’auteur, exécutez mvn clean install -PautoInstallBundle.

  2. Initialisez les propriétés suivantes dans le fichier de configuration OSGi de l’externaliseur dans le module de contenu ui.config :

       accountKey=""
   accountName=""
   endpointSuffix=""
   containerName=""
   protocol=""

Voici les objectifs (et exemples) de ces propriétés :

  • accountKey est la clé secrète pour autoriser l’accès.

  • accountName est le compte Azure où les données doivent être stockées.

  • endpointSuffix, par exemple core.windows.net.

  • containerName est le conteneur dans le compte où les données doivent être stockées. L’exemple suppose que le conteneur existe.

  • protocol, par exemple https ou http.

  1. Configurez le modèle de workflow dans Adobe Experience Manager. Pour savoir comment configurer le modèle de workflow pour un stockage externe, reportez-vous à Configurer le modèle de workflow.

Configurer le modèle de workflow dans Adobe Experience Manager pour le stockage de données externe

Pour configurer un modèle de workflow AEM pour le stockage de données externe :

  1. Accédez à Outils > Workflows > Modèles.

  2. Sélectionnez un nom de modèle et sélectionnez Modifier.

  3. Sélectionnez l’icône Informations sur la page, puis Ouvrir les propriétés.

  4. Sélectionnez Externaliser le stockage des données de workflow.

  5. Sélectionnez Enregistrer et fermer pour enregistrer les propriétés.

Recommandations pour les workflows d’AEM pour le stockage de données externes

Voici nos recommandations concernant l’utilisation des workflows Adobe Experience Manager et le stockage de données externe tels que le serveur de stockage Microsoft Azure :

  • Utilisez des variables pour stocker des données lors de la définition de fichiers de données d’entrée et de sortie et de pièces jointes dans les étapes du modèle de workflow. Ne sélectionnez pas les options Relatif à la charge et Disponible sur un chemin absolu. Les options Relatif à la payload et Disponible sur un chemin absolu ne s’affichent pas automatiquement lorsque vous configurez un modèle de workflow Adobe Experience Manager pour le stockage de données externe.

  • Utilisez des variables pour stocker le fichier de données et les pièces jointes lors de l’envoi d’un formulaire adaptatif à un workflow AEM. Ne sélectionnez pas l’option Relatif à la payload lors de l’envoi d’un formulaire adaptatif à un workflow Adobe Experience Manager. L’option Relatif à la payload ne s’affiche pas automatiquement une fois que vous avez configuré un modèle de workflow Adobe Experience Manager pour le stockage des données externe.

  • N’utilisez pas d’étape de workflow Adobe Experience Manager personnalisé dans un modèle de workflow pour stocker des données dans le référentiel CRX DE.

  • Lorsque vous configurez un modèle de workflow Adobe Experience Manager pour le stockage externe des données, ne créez pas de colonnes personnalisées pour la boîte de réception Adobe Experience Manager, car les valeurs des colonnes personnalisées ne sont pas récupérées si l’élément de travail de la boîte de réception Adobe Experience Manager appartient à un workflow marqué pour le stockage externe.

Sur cette page