実行

送信した翻訳を見つけ、ドキュメントとロケールごとの状況を確認して、未完了の処理を復旧します。

翻訳の実行には、まとめて送信されたドキュメントと翻訳先言語が含まれます。実行を開くと、完了した翻訳先、処理中の翻訳先、対応が必要な翻訳先を確認できます。ある翻訳先で処理が成功していても、別の翻訳先では失敗している場合があります。

実行の状況はStudioで調べます。HTTP経由で送信した場合は、ローカライズAPIを開いてください。ファイル翻訳の場合は、CLIチャネルを開くか、コマンドが出力した実行リンクにアクセスしてください。リポジトリ連携やコンテンツ連携でも、それぞれの履歴から送信した処理にアクセスできます。

送信内容を見つける #

エンジンやAPIキーのフィルターを使って履歴を絞り込みます。実行IDを呼び出し元が保存したIDと照合し、対応するソースのリビジョンも調査用に手元に残してください。過去の送信を読み込むと、さらに前の履歴を確認できます。最初のページだけでは、アカウント全体のアクティビティを確認できません。

各行には、送信の開始日時、ファイル数、翻訳先ごとの進捗、ステータスが表示されます。行を展開すると、ドキュメントキーと翻訳先ロケールを確認できます。該当するロケールのステージを開き、進捗、警告、失敗、モデルの試行を確認してください。

APIジョブの初期状態はPendingで、画面には未開始と表示されます。ジョブを作成すると送信内容が保存され、不足している成果物をアップロードして開始すると処理が始まります。未開始のジョブがあるだけでは、プロバイダーで障害が発生しているとは判断できません。

翻訳先とステージを併せて確認する #

ジョブの状態には、Pending、Running、Completed、Failed、Cancelledがあります。各翻訳先はCompletedまたはFailedになります。翻訳先の結果がまだ確定していない間は、各ステージで処理状況を確認できます。

ステージの状態には、バッチ計画中、実行中、先行処理の待機中、完了、警告付きで完了、スキップ、キャンセル、失敗があります。併記されているメッセージを確認してください。スキップは、そのステージが無効になっていることや、既存の翻訳が再利用されたことを意味する場合があります。任意の改善処理が失敗しても、それまでに生成された利用可能なテキストが警告とともに残る場合があります。

翻訳先の最終結果がまだ確定していない間は、画面にキュー待ち、最終処理中、ステージ失敗と表示されることがあります。モデルの試行やステージが完了しただけでは、翻訳先の成果物が利用可能になったとは限りません。APIのフィールドについてはステージの進捗を、個々の試行についてはリクエストを参照してください。

出力先で結果を確認する #

APIでは、ジョブを取得し、ステータスがCompletedの翻訳先をそれぞれダウンロードします。失敗したジョブにも、利用可能なダウンロードURLがある完了済みの翻訳先が含まれている場合があります。再試行する範囲を決める前に、それらの結果を保存してください。

CLIでは、プルを使って元のプロジェクトに結果を取得します。連携機能では、出力先のレコードやリポジトリの変更を確認してください。翻訳の完了と書き戻しの成功は、別々に確認する必要があります。成果物が生成されていても、リポジトリのブランチや公開ページに反映されたとは限りません。

再構成後の形式、翻訳先ロケール、変数、承認された表現を確認してください。ほかの翻訳先の準備ができていても、リリースを判断する際は未完了の言語を見落とさないようにしてください。

問題のある処理を復旧する #

確認された状況次の対応
保留中のAPIジョブ不足している成果物をアップロードし、保存済みのジョブを開始します。
解析または対応付けの失敗選択した形式の原文または以前の翻訳を修正します。
権限、利用資格、請求に関する問題再試行する前に、呼び出し元のアクセスやアカウントの問題を解決します。
モデルのカバレッジ不足選択したエンジンと、そのロケールペアの設定を確認します。
人によるレビュー待ちInboxで割り当てられた作業を開きます。
プロバイダーまたはステージの失敗エラーを確認し、再試行が必要な翻訳先を特定します。
出力先への書き込み失敗完了済みの結果を出力先に反映する処理を復旧します。

APIの開始リクエストを再試行すると、再開可能な場合は、保存済みの同じ送信内容で処理が再開されます。失敗が確定して終了したジョブが再開されるわけではありません。原因を修正してから、残りの処理を新しいジョブとして送信してください。リクエストの冪等性と復旧については、ジョブのリファレンスで説明しています。

CLIでの処理は、原因を修正した後、元の状態と完了済みのファイルを保持したまま、元のプッシュを再実行してください。結果の取得方法とローカルでの修正を保持する方法については、中断したローカライズの実行を復旧するで説明しています。