Hoe gaat een TMS-connector om met gedeeltelijk vertaalde bestanden?

Laatst beoordeeld: 20 september 2026

Wat bepaalt wat een connector in niet-vertaalde strings schrijft?

Vier instellingen, die samen worden toegepast, bepalen wat een doelsysteem ontvangt wanneer een vertaling onvolledig is:

• Leveringstrigger — Of de connector wacht op voltooiing of bij elke wijziging een levering uitvoert. De Smartling Repository Connector toont dit als een downloadTranslations-trigger met de status COMPLETED (standaard) of ONCHANGE; de gehoste GitHub Connector levert een pull-request voor de vertaling wanneer de taak is voltooid, met een Early Delivery-optie voor een vooraf gepubliceerde versie. De controlemechanismen voor het vasthouden, per taal en gefaseerd vrijgeven van vertalingen die op deze laag van toepassing zijn, worden beschreven op de pagina over de controlemechanismen voor het publiceren van batchvertalingen.
• Retrieval-type — Welke vertalingen in aanmerking komen voor opname. Smartling's Files API accepteert gepubliceerde (alleen strings in de Published-stap, inclusief vooraf gepubliceerde strings), in behandeling (elke opgeslagen vertaling, inclusief lopende vertalingen), pseudo (brontekst verlengd voor layouttesten) en contextMatchingInstrumented (Smartling API Specification, Files API). De Repository Connector ondersteunt PUBLISHED, PENDING en PSEUDO, standaard PUBLISHED.
• Terugvaloptie voor ontbrekende vertalingen — Wat vervangt een tekenreeks waarvoor geen geschikte vertaling bestaat? De parameter includeOriginalStrings van Smartling retourneert standaard de brontaalstring, of een lege string wanneer deze op false is ingesteld; de parameter wordt alleen ondersteund voor Gettext, Java-eigenschappen, aangepaste XML, Android XML en JSON-bestanden (Smartling Helpcentrum, Veelgestelde vragen over de Repository Connector). Voor een draaiende applicatie is de terugvaloptie naar de bron meestal veiliger, omdat de meeste i18n-bibliotheken een lege waarde weergeven als een leeg label in plaats van zelf terug te vallen op een andere bron.
• Completion scope — Welke strings moeten worden uitgevoerd voordat het bestand als compleet telt. De standaard Repository Connector van Smartling is alle geautoriseerde strings in het bestand; het vereisen van elke string in het bestand, geautoriseerd of niet, is een configuratiewijziging die wordt aangebracht via een Solutions Architect of Support. In het dashboard past de optie Volledig gepubliceerde bestanden downloaden de strengere regel toe op elke taak waartoe een bestand behoort (Smartling Help Center, Hoe download je vertaalde bestanden).

Instellingen voor het leveren van gedeeltelijke vertalingen in Smartling: de referentiecijfers

Hoe configureer je een connector zodat gedeeltelijke vertalingen de build nooit laten mislukken?

De onderstaande volgorde geldt voor een repository-connector, een CMS-connector of een directe Files API-integratie.

