ヒント
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アプリケーションを使用する場合:
-
マーケットプレイスからPhrase TMSアプリケーションをダウンロードします。
-
現在アクティブなスペースにアプリケーションをインストールし、アプリケーションのインストールが必要なコンテンツモデルを選択します。
-
Phrase TMS内でコネクターを作成する際に取得したPhrase TMS Auth トークンを入力します。
-
インストールをクリックします。
オプション - アプリを起動 (Contentfulにより非推奨)
Launch App by Contentful経由でワークフローサポートを使用する場合は、以下の手順に従ってください。
-
ContentfulのLaunchアプリケーションを1つ以上のスペースにインストールします。
備考
1つのスペースにつき作成できるワークフローは1つだけです。1つのContentfulスペース内でコンテンツタイプごとに異なるアプローチが必要な場合は、専任のお客様サクセスマネージャーにお問い合わせください。
-
必要なローカリゼーションワークフローを設定します。
-
説明されているワークフローに従うコンテンツタイプを選択します。
コネクターでワークフローが設定されている場合、監視対象のアーティクルまたはコンテンツタイプでワークフローのステップに変更が検出されると、APC(Automated Project Creation)が自動的に新しいプロジェクトを作成します。
送信済みのジョブはキャンセルできるため、変更を加えた後にコンテンツを再送信できます。これらのジョブはPhrase内に残るため、プロジェクトマネージャが削除する必要があります。
備考
Contentful Launch Appは、2.0コネクターではサポートされていません。
-
設定
ページから、セクションまでスクロールします。
-
[コネクタ]をクリックします。
ページが開きます。
-
新しいコネクターをクリックします。
ページが開きます。
-
タイプをContentful 2.0に変更します。
-
コネクターの名前を入力します。
-
Connect to Contentful 2.0をクリックします。
Contentfulのログインウィンドウが開きます。
-
ログイン情報を入力し、Log inをクリックします(または別のログイン方法を使用します)。ログインウィンドウが閉じ、と表示されます。
-
アプリでコネクターを使用する場合は、必要に応じてPhrase Contentful Appチェックボックスを選択します。
-
トークンを生成をクリックします。
ウィンドウが開きます。
-
トークンを生成をクリックします。
クリップボードまたはテキストファイルにコピーする必要があるトークンが生成されます。ウィンドウを閉じるとトークンは二度と表示されなくなるため、閉じる前に必ずコピーしてください。このトークンは、アプリに接続する際に使用されます。
-
ウィンドウを閉じると、と表示されます。
-
-
Contentfulタグを使用して翻訳可能なコンテンツを識別する場合は、タグIDを入力してEnterを押します。
IDが表示され、さらに追加することができます。タグを使用して、Contentfulからコネクターに表示されるコンテンツを制限できます。
-
必要に応じて、を選択します。
-
必要に応じて、(ネストされたコンテンツ)を選択します。
が表示されます。目的のフィルターを適用して、システムがコンテンツの関係をどのようにトラバースするかについて、より詳細な制御を確立します。
-
インポート中にPhraseが参照エントリをたどる深さを制限します。
デフォルト値は10,000です。必要に応じて、他の値を選択するか、カスタム整数値を指定します。
-
コンテンツタイプが指定された一覧と一致するエントリで停止するか、それともたどるかを選択します。
-
親コンテンツタイプが指定された一覧と一致するエントリを除外します。
-
指定されたコンテンツタグを持つエントリで停止するか、それらのエントリに従うかを選択します。
-
指定されたフィールドIDによって参照されるエントリで停止するか、それらのエントリに従うかを選択します。
-
-
必要に応じて、を選択します。
フィールドが表示されます。タクソノミ設定を有効にするには、値を入力します。
-
選択すると、コネクターはContentfulからタクソノミを取得し、それらを.XLIFF fileに含めます。CAT Editorのペインには、各セグメントのContentfulタクソノミ値が一覧表示されます。
-
タクソノミメタデータが利用できない場合、またはコネクターで設定されていない場合、ペインは単に省略されます。
-
プロジェクトで機能/画面のコンテキストが不要な場合は、.XLIFFエクスポート時のパフォーマンスを最適化するために、タクソノミを無効のままにすることをお勧めします。
-
-
必要に応じて、を選択します。
aliasは、すべてのAPC監視およびジョブの再インポート/エクスポートに使用されます。将来的にエイリアスの訳文が変更された場合、APCは新しい訳文のコンテンツを監視し、ジョブは新しいエイリアスの訳文に対して再インポート/エクスポートされます。
-
(デフォルトで推奨)
APCおよび作成されたジョブは、ジョブ/APC作成時にエイリアスが指していた環境に紐付けられます。APCはその環境とコンテンツのみを監視し、ジョブはその環境に対してエクスポートおよび再インポートされます。
-
APCおよび作成されたジョブは、エイリアス自体に紐付けられます。APCはそのエイリアスとコンテンツのみを監視し、ジョブはそのエイリアスに対してエクスポートおよび再インポートされます。
エイリアスの訳文が変更された場合、APCは新しいエイリアスの訳文(環境)を監視し、ジョブは今後その訳文に対してエクスポートおよび再インポートされます。
カスタムContentfulロールには、エイリアス自体だけでなく、エイリアスが指す特定の基盤環境への直接アクセスが必要です。そうでない場合、Phraseダッシュボードが読み込まれません。のロールの セクションで、このアクセスを追加します。エイリアスが後で別の環境に向け直された場合は、新しい環境へのアクセスも追加してください。
-
-
必要に応じて、 を指定します。
これは、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 でロケールを使用するには、固定値を指定し、複数のコネクターインスタンスを作成します。
-
-
必要に応じて、を使用して、特定のフィールドを Phrase へのインポートから除外します。インポートから除外するコンテンツIDを指定します。
-
に必要な と を指定します。
プレビュー API には、Contentful スペースの API 設定で構成する必要がある という名前の Contentful アクセストークンが必要です。
Contentful 2.0 統合機能は、コンテンツのインポートと変更の監視にこの API を使用します (APC)。
-
Contentful から監視/インポートする各スペースと環境を選択します。
-
セットアップとアクセスは Contentful 自体の中で管理されます。
-
-
保存をクリックします。
コネクターがページの一覧に追加されます。
備考
APC 監視は、Contentful がどのロケールが変更されたかを報告しないため、実行のたびに追跡対象のエントリーとその参照のコンテンツ全体を再チェックします。このため、原文に変更がなくても、翻訳を受け取った後にエントリーを再インポートできます。大容量のスペースでは、これによりAPCの実行が遅くなる可能性があります。
これを軽減するには:
-
エントリーが完了したら翻訳タグを削除し、再翻訳が必要な場合にのみ再度追加します。
-
-
Phrase Contentfulアプリを使用します。このアプリは、それを通じて送信されたエントリーのみを監視します。
注意
カスタムドメイン(例:mydomain.phrase.jp)からアクセスする場合は、シークレットブラウザウィンドウを開き、cloud.memsource.comまたはus.cloud.memsource.com経由でログインして、コネクターの作成または保存に必要な認証を適用してください。保存後、カスタムドメイン経由でコネクターにアクセスできます。
-
設定
ページから、セクションまでスクロールします。
-
[コネクタ]をクリックします。
ページが開きます。
-
新しいコネクターをクリックします。
ページが開きます。
-
タイプをいずれかContentful(エントリーレベル)またはContentful(フィールドレベル)に変更し、コネクターの名前を入力します。
-
アプリでコネクターを使用する場合は、必要に応じてPhrase Contentful Appチェックボックスを選択します。
-
Contentfulアプリトークン
Phrase TMS<1>のContentfulアプリケーションに入力するアプリトークンを生成します。トークンを生成してContentfulアプリにコピーした後、コネクターを保存します。
備考
保存後、トークンはContentful内から変更できません。更新するには、Phrase TMSのコネクター設定からトークンを取り消し、新しいトークンを生成します。
-
-
言語非依存の設定を構成します。
-
原文言語
Contentfulのデフォルト言語を上書きする原文言語を選択します。その後、コネクターはコネクター設定で設定された言語からコンテンツを取り込みます。
例:
備考
アプリケーションを使用している場合は適用されません。
-
-
エントリーインポートモード<1>を通じてネストされたコンテンツを処理する方法を選択します。コンテンツは、参考資料フィールドを使用して他のコンテンツを参照し、エンティティの階層を作成できます。
-
Contentful (エントリーレベル)
エントリーレベルのコネクターは、ネストされたコンテンツの階層全体を自動的にトラバースします。
-
Contentful (フィールドレベル)
フィールドレベルのコネクターがネストされたコンテンツをどのようにインポートするかを選択します。
-
-
リポジトリから追加する際に明示的に選択されたコンテンツがインポートされます。
-
APCによって検出された変更が翻訳用にインポートされます。
-
-
参照されているエントリーをインポートする
-
コネクターはネストされたコンテンツの階層全体をトラバースし、すべての翻訳可能フィールドを翻訳用にインポートします。
-
-
-
-
翻訳可能フィールドを除外にカンマ区切りの一覧を作成し、がチェックされているフィールドをPhrase TMSへのインポートから除外します。次の構造を使用してください:
contentTypeID:fieldID。-
一覧にあるフィールドを空欄にする場合は、除外されたフィールドを空欄にするを選択します。この設定はリストされているすべてのエントリに適用されます。
-
一覧にあるフィールドに原文の値を含める場合は、原文を訳文にコピーを選択します。この設定はリストされているすべてのエントリに適用されます。
-
-
原文の言語で特定のフィールドのデータが欠落している場合は、を選択します。
必要に応じて、ドロップダウン一覧からを選択します。この言語ロケールは、データが欠落している場合に使用されます。
備考
Contentfulのフォールバック言語とこの設定の間に関係はありません。
-
必要に応じて、 (BETA) を指定してください。
これは、Contentful からレンダリングされたコンテンツへ導く URL テンプレートです。以下のプレースホルダーを利用できます。
-
{env_id}: 環境 ID -
{entry.sys.id}: エントリーID -
{space_id}: スペース ID
URL テンプレートは次のようになります。
https://contentfulapp.tld/?spaceId={space_id}&environmentId={env_id}&entryId={entry.sys.id}
備考
URL は、Contentful コンテンツをレンダリングするデプロイ済みのアプリケーションへ導く必要があります。ライブプレビューを使用するには、URL テンプレート内の
contentfulapp.tldをアプリケーションの実際のドメインに置換します。コンテンツプレビューのセットアップの詳細については、Contentful のドキュメントを参照してください。
現在、ロケールはプレースホルダーとしてサポートされていません。URL でロケールを使用するには、固定値を指定し、複数のコネクターインスタンスを作成します。
-
-
テクニカルサポートTeamからデバッグ情報のログ記録を要求された場合は、を選択します。
-
Contentfulに接続をクリックします。
接続が成功すると、コネクターのセットアップにチェックマークが表示されます。そうでない場合、赤い感嘆符が表示されます。アイコンにカーソルを合わせると、詳細が表示されます。
-
Contentful(エントリーレベル)のみ:
原文言語<1>を設定します。
備考
この言語は、Contentfulのロケール設定で構成されているContentfulスペースのデフォルトロケールと一致する必要があります。
-
保存をクリックします。
コネクターがページの一覧に追加されます。
-
オプションで、コネクターを編集して
-
コネクターは、選択したステージ(例: 要翻訳)の記事を監視します。翻訳の準備ができたら、作成者はこのラベルを記事に適用することができます。
Contentfulからのインポート時:
-
コネクターは、原文記事がダウンロードされると、ワークフローを選択したステージ(例:翻訳中)に進めます。
Contentfulへのエクスポート時:
-
コネクターは、翻訳がエクスポートされると、原文記事のワークフローのステージを選択したステージ(例:翻訳完了)に設定します。
備考
ワークフローのサポートは、Contentfulによって2023年6月1日に終了しました。継続的な使用はサポートされていません。
-
コネクターを削除する
コネクターを削除するには:
備考
プロジェクト内の未完了のジョブ(ごみ箱にあるジョブを含む)にリンクされている間は、コネクターを削除できません。そのようなコネクターを削除しようとすると、「コネクターの削除に失敗しました」というエラーが返されます。
解決策:コネクターに関連付けられているプロジェクトを開き、残っているジョブを完了または削除してください。に移動し、コネクターにまだリンクされているジョブを削除するためにごみ箱を空にしてください。コネクターの削除を再試行してください。