Documentation – Aspose.Cells Cloud AI – Descomposición de Tareas, Traducción de Hojas de Cálculo y Texto

Developer-Guide: Aspose.Cells Cloud Web API: Traduzca archivos de texto con conversión de idiomas impulsada por IA

Mon, 01 Jan 0001 00:00:00 +0000

El punto de conexión TranslateTextFile aprovecha los servicios de IA de Aspose.Cells Cloud para traducir el contenido de un archivo de texto a un idioma de destino especificado. Admite dos modos de operación: (1) Modo de carga de archivos: envíe un archivo de texto mediante multipart/form-data y reciba un archivo traducido; (2) Modo de contenido directo: envíe texto sin formato en el cuerpo de la solicitud y obtenga el texto traducido directamente. El servicio preserva los saltos de línea y el formato originales, agrega automáticamente el sufijo “_translated” al nombre del archivo y devuelve el resultado como una secuencia descargable. Ideal para la traducción por lotes de documentos, su integración en flujos de trabajo multilingües o la traducción en tiempo real de contenido generado por usuarios.

API para traducir archivos de texto

API web

PUT https://api.aspose.cloud/v4.0/cells/ai/translate/text-file

Parámetros de solicitud:

Nombre del parámetro	Tipo	Ubicación	Obligatorio/Opcional	Descripción
Spreadsheet	Archivo	Obligatorio	FormData	El archivo de texto de origen que se va a traducir. Debe ser un archivo de texto sin formato (.txt) o un formato de hoja de cálculo admitido. Ejemplo: cargue `document.txt` mediante el campo “file” de multipart/form-data.
targetLanguage	Cadena	Obligatorio	Query	Código de idioma ISO‑639‑1 del idioma deseado (por ejemplo, “es” para español, “fr” para francés, “de” para alemán). El código no distingue entre mayúsculas y minúsculas.
region	string	Opcional	Query	Identificador de región de la hoja de cálculo que influye en el formato específico de la configuración regional, como fechas, números y moneda. Valores comunes: “US”, “EU”, “CN”. Si se omite, se utiliza la configuración de región original del libro.
password	Cadena	Opcional	Query	Contraseña necesaria para abrir archivos de hoja de cálculo cifrados. No es necesaria para archivos de texto sin formato.

Respuesta

Respuesta correcta (200 OK) Encabezados: Content-Type: application/octet-stream // secuencia binaria del archivo traducido Content-Disposition: attachment; filename="<nombre_original>_translated.txt" Content-Length: <tamaño en bytes>

Cuerpo: secuencia binaria que contiene el texto traducido, preservando los saltos de línea y el formato originales.

Códigos de estado HTTP

Código	Significado	Descripción
200	OK	Filtro aplicado correctamente; la respuesta contiene los detalles de la operación.
400	Solicitud incorrecta	Parámetros ausentes o no válidos (por ejemplo, tipo de archivo no admitido).
401	No autorizado	Token JWT no válido o ausente.
413	Carga demasiado grande	El archivo cargado supera el límite de tamaño.
500	Error interno del servidor	Error inesperado del servidor.

¿Dónde debemos utilizar la API para traducir archivos de texto?

Portales de documentación multilingües: traduzca automáticamente manuales de usuario u archivos de ayuda cargados como documentos de texto, entregando versiones localizadas bajo demanda.
Sistemas de gestión de contenido (CMS): intégrelo en un flujo de trabajo de CMS para traducir publicaciones de blog o artículos antes de publicarlos para audiencias internacionales.
Tuberías de datos empresariales: utilícelo en trabajos por lotes que procesen grandes volúmenes de informes CSV o TXT, convirtiéndolos al idioma de las oficinas regionales, al tiempo que se conserva el formato original.
Plataformas de atención al cliente: traduzca tickets entrantes o registros de chat en texto sin formato en tiempo real para ayudar a los agentes de soporte que trabajan en distintos idiomas.

¿Por qué debería utilizar la API para traducir archivos de texto?

