Phrase Strings コネクター (Job Sync)

本コンテンツはPhrase Language AIの機械翻訳により、英語から翻訳されています。

Phrase Strings 統合機能 (Strings インターフェースでは Job Sync と呼ばれます) は、Phrase TMS と Phrase Strings を接続します。この統合機能は、ジョブレベルとプロジェクトレベルの両方の同期をサポートしています。

ジョブ同期

Strings で作成され、進捗ステータスで開始されたジョブは、翻訳用にTMSにインポートされ、翻訳後にStringsに送り返されます。デフォルトでは、Strings から TMS に送信されたジョブは XLIFF 2.0 ファイルとしてインポートされます。

きめ細かな制御を行うバッチベースのワークフローに推奨されます。
プロジェクトレベルの同期

選択した Strings プロジェクト内のすべてのキーは、ジョブ作成を必要とせずに TMS に転送されます。新しく追加または更新されたキーは、自動的に同期できるようになります。

継続的なローカライズのワークフローに推奨されます。

前提条件

TMS と Strings の両方のアプリケーションへのアクセスが必要です
TMS プロジェクトで使用される言語コードは、Strings ジョブのロケールコードと一致している必要があります。
Strings プロジェクトのデフォルト言語は、TMS プロジェクトで定義された原文言語と同じである必要があります。

注意

Figma ファイルは Strings ではライブファイル全体として表示できますが、TMS ではサポートされていません。TMS CAT Editor は、特定の Figma フレーム内の訳文コンテンツを SVG 形式でのみ表示できます。

Strings キー<1>の翻訳ステータスはサポートされていません。TMS へのインポート前に Strings で未検証とマークされたキーは、訳文に変更がない場合、検証済みとして Strings に戻すことができます。

Strings ジョブのインポート後に TMS で作成されるセグメントの数は、次の場合に元のキー数と異なる場合があります。

Strings でキーが除外済としてマークされています。除外キーはインポートされていません。
TMS でのジョブ作成時、XLIFF 2.0 のファイルインポート設定でセグメント XLIFF オプションが有効になっています。この場合、セグメントの数が Strings のキーの数が多い可能性があります。

Strings キーには HTML エンティティを含めることができます。TMS でコネクターを設定する場合、TMS の対応する文字を表示する代わりに、HTML エンティティを維持するために CDATA で HTML コンテンツを囲むオプションを有効にします。

Strings キーの原文テキストにある先頭および末尾のスペースは、TMS CAT Editor には表示されません。これらのスペースはスケルトン内で保持され、ジョブが Strings に同期される際に原文と訳文の両方に再挿入されます。これはStringsで設定された文字数制限のバリデーションに影響を与える可能性があります。なぜなら、翻訳中にエディタでスペースの数が反映されないためです。

コネクターを使用すると、複数のプロジェクトやファイルをAPCで監視できます。各プロジェクトは、1つのAPC内で個別にモニタリングする必要があります。

このコネクターは、ジョブのロケール注釈を使用して、対応するPhrase TMSプロジェクトに関するメタデータをStringsのジョブおよびジョブのロケールに添付します。ジョブのロケール注釈を一覧表示するためのPhrase Strings APIエンドポイントは、このメタデータを取得します。ジョブの訳文ロケールを一覧表示するためのエンドポイントにも、include_annotationsパラメーターがtrueに設定されている場合、このメタデータが含まれます。注釈付きのジョブにはtms_project_idやtms_in_progressなどのフィールドが含まれており、これらにより、リンクされたPhrase TMSプロジェクトにおけるStringsのジョブの進捗状況を追跡できます。

ICU メッセージと CLDR 複数形

ICU メッセージまたは複数形を含む Strings ジョブを翻訳用に TMS に送信する場合、XLIFF 2.0 ファイルインポート設定または TMS プロジェクトテンプレートで Parse ICU messages オプションを有効にします。

使用例

コネクターにはいくつかの使用例があります。

