Verwenden der API zum Erstellen kontinuierlicher Lokalisierungsprojekte

Dieser Artikel enthält ein einfaches Rezept zum Erstellen von Projekten mit der kontinuierlichen API. Einer der wichtigsten Aspekte zu verstehen ist, dass das Tag im Erstellungsschritt bietet, ein Projekt unter anderen CI-Projekten in Bureau Works eindeutig identifizieren wird.

Normalerweise folgt ein Projekt diesen Zuständen in Bureau Works:

1. PREPARING - Entwurfszustand, wenn Sie dem Projekt noch Dateien hinzufügen können
2. PENDING - es bedeutet, dass das Projekt analysiert wurde und eine Kostenstruktur angefügt werden kann
3. APPROVED - das Projekt wird an die Produktion gesendet - Dateien können nicht mehr hinzugefügt werden
4. DELIVERED - Endzustand, das ist gut für die Produktion
5. INVOICED - Projekt ist in Forderungen

Ein fortlaufendes Projekt führt diesen Pfad normalerweise in der obigen Reihenfolge aus. Das bedeutet, dass Sie Dateien aus einem dieser Zustände abrufen können (vorausgesetzt, dass sie vorhanden sind), aber der Inhalt variiert. Im Zustand PREPARING wird ein Auftrag höchstwahrscheinlich eine Mischung aus maschineller Übersetzung sein, sofern aktiviert, und den Dem Projekt beigefügten Translation Memories - was großartig ist! Wenn Sie jedoch Produktionszeichenfolgen benötigen, müssen Sie aus dem STATUS DELIVERED ziehen.

In diesem Artikel wird davon ausgegangen, dass Sie mit dem Authentifizierungsmechanismus in der API vertraut sind.

Erstellen von Projekt- und Uploaddateien

Rufen Sie den folgenden Endpunkt auf:

POST https://<SUB>.bureau.works/api/pub/v1/project/async/continuous/<TAG>

Ersetzen Sie <SUB für Ihren Bureau> Works-Handle und <TAG durch eine> aussagekräftige Darstellung Ihres Projekts, wie z., , , B. ios , android , Windows , etc.

Dieser Endpunkt empfängt eine Formulardaten als Eingabe mit den folgenden Parametern:

• Datei - mehrteilige Datei
• Referenz - etwas für Ihre Referenz
• Sprachen - eine Liste/Array mit den Bureau Works Sprachencodes (siehe https://dev.bureau.works/#languages)

Wenn die Sprachparameter nicht informiert werden, übernimmt Bureau Works die Standardsprachen, die im Profil des Clients eingerichtet sind. Wenn keine gefunden werden kann, löst dieser Endpunkt einen Fehler aus.

Im Erfolgsfall erhalten Sie eine 200-Nachricht, mit einem Körper wie diesem:

•
 "id": "9999999-3333-4555-2223-964c1e52cb88",
 "Status": "NEW",
 "data":
 "projectId": 999999,
 "fileName": "Resources.resx",
 "fileHash": "867423243877g24dg9gs2gg2sg23gs239gsg",
 "productTag": "dispatch"
 
 "error": null

Dieser Endpunkt fügt die Dateien demselben Projekt hinzu, das von der TAG identifiziert wurde, wenn er nacheinander mit verschiedenen Dateien aufgerufen <>wird.

Projekte, die mit dieser Methode erstellt wurden, sind normalerweise auffindbar und können in der Web-BEnutzeroberfläche von Bureau Works unter https://<SUB>.bureau.works.

Herunterladen von Dateien aus continuous Localization Projects

Verwenden Sie zum Herunterladen von Dateien den folgenden Endpunkt:

GET https:// SUB<>.bureau.works/api/pub/v1/project/continuous/<TAG /><FILENAME>/

Dieser Endpunkt verfügt über einen optionalen Abfrageparameter:

• Status - wenn angegeben, wird versuchen, den gewünschten Zustand aus der Liste oben zu finden

Beim Herunterladen von Dateien folgt der Status einem Fallback-Mechanismus. Wenn z. B. ein PREPARING-Projekt nicht gefunden wird, versucht es automatisch, das Projekt mit demselben Tag im Status PENDING abzurufen. Wenn keine gefunden wurde, wird es auf DELIVERED zurückgreifen, und so weiter.

Die Antwort dieses Endpunkts kann lokal als ZIP-Datei gespeichert werden, die alle Übersetzungen für alle im Projekt eingerichteten Sprachen enthält.

Für jedes tag ist es möglich, eine Konfiguration im Clientprofil zu erstellen, die für jedes Tag eine Verzeichnisstruktur definiert. Auf diese Weise wird es einfach, Pakete herunterzuladen, die für die Bereitstellung in der Struktur jedes Projekts bereit sind. Wenn keine angegeben, wird die Zip-Struktur:

• /
  • lang1
    • file.xml
    • File2.json
  • lang2
    • file.xml
    • File2.json
  • lang3
    • file.xml
    • File2.json