Adobe Experience Manager (préversion)
L’intégration d’Adobe Experience Manager permet d’accéder aux services liés aux formulaires Adobe Experience Manager (par exemple, Communications et bien plus encore). Cette intégration permet également aux flux d’être déclenchés lorsqu’un formulaire est envoyé via adobe Experience Manager Forms.
Ce connecteur est disponible dans les produits et régions suivants :
| Service | classe | Régions |
|---|---|---|
| Copilot Studio | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Applications logiques | Norme | Toutes les régions Logic Apps , à l’exception des suivantes : - Régions Azure Government - Régions Azure Chine - Us Department of Defense (DoD) |
| Power Apps | Premium | Toutes les régions Power Apps , à l’exception des suivantes : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Contact | |
|---|---|
| Nom | Formulaires Adobe Experience Manager |
| URL | https://www.adobe.com/go/adobe-experience-manager-forms-community |
| Messagerie électronique | aem-pa@adobe.com |
| Métadonnées du connecteur | |
|---|---|
| Éditeur | Adobe |
| Site internet | https://business.adobe.com/products/experience-manager/forms/aem-forms.html |
| Politique de confidentialité | https://www.adobe.com/in/privacy/policy.html |
| Catégories | Productivité; Gestion de l’entreprise |
Vous pouvez utiliser le connecteur Adobe Experience Manager pour accéder aux formulaires Adobe Experience Manager - Fonctionnalités de communication pour créer un document PDF basé sur une conception de formulaire et des données de formulaire XML ou créer postScript (PS), le langage de commande d’imprimante (PCL), le ZPL (Zebra Printing Language) et d’autres documents de langage de définition d’imprimante.
Prerequisites
Vous avez besoin d’une licence et d’un accès à Adobe Experience Manager Forms en tant que service cloud - API de communication pour utiliser le connecteur.
Comment obtenir des informations d’identification
Vous pouvez commencer facilement avec Adobe Experience Manager en quelques étapes :
Générer les informations d’identification du service
Utilisez adobe Experience Manager Developer Console pour générer les informations d’identification du service.
Configurer votre connexion
Ajoutez vos informations d’identification de service au connecteur Adobe Experience Manager. Vous pouvez obtenir des informations d’identification à partir des informations d’identification du service JSON et copier ces informations d’identification dans votre configuration de connexion unique :
- ID d’organisation
- ID de client
- Clé secrète client
- ID de compte technique
- Étendues meta
- Clé privée
- URL de l’hôte Adobe IMS
Pour AEM Server, spécifiez l’URL de votre instance Adobe Experience Manager Cloud Service Author ou Publish. Par exemple, https://publish-pXXXX-eXXXXX.adobeaemcloud.com
Bien démarrer avec votre connecteur
Le connecteur prend en charge les opérations suivantes :
Générer un document PDF à partir d’un modèle et fusionner des données
Vous pouvez créer un document PDF basé sur une conception de formulaire et des données de formulaire XML. Il vous aide à créer des documents approuvés, personnalisés et standardisés tels que des correspondances commerciales, des déclarations, des lettres de traitement des demandes, des avis d’avantages, des factures mensuelles ou des kits de bienvenue.
Un flux de travail de base consiste à fusionner des données de formulaire XML avec une conception de formulaire pour créer un document PDF. Vous pouvez créer un modèle dans Adobe Experience Manager Forms Designer.
La sortie de l’opération est un document PDF non interactif. Autrement dit, les utilisateurs ne peuvent pas entrer ou modifier les données du formulaire. Vous pouvez spécifier les paramètres suivants pour configurer différentes options pour l’opération :
| Paramètre | Obligatoire (obligatoire) | Descriptif |
|---|---|---|
| Template | Oui | Le modèle définit l’apparence et le comportement du document PDF. L’API prend en charge les modèles de format : XDP et document PDF. Vous pouvez spécifier un chemin complet, un chemin d’accès de référence de votre référentiel Adobe Experience Manager ou un fichier binaire. |
| Data | Oui | Fichier XML contenant les données à fusionner avec un modèle. Vous pouvez spécifier un emplacement HTTP complet ou un fichier binaire. |
| Configuration XCI | Non | Le service utilise un fichier de configuration XCI pour configurer différentes propriétés du document PDF. Le paramètre XCI a un effet uniquement lorsque le modèle est de type XDP ou un document PDF basé sur XDP. Vous pouvez spécifier un chemin complet, un chemin d’accès de référence de votre référentiel Adobe Experience Manager ou un fichier binaire. |
| Paramètres régionaux | Non | Paramètres régionaux dans lesquels le fichier pdf doit être rendu. |
| Racine du contenu | Non | Emplacement des ressources de modèle (images, fragments, etc.). Ce chemin d’accès est relatif à l’emplacement du modèle. |
| Ajouter des balises au format PDF | Non | Spécifiez la création d’un fichier PDF avec des balises pour l’optimiser à utiliser avec les lecteurs d’écran et d’autres technologies d’assistance. |
| Incorporer des polices au format PDF | Non | Lorsque vous incorporez une police, la police incorporée ressemble également à tous les appareils, mais un fichier de sortie plus volumineux est produit. |
| Linearize PDF (Affichage web rapide) | Non | Choisir d’optimiser le PDF pour l’affichage web rapide |
| Conserver l’état | Non | Un document PDF interactif contient différents éléments qui constituent un formulaire. Ces éléments peuvent inclure des champs (pour accepter ou afficher des données), des boutons (pour déclencher des événements) et des scripts (commandes pour effectuer une action spécifique). Cliquer sur un bouton peut déclencher un événement qui modifie l’état d’un champ. Par exemple, le choix d’une option de sexe peut modifier la couleur d’un champ ou l’apparence du formulaire. Il s’agit d’un exemple d’événement manuel qui entraîne la modification de l’état du formulaire. Lorsqu’un tel document PDF interactif est aplatit à l’aide des fonctionnalités de communication des formulaires Adobe Experience Manager, l’état du formulaire n’est pas conservé. Pour vous assurer que l’état du formulaire est conservé même après l’aplatissement du formulaire, définissez la valeur booléenne Conserver l’état Conserver sur True pour enregistrer et conserver l’état du formulaire. |
| Conserver les champs de signature non signés | Non | Spécifie si les champs de signature signés et non signés sont conservés lorsqu’un fichier PDF est aplatis |
| Version d’Adobe Acrobat Reader | Non | Spécifie la version minimale d’Acrobat Reader requise pour ouvrir le document PDF. La version par défaut est Adobe Acrobat 11. |
Générer un postScript (PS), un langage de commande d’imprimante (PCL), un langage d’impression Zebra (ZPL), un DPL (langage de programmation Datamax), un fichier IPL (langage d’imprimante Intermec), des fichiers TPCL (langage de commande d’imprimante TEC) à partir d’un modèle et de données
Vous pouvez utiliser les API de génération de documents pour créer postScript (PS), le langage de commande d’imprimante (PCL), le langage d’impression Zebra (ZPL), le DPL (langage de programmation Datamax), l’IPL (langage d’imprimante Interèque), le document TPCL (TEC Printer Command Language) basé sur une conception de formulaire XDP ou un document PDF. Ces API permettent de fusionner une conception de formulaire avec des données de formulaire pour générer un document. Vous pouvez enregistrer le document dans un fichier et utiliser Power Automate pour l’envoyer à une imprimante. Vous pouvez spécifier les paramètres suivants pour configurer différentes options pour l’opération :
| Paramètre | Obligatoire (obligatoire) | Descriptif |
|---|---|---|
| Template | Oui | Le modèle définit l’apparence et le comportement du document PDF. L’API prend en charge les modèles de format : XDP et document PDF. Vous pouvez spécifier un chemin complet, un chemin d’accès de référence de votre référentiel Adobe Experience Manager ou un fichier binaire. |
| Data | Oui | Fichier XML contenant les données à fusionner avec un modèle. Vous pouvez spécifier un emplacement HTTP complet ou un fichier binaire. |
| Profil d’imprimante | Oui | Spécifie le fichier XDC à utiliser. Les fichiers XDC sont des fichiers de description d’imprimante au format XML. La fonctionnalité Adobe Experience Manager Forms Communications utilise des fichiers XDC pour générer des documents dans des formats tels que PostScript, PCL, DPL, TPCL et ZPL. Les fichiers XDC sont également utilisés pour spécifier des options d’impression telles que le nombre de copies, si l’imprimante duplex est utilisée ou les options d’agrafeur. |
| Type de sortie | Oui | Spécifie le type de fichier de sortie de l’opération. Les options prises en charge sont PostScript (PS), Printer Command Language (PCL), Zebra Printing Language (ZPL), DPL (Datamax Programming Language), IPL (Inter olm Printer Language), TPCL (TEC Printer Command Language). |
| Configuration XCI | Non | Spécifie le fichier XCI à utiliser. Les fichiers XCI sont utilisés pour décrire les polices utilisées pour les éléments de conception de formulaire. Vous pouvez spécifier un chemin complet, un chemin d’accès de référence de votre référentiel Adobe Experience Manager ou un fichier binaire. |
| Paramètres régionaux | Non | Paramètres régionaux dans lesquels la sortie doit être rendue. |
| Racine du contenu | Non | Emplacement des ressources de modèle (images, fragments, etc.). Ce chemin d’accès est relatif à l’emplacement du modèle. |
| Nombre de copies | Non | Spécifie le nombre de copies du fichier de sortie à produire. |
| Numérotation des pages | Non | Spécifie s’il faut utiliser l’impression à deux côtés ou à côté unique. Les imprimantes qui prennent en charge PostScript et PCL utilisent cette valeur. |
Erreurs courantes et solutions
| Code d’erreur | Descriptif | Résolution |
|---|---|---|
| 4:03 | Interdit. Vous devez être membre du groupe d’utilisateurs de formulaires pour effectuer l’utilisation de l’API. | Rendre le compte technique membre du groupe formulaires-utilisateurs, publier à la fois l’utilisateur (compte technique) et le groupe (utilisateurs de formulaires). |
| 400 | Le modèle spécifié n’est pas valide. Spécifiez un modèle valide et réessayez. | Lorsque la valeur du paramètre est du texte brut et non une URL, convertissez la chaîne xml de template données en binaire. Vous pouvez utiliser l’expression binary() de Microsoft Power Automate pour effectuer la conversion. Lorsque vous utilisez le chemin JCR, ajoutez crx:// préfixe au chemin d’accès. |
| 400 | Les données spécifiées ne sont pas valides. Réessayez avec un fichier de données valide. | Lorsque la valeur du paramètre est du texte brut et non une URL, convertissez la chaîne xml de data données en binaire. Vous pouvez utiliser l’expression binary() de Microsoft Power Automate pour effectuer la conversion. |
| 400 | La configuration XCI spécifiée contient des valeurs non valides. Corrigez le fichier de configuration et réessayez. | Lorsque la valeur du paramètre est du texte brut et non une URL, convertissez la chaîne xml de XCI configuration données en binaire. Vous pouvez utiliser l’expression binary() de Microsoft Power Automate pour effectuer la conversion |
Création d’une connexion
Le connecteur prend en charge les types d’authentification suivants :
| Par défaut | Paramètres de création de connexion. | Toutes les régions | Non partageable |
Faire défaut
Applicable : Toutes les régions
Paramètres de création de connexion.
Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.
| Nom | Type | Descriptif | Obligatoire |
|---|---|---|---|
| Serveur AEM | ficelle | Spécifiez l’URL de votre instance AEM Author ou Publish. | Vrai |
| ID d’organisation (org) | ficelle | Spécifiez votre ID d’organisation. | Vrai |
| ID client (clientId) | ficelle | Spécifiez l’ID client de vos informations d’identification de service. | Vrai |
| Clé secrète client (clientSecret) | securestring | Spécifiez la clé secrète client à partir de vos informations d’identification de service. | Vrai |
| ID de compte technique (ID) | ficelle | Spécifiez l’ID de votre compte technique AEM. | Vrai |
| Étendues meta (métascopes) | ficelle | Spécifiez les étendues meta de vos informations d’identification de service. | Vrai |
| Clé privée (privateKey) | securestring | Indiquez la clé privée. Il est inclus dans les informations d’identification du service. | Vrai |
| URL de l’hôte Adobe IMS (imsEndpoint) | ficelle | Fournissez l’URL de l’hôte du service Adobe Identity Management. | Vrai |
Limitations
| Nom | Appels | Période de renouvellement |
|---|---|---|
| Appels d’API par connexion | 100 | 60 secondes |
Actions
| Générer un fichier PDF à partir d’un modèle et de données (préversion) |
Générez un document PDF à partir d’un modèle PDF ou XDP et fusionnez-y des données XML. |
| Générer un fichier PS, PCL, ZPL, DPL, IPL ou TPCL à partir d’un modèle et de données (préversion) |
Générez un postScript (PS), un langage de commande d’imprimante (PCL), un langage d’impression Zebra (ZPL), un DPL (langage de programmation Datamax), un document IPL (langage d’imprimante interèque) ou TPCL (TEC Printer Command Language) à partir d’un fichier XDP ou d’un document PDF et fusionnez les données XML. |
Générer un fichier PDF à partir d’un modèle et de données (préversion)
Générez un document PDF à partir d’un modèle PDF ou XDP et fusionnez-y des données XML.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Template
|
template | True | binary |
Fournissez le fichier binaire ou l’emplacement du modèle XDP ou PDF. |
|
Data
|
data | True | binary |
Fournissez le fichier binaire ou l’emplacement des données XML à fusionner avec le modèle. |
|
Configuration XCI
|
xci | binary |
Fournissez le fichier binaire ou l’emplacement du fichier de configurations XCI. |
|
|
Paramètres régionaux
|
locale | string |
Sélectionnez des paramètres régionaux pour le document PDF. |
|
|
Racine du contenu
|
contentRoot | string |
Spécifiez l’URI, la référence absolue ou l’emplacement pour récupérer les ressources utilisées dans le modèle. |
|
|
Ajouter des balises au format PDF
|
isTagged | boolean |
Créez un fichier PDF avec des balises pour optimiser le pdf pour ceux qui utilisent des lecteurs d’écran et d’autres technologies d’assistance. |
|
|
Incorporer des polices au format PDF
|
embedFonts | boolean |
Incorporer des polices au format PDF pour une apparence cohérente entre les appareils et les écrans |
|
|
Linearize PDF (Affichage web rapide)
|
linearizedPDF | boolean |
Choisir d’optimiser le PDF pour l’affichage web rapide |
|
|
Conserver l’état
|
retainFormState | boolean |
Choisissez de conserver l’état du document une fois qu’il aplatit. |
|
|
Conserver les champs de signature non signés
|
retainUnsignedSignatureFields | boolean |
Sélectionnez cette option pour conserver ou supprimer les champs de signature non signés |
|
|
Version d’Adobe Acrobat Reader
|
acrobatVersion | string |
Sélectionnez la version minimale d’Acrobat Reader requise pour ouvrir le document PDF. |
Retours
- response
- PDFResult
Générer un fichier PS, PCL, ZPL, DPL, IPL ou TPCL à partir d’un modèle et de données (préversion)
Générez un postScript (PS), un langage de commande d’imprimante (PCL), un langage d’impression Zebra (ZPL), un DPL (langage de programmation Datamax), un document IPL (langage d’imprimante interèque) ou TPCL (TEC Printer Command Language) à partir d’un fichier XDP ou d’un document PDF et fusionnez les données XML.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Template
|
template | True | binary |
Fournissez le fichier binaire ou l’emplacement du modèle XDP ou PDF. |
|
Data
|
data | True | binary |
Fournissez le fichier binaire ou l’emplacement des données XML à fusionner avec le modèle. |
|
Configuration XCI
|
xci | binary |
Fournissez le fichier binaire ou l’emplacement du fichier de configurations XCI. |
|
|
Paramètres régionaux
|
locale | string |
Sélectionnez les paramètres régionaux du fichier de sortie. |
|
|
Racine du contenu
|
contentRoot | string |
Spécifiez l’URI, la référence absolue ou l’emplacement pour récupérer les ressources utilisées dans le modèle. |
|
|
Nombre de copies
|
copies | integer |
Spécifiez le nombre de copies à produire. |
|
|
Numérotation des pages
|
paginationOverride | string |
Définissez l’option pour imprimer d’un côté ou les deux côtés d’une page. |
|
|
Profil d’imprimante
|
xdcUri | True | string |
Choisissez un fichier XDC décrivant les fonctionnalités d’imprimante, telles que les fonctionnalités de l’imprimante et les types de papier. |
|
Type de sortie
|
renderType | True | string |
Choisissez parmi les types de sortie disponibles. |
Retours
- response
- PrintedResult
Définitions
PDFResult
- PDFOutput
- binary
PrintedResult
- PrintedOutput
- binary