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 キーの翻訳ステータスはサポートされていません。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で設定された文字数制限の検証に影響を与える可能性があります。なぜなら、スペースの数は翻訳中にTMSエディタに反映されないためです。

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

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

TMSは、プロジェクト内で同じロケールを原文言語と訳文言語の両方として使用することをサポートしていません。例えば、Stringsジョブがen-USを原文言語と訳文言語の両方として使用している場合、en-USの訳文をTMSにインポートすることはできず、ジョブ全体を完了としてマークすることもできません。TMSに同期されるStringsジョブを作成する際は、原文ロケールを訳文ロケールとして選択しないでください。

ICU メッセージと CLDR 複数形

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

使用例

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

TMSプロジェクトマネージャは、ファイルをオンラインリポジトリからTMSプロジェクトに直接追加できます。
提出者がPhrase Stringsから直接リクエストにファイルを追加できるようにPhrase TMS提出者ポータルを設定します。
TMSプロジェクト自動作成（APC）を使用して、監視対象のファイルまたはフォルダの最終更新日の変更が検出されると、新しいプロジェクトが自動的に作成されます。
- ジョブレベルとプロジェクトレベルの両方の同期において、モニタリング対象のプロジェクトのパスは、ジョブフォルダまで選択する必要があります（スペース/プロジェクト/メイン/ジョブなど）。
- Job Syncの場合、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ページには、統合機能とジョブの左側ナビゲーションメニューの両方からアクセスできます。

StringsでJob Syncsを設定する

備考

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

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

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

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

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

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

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

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

ヒント

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

カスタムマッピングを使用している場合、変更が必要なときは、TMSのコネクターに適用する必要があります。

Phrase TMS設定map

一部の組織では、組織のPhrase Platform IDを使用して、Phrase Stringsコネクターが自動的に作成されています。手動で作成する前に、コネクターページでコネクター一覧を確認してください。自動作成されたコネクターは、手動で入力されたアクセストークンではなく、ログイン中のIDを使用してサーバー側で認証を行います。

コネクターは、作成後の初回同期が完了するまで保留中ステータスを表示し、その後アクティブに変更されます。保留中状態は、コネクター設定に変更が加えられた場合や、意味のある変更がない場合でもコネクター設定ページが保存された場合にもトリガーされます。コネクターが保留中と表示されている間は、Phrase TMSでのジョブ作成のソースとして使用できません。そのコネクターでジョブを作成する前に、ステータスがアクティブに変更されるまで待機してください。

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

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

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

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

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

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

コネクターを削除する

コネクターを削除するには：

統合ページから、削除するコネクターを選択します。
削除をクリックします。

コネクターを削除ウィンドウが開きます。
「delete」と入力し、削除をクリックします。

コネクターが削除され、コネクターの一覧が表示されます。

備考

ごみ箱にあるジョブを含め、プロジェクト内の未完了のジョブにまだリンクされているコネクターは削除できません。このようなコネクターを削除しようとすると、「コネクターの削除に失敗しました」というエラーが返されます。

解決策：コネクターに関連付けられているプロジェクトを開き、残っているジョブを完了または削除してください。設定/ごみ箱に移動し、コネクターにまだリンクされているジョブを削除するためにごみ箱を空にします。コネクターの削除を再試行してください。

統合機能でサポート：

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

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

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

キー名

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

キー説明

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

最大キー文字数

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

スクリーンショット

TMS CAT EditorのコンテキストメモペインにStringsのスクリーンショットを表示するには：
- TMSプロジェクト設定のアクセスとセキュリティセクションで、Phrase CAT Editorで外部コンテンツの読み込みを許可するオプションを有効にします。
- コンテキストメモペインでリッチテキスト形式を選択します。
サポートされているファイル形式のカスタムメタデータ：
- .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は各ポーリングまたはウェブフックトリガーでコンテンツハッシュを比較し、キーの削除を含むあらゆる変更を、再同期をトリガーする更新として扱います。

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

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

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

問題	原因	ソリューション
TMS ジョブの `NMTOKEN` に関する警告メッセージ	キー名に望ましくない文字（スペースなど）が含まれています	警告メッセージが表示されても、翻訳コンテンツを処理してStringsにエクスポートできます。
TMSのキーが空です	原文言語に原文のないキーがジョブに含まれます	以下のいずれか：セグメントを無視します。 Stringsジョブからキーを削除し、オンラインリポジトリから原文を再インポートします。
APCはプロジェクトを作成していません/新規ジョブを処理しています	言語コードの不一致	Strings の言語コードが TMS プロジェクトの言語コードと一致していることを確認します。 APC が継続的なプロジェクトとして設定されている場合、プロジェクト作成後にプロジェクトテンプレートに変更を加えても、既存のプロジェクトには適用されません。したがって、継続プロジェクトに直接変更を加える必要があります。
	APCはジョブ/ロケールを処理済と見なします	ジョブ開始後にテンプレートが変更されると、APC履歴で処理済とみなされる場合があります。そのため、次への反復のためにジョブの更新が必要になる場合があります。以下のいずれか：ジョブへの新規キーの追加またはジョブの既存キーの更新 Strings でのジョブの納期の変更
	エラー：`429 要求が多すぎます`（Strings API制限）	APCの数を減らし、モニタリング頻度を減らしましょう。
Stringsプロジェクトの既存のキーがTMSジョブにありません	特定のキーがStringsジョブに追加されていませんでした	Stringsジョブにキーを追加し、TMSのオンラインリポジトリからジョブを再インポートしてください
ジョブのインポート/エクスポートを試みると、「Could not authenticate」エラーが表示されます。	自動作成された「created by Phrase Strings」コネクターのアクセストークンが期限切れであるか、取り消されています	TMSで新しいPhrase Stringsコネクターを作成し、既存のAPCを新しいコネクターに再リンクして、モニターをトリガーします。
Stringsジョブが完了として表示されていないにもかかわらず、APCまたは手動でのインポートや再インポートのために見つかりません。	そのジョブは、完了または削除されることなく、後でごみ箱に移動されたTMSプロジェクトに既にインポートされていました。プロジェクトが技術的にまだ進捗中のため、ジョブは再インポート用に解放されません。	トラブルシューティングを行う前に、Stringsのロケールの横にあるジョブのAnnotationsを確認し、TMSに既にインポートされているかどうかを検証してください。リンクされたプロジェクトがごみ箱にある場合は、プロジェクトを復元して直接作業を続けるか、プロジェクトが不要な場合はジョブとプロジェクトをキャンセルするか、`purge=true`パラメーターを使用してAPI経由でプロジェクトを完全に削除し、APCがそれをアクティブなバージョンと見なさないようにします。
TMSコネクターにカスタムロケールマッピングが構成されているにもかかわらず、Job Syncの保存時に「`Locales are not supported by Phrase TMS: x`」エラーが発生して失敗します。	Job Syncは、保存時にStringsプロジェクトの訳文ロケールを、TMSでネイティブサポートされているロケールの一覧と直接照合して検証します。この検証では、カスタムコネクターのロケールマッピングは考慮されません。	TMSでネイティブサポートされていない訳文ロケールを持つStringsプロジェクトの場合は、StringsからではなくTMSで直接Stringsコネクターを使用し、カスタム言語マッピングを構成してください。