ヒント
Phrase StringsにおけるContentful統合に関する情報は、Contentful (Strings)を参照してください。
Contentfulは、コンテンツを作成、管理、配信するためのヘッドレスコンテンツ管理インフラストラクチャを提供します。Phraseは、よりカスタマイズされたユーザーエクスペリエンスのために、コネクタベースの統合とContentfulマーケットプレイスのプラグインの両方を提供します。
備考
コネクタは、JSONオブジェクトの翻訳をサポートしていません。
サポートされているローカリゼーション方法
Contentfulは複数のローカリゼーション方法をサポートしています。詳細な説明については、Contentfulのドキュメントを参照してください。
エントリーレベルのローカリゼーション(従来)
Contentful (エントリーレベル)コネクタを使用してください。
エントリーレベルのコネクタは、ローカライズされた参照フィールドを持つコンテンツタイプでのみ機能します(例:ローカリゼーションが有効な参照フィールド)。
フィールドレベルのローカリゼーション(従来)
Contentful (フィールドレベル)コネクタを使用してください。
フィールドレベルのコネクタは、翻訳可能なフィールド(例:ローカリゼーションが有効なテキストまたはリッチテキストフィールド)およびメディアアセットを持つコンテンツタイプでのみ機能します。コネクタが参照エントリをインポートするように設定されている場合、ネストされたコンテンツの全階層を横断し、翻訳のためのすべての翻訳可能なフィールドをインポートします。参照フィールドがローカリゼーションのために有効になっている場合、プロジェクトのソース言語に一致する参照をインポートします。
コネクタの使用例はいくつかあります:
-
プロジェクトマネージャーは、オンラインリポジトリからプロジェクトにファイルを直接追加できます。コンテンツはエントリーIDで検索可能です。
-
提出者ポータルを設定して、提出者がオンラインリポジトリからリクエストにファイルを直接追加できるようにします。コンテンツはエントリーIDで検索可能です。
-
自動プロジェクト作成 (APC)を使用して、監視された文書またはフォルダーのコンテンツサイズに変更が検出されたときに新しいプロジェクトを自動的に作成します。
-
選択したファイルはAPCの初回実行時にインポートされます。
-
アプリケーションの使用例:
-
コンテンツ編集者は、Contentful内から直接ローカリゼーションのためのエントリーを送信できます。これにより、コンテンツ編集者やマネージャーはローカリゼーションフローを完全に制御し、エントリーを表示しているときにステータスの更新をリアルタイムで受け取ることができます。
エントリーが最終化されたら:
-
ローカリゼーションのために希望するターゲット言語を選択します。
-
選択した言語のエントリーのみをPhrase TMSに送信するか、フィールド選択タブを使用してフィールドを選択します。
-
フィールドが選択されていない場合、すべてのローカライズ可能なフィールドが翻訳のために送信されます。
-
ローカライズできないフィールドが選択された場合、そのフィールドは翻訳のために送信されません。ローカライズ可能なフィールドのみが送信されます。
-
ローカライズ可能なフィールドの一部のみが選択された場合、それらのフィールドのみが翻訳のために送信されます。
-
-
APC設定に基づいて、送信されたコンテンツからジョブが自動的に作成されます。APC実行中は、送信済みステータスのエントリーのみがジョブ作成のために取得されます。
-
送信されたエントリーからジョブが作成されると、ステータスが進行中に変更されます。翻訳がContentfulに戻されると、ステータスが完了に変更されます。
-
以前に翻訳されたエントリーは、元のコピーに変更があった後に再送信できます。
-
-
コンテンツ編集者はPhrase TMSのホーム画面を使用して:
-
エントリーを一括で送信します。
-
一括送信中に個別のターゲット言語を指定します。
-
アクティブな翻訳ジョブの概要を把握します。
-
Contentful 設定
Phrase TMS アプリケーションを使用する場合:
-
マーケットプレイスから Phrase TMS アプリケーションをダウンロードします。
-
アプリケーションを現在のアクティブなスペースにインストールし、アプリケーションのインストールが必要なコンテンツモデルを選択します。
-
Phrase TMS 内でコネクターを作成する際に取得した Phrase TMS 認証トークン を入力します。
-
インストール をクリックします。
オプション - アプリを起動
Contentful の Launch App を使用してワークフローサポートを利用する場合は、次の手順に従ってください:
-
Contentful の Launch アプリケーションを1つ以上のスペースにインストールします。
備考
スペースごとに1つのワークフローしか作成できません。1つの Contentful スペース内で異なるコンテンツタイプのアプローチが必要な場合は、専任のカスタマーサクセスマネージャーに連絡してください。
-
必要なローカリゼーションワークフローを設定します。
-
記載されたワークフローに従うコンテンツタイプを選択します。
コネクター内にワークフローが設定されている場合、監視されている記事やコンテンツタイプのワークフローステップに変更が検出されると、自動プロジェクト作成 (APC) が新しいプロジェクトを自動的に作成します。
提出されたジョブはキャンセルでき、変更後にコンテンツを再提出できます。これらのジョブは Phrase に存在し続け、プロジェクトマネージャーによって削除する必要があります。
注意
カスタムドメイン (例: mydomain.phrase.jp
) からアクセスする場合は、シークレットブラウザウィンドウを開き、cloud.memsource.com
または us.cloud.memsource.com
を介してログインして、コネクターの作成または保存に必要な認証を適用します。保存後、コネクターはカスタムドメインを介してアクセスできます。
-
設定
ページから、 セクションまでスクロールします。
-
[コネクタ]をクリックします。
ページが開きます。
-
新しいコネクター をクリックします。
ページが開きます。
-
接続の名前を提供し、タイプをいずれかのContentful (エントリーレベル)またはContentful (フィールドレベル)に変更します。
-
コネクタをアプリで使用する場合は、フレーズContentfulアプリのチェックボックスを選択します。
-
Contentfulアプルトークン
フレーズTMSContentfulアプリケーションに入力するアプリケーショントークンを生成します。トークンを生成し、それをContentfulアプリにコピーした後、コネクタを保存します。
備考
トークンがContentfulのアプリケーション設定に追加されると、Contentful内から変更することはできません。トークンを変更するには、コネクタ設定でそれを取り消し、新しいトークンを生成してPhrase TMSへの新しいコネクタを作成します。
-
-
言語に依存しない設定を構成します。
-
スペースを選択
デフォルトのContentfulスペースの言語を上書きするためのソース言語を構成するスペースを選択します。
-
環境を選択
設定されたスペースの環境を選択します。
-
原文言語
Contentfulのデフォルト言語を上書きするソース言語を選択します。コネクタは、コネクタ設定で設定された言語からコンテンツを引き出します。
例:
備考
アプリケーションを使用している場合は適用されません。
-
-
エントリインポートモードを通じてネストされたコンテンツを処理する方法を選択します。コンテンツは、他のコンテンツを参照するための参照フィールドを使用でき、エンティティの階層を作成します。
-
Contentful (エントリーレベル)
エントリーレベルのコネクタは、ネストされたコンテンツの全階層を自動的に横断します。
-
Contentful (フィールドレベル)
フィールドレベルのコネクタがネストされたコンテンツをインポートする方法を選択します。
-
-
リポジトリから追加する際に明示的に選択されたコンテンツがインポートされます。
-
APCによって検出された変更が翻訳のためにインポートされます。
-
-
参照されたエントリをインポート
-
コネクターは、ネストされたコンテンツの全階層を横断し、翻訳可能なすべてのフィールドをインポートします。
-
-
-
-
翻訳可能なフィールドを省略するで、Phrase TMSへのインポートから がチェックされているフィールドを省略するためのカンマ区切りのリストを作成します。次の構造を使用します:
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へのエクスポート時:
-
コネクターは、翻訳がエクスポートされると、ソース記事のワークフローステージを選択されたステージ(例:翻訳完了)に設定します。
備考
ワークフローのサポートは、Contentfulによって2023年6月1日に終了しました。継続的な使用はサポートされていません。
-
備考
Contentful Launch Appは、2.0コネクターではサポートされていません。
-
設定
ページから、 セクションまでスクロールします。
-
[コネクタ]をクリックします。
ページが開きます。
-
新しいコネクター をクリックします。
ページが開きます。
-
タイプをContentful 2.0に変更します。
-
コネクターの名前を提供します。
-
Contentful 2.0に接続するをクリックします。
Contentfulのログインウィンドウが開きます。
-
ログイン情報を提供し、ログインをクリックします(または別のログイン方法を使用します)。ログインウィンドウが閉じ、 が表示されます。
-
コネクタをアプリで使用する場合は、フレーズContentfulアプリのチェックボックスを選択します。
-
トークンを生成をクリックします。
ウィンドウが開きます。
-
トークンを生成をクリックします。
トークンが生成され、クリップボードまたはテキストファイルにコピーする必要があります。ウィンドウを閉じる前にトークンがコピーされていることを確認してください。再度表示されることはありません。このトークンはアプリに接続する際に使用されます。
-
ウィンドウを閉じると、
が表示されます。
-
-
Contentfulタグを使用してコンテンツを識別する場合は、タグIDを入力し、Enterを押します。
IDが表示され、さらに追加できます。
-
必要に応じて、
を選択します(ネストされたコンテンツ)。すべてのネストされたコンテンツは、インポートおよびジョブの作成中に含まれます。
-
必要に応じて、
を選択します。エイリアスは、すべての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 2.0統合は、コンテンツのインポートと変更の監視のためにこのAPIを使用します(APC)。
-
Contentfulから監視/インポートする各スペースと環境を選択してください。
-
セットアップとアクセスはContentful自体内で管理されます。
-
-
保存をクリックします。
コネクターが
ページの一覧に追加されます。