RaccomandazioneEsegui il backup prima di modificare. Elimina solo con i tuoi ID, utilizzando il command-line and user-specified identifiers to avoid errors. Check the initial size della sezione del glossario per comprendere l'impatto e preparare un singolo csv_data file che elenca i glossari di destinazione da rimuovere, quindi esegue l'eliminazione nel tuo ambiente.
Per eseguire l'eliminazione, utilizzare il command-line fluire con deeplclientoptions to authenticate and set the scope. For a single glossary, pass the ID or name and run one deletion; for multiple glossari, fare riferimento a csv_data file and process in one batch. The operation should return successful stato per ciascun elemento.
Dopo l'esecuzione, verifica interrogando l'API o l'interfaccia utente per confermare che il glossario non sia più recuperabile. Salva un timestamp e un backup locale. file per l'audit, quindi rimuovere il temporaneo csv_data file se ne hai utilizzato uno.
Grazie agli strumenti DeepL, puoi controllare con precisione le eliminazioni, mantenere pulito il tuo elenco di glossario e ridurre l'accumulo di elementi in diversi progetti. Se hai bisogno di automazione, imposta un piccolo script che legge il csv_data and uses the command-line flusso per eliminare i glossari in multiple passes e registra gli esiti come successful entries.
Individua il glossario nella console di amministrazione di DeepL
Aprire la DeepL Admin Console e accedere con le proprie credenziali di amministratore. Nella navigazione a sinistra, fare clic su Glossari, quindi passare al contesto del progetto se necessario per filtrare l'elenco. Qui è possibile visualizzare il nome del glossario, il doc_id e lo stato in una tabella ricercabile. Questa visualizzazione è disponibile anche a ihnen.
- Trova il glossario: usa la casella di ricerca o filtra per nome, doc_id o coppia linguistica per isolare la voce; i glossari di cui non hai bisogno rimangono nascosti fino a quando non vengono aperti.
- Apri i dettagli: clicca sulla riga del glossario per visualizzare le voci, le variabili e la cronologia. La visualizzazione mostra replacement_entries e la data dell'ultimo aggiornamento.
- Modifica le voci: opzionalmente modifica le voci manualmente; aggiungi nuove sostituzioni, regola le coppie e salva le modifiche. Il campo metodo indica come il glossario si applica durante i flussi di lavoro, inclusa la traduzione_documento_upload.
- Validare con test: eseguire test per confermare che le traduzioni siano in linea con il glossario in mundo e in altre lingue; dopo le modifiche, confrontare i risultati con gli output previsti.
- Propagare le modifiche: inviare aggiornamenti al client tramite l'opzione di streaming o chiamate API dirette; clientrephrasetextasynca può eseguire lo streaming di aggiornamenti durante l'elaborazione di un documento.
- Gestione problemi: se si verifica un problema, ricontrollare doc_id e le mappature delle variabili, quindi rieseguire i test; se necessario, creare una coppia sostitutiva manualmente e ricaricare utilizzando translate_document_upload.
- Consigli per la manutenzione: che tu gestisca un singolo glossario o una flotta, mantieni una cronologia pulita e voci_di_sostituzione concise per ridurre il rumore e migliorare i tempi di ricerca.
Esegui il backup dei dati del glossario prima dell'eliminazione
Esporta i dati del glossario in un archivio locale prima di eliminare qualsiasi voce. Conferma che il backup contenga tutti i glossari, le mappature glossary_languages e i metadati della licenza associati.
Esegui il backup sia dei dati di origine che del contesto operativo: le voci del glossario, le coppie linguistiche e qualsiasi account utilizzato per creare o modificare i glossari. Conserva una copia del bundle di dati originale in una posizione separata per facilitare il recupero se necessario.
Utilizza python3 e un piccolo strumento per serializzare i glossari in un formato portatile. Crea un pacchetto di file che includa glossary.json, glossary_languages.json e license.json. Inserisci il backup in una directory protetta e assicurati che il percorso binario sia accessibile tramite usrlocalbin aggiungendo un collegamento simbolico se necessario.
Per sistemi con permessi restrittivi, esegui l'esportazione con sudo solo quando necessario per accedere a directory restrittive. Quindi, modifica i permessi per consentire al tuo utente di leggere i file. Se operi dietro un proxy, esporta le impostazioni del proxy nell'ambiente: esporta http_proxy e https_proxy, e fornisci le credenziali necessarie.
Valida il backup calcolando un checksum (SHA256) ed elencando i file. Apri l'archivio e verifica che ogni glossary_id appaia con le sue voci linguistiche. Tieni un registro dei ritorni dello script di esportazione e delle dimensioni dei file per confermare la completezza.
Piano di ripristino: tenere traccia di dove sono archiviati i backup, dei termini di licenza e della fonte esatta dei dati. In caso di cancellazione, reimportare tramite lo stesso strumento o API puntando al pacchetto di backup. Riformulare i dati per ripristinare formati e mapping, se necessario, assicurando che i glossari e le glossary_languages siano allineati con la fonte originale.
| Step | Action | Note / Esempio |
|---|---|---|
| 1 | Inventario | List glossaries and glossary_languages; capture IDs and language pairs, e.g., "en-de" and "de-en". |
| 2 | Export | Run a Python3-based package to export: example tool export_glossaries --output /backup/glossaries-backup.json --glossaries all; ensure /backup is writable. |
| 3 | Integrità | Calcola l'SHA256 per l'archivio; confronta con un valore noto valido se disponibile. |
| 4 | Protezione | Spostati in una posizione sicura; impostare le autorizzazioni e, se necessario, utilizzare sudo per modificare la proprietà. |
| 5 | Documentazione | Registrare la fonte esatta, inclusi i termini di licenza e le mappature glossary_languages; notare l'utilizzo di proxy e i riferimenti all'account. |
Elimina il glossario dalla Console Amministratore: passo dopo passo
Elimina il glossario direttamente dalla Admin Console selezionandolo e facendo clic su Elimina, quindi conferma nel prompt. Questa azione è supportata in tutti i piani e migliorerebbe l'igiene dei dati per i glossari. Assicurati di avere pronto il tuo deeplclientauthkey e il progetto corretto; partendo dalla home della Admin Console, passa alla visualizzazione dei Glossari e individua il glossario esatto per nome. Questa modifica influenzerebbe solo il glossario scelto e manterrebbe intatti gli altri glossari.
Nella visualizzazione dei glossari, raggiungere il glossario specifico e aprire i suoi dettagli. Verificare le mappature origine-destinazione (source-target) e confermare di eliminare l'oggetto previsto. Se il glossario include frasi come hello, cómo o お元気ですか, considerare di esportarle o rivederle prima dell'eliminazione. Da qui, cliccare Elimina e confermare nella finestra di dialogo. L'operazione prende di mira il glossario specifico e non influirà su altri glossari.
Dopo l'eliminazione, verificare che il glossario non appaia più nell'elenco dei glossari, e rivedere gli oggetti correlati e le configurazioni di visualizzazione per assicurarsi che non vi siano riferimenti orfani. Se si gestiscono ambienti multi-piattaforma come xamarinwatchos, confermare che la modifica sia riflessa su tutti i dispositivi connessi. Validazione di base: assicurarsi che il comportamento predefinito del flusso di lavoro di traduzione sia preservato e che fornire una nota chiara sull'eliminazione aiuti la rintracciabilità.
Per ridurre al minimo l'impatto sulla formalità e sulla funzionalità, evitare di eliminare i glossari che sono ancora in uso da traduzioni. Fornire un breve riepilogo nelle note amministrative aiuta i team a rimanere allineati. Come best practice, eseguire prima una rimozione di prova in un ambiente di staging per verificare i risultati e assicurarsi che l'iniziale governance sia in linea con le proprie policy.
Infine, esegui un'ultima verifica: cerca nuovamente il nome del glossario nella vista e assicurati che sia scomparso. Se persistono dei riferimenti, rimuovili dagli oggetti correlati tramite l'API o la console. Il processo è semplice e mantiene la Console di amministrazione ben organizzata, pronta per futuri aggiornamenti del glossario; questo approccio sarebbe riproducibile e affidabile.
Eliminazione tramite API: autenticazione, endpoint e payload
Autenticare prima, quindi eliminare il glossario tramite l'API. Utilizzare la propria API key nell'header Authorization come Bearer ed evitare di esporre credenziali senza questo header. Assegnare un'identità client chiara come deepldeeplclient in User-Agent; per app cross-platform (xamarintvos, monotouch), assicurarsi che HttpClient passi correttamente le intestazioni. Se si gestiscono glossari multilingue, è possibile inizializzare deepl_clientcreate_multilingual_glossary durante la configurazione per preparare i contesti, ma l'eliminazione dipende solo dal glossary_id. Registrare l'esito su un output_path per semplificare il debug qui e mantenere le variabili per il monitoraggio dello stato. La key deve essere assegnata al proprio account per eseguire l'eliminazione; le risposte includono 200 in caso di successo, 404 quando il glossary_id è sconosciuto o 429 per il rate limiting. La chiamata delete utilizza l'endpoint sottostante; non è necessario un corpo payload, e l'operazione dovrebbe essere tentata tramite un canale sicuro. Se il proprio client richiede un corpo minimo, inviare un oggetto JSON vuoto o un payload che trasporti glossary_id nel percorso, non nel corpo.
Authentication
Utilizza la chiave API dal tuo account DeepL Pro. Esempio di header: Authorization: Bearer . Includi Content-Type: application/json se la tua libreria lo richiede; altrimenti, omettilo. Nel codice, memorizza la chiave in modo sicuro e non registrarla mai. Per build di computer o dispositivi mobili, tieni le credenziali al di fuori del controllo del codice sorgente e propaga gli errori in modo chiaro. Il nome deepldeeplclient aiuta a tracciare nei log e si allinea con l'ortografia britannica quando si localizzano i messaggi. Se hai bisogno di un tono più diplomatico per i messaggi rivolti agli utenti, mostra uno stato chiaro senza esporre dettagli che potrebbero favorire un uso improprio.
Endpoint e payload
Endpoint: DELETE https://api-free.deepl.com/v2/glossaries/{glossary_id} (usa la regione corrispondente al tuo piano). Non è necessario un corpo per una cancellazione standard; se la tua libreria lo richiede, lascialo vuoto o includi solo glossary_id nel percorso. Analizza la risposta JSON per confermare la rimozione e aggiorna di conseguenza la tua UI o il tuo flusso di lavoro. In caso di successo, rispondi aggiornando l'utente e scrivendo lo stato finale in output_path; in caso di errore, acquisisci il codice e il messaggio dell'errore, quindi riprova con una strategia di backoff. Utilizza le variabili per gestire i conteggi di riprova e i timeout, e assicurati che il passaggio successivo nella tua pipeline venga eseguito tramite il percorso previsto.
Verifica l'eliminazione tra UI e integrazioni
Elimina la voce del glossario tramite ID tramite l'API, quindi verifica che il flag di risposta indichi il successo e che l'elemento venga rimosso dal repository di origine (elimina).
Nell'interfaccia utente, cerca utilizzando il languagecode fornito e il termine specificato; verifica che il risultato sia empty e la voce non appare più nelle viste elenco o dettaglio.
Attraverso le integrazioni, interroga i servizi a valle che consumano i dati del glossario. Confronta gli ID referenziati con un comma-separated elenco; conferma che non rimangono riferimenti e che il campo interessato utilizza il valore aggiornato.
Genera un'esportazione per validare il flusso di dati: usa csvstream per ottenere lo stato corrente del glossario, scrivi a output_path, e includi colonne per directory, named, and languagecode. Se esporti con encodingutf-8-sig, l'intestazione viene codificata correttamente; altrimenti encodingutf-8 funziona anche. Il option to use output_path aiuta a tracciare la provenienza.
Per test locali in un homebrew configurazione, esegui la CLI dai tuoi strumenti installati tramite homebrew e verifica tramite l'interfaccia utente e l'API; times tra le esecuzioni dovrebbe essere minimale, e puoi rieseguire per confermare la propagazione attraverso projects.
Opzionalmente, cattura un report di verifica finale: genera un piccolo file JSON o CSV, con campi named, languagecode, number, status (eliminato/esistente), e empty se nessuno rimane; memorizzare sotto il directory named verification_reports.
For xamarintvos builds, avvia un test di smoke dopo l'eliminazione per confermare che la modifica si rifletta nell'interfaccia utente mobile e in qualsiasi servizio connesso; in caso contrario, sincronizza nuovamente con un job in background e ricontrolla dopo alcuni times.
Risoluzione problemi: risolvere gli errori di cancellazione più comuni
Identificare il codice di errore esatto restituito dal tentativo di eliminazione e ispezionare il registro delle operazioni correlate. Questo rapido passaggio di identificazione si concentra sui contenuti e sulle voci del glossario che si intende rimuovere, in modo da poter individuare la causa principale senza congetture.
Verificare la configurazione del glossario: esaminare le fonti configurate, confermare l'elenco dei file e controllare che my_csv_glossary utilizzi le colonne previste. Se i contenuti differiscono dallo schema, l'eliminazione può fallire.
Inserisci la richiesta di eliminazione con chiavi precise: copia l'id della voce, incollalo nella console e premi invio. Verifica l'id del glossario di destinazione e assicurati di rimuovere i contenuti corretti.
Disabilita plugin in conflitto o esegui in modalità pulita per evitare effetti collaterali. Se utilizzi un plugin per gestire le eliminazioni, disabilitalo temporaneamente, quindi riesegui e ispeziona printentries_responsedictionaries0 per lo stato corrente.
Riformula la richiesta se il server rifiuta la sintassi originale: utilizza una riformulazione sicura del comando, quindi invia nuovamente la risposta e confronta la risposta con l'esito previsto. Il risultato desiderato è una cancellazione riuscita senza errori.
Per distribuzioni xamarintvos, verificare la codifica e le intestazioni delle richieste. La funzione clientrephrasetextasynca deve gestire correttamente le chiamate asincrone; testare con un piccolo batch per assicurarsi che la risposta corrisponda al comportamento previsto.
Riguardo ai dati di test, crea un sottoinsieme minimo in file per validare i passaggi di cancellazione. Usa c{\'o}mo rimuoveresti da my_csv_glossary; inizia con un piccolo campione, quindi estenditi al glossario completo.
Continua l'ispezione stampando le voci correnti con printentries_responsedictionaries0, quindi passa all'eliminazione effettiva una volta che il risultato corrisponde allo stato desiderato.
Documentare il glossario e la risposta dopo ogni tentativo, in modo che la risoluzione dei problemi futuri possa riutilizzare i passaggi esatti.
Se i problemi persistono, contatta l'assistenza con un rapporto conciso che includa il codice di errore, l'ID del glossario, il numero di voci eliminate e il contenuto di esempio.
