統合機能

Contentful (TMS)

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

利用可能対象

  • BusinessおよびEnterpriseプラン(LSPプランでは利用不可)

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

利用可能対象

  • Enterpriseプラン(従来のプラン)

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

ヒント

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

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

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

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

  • カスタマイズされたエクスペリエンスのためのContentful Marketplaceプラグイン経由

備考

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

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

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

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

  • 連続スペース

  • 環境エイリアス

  • プレビューURLセットアップ

  • 参考資料インポート

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

  • ライブプレビュー構成

エントリーレベルのローカライズ(従来)

Contentful(エントリーレベル)コネクターを使用します。

エントリーレベルコネクターは、ローカライズされた参考資料フィールド(ローカライズが有効になっているLocalizedという名前の参考資料フィールドなど)を持つコンテンツタイプでのみ機能します。

フィールドレベルのローカライズ(従来)

Contentful(フィールドレベル)コネクターを使用します。

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

注意

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

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

使用例

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

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

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

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

アプリケーション<1>のユースケース:

  • コンテンツエディタは、Contentful内から直接エントリーを翻訳用に送信できます。これにより、コンテンツエディタやマネージャは、翻訳フローを完全に制御し、エントリーを表示する際にステータスの更新をリアルタイムで確認できます。

    エントリーが確定したら:

    • 翻訳対象の訳文言語を選択します。

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

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

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

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

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

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

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

  • コンテンツエディターは、Phrase TMSホーム画面を使用して次のことができます。

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

    • 一括送信時に個別の訳文言語を指定する。

    • アクティブな翻訳ジョブの概要を確認する。

Contentful 設定

Phrase TMSアプリケーションを使用する場合:

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

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

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

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

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

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

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

    備考

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

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

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

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

送信済みのジョブはキャンセルできるため、変更を加えた後にコンテンツを再送信できます。これらのジョブは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. ログイン情報を入力し、Log inをクリックします(または別のログイン方法を使用します)。ログインウィンドウが閉じ、Connectedと表示されます。

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

    1. トークンを生成をクリックします。

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

    2. トークンを生成をクリックします。

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

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

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

    IDが表示され、さらに追加することができます。

    • 一覧表示戦略を選択します

      • すべてのタグ 

        すべてのタグが一覧表示された状態でContentful内のコンテンツを表示します。

      • 1つ以上のタグ 

        一覧表示されたタグのいずれか1つ以上を持つContentfulからのコンテンツを表示します。

  10. 必要に応じて、アセットを含めるを選択します。

  11. 必要に応じて、参照エントリを含める(ネストされたコンテンツ)を選択します。

    参照エントリ設定が表示されます。目的のフィルターを適用して、システムがコンテンツの関係をどのようにトラバースするかについて、より詳細な制御を確立します。

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

      インポート中にPhraseが参照エントリをたどる深さを制限します。

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

    • コンテンツの種類

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

    • 親コンテンツの種類

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

    • タグ

      指定されたコンテンツタグを持つエントリで停止するか、それらに従うかを選択します。

    • フィールドID

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

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

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

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

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

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

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

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

    • Disabled(デフォルトおよび推奨)

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

    • 有効 

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

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

  14. 必要に応じて、Preview URLを入力します。

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

    • {env_id}: 環境ID

    • {entry.id}: エントリー ID

    • {space_id}: スペース ID

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

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

    備考

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

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

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

  15. 必要に応じて、Phraseへのインポートから除外するContentIDを指定してください。

  16. スペース IDトークンスペース プレビュー トークン マップ用に指定してください(必須)。

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

    Contentful 2.0統合機能は、コンテンツのインポートおよび変更の監視(APC)にこのAPIを使用します。

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

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

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

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

Phrase TMS設定

注意

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

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

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

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

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

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

  4. Typeeither Contentful (Entry-Level) or Contentful (Field-Level)に変更し、コネクターの名前を指定してください。

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

    • Contentful App token

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

    備考

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

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

    • 原文言語

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

      例:

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

    備考

    アプリケーションを使用している場合は適用されません。

  7. エントリーインポートモードを通じて、ネストされたコンテンツを処理する方法を選択します。コンテンツは参考資料フィールドを使用して他のコンテンツを参照し、エンティティの階層を作成できます。

    備考

    アプリケーションを使用している場合は適用されません。

    • Contentful (エントリーレベル)

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

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

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

      • 選択したエントリのみ

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

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

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

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

  8. 翻訳可能なフィールドを除外にカンマ区切りの一覧を作成し、このフィールドのローカライズを有効にするがチェックされているフィールドをPhrase TMSへのインポートから除外します。次の構造を使用してください: contentTypeID:fieldID

    • 一覧表示されたフィールドを空欄にする場合は、除外されたフィールドを空欄にするを選択します。この設定はリストされているすべてのエントリに適用されます。

    • リストされたフィールドに原文の値を含める必要がある場合は、原文を訳文にコピーを選択します。この設定はリストされているすべてのエントリに適用されます。

  9. 原文の言語で特定のフィールドのデータが欠落している場合は、フォールバック言語を使用を選択します。

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

    備考

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

  10. 必要に応じて、ライブプレビューURL(BETA)を提供します。

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

    • {env_id}: 環境ID

    • {entry.sys.id}:エントリーID

    • {space_id}: スペース ID

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

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

    備考

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

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

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

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

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

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

  13. Contentful(エントリーレベル)のみ:

    原文<1>言語を設定します。

    備考

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

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

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

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

    • 記事の翻訳元

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

    Contentfulからインポート時:

    • 原文記事を以下に設定

      コネクターは、原文の記事がダウンロードされると、ワークフローを選択したステージ(例:翻訳の進捗)に進めます。

    Contentfulへエクスポート時:

    • 原文記事を以下に設定

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

    備考

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

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

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.