Documentation –

Developer-Guide: Aspose.Cells Cloud Web API – Traduci foglio di calcolo nella lingua di destinazione

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

L’endpoint TranslateSpreadsheet, parte dell'API di traduzione foglio di calcolo, legge ogni elemento di testo in un libro, invia il contenuto a un servizio di traduzione alimentato dall’AI e restituisce un nuovo file foglio di calcolo in cui tutti i dati testuali sono renderizzati nella targetLanguage specificata. L’operazione mantiene intatti la struttura originale, gli stili delle celle, le formule e la struttura multi-foglio, rendendola ideale per la globalizzazione di report, dashboard e documenti basati sui dati. I formati di file supportati includono XLS, XLSX, XLSM, CSV e ODS. Gli errori vengono restituiti per codici linguistici non validi, errori di autenticazione o disservizi del servizio di traduzione.

API di traduzione foglio di calcolo

API Web

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

Parametri della richiesta:

Nome parametro	Tipo	Posizione	Obbligatorio/Opzionale	Descrizione
Spreadsheet	File	Richiesto	FormData	Il libro Excel da tradurre. Estensioni accettabili: .xls, .xlsx, .xlsm, .csv, .ods. Dimensione massima file: 50 MB. Esempio: `budget.xlsx`.
targetLanguage	string	Richiesto	Query	Codice linguistico ISO 639-1 per la lingua di output desiderata (ad esempio, “es” per spagnolo, “fr” per francese, “de” per tedesco). Deve essere una lingua supportata dal servizio AI sottostante.
region	string	Opzionale	Query	Identificatore di area geografica del foglio di calcolo che influisce sul formato specifico della localizzazione, come date, numeri e valuta. Valori comuni: “US”, “EU”, “CN”. Se omesso, viene utilizzata l’impostazione regionale originale del libro.
password	string	Opzionale	Query	Password per aprire un libro protetto. Lasciare vuoto quando il file non è protetto da password.

Risposta

Risposta positiva (200 OK)
Intestazioni:
Content-Type: application/octet-stream // oppure text/csv quando viene richiesto l’output CSV
Content-Disposition: attachment; filename=“translated.xlsx”
Content-Length:

Corpo:

Le risposte di errore seguono il modello standard di errore di Aspose.Cells Cloud (application/json) con campi code, message e details opzionale.

Codici di stato HTTP

Codice	Significato	Descrizione
200	OK	Filtro applicato correttamente; la risposta contiene i dettagli dell’operazione.
400	Richiesta non valida	Parametri mancanti o non validi (ad esempio, tipo di file non supportato).
401	Non autorizzato	Token JWT non valido o mancante.
413	Payload troppo grande	Il file caricato supera il limite di dimensione.
500	Errore interno del server	Errore imprevisto del server.

Dove dovremmo utilizzare l’API di traduzione foglio di calcolo?

Reso conto finanziario internazionale – Converti report trimestrali Excel in più lingue per uffici regionali, mantenendo formule e layout dei grafici.
Dashboard di marketing multilingue – Genera automaticamente versioni localizzate delle dashboard di performance delle vendite per team globali.
Distribuzione di contenuti educativi – Traduci quaderni, schede di esercizi o fogli di calcolo curricolari per studenti in diversi paesi, senza copiare e incollare manualmente.
Conformità normativa – Produci fogli di calcolo per la conformità specifici per lingua, mantenendo regole di convalida e liste di convalida dati.

Perché dovresti utilizzare l’API di traduzione foglio di calcolo?

Precisione basata sull’AI – Sfrutta modelli neurali di traduzione all’avanguardia per conversioni linguistiche contestualmente consapevoli e di alta qualità.
Nessuna alterazione della struttura – Mantiene esattamente come nel file sorgente le formule delle celle, la formattazione condizionale, i grafici e l’ordine dei fogli.
Elaborazione multi-foglio in una singola chiamata – Traduce tutti i fogli di lavoro in una sola richiesta, eliminando la necessità di cicli per foglio.
Integrazione cloud senza interruzioni – Funziona con l’autenticazione di Aspose.Cells Cloud, consentendo pipeline automatizzate in CI/CD, funzioni serverless o back-end aziendali.

