Integrare in un’applicazione web ASP.NET Core consente una modifica fluida dei documenti direttamente nel tuo portale web. GroupDocs.Editor Cloud SDK for .NET fornisce un’API potente che ti permette di caricare, modificare e salvare file DOCX sul server. Questa guida ti accompagna attraverso la configurazione necessaria, mostra il codice passo‑passo e fornisce un esempio completo che puoi eseguire in pochi minuti. Alla fine sarai in grado di aggiungere la modifica dei documenti a un’applicazione ASP.NET Core con sicurezza.

Prerequisiti e Configurazione

Prima di iniziare, assicurati di avere quanto segue:

  • .NET 6.0 SDK o versioni successive installate
  • Un IDE come Visual Studio 2022 o VS Code
  • Un account GroupDocs Cloud per ottenere Client Id e Client Secret
  • Accesso a una macchina di sviluppo Windows, Linux o macOS

Integrare in un’applicazione web ASP.NET Core richiede anche una connessione di rete affidabile ai endpoint di GroupDocs Cloud, poiché l’elaborazione di tutti i documenti avviene in remoto. Pianifica di conseguenza l’ambiente di distribuzione.

Installa l’SDK tramite NuGet:

dotnet add package GroupDocs.editor-Cloud

Scarica il pacchetto più recente dalla pagina di rilascio ufficiale: GroupDocs.Editor Cloud SDK for .NET Download.

Crea un oggetto di configurazione con le tue credenziali (estratto dall’esempio completo):

var configuration = new Configuration
{
    ClientId = "client_id",
    ClientSecret = "client_secret"
};

Con il pacchetto installato e le credenziali pronte, puoi passare all’implementazione. Le sezioni successive spiegano ogni parte del codice in dettaglio, così da capire come la libreria si inserisce nell’architettura complessiva di un’applicazione web ASP.NET Core.

Guida passo-passo per l’integrazione in un’applicazione Web ASP.NET Core

Questa sezione suddivide il processo di integrazione in un’applicazione web ASP.NET Core in passaggi discreti e gestibili. Ogni passaggio include un breve frammento di codice preso direttamente dall’implementazione di riferimento.

Passo 1: Configura le credenziali API

Innanzitutto, istanzia l’oggetto Configuration con i dettagli del tuo client e crea il client EditorApi.

var configuration = new Configuration
{
    ClientId = "client_id",
    ClientSecret = "client_secret"
};

var editorApi = new EditorApi(configuration);

La classe EditorApi è documentata nella riferimento API. Inizializzare il client una volta per richiesta è sufficiente per la maggior parte degli scenari; è inoltre possibile registrarlo come singleton nel contenitore di iniezione delle dipendenze di ASP.NET Core per migliori prestazioni.

Passo 2: Definisci le Opzioni di Caricamento

Specifica il file di origine e la posizione di output desiderata utilizzando LoadOptions. Questo oggetto indica al servizio quale documento aprire e dove memorizzare l’HTML renderizzato.

var loadOptions = new LoadOptions
{
    FileInfo = new FileInfo { FilePath = "input.docx" },
    RenderOptions = new RenderOptions { OutputPath = "output.html" }
};

LoadOptions, FileInfo e RenderOptions ti consentono di controllare come il documento viene renderizzato per la modifica. Ad esempio, puoi impostare RenderOptions per includere immagini, preservare gli stili originali o limitare il numero di pagine renderizzate.

Passo 3: Chiama LoadDocument

Invoca l’API per caricare e convertire il documento. La chiamata è sincrona in questo esempio, ma è possibile utilizzare anche la versione asincrona se l’azione del controller è asincrona.

var loadResult = editorApi.LoadDocument(loadOptions);

Il metodo LoadDocument restituisce un oggetto risultato contenente URL al HTML renderizzato e altri metadati. È possibile memorizzare il loadResult per un recupero successivo o passare direttamente l’HTML al front‑end.

Passo 4: Elaborare il risultato del caricamento

Dopo il caricamento, puoi servire l’HTML al front‑end o archiviarlo per un uso successivo. Questo passaggio completa il workflow integrare l’editor di documenti in un’app web ASP.NET Core e prepara il documento per l’interazione dell’utente.

In uno scenario reale, di solito restituiresti il contenuto HTML da un’azione del controller:

return Content(loadResult.HtmlContent, "text/html");

Potresti anche voler implementare la cache per evitare il re‑loading dello stesso documento più volte, il che può migliorare i tempi di risposta quando integrare in un’applicazione web ASP.NET Core su larga scala.

Integrazione dell’Editor di Documenti in un’applicazione Web ASP.NET Core - Esempio di codice completo

Il codice seguente dimostra l’intero processo, dalla configurazione al caricamento di un file DOCX.

var configuration = new Configuration
{
    ClientId = "client_id",
    ClientSecret = "client_secret"
};

var editorApi = new EditorApi(configuration);

var loadOptions = new LoadOptions
{
    FileInfo = new FileInfo { FilePath = "input.docx" },
    RenderOptions = new RenderOptions { OutputPath = "output.html" }
};

var loadResult = editorApi.LoadDocument(loadOptions);

Nota: Questo esempio di codice dimostra la funzionalità principale. Prima di usarlo nel tuo progetto, assicurati di aggiornare tutti i percorsi dei file e i valori di configurazione per corrispondere al tuo ambiente reale, verifica che tutte le dipendenze richieste siano installate correttamente e testa accuratamente nel tuo ambiente di sviluppo. Se incontri problemi, consulta la documentazione ufficiale o contatta il team di supporto per assistenza.

Utilizzo di cURL per l’integrazione di modifica dei documenti ASP.NET Core

Se preferisci un approccio REST diretto, la stessa operazione può essere eseguita con comandi cURL. Questo metodo è utile per la prototipazione rapida o quando devi integrare l’editor in un servizio che non è scritto in .NET.

1. Autenticazione e Ottenimento del Token di Accesso

curl -X POST "https://api.groupdocs.cloud/v2.0/auth/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

La risposta contiene un access_token utilizzato nelle chiamate successive.

2. Carica il file di origine

curl -X POST "https://api.groupdocs.cloud/v2.0/editor/storage/upload?path=/input.docx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@input.docx"

3. Carica il documento per la modifica

curl -X POST "https://api.groupdocs.cloud/v2.0/editor/load" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": { "filePath": "input.docx" },
           "renderOptions": { "outputPath": "output.html" }
         }'

4. Scarica l’HTML renderizzato

curl -X GET "https://api.groupdocs.cloud/v2.0/editor/storage/download?path=/output.html" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.html

Questi comandi illustrano come aggiungere la modifica dei documenti a un’applicazione ASP.NET Core senza scrivere alcun codice C#, utile per test rapidi o integrazione con altri servizi. Per ulteriori dettagli, vedere la documentazione API ufficiale.

Padroneggiando sia la libreria .NET sia la REST API grezza, ottieni flessibilità quando integri in un’applicazione web ASP.NET Core, consentendoti di scegliere l’approccio che meglio si adatta alla tua architettura.

FAQs

Ulteriori letture