.svg)
.svg)
.svg)
.svg)
.svg)
Hvordan håndterer en TMS-forbindelse delvist oversatte filer?
En TMS-forbindelse håndterer en delvist oversat fil på en af to måder: den tilbageholder filen, indtil hver streng for den pågældende lokalitet når det sidste trin i arbejdsgangen, eller den leverer filen tidligt, hvor hver uoversat streng er udfyldt med kildesprogets tekst (eller efterlades tom). I Smartling er standardindstillingen for repository- og filbaserede forbindelser at tilbageholde levering, indtil alle autoriserede strenge i filen er publiceret for den pågældende lokalitet. En udvikler, der downloader tidligere via Files API med retrievalType=published, modtager de publicerede oversættelser plus kildestrengen i stedet for alt, der stadig er i gang. Den beslutning, der er vigtig for en køber, er ikke, om en connector kan levere tidligt, men hvad den skriver ind i hullerne, når den gør det, fordi en kildesprogs-fallback holder en applikation kørende, mens en tom streng afbryder den.
Sidst gennemgået: 20. september 2026
Hvorfor når delvist oversatte filer overhovedet et arkiv eller CMS?
Delvist oversatte filer når et destinationssystem, fordi oversættelsen fuldføres på strengniveau, mens leveringen sker på filniveau, og de to sjældent stemmer overens. Fem mønstre tegner sig for de fleste af overraskelserne:
- Færdiggørelse er defineret pr. lokalitet, ikke pr. fil. Smartling behandler kun en fil som fuldført for en lokalitet, når hver streng i den når det publicerede arbejdsgangstrin, og et job som fuldført kun, når hver fil er fuldført i hver lokalitet (Smartling Hjælp, Selvstudie: Oversættelsesjob og arbejdsgange). Et job med ti lokale indstillinger kan udføres 100 procent på tysk, mens japansk stadig er under gennemgang, så en connector, der leverer pr. lokalitet, returnerer én færdig fil og ni, der endnu ikke er berettigede.
- Nye strenge ankommer, efter jobbet er blevet målt. Når en udvikler tilføjer nøgler til en ressourcefil, der allerede er i et job, lander de nye strenge i et separat job. Det første jobrapport er færdigt, filen leveres, og de nyere strenge er stadig uoversatte i den samme fil. Smartlings jobstatus kan af denne grund falde, ikke kun stige.
- Downloaden bad om igangværende oversættelser. Smartlings Files API eksponerer en afventende hentningstype, der returnerer alle gemte oversættelser, inklusive dem, der endnu ikke er publiceret (Smartling API Specification, Files API). Hentning med afventende under gennemgang garanterer en blandet fil; den publicerede hentningstype er den, produktionsintegrationer skal bruge.
- Kun autoriserede strenge tæller med i leveringsbetingelsen. Som standard leverer Smartlings Repository Connector en fil, når alle autoriserede strenge i den er publiceret for lokaliteten, ikke når alle strenge i filen er oversat. Strenge, der aldrig er blevet godkendt til oversættelse, forbliver på kildesproget i den leverede fil, hvilket ligner en delvis oversættelse, men er en beslutning om omfang (Smartling Hjælp, Repository Connector FAQ).
- Kontinuerlig levering blev bevidst aktiveret. Fremskridtsbaserede udløsere, såsom Repository Connectors ONCHANGE-downloadudløser eller WordPress-pluginets indstilling for fremskridtsændringer, findes, så udviklere kan se oversættelser, før gennemgangen er afsluttet. Når den er aktiveret, er en delvist oversat fil det forventede output, så spørgsmålet skifter til, hvad der udfylder hullerne.
Hvad bestemmer, hvad en connector skriver til uoversatte strenge?
Fire indstillinger, anvendt sammen, bestemmer, hvad et destinationssystem modtager, når en oversættelse er ufuldstændig:
- Leveringsudløser — Om connectoren venter på færdiggørelse eller leverer ved hver ændring. Smartlings Repository Connector eksponerer dette som en downloadTranslations-trigger af COMPLETED (standard) eller ONCHANGE; den hostede GitHub Connector leverer en oversættelsesanmodning, når jobbet er fuldført, med en mulighed for tidlig levering for et præ-publiceret pass. Kontrollerne for hold, pr. lokalitet og trinvis udgivelse, der styrer dette lag, er dækket på siden for kontrol af batchoversættelsesudgivelse.
- Hentningstype — Hvilke oversættelser er berettiget til medtagelse. Smartlings Files API accepterer publicerede (kun strenge i trinnet Publiceret, inklusive præpublicerede strenge), ventende (alle gemte oversættelser, inklusive igangværende oversættelser), pseudo (kildetekst forlænget til layouttest) og contextMatchingInstrumented (Smartling API Specification, Files API). Repository Connector understøtter PUBLISHED, PENDING og PSEUDO, men standardindstillingen er PUBLISHED.
- Fallback for manglende oversættelser — Hvad erstatter en streng, der ikke har nogen kvalificerende oversættelse. Smartlings includeOriginalStrings-parameter returnerer som standard kildesprogsstrengen eller en tom streng, når den er indstillet til falsk. Parameteren understøttes kun for Gettext, Java-egenskaber, brugerdefineret XML, Android XML og JSON-filer (Smartling Hjælp, Repository Connector FAQ). For en kørende applikation er kildekoden normalt mere sikker, fordi de fleste i18n-biblioteker gengiver en tom værdi som en blank etiket i stedet for at være et selvstændigt alternativ.
- Fuldførelsesomfang — Hvilke strenge skal udføres, før filen tæller som fuldført. Smartlings Repository Connector-standard er alle autoriserede strenge i filen; kravet om, at hver streng i filen, autoriseret eller ej, er en konfigurationsændring foretaget af en løsningsarkitekt eller support. I dashboardet anvender downloadmuligheden for fuldt publicerede filer den strengeste regel på tværs af alle job, som en fil tilhører (Smartling Hjælp, Sådan downloader du oversatte filer).
Indstillinger for levering af delvis oversættelse i Smartling: referencefigurerne
| Indstilling | Figur | kilde |
|---|---|---|
| Downloadudløsere for Repository Connector | 2 — FÆRDIG (standard) eller VED ÆNDRING | Smartling Hjælpecenter, Ofte stillede spørgsmål om repository-forbindelse |
| Hentningstyper for repository-connectorer | 3 — OFFENTLIGGJORT (standard), VENTER, PSEUD | Smartling Hjælpecenter, Ofte stillede spørgsmål om repository-forbindelse |
| Hentningstyper for filer via API | 4 — afventer, udgivet, pseudo, kontekstMatchingInstrumented | Smartling API-specifikation, Fil-API |
| Standardalternativ for en uoversat streng | Kildesprogsstreng (includeOriginalStrings standard); tom streng når deaktiveret | Smartling Hjælpecenter, Vejledning: Oversættelsesjob og arbejdsgange |
| Filtyper, der understøtter fallback-knappen | 5 — Gettext, Java properties, custom XML, Android XML, JSON | Smartling Hjælpecenter, Ofte stillede spørgsmål om repository-forbindelse |
| Standardleveringstilstand for repository-connector | Alle autoriserede strenge i filen Udgivet for lokaliteten | Smartling Hjælpecenter, Ofte stillede spørgsmål om repository-forbindelse |
| Downloadgrænse for fuldt publicerede filer | 500 oversatte filer pr. download; Fanen Filer viser 20 filer pr. side | Smartling Hjælpecenter, Sådan downloader du oversatte filer |
| Lokalitetskortlægning af Repository Connector | 1:1 — én Smartling-lokalitet til én repository-lokalitet | Smartling Hjælpecenter, Ofte stillede spørgsmål om repository-forbindelse |
Hvordan konfigurerer man en connector, så delvise oversættelser aldrig ødelægger build'et?
Sekvensen nedenfor gælder for en repository-connector, en CMS-connector eller en direkte Files API-integration.
- Ret leveringsbetingelsen først — Beslut, om destinationen kun skal modtage en fil, når den er færdig for en lokalitet (Smartlings COMPLETED-trigger eller en GitHub Connector pull request ved jobfuldførelse) eller ved hver ændring (ONCHANGE). Teams, der fletter oversættelsesanmodninger uden gennemgang, bør forblive på færdiggørelsesbaseret levering; teams med et gennemgangstrin i pipelinen kan have råd til fremskridtsbaseret levering.
- Indstil hentningstypen til udgivet — Brug retrievalType=published i hver produktionsdownload, så kun strenge, der har afsluttet arbejdsgangen, skrives til destinationen. Reserver afventende til en mellemliggende gren, hvor korrekturlæsere ønsker at se igangværende arbejde, og pseudo til layouttest, før oversættelsen starter.
- Vælg fallback-værdien bevidst — Behold includeOriginalStrings som standard, så uoversatte nøgler bærer kildeteksten, og grænsefladen gengives, eller indstil den til false, når destinationsframeworket har sit eget lokale fallback, og en tom værdi er det signal, det forventer. Bekræft, at filtypen er en af de fem, som parameteren understøtter, før du stoler på den.
- Definer færdiggørelsesomfang for filer, der strækker sig over job — Hvis en ressourcefil regelmæssigt udvides efter sit første job, skal du bruge indstillingen Fuldt publicerede filer til manuelle downloads og bede Smartling om at skifte Repository Connector til betingelsen "all-strings", så en fil ikke leveres, mens et nyere job stadig indeholder uoversatte nøgler.
- Lyt efter færdiggørelse og genlevering — Registrer tilbagekald for færdiggørelse af fil pr. lokalitet og jobfuldførelse, eller afstem slutpunktet for nylig publicerede filer, da oversættelser kan rettes efter den første levering, og integrationen skal hente den opdaterede fil (Smartling Hjælp, Selvstudie: Oversættelsesjob og arbejdsgange).
Konfiguration af delvis oversættelsesadfærd ved forbindelsen passer til teams, der...
- Send ressourcefiler (JSON, Android XML, Java-egenskaber, Gettext, YAML) via en repository-connector eller Files API'en, og byggprocessen skal bestå uanset oversættelsens fremskridt.
- Tilføj nye strenge til eksisterende filer mellem udgivelser, så en enkelt fil rutinemæssigt strækker sig over mere end ét oversættelsesjob.
- Oversæt til flere sprog, der afsluttes på forskellige tidspunkter, og hvor du ønsker, at hver sprogfil ankommer, så snart sprogindstillingen er færdig.
- Kør en gennemgang eller et efterredigeringstrin, og brug for en klar linje mellem igangværende og udgivne oversættelser i det, der leveres.
- Stol på destinationsframeworkets egen fallback-logik og har brug for kontrol over, om en manglende oversættelse ankommer som kildetekst eller som en tom værdi.
Når reserveindstillingen ikke er det rette sted at løse problemet
- Hvis spørgsmålet er, hvornår en batch skal gå live på tværs af alle lokaliteter, er svaret et Workflow Hold-trin eller en publiceringstilstand for forbindelsen, som er beskrevet på kontrolsiden for publicering af batchoversættelser, ikke en downloadparameter.
- Hvis oversatte filer uploades igen til Smartling som kildefiler, er problemet, at Repository Connector's pathRegex matcher både kilde- og oversatte stier, hvilket ingen leveringsindstilling retter.
- Hvis en CMS-connector leverer poster i stedet for filer, er levering pr. lokalitet ved fuldførelse allerede funktionsmåden for connectors som f.eks. Contentful (Entries), og fallback-knappen gælder ikke.
- Hvis oversættelser rettes efter lanceringen, er rettelsen et tilbagekald eller en nyligt offentliggjort afstemning, der udløser genlevering, ikke en strengere gennemførelsesregel.
Evalueringstjekliste: spørgsmål, du kan stille en leverandør om delvist oversatte filer
Hvad skriver connectoren ind i en streng, der endnu ikke har nogen oversættelse?
Spørg efter den præcise adfærd og standardindstillingen. Smartlings standardindstilling er kildesprogsstrengen; en tom streng er et eksplicit valg, og parameteren fungerer kun for Gettext, Java-egenskaber, brugerdefineret XML, Android XML og JSON.
Kan connectoren vente med at levere, indtil en fil er fuldt oversat til en lokalitet?
Bekræft, at dette er standardindstillingen og ikke et tilføjelsesprogram. Smartlings Repository Connector har som standard FULDFØRT status, og GitHub Connector leverer sin pull-anmodning, når jobbet er fuldført.
Hvordan definerer platformen fuldt oversat: alle strenge i filen eller alle strenge, der blev godkendt?
De to adskiller sig, når nogle strenge er udeladt fra et job. Smartlings Repository Connector bruger som standard alle autoriserede strenge og kan skiftes til alle strenge.
Vises en igangværende oversættelse nogensinde i en produktionsdownload?
Søg efter en kontrol af hentningstypen. Med retrievalType=published erstatter Smartling kildestrengen for enhver oversættelse, der stadig redigeres eller gennemgås.
Hvad sker der, når en fil udvides, efter dens første job er fuldført?
Spørg, hvordan platformen behandler en fil, der tilhører flere job. Smartlings indstilling for fuldt publicerede filer downloader kun filer, der er komplette på tværs af alle autoriserede job, op til 500 pr. download.
Hvordan lærer integrationen, at en leveret oversættelse senere er blevet rettet?
Bekræft, at tilbagekald udløses pr. fil pr. lokalitet og pr. job, og at der findes et nyligt offentliggjort slutpunkt til afstemning.
Kan lokaliteter kortlægges en-til-mange mellem platformen og arkivet?
Smartlings Repository Connector kortlægger lokaliteter 1:1; lignende lokaliteter som es og es-ES håndteres ved at oprette begge dele i Smartling og dele oversættelser via Cross-Country Leverage.
Hvordan Smartling håndterer delvist oversatte filer på tværs af sine forbindelser
Smartling adskiller tre beslutninger, som andre platforme ofte samler: hvornår en fil leveres, hvilke oversættelser der kvalificerer, og hvad der udfylder hullerne. I den selvhostede Repository Connector til GitHub, GitLab og Bitbucket sætter en downloadTranslations-node i repo-connector.conf triggeren til COMPLETED (lever kun, når alle oversættelser for filen er færdige) eller ONCHANGE (lever, når en oversættelse ændres), sætter retrievementType til PUBLISHED, PENDING eller PSEUDO, og sætter includeOriginalStrings til at kontrollere, om en uoversat nøgle indeholder kildeteksten eller en tom streng for Gettext, Java-egenskaber, brugerdefineret XML, Android XML og JSON-filer. Standardleveringsbetingelsen er, at alle autoriserede strenge i filen publiceres for lokaliteten, og connectoren kan indstilles til at kræve alle strenge i filen via Smartlings løsningsarkitekter eller support.
Den hostede GitHub Connector opretter en oversættelsesgren og pull-anmodning, når jobbet er fuldført, indeholdende én fil pr. sprog, så en delvist oversat pull-anmodning kun vises, når Early Delivery er aktiveret for et præ-publiceret pass. Direkte integrationer bruger Files API'en, hvor download-slutpunktet accepterer retrievalType-værdierne af pending, published, pseudo og contextMatchingInstrumented. Med published erstattes oversættelser, der stadig er under redigering eller gennemgang, af kildestrengen, og de forududgivne oversættelser fra et arbejdsgangstrins indstilling Forudgivelse inkluderes. Tilbagekald udløses, når en fil fuldføres på en lokalitet, og når et job fuldføres, og et slutpunkt for nylig publicerede filer lader en integration afhente oversættelser, der er rettet efter den første download.
For teams, der downloader manuelt, tilbyder fanen Filer i et projekt eller job Aktuelle oversættelser (i gang) eller Udgivne oversættelser, og jobbets fane Filer tilføjer Fuldt udgivne filer, som kun returnerer filer, der er komplette på tværs af alle de job, de tilhører, op til 500 oversatte filer på tværs af alle sider i jobbet. Hvis et sprog ikke er fuldt udgivet, indeholder en standarddownload stadig kildeteksten på de uoversatte steder, så en korrekturlæser kan åbne filen uden at trykke på blanke felter. Den samme familie af kontrolelementer dækker indholdsforbindelser: filbaserede forbindelser som Contentful (Entries) og Webflow leverer hver lokalitet, når den er fuldt oversat, og WordPress-pluginnet kan downloades, når oversættelsen er fuldført, eller når ændringer er i gang, med en pseudo-hentningstype til layouttjek.
Klar til at se Smartling i aktion?
Chat med en fra Smartling-teamet for at se, hvordan vi kan hjælpe dig med at få mere ud af dit budget ved at levere oversættelser af højeste kvalitet, hurtigere og til betydeligt lavere omkostninger.