Adobe Experience Manager (versión preliminar)
La integración de Adobe Experience Manager permite el acceso a los servicios relacionados con Adobe Experience Manager Forms (por ejemplo, comunicaciones y mucho más). Esta integración también permitirá que los flujos se desencadenen cuando se envíe un formulario a través de Adobe Experience Manager Forms.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Premium | Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Nombre | Formularios de Adobe Experience Manager |
| URL | https://www.adobe.com/go/adobe-experience-manager-forms-community |
| Correo Electrónico | aem-pa@adobe.com |
| Metadatos del conector | |
|---|---|
| Publicador | Adobe |
| Sitio web | https://business.adobe.com/products/experience-manager/forms/aem-forms.html |
| Directiva de privacidad | https://www.adobe.com/in/privacy/policy.html |
| Categorías | Productividad; Gestión empresarial |
Puede usar el conector de Adobe Experience Manager para acceder a los formularios de Adobe Experience Manager: funcionalidades de comunicación para crear un documento PDF basado en un diseño de formulario y datos de formulario XML o crear PostScript (PS), Lenguaje de comandos de impresora (PCL), Lenguaje de impresión zebra (ZPL) y otros documentos del lenguaje de definición de impresora.
Prerrequisitos
Necesita una licencia y acceso a Adobe Experience Manager Forms como servicio en la nube: API de comunicación para usar el conector.
Obtención de credenciales
Puede empezar a trabajar con Adobe Experience Manager fácilmente con solo unos pocos pasos:
Generación de las credenciales del servicio
Use adobe Experience Manager Developer Console para generar las credenciales de servicio.
Configurar la conexión
Agregue sus credenciales de servicio al conector de Adobe Experience Manager. Puede obtener credenciales de JSON de credenciales de servicio y copiar estos detalles de credenciales en la configuración de conexión única:
- Identificador de la organización
- Id. de cliente
- Secreto del cliente
- Identificador de cuenta técnica
- Ámbitos meta
- Clave privada
- Adobe IMS Host URL
Para AEM Server, especifique la dirección URL de la instancia de Creación o publicación del servicio en la nube de Adobe Experience Manager. Por ejemplo: https://publish-pXXXX-eXXXXX.adobeaemcloud.com
Introducción al conector
El conector admite las siguientes operaciones:
Generar un documento PDF a partir de una plantilla y combinar datos
Puede crear un documento PDF basado en un diseño de formulario y datos de formulario XML. Le ayuda a crear documentos aprobados por la marca, personalizados y estandarizados, como correspondencia comercial, declaraciones, cartas de procesamiento de reclamaciones, avisos de beneficios, facturas mensuales o kits de bienvenida.
Un flujo de trabajo básico consiste en combinar datos de formulario XML con un diseño de formulario para crear un documento PDF. Puede crear una plantilla en el Diseñador de formularios de Adobe Experience Manager.
La salida de la operación es un documento PDF no interactivo. Es decir, los usuarios no pueden escribir ni modificar los datos del formulario. Puede especificar los parámetros siguientes para configurar varias opciones para la operación:
| Parámetro | Obligatorio (obligatorio) | Description |
|---|---|---|
| Template | Sí | La plantilla define la apariencia y el comportamiento del documento PDF. La API admite plantillas de formato: documento XDP y PDF. Puede especificar una ruta de acceso completa, una ruta de acceso de referencia del repositorio de Adobe Experience Manager o un archivo binario. |
| Data | Sí | Un archivo XML que contiene los datos que se van a combinar con la plantilla. Puede especificar una ubicación HTTP completa o un archivo binario. |
| Configuración de XCI | No | El servicio usa un archivo de configuración XCI para configurar varias propiedades del documento PDF. El parámetro XCI tiene un efecto solo cuando la plantilla es de tipo XDP o un documento PDF basado en XDP. Puede especificar una ruta de acceso completa, una ruta de acceso de referencia del repositorio de Adobe Experience Manager o un archivo binario. |
| Configuración regional | No | Configuración regional en la que se debe representar pdf. |
| Raíz del contenido | No | Ubicación de los recursos de plantilla (imágenes, fragmentos y mucho más). Esta ruta de acceso es relativa a la ubicación de la plantilla. |
| Adición de etiquetas a PDF | No | Especifique para crear un PDF con etiquetas para optimizarlo para su uso con lectores de pantalla y otra tecnología de asistencia. |
| Insertar fuentes en PDF | No | Al insertar una fuente, la fuente incrustada también tiene el mismo aspecto en todos los dispositivos, pero se genera un archivo de salida mayor. |
| Linearizar PDF (Vista web rápida) | No | Elección para optimizar el PDF para vista web rápida |
| Conservar el estado | No | Un documento PDF interactivo contiene varios elementos que constituyen un formulario. Estos elementos pueden incluir campos (para aceptar o mostrar datos), botones (para desencadenar eventos) y scripts (comandos para realizar una acción específica). Hacer clic en un botón puede desencadenar un evento que cambie el estado de un campo. Por ejemplo, elegir una opción de género puede cambiar el color de un campo o la apariencia del formulario. Este es un ejemplo de un evento manual que provoca que el estado del formulario cambie. Cuando este tipo de documento PDF interactivo se aplana mediante las funcionalidades de comunicación de Formularios de Adobe Experience Manager, el estado del formulario no se conserva. Para asegurarse de que el estado del formulario se conserva incluso después de que se aplane el formulario, establezca el valor booleano Conservar estado en True para guardar y conservar el estado del formulario. |
| Conservar campos de firma sin firmar | No | Especifica si los campos de firma firmados y sin firmar se conservan cuando se aplana un archivo PDF. |
| Versión de Adobe Acrobat Reader | No | Especifica la versión mínima de Acrobat Reader necesaria para abrir el documento PDF. La versión predeterminada es Adobe Acrobat 11. |
Generar un postScript (PS), lenguaje de comandos de impresora (PCL), lenguaje de impresión zebra (ZPL), DPL (lenguaje de programación Datamax), IPL (lenguaje de impresora intermec), TPCL (lenguaje de comandos de impresora TEC) a partir de una plantilla y datos
Puede usar api de generación de documentos para crear postScript (PS), lenguaje de comandos de impresora (PCL), lenguaje de impresión zebra (ZPL), DPL (lenguaje de programación Datamax), IPL (lenguaje de impresora intermec), documento TPCL (lenguaje de comandos de impresora TEC) basado en un diseño de formulario XDP o documento PDF. Estas API ayudan a combinar un diseño de formulario con datos de formulario para generar un documento. Puede guardar el documento en un archivo y usar Power Automate para enviarlo a una impresora. Puede especificar los parámetros siguientes para configurar varias opciones para la operación:
| Parámetro | Obligatorio (obligatorio) | Description |
|---|---|---|
| Template | Sí | La plantilla define la apariencia y el comportamiento del documento PDF. La API admite plantillas de formato: documento XDP y PDF. Puede especificar una ruta de acceso completa, una ruta de acceso de referencia del repositorio de Adobe Experience Manager o un archivo binario. |
| Data | Sí | Un archivo XML que contiene los datos que se van a combinar con la plantilla. Puede especificar una ubicación HTTP completa o un archivo binario. |
| Perfil de impresora | Sí | Especifica el archivo XDC que se va a usar. Los archivos XDC son archivos de descripción de impresora en formato XML. La funcionalidad comunicaciones de Formularios de Adobe Experience Manager usa archivos XDC para generar documentos a formatos como, PostScript, PCL, DPL, TPCL y ZPL. Los archivos XDC también se usan para especificar opciones de impresión, como el número de copias, si se usa la impresora dúplex o las opciones de grapa. |
| Tipo de salida | Sí | Especifica el tipo de archivo de salida para la operación. Las opciones admitidas son PostScript (PS), Printer Command Language (PCL), Zebra Printing Language (ZPL), DPL (Datamax Programming Language), IPL (Intermec Printer Language), TPCL (TEC Printer Command Language). |
| Configuración de XCI | No | Especifica el archivo XCI que se va a usar. Los archivos XCI se usan para describir las fuentes que se usan para los elementos de diseño de formulario. Puede especificar una ruta de acceso completa, una ruta de acceso de referencia del repositorio de Adobe Experience Manager o un archivo binario. |
| Configuración regional | No | Configuración regional en la que se debe representar la salida. |
| Raíz del contenido | No | Ubicación de los recursos de plantilla (imágenes, fragmentos y mucho más). Esta ruta de acceso es relativa a la ubicación de la plantilla. |
| Número de copias | No | Especifica el número de copias del archivo de salida que se van a generar. |
| Paginación | No | Especifica si se va a usar la impresión de dos caras o de un solo lado. Las impresoras que admiten PostScript y PCL usan este valor. |
Errores y soluciones comunes
| Código de error | Description | Resolución |
|---|---|---|
| 403 | Prohibido. Debe ser miembro del grupo de usuarios de formularios para realizar el uso de la API. | Haga que el miembro de la cuenta técnica del grupo forms-users, publique tanto el usuario (cuenta técnica) como el grupo (forms-users). |
| 400 | La plantilla especificada no es válida. Especifique una plantilla válida y vuelva a intentarlo. | Cuando el valor del template parámetro es texto sin formato y no una dirección URL, convierta la cadena xml de datos en binario. Puede usar la expresión binary() de Microsoft Power Automate para realizar la conversión. Cuando use la ruta de acceso DE JCR, agregue crx:// prefijo a la ruta de acceso. |
| 400 | Los datos especificados no son válidos. Vuelva a intentarlo con un archivo de datos válido. | Cuando el valor del data parámetro es texto sin formato y no una dirección URL, convierta la cadena xml de datos en binario. Puede usar la expresión binary() de Microsoft Power Automate para realizar la conversión. |
| 400 | La configuración XCI especificada contiene algunos valores no válidos. Corrija el archivo de configuración y vuelva a intentarlo. | Cuando el valor del XCI configuration parámetro es texto sin formato y no una dirección URL, convierta la cadena xml de datos en binario. Puede usar la expresión binary() de Microsoft Power Automate para realizar la conversión. |
Creación de una conexión
El conector admite los siguientes tipos de autenticación:
| Predeterminado | Parámetros para crear una conexión. | Todas las regiones | No se puede compartir |
Predeterminado
Aplicable: Todas las regiones
Parámetros para crear una conexión.
Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.
| Nombre | Tipo | Description | Obligatorio |
|---|---|---|---|
| Servidor AEM | cuerda / cadena | Especifique la dirección URL de la instancia de creación o publicación de AEM. | Cierto |
| Id. de organización (organización) | cuerda / cadena | Especifique el identificador de la organización. | Cierto |
| Id. de cliente (clientId) | cuerda / cadena | Especifique el identificador de cliente de las credenciales de servicio. | Cierto |
| Secreto de cliente (clientSecret) | securestring | Especifique el secreto de cliente de las credenciales de servicio. | Cierto |
| Identificador de cuenta técnica (id.) | cuerda / cadena | Especifique el identificador de la cuenta técnica de AEM. | Cierto |
| Meta Scopes (metascopes) | cuerda / cadena | Especifique Meta Scopes from your service credentials (Meta Scopes from your service credentials). | Cierto |
| Clave privada (privateKey) | securestring | Proporcione la clave privada. Se incluye en las credenciales del servicio. | Cierto |
| Dirección URL del host de Adobe IMS (imsEndpoint) | cuerda / cadena | Proporcione la dirección URL del host del servicio Adobe Identity Management. | Cierto |
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Generación de un PDF a partir de una plantilla y datos (versión preliminar) |
Genere un documento PDF a partir de una plantilla PDF o XDP y combine datos XML con él. |
| Generar un archivo PS, PCL, ZPL, DPL, IPL o TPCL a partir de una plantilla y datos (versión preliminar) |
Generar un postScript (PS), lenguaje de comandos de impresora (PCL), lenguaje de impresión zebra (ZPL), DPL (lenguaje de programación Datamax), IPL (lenguaje de impresora intermec) o TPCL (lenguaje de comandos de impresora TEC) a partir de un archivo XDP o documento PDF y combinar datos XML en él. |
Generación de un PDF a partir de una plantilla y datos (versión preliminar)
Genere un documento PDF a partir de una plantilla PDF o XDP y combine datos XML con él.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Template
|
template | True | binary |
Proporcione el archivo binario o la ubicación de la plantilla XDP o PDF. |
|
Data
|
data | True | binary |
Proporcione el archivo binario o la ubicación de los datos XML que se van a combinar con la plantilla. |
|
Configuración de XCI
|
xci | binary |
Proporcione el archivo binario o la ubicación del archivo de configuraciones XCI. |
|
|
Configuración regional
|
locale | string |
Seleccione una configuración regional para el documento PDF. |
|
|
Raíz del contenido
|
contentRoot | string |
Especifique el URI, la referencia absoluta o la ubicación para recuperar los recursos usados en la plantilla. |
|
|
Adición de etiquetas a PDF
|
isTagged | boolean |
Cree un PDF con etiquetas para optimizar PDF para aquellos que usan lectores de pantalla y otra tecnología de asistencia. |
|
|
Insertar fuentes en PDF
|
embedFonts | boolean |
Insertar fuentes en PDF para una apariencia coherente entre dispositivos y pantallas |
|
|
Linearizar PDF (Vista web rápida)
|
linearizedPDF | boolean |
Elección para optimizar el PDF para vista web rápida |
|
|
Conservar el estado
|
retainFormState | boolean |
Elija conservar el estado del documento después de que se aplane. |
|
|
Conservar campos de firma sin firmar
|
retainUnsignedSignatureFields | boolean |
Seleccione esta opción para conservar o quitar los campos de firma sin firmar. |
|
|
Versión de Adobe Acrobat Reader
|
acrobatVersion | string |
Seleccione la versión mínima de Acrobat Reader necesaria para abrir el documento PDF. |
Devoluciones
- response
- PDFResult
Generar un archivo PS, PCL, ZPL, DPL, IPL o TPCL a partir de una plantilla y datos (versión preliminar)
Generar un postScript (PS), lenguaje de comandos de impresora (PCL), lenguaje de impresión zebra (ZPL), DPL (lenguaje de programación Datamax), IPL (lenguaje de impresora intermec) o TPCL (lenguaje de comandos de impresora TEC) a partir de un archivo XDP o documento PDF y combinar datos XML en él.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Template
|
template | True | binary |
Proporcione el archivo binario o la ubicación de la plantilla XDP o PDF. |
|
Data
|
data | True | binary |
Proporcione el archivo binario o la ubicación de los datos XML que se van a combinar con la plantilla. |
|
Configuración de XCI
|
xci | binary |
Proporcione el archivo binario o la ubicación del archivo de configuraciones XCI. |
|
|
Configuración regional
|
locale | string |
Seleccione la configuración regional del archivo de salida. |
|
|
Raíz del contenido
|
contentRoot | string |
Especifique el URI, la referencia absoluta o la ubicación para recuperar los recursos usados en la plantilla. |
|
|
Número de copias
|
copies | integer |
Especifique el número de copias que se van a producir. |
|
|
Paginación
|
paginationOverride | string |
Establezca la opción para imprimir en un lado o ambos lados de una página. |
|
|
Perfil de impresora
|
xdcUri | True | string |
Elija un archivo XDC que describa las funcionalidades de impresora, como las características de la impresora y los tipos de papel. |
|
Tipo de salida
|
renderType | True | string |
Elija entre los tipos de salida disponibles. |
Devoluciones
- response
- PrintedResult
Definiciones
PDFResult
- PDFOutput
- binary
PrintedResult
- PrintedOutput
- binary