Desarrollo con servicios Output y Forms en AEM Forms developing-with-output-and-forms-services-in-aem-forms
Obtenga información sobre el desarrollo con la salida y la API de servicio de Forms en AEM Forms.
En este artículo echaremos un vistazo a lo siguiente
- Servicio de salida: normalmente este servicio se usa para combinar datos xml con la plantilla xdp o el pdf para generar un pdf aplanado.
- FormsService: se trata de un servicio muy versátil que le permite procesar xdp como pdf y exportar/importar datos desde y hacia el archivo PDF.
El siguiente fragmento de código exporta datos desde un archivo de PDF
javax.servlet.http.Part pdfPart = request.getPart("pdffile");
String filePath = request.getParameter("saveLocation");
java.io.InputStream pdfIS = pdfPart.getInputStream();
com.adobe.aemfd.docmanager.Document pdfDocument = new com.adobe.aemfd.docmanager.Document(pdfIS);
com.adobe.fd.forms.api.FormsService formsservice = sling.getService(com.adobe.fd.forms.api.FormsService.class);
com.adobe.aemfd.docmanager.Document xmlDocument = formsservice.exportData(pdfDocument,com.adobe.fd.forms.api.DataFormat.Auto);
La línea 1 extrae el archivo .pd de la solicitud
La línea 2 extrae saveLocation de la solicitud
La línea 5 se hace con FormsService
La línea 6 exporta los xmlData desde el archivo del PDF
Para probar el paquete de muestra en el sistema
AEM Descargue e instale el paquete mediante el administrador de paquetes de la
Después de instalar el paquete, tendrá que lista de permitidos las siguientes direcciones URL en el filtro CSRF de Adobe Granite.
- Siga los pasos que se mencionan a continuación para lista de permitidos las rutas mencionadas anteriormente.
- Iniciar sesión en configMgr
- Búsqueda de Adobe Granite CSRF Filter
- Añada las 3 rutas siguientes en las secciones excluidas y guarde
- /content/AemFormsSamples/mergedata
- /content/AemFormsSamples/exportdata
- /content/AemFormsSamples/outputservice
- /content/AemFormsSamples/renderxdp
- Busque "Filtro de referente de Sling"
- Marque la casilla "Permitir vacío". (Esta configuración solo debe ser para fines de prueba)
Prueba de las muestras
Existen varias formas de probar el código de ejemplo. La forma más rápida y sencilla de usar una aplicación de Postman es. Postman le permite realizar solicitudes de POST al servidor.
- Instale la aplicación de Postman en su sistema.
- Inicie la aplicación e introduzca la dirección URL adecuada
- Asegúrese de haber seleccionado "POST" en la lista desplegable
- Asegúrese de especificar "Autorización" como "Autenticación básica". AEM Especifique el nombre de usuario y la contraseña del servidor de
- Especifique los parámetros de solicitud en la pestaña del cuerpo
- Haga clic en el botón Send
El paquete contiene 4 muestras. En los siguientes párrafos se explica cuándo utilizar el servicio de salida o el servicio Forms, la dirección URL del servicio y los parámetros de entrada que espera cada servicio
Usar OutputService para combinar datos con la plantilla xdp
-
Utilice el servicio Output para combinar datos con documentos xdp o pdf para generar PDF aplanados
-
URL DE POST: http://localhost:4502/content/AemFormsSamples/outputservice.html
-
Parámetros de solicitud -
- xdp_or_pdf_file : archivo xdp o pdf con el que desea combinar los datos
- xmlfile: archivo de datos xml que se combina con xdp_or_pdf_file
- saveLocation: la ubicación para guardar el documento procesado en el sistema de archivos. Por ejemplo, c:\documents\sample.pdf
Usar la API de FormsService
Importar datos
-
Utilice FormsService importData para importar datos en un archivo de PDF
-
URL DE POST - http://localhost:4502/content/AemFormsSamples/mergedata.html
-
Parámetros de solicitud:
- archivo PDF : El archivo PDF con el que desea combinar los datos
- xmlfile: archivo de datos xml que se combina con el archivo pdf
- saveLocation: la ubicación para guardar el documento procesado en el sistema de archivos. Por ejemplo,
c:\\outputsample.pdf.
Exportar datos
-
Utilice la API exportData de FormsService para exportar datos desde el archivo del PDF
-
URL DE POST - http://localhost:4502/content/AemFormsSamples/exportdata.html
-
Parámetros de solicitud:
- archivo PDF : El archivo PDF desde el que desea exportar los datos
- saveLocation: La ubicación para guardar los datos exportados en el sistema de archivos. Por ejemplo, c:\documents\export_data.xml
Procesar XDP
- Procesar una plantilla XDP como PDF estático/dinámico
- Utilice la API renderPDFForm de FormsService para procesar la plantilla xdp como PDF
- URL DE POST - http://localhost:4502/content/AemFormsSamples/renderxdp?xdpName=f1040.xdp
- Parámetro de solicitud:
- xdpName: nombre del archivo xdp que se procesará como pdf
Puede importar esta colección de Postman para probar la API