統合機能
    1. Phrase
    2. Phrase TMS
    3. 統合機能

    Contentful (TMS)

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

    利用可能対象

    • ビジネスおよびエンタープライズプラン（LSPプランでは利用不可）

    ライセンスに関する質問は、営業担当までお問い合わせください。

    利用可能対象

    • Enterpriseプラン（従来のプラン）

    ライセンスに関する質問は、営業担当までお問い合わせください。

    ヒント

    Phrase StringsにおけるContentful統合の詳細については、Contentful (Strings)を参照してください。

    Contentfulは、あらゆるプラットフォームやデバイスに対してコンテンツを作成、管理、配信するためのヘッドレスコンテンツ管理インフラストラクチャを提供します。Phraseは、以下の2つの方法でContentfulと統合します： 

    • 専用のContentfulコネクタ経由（2.0、エントリーレベル、フィールドレベル）

      Contentful 2.0コネクタは現在、米国データセンター経由の認証のみをサポートしています。

    • カスタマイズされたエクスペリエンスのためのContentfulマーケットプレイスプラグイン経由

    備考

    このコネクタは、JSONオブジェクトの翻訳をサポートしていません。

    サポートされているローカライズ方法

    Contentfulは複数のローカライズ方法をサポートしています。詳細な説明については、Contentfulドキュメントを参照してください。

    Contentful 2.0コネクタは、フィールドレベルのローカライズをサポートする、現在推奨されている統合機能です。また、以下の機能も提供します：

    • 連続スペース

    • 環境エイリアス

    • プレビューURL設定

    • 参照インポート

    • タグベースのコンテンツフィルタリング

    • ライブプレビュー設定

    エントリーレベルのローカライズ（レガシー）

    Contentful (Entry-Level)コネクタを使用します。

    エントリーレベルのコネクタは、ローカリゼーションが有効になっている参照フィールド（例：名称がLocalized）を持つコンテンツタイプでのみ機能します。

    フィールドレベルのローカライズ（レガシー）

    Contentful (Field-Level)コネクタを使用します。

    フィールドレベルのコネクタは、翻訳可能なフィールド（例：ローカリゼーションが有効なテキストまたはリッチテキストフィールド）と、オプションでメディアアセットを持つコンテンツタイプでのみ機能します。参照されたエントリーとその翻訳可能なフィールド（参照フィールドがローカライズされている場合）をインポートします。

    注意

    レガシーコネクタは廃止されます。廃止日は2026年11月30日です。これらのコネクタの新しいインスタンスは、2026年8月17日まで作成できます。廃止日までに新しいコネクタに移行してください。

    完全な移行ガイドについては、レガシーコネクタの廃止を参照してください。

    使用例

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

    • プロジェクトマネージャは、ファイルをオンラインリポジトリからプロジェクトに直接追加できます。コンテンツはエントリーIDで検索可能です。

    • 提出者ポータルをセットアップして、提出者がオンラインリポジトリから直接リクエストにファイルを追加できるようにします。コンテンツはエントリーIDで検索可能です。

    • プロジェクト自動作成（APC）を使用して、監視対象のドキュメントまたはフォルダのコンテンツサイズの変更が検出されると、新しいプロジェクトが自動的に作成されるようにします。

    アプリケーションのユースケース：

    • コンテンツエディターは、Contentful内から直接エントリーをローカリゼーション用に提出できます。これにより、コンテンツエディタやマネージャは、ローカリゼーションフローを完全に制御し、エントリーを表示する際にステータスの更新をその場で確認できるようになります。

      エントリーが確定したら、次の操作を行います。

      • ローカリゼーションの対象となる言語を選択します。

      • 選択した言語のエントリーのみをPhrase TMSに提出するか、フィールド選択タブを使用してフィールドを選択します。

        • フィールドが選択されていない場合、ローカライズ可能なすべてのフィールドが翻訳対象として送信されます。

        • ローカライズ不可能なフィールドが選択されていても、そのフィールドは翻訳対象として送信されません。ローカライズ可能なフィールドのみが送信されます。

        • ローカライズ可能なフィールドの一部のみが選択されている場合、そのフィールドのみが翻訳対象として送信されます。

      • APC設定に基づき、送信されたコンテンツからジョブが自動的に作成されます。APCの実行中、送信済みステータスのエントリーのみがジョブ作成の対象となります。

      • 送信済みエントリーからジョブが作成されると、ステータスが進行中に変更されます。翻訳がContentfulにプッシュバックされると、ステータスが完了に変更されます。

      • 以前に翻訳されたエントリーは、元のコピーに変更を加えた後、再送信できます。

    • コンテンツエディターは、Phrase TMSのホーム画面を使用して以下の操作を行えます。

      • エントリーを一括送信する。

      • 一括送信時に個別のターゲット言語を指定する。

      • 進行中の翻訳ジョブの概要を確認する。

    Contentful設定

    Phrase TMSアプリケーションを使用する際は、以下の手順に従ってください。

    1. マーケットプレイスからPhrase TMSアプリケーションをダウンロードします。

    2. アプリケーションを現在アクティブなスペースにインストールし、インストールが必要なコンテンツモデルを選択します。

    3. Phrase TMS内でコネクタを作成した際に取得したPhrase TMS認証トークンを入力します。

    4. インストールをクリックします。

    オプション - アプリを起動（Contentfulにより非推奨）

    ContentfulのLaunch App経由でワークフローサポートを使用する場合は、以下の手順に従ってください。

    1. ContentfulのLaunchアプリケーションを1つ以上のスペースにインストールします。

      備考

      1つのスペースにつき作成できるワークフローは1つだけです。1つのContentfulスペース内でコンテンツタイプごとに異なるアプローチが必要な場合は、担当のカスタマーサクセスマネージャーにお問い合わせください。

    2. 必要なローカリゼーションワークフローを設定します。

    3. 説明されているワークフローに従うコンテンツタイプを選択します。

    コネクタでワークフローが設定されている場合、監視対象のアーティクルまたはコンテンツタイプでワークフローのステップに変更が検出されると、自動プロジェクト作成（APC）機能によって新しいプロジェクトが自動的に作成されます。

    送信済みのジョブはキャンセルできるため、変更を加えた後にコンテンツを再送信できます。これらのジョブはPhrase内に残るため、プロジェクトマネージャーが削除する必要があります。

    Phrase TMS設定 (Contentful 2.0)

    備考

    Contentful Launch Appは、2.0コネクタではサポートされていません。

    1. 設定Setup_gear.pngページから、統合機能セクションまでスクロールします。

    2. [コネクタ]をクリックします。

      「コネクタ」ページが開きます。

    3. 新規コネクタをクリックします。

      「コネクタを作成」ページが表示されます。

    4. タイプをContentful 2.0に変更します。

    5. コネクタの名前を入力してください。

    6. Connect to Contentful 2.0をクリックしてください。

      Contentfulのログインウィンドウが開きます。

    7. ログイン情報を入力して、ログインをクリックしてください（または他のログイン方法を使用してください）。ログインウィンドウが閉じ、接続済みと表示されます。

    8. アプリでコネクタを使用する場合は、Phrase Contentful Appチェックボックスを必要に応じて選択してください。

      1. トークンを生成をクリックしてください。

        Contentfulトークンを生成ウィンドウが開きます。

      2. トークンを生成をクリックしてください。

        トークンが生成されます。これをクリップボードまたはテキストファイルにコピーしてください。ウィンドウを閉じるとトークンは二度と表示されないため、閉じる前に必ずコピーしてください。このトークンは、アプリに接続する際に使用されます。

      3. ウィンドウを閉じると、トークンが生成されましたと表示されます。

    9. Contentful Tags を使用して翻訳可能なコンテンツを識別する場合は、タグIDを入力して Enter を押します。

      IDが表示され、さらに追加することができます。タグを使用して、Contentfulからコネクタに表示されるコンテンツを制限できます。

      • リスティング戦略を選択します。

        • すべてのタグ 

          すべてのタグがリストされたContentful内のコンテンツを表示します。

        • 1つ以上のタグ 

          リストされたタグの少なくとも1つを持つContentfulからのコンテンツを表示します。

    10. 必要に応じて、Include assets を選択します。

    11. 必要に応じて、Include referenced entries （ネストされたコンテンツ）を選択します。

      Referenced entries settings が表示されます。目的のフィルターを適用し、システムがコンテンツ間の関係をどのように辿るかをより詳細に制御できるようにします。

      • リンクされたエントリのインポート深度を設定 

        インポート中にPhraseが参照エントリを追跡する範囲を制限します。

        デフォルト値は10,000です。必要に応じて、他の値を選択するか、カスタム整数値を指定します。

      • コンテンツの種類

        指定されたリストとコンテンツタイプが一致するエントリで停止するか、それらのエントリを追跡するかを選択します。

      • 親コンテンツの種類

        親コンテンツタイプが指定されたリストと一致するエントリを除外します。

      • タグ

        指定されたコンテンツタグのいずれかを持つエントリで停止するか、それらのエントリを追跡するかを選択します。

      • フィールドID

        指定されたフィールドIDによって参照されるエントリで停止するか、それらのエントリを追跡するかを選択します。

    12. 必要に応じて、Include taxonomy を選択します。

      Contentful Organization ID フィールドが表示されます。タクソノミ設定を有効にするには、値を入力します。

      • 選択すると、コネクタはContentfulからタクソノミを取得し、それらを.XLIFF fileに含めます。CAT editorのContext noteペインには、各セグメントのContentfulタクソノミ値が一覧表示されます。

      • タクソノミのメタデータが利用できない場合、またはコネクタで設定されていない場合、Context noteペインは単に省略されます。

      • プロジェクトで機能/画面のコンテキストが不要な場合は、.XLIFFエクスポート時のパフォーマンスを最適化するために、タクソノミを無効のままにすることをお勧めします。

    13. 必要に応じて、Follow aliases を選択します。

      aliasは、すべてのAPC監視およびジョブの再インポート/エクスポートに使用されます。将来エイリアスのターゲットが変更された場合、APCは新しいエイリアスターゲット内のコンテンツを監視し、ジョブは新しいエイリアスターゲットとの間で再インポート/エクスポートされます。

      Follow aliasesは、標準コネクタのAPC監視、ジョブの再インポート、およびジョブのエクスポートにのみ適用されます。これは、Phrase Contentful Appを通じて送信されたエントリには適用されません。アプリを使用する場合、エントリは送信時に送信元であった特定の環境にバインドされたままになります。これは、その環境が後で削除されたり、安定したエイリアスの背後で置き換えられたりした場合でも同様です。元の環境が削除または置き換えられた場合、Follow aliasesが有効になっていても、コネクタは新しい環境下のエントリを検出しません。コネクタがエントリを検出できるように、新しい環境がアクティブな間にContentfulからエントリを再送信してください。

      • 無効（デフォルトであり、推奨されます）

        APCおよび作成されたジョブは、ジョブ/APC作成時にエイリアスが指していた環境に紐付けられます。APCはその環境とコンテンツのみを監視し、ジョブはその環境に対してエクスポートおよび再インポートされます。

      • 有効 

        APCおよび作成されたジョブは、エイリアス自体に紐付けられます。APCはそのエイリアスとコンテンツのみを監視し、ジョブはそのエイリアスに対してエクスポートおよび再インポートされます。

        エイリアスのターゲットが変更された場合、APCは新しいエイリアスのターゲット（環境）を監視し、ジョブは今後そのターゲットに対してエクスポートおよび再インポートされます。

      カスタムContentfulロールには、エイリアス自体だけでなく、エイリアスが指す特定の基盤環境への直接アクセスが必要です。これがないと、Phrase TMSアプリのダッシュボードが読み込まれません。このアクセス権は、Contentfulの Contentfulスペース設定/ロール 内、ロールの 環境 セクションで追加してください。エイリアスが後で別の環境を指すように変更された場合は、新しい環境へのアクセス権も追加してください。

    14. 必要に応じて、プレビューURLを指定してください。

      これは、Contentfulからレンダリングされたコンテンツへ導くURLテンプレートです。以下のプレースホルダーを利用できます。

      • env_id:Environment ID

      • Entry IDEntry ID

      • Space IDSpace ID

      URLテンプレートは次のようになる場合があります。

      https://contentfulapp.tld/?spaceId={space_id}&environmentId={env_id}&entryId={entry_id}

      備考

      URLは、Contentfulのコンテンツをレンダリングするデプロイ済みのアプリケーションへ導く必要があります。ライブプレビューを使用するには、URLテンプレート内の contentfulapp.tld をアプリケーションの実際のドメインに置き換えてください。

      コンテンツプレビューの設定に関する詳細については、Contentfulのドキュメントを参照してください。

      現在、ロケールはプレースホルダーとしてサポートされていません。URLでロケールを使用するには、固定値を指定し、複数のコネクタインスタンスを作成してください。

    15. 必要に応じて、Omit translatable fieldsを使用して、特定のフィールドをPhraseへのインポートから除外してください。インポートから除外するContent IDを指定してください。

    16. Space preview token map（必須）に必要な スペースID と トークン を指定してください。

      Preview APIには、ContentfulスペースのAPI設定で構成する必要があるContent Preview API – access tokenという名前のContentfulアクセストークンが必要です。

      Contentful 2.0統合では、このAPIを使用してコンテンツのインポートと変更の監視（APC）を行います。

      • Contentfulから監視/インポートする各スペースと環境を選択してください。

      • セットアップとアクセスはContentful自体の中で管理されます。

    17. 保存をクリックします。

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

    備考

    APC監視は、Contentfulがどのロケールが変更されたかを報告しないため、実行のたびに追跡対象エントリとその参照の全コンテンツを再チェックします。参照エントリはバッチではなく個別にフェッチされるため、参照エントリが多いスペースでは、1回の実行でContentful Preview APIおよびContent APIへのリクエスト数が多くなる可能性があります。このため、ソースが変更されていない場合でも、翻訳を受け取った後にエントリが再インポートされることがあります。ボリュームの大きいスペースでは、これによりAPCの実行が遅くなり、Contentful APIの使用量が大幅に増加する可能性があります。

    これを軽減するには：

    • エントリの翻訳が完了したら翻訳タグを削除し、再翻訳が必要な場合にのみ再度追加してください。

    • Referenced entries設定を、翻訳が必要なエントリのみに絞り込んでください。

    • Phrase Contentfulアプリを使用します。このアプリは、それを通じて送信されたエントリのみを監視します。

      以前に翻訳されたエントリは、元のコピーに変更が加えられた後、再送信できます。Phrase Contentfulアプリを使用する場合、再送信は手動で行われます。編集者はContentfulでエントリを開き、Phraseアプリのサイドバーを開いてStart overをクリックする（またはアプリのダッシュボードから一括再送信を使用する）必要があります。そうすることで、APCがそれを検出し、既存のジョブのソースを更新します。これは、手動での再送信を必要とせずにAPCがソースの変更を自動的に検出するファイルまたはフォルダ監視コネクタとは異なります。

    Phrase TMS設定

    注意

    カスタムドメイン（例：mydomain.phrase.jp）からアクセスする場合は、シークレットブラウザウィンドウを開き、cloud.memsource.comまたはus.cloud.memsource.com経由でログインして、コネクタの作成または保存に必要な認証を適用してください。保存後、カスタムドメイン経由でコネクタにアクセスできるようになります。

    1. 設定ページSetup_gear.pngから、統合機能セクションまでスクロールします。

    2. [コネクタ]をクリックします。

      「コネクタ」ページが開きます。

    3. 新規コネクタをクリックします。

      コネクタを作成ページが開きます。

    4. Typeをeither Contentful (Entry-Level) or Contentful (Field-Level)に変更し、コネクタの名前を入力してください。

    5. アプリでコネクタを使用する場合は、必要に応じて Phrase Contentful App チェックボックスを選択します。

      • Contentfulアプリのトークン

        Phrase TMS Contentfulアプリケーションに入力するためのアプリトークンを生成してください。トークンを生成し、それをContentfulアプリにコピーした後、コネクタを保存してください。

      備考

      一度保存すると、Contentful内からトークンを変更することはできません。更新するには、Phrase TMSのコネクタ設定からトークンを取り消し、新しいトークンを生成してください。

    6. 言語に依存しない設定を行います。

      • 原文言語

        Contentfulのデフォルト言語を上書きするためのソース言語を選択します。コネクタはコネクタ設定で設定された言語からコンテンツを取得します。

        例：

        ContentfulでEN-USがデフォルト言語として設定されている場合でも、特定のスペースまたはコンテンツモデルのローカリゼーションのソース言語としてDE-DEが必要な場合は、スペース（リモートフォルダ）がEN-USではなくDE-DEからコンテンツを取得するように設定を調整できます。

      備考

      アプリケーション使用時は適用されません。

    7. Entry import modeでネストされたコンテンツを処理する方法を選択します。コンテンツは参照フィールドを使用して他のコンテンツを参照できるようになり、階層構造を作成することが可能になります。

      備考

      アプリケーション使用時は適用されません。

      • Contentful (エントリレベル)

        エントリーレベルのコネクタは、ネストされたコンテンツの階層全体を自動的に走査します。

      • Contentful (フィールドレベル)

        フィールドレベルのコネクタがネストされたコンテンツをどのようにインポートするかを選択します。

        • 選択したエントリのみ

          • リポジトリから追加する際に明示的に選択されたコンテンツがインポートされます。

          • APCによって検出された変更が翻訳用にインポートされます。

        • 参照されたエントリをインポートする

          • コネクタはネストされたコンテンツの階層全体を走査し、翻訳可能なすべてのフィールドを翻訳用にインポートします。

    8. Omit translatable fieldsにカンマ区切りのリストを作成し、Enable localization of this fieldがチェックされているフィールドをPhrase TMSへのインポートから除外します。次の構造を使用してください：contentTypeID:fieldID。

      • リストされたフィールドを空のままにする場合は、Leave omitted fields emptyを選択します。この設定はリストされているすべてのエントリに適用されます。

      • リストされたフィールドにソース値を含める場合は、Copy source to targetを選択します。この設定はリストされているすべてのエントリに適用されます。

    9. ソース言語の特定のフィールドのデータが欠落している場合は、Use fallback languageを選択します。

      必要に応じて、ドロップダウンリストからSource language fallbackを選択します。この言語ロケールは、データが欠落している場合に使用されます。

      備考

      Contentfulのフォールバック言語とこの設定の間に関係はありません。

    10. 必要に応じて、ライブプレビューURL（BETA）を提供してください。

      これは、Contentfulでレンダリングされたコンテンツへ導くURLテンプレートです。以下のプレースホルダーを利用できます。

      • env_id:Environment ID

      • entry.sys.id:Entry ID

      • Space IDSpace ID

      URLテンプレートは次のようになります。

      https://contentfulapp.tld/?spaceId={space_id}&environmentId={env_id}&entryId={entry.sys.id}

      備考

      URLは、Contentfulのコンテンツをレンダリングするデプロイ済みアプリケーションに接続されている必要があります。ライブプレビューを使用するには、URLテンプレート内の contentfulapp.tld をアプリケーションの実際のドメインに置き換えてください。

      コンテンツプレビューの設定に関する詳細については、Contentfulのドキュメントを参照してください。

      現在、ロケールはプレースホルダーとしてサポートされていません。URLでロケールを使用するには、固定値を指定し、複数のコネクタインスタンスを作成してください。

    11. テクニカルサポートチームからデバッグ情報のログ記録を要求された場合は、デバッグ情報をログに記録を選択してください。

    12. Contentfulに接続をクリックします。

      接続が成功すると、コネクタ設定にチェックマークが表示されます。そうでない場合、赤い感嘆符が表示されます。アイコンにカーソルを合わせると、詳細が表示されます。

    13. Contentful（エントリーレベル）のみ：

      ソース言語を設定します。

      備考

      この言語は、Contentfulのロケール設定で設定されているスペースのデフォルトロケールと一致している必要があります。

    14. 保存をクリックします。

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

    15. 必要に応じて、コネクタを編集してContentfulワークフローを選択します。

      • 原文記事の翻訳

        コネクターは、選択したステージ（例: 要翻訳）の記事を監視します。翻訳の準備ができたら、作成者はこのラベルを記事に適用することができます。

      Contentfulからのインポート時

      • 原文記事を以下に設定

        コネクタは、ソース記事がダウンロードされると、ワークフローを選択したステージ（例：翻訳中）に進めます。

      Contentfulへのエクスポート時

      • 原文記事を以下に設定

        コネクタは、翻訳がエクスポートされると、ソース記事のワークフローのステージを選択したステージ（例：翻訳完了）に設定します。

      備考

      ワークフローのサポートは、2023年6月1日をもってContentfulにより終了されました。継続的な使用はサポートされていません。

    この記事は役に立ちましたか？
    ★ ★ ★ ★ ★

    Sorry about that! In what way was it not helpful?

    The article didn’t address my problem.
    I couldn’t understand the article.
    The feature doesn’t do what I need.
    Other reason.

    Note that feedback is provided anonymously so we aren't able to reply to questions.
    If you'd like to ask a question, submit a request to our Support team.
    Thank you for your feedback.