Translation Service

Hvorfor den finnes

Plattformen trenger flerspråklig innholdslevering uten å duplisere eller forgrene den underliggende innholdsmodellen. Oversettelsesstøtte oppretter språkvarianter på dokumentnivå koblet til kildedokumentene sine, samtidig som den opprinnelige skjema- og innholdsstrukturen bevares.

Bruk dette når

• oversetter én eller flere komponenter til flere språk
• sporer fremdriften til en masseoversettelsesjobb
• prøver mislykkede oversettelser på nytt
• korrigerer maskinproduserte oversettelser manuelt
• leser oversatt innhold i en dokumentasjons- eller nettstedsapp
• bygger språkspesifikke dokumentvisninger i CMS-et

Hva det inkluderer

• massevalg av komponenter og språk i CMS-et
• asynkrone oversettelsesjobber med fremdriftssporing
• dokumentoversettelse støttet av TensorZero
• automatisk hopp over oversettelser som allerede er oppdaterte
• deduplisering av identiske aktive oversettelsesjobber
• gjenoppretting av aktiv jobbframdrift etter navigasjon i CMS-et
• kontroller for å prøve mislykkede oversettelser på nytt
• vedvarende målspråkpreferanser
• manuell korrigering av oversettelser via patch-endepunktet
• språkbevisst dokumenthenting
• kildehash-er for å oppdage utdaterte oversettelser
• oversettelsesbevisste databasekolonner og -indekser

Kjernearbeidsflyt

1. Åpne siden Komponenter og velg Send til oversettelse.
2. Velg én eller flere komponenter og målspråk.
3. Gå gjennom estimert antall oversettelser og legg partiet i kø.
4. Oversettelsesbehandleren laster inn de publiserte kildedokumentene og hopper over oversettelser der kildehashen allerede er oppdatert.
5. Gjenværende oversettelser behandles asynkront via TensorZero.
6. Overvåk oversettelser i kø, fullførte, hoppet over og mislykkede oversettelser fra CMS-et.
7. Prøv mislykkede oversettelser på nytt ved behov.
8. Korriger oversatt innhold manuelt når maskinprodusert resultat trenger justering.
9. Les oversatte varianter via språkbevisste skjema- og dokument-API-er.

Oversettelsesjobber

Å sende inn et parti oppretter en oversettelsesjobb. En jobb registrerer:

• valgte komponenter og språk
• kildedokumenter behandlet
• planlagte oversettelser
• oversettelser hoppet over fordi de allerede er oppdaterte
• fullførte oversettelser
• mislykkede oversettelser
• gjeldende jobbstatus

Å sende inn det samme valget mens en tilsvarende jobb er aktiv kobler seg til den eksisterende jobben i stedet for å skape duplikatarbeid.

CMS-et lagrer identifikatoren for den aktive jobben lokalt slik at fremdriften kan gjenopprettes etter navigasjon. Tilstanden for oversettelsesjobber holdes for øyeblikket i minnet av oversettelsesbehandleren og tømmes når tjenesten startes på nytt. Distribuer tjenesten som én enkelt instans eller bruk sticky routing slik at jobbinndata og statusforespørsler når samme prosess.

Oppdagelse av utdaterte oversettelser

Hvert oversatte dokument lagrer en hash av kildedokumentets publiserte innhold på tidspunktet det ble oversatt.

Når et annet oversettelsesparti sendes inn:

• samsvarende hash-er indikerer at oversettelsen er oppdatert og kan hoppes over
• ulike hash-er indikerer at kilden har endret seg og at oversettelsen bør regenereres

Dette gjør masseoversettelse trygg å kjøre gjentatte ganger uten å oversette uendret innhold på nytt.

API-endepunkter

• POST /translation — legg oversettelser for én eller flere komponenter i kø
• GET /translation-jobs/{job_id} — les status og fremdrift for oversettelsesjobben
• PATCH /translations — korriger oversatt innhold manuelt

Systemflater

• dialog for masseoversettelse i CMS-et
• CMS-kontroller for oversettelsesjobbstatus og gjenoppretting
• API for oversettelsesbehandler og bakgrunnsarbeidere
• TensorZero-integrasjon for oversettelse
• språkspesifikke dokumentvisninger i CMS-et
• språkbevisst innlastning av innhold i dokumentasjonsappen
• persistens for oversettelser og sporing av kildehash