Precisión impulsada por IA: aprovecha modelos avanzados de traducción neuronal para una salida natural y contextual.
Flexibilidad de entrada dual: acepta tanto cargas de archivos como cargas útiles de texto sin formato, lo que simplifica la integración con diversas aplicaciones cliente.
Preservación del diseño original: mantiene saltos de línea, sangrías y caracteres especiales, eliminando la necesidad de limpieza posterior.
Gestión de archivos sencilla: devuelve un archivo listo para descargar con el sufijo “_translated” generado automáticamente, reduciendo la complejidad del código del lado del cliente.

Cómo utilizar la API para traducir archivos de texto con SDK

Especificación de la API para traducir archivos de texto

La especificación de la API para traducir archivos de texto proporciona una interfaz de programación públicamente accesible para realizar interacciones REST directamente desde un navegador web.

SDK para API de Excel

Utilice los SDK de Aspose.Cells Cloud

Utilizar el SDK es la forma más rápida de desarrollar, ya que abstracta los detalles de bajo nivel, permitiéndole combinar una hoja de cálculo en otra mediante un código breve. Consulte el repositorio de GitHub para obtener una lista completa de los SDK de Aspose.Cells Cloud. Los siguientes ejemplos de código muestran cómo interactuar con los servicios web de Aspose.Cells mediante varios SDK:

Developer-Guide: Aspose.Cells Cloud AI – API de descomposición de tareas de usuario (v4.0) | Planificación inteligente de tareas (SMART)

Mon, 01 Jan 0001 00:00:00 +0000

El endpoint DecomposeUserTask proporciona una API REST para convertir una descripción de tarea en formato libre en un plan de acciones detallado y secuencial que cumple con los criterios SMART. Asigna automáticamente estimaciones de tiempo en horas, formatea la salida para importación compatible con Redmine y crea nodos de hitos del proyecto. Al proporcionar únicamente la lista de tareas en bruto y estimaciones de tiempo opcionales, la API devuelve un archivo listo para usar (CSV, XLSX, etc.) que puede importarse directamente en herramientas de gestión de proyectos, automatizando la descomposición de tareas y reduciendo el esfuerzo manual.

API de descomposición de tareas de usuario

API web

PUT https://api.aspose.cloud/v4.0/cells/ai/task/decompose

Seguridad y autenticación

Las API de Aspose.Cells Cloud son seguras y requieren autenticación basada en token JWT.

Parámetros de solicitud:

Nombre del parámetro	Tipo	Ubicación	Obligatorio/Opcional	Descripción
TaskDescription	string	Cuerpo	Obligatorio	Descripción en texto plano del objetivo general del usuario. El servicio analiza la descripción y genera tareas individuales. Ejemplo: “Lanzar campaña de marketing para el T3, incluyendo creación de contenido, envío masivo de correos y anuncios en redes sociales.”

Respuesta

Respuesta correcta (200 OK)
Content‑Type: application/octet-stream (flujo binario de archivo)

Encabezados:

Content-Disposition: attachment; filename="DecomposedTaskPlan.xlsx"
Content-Length: <tamaño en bytes>

La misma estructura se utiliza para formatos XLSX/ODS, con las columnas colocadas en la primera hoja de cálculo.

Códigos de estado HTTP

Código	Significado	Descripción
200	OK	Filtro aplicado correctamente; la respuesta contiene detalles de la operación.
400	Solicitud incorrecta	Parámetros ausentes o inválidos (por ejemplo, tipo de archivo no admitido).
401	No autorizado	Token JWT inválido o ausente.
413	Carga demasiado grande	El archivo cargado supera el límite de tamaño.
500	Error interno del servidor	Error inesperado en el servidor.

Ejemplo de respuesta de error (400 Solicitud incorrecta)

{
  "code": "InvalidParameter",
  "message": "El campo 'TaskDescription' es obligatorio y no puede estar vacío."
}

Ejemplo de cuerpo de solicitud (JSON)

{
  "TaskDescription": "Desarrollar una API web para una funcionalidad de división de tareas en el sistema existente."
}

Ejemplo de respuesta
La API devuelve un flujo binario que contiene el archivo generado. Para previsualizar las primeras filas de una respuesta en CSV, decodifique el flujo y visualice la fila de encabezados, por ejemplo:

ID,Subject,Trucker,Estimated Duration,Description
1	Recolección de requisitos para la API de división de tareas	Analista de negocio	8	Recopilar requisitos funcionales y no funcionales, historias de usuario y criterios de aceptación para el nuevo endpoint de división de tareas.
2	Especificación de la API (OpenAPI)	Analista de negocio	6	Definir el contrato OpenAPI para POST /tasks/split, incluyendo esquema de solicitud, formatos de respuesta, códigos de error y requisitos de seguridad.
3	Diseño del algoritmo de división y del modelo de datos	Arquitecto de soluciones	5	Diseñar el algoritmo central que divide una tarea principal en subtareas, y ampliar el modelo de datos (tablas/entidades de base de datos) para almacenar la jerarquía y los metadatos.
4	Revisión de integración de arquitectura	Arquitecto de soluciones	4	Analizar el impacto en los servicios existentes, flujos de eventos y migraciones de base de datos; producir el plan de integración.
...

¿Dónde debemos utilizar la API de descomposición de tareas de usuario?

Inicio de proyectos: Convertir un resumen de proyecto de alto nivel en una lista de tareas compatible con Redmine que incluya estimaciones de tiempo, permitiendo una planificación inmediata de sprints.
Automatización de marketing: Descomponer objetivos de campañas en pasos ejecutables, exportar como CSV e importar en herramientas de gestión de tareas para coordinación entre equipos.
Asignación de recursos: Generar estimaciones basadas en horas para cada subtarea, permitiendo a los gerentes equilibrar la carga de trabajo entre miembros del equipo antes del inicio del proyecto.
Seguimiento de hitos: Crear automáticamente nodos de hitos que puedan sincronizarse con herramientas de diagramas de Gantt, garantizando que cada fase tenga un entregable claro.

¿Por qué debería utilizar la API de descomposición de tareas de usuario?

Salida conforme a SMART asegura que cada tarea generada cumpla con los criterios Específica, Medible, Alcanzable, Relevante y Temporal.
Estimación de tiempo basada en horas integrada elimina la necesidad de cálculos manuales y mejora la precisión de las proyecciones.
Formatos de archivo listos para importar (CSV, XLSX, etc.) facilitan la integración con Redmine, Jira, Azure DevOps y otras plataformas de gestión de proyectos.
Automatización en una sola solicitud permite la descomposición de tareas mediante una única solicitud, acelerando el inicio del proyecto y minimizando el esfuerzo manual.

Cómo utilizar la API de descomposición de tareas de usuario con SDK

Especificación de la API de descomposición de tareas de usuario

La Especificación de la API de descomposición de tareas de usuario proporciona una interfaz de programación accesible públicamente para ejecutar interacciones REST directamente desde un navegador web.

SDK para API de Excel

Uso de los SDK de Aspose.Cells Cloud

Utilizar el SDK es la forma más rápida de desarrollar, ya que abstracte los detalles de bajo nivel y permite invocar el endpoint DecomposeUserTask con código conciso.
Consulte el repositorio de GitHub para obtener una lista completa de los SDK de Aspose.Cells Cloud.
Los siguientes ejemplos de código muestran cómo interactuar con los servicios web de Aspose.Cells mediante diversos SDK:

Developer-Guide: Aspose.Cells Cloud Web API – Traducir hoja de cálculo al idioma de destino

Mon, 01 Jan 0001 00:00:00 +0000

El punto final TranslateSpreadsheet, parte de la API de traducción de hojas de cálculo, lee cada elemento de texto en un libro, envía el contenido a un servicio de traducción impulsado por IA y devuelve un nuevo archivo de hoja de cálculo donde todos los datos textuales se presentan en el targetLanguage especificado. La operación mantiene intacta la estructura original, los estilos de celda, las fórmulas y la estructura multi-hoja, lo que la hace ideal para internacionalizar informes, paneles de control y documentos basados en datos. Los formatos de archivo admitidos incluyen XLS, XLSX, XLSM, CSV y ODS. Se devuelven errores para códigos de idioma inválidos, fallos de autenticación o interrupciones del servicio de traducción.

API de traducción de hojas de cálculo

API web

PUT https://api.aspose.cloud/v4.0/cells/ai/translate/spreadsheet

Parámetros de solicitud:

