Microsoft Word supporta l’opzione “Confronta” che consente agli utenti di confrontare documenti Word e identificare le modifiche appena aggiunte. Questa funzionalità è utile in quanto è possibile eseguire un’operazione di confronto del testo in documenti Word affiancati. Tuttavia, una soluzione programmatica di controllo delle differenze di testo può essere molto più rapida ed efficiente e può eseguire facilmente operazioni di confronto di testo in blocco. In questo articolo, eseguiremo un’operazione di confronto del testo utilizzando REST-API in modo da poter trovare le differenze.
- API di confronto del testo
- Confronta il testo online usando C#
- Confronta i documenti Word usando i comandi cURL
API di confronto del testo
Aspose.Words Cloud SDK per .NET consente di creare, manipolare e trasformare i principali formati MS Word (DOC, DOCX, DOCM ecc.) in altri formati supportati. Allo stesso tempo, fornisce anche la possibilità di confrontare documenti Word ed evidenziare le differenze. Ora, per utilizzare l’SDK, installalo da NuGet library utilizzando il seguente comando sulla console del gestore pacchetti:
Install-Package Aspose.Words-Cloud
Per maggiori informazioni, puoi prendere in considerazione la visita al seguente link per maggiori informazioni su Come installare Aspose.Cloud SDK. Ora, dopo l’installazione, dobbiamo anche creare un account gratuito visitando Dashboard Aspose.Cloud. Registrati semplicemente con il tuo account GitHub o Google oppure clicca sul pulsante Crea un nuovo account. Le credenziali client visualizzate sulla pagina verranno utilizzate nelle sezioni successive.
Confronta il testo online usando C#
Di seguito sono riportati i passaggi e il frammento di codice che spiegano nei dettagli come confrontare due documenti Word utilizzando il frammento di codice C# .NET.
- Per prima cosa dobbiamo definire le informazioni ClientID e ClientSecret nel codice.
- In secondo luogo, creare un oggetto della classe Configuration fornendo i dettagli ClientID e ClientSecret come argomenti.
- In terzo luogo, crea un oggetto della classe WordsApi e passa l’istanza Configuration come argomento.
- Ora crea un’istanza della classe CompareData.
- Per identificare specificamente il nome della persona così come identificata nel file risultante, utilizzare la proprietà Author della classe CompareData.
- La proprietà ComparingWithDocument della classe CompareData viene utilizzata per specificare il documento di destinazione per confrontare il contenuto.
- Ora crea un’istanza della classe CompareDocumentRequest che accetta come argomenti il file di input/sorgente, l’oggetto CompareData e il nome del file risultante.
- Infine, chiamare il metodo CompareDocument(..) per avviare l’operazione di confronto.
String MyClientID = "c235e685-1aab-4cda-a95b-54afd63eb87f"; // Get Client Id from https://dashboard.aspose.cloud/
String MyClientSecret = "b8da4ee37494f2ef8da3c727f3a0acb9"; // Get Client Secret from https://dashboard.aspose.cloud/
// crea un'istanza della classe Configurazione
// e fornisci il tuo ID cliente personalizzato e i dettagli del segreto cliente
var config = new Configuration { ClientId = MyClientID, ClientSecret = MyClientSecret };
// inizializza l'oggetto WordsAPI utilizzando l'istanza di configurazione
var wordsApi = new WordsApi(config);
// primo documento di input
string firstDocument = "file-sample.docx";
// secondo documento da confrontare con
string secondFile = "file-sample-updated.docx";
// nome del file risultante
string resultantFile = "Out_ComparedTestDocs.docx";
// Crea un'istanza della classe CompareData
CompareData compareData = new CompareData();
// nome da utilizzare come autore che identifica le differenze
compareData.Author = "Nayyer";
// specificare il documento con cui effettuare il confronto
compareData.ComparingWithDocument = secondFile;
compareData.DateTime = DateTime.Now;
// crea un'istanza di richiesta fornendo la fonte, il documento da confrontare e il nome del file risultante
CompareDocumentRequest request = new CompareDocumentRequest(firstDocument, compareData, null, null, null, null, resultantFile);
// avviare il confronto dei documenti
DocumentResponse result = wordsApi.CompareDocument(request);
I file di esempio utilizzati negli esempi sopra riportati possono essere scaricati dai seguenti link
Confronta i documenti Word usando i comandi cURL
In questa sezione, impareremo i passaggi per confrontare i documenti Word usando i comandi cURL. Poiché le nostre API sono accessibili solo al personale autorizzato, esegui il seguente comando per creare un token di accesso JWT basato sui dettagli di Client ID e Client Secret.
curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=c235e685-1aab-4cda-a95b-54afd63eb87f&client_secret=b8da4ee37494f2ef8da3c727f3a0acb9" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"
Il comando cURL riportato di seguito mostra come eseguire il confronto file online utilizzando il comando cURL. Accede al metodo CompareDocument e il risultato di questa operazione viene scritto nel documento di output che contiene le modifiche di traccia come un numero di revisioni di modifica e formato. Si noti che se non si forniscono i dettagli del documento di output, le revisioni vengono salvate nel documento originale.
curl -X PUT "https://api.aspose.cloud/v4.0/words/file-sample.docx/compareDocument?destFileName=ComparisonResult.docx" \
-H "accept: application/json"
-H "Authorization: Bearer <JWT Token>" \
-H "Content-Type: application/json" \
-d "{\"ComparingWithDocument\":\"file-sample-updated.docx\",\"Author\":\"Nayyer\",\"DateTime\":\"2021-04-27T16:50:55.869Z\",\"CompareOptions\":{\"IgnoreCaseChanges\":true,\"IgnoreTables\":true,\"IgnoreFields\":true,\"IgnoreFootnotes\":true,\"IgnoreComments\":true,\"IgnoreTextboxes\":true,\"IgnoreFormatting\":true,\"IgnoreHeadersAndFooters\":true,\"Target\":\"Current\"}}"
Una volta eseguito il comando, le informazioni eliminate vengono specificate separatamente e il contenuto appena aggiunto viene evidenziato in giallo.
Immagine 1: Anteprima del documento originale e del documento modificato.
Immagine 2: Anteprima del confronto del testo.
Conclusione
In questo articolo, abbiamo spiegato i passaggi per confrontare i documenti Word usando Aspose.Words Cloud API. Si noti che le API sono accessibili anche tramite swagger interface. Inoltre, i nostri Cloud SDK sono open source e il loro codice sorgente completo può essere scaricato da GitHub.
Ti consigliamo inoltre di visitare Prodotto Documentazione per maggiori dettagli su altre interessanti funzionalità offerte dall’API. Il tuo feedback è molto importante per noi. Quindi, non esitare a contattarci tramite i nostri Forum di supporto.
Vedi anche
Per informazioni su: