ヒント
Phrase StringsにおけるContentful統合に関する情報は、Contentful (Strings)を参照してください。
Contentfulは、あらゆるプラットフォームやデバイスにコンテンツを作成、管理、配信するためのヘッドレスコンテンツ管理インフラストラクチャを提供します。Phraseは、Contentfulと2つの方法で統合します：
-
専用のContentfulコネクター（2.0、エントリーレベル、フィールドレベル）を介して
Contentful 2.0コネクターは、現在、米国データセンターを介した認証のみをサポートしています。
-
カスタマイズされた体験のためのContentful Marketplaceプラグインを介して
備考
コネクターは、JSONオブジェクトの翻訳をサポートしていません。
サポートされているローカリゼーション方法
Contentfulは、複数のローカリゼーション方法をサポートしています。詳細な説明については、Contentfulのドキュメントを参照してください。
Contentful 2.0コネクターは、フィールドレベルのローカリゼーションをサポートする現在の推奨統合です。それはまた、次のものを提供します：
-
連続スペース
-
環境エイリアス
-
プレビューURLのセットアップ
-
参照インポート
-
タグベースのコンテンツフィルタリング
-
ライブプレビューの設定
エントリーレベルのローカリゼーション（従来）
Contentful (エントリーレベル)コネクターを使用してください。
エントリーレベルのコネクターは、ローカライズされた参照フィールドを持つコンテンツタイプ（例：ローカライズ用に有効化された参照フィールドであるローカライズされた）でのみ機能します。
フィールドレベルのローカリゼーション（従来）
Contentful（フィールドレベル）コネクターを使用します。
フィールドレベルのコネクターは、翻訳可能なフィールド（例：ローカライズが有効化されたテキストまたはリッチテキストフィールド）を持つコンテンツタイプでのみ機能し、オプションでメディアアセットも含まれます。参照されたエントリーとその翻訳可能なフィールドをインポートします（参照フィールドがローカライズされている場合）。
備考
従来のコネクターはもはや積極的にメンテナンスされていませんが、動作はします。
コネクターにはいくつかの使用例があります。
-
プロジェクトマネージャは、オンラインリポジトリからプロジェクトにファイルを直接追加できます。コンテンツはエントリーIDで検索可能です。
-
サブミッターポータルを設定して、サブミッターがオンラインリポジトリからリクエストにファイルを直接追加できるようにします。コンテンツはエントリーIDで検索可能です。
-
自動プロジェクト作成（APC）を使用して、監視対象のドキュメントまたはフォルダのコンテンツサイズに変更が検出されると、新しいプロジェクトが自動的に作成されます。
アプリケーションの使用例：
-
コンテンツエディターは、Contentful内からローカライズのためにエントリーを直接送信できます。これにより、コンテンツエディターやマネージャーはローカリゼーションフローを完全に制御し、エントリーを表示しているときにリアルタイムでステータス更新を受け取ることができます。
エントリーが最終化されたら：
-
ローカリゼーションのために希望するターゲット言語を選択します。
-
選択した言語のエントリーのみをPhrase TMSに送信するか、フィールド選択タブを使用してフィールドを選択します。
-
フィールドが選択されていない場合、すべてのローカライズ可能なフィールドが翻訳のために送信されます。
-
ローカライズ不可能なフィールドが選択されている場合、そのフィールドは翻訳のために送信されません。ローカライズ可能なフィールドのみが送信されます。
-
ローカライズ可能なフィールドの一部のみが選択されている場合、それらのフィールドのみが翻訳のために送信されます。
-
-
APCの設定に基づいて、ジョブは提出されたコンテンツから自動的に作成されます。APCの実行中は、提出されたステータスのエントリーのみがジョブ作成のために選択されます。
-
提出されたエントリーからジョブが作成されると、ステータスは進行中に変更されます。翻訳がContentfulにプッシュバックされると、ステータスは完了に変更されます。
-
以前に翻訳されたエントリーは、元のコピーに変更があった後に再提出できます。
-
-
コンテンツエディターは、Phrase TMSのホーム画面を使用して：
-
エントリーを一括で提出します。
-
一括提出の際に個別のターゲット言語を指定します。
-
アクティブな翻訳ジョブの概要を把握します。
-
Contentfulの設定
Phrase TMSアプリケーションを使用する際：
-
マーケットプレイスからPhrase TMSアプリケーションをダウンロードします。
-
アプリケーションを現在のアクティブスペースにインストールし、アプリケーションのインストールが必要なコンテンツモデルを選択します。
-
Phrase TMS内でコネクタを作成する際に取得したPhrase TMS認証トークンを入力します。
-
インストールをクリックします。
オプション - アプリを起動（Contentfulによって非推奨）
ContentfulのLaunch Appを使用する場合は、次の手順に従ってください：
-
1つ以上のスペースにContentfulのLaunchアプリケーションをインストールします。
備考
スペースごとに1つのワークフローしか作成できません。1つのContentfulスペース内で異なるコンテンツタイプのアプローチが必要な場合は、専任のカスタマーサクセスマネージャーに連絡してください。
-
必要なローカリゼーションワークフローを設定します。
-
記述されたワークフローに従うコンテンツタイプを選択します。
コネクター内のワークフローが設定されている場合、監視されている記事やコンテンツタイプのワークフローステップに変更が検出されると、自動プロジェクト作成（APC）が新しいプロジェクトを自動的に作成します。
提出されたジョブはキャンセルでき、変更後にコンテンツを再提出できます。これらのジョブはPhraseに存在し続け、プロジェクトマネージャによって削除する必要があります。
備考
Contentful Launch Appは2.0コネクターではサポートされていません。
-
設定
ページから、セクションまでスクロールします。
-
[コネクタ]をクリックします。
ページが開きます。
-
新しいコネクターをクリックします。
ページが開きます。
-
タイプをContentful 2.0に変更します。
-
コネクターの名前を提供します。
-
Contentful 2.0に接続をクリックします。
Contentfulのログインウィンドウが開きます。
-
ログイン情報を提供し、ログインをクリックします（または代替のログイン方法を使用します）。ログインウィンドウが閉じ、が表示されます。
-
オプションで、アプリとコネクターを使用している場合はPhrase Contentful Appのチェックボックスを選択します。
-
トークンを生成をクリックします。
ウィンドウが開きます。
-
トークンを生成をクリックします。
トークンが生成され、クリップボードまたはテキストファイルにコピーする必要があります。ウィンドウを閉じる前にトークンがコピーされていることを確認してください。再度表示されることはありません。このトークンはアプリに接続する際に使用されます。
-
ウィンドウを閉じると、が表示されます。
-
-
Contentful タグが翻訳可能なコンテンツを識別するために使用される場合、タグ ID を入力し、Enterを押してください。
ID が表示され、さらに追加できます。
-
必要に応じて、を選択します。
-
必要に応じて、（ネストされたコンテンツ）を選択します。
が表示されます。システムがコンテンツの関係を通じてどのように移動するかをより詳細に制御するために、希望するフィルターを適用します。
-
インポート中にフレーズが参照エントリをどれだけ追跡するかを制限します。
デフォルト値は 10,000 です。必要に応じて、他の値を選択するか、カスタム整数値を指定します。
-
指定されたリストに一致するコンテンツタイプを持つエントリで停止するか、追跡するかを選択します。
-
指定されたリストに一致する親コンテンツタイプを持つエントリを除外します。
-
指定されたコンテンツタグのいずれかを持つエントリで停止するか、追跡するかを選択します。
-
指定されたフィールド ID によって参照されるエントリで停止するか、追跡するかを選択します。
-
-
必要に応じて、を選択します。
フィールドが表示されます。値を入力して分類設定を有効にします。
-
選択すると、コネクターはContentfulから分類を取得し、それを.XLIFFファイルに含めます。パネルは、CATエディタの各セグメントのContentful分類値を一覧表示します。
-
分類メタデータが利用できない場合、またはコネクターがそれで構成されていない場合、パネルは単に省略されます。
-
プロジェクトが機能/画面のコンテキストを必要としない場合、.XLIFFエクスポート時のパフォーマンスを最適化するために分類を無効にしておくことをお勧めします。
-
-
必要に応じて、を選択します。
エイリアスは、すべてのAPC監視およびジョブの再インポート/エクスポートに使用されます。将来的にエイリアスターゲットが変更された場合、APCは新しいターゲットのコンテンツを監視し、ジョブは新しいエイリアスターゲットから/へ再インポート/エクスポートされます。
-
（デフォルトおよび推奨）
APCおよび作成されたジョブは、ジョブ/APC作成時にエイリアスが指していた環境に結びついています。APCはその環境とコンテンツのみを監視し、ジョブはそれにエクスポートおよび再インポートされます。
-
APCおよび作成されたジョブは、エイリアス自体に結びついています。APCはそのエイリアスとコンテンツのみを監視し、ジョブはそれにエクスポートおよび再インポートされます。
エイリアスターゲットが変更された場合、APCは新しいエイリアスターゲット（環境）を監視し、ジョブはそれにエクスポートおよび再インポートされます。
-
-
必要に応じて、を提供します。
これは、ContentfulからレンダリングされたコンテンツへのURLテンプレートです。以下のプレースホルダーを利用できます。
-
{env_id}:Environment ID -
{entry.id}:Entry ID -
{space_id}:Space 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統合は、コンテンツのインポートと変更の監視にこのAPIを使用します（APC）。
-
Contentfulから監視/インポートする各スペースと環境を選択します。
-
セットアップとアクセスは、Contentful自体内で管理されます。
-
-
保存をクリックします。
コネクターがページの一覧に追加されます。
注意
カスタムドメイン（例：mydomain.phrase.jp）からアクセスする場合は、シークレットブラウザウィンドウを開き、cloud.memsource.comまたはus.cloud.memsource.comを介してログインして、コネクターの作成または保存に必要な認証を適用します。保存後、コネクターはカスタムドメインを介してアクセスできます。
-
設定
-
[コネクタ]をクリックします。
ページが開きます。
-
新しいコネクターをクリックします。
ページが開きます。
-
タイプをいずれかのContentful（エントリーレベル）またはContentful（フィールドレベル）に変更し、コネクターの名前を提供します。
-
オプションで、アプリとコネクターを使用している場合はPhrase Contentful Appのチェックボックスを選択します。
-
Contentfulアプリトークン
Phrase TMS Contentfulアプリケーションに入力するアプリトークンを生成します。トークンを生成し、Contentfulアプリにコピーした後、コネクターを保存します。
備考
一度保存されると、トークンはContentful内から変更できません。更新するには、Phrase TMSのコネクター設定からトークンを取り消し、新しいトークンを生成します。
-
-
言語に依存しない設定を構成します。
-
原文言語
Contentfulのデフォルト言語を上書きするソース言語を選択します。コネクターは、コネクター設定で設定された言語からコンテンツを取得します。
例：
備考
アプリケーションを使用している場合は適用されません。
-
-
ネストされたコンテンツを処理する方法を選択します エントリーインポートモード。コンテンツは、他のコンテンツを参照するための参照フィールドを使用でき、エンティティの階層を作成できます。
-
Contentful（エントリーレベル）
エントリーレベルのコネクターは、ネストされたコンテンツの全階層を自動的に横断します。
-
Contentful（フィールドレベル）
フィールドレベルのコネクターがネストされたコンテンツをインポートする方法を選択します。
-
-
リポジトリから追加する際に明示的に選択されたコンテンツがインポートされます。
-
APCによって検出された変更が翻訳のためにインポートされます。
-
-
参照されたエントリーをインポート
-
コネクターはネストされたコンテンツの全階層を横断し、翻訳のためにすべての翻訳可能なフィールドをインポートします。
-
-
-
-
翻訳可能なフィールドを省略するために、翻訳可能なフィールドを省略にカンマ区切りのリストを作成します。次の構造を使用します:
contentTypeID:fieldID。-
リストされたフィールドを空のままにする場合は、省略されたフィールドを空のままにするを選択します。この設定はリストされているすべてのエントリに適用されます。
-
リストされたフィールドにソース値を含める必要がある場合は、ソースをターゲットにコピーするを選択します。この設定はリストされているすべてのエントリに適用されます。
-
-
ソース言語の特定のフィールドにデータが欠けている場合は、を選択します。
必要に応じて、ドロップダウンリストからを選択します。データが欠けている場合、この言語ロケールが使用されます。
備考
Contentfulのフォールバック言語とこの設定の間に関係はありません。
-
必要に応じて、を提供してください（ベータ版）。
これは、ContentfulからレンダリングされたコンテンツへのURLテンプレートです。以下のプレースホルダーを利用できます。
-
{env_id}:Environment ID -
{entry.sys.id}:Entry ID -
{space_id}:Space ID
URLテンプレートはこのようになります:
https://contentfulapp.tld/?spaceId={space_id}&environmentId={env_id}&entryId={entry.sys.id}
備考
URLは、Contentfulコンテンツをレンダリングするデプロイされたアプリケーションに導く必要があります。ライブプレビューを使用するには、URLテンプレート内の
contentfulapp.tldをアプリケーションの実際のドメインに置き換えます。コンテンツプレビューの設定に関する詳細は、Contentfulのドキュメントを参照してください。
現在、ロケールはプレースホルダーとしてサポートされていません。URLでロケールを使用するには、固定値を指定し、複数のコネクターインスタンスを作成します。
-
-
技術サポートチームからデバッグ情報のログ記録が要求された場合は、を選択してください。
-
Contentfulに接続するをクリックしてください。
接続が成功した場合、コネクターのセットアップにチェックマークが表示されます。そうでない場合、赤い感嘆符が表示されます。アイコンにカーソルを合わせると、詳細が表示されます。
-
Contentful（エントリーレベル）のみ：
ソース言語を設定してください。
備考
この言語は、Contentfulのロケール設定で構成されたContentfulスペースのデフォルトロケールと一致する必要があります。
-
保存をクリックします。
コネクターがページの一覧に追加されます。
-
オプションで、コネクターを編集してを選択します。
-
:
コネクターは、選択したステージ（例: 要翻訳）の記事を監視します。翻訳の準備ができたら、作成者はこのラベルを記事に適用することができます。
Contentfulからのインポート時:
-
コネクターは、ソース記事がダウンロードされると、選択されたステージ（例：翻訳中）にワークフローを進めます。
Contentfulへのエクスポート時:
-
コネクターは、翻訳がエクスポートされると、ソース記事のワークフローステージを選択されたステージ（例：翻訳完了）に設定します。
備考
ワークフローのサポートは、2023年6月1日にContentfulによって中止されました。継続的な使用はサポートされていません。
-