ヒント
Phrase Strings における Contentful 統合機能の詳細については、Contentful (Strings) を参照してください。
Contentful は、コンテンツを作成、管理し、あらゆるプラットフォームやデバイスに配信するためのヘッドレスコンテンツ管理インフラストラクチャを提供します。Phrase は、以下の2つの方法で Contentful と統合機能を提供します。
-
専用の Contentful コネクター経由 (2.0、エントリーレベル、フィールドレベル)
Contentful 2.0 コネクターは現在、米国データセンター経由の認証のみをサポートしています。
-
カスタマイズされたエクスペリエンスのための Contentful Marketplace プラグイン経由
備考
このコネクターは、JSON オブジェクトの翻訳をサポートしていません。
サポートされているローカライズ方法
Contentfulは複数のローカライズ方法をサポートしています。詳細な説明については、Contentful documentationを参照してください。
Contentful 2.0 コネクターは、フィールドレベルのローカライズをサポートする、現在推奨されている統合機能です。また、以下の機能も提供します。
-
連続スペース
-
環境エイリアス
-
プレビュー URL セットアップ
-
参考資料 インポート
-
タグベースのコンテンツフィルタリング
-
ライブプレビュー構成
エントリーレベルのローカライズ (従来)
Contentful(エントリーレベル)コネクターを使用します。
エントリーレベルコネクターは、ローカライズされた参考資料フィールド(例:ローカライズが有効になっているLocalizedという参考資料フィールド)を持つコンテンツタイプでのみ機能します。
フィールドレベルのローカライズ(従来)
Contentful(フィールドレベル)コネクターを使用します。
フィールドレベルコネクターは、翻訳可能なフィールド(例:ローカライズが有効なテキストまたはリッチテキストフィールド)と、オプションでメディアアセットを持つコンテンツタイプでのみ機能します。参照されたエントリーとその翻訳可能フィールド(参考資料フィールドがローカライズされている場合)をインポートします。
注意
従来コネクターは、2026年11月30日に廃止されます。これらのコネクターの新しいインスタンスは、2026年8月17日まで作成できます。廃止日までに新しいコネクターへ移行してください。
完全な移行ガイドについては、従来コネクターの廃止を参照してください。
コネクターにはいくつかの使用例があります。
-
プロジェクトマネージャは、ファイルをオンラインリポジトリからプロジェクトに直接追加できます。コンテンツはエントリーIDで検索可能です。
-
サブミッターがオンラインリポジトリから直接リクエストにファイルを追加できるように、サブミッターポータルを設定します。コンテンツはエントリーIDで検索可能です。
-
プロジェクト自動作成(APC)を使用して、監視対象のドキュメントまたはフォルダのコンテンツサイズの変更が検出されると、新しいプロジェクトが自動的に作成されるようにします。
アプリケーション<1>のユースケース:
-
コンテンツエディターは、Contentful内から直接エントリーを翻訳用に送信できます。これにより、コンテンツエディターやマネージャは、翻訳フローを完全に制御し、エントリーを表示する際にステータスの更新をその場で確認できるようになります。
エントリーが確定したら、次の操作を行います。
-
翻訳対象の言語を選択します。
-
エントリーのみを選択した言語でPhrase TMSに送信するか、フィールド選択タブを使用してフィールドを選択します。
-
フィールドが選択されていない場合、ローカライズ可能なすべてのフィールドが翻訳用に送信されます。
-
ローカライズ不可能なフィールドが選択された場合、そのフィールドは翻訳用に送信されません。ローカライズ可能なフィールドのみが送信されます。
-
一部のローカライズ可能なフィールドのみが選択された場合、それらのフィールドのみが翻訳用に送信されます。
-
-
APC 設定に基づき、送信されたコンテンツからジョブが自動的に作成されます。APC の実行中、送信済み<1> ステータスのエントリーのみがジョブ作成の対象となります。
-
送信されたエントリーからジョブが作成されると、ステータスは 進捗<1> に変更されます。翻訳がContentfulにプッシュバックされると、ステータスは 完了<3> に変更されます。
-
以前に翻訳されたエントリーは、元のコピーに変更があった後に再送信できます。
-
-
コンテンツエディターは、Phraseホーム画面を使用して次のことができます。
-
エントリーを一括送信する。
-
一括送信時に個別の訳文言語を指定する。
-
アクティブな翻訳ジョブの概要を確認する。
-
Contentful 設定
Phraseアプリケーションを使用する場合:
-
マーケットプレイスから Phrase<1> アプリケーションをダウンロードします。
-
現在アクティブなスペースにアプリケーションをインストールし、アプリケーションのインストールが必要なコンテンツモデルを選択します。
-
Phrase内でコネクターを作成する際に取得した Phrase トークン<1> を入力します。
-
送信<1> をクリックします。
オプション - アプリを起動(Contentfulにより非推奨)
Launch App by Contentful経由でワークフローサポートを使用する場合は、以下の手順に従ってください。
-
ContentfulのLaunchアプリケーションを1つ以上のスペースにインストールします。
備考
1つのスペースにつき作成できるワークフローは1つのみです。1つのContentfulスペース内でコンテンツタイプごとに異なるアプローチが必要な場合は、専任のお客様サクセスマネージャーにお問い合わせください。
-
必要なローカリゼーションワークフローを設定します。
-
説明されているワークフローに従うコンテンツタイプを選択します。
コネクターでワークフローが設定されている場合、監視対象のアーティクルまたはコンテンツタイプでワークフローのステップに変更が検出されると、APC(Automated Project Creation)が自動的に新しいプロジェクトを作成します。
送信済みのジョブはキャンセルできるため、変更を加えた後にコンテンツを再送信できます。これらのジョブはPhrase内に残るため、プロジェクトマネージャが削除する必要があります。
備考
Contentful Launch Appは、2.0コネクターではサポートされていません。
-
設定
ページから、セクションまでスクロールします。
-
[コネクタ]をクリックします。
ページが開きます。
-
New connectorをクリックします。
ページが開きます。
-
TypeをContentful 2.0に変更します。
-
コネクターの名前を入力します。
-
Connect to Contentful 2.0をクリックします。
Contentfulのログインウィンドウが開きます。
-
ログイン情報を入力し、Log inをクリックします(または他のログイン方法を使用します)。ログインウィンドウが閉じ、と表示されます。
-
コネクターをアプリで使用する場合は、必要に応じてPhrase Contentful Appチェックボックスを選択します。
-
トークンを生成をクリックします。
ウィンドウが開きます。
-
トークンを生成をクリックします。
クリップボードまたはテキストファイルにコピーする必要があるトークンが生成されます。トークンは再度表示されないため、ウィンドウを閉じる前に必ずコピーしてください。このトークンはアプリに接続する際に使用されます。
-
ウィンドウを閉じると、と表示されます。
-
-
Contentfulタグを使用して翻訳可能なコンテンツを識別する場合は、タグIDを入力してEnterを押します。
IDが表示され、さらに追加することができます。
-
必要に応じて、を選択します。
-
必要に応じて、(ネストされたコンテンツ)を選択します。
が表示されます。目的のフィルターを適用して、システムがコンテンツの関係をどのようにトラバースするかについて、より詳細な制御を確立します。
-
インポート中にPhraseが参照エントリを追跡する深さを制限します。
デフォルト値は10,000です。必要に応じて、他の値を選択するか、カスタム整数値を指定します。
-
コンテンツタイプが指定された一覧と一致するエントリで停止するか、それらを追跡するかを選択します。
-
親コンテンツタイプが指定された一覧と一致するエントリを除外します。
-
指定されたコンテンツタグを持つエントリで停止するか、それらのエントリに従うかを選択します。
-
指定されたフィールドIDによって参照されるエントリで停止するか、それらのエントリに従うかを選択します。
-
-
必要に応じて、を選択します。
フィールドが表示されます。分類設定を有効にするには、値を入力します。
-
選択すると、コネクターはContentfulから分類を取得し、それらを.XLIFF fileに含めます。CAT Editorのペインには、各セグメントのContentful分類値が一覧表示されます。
-
分類メタデータが利用できない場合、またはコネクターで設定されていない場合、ペインは単に省略されます。
-
プロジェクトで機能/画面のコンテキストが不要な場合は、.XLIFFエクスポート時のパフォーマンスを最適化するために、分類を無効のままにすることをお勧めします。
-
-
必要に応じて、を選択します。
aliasは、すべてのAPC監視およびジョブの再インポート/エクスポートに使用されます。将来的にエイリアスの訳文が変更された場合、APCは新しい訳文内のコンテンツを監視し、ジョブは新しいエイリアスの訳文との間で再インポート/エクスポートされます。
-
(デフォルトおよび推奨)
APCおよび作成されたジョブは、ジョブ/APC作成時にエイリアスが指していた環境に紐付けられます。APCはその環境とコンテンツのみを監視し、ジョブはその環境に対してエクスポートおよび再インポートされます。
-
APCおよび作成されたジョブは、エイリアス自体に紐付けられます。APCはそのエイリアスとコンテンツのみを監視し、ジョブはそのエイリアスに対してエクスポートおよび再インポートされます。
エイリアスの訳文が変更された場合、APCは新しいエイリアスの訳文(環境)を監視し、ジョブは今後その訳文に対してエクスポートおよび再インポートされます。
-
-
必要に応じて、を入力します。
これは、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へのインポートから除外するContentIDを提供します。
-
とを用に指定します(必須)。
プレビュー APIには、ContentfulスペースのAPI設定で構成する必要があるという名前のContentfulアクセス トークンが必要です。
Contentful 2.0 統合機能は、コンテンツのインポートおよび変更の監視(APC)にこのAPIを使用します。
-
Contentfulから監視/インポートする各スペースと環境を選択します。
-
セットアップとアクセスはContentful自体の中で管理されます。
-
-
保存をクリックします。
コネクターがページの一覧に追加されます。
注意
カスタム ドメイン(例: mydomain.phrase.jp)からアクセスする場合は、シークレット ブラウザ ウィンドウを開き、cloud.memsource.comまたはus.cloud.memsource.com経由でログインして、コネクターの作成または保存に必要な認証を適用してください。保存後、カスタム ドメイン経由でコネクターにアクセスできます。
-
設定
ページから、セクションまでスクロールします。
-
[コネクタ]をクリックします。
ページが開きます。
-
New connectorをクリックします。
ページが開きます。
-
Typeをeither Contentful (Entry-Level) or Contentful (Field-Level)に変更し、コネクターの名前を指定します。
-
コネクターをアプリで使用する場合は、必要に応じてPhrase Contentful Appチェックボックスを選択します。
-
Contentful App トークン
Phrase TMS Contentfulアプリケーションに入力するためのアプリ トークンを生成します。トークンを生成し、それをContentful Appにコピーした後、コネクターを保存します。
備考
保存すると、トークンはContentful内から変更できなくなります。更新するには、Phrase TMSのコネクター設定からトークンを取り消し、新しいトークンを生成してください。
-
-
言語に依存しない設定を構成します。
-
原文言語
Contentfulのデフォルト言語を上書きする原文言語を選択します。コネクターは、コネクター設定で設定された言語からコンテンツを取得します。
例:
備考
アプリケーションを使用している場合は適用されません。
-
-
エントリーインポートモードを通じてネストされたコンテンツを処理する方法を選択します。コンテンツは参考資料フィールドを使用して他のコンテンツを参照でき、エンティティの階層を作成できます。
-
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日に終了しました。継続的な使用はサポートされていません。
-