Come utilizzare l’API di traduzione foglio di calcolo con gli SDK

Specifica dell’API di traduzione foglio di calcolo

La Specifica dell’API di traduzione foglio di calcolo fornisce un’interfaccia di programmazione pubblicamente accessibile per eseguire interazioni REST direttamente da un browser web.

SDK per API Excel

Utilizzare gli SDK di Aspose.Cells Cloud

L’utilizzo dell’SDK è il modo più rapido per sviluppare, poiché nasconde i dettagli a basso livello, consentendoti di unire un foglio di calcolo in un altro con codice minimo.
Consulta il repository GitHub per un elenco completo degli SDK di Aspose.Cells Cloud.
I seguenti esempi di codice mostrano come interagire con i servizi web di Aspose.Cells utilizzando vari SDK:

Developer-Guide: Aspose.Cells Cloud Web API – Traduci file di testo con conversione linguistica basata su intelligenza artificiale

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

L’endpoint TranslateTextFile sfrutta i servizi AI di Aspose.Cells Cloud per tradurre il contenuto di un file di testo in una lingua di destinazione specificata. Supporta due modalità operative: (1) Modalità caricamento file – invia un file di testo tramite multipart/form-data e ricevi un file tradotto; (2) Modalità contenuto diretto – invia testo grezzo nel corpo della richiesta e ottieni direttamente il testo tradotto. Il servizio conserva le interruzioni di riga e la formattazione originali, aggiunge automaticamente il suffisso “_translated” al nome del file e restituisce il risultato come flusso scaricabile. Ideale per la traduzione in batch di documenti, l’integrazione in flussi di lavoro multilingue o la traduzione in tempo reale di contenuti generati dagli utenti.

API per la traduzione di file di testo

API Web

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

Parametri della richiesta:

Nome parametro	Tipo	Posizione	Obbligatorio/opzionale	Descrizione
Spreadsheet	File	Obbligatorio	FormData	Il file di testo sorgente da tradurre. Deve essere un file di testo semplice (.txt) o un formato foglio di calcolo supportato. Esempio: carica `document.txt` tramite il campo “file” di multipart/form-data.
targetLanguage	String	Obbligatorio	Query	Codice linguistico ISO-639-1 della lingua di output desiderata (ad esempio, “es” per spagnolo, “fr” per francese, “de” per tedesco). Il codice è case-insensitive.
region	string	Opzionale	Query	Identificatore regionale del foglio di calcolo che influisce sulla formattazione specifica della localizzazione, come date, numeri e valuta. Valori comuni: “US”, “EU”, “CN”. Se omesso, viene utilizzata l’impostazione regionale originale del foglio di calcolo.
password	String	Opzionale	Query	Password necessaria per aprire file di fogli di calcolo crittografati. Non necessaria per file di testo semplice.

Risposta

Risposta corretta (200 OK) Intestazioni: Content-Type: application/octet-stream // flusso binario del file tradotto Content-Disposition: attachment; filename="<nome_originale>_translated.txt" Content-Length:

Corpo: flusso binario contenente il testo tradotto, che conserva le interruzioni di riga e la formattazione originali.

Codici di stato HTTP

Codice	Significato	Descrizione
200	OK	Filtro applicato correttamente; la risposta contiene i dettagli dell’operazione.
400	Richiesta non valida	Parametri mancanti o non validi (ad esempio, tipo di file non supportato).
401	Non autorizzato	Token JWT non valido o mancante.
413	Payload troppo grande	Il file caricato supera il limite di dimensione.
500	Errore interno del server	Errore imprevisto del server.

Dove utilizzare l’API per la traduzione di file di testo?

Portali documentali multilingue – Traduci automaticamente manuali utente o file di aiuto caricati come documenti di testo, fornendo versioni localizzate su richiesta.
Sistemi di gestione dei contenuti (CMS) – Integra in un flusso di lavoro CMS per tradurre post di blog o articoli prima della pubblicazione a un pubblico internazionale.
Pipeline di dati aziendali – Utilizza in processi batch che elaborano grandi quantità di report CSV o TXT, convertendoli nella lingua degli uffici regionali mantenendo la formattazione originale.
Piattaforme di supporto clienti – Traduci in tempo reale ticket o log di chat in testo grezzo in ingresso per supportare gli agenti di supporto che operano in diverse lingue.

