Contentful (TMS)

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

利用可能対象

ビジネスおよびエンタープライズプラン（LSPプランでは利用できません）

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

利用可能対象

エンタープライズプラン（従来のプラン）

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

ヒント

Phrase StringsにおけるContentful統合に関する情報は、Contentful (Strings)を参照してください。

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

専用のContentfulコネクター（2.0、エントリーレベル、フィールドレベル）を介して

Contentful 2.0コネクターは、現在、米国データセンターを介した認証のみをサポートしています。
カスタマイズされた体験のためのContentfulマーケットプレイスプラグインを介して

備考

コネクターは、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 Auth tokenを入力します。
インストールをクリックします。

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

Contentfulのアプリを起動するワークフローサポートを使用する場合は、次の手順に従ってください：

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

備考

1つのスペースにつき、1つのワークフローしか作成できません。1つのContentfulスペース内で異なるコンテンツタイプのアプローチが必要な場合は、専任のカスタマーサクセスマネージャーに連絡してください。
必要なローカリゼーションワークフローを設定します。
記載されたワークフローに従うコンテンツタイプを選択します。

コネクタにワークフローが設定されている場合、監視されている記事やコンテンツタイプのワークフローステップに変更が検出されると、自動プロジェクト作成（APC）が新しいプロジェクトを自動的に作成します。

提出されたジョブはキャンセルでき、変更後にコンテンツを再提出できます。これらのジョブはPhraseに存在し続け、プロジェクトマネージャーによって削除する必要があります。

Phrase TMS設定（Contentful 2.0）

備考

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

設定ページから、統合機能セクションまでスクロールします。
コネクタをクリックします。

コネクタページが開きます。
新しいコネクタをクリックします。

コネクターを作成するページが開きます。
タイプをContentful 2.0に変更します。
コネクターの名前を提供してください。
Contentful 2.0に接続するをクリックします。

Contentfulのログインウィンドウが開きます。
ログイン情報を提供し、ログインをクリックします（または代替のログイン方法を使用します）。ログインウィンドウが閉じ、接続済みが表示されます。
オプションで、アプリでコネクターを使用する場合はPhrase Contentful Appのチェックボックスを選択します。
1. トークンを生成するをクリックします。
  
  Contentfulトークンを生成するウィンドウが開きます。
2. トークンを生成するをクリックします。
  
  トークンが生成され、クリップボードまたはテキストファイルにコピーする必要があります。ウィンドウを閉じる前にトークンがコピーされていることを確認してください。再度表示されることはありません。このトークンはアプリに接続する際に使用されます。
3. ウィンドウを閉じると、トークンが生成されましたが表示されます。
Contentfulタグを使用して翻訳可能なコンテンツを識別する場合は、タグIDを入力し、Enterを押します。

IDが表示され、さらに追加できます。
- リスティング戦略を選択する
  - すべてのタグで
    
    すべてのタグがリストされたContentful内のコンテンツを表示します。
  - 1つ以上のタグで
    
    Contentfulから、リストにあるタグのいずれかを持つコンテンツを表示します。
必要に応じて、アセットを含めるを選択します。
必要に応じて、参照されたエントリを含める（ネストされたコンテンツ）を選択します。

参照されたエントリの設定が表示されます。システムがコンテンツの関係を通じて移動する方法をより詳細に制御するために、必要なフィルターを適用します。
- リンクされたエントリのインポート深度を設定
  
  インポート中にPhraseが参照エントリを追跡する距離を制限します。
  
  デフォルト値は10,000です。必要に応じて、他の値を選択するか、カスタム整数値を指定します。
- コンテンツの種類
  
  指定されたリストに一致するコンテンツタイプのエントリで停止するか、追跡するかを選択します。
- 親コンテンツの種類
  
  指定されたリストに一致する親コンテンツタイプのエントリを除外します。
- タグ
  
  指定されたコンテンツタグのいずれかを持つエントリで停止するか、追跡するかを選択します。
- フィールドID
  
  指定されたフィールドIDによって参照されるエントリで停止するか、追跡するかを選択します。
必要に応じて、分類を含めるを選択します。

Contentful組織IDフィールドが表示されます。分類設定を有効にするための値を入力します。
- 選択されると、コネクターはContentfulからタクソノミーを取得し、それを.XLIFFファイルに含めます。コンテキストメモペインのCAT Editorは、各セグメントのContentfulタクソノミー値を一覧表示します。
- タクソノミーメタデータが利用できない場合、またはコネクターがそれで構成されていない場合、コンテキストメモペインは単に省略されます。
- プロジェクトが機能/画面のコンテキストを必要としない場合、.XLIFFエクスポート時のパフォーマンスを最適化するためにタクソノミーを無効にしておくことをお勧めします。
必要に応じて、エイリアスに従うを選択します。

