Configurer Automated Forms Conversion service (AFCS)
- Rubriques :
- Formulaires adaptatifs
Créé pour :
- Débutant
- Intermédiaire
- Administration
- Développeur
- Utilisateur ou utilisatrice
Cet article décrit comment un administrateur ou une administratrice AEM peut configurer le service de conversion automatisée de formulaires (AFCS) pour automatiser la conversion des formulaires PDF en formulaires adaptatifs. Cet article est destiné aux administrateurs et administratrices informatiques et AEM de votre organisation. Il s’adresse à un public familiarisé avec les technologies suivantes :
-
installation, configuration et administration des packages Adobe Experience Manager et AEM ;
-
utilisation des systèmes d’exploitation Linux® et Microsoft® Windows® ;
Intégration
Le service est disponible gratuitement pour les clientes et clients AEM 6.5 Forms On-Premise et les clientes et clients d’entreprise Adobe Managed Service. Vous pouvez contacter l’équipe de ventes d’Adobe ou votre représentant Adobe pour demander l’accès au service. Le service est également disponible gratuitement et préactivé pour les clients AEM Forms as a Cloud Service.
Adobe autorise l’accès de votre entreprise et fournit les privilèges requis à la personne désignée comme administrateur au sein de votre entreprise. L’administrateur peut autoriser les développeurs (utilisateurs) AEM Forms de votre entreprise à se connecter au service.
Prérequis
Pour utiliser Automated Forms Conversion service (AFCS), les conditions suivantes doivent être remplies :
- activation de Automated Forms Conversion service (AFCS) pour votre entreprise ;
- compte Adobe ID avec des privilèges d’administration pour le service de conversion ;
- version AEM 6.5 opérationnelle avec le dernier pack de services AEM ou instance de création AEM Forms as a Cloud Service avec les dernières mises à jour ;
- utilisateur AEM (sur votre instance AEM) membre du groupe d’utilisateurs de formulaires.
Configuration de l’environnement
Avant d’utiliser le service, préparez votre instance d’auteur AEM à la connexion au service exécuté sur Adobe Cloud. Pour préparer votre instance à la connexion au service, procédez aux étapes suivantes dans l’ordre indiqué :
1. Télécharger et installer AEM 6.5 ou intégrer AEM Forms as a Cloud Service
Le service de conversion automatisée des formulaires (AFCS) s’exécute sur une instance de création AEM. Vous avez besoin d’AEM 6.5 ou d’AEM Forms as a Cloud Service pour configurer une instance de création AEM.
-
Si vous n’avez pas AEM 6.5 en état de fonctionnement, téléchargez-le à partir des emplacements ci-dessous. Après avoir téléchargé AEM, consultez la page Déploiement et maintenance pour obtenir des instructions sur la configuration d’une instance de création AEM:
-
Si vous êtes déjà client AEM, téléchargez AEM 6.5 sur le site Web Adobe Licensing.
-
Si vous êtes un partenaire Adobe, utilisez le programme de formation des partenaires Adobe pour demander AEM 6.5.
-
-
Si vous utilisez AEM Forms as a Cloud Service, consultez les instructions d’intégration d’AEM Forms as a Cloud Service et configurez un environnement de développement local.
2. (Pour AEM 6.5 uniquement) télécharger et installer le dernier pack de services AEM
Téléchargez et installez le dernier pack de services AEM. Pour obtenir des instructions détaillées, reportez-vous à la section Notes de mise à jour du pack de services AEM 6.5.
3. (Pour AEM 6.5 uniquement) Télécharger et installer le dernier module complémentaire d’AEM Forms
Une instance AEM contient des fonctionnalités de formulaires de base. Le service de conversion nécessite toutes les capacités d’AEM Forms. Téléchargez et installez le package complémentaire AEM Forms pour bénéficier de toutes les capacités d’AEM Forms. Le package est requis pour la configuration et l’exécution du service de conversion. Pour obtenir des instructions détaillées, consultez Installer et configurer les fonctionnalités de capture de données.
https://adminconsole.adobe.com/
NOTE4. Créer des thèmes et des modèles personnalisés
Les packages de référence contiennent des exemples de thèmes et de modèles. Automated Forms Conversion service (AFCS) a besoin d’au moins un thème et un modèle pour convertir un formulaire PDF en un formulaire adaptatif. Créez un thème et un modèle personnalisés et configurez le service de sorte à utiliser les modèles et thèmes personnalisés avant d’utiliser le service.
Vous pouvez également télécharger et installer le package AEM Forms Reference Assets sur votre instance d’auteur. Ce dernier crée des thèmes de référence et un modèle.
Configurer l’accès et les autorisations
Avant de procéder à la configuration du service et à la connexion de votre instance au service exécuté sur Adobe Cloud, découvrez les types de personnes et les privilèges requis pour la connexion au service. Le service nécessite deux types de personnes différentes : les administrateurs et les développeurs.
- Administrateurs : les administrateurs sont responsables de la gestion des logiciels et des services Adobe pour leur entreprise. Les administrateurs et administratrices autorisent les développeurs et développeuses de leur entreprise à se connecter à Automated Forms Conversion service (AFCS) exécuté sur Adobe Cloud. Lorsqu’un membre de l’administration est nommé pour une entreprise, il reçoit un e-mail intitulé « Vous disposez désormais des droits d’administration pour gérer les logiciels et services Adobe pour votre entreprise ». Si vous êtes un administrateur, vérifiez si vous avez reçu le message mentionné ci-dessus et accordez l’accès aux développeurs de votre entreprise.
- Développeurs et développeuses : un développeur ou une développeuse connecte une instance de création AEM Forms au service de conversion automatisée de formulaires (AFCS) en cours d’exécution sur Adobe Cloud. Lorsqu’un administrateur ou une administratrice autorise un développeur ou une développeuse à se connecter à Automated Forms Conversion service (AFCS), ce dernier ou cette dernière reçoit un e-mail intitulé « Vous disposez désormais d’un accès en tant que développeur ou développeuse pour gérer les intégrations d’API Adobe de votre entreprise ». Si vous êtes un développeur, vérifiez si vous avez reçu le message mentionné ci-dessus et connectez votre instance AEM locale au service de conversion automatisée de formulaires sur Adobe Cloud.
Accorder l’accès aux développeurs et développeuses de votre organisation
Une fois qu’Adobe a autorisé l’accès de votre entreprise et octroyé les privilèges requis à l’administrateur ou à l’administratrice, ce dernier ou cette dernière peut se connecter à l’Admin Console (voir les instructions détaillées ci-dessous), créer un profil et ajouter des développeurs et des développeuses au profil. Les développeurs et développeuses peuvent connecter une instance d’AEM Forms au service de conversion automatisée de formulaires (AFCS) sur Adobe Cloud.
Les développeurs et les développeuses sont des membres de votre entreprise désignés pour exécuter le service de conversion. Seuls les développeurs et développeuses ajoutés au profil du service de conversion automatisée de formulaires (AFCS) Adobe sont autorisés à utiliser ce dernier.
Pour créer un profil et y ajouter des développeurs, procédez comme suit : Au moins un profil est nécessaire pour accorder l’accès requis aux développeurs de votre entreprise :
-
Connectez-vous à l’Admin Console. Utilisez l’Adobe ID d’administration fourni afin d’utiliser le service de conversion automatisée de formulaires (AFCS) pour vous connecter.
-
Cliquez sur l’option Automated Forms Conversion (Conversion automatisée de formulaires).
-
Cliquez sur New Profile (Nouveau profil) dans l’onglet Products (Produits).
-
Renseignez les champs suivants dans le profil :Name (Nom), Display Name (Nom d’affichage) et Description. Cliquez sur Done (Terminé). Par exemple, créez un profil en tant que AFC_Flamingo_Test_Dev.
-
Ajoutez un développeur au profil. Pour ajouter les développeurs :
- Dans l’Admin Console, accédez à l’onglet de présentation.
- Cliquez sur Assign Developers (Attribuer des développeurs) sur la carte de produit requise.
- Saisissez les adresses électroniques des développeurs et éventuellement leurs noms et prénoms.
- Sélectionnez les profils de produits. Cliquez sur Enregistrer.
Répétez les étapes ci-dessus pour tous les utilisateurs. Pour plus de détails sur l’ajout de développeurs, consultez la page Gérer les développeurs.
Une fois qu’un administrateur ou une administratrice a ajouté des développeurs et développeuses au profil Adobe I/O, ces derniers et dernières reçoivent une notification par e-mail (si l’option est configurée).
Ajouter un utilisateur au groupe forms-users
Indiquez une adresse e-mail dans le profil de la personne AEM désignée pour exécuter le service. Assurez-vous que la personne est membre du groupe forms-users. Les courriers électroniques sont envoyés à l’adresse de l’utilisateur qui procède à la conversion. Pour indiquer l’adresse de l’utilisateur et ajouter un utilisateur au groupe d’utilisateurs de formulaires :
-
Connectez-vous à votre instance d’auteur AEM Forms en tant qu’administrateur AEM. Utilisez vos informations d’identification AEM locales pour vous connecter.
-
Cliquez sur Adobe Experience Manager > Outils > Sécurité > Utilisateurs et utilisatrices.
-
Sélectionnez un utilisateur ou une utilisatrice en charge de l’exécution du service de conversion et cliquez sur Propriétés. La page Modifier les paramètres d’utilisation s’affiche.
-
Indiquez une adresse e-mail dans le champ E-mail et cliquez sur Enregistrer. Les e-mails sont envoyés à l’adresse indiquée en cas de réussite ou d’échec de la conversion.
-
Cliquez sur l’onglet Groupes. Dans l’onglet de sélection de groupe, saisissez et sélectionnez le groupe d’utilisateurs et d’utilisatrices des formulaires.
-
Cliquez sur Enregistrer et fermer. La personne est maintenant membre du groupe forms-users.
Connecter votre instance AEM Forms au service de conversion automatisée de formulaires (AFCS) sur Adobe Cloud
Une fois qu’un administrateur ou une administratrice vous a accordé un accès en tant que développeur ou développeuse, vous pouvez connecter votre instance AEM Forms au service de conversion automatisée de formulaires (AFCS) exécuté sur Adobe Cloud.
Pour connecter l’instance AEM Forms au service de conversion automatisée de formulaires, procédez comme suit :
1. Configurer les API de service sur Adobe Developer Console
2. Créer des configurations Adobe IMS
3. Créer une configuration de conversion automatisée de formulaires
1. Configurer les API de service sur Adobe Developer Console
Pour utiliser le service de conversion automatisée de formulaires (AFCS), créez un projet et ajoutez l’API Automated Forms Configuration Service au projet sur Adobe Developer Console. L’intégration génère la clé API, le secret client, l’ID de compte technique, les portées et l’ID d’organisation.
Pour configurer l’API du service de conversion automatisée de formulaires sur Adobe Developer Console, procédez comme suit :
-
Connectez-vous à https://developer.adobe.com/console . Utilisez votre Adobe ID et le compte de développement que votre administration a mis à votre disposition pour vous connecter à la console Adobe I/O.
-
Sélectionnez votre entreprise dans le coin supérieur droit. Si vous ne connaissez pas le nom de votre entreprise, contactez votre administrateur ou administratrice.
-
Cliquez sur Créer un projet. Un écran pour démarrer votre nouveau projet apparaît.
-
Cliquez sur Ajouter une API. Un écran avec la liste de toutes les API activées pour votre compte apparaît.
-
Sélectionnez Service de conversion automatisée de formulaires et cliquez sur Suivant. Un écran de configuration de l’API apparaît.
-
Sélectionnez la méthode d’authentification OAuth de serveur à serveur.
-
Spécifiez le Nom de l’information d’identification et cliquez sur Suivant.
-
Sélectionnez un profil de produit. Par exemple, sélectionnez un profil en tant que AFC_Flamingo_Test_Dev.
-
Cliquez sur Enregistrer l’API configurée.
NOTESélectionnez le profil créé tout en accordant l’accès aux développeurs et développeuses de votre entreprise. Si vous ne savez pas quel profil sélectionner, contactez votre administrateur ou administratrice. -
Cliquez sur OAuth de serveur à serveur pour afficher la clé API, le secret client et d’autres informations nécessaires pour connecter votre instance AEM au service de conversion automatisée de formulaires (AFCS).
Les informations de la page sont utilisées pour créer la configuration IMS, comme expliqué dans la section Créer une configuration technique IMS sur l’instance de création AEM.
2. Créer des configurations Adobe IMS
Connectez-vous à votre instance de création pour créer les configurations Adobe IMS. Utilisez la variable Détails des informations d’identification OAuth pour récupérer la clé API, le secret client, l’ID de compte technique, les portées et l’ID d’organisation.
-
Connectez-vous à votre instance de création AEM Forms. Accédez à Outils > Sécurité > Configurations Adobe IMS.
-
Cliquez sur Créer.
-
La page Adobe IMS Technical Account Configuration (Configuration de compte technique Adobe IMS) s’affiche.
-
Sélectionnez Service de conversion automatisée de formulaires dans Solution cloud.
-
Indiquez les informations suivantes :
-
Titre : indiquez un titre.
-
Serveur d’autorisation : https://ims-na1.adobelogin.com
-
Récupérez les éléments suivants à partir de la section Configurer les API de service sur Adobe Developer Console :
- ID client : copiez et collez Clé API (ID client).
- Secret client : copiez et collez Secret client.
- Portée : copiez et collez Portées.
- ID d’organisation : copiez et collez ID de compte technique.
-
-
Cliquez sur Enregistrer. La configuration Adobe IMS est alors créée.
CAUTIONCréez une seule configuration IMS. Ne créez pas plusieurs configurations IMS. -
Sélectionnez la configuration Adobe IMS et cliquez sur Contrôle de l’intégrité. Une boîte de dialogue s’affiche.
Une boîte de dialogue de contrôle s’affiche.
-
Cliquez sur Vérifier.
Une fois la connexion établie, le message Token retrieved successfully (Jeton récupéré) s’affiche.
-
Cliquez sur Fermer.
3. Créer une configuration de conversion automatisée de formulaires
Créez une configuration de conversion automatisée de formulaires pour connecter votre instance AEM au service de conversion. Cela vous permet également de spécifier un modèle, un thème et des fragments de formulaire pour une conversion. Vous pouvez créer plusieurs configurations de service cloud distinctes pour chaque jeu de formulaires.
Par exemple, vous pouvez avoir une configuration donnée pour les formulaires du service commercial et une autre pour les formulaires de support client. Pour créer une configuration de service cloud, procédez comme suit :
-
Sur votre instance AEM Forms, cliquez sur Adobe Experience Manager > Outils > Services cloud > Configuration de conversion automatisée de formulaires.
-
Sélectionnez le dossier Global et cliquez sur Créer.
La page de création de la configuration de conversion automatisée de formulaires apparaît. La configuration est créée dans le dossier Global. Vous pouvez également créer la configuration dans un dossier différent qui existe déjà ou créer un dossier pour vos configurations.
-
Sur la page Créer une configuration de conversion automatisée de formulaires, spécifiez la valeur des champs suivants et cliquez sur Suivant.
ChampDescriptionTitle (Titre)Titre unique pour la configuration. Le titre s’affiche dans l’interface utilisateur utilisée pour démarrer la conversion.Name (Nom)Nom unique pour la configuration. La configuration est enregistrée dans le référentiel crx-repository sous le nom indiqué. Le nom peut être identique au titre.Thumbnail location (Emplacement de la miniature)Emplacement de la miniature de la configuration.Service URL (URL du service)URL de Automated Forms Conversion service (AFCS) sur Adobe Cloud. Utilisez l’URL suivante :https://aemformsconversion.adobe.io/.Template (Modèle)Modèle par défaut à appliquer aux formulaires convertis. Vous pouvez toujours indiquer un modèle différent avant de démarrer la conversion. Un modèle contient une structure de base et un contenu initial pour un formulaire adaptatif. Vous pouvez choisir un modèle parmi les modèles prêts à l’emploi. Vous pouvez également créer un modèle personnalisé.Theme (Thème)Thème par défaut à appliquer aux formulaires convertis. Vous pouvez toujours indiquer un thème différent avant de démarrer la conversion. Vous pouvez cliquer sur l’icône pour choisir un thème prêt à l’emploi. Vous pouvez également créer un thème personnalisé.Existing Fragments (Fragments existants)Emplacement des fragments existants, le cas échéant.Custom Meta-model (Métamodèle personnalisé)Chemin d’accès du fichier .schema.json du métamodèle personnalisé. Vous pouvez créer des métamodèles distincts pour l’anglais, le français, l’allemand, l’espagnol, l’italien et le portugais. -
Dans l’onglet Avancé de la page Créer une configuration de conversion automatisée de formulaires, spécifiez la valeur des champs suivants :
ChampDescriptionGenerate Document of Record (Générer un document d’enregistrement)Sélectionnez l’option pour générer automatiquement un document d’enregistrement pour les formulaires convertis. L’option est uniquement destinée aux formulaires basés sur XFA (formulaires XDP et PDF). Lorsque vous activez l’option, après l’envoi d’un formulaire, vous pouvez autoriser vos clients à conserver un enregistrement, sous forme imprimée ou en tant que document, des informations qu’ils ont intégrées au formulaire à des fins de référence ultérieure. On parle ici de document d’enregistrement.Enable Analytics (Activer Adobe Analytics)(Pour AEM 6.5) sélectionnez l’option permettant d’activer Adobe Analytics pour tous les formulaires convertis. Avant d’utiliser cette option, assurez-vous qu’Adobe Analytics est activé pour votre instance AEM Forms.- Lorsque la source est un formulaire basé sur XFA avec l’extension .XDP, le document d’enregistrement de sortie conserve la disposition XFA. Sinon, le service de conversion utilise un modèle prêt à l’emploi pour générer un document d’enregistrement pour d’autres formulaires basés sur XFA.
- Lors de l’envoi d’un formulaire XFA, les données d’envoi du formulaire sont enregistrées en tant qu’attribut ou élément XML. Par exemple,
<Amount currency="USD"> 10.00 </Amount>. La devise est enregistrée en tant qu’attribut et le montant de la devise, 10.00, est enregistré en tant qu’élément. L’envoi de données d’un formulaire adaptatif n’a pas d’attributs, simplement des éléments. Ainsi, lorsqu’un formulaire basé sur XFA est converti en formulaire adaptatif, les données d’envoi de formulaire adaptatif contiennent un élément pour chacun de ces attributs. Par exemple :
{ "Type": "Principal", "Amount": "10.00", "currency": "USD" } -
Cliquez sur Créer. La configuration cloud est alors créée. Votre instance AEM Forms est prête à commencer la conversion des formulaires hérités en formulaires adaptatifs.