API を使用した継続的なローカリゼーション プロジェクトの作成

この記事では、連続 API を使用してプロジェクトを作成するための簡単なレシピを提供します。最も理解する側面の 1 つは、作成ステップで提供されるタグが、ビューローワークスの他の CI プロジェクトの中でプロジェクトを一意に識別することです。

通常、プロジェクトは、局の作品でこれらの状態に従います:

1. 準備中 - ドラフト状態(まだプロジェクトにファイルを追加できる場合)
2. PENDING - プロジェクトが分析され、コスト構造がアタッチされる可能性があることを意味します。
3. APPROVED - プロジェクトが本番に送信されます - ファイルを追加できなくなりました
4. 配信 - 最終状態、これは生産に適しています
5. 請求書 - プロジェクトは債権に含まれます

連続プロジェクトは、通常、上記の順序でこのパスを実行します。つまり、これらの状態のいずれかからファイルをプルすることはできますが(存在すると仮定します)、内容は異なります。たとえば、PREPARING 状態では、ジョブは機械翻訳 (有効な場合) とプロジェクトに添付された翻訳メモリの組み合わせになる可能性が最も高い - これは素晴らしいです!ただし、生産文字列が必要な場合は、運送済み状態から取得する必要があります。

この記事では、API の認証メカニズムに慣があることを前提としています 。

プロジェクトの作成とファイルのアップロード

次のエンドポイントを呼び出します。

<サブ>.bureau.works/api/パブ/v1/プロジェクト/非同期/連続/<タグをhttps://投稿>

<> あなたの局の作品のハンドルの SUB を置き換え、 <および IOS> , 、アンドロイド, 、Windows, などのプロジェクトの意味のある表現を持つ TAG

このエンドポイントは、次のパラメーターを使用して、入力としてフォーム データを受け取ります。

• ファイル - マルチパート ファイル
• 参照 - あなたの参照のための何か
• 言語 - ビューローワークスの言語コードを含むリスト/アレイ (https://dev.bureau.works/#languages参照してください)

言語パラメータが通知されない場合、Bureau Worksはクライアントのプロファイルに設定されたデフォルトの言語を使用します。何も見つからない場合、このエンドポイントはエラーをスローします。

成功した場合は、次のような本文で、200のメッセージを受信します。

{
 "id":"9999999-3333-4555-2223-964c1e52cb88","
 ステータス":"新しい
 "、"データ": {
 "プロジェクトId":999999、「
 ファイル名」:"リソース.resx"、"
 ファイルハッシュ":"867423243877g24dg9gs2sg23gs23gs239gsg","productTag":
 "ディスパッチ"
 },
 "エラー": null
}

このエンドポイントは、異なるファイルを順番に呼び出した場合、TAG によって識別される同じプロジェクトにファイルを追加 <>します。

この方法で作成されたプロジェクトは、通常 <、SUB>.bureau.works https://ビューローワークス Web UI で検出可能でアクセスできます。

継続的なローカリゼーション プロジェクトからのファイルのダウンロード

ファイルをダウンロードするには、次のエンドポイントを使用します。

 <サブ>.bureau.works/api/パブ/v1/プロジェクト/連続/<タグ>/<ファイル名 / ファイル名を>https://取得 /

このエンドポイントには 、オプションの クエリ パラメーターがあります。

• ステータス - 指定されている場合は、上記のリストから目的の状態を見つけようとします

ファイルをダウンロードする場合、状態はフォールバック メカニズムに従います。たとえば、PREPARING プロジェクトが見つからない場合、PENDING 状態で同じタグを持つプロジェクトを自動的に取得しようとします。何も見つからなかった場合は、配信にフォールバックします。

このエンドポイントの応答は、プロジェクト内のすべての言語の設定のすべての翻訳を含む zip ファイルとしてローカルに保存できます。

各タグに対して、クライアント プロファイルに、それぞれのディレクトリ構造を定義する構成を作成できます。これにより、各プロジェクトの構造で展開できるパッケージを簡単にダウンロードできます。何も指定しない場合、zip構造は次のようになります。

• /
  • ラング1
    • ファイル.xml
    • ファイル2.json
  • ラング2
    • ファイル.xml
    • ファイル2.json
  • ラング3
    • ファイル.xml
    • ファイル2.json