Perché utilizzare l’API per la traduzione di file di testo?

Precisione guidata dall’AI – Sfrutta modelli neurali all’avanguardia per output naturali e contestualmente accurati.
Flessibilità di input duplice – Accetta sia caricamenti di file che payload di testo grezzo, semplificando l’integrazione con applicazioni client eterogenee.
Conserva il layout originale – Mantiene interruzioni di riga, rientri e caratteri speciali, eliminando la necessità di pulizie post-traduzione.
Gestione file senza attriti – Restituisce un file pronto per il download con un suffisso “_translated” generato automaticamente, riducendo la complessità del codice lato client.

Come utilizzare l’API per la traduzione di file di testo con gli SDK

Specifica dell’API per la traduzione di file di testo

La Specifiche dell’API per la traduzione di file di testo fornisce un’interfaccia di programmazione pubblicamente accessibile per eseguire interazioni REST direttamente da un browser web.

SDK per API Excel

Utilizzare gli SDK di Aspose.Cells Cloud

L’utilizzo degli SDK rappresenta il modo più rapido per sviluppare, poiché astrae i dettagli di basso livello, consentendo di unire un foglio di calcolo in un altro con poche righe di codice. Consulta il repository GitHub per un elenco completo degli SDK di Aspose.Cells Cloud. I seguenti esempi di codice mostrano come interagire con i servizi web di Aspose.Cells utilizzando vari SDK:

Developer-Guide:

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

title: “Aspose.Cells Cloud AI – API di decomposizione dei compiti utente (v4.0) | Pianificazione dei compiti SMART” second_title: “Documento” ArticleTitle: “Come convertire obiettivi utente in piani di azione sequenziali con l’API di decomposizione dei compiti di Aspose.Cells Cloud AI” linktitle: “Decomponi compito utente” type: docs url: /decompose-user-task/ keywords: “Aspose.Cells AI, API di decomposizione dei compiti, pianificazione dei compiti SMART, importazione Redmine, automazione di progetto” description: “Trasforma obiettivi liberi in liste di compiti SMART, con stime temporali in ore, grazie ad Aspose.Cells Cloud AI. Ottieni output CSV/XLSX pronti per Redmine, Jira o Azure DevOps con una singola richiesta PUT.” weight: 100

L’endpoint DecomposeUserTask fornisce un endpoint REST per trasformare una descrizione di un compito in formato libero in un piano d’azione dettagliato e sequenziale conforme ai criteri SMART. Assegna automaticamente stime temporali in ore, formatta l’output per l’importazione compatibile con Redmine e crea nodi di traguardo di progetto. Fornendo soltanto l’elenco grezzo dei compiti e, opzionalmente, le stime temporali, l’API restituisce un file pronto all’uso (CSV, XLSX, ecc.) che può essere importato direttamente in strumenti di project management, automatizzando la scomposizione dei compiti e riducendo lo sforzo manuale.

API di decomposizione dei compiti utente

API Web

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

Sicurezza e autenticazione

Le API di Aspose.Cells Cloud sono sicure e richiedono l’autenticazione basata su token JWT.

Parametri della richiesta:

Nome del parametro	Tipo	Posizione	Obbligatorio/Opzionale	Descrizione
TaskDescription	string	Corpo	Obbligatorio	Una descrizione in testo semplice dell’obiettivo complessivo dell’utente. Il servizio analizza la descrizione e genera singoli compiti. Esempio: “Lanciare una campagna di marketing per il terzo trimestre, inclusa la creazione di contenuti, invio di email e inserzioni sui social media.”

Risposta

Risposta riuscita (200 OK)
Content‑Type: application/octet-stream (flusso binario di file)

Intestazioni:

Content-Disposition: attachment; filename="DecomposedTaskPlan.xlsx"
Content-Length: <dimensione in byte>

La stessa struttura viene utilizzata per i formati XLSX/ODS, con le colonne posizionate nel primo foglio di lavoro.

Codici di stato HTTP

