翻訳ルールの設定

翻訳のコンテンツを識別するための翻訳ルールを定義する方法を説明します。

これまでの説明内容

AEMヘッドレス翻訳ジャーニーの前のドキュメントで、翻訳コネクタのインストールと設定の方法を学習した翻訳コネクタの設定を、次の手順でおこないました。

  • AEMの翻訳統合フレームワークの重要なパラメーターについて説明します。
  • 翻訳サービスへの接続を独自に設定できる。

コネクタの設定が完了したので、この記事では、次の手順を実行して、翻訳する必要のあるコンテンツを特定します。

目的

このドキュメントでは、AEM翻訳ルールを使用して翻訳コンテンツを特定する方法を説明します。 読み終えると、以下を達成できます。

  • 翻訳ルールの動作を理解します。
  • 独自の翻訳ルールを定義できる。

翻訳ルール

ヘッドレスコンテンツを表すコンテンツフラグメントには、構造化されたフィールドで構成された多くの情報を含めることができます。 プロジェクトのニーズに応じて、コンテンツフラグメント内のすべてのフィールドを翻訳する必要がない可能性があります。

翻訳ルールは、翻訳プロジェクトに含まれる、または翻訳プロジェクトから除外されるコンテンツを識別します。 コンテンツが翻訳されると、AEMはこれらのルールに基づいてコンテンツを抽出またはハーベストします。 この方法で、翻訳が必要なコンテンツのみが翻訳サービスに送信されます。

翻訳ルールには、次の情報が含まれます。

  • ルールを適用するコンテンツのパス
    • ルールはコンテンツの子孫にも適用されます
  • 翻訳するコンテンツを含むプロパティの名前
    • プロパティは、特定のリソースタイプまたはすべてのリソースタイプに固有です

コンテンツフラグメントの構造を定義するコンテンツフラグメントモデルは、独自のプロジェクトに固有なので、AEMが翻訳するコンテンツモデルの要素を把握できるように翻訳ルールを設定することが不可欠です。

ヒント

通常、コンテンツアーキテクトは翻訳スペシャリストに翻訳に必要なすべてのフィールドの​プロパティ名​を提供します。 これらの名前は、翻訳ルールを設定するために必要です。 翻訳のスペシャリストとして、は、このジャーニーで前述したように、プロパティ名​を自分で見つけることができます。

翻訳ルールの作成

複雑な翻訳要件をサポートするために、複数のルールを作成できます。 例えば、作業中のプロジェクトの場合は、モデルのすべてのフィールドを翻訳する必要がありますが、タイトルは未翻訳のまま残される間、別の説明フィールドのみを翻訳する必要があります。

翻訳ルールは、このようなシナリオを処理するように設計されています。 ただし、この例では、単純な単一の設定に焦点を当ててルールを作成する方法を説明します。

翻訳設定​コンソールを使用して、翻訳ルールを設定できます。 コンソールにアクセスするには:

  1. ツール -> 一般​に移動します。
  2. 翻訳設定」をタップまたはクリックします。

翻訳設定 UIには、翻訳ルールに使用できるオプションが多数あります。 ここでは、基本的なヘッドレスローカリゼーション設定に必要な、最も必要で一般的な手順を示します。

  1. コンテキストを追加」をタップまたはクリックして、パスを追加できます。 これは、ルールの影響を受けるコンテンツのパスです。
    コンテキストの追加
  2. パスブラウザーを使用して必要なパスを選択し、「確認」ボタンをタップまたはクリックして保存します。 ヘッドレスコンテンツを保持するコンテンツフラグメントは、通常/content/dam/<your-project>の下に配置されます。
    パスを選択
  3. AEMは設定を保存します。
  4. 作成したコンテキストを選択し、「編集」をタップまたはクリックします。 翻訳ルールエディター​が開き、プロパティを設定します。
    翻訳ルールエディター
  5. デフォルトでは、すべての設定は親パスから継承されます(この場合は/content/dam)。 設定にフィールドを追加するには、「/content/dam​から継承」オプションのチェックを外します。
  6. オフにした後、リストの「一般」セクションで、翻訳用のフィールドとして以前に識別したコンテンツフラグメントモデルのプロパティ名を追加します。
    1. 新しいプロパティ」フィールドにプロパティ名を入力します。

    2. 翻訳」と「継承」の各オプションが自動的にオンになります。

    3. 追加」をタップまたはクリックします。

    4. 翻訳する必要のあるすべてのフィールドに対して、これらの手順を繰り返します。

    5. 保存して閉じる」をタップまたはクリックします。

      プロパティの追加

これで、翻訳ルールが設定されました。

高度な使用方法

翻訳ルールの一部として設定できる追加のプロパティは多数あります。 さらに、ルールをXMLとして手動で指定することもできます。これにより、特異性と柔軟性が高まります。

このような機能は、通常、ヘッドレスコンテンツのローカライズを開始する際には必要ありませんが、必要に応じて、「その他のリソース」の節で詳しく説明します。

次の手順

これで、ヘッドレスな翻訳ジャーニーのこの部分を完了しました。

  • 翻訳ルールの動作を理解します。
  • 独自の翻訳ルールを定義できる。

この知識に基づいてAEMヘッドレス翻訳のジャーニーを続けるには、次にTranslate contentドキュメントを確認します。ここでは、コネクタとルールが連携してヘッドレスコンテンツを翻訳する方法を説明します。

その他のリソース

ドキュメントコンテンツの翻訳を確認して、ヘッドレス翻訳ジャーニーの次の部分に進むことをお勧めしますが、以下に、このドキュメントで取り上げるいくつかの概念について詳しく説明する追加のオプションリソースを示します。

このページ