Nombre del parámetro	Tipo	Ubicación	Obligatorio/Opcional	Descripción
Spreadsheet	Archivo	Obligatorio	FormData	El libro de Excel que se va a traducir. Las extensiones aceptables: .xls, .xlsx, .xlsm, .csv, .ods. Tamaño máximo del archivo: 50 MB. Ejemplo: `budget.xlsx`.
targetLanguage	string	Obligatorio	Query	Código de idioma ISO 639‑1 para el idioma de salida deseado (por ejemplo, “es” para español, “fr” para francés, “de” para alemán). Debe ser un idioma admitido por el servicio de IA subyacente.
region	string	Opcional	Query	Identificador de región de la hoja de cálculo que influye en el formato específico de la configuración regional, como fechas, números y monedas. Valores comunes: “US”, “EU”, “CN”. Si se omite, se utiliza la configuración de región original del libro.
password	string	Opcional	Query	Contraseña para abrir un libro protegido. Déjelo en blanco si el archivo no está protegido con contraseña.

Respuesta

Respuesta correcta (200 OK)
Encabezados:
Content‑Type: application/octet-stream // o text/csv cuando se solicita salida en CSV
Content‑Disposition: attachment; filename=“translated.xlsx”
Content‑Length: <tamaño en bytes>

Cuerpo:
<flujo binario que contiene el archivo de hoja de cálculo traducido>

Las respuestas de error siguen el modelo estándar de errores de Aspose.Cells Cloud (application/json) con campos code, message y details (opcional).

Códigos de estado HTTP

Código	Significado	Descripción
200	OK	Filtro aplicado correctamente; la respuesta contiene detalles de la operación.
400	Solicitud incorrecta	Parámetros faltantes o inválidos (por ejemplo, tipo de archivo no admitido).
401	No autorizado	Token JWT inválido o faltante.
413	Carga útil demasiado grande	El archivo subido excede el límite de tamaño.
500	Error interno del servidor	Error inesperado del servidor.

¿Dónde debemos utilizar la API de traducción de hojas de cálculo?

Informes financieros internacionales – Convertir informes trimestrales en Excel a múltiples idiomas para oficinas regionales, preservando fórmulas y diseños de gráficos.
Paneles de control de marketing multilingües – Generar automáticamente versiones localizadas de paneles de rendimiento de ventas para equipos globales.
Distribución de contenido educativo – Traducir libretas de calificaciones, hojas de tareas u hojas de cálculo curriculares para estudiantes en diferentes países sin necesidad de copiar y pegar manualmente.
Cumplimiento normativo – Generar hojas de cálculo específicas por idioma para cumplimiento normativo, conservando reglas de validación y listas de validación de datos.

¿Por qué debería utilizar la API de traducción de hojas de cálculo?

Precisión impulsada por IA – Utiliza modelos avanzados de traducción neuronal para conversiones lingüísticas contextualmente conscientes y de alta calidad.
Sin interrupción del diseño – Mantiene fórmulas de celda, formato condicional, gráficos y orden de hojas de cálculo exactamente como en el archivo original.
Procesamiento multi-hoja en una sola llamada – Traduce todas las hojas de cálculo en una sola solicitud, eliminando la necesidad de bucles por hoja.
Integración fluida en la nube – Funciona con la autenticación de Aspose.Cells Cloud, permitiendo canalizaciones automatizadas en CI/CD, funciones sin servidor o sistemas back-end empresariales.

Cómo utilizar la API de traducción de hojas de cálculo con SDK

Especificación de la API de traducción de hojas de cálculo

La Especificación de la API de traducción de hojas de cálculo proporciona una interfaz de programación accesible públicamente para realizar interacciones REST directamente desde un navegador web.

SDK de API de Excel

Utilizar los SDK de Aspose.Cells Cloud

Utilizar el SDK es la forma más rápida de desarrollar, ya que oculta los detalles de bajo nivel, permitiéndole fusionar una hoja de cálculo en otra con un código breve.
Consulte el repositorio de GitHub para ver una lista completa de los SDK de Aspose.Cells Cloud.
Los siguientes ejemplos de código muestran cómo interactuar con los servicios web de Aspose.Cells mediante diversos SDK: