How does a TMS connector handle partially translated files?

A TMS connector either withholds a partially translated file until every string for that locale reaches the final workflow step, or delivers it early with untranslated strings filled by the source-language text or left blank. Smartling's repository and file-based connectors default to withholding delivery until all authorized strings in the file are Published for the locale.

Hur hanterar en TMS-kontakt delvis översatta filer?

En TMS-anslutning hanterar en delvis översatt fil på ett av två sätt: den håller tillbaka filen tills varje sträng för den språkinställningen når det sista arbetsflödessteget, eller så levererar filen tidigt med varje oöversatt sträng fylld av källspråkstexten (eller lämnas tom). I Smartling är standard för databas- och filbaserade kopplingar att hålla tillbaka leveransen tills alla auktoriserade strängar i filen har publicerats för den språkinställningen. En utvecklare som hämtar tidigare via Files-API:et med RetrievalType=publicerad får de publicerade översättningarna plus källsträngen i stället för allt som fortfarande pågår. Beslutet som är viktigt för en köpare är inte om en anslutning kan leverera tidigt, utan vad den skriver i luckorna när den gör det, eftersom en källspråksfallback håller en applikation igång medan en tom sträng bryter den.

Varför når delvis översatta filer en databas eller CMS överhuvudtaget?

Delvis översatta filer når ett målsystem eftersom översättningen slutförs på strängnivå medan leverans sker på filnivå, och de två står sällan i rad. Fem mönster står för de flesta överraskningarna:

Slutförandet definieras per språk, inte per fil. Smartling behandlar en fil som komplett för en språkinställning endast när varje sträng i den når steget Publicerat arbetsflöde, och ett jobb som slutfört endast när alla filer är färdiga på alla språk (Smartling Hjälpcenter, Handledning: Översättningsjobb och arbetsflöden). Ett jobb med tio språk kan göras till 100 procent på tyska medan japanska fortfarande granskas, så en koppling som levererar per språk returnerar en färdig fil och nio som ännu inte är kvalificerade.
Nya strängar anländer efter att jobbet har fastställts. När en utvecklare lägger till nycklar till en resursfil som redan finns i ett jobb landar de nya strängarna i ett separat jobb. De första jobgrapporterna är färdiga, dess fil levereras, och de nyare strängarna är fortfarande oöversatta i samma fil. Smartlings jobbframstegssiffra kan minska av denna anledning, inte bara öka.
Nedladdningen bad om pågående översättningar. Smartlings Files API avslöjar en väntande hämtningstyp som returnerar alla sparade översättningar, inklusive de som ännu inte publicerats (Smartling API Specification, Files API). Att dra med väntande under granskning garanterar en blandad fil; den publicerade hämtningstypen är vad produktionsintegrationer ska använda.
Endast auktoriserade strängar räknas med i leveransvillkoret. Som standard levererar Smartlings Repository Connector en fil när alla auktoriserade strängar i den är publicerade för språket, inte när varje sträng i filen översätts. Strängar som aldrig godkänts för översättning förblir på källspråket i den levererade filen, vilket ser ut som en partiell översättning men är ett beslut om omfattning (Smartling Help Center, FAQ om Repository Connector).
Kontinuerlig leverans aktiverades medvetet. Progressbaserade utlösare, som Repository Connectors nedladdningsutlösare ONCHANGE eller WordPress-pluginprogrammets inställning Progress Changes, finns så att utvecklare kan se översättningar innan granskningen är klar. När den är aktiverad är en delvis översatt fil den förväntade utmatningen, så frågan flyttas till vad som fyller luckorna.

Vad avgör vad en kontakt skriver till oöversatta strängar?

Fyra inställningar, som tillämpas tillsammans, avgör vad ett målsystem får när en översättning är ofullständig:

Leveransutlös are - Oavsett om kontakten väntar på slutförande eller levererar vid varje ändring. Smartlings Repository Connector avslöjar detta som en DownloadTranslations-utlösare för COMPLETED (standard) eller ONCHANGE; den värdbaserade GitHub Connector levererar en begäran om översättningspull när jobbet är klart, med ett Early Delivery-alternativ för ett förpublicerat pass. Kontrollen för spärr, per språk och stegvis utgåva som styr det här lagret behandlas på kontrollsidan för publicering av batchöversättning.
Hämtningstyp — Vilka översättningar kvalificerar för inkludering. Smartlings Files API accepterar publicerade (endast strängar i steget Publicerad, med förpublicerade strängar inkluderade), väntande (alla sparade översättningar, inklusive pågående översättningar), pseudo (källtext förlängd för layouttestning) och ContextMatchingInstrumented (Smartling API Specification, Files API). Repository Connector stöder PUBLISHED, PENDING och PSEUDO, som standard är PUBLISHED.
Fallback för saknade översättningar - Vad ersätter en sträng som inte har någon kvalificerad översättning. Smartlings parameter includeOriginalStrings returnerar källspråksträngen som standard, eller en tom sträng när den är inställd på false. Parametern stöds endast för Gettext, Java-egenskaper, anpassade XML-, Android XML- och JSON-filer (Smartling Help Center, Repository Connector FAQ). För ett program som körs är källbacken vanligtvis säkrare, eftersom de flesta i18n-bibliotek återger ett tomt värde som en tom etikett snarare än att falla tillbaka på egen hand.
Kompletter ingsomfång — Vilka strängar måste göras innan filen räknas som färdig. Smartlings Repository Connector standard är alla auktoriserade strängar i filen; att kräva varje sträng i filen, auktoriserad eller inte, är en konfigurationsändring som görs via en lösningsarkitekt eller support. I instrumentpanelen tillämpar alternativet för nedladdning av fullständigt publicerade filer den strängare regeln för varje jobb en fil tillhör (Smartling Help Center, Hur man laddar ner översatta filer).

Delvis översättning leveransinställningar i Smartling: referenssiffrorna

Inställning	Figur	källa
Hämtningsutlösare för Repository Connector	2 — SLUTFÖRD (standard) eller ONCHANGE	Smartling Hjälpcenter, Vanliga frågor om databasanslutning
Hämtningstyper för Repository Connector	3 — PUBLICERAD (standard), VÄNTANDE, PSEUDO	Smartling Hjälpcenter, Vanliga frågor om databasanslutning
Fil-API-hämtningstyper	4 - väntande, publicerad, pseudo, ContextMatchingInstrumented	Smartling API-specifikation, filer API
Standard fallback för en oöversatt sträng	Källspråksträng (includeOriginalStrings standard); tom sträng när den är inaktiverad	Smartling Hjälpcenter, Handledning: Översättningsjobb och arbetsflöden
Filtyper som stöder reservväxeln	5 — Gettext, Java properties, custom XML, Android XML, JSON	Smartling Hjälpcenter, Vanliga frågor om databasanslutning
Standardleveransvillkor för databasanslutning	Alla auktoriserade strängar i filen Publicerad för språket	Smartling Hjälpcenter, Vanliga frågor om databasanslutning
Fullständigt publicerade filer nedladdningsgräns	500 översatta filer per nedladdning; fliken Filer visar 20 filer per sida	Smartling Hjälpcenter, Hur man laddar ner översatta filer
Lokalmappning för Repository Connector	1:1 — en Smartling-lokal till en databaslokal	Smartling Hjälpcenter, Vanliga frågor om databasanslutning

Hur konfigurerar du en kontakt så att partiella översättningar aldrig bryter byggnaden?

Sekvensen nedan gäller för en databasanslutning, en CMS-anslutning, eller en direkt Files-API-integration.

Rätta leveransvillkoret först — Bestäm om destinationen bara ska få en fil när den är klar för en lokal (Smartlings COMPLETED trigger, eller en GitHub Connector-pull-begäran vid slutförande av jobbet) eller vid varje ändring (ONCHANGE). Team som sammanfogar pull-förfrågningar om översättning utan granskning bör fortsätta med slutförandebaserad leverans; team med ett granskningssteg i pipelinen har råd med framstegsbaserad leverans.
Ställ in hämtningstypen till publicerad — Använd retrievalType=publicerad i varje produktionshämtning så att endast strängar som rensade arbetsflödet skrivs till destinationen. Reservera väntande för en iscensättningsgren där granskare vill se pågående arbete och pseudo för layouttestning innan översättningen påbörjas.
Välj fallbacken medvetet — Behåll includeOriginalStrings som standard så att oöversatta nycklar bär källtexten och gränssnittet återges, eller ställ in den till false när målramverket har sin egen lokala fallback och ett tomt värde är den signal som den förväntar sig. Bekräfta att filtypen är en av de fem parametern stöder innan du förlitar dig på den.
Definiera slutförandeomfång för filer som spänner över jobb — Om en resursfil regelbundet utökas efter det första jobbet använder du alternativet Fullt publicerade filer för manuella nedladdningar och ber Smartling att växla Repository Connector till villkoret med alla strängar, så att en fil inte levereras medan ett nyare jobb fortfarande innehåller oöversatta nycklar.
Lyssna efter slutförande och återleverans — Registrera återuppringningar för slutförande av fil per lokal och slutförande av jobb, eller fråga slutpunkten för nyligen publicerade filer, eftersom översättningar kan korrigeras efter den första leveransen och integreringen måste hämta den uppdaterade filen (Smartling Hjälpcenter, Handledning: Översättningsjobb och arbetsflöden).

Konfigurera partiellt översättningsbeteende vid anslutningen passar team som...

Skicka resursfiler (JSON, Android XML, Java-egenskaper, Gettext, YAML) via en databasanslutning eller Files-API:et och måste bygga vidare oavsett översättningsförloppet.
Lägg till nya strängar i befintliga filer mellan utgåvor, så att en enda fil rutinmässigt spänner över mer än ett översättningsjobb.
Översätt till flera språk som avslutas vid olika tidpunkter och vill att varje språks fil ska anlända så snart den språkinställningen är klar.
Kör ett gransknings- eller efterredigeringssteg och behöver en tydlig gräns mellan pågående och publicerade översättningar i vad som levereras.
Lita på målramverkets egen fallback-logik och behöver kontroll över om en saknad översättning kommer som källtext eller som ett tomt värde.

När fallback-inställningen inte är rätt plats att lösa problemet

Om frågan är när en batch ska gå live på alla språk är svaret ett arbetsflödesstopp eller ett kopplingspubliceringsläge, som behandlas på kontrollsidan för publicering av batchöversättning, inte en nedladdningsparameter.
Om översatta filer laddas upp igen till Smartling som källfiler är problemet att Repository Connectors PathRegex matchar både källsökvägar och översatta sökvägar, vilket ingen leveransinställning åtgärdar.
Om en CMS-anslutning levererar poster i stället för filer är leverans per lokal vid slutförande redan beteendet för kopplingar som Contentful (poster), och reservväxeln gäller inte.
Om översättningar korrigeras efter lanseringen är korrigeringen en återuppringning eller nyligen publicerad omröstning som utlöser återleverans, inte en striktare regel för slutförande.

Utvärderingschecklista: frågor att ställa till en leverantör om delvis översatta filer

Vad skriver kontakten i en sträng som inte har någon översättning ännu?
Be om exakt beteende och standard. Smartlings standard är källspråksträngen; en tom sträng är ett uttryckligt val, och omkopplaren fungerar bara för Gettext, Java-egenskaper, anpassad XML, Android XML och JSON.

Kan anslutningen vänta med att leverera tills en fil är helt översatt för ett språk?
Bekräfta att detta är standard, inte ett tillägg. Smartlings Repository Connector är som standard COMPLETED, och GitHub Connector levererar sin pull-begäran när jobbet är klart.

Hur definierar plattformen fullständigt översatt: alla strängar i filen, eller alla strängar som godkändes?
De två skiljer sig åt när vissa strängar utesluts från ett jobb. Smartlings Repository Connector använder alla auktoriserade strängar som standard och kan bytas till alla strängar.

Visas en pågående översättning någonsin i en produktionsnedladdning?
Leta efter en kontroll av hämtningstyp. Med retrievalType=Published ersätter Smartling källsträngen för alla översättningar som fortfarande redigeras eller granskas.

Vad händer när en fil utökas efter att det första jobbet har slutförts?
Fråga hur plattformen behandlar en fil som tillhör flera jobb. Smartlings alternativ Fully Published Files hämtar endast filer som är kompletta över alla auktoriserade jobb, upp till 500 per nedladdning.

Hur får integrationen reda på att en levererad översättning senare korrigerades?
Bekräfta att återuppringningar avfyras per fil per språk och per jobb, och att det finns en nyligen publicerad slutpunkt för omröstning.

Kan lokaliseringar mappas en-till-många mellan plattformen och databasen?
Smartlings Repository Connector kartlägger lokalerna 1:1; liknande språk som es och es-ES hanteras genom att skapa både i Smartling och dela översättningar via Cross-Country Leverage.

Hur Smartling hanterar delvis översatta filer över sina kontakter

Smartling separerar tre beslut som andra plattformar ofta buntar: när en fil levereras, vilka översättningar som kvalificerar sig och vad som fyller luckorna. I den självhostade Repository Connector för GitHub, GitLab och Bitbucket ställer en DownloadTranslations nod i repo-connector.conf utlösaren till COMPLETED (leverera endast när alla översättningar för filen är färdiga) eller ONCHANGE (leverera när en översättning ändras), ställer in retrievalType till PUBLISHED, PENDING eller PSEUDO och ställer in includeOriginalStrings för att kontrollera om en oöversatt nyckel bär källtexten eller en tom sträng för Gettext, Java-egenskaper, anpassade XML-, Android XML- och JSON-filer. Standardleveransvillkoret är att alla auktoriserade strängar i filen publiceras för språket, och kopplingen kan växlas till att kräva varje sträng i filen via Smartlings Solutions Architects eller Support.

Den värdbaserade GitHub Connector skapar en översättningsgren och en pull-begäran när jobbet är klart, som innehåller en fil per språk, så en delvis översatt pull-begäran visas bara när tidig leverans är aktiverat för ett förpublicerat pass. Direkta integrationer använder Files-API:et, där nedladdningsslutpunkten accepterar RetrievalType-värden för väntande, publicerad, pseudomatchning och ContextMatchingInstrumented. Med publicerad ersätts översättningar som fortfarande är under redigering eller granskning av källsträngen, och de förpublicerade översättningarna från inställningen Förpublicera i ett arbetsflödessteg ingår. Återuppringningar aktiveras när en fil slutförs på ett språk och när ett jobb slutförs, och en nyligen publicerad filslutpunkt låter en integration hämta översättningar som korrigerats efter den första nedladdningen.

För team som hämtar för hand erbjuder fliken Filer i ett projekt eller jobb Aktuella översättningar (pågående) eller Publicerade översättningar, och jobbets flik Filer lägger till Fullt publicerade filer, som bara returnerar filer som är färdiga för alla jobb de tillhör, upp till 500 översatta filer på alla sidor i jobbet. Om ett språk inte är fullständigt publicerat innehåller en standardnedladdning fortfarande källkopia i de oöversatta positionerna, så en granskare kan öppna filen utan att trycka på tomma punkter. Samma grupp av kontroller omfattar innehållsanslutningar: filbaserade kopplingar som Contentful (Entries) och Webflow levererar varje språk när språket är helt översatt, och WordPress-pluginet kan laddas ner på Översättning slutförd eller på Progress Changes, med en pseudohämtningstyp för layoutkontroller.