Codice	Significato	Descrizione
200	OK	Filtro applicato correttamente; la risposta contiene i dettagli dell’operazione.
400	Richiesta non valida	Parametri mancanti o non validi (es. tipo di file non supportato).
401	Non autorizzato	Token JWT non valido o mancante.
413	Payload troppo grande	Il file caricato supera il limite di dimensione.
500	Errore interno del server	Errore imprevisto del server.

Esempio di risposta di errore (400 Bad Request)

{
  "code": "InvalidParameter",
  "message": "Il campo 'TaskDescription' è obbligatorio e non può essere vuoto."
}

Esempio di corpo della richiesta (JSON)

{
  "TaskDescription": "Sviluppare un'API web per una funzionalità di suddivisione dei compiti nel sistema esistente."
}

Esempio di risposta
L’API restituisce un flusso binario contenente il file generato. Per visualizzare le prime righe di una risposta in formato CSV, decodificare il flusso e visualizzare la riga di intestazione, ad esempio:

ID,Oggetto,Responsabile,Durata stimata,Descrizione
1	Rilevamento dei requisiti per l'API di suddivisione dei compiti	Analista aziendale	8	Raccogliere i requisiti funzionali e non funzionali, le user story e i criteri di accettazione per il nuovo endpoint di suddivisione dei compiti.
2	Specifica dell'API (OpenAPI)	Analista aziendale	6	Definire il contratto OpenAPI per POST /tasks/split, inclusi schema di richiesta, formati di risposta, codici di errore e requisiti di sicurezza.
3	Algoritmo di suddivisione e progettazione del modello dati	Architetto di soluzione	5	Progettare l’algoritmo principale che divide un compito padre in sotto-compiti e estendere il modello dati (tabelle DB / entità) per memorizzare la gerarchia e i metadati.
4	Revisione dell'integrazione architettonica	Architetto di soluzione	4	Analizzare l’impatto sui servizi esistenti, sui flussi di eventi e sulle migrazioni del database; produrre il piano di integrazione.
...

Dove utilizzare l’API di decomposizione dei compiti utente?

Avvio di progetto: Convertire un breve cenno generale del progetto in un elenco di compiti compatibile con Redmine, con stime temporali, abilitando la pianificazione immediata degli sprint.
Automazione marketing: Suddividere gli obiettivi della campagna in passi eseguibili, esportare in CSV e importare negli strumenti di gestione dei compiti per la coordinazione tra team diversi.
Assegnazione delle risorse: Generare stime in ore per ogni sotto-compito, consentendo ai manager di bilanciare il carico di lavoro tra i membri del team prima dell’inizio del progetto.
Monitoraggio dei traguardi: Creare automaticamente nodi di traguardo che possono essere sincronizzati con strumenti di diagramma di Gantt, garantendo che ogni fase abbia un risultato tangibile.

Perché utilizzare l’API di decomposizione dei compiti utente?

Output conforme a SMART garantisce che ogni compito generato soddisfi i criteri Specifico, Misurabile, Realizzabile, Rilevante e Temporizzato.
Stima temporale in ore integrata elimina la necessità di calcoli manuali e migliora la precisione delle previsioni.
Formati di file pronti all’importazione (CSV, XLSX, ecc.) facilitano l’integrazione con Redmine, Jira, Azure DevOps e altre piattaforme di project management.
Automazione in una singola richiesta consente la scomposizione dei compiti tramite una singola richiesta, accelerando l’avvio del progetto e riducendo lo sforzo manuale.

Come utilizzare l’API di decomposizione dei compiti utente con gli SDK

Specifica dell’API di decomposizione dei compiti utente

La Specifica dell’API di decomposizione dei compiti utente fornisce un’interfaccia di programmazione pubblicamente accessibile per eseguire interazioni REST direttamente da un browser web.

SDK per l’API Excel

Utilizzare gli SDK di Aspose.Cells Cloud

L’utilizzo dell’SDK è il modo più rapido per sviluppare, poiché astrae i dettagli a basso livello e consente di chiamare l’endpoint DecomposeUserTask con codice conciso.
Consultare il repository GitHub per un elenco completo degli SDK di Aspose.Cells Cloud.
I seguenti esempi di codice mostrano come interagire con i servizi web di Aspose.Cells utilizzando vari SDK: