Waarom het bestaat
Het platform heeft meertalige contentlevering nodig zonder het onderliggende contentmodel te dupliceren of te forken. Ondersteuning voor vertalingen maakt taalvarianten op documentniveau die gekoppeld zijn aan hun brondocumenten, terwijl het oorspronkelijke schema en de contentstructuur behouden blijven.
Gebruik dit wanneer
- één of meer componenten naar meerdere talen vertalen
- de voortgang van een bulkvertaalopdracht volgen
- mislukte vertalingen opnieuw proberen
- machinaal gegenereerde vertalingen handmatig corrigeren
- vertaalde content lezen in een documentatie- of website-app
- taalspecifieke documentweergaven bouwen in het CMS
Wat het omvat
- bulkselectie van componenten en talen in het CMS
- asynchrone vertaalopdrachten met voortgangsmonitoring
- door TensorZero ondersteunde documentvertaling
- automatisch overslaan van vertalingen die al actueel zijn
- deduplicatie van identieke actieve vertaalopdrachten
- herstel van de voortgang van actieve opdrachten na navigatie in het CMS
- herhaalopties voor mislukte vertalingen
- blijvende voorkeuren voor doeltalen
- handmatige vertaalcorrectie via het patch-endpoint
- taalbewuste documentopvraging
- bron-hashes om verouderde vertalingen te detecteren
- vertaalbewuste databasekolommen en -indexen
Kernworkflow
- Open de pagina Componenten en selecteer Naar vertaling verzenden.
- Kies één of meer componenten en doeltalen.
- Controleer het geschatte aantal vertalingen en zet de batch in de wachtrij.
- De vertaalmanager laadt de gepubliceerde brondocumenten en slaat vertalingen over waarvan de bronhash al actueel is.
- Overgebleven vertalingen worden asynchroon verwerkt via TensorZero.
- Volg vanuit het CMS de vertalingen die in de wachtrij staan, voltooid, overgeslagen of mislukt zijn.
- Probeer mislukte vertalingen indien nodig opnieuw.
- Corrigeer vertaalde content handmatig wanneer machinaal gegenereerde output aanpassing nodig heeft.
- Lees vertaalde varianten via taalbewuste schema- en document-API's.
Vertaalopdrachten
Het indienen van een batch maakt een vertaalopdracht aan. Een opdracht registreert:
- geselecteerde componenten en talen
- verwerkte brondocumenten
- geplande vertalingen
- vertalingen die zijn overgeslagen omdat ze al actueel zijn
- voltooide vertalingen
- mislukte vertalingen
- huidige opdrachtstatus
Het indienen van dezelfde selectie terwijl een equivalente opdracht actief is, maakt opnieuw verbinding met de bestaande opdracht in plaats van dubbel werk te creëren.
Het CMS slaat de identificatie van de actieve opdracht lokaal op, zodat de voortgang kan worden hersteld na navigatie. De status van vertaalopdrachten wordt momenteel in het geheugen bijgehouden door de vertaalmanager en wordt gewist wanneer de service opnieuw wordt gestart. Implementeer de service als een enkele instantie of gebruik sticky routing zodat opdrachten en statusaanvragen hetzelfde proces bereiken.
Detectie van verouderde vertalingen
Elk vertaald document slaat een hash op van de gepubliceerde inhoud van het brondocument op het moment van vertaling.
Wanneer een andere vertaalbatch wordt ingediend:
- overeenkomende hashes geven aan dat de vertaling actueel is en kan worden overgeslagen
- verschillende hashes geven aan dat de bron is gewijzigd en de vertaling opnieuw moet worden gegenereerd
Dit maakt het veilig om bulkvertalingen herhaaldelijk uit te voeren zonder ongewijzigde content opnieuw te vertalen.
API-eindpunten
POST /translation — vertalingen in de wachtrij plaatsen voor één of meer componentenGET /translation-jobs/{job_id} — de status en voortgang van een vertaalopdracht lezenPATCH /translations — vertaalde content handmatig corrigeren
Systeemoppervlakken
- CMS-dialoog voor bulkvertaling
- CMS-bediening voor status en herstel van vertaalopdrachten
- API van de vertaalmanager en achtergrondwerkers
- TensorZero-vertaalintegratie
- Taalspecifieke documentweergaven in het CMS
- Taalbewuste contentladen in de documentatie-app
- Persistentie van vertalingen en tracking van bronhashes