エイリアスは、すべてのAPC監視およびジョブの再インポート/エクスポートに使用されます。将来的にエイリアスターゲットが変更された場合、APCは新しいターゲットのコンテンツを監視し、ジョブは新しいエイリアスターゲットから/へ再インポート/エクスポートされます。
- 無効（デフォルトおよび推奨）
  
  APCおよび作成されたジョブは、ジョブ/APC作成時にエイリアスが指していた環境に結びついています。APCはその環境とコンテンツのみを監視し、ジョブはそれにエクスポートおよび再インポートされます。
- 有効
  
  APCおよび作成されたジョブは、エイリアス自体に結びついています。APCはそのエイリアスとコンテンツのみを監視し、ジョブはそれにエクスポートおよび再インポートされます。
  
  エイリアスターゲットが変更された場合、APCは新しいエイリアスターゲット（環境）を監視し、ジョブはそれにエクスポートおよび再インポートされます。
必要に応じて、プレビュー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でロケールを使用するには、固定値を指定し、複数のコネクターインスタンスを作成します。
必要に応じて、Phraseへのインポートから省略すべきContentIDを提供してください。
スペースIDとトークンをスペースプレビュートークンマップに提供してください（必須）。

プレビューAPIには、ContentfulスペースのAPI設定で構成する必要があるコンテンツプレビューAPI - アクセストークンという名前のContentfulアクセストークンが必要です。

Contentful 2.0統合は、コンテンツのインポートと変更の監視にこのAPIを使用します（APC）。
- Contentfulから監視/インポートする各スペースと環境を選択します。
- セットアップとアクセスはContentful内で管理されます。
保存をクリックします。

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

Phrase TMS設定

注意

カスタムドメイン（例：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でEN-USがデフォルト言語として設定されている場合でも、特定のスペースやコンテンツモデルのローカリゼーションにDE-DEが必要な場合、設定を調整してスペース（リモートフォルダー）がEN-USの代わりにDE-DEからコンテンツを取得するようにできます。
備考

アプリケーションを使用している場合は適用されません。
エントリーインポートモードを通じてネストされたコンテンツを処理する方法を選択します。コンテンツは、他のコンテンツを参照するための参照フィールドを使用でき、エンティティの階層を作成します。

備考

アプリケーションを使用している場合は適用されません。
- Contentful（エントリーレベル）
  
  エントリーレベルのコネクターは、ネストされたコンテンツの全階層を自動的に横断します。
- Contentful（フィールドレベル）
  
  フィールドレベルのコネクターがネストされたコンテンツをインポートする方法を選択します。
  - 選択したエントリのみ
    
    リポジトリから追加する際に明示的に選択されたコンテンツがインポートされます。
    
    APCによって検出された変更は、翻訳のためにインポートされます。
  - 参照されたエントリをインポート
    
    コネクターは、ネストされたコンテンツの全階層を横断し、翻訳可能なすべてのフィールドを翻訳のためにインポートします。
翻訳可能なフィールドを省略する<1>にチェックされたフィールドを省略するために、カンマ区切りの一覧を作成します。次の構造を使用してください: contentTypeID:fieldID。
- リストされたフィールドを空欄にする必要がある場合は、省略されたフィールドを空欄にするを選択してください。この設定はリストされているすべてのエントリに適用されます。
- リストされたフィールドにソース値を含める必要がある場合は、ソースをターゲットにコピーするを選択してください。この設定はリストされているすべてのエントリに適用されます。
ソース言語の特定のフィールドにデータが欠けている場合は、フォールバック言語を使用するを選択してください。

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

備考

Contentfulのフォールバック言語とこの設定の間には関係はありません。
必要に応じて、ライブプレビューURLを提供してください（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でロケールを使用するには、固定値を指定し、複数のコネクターインスタンスを作成します。
技術サポートチームからデバッグ情報のログが要求された場合は、デバッグ情報をログに記録するを選択してください。
Contentfulに接続するをクリックしてください。

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

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

備考

この言語は、Contentfulのロケール設定で構成されたContentfulスペースのデフォルトロケールと一致する必要があります。
保存をクリックします。

コネクターが「コネクター」ページの一覧に追加されます。
オプションで、コネクターを編集してContentfulワークフローを選択します。
- 以下から記事を翻訳します:
  
  コネクターは、選択したステージ（例: 翻訳）の記事を監視します。翻訳の準備ができたら、作成者はこのラベルを記事に適用することができます。
Contentfulからのインポート時:
- 原文記事を以下に設定
  
  コネクターは、ソース記事がダウンロードされると、ワークフローを選択したステージ（例: 翻訳中）に進めます。
Contentfulへのエクスポート時:
- 原文記事を以下に設定
  
  コネクターは、翻訳がエクスポートされると、ソース記事のワークフローステージを選択したステージ（例: 翻訳完了）に設定します。
備考

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