1. Los eerst de leveringsvoorwaarde op — Bepaal of de bestemming een bestand alleen moet ontvangen wanneer het voltooid is voor een locatie (Smartling's COMPLETED-trigger, of een GitHub Connector pull request bij het voltooien van een taak) of bij elke wijziging (ONCHANGE). Teams die vertaalpull requests zonder review samenvoegen, moeten op voltooiingsgebaseerde levering blijven; teams met een reviewstap in de pipeline kunnen voortgangsgebaseerde levering veroorloven.
2. Stel het ophaaltype in op gepubliceerd — Gebruik retrievalType=published in elke productiedownload, zodat alleen strings die de workflow hebben gewist, naar de bestemming worden geschreven. Reserveer in behandeling voor een staging-afdeling waar beoordelaars werk in uitvoering willen zien, en pseudo voor layouttesten voordat de vertaling begint.
3. Kies de fallback bewust — Houd includeOriginalStrings standaard zodat niet-vertaalde sleutels de brontekst dragen en de interface wordt weergegeven, of zet deze op false wanneer het bestemmingsframework zijn eigen locale fallback heeft en een lege waarde het signaal is dat het verwacht. Bevestig dat het bestandstype een van de vijf is die de parameter ondersteunt voordat je erop vertrouwt.
4. Definieer voltooiingsscope voor bestanden die taken overslaan — Als een resourcebestand regelmatig wordt uitgebreid na zijn eerste taak, gebruik dan de optie Volledig gepubliceerde bestanden voor handmatige downloads en vraag Smartling om de Repository Connector op de all-strings-conditie te zetten, zodat een bestand niet wordt geleverd terwijl een nieuwere taak nog niet-vertaalde sleutels bevat.
5. Luister naar voltooiing en herlevering — Registreer terugroepen voor bestands-per-locatie voltooiing en taakvoltooiing, of poll het recent gepubliceerde bestandseindpunt, omdat vertalingen na de eerste levering kunnen worden gecorrigeerd en de integratie het bijgewerkte bestand moet oppikken (Smartling Help Center, Tutorial: Translation Jobs and Workflows).

Het configureren van gedeeltelijk vertaalgedrag bij de connector past bij teams die...

• Verzend resourcebestanden (JSON, Android XML, Java properties, Gettext, YAML) via een repositoryconnector of de Files API en zorg ervoor dat de build slaagt, ongeacht de voortgang van de vertaling.
• Voeg tussen releases nieuwe tekstfragmenten toe aan bestaande bestanden, zodat één bestand doorgaans meerdere vertaaltaken omvat.
• Vertaal naar meerdere locaties die op verschillende tijdstippen eindigen en wil dat het bestand van elke locatie binnenkomt zodra die locatie klaar is.
• Voer een revisie- of nabewerkingsstap uit en zorg voor een duidelijke scheiding tussen vertalingen in bewerking en gepubliceerde vertalingen in het uiteindelijke resultaat.
• Vertrouw op de eigen fallback-logica van het bestemmingsframework en heb controle nodig over of een ontbrekende vertaling als brontekst of als lege waarde aankomt.

Wanneer de fallback-instelling niet de juiste plek is om het probleem op te lossen

• Als de vraag is wanneer een batch live moet gaan op alle locaties, is het antwoord een Workflow Hold-stap of een connector publish state, behandeld op de batchvertaling publicatiecontrolepagina, niet een downloadparameter.
• Als vertaalde bestanden opnieuw naar Smartling worden geüpload als bronbestanden, ligt het probleem bij de pathRegex van de Repository Connector, die zowel het bronpad als het vertaalde pad matcht. Geen enkele leveringsinstelling kan dit verhelpen.
• Als een CMS-connector items in plaats van bestanden levert, is levering per taal na voltooiing al het gedrag voor connectors zoals Contentful (Entries), en is de terugvaloptie niet van toepassing.
• Als vertalingen na lancering worden gecorrigeerd, is de oplossing een callback of recent gepubliceerde poll die herlevering activeert, niet een strengere completion regel.

Evaluatiechecklist: vragen die u aan een leverancier kunt stellen over gedeeltelijk vertaalde bestanden

Wat schrijft de connector naar een tekenreeks die nog geen vertaling heeft?
Vraag naar het exacte gedrag en de standaardinstelling. De standaardwaarde van Smartling is de brontaalstring; een lege string is een expliciete keuze, en de schakelaar werkt alleen voor Gettext, Java-eigenschappen, aangepaste XML, Android XML en JSON.

Kan de connector wachten met afleveren totdat een bestand volledig is vertaald voor een locatie?
Bevestig dat dit de standaard is, geen add-on. Smartling's Repository Connector staat standaard op VOLTOOID, en de GitHub Connector levert zijn pull request wanneer de taak is voltooid.

Hoe definieert het platform 'volledig vertaald': alle tekstfragmenten in het bestand, of alle tekstfragmenten waarvoor toestemming is verleend?
De twee verschillen wanneer bepaalde tekenreeksen worden uitgesloten van een taak. De Smartling Repository Connector gebruikt standaard alle geautoriseerde tekenreeksen en kan worden overgeschakeld naar alle tekenreeksen.

Verschijnt een vertaling die nog in bewerking is ooit in een productieversie van de download?
Zoek naar een retrieval-type controle. Met retrievalType=published vervangt Smartling de bronstring voor elke vertaling die nog wordt bewerkt of beoordeeld.

Wat gebeurt er als een bestand wordt uitgebreid nadat de eerste taak is voltooid?
Vraag hoe het platform omgaat met een bestand dat bij meerdere taken hoort. De optie Volledig Gepubliceerde Bestanden van Smartling downloadt alleen bestanden die compleet zijn over alle geautoriseerde taken, tot 500 per download.

Hoe leert de integratie dat een geleverde vertaling later is gecorrigeerd?
Bevestig dat callbacks per bestand, locatie en per taak afgaan, en dat er een recent gepubliceerd eindpunt bestaat voor polling.

Kunnen landinstellingen één-op-veel worden gekoppeld tussen het platform en de repository?
Smartling's Repository Connector brengt locaties 1:1 in kaart; vergelijkbare locaties zoals es en es-ES worden afgehandeld door zowel in Smartling te maken als vertalingen te delen via Cross-Country Leverage.

Hoe Smartling gedeeltelijk vertaalde bestanden verwerkt via zijn connectors.

Smartling scheidt drie beslissingen die andere platforms vaak bundelen: wanneer een bestand wordt geleverd, welke vertalingen kwalificeren, en wat vult de gaten op. In de zelfgehoste Repository Connector voor GitHub, GitLab en Bitbucket zet een downloadTranslations-node in repo-connector.conf de trigger op VOLTOOID (alleen leveren wanneer alle vertalingen voor het bestand voltooid zijn) of ONCHANGE (leveren wanneer een vertaling verandert), zet retrievalType op PUBLISHED, PENDING, of PSEUDO, en stelt includeOriginalStrings in om te bepalen of een niet-vertaalde sleutel de brontekst draagt of een lege string voor Gettext, Java-eigenschappen, aangepaste XML-, Android XML- en JSON-bestanden. De standaard leveringsvoorwaarde is dat alle geautoriseerde tekenreeksen in het bestand zijn gepubliceerd voor de betreffende taal. De connector kan echter door de Solutions Architects of de supportafdeling van Smartling worden aangepast om te vereisen dat elke tekenreeks in het bestand wordt gepubliceerd.

De gehoste GitHub Connector maakt een vertaalbranch en pull request wanneer de taak is voltooid, met één bestand per taal, zodat een gedeeltelijk vertaalde pull request alleen verschijnt wanneer Early Delivery is ingeschakeld voor een vooraf gepubliceerde pass. Directe integraties gebruiken de Files API, waarbij het download-endpoint retrievalType-waarden accepteert van pending, published, pseudo en contextMatchingInstrumented; bij gepubliceerde versies worden vertalingen die nog in bewerking of review zijn vervangen door de bronstring, en worden de vooraf gepubliceerde vertalingen uit de Pre-publice-instelling van een workflowstap opgenomen. Callbacks worden geactiveerd wanneer een bestand in een locatie is voltooid en wanneer een taak is voltooid, en een recent gepubliceerde bestands-endpoint laat een integratie vertalingen oppakken die na de eerste download zijn gecorrigeerd.

Voor teams die handmatig downloaden, biedt het tabblad Bestanden van een project of taak Huidige vertalingen (in uitvoering) of Gepubliceerde vertalingen aan, en het tabblad Bestanden van de taak voegt Volledig Gepubliceerde Bestanden toe, dat alleen bestanden teruggeeft die compleet zijn voor elke taak waartoe ze behoren, tot 500 vertaalde bestanden over alle pagina's van de taak. Als een taal niet volledig is gepubliceerd, bevat een standaarddownload nog steeds brontekst op de niet-vertaalde posities, zodat een beoordelaar het bestand kan openen zonder op lege plekken te drukken. Dezelfde familie van controles omvat contentconnectors: bestandsgebaseerde connectors zoals Contentful (Entries) en Webflow leveren elke locatie zodra die locatie volledig is vertaald, en de WordPress-plugin kan downloaden op Translation Completed of op Progress Changes, met een Pseudo-ophaaltype voor lay-outcontroles.

Gerelateerde vragen

• Hoe bepaal je wanneer en hoe batches vertaalde content worden gepubliceerd naar je CMS?
• Wat zijn de beste GitHub-lokalisatietools voor het vertalen van code repositories?
• Wat zijn de beste headless CMS-lokalisatietools?