Biblioteca .NET para crear informes altamente personalizados mediante API REST
Empiza la prueba gratuitaGroupDocs.Assembly Cloud es un servicio REST totalmente administrado que permite a los desarrolladores generar documentos con formato enriquecido mediante programación.
El servicio funciona con archivos de plantilla (Word, Excel, PowerPoint, HTML, PDF o cualquiera de los formatos compatibles con OpenOffice) que contienen marcadores de posición especiales. En tiempo de ejecución, los datos de fuentes XML o JSON se vinculan a estos marcadores de posición mediante una sintaxis de expresión estilo LINQ, lo que permite inyectar valores simples, tablas, imágenes, gráficos, códigos de barras, hipervínculos e incluso contenido condicional. La infraestructura en la nube se encarga de todo el trabajo pesado: analizar la plantilla, realizar cálculos, renderizar gráficos y, finalmente, entregar el documento ensamblado en el formato solicitado (DOCX, PDF, HTML, PNG, etc.).
Como la API es independiente de la plataforma, se puede llamar desde cualquier lenguaje que permita emitir solicitudes HTTP. El .NET SDK encapsula las llamadas REST en una API nativa orientada a objetos, oculta los detalles de autenticación y proporciona modelos de solicitud/respuesta fuertemente tipados.
Flujo de trabajo típico de .NET
Instalar el SDK: añadir el paquete NuGet groupdocs.GroupDocs.Assembly-Cloud a su proyecto.
Configurar las credenciales: crear un objeto Configuration con el SID y la clave de la aplicación (obtenidos del panel de GroupDocs Cloud).
Subir la plantilla: usar UploadFile para colocar la plantilla en el almacenamiento en la nube de GroupDocs.
Preparar la fuente de datos: leer el archivo XML o JSON (por ejemplo, datos de factura) en una cadena.
Establecer AssembleOptions: especificar el formato de salida, la cadena de datos y la ruta de la plantilla cargada. 6. Llamar a AssembleDocument: el SDK envía una única solicitud; la respuesta contiene el flujo de archivos generado.
Guardar o transmitir el resultado: escribir el archivo en el disco, enviarlo a un cliente o almacenarlo en la nube.
El SDK es de código abierto y se mantiene en GitHub: https://github.com/groupdocs-GroupDocs.Assembly-cloud/groupdocs-GroupDocs.Assembly-cloud-dotnet. Recibe actualizaciones periódicas, incluye pruebas unitarias completas y sigue el control de versiones semántico.
La seguridad está integrada: todo el tráfico está cifrado con SSL/TLS y el acceso está protegido por claves API personales. No se requiere software adicional ni componentes de terceros en el lado del cliente: el servicio se ejecuta completamente en la nube, lo que lo hace ideal para aplicaciones locales, sin servidor o de escritorio.
En resumen, GroupDocs.Assembly Cloud, junto con el SDK de .NET, le ofrece una solución escalable y de bajo código para generar contratos, facturas, informes, propuestas, cartas de combinación de correspondencia y cualquier otro flujo de trabajo con gran cantidad de documentos directamente desde su código C#.
El fragmento muestra cómo cargar un archivo de plantilla, vincular una fuente de datos y generar un documento mediante la API de Assembly Cloud.
Pasos
AssembleOptions: especifique el formato de salida, los datos y la ruta de la plantilla.AssembleDocument y reciba el archivo ensamblado.using GroupDocs.Assembly.Cloud.Sdk;
var config = new Configuration
{
AppSid = ".#-.#-.#-.#-.#",
AppKey = "......"
};
var assemblyApi = new AssemblyApi(config);
var fileName = "Input1.docx";
var dataFile = "Input2.docx";
// Upload template
var uploadRequest = new UploadFileRequest(File.OpenRead(fileName), fileName);
assemblyApi.UploadFile(uploadRequest);
// Assemble document
var assembleOptions = new AssembleOptions
{
SaveFormat = "docx",
ReportData = File.ReadAllText(dataFile),
TemplateFileInfo = new TemplateFileInfo { FilePath = fileName }
};
var assembleRequest = new AssembleDocumentRequest(assembleOptions);
var assembledDocument = assemblyApi.AssembleDocument(assembleRequest);