TMSプロジェクトマネージャは、ファイルをオンラインリポジトリからTMSプロジェクトに直接追加できます。
提出者がPhrase Stringsから直接リクエストにファイルを追加できるようにPhrase TMS提出者ポータルを設定します。
TMSプロジェクト自動作成（APC）を使用して、監視対象のファイルまたはフォルダの最終更新日の変更が検出されると、新しいプロジェクトが自動的に作成されます。
- ジョブレベルとプロジェクトレベルの両方の同期において、モニタリング対象のプロジェクトのパスは、ジョブフォルダまで選択する必要があります（スペース/プロジェクト/メイン/ジョブなど）。
- ジョブ同期の場合、APCは次のジョブ更新によってトリガーされます。
  - 新規追加キーまたは既存キーへの変更
  - Stringsの更新ジョブの納期
  備考
  
  ジョブを再度開いても、APCの更新にはカウントされません。
- プロジェクトレベルの同期の場合、APCは以下によってトリガーされます。
  - 新しく追加されたキー
  - 既存のキーへの変更
- APC 設定時に [毎回新規プロジェクト作成] を選択すると、リモートのオンラインリポジトリは原文だけでなく訳文の更新も監視できます
  
  訳文の更新を監視する場合、オンラインリポジトリで訳文コピーに変更が加えられると、Phrase TMSの翻訳メモリが自動的に更新されます。
- リモートで行われた訳文更新をTMに自動的に保存するを選択した場合、Strings訳文言語のキーテキストの変更は、関連するAPCプロジェクトで使用されるTMS翻訳メモリに自動的に更新されます。
TMSコネクターAPIを使用すると、通常はUIを介して手動で実行するステップを自動化できます。ウェブフックを使用すると、特定のイベント（ジョブのステータス変更など）をサードパーティのシステムに通知できます。

Job Syncsページ

Job Syncsページでは、Phrase Stringsコネクターを使用するすべてのジョブ同期設定（APC）を一元的に表示できます。これには、Stringsで直接作成された同期と、TMSで設定された同期の両方が、関連情報とともに含まれます。

Job Syncsページから、Stringsの管理者およびプロジェクトマネージャは、新しいジョブ同期の設定、既存のジョブ同期の編集（アクティブ/非アクティブのステータスを含む）、または削除を行うことができます。

既存のジョブ同期は、More More Menu メニューの関連オプションを使用して編集または削除できます。すべての変更はStringsとTMS間で同期されます。ジョブ同期を削除すると、TMSの対応するAPCが削除されます。

Job Syncsページには、左側のナビゲーションメニューのIntegrationsとJobsの両方からアクセスできます。

Stringsでジョブ同期を設定する

備考

TMSで必須のカスタムフィールドが定義されている場合、Stringsからのジョブ同期の設定はサポートされていません。

StringsとTMS間の新しいJob Syncを基本設定で設定するには、Strings UIで以下の手順に従ってください。

Integrationsページで、Job Sync統合機能の横にあるConfigureを選択します。

Job Syncsページが表示されます。
+ New Job Syncをクリックします。

Create new Job Syncウィンドウが表示されます。
Sync Nameを入力し、Assigned Strings projectsドロップダウンからTMSに接続するStringsプロジェクトを選択します。

同じ言語の組み合わせを持つプロジェクトのみを含めることができます。
必要に応じて、使用するTMS project templateを選択します。選択したTMSプロジェクトテンプレートは、割り当てられたStringsプロジェクトで定義されている言語セットと一致する必要があります。

同期されたジョブは、選択したテンプレートから作成されたTMSプロジェクトに追加されます。
- Defaultを選択すると、選択したStringsプロジェクトに基づいてTMSプロジェクトテンプレートが自動的に作成されます。
TMSで作成するプロジェクトのTypeを選択します。
- 継続的なプロジェクト
  
  デフォルトのオプション。
- 新規プロジェクト
  
  Stringsジョブで変更が検出されるたびに、新しいTMSプロジェクトが作成されます。
Export back to Stringsセクションで、TMSからの訳文をStringsにエクスポートする方法を制御するためのStringsエクスポート設定を指定します。
- 既存の翻訳を上書き
  
  Strings内の既存の訳文を更新します。
- ジョブを完了済みにする
  
  Stringsでジョブを自動的に完了としてマークします。
- 未変更の翻訳をStringsで検証
  
  未検証としてマークされたキーは、訳文が変更されていない場合、Stringsで自動的に検証済みとしてマークされます。
必要に応じて、Advanced optionsをクリックして追加のエクスポートオプションを表示します。
- ロケールを完了済みにする
  
  翻訳が同期されたら、特定のロケールを完了としてマークします。
- 新規のキーを作成し、既存のキーを更新する
  
  TMS からの新しいキーが Strings に作成され、既存のキーが更新されるようにします。
- 原文が保存されたバージョンと一致した場合にのみ翻訳を適用する
  
  エクスポート以降に Strings 内の原文が変更されている場合、翻訳が上書きされないようにします。
保存をクリックします。

新しい Job Sync 設定が、非アクティブなステータスで TMS Job Syncs 一覧に追加されます。アクティブ列の下にあるトグルを使用して、Job Sync を有効にします。

ヒント

より高度な設定を行うには、Phrase TMS 設定を使用してコネクターを設定します。

Phrase TMS設定

設定ページから、[統合機能]セクションまでスクロールします。
[コネクタ]をクリックします。

「コネクタ」ページが開きます。
コネクター作成をクリックします。

コネクター作成ページが開きます。
タイプを Phrase Strings<2> に変更し、コネクターの名前を入力します。
Strings から取得したアカウント ID とアクセストークンを入力します。
［接続テストTest connection］をクリックします。
- 成功すると、接続テストボタンの横に小さなチェックマークが表示されます。
TMS にインポートする項目を選択します。

訳文 Strings がインポートされない場合、XLIFF 2.0 ファイルのファイルインポート設定で Segment XLIFF が選択されていれば、XLIFF 2.0 ファイルをさらにセグメント化できます。
- 必要に応じて、詳細インポートオプションを有効または無効にします。
  - インポート時にTMSプロジェクトの原文言語を適用
    
    TMS プロジェクトの原文言語は、Strings プロジェクトの デフォルト 言語に関係なく適用されます。
  - 言語ごとにTMSジョブを作成
    
    すでに進捗中のロケールに対して重複する TMS ジョブが作成されないようにするには、このオプションを有効にします。多言語のジョブでより細かな制御が必要な場合に推奨されます。
  - CDATA内でHTMLコンテンツをラップする
    
    このオプションを使用すると、HTML エンティティが CDATA でラップされ、Strings と TMS 間の転送中に維持されます。
    
    このオプションを使用すると、ICU構文とインラインHTML要素を組み合わせたコンテンツをインポートできます。
エクスポートモードを選択します。
- 必要に応じて、以下のエクスポートオプションを有効または無効にします。
  - 翻訳を上書き
    
    既存の翻訳がファイルコンテンツで更新されないようにするには、無効にします。
  - キーを新規作成または更新
    
    新しいキーの作成や既存キーの更新を防ぐには、無効にします。
  - 原文が一致する場合にのみ翻訳を適用
    
    最新の原文コンテンツと一致しない翻訳は、同期中に除外されます。これにより、原文と訳文間の一貫性が維持され、古い訳文や誤った訳文を回避できます。
  - 翻訳が未変更の場合にのみ検証
    
    未検証<1>とマークされたキーは、訳文が変更されていない場合、Stringsで自動的に検証済みになります。
  - 言語を完了済みにする
    
    翻訳が同期されたら、特定のロケールを完了としてマークします。
  - ジョブを完了済みにする
    
    選択した場合、最後のロケールがアップロードされた場合にのみジョブが完了済になります。
指定する場合は、デフォルトのフォルダを選択します（保存後にのみ可能です）。
言語マッピングが表示され、必要に応じてカスタマイズできます。言語マッピングの変更は既存のジョブには影響しません。

一覧は5つのプロジェクトごとにページ分割され、プロジェクトはアルファベット順に並べ替えられます。まずA-Z（大文字）、次にa-z（小文字）の順です。
保存をクリックします。

コネクターが「コネクター」ページの一覧に追加されます。

統合機能でサポート：

TMS プロジェクトテンプレート
TMSワークフロー
ジョブブリーフィング<1>（プロジェクトレベルの同期を使用している場合は適用されません）
ジョブ期限<1>（プロジェクトレベルの同期を使用している場合は適用されません）

Strings に設定された納期は、TMS でプロジェクト納期を更新します。複数の異なる期限がある場合は、最も近い期限がTMSプロジェクトに適用されます。

プロジェクトの参考資料としてStringsからTMSに転送：

キー名

Stringsから転送され、TMS CATエディタのコンテキストメモビューにコンテキストキーとして表示されます。

キー説明

Stringsから転送され、TMS CATエディタのコンテキストメモビューにコンテキストメモとして表示されます。

最大キー文字数

Stringsから転送され、TMS CATエディタのコンテキストメモビューに表示されます。

スクリーンショット

StringsのスクリーンショットをTMS CAT Editorのコンテキストメモ<1>ペインに表示するには：
- TMSプロジェクト設定のアクセスとセキュリティ<2>セクションで、Phrase CAT Editorでの外部コンテンツの読み込みを許可する<1>オプションを有効にします。
- コンテキストメモ<2>ペインでリッチ<1>テキスト形式を選択します。
サポートされているファイル形式のカスタムメタデータ：
- .XLSX
- .CSV
- .XLIFF 2.0

APC経由のStrings訳文更新のモニタリング

APC経由でStringsで行われる訳文更新を監視する手順は、次のとおりです。

APC を設定する場合、新規プロジェクト毎回作成を選択。

これにより、Stringsで行われた訳文更新のオンラインリポジトリを監視できます。
APC セットアップの自動化セクションで、訳文訳文更新はリモートエンティティに自動的に保存されるを選択します。

Stringsの訳文言語コンテンツに対する変更は、APCモニタリングがトリガーされると自動的にPhrase TMS翻訳メモリに保存されます。

Phrase TMSエディタで訳文セグメントを変更することで、翻訳メモリの更新を上書きできます。これらの更新は、Phrase TMSジョブが完了するとStringsにエクスポートされます。

APCによるキー削除の動作

Stringsでキーを削除しても、ジョブに含まれた後のPhrase TMSジョブには影響しません。これは、一度限りの手動インポートで作成されたジョブの場合です。そのジョブは、手動で再インポートされるまで変更されません。

APC監視がアクティブな場合、Phraseはポーリングまたはウェブフックのトリガーごとにコンテンツハッシュを比較し、キー削除を含むあらゆる変更を、再同期をトリガーする更新として扱います。

継続的なプロジェクト<1>モードでは、再同期によって既存のPhrase TMSプロジェクトまたはジョブがStringsの現在のコンテンツと一致するように更新されるため、削除されたキーのコンテンツはそのジョブから削除されます。
毎回新しいプロジェクトを作成する<1>モードでは、再同期によって削除後のコンテンツを反映した新しいPhrase TMSジョブバージョンが作成されますが、以前に作成されたジョブバージョンは変更されません。

ジョブ同期のトラブルシューティング

次の表に、Strings統合機能の使用時にユーザーが遭遇する可能性のある一般的な問題の概要を示します。トラブルシューティングを行う際に考えられる原因と解決策をご紹介します。

問題	原因	ソリューション
TMS ジョブの `NMTOKEN` に関する警告メッセージ	キー名に望ましくない文字（スペースなど）が含まれています	警告メッセージが表示されても、翻訳コンテンツを処理してStringsにエクスポートできます。
TMSのキーが空です	原文言語に原文のないキーがジョブに含まれます	以下のいずれか：セグメントを無視します。 Stringsジョブからキーを削除し、オンラインリポジトリから原文を再インポートします。
APCはプロジェクトを作成していません/新規ジョブを処理しています	言語コードの不一致	Strings の言語コードが TMS プロジェクトの言語コードと一致していることを確認します。 APC が継続的なプロジェクトとして設定されている場合、プロジェクト作成後にプロジェクトテンプレートに変更を加えても、既存のプロジェクトには適用されません。したがって、継続プロジェクトに直接変更を加える必要があります。
	APCはジョブ/ロケールを処理済と見なします	ジョブ開始後にテンプレートが変更されると、APC履歴で処理済とみなされる場合があります。そのため、次への反復のためにジョブの更新が必要になる場合があります。以下のいずれか：ジョブへの新規キーの追加またはジョブの既存キーの更新 Strings でのジョブの納期の変更
	エラー：`429 要求が多すぎます`（Strings API制限）	APCの数を減らし、モニタリング頻度を減らしましょう。
Stringsプロジェクト内の既存のキーがTMSジョブに存在しません	特定のキーがStringsジョブに追加されていませんでした	キーをStringsジョブに追加し、TMSでオンラインリポジトリからジョブを再インポートしてください
ジョブのインポート/エクスポートを試みると、「認証できませんでした」というエラーが表示されます。	「created by Phrase Strings」コネクターのアクセストークンの有効期限が切れているか、取り消されています	TMSで新しいPhrase Stringsコネクターを作成し、既存のAPCを新しいコネクターに再リンクして、モニターをトリガーします。