In qualità di sviluppatore Python, puoi annotare qualsiasi file Word (.doc o .docx) a livello di codice sul cloud. Puoi anche estrarre o rimuovere tutte le annotazioni dai file di Word usando Python. Le annotazioni includono commenti, popup e vari altri oggetti grafici nel documento che forniscono informazioni aggiuntive. Questo articolo si concentrerà su come estrarre o rimuovere annotazioni dai file DOCX utilizzando un’API REST in Python.
In questo articolo saranno trattati i seguenti argomenti:
- API REST di annotazione del documento e SDK Python
- Estrai o rimuovi annotazioni dai file DOCX utilizzando un’API REST
API REST di annotazione del documento e SDK Python
Per estrarre o rimuovere le annotazioni dai file DOC o DOCX, utilizzerò l’API Python SDK of GroupDocs.Annotation Cloud. Ti consente di creare in modo programmatico strumenti di annotazione di documenti e immagini online. Tali strumenti possono essere utilizzati per aggiungere annotazioni, sovrapposizioni di filigrane, sostituzioni di testo, redazioni, note adesive e contrassegni di testo ai documenti aziendali di tutti i formati più diffusi. Fornisce inoltre SDK .NET, Java, PHP, Ruby e Node.js come document annotation family members per l’API Cloud.
Puoi installare GroupDocs.Annotation Cloud nel tuo progetto Python utilizzando il seguente comando nella console:
pip install groupdocs_annotation_cloud
Si prega di ottenere l’ID cliente e il segreto cliente dalla dashboard prima di iniziare a seguire i passaggi e gli esempi di codice disponibili. Una volta che hai il tuo ID e segreto, aggiungi il codice come mostrato di seguito:
client_id = "da0c487d-c1c0-45ae-b7bf-43eaf53c5ad5"
client_secret = "479db2b01dcb93a3d4d20efb16dea971"
configuration = groupdocs_annotation_cloud.Configuration(client_id, client_secret)
configuration.api_base_url = "https://api.groupdocs.cloud"
Estrai o rimuovi annotazioni dai file DOCX utilizzando un’API REST in Python
Puoi estrarre o eliminare tutte le annotazioni dai file DOCX seguendo i semplici passaggi indicati di seguito:
- Carica il file DOCX nel Cloud
- Estrai annotazioni da file DOCX in Python
- Rimuovi le annotazioni dai file DOCX in Python
- Scarica il file aggiornato
Carica il documento
Innanzitutto, carica il file DOCX sul Cloud utilizzando l’esempio di codice riportato di seguito:
# istanza dell'API
file_api = groupdocs_annotation_cloud.FileApi.from_config(configuration)
# caricare un file
request = groupdocs_annotation_cloud.UploadFileRequest("input.docx", "C:\\Files\\input.docx", my_storage)
response = file_api.upload_file(request)
Di conseguenza, il file DOCX caricato (input.docx) sarà disponibile nella sezione file della dashboard sul cloud.
Estrai annotazioni da file DOCX in Python
Si prega di seguire i passaggi indicati di seguito per estrarre le annotazioni dal documento di Word a livello di codice.
- Crea un’istanza di AnnotateApi
- Crea un’istanza di FileInfo
- Imposta il percorso del file
- Crea una richiesta chiamando il metodo ExtractRequest
- Ottieni risultati chiamando il metodo AnnotateApi.extract().
Il frammento di codice seguente mostra come estrarre le annotazioni dal documento di Word usando un’API REST.
# istanza dell'API
api = groupdocs_annotation_cloud.AnnotateApi.from_config(configuration)
# dettagli del file di input
file_info = groupdocs_annotation_cloud.FileInfo()
file_info.file_path = "input.docx"
# estrarre la richiesta di annotazione
request = groupdocs_annotation_cloud.ExtractRequest(file_info)
result = api.extract(request)
print("ExtractAnnotations: annotations count: " + str(len(result)))
L’esempio di codice precedente restituirà un array di tutte le annotazioni in formato JSON come mostrato di seguito:
Estrai le annotazioni dal file DOCX usando Python
Rimuovi le annotazioni dai file DOCX in Python
Si prega di seguire i passaggi indicati di seguito per eliminare le annotazioni dal documento di Word a livello di codice.
- Crea un’istanza di AnnotateApi
- Crea un’istanza di FileInfo
- Imposta il percorso del file
- Definisci RimuoviOpzioni
- Imposta le informazioni sul file su AnnotateOptions
- Fornisci gli ID delle annotazioni da rimuovere
- Imposta il percorso del file di output
- Crea una richiesta chiamando il metodo RemoveAnnotationsRequest
- Ottieni risultati chiamando il metodo AnnotateApi.remove\annotations().
Il frammento di codice seguente mostra come rimuovere le annotazioni dal documento di Word utilizzando un’API REST. Devi menzionare gli ID di annotazione che devono essere rimossi dal documento.
# istanza dell'API
api = groupdocs_annotation_cloud.AnnotateApi.from_keys(client_id, client_secret)
# dettagli del file di input
file_info = groupdocs_annotation_cloud.FileInfo()
file_info.file_path = "input.docx"
# rimuovere le opzioni
options = groupdocs_annotation_cloud.RemoveOptions()
options.file_info = file_info
options.annotation_ids = [0,1,2,3,4,5,6,7,8,9,10,11]
# file di uscita
options.output_path = "output.docx"
# rimuovere la richiesta
request = groupdocs_annotation_cloud.RemoveAnnotationsRequest(options)
result = api.remove_annotations(request)
print("RemoveAnnotations: Annotations removed: " + result['href'])
Rimuovi le annotazioni dal file DOCX usando Python
Scarica il file di output
L’esempio di codice precedente salverà il file DOCX di output (output.docx) dopo aver rimosso le annotazioni nel cloud. Puoi scaricarlo utilizzando il seguente esempio di codice:
# istanza dell'API
file_api = groupdocs_annotation_cloud.FileApi.from_config(configuration)
# richiesta di download del file
request = groupdocs_annotation_cloud.DownloadFileRequest("output.docx", my_storage)
response = file_api.download_file(request)
# Sposta il file scaricato nella tua directory di lavoro
shutil.move(response, "C:\\Files\\")
Prova in linea
Prova il seguente strumento di annotazione DOCX online gratuito, sviluppato utilizzando l’API di cui sopra. https://products.groupdocs.app/annotation/docx
Conclusione
In questo articolo, hai imparato come estrarre o rimuovere annotazioni dai documenti di Word nel cloud usando Python. Hai anche imparato come caricare a livello di codice il file DOCX sul cloud e scaricare il file dal cloud. Puoi saperne di più su GroupDocs.Annotation Cloud API utilizzando la documentazione. Forniamo anche una sezione Riferimento API che ti consente di visualizzare e interagire con le nostre API direttamente attraverso il browser. In caso di qualsiasi ambiguità, non esitate a contattarci sul forum.