統合機能

Adobe Experience Manager - AEM (TMS)

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

利用可能対象

  • Enterpriseプラン

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

利用可能対象

  • Enterpriseプラン(従来のプラン)

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

サポートされているバージョン

Adobe Experience Manager用Phrase翻訳プラグインは、Adobe Experience Managerと同じ製品サポート期間に従います。サポート期間の詳細については、https://helpx.adobe.com/support/programs/eol-matrix.htmlを参照してください。

Adobe Experience Managerのバージョンがコアサポート終了に達すると、Phraseはプラグインのメンテナンスを終了します。インストーラーは引き続き利用可能ですが、それ以降の改善や修正は実施されません。

  • プラグインバージョン2.Xは6.5をサポートしています。

  • プラグインバージョン3.XはAEM as a Cloud Serviceをサポートしています。

プラグインのリリースノート

Phrase設定

インコンテキストプレビューの設定

インコンテキストプレビュー機能は、CAT Web EditorおよびCAT Desktop Editorの両方で、原文または翻訳文のリアルタイムプレビューを提供します。

テーブル、列、各種グラフィック、書式設定、およびフォント(ユーザーがインストールした場合)がサポートされています。この機能は翻訳時にコンテキストを提供することを目的としており、原文や完成したドキュメントを完全に再現するものではありません。そのため、多少の視覚的な差異が生じることがあります。また、アクセスおよびセキュリティ設定のエディターでの外部コンテンツの読み込みを許可するオプションを有効/無効にすることによっても影響を受ける可能性があります。

Phraseの要件:

  • オンプレミス環境にアクセスするために、Enterpriseファイアウォールを通過してください。

  • オーサリング環境に認証してください。

オンプレミス環境のファイアウォール設定:

  • インストールは、PhraseサーバーのIPアドレスからアクセス可能である必要があります。現在のリストについては、PhraseサーバーIPアドレスを参照してください。

  • ドメイン名は外部から解決可能である必要があります。

備考

一部のHTMLタグはリスクをもたらすため、CAT Editorはプレビューを表示する際、このHTMLからそれらのタグを削除します。これは、ユーザーのデータプライバシーとセキュリティを確保するためです。

削除されるタグの例には、FORMIFRAMESCRIPTSVGVIDEOEMBEDOBJECT、またはbackground-image CSSプロパティが含まれます。

Phrase TMS設定

前提条件:未公開ページの表示に必要な最小限の権限を持つAdobe Experience Managerユーザーを作成します。

ヒント

phrase-previewという新しいユーザーを作成し、そのユーザーを作成者グループに追加します。

  1. 設定Setup_gear.pngページから、[統合機能]セクションまでスクロールします。

  2. [コネクタ]をクリックします。

    「コネクタ」ページが開きます。

  3. コネクター作成をクリックします。

    コネクター作成ページが開きます。

  4. タイプAdobe Experience Manager Live Previewに変更し、コネクターの名前を入力します。

  5. ホストを入力します。

    Adobe Experience Managerインストールのホストアドレスを使用します(例:https://aem-author.example.org/ または https://author-X-Y.adobeaemcloud.com/)。

    ドメイン名は外部から解決可能である必要があります(イントラネットドメインは不可)。

  6. ユーザー名とパスワードを入力します。

    シングルサインオン(SSO)および2段階認証(2FA)はサポートされていません。DrupalアカウントでSSOまたは2段階認証が強制されている場合は、両方の対象外となる専用のサービスアカウントを使用してください。

  7. ページHTMLに含まれるリンクを変更するには、正規表現URL書き換えルールを指定します。

    例:

    https://example.org/en-us/images/sample.jpg内の完全なロケールコードを言語コードのみに置換するには、/([a-z]{2})-[a-z]{2}/を検索し、/$1/に置換します。

    <img src=\"\" data-lazy-src=\"\"<link href=\"\", <script src=\"\"<iframe src=\"\"タグ内のリンク、およびCSSスタイルや参照されるCSSファイル内のリンク(url: (''))が書き換えられます。

  8. 保存をクリックします。

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

コネクターを削除する

コネクターを削除するには:

  1. 統合ページから、削除するコネクターを選択します。

  2. 削除をクリックします。

    コネクターを削除ウィンドウが開きます。

  3. 「delete」と入力し、削除をクリックします。

    コネクターが削除され、コネクターの一覧が表示されます。

備考

ごみ箱にあるジョブを含め、プロジェクト内の未完了のジョブにまだリンクされているコネクターは削除できません。そのようなコネクターを削除しようとすると、「コネクターの削除に失敗しました」というエラーが返されます。

解決策: コネクターに関連付けられているプロジェクトを開き、残っているジョブを完了または削除します。設定/ごみ箱に移動し、ごみ箱を空にして、コネクターにまだリンクされているジョブを削除します。コネクターの削除を再試行します。

備考

一部のHTMLタグはリスクをもたらすため、CAT Editorはプレビューを表示する際、このHTMLからそれらのタグを削除します。これは、ユーザーのデータプライバシーとセキュリティを確保するためです。

削除されるタグの例には、FORMIFRAMESCRIPTSVGVIDEOEMBEDOBJECT、またはbackground-image CSSプロパティが含まれます。

翻訳ワークフローを構成する

Adobe Experience Managerのジョブ処理を構成するには、ニーズに合わせて構成されたプロジェクトテンプレートを作成します。

  • アクセスとセキュリティで、Phrase CAT Editorでの外部コンテンツの読み込みを許可するオプションを有効にします。

従来バージョンを使用している場合は、サービスサブミッターポータルを作成および検証する必要があります。構成を検証するには、以下の手順に従います。

  1. 未完了の翻訳プロジェクトを開きます。

  2. ジョブタイルメニューからエクスポートを選択します。

  3. ダウンロードしたzipファイル内で、原文テキストを含む.XMLファイルを探します。

  4. Phraseで、統合機能に使用する提出者ポータルに移動し、リストされているURLを開きます。

  5. SPフォームを完了し、.XMLファイルをアップロードし、メールを検証して送信します。

  6. 新しいプロジェクトが設定通りにプロジェクトテンプレートから作成されたことを検証します。

AEM設定

プラグインをインストールする

オンプレミスAEM

  1. 6.2または6.3から6.4以降に移行する場合は、Classic UI管理者ツール(/miscadmin#/etc/cloudservices/memsource-translation)からすべての従来型クラウドサービス設定を削除します。

    すべての設定が従来型クラウドサービス > Memsource Translation Plugin for AEMから消えます。

  2. ツールデプロイメントで、パッケージに移動します。

  3. 該当する場合は、プラグインの以前のバージョンをアンインストールします。

  4. パッケージのアップロードを選択し、インストールファイルをアップロードします。

  5. 強制アップロードをチェックして送信します。

AEM as a Cloud Service

プラグインが既にインストールされている場合は、ステップ4にスキップしてください。

  1. ローカルファイルシステムベースのmavenリポジトリをAEMクラウドサービスプロジェクトのルートpom.xmlに追加します:

    <repositories>
    ...
      <repository>
        <id>project.local</id>
        <name>project</name>
        <url>file:${maven.multiModuleProjectDirectory}/repository</url>
      </repository>
    ...
    </repositories>
  2. プラグインの依存関係をall/pom.xmlに追加します:

    <dependency>
      <groupId>com.memsource</groupId>
      <artifactId>aem-memsource-plugin.all</artifactId>
      <version>X.X.X</version>
      <type>zip</type>
    </dependency>
  3. 埋め込みブロックをall/pom.xml -> filevault-package-maven-plugin設定に追加します:

    ...
    <plugin>
      <groupId>org.apache.jackrabbit</groupId>
      <artifactId>filevault-package-maven-plugin</artifactId>
      <extensions>true</extensions>
      <configuration>
      <group>my_packages</group>
      <embeddeds>
       <embedded>
         <groupId>com.memsource</groupId>
         <artifactId>aem-memsource-plugin.all</artifactId>
         <type>zip</type>
         <target>/apps/aem-memsource-plugin-packages/application/install</target>
       </embedded>
    ...
  4. プラグインをローカルmavenリポジトリに追加します。AEMクラウドサービスプロジェクトのルートから次のコマンドを実行し、{memsource.plugin.path}プレースホルダーをプラグインへのパス(例:/tmp/aem-memsource-plugin.all-3.0.1.zip)に置き換えます:

    mvn org.apache.maven.plugins:maven-install-plugin:2.5.2:install-file -Dfile={memsource.plugin.path} -DlocalRepositoryPath=./repository/ -Dpackaging=zip
    
  5. all/pom.xmlで正しいプラグインバージョンを設定します(例:3.0.1)。

    <dependency>
      <groupId>com.memsource</groupId>
      <artifactId>aem-memsource-plugin.all</artifactId>
      <version>3.0.1</version>
      <type>zip</type>
    </dependency>
    

プラグインを設定する

2つの設定が必要です。

  • TMSへの接続方法を指定して、翻訳サービスプロバイダとして追加することで、システムにPhraseが存在することを伝えます。

  • 翻訳統合設定を構成することで、いつどのようにPhraseを使用するかをAdobe Experience Managerに伝えます。

    例:

    重要度の高いコンテンツにはPhraseを使用し、コミュニティコンテンツには機械翻訳ベンダーを使用します。

Phraseを翻訳サービスプロバイダとして追加する

以下の手順に従ってください。

  1. ツール一般で、設定ブラウザに移動します。

  2. 各Phraseサービスの設定コンテナを作成します(例:人間による翻訳用設定と、機械翻訳専用設定を個別に作成)。

  3. クラウドサービスで、翻訳クラウドサービスに移動します。

  4. confディレクトリを展開します。

  5. 新しい設定を作成し、以下の情報を入力します。

    • ホスト名: デフォルトのURLは https://cloud.memsource.com/web/ ですが、ユーザーまたはLSPがカスタムURLを使用している場合は異なる可能性があります。

    • ユーザー名およびパスワード(ユーザー権限でグローバルサーバー設定の変更オプションが有効になっているPMロールである必要があります)。

    接続をクリックします。

  6. その他のオプションを選択して、設定を閉じます。

    • すべての翻訳ジョブを単一のPhraseプロジェクトにグループ化する 

      1つのAEMプロジェクト内のすべての翻訳ジョブは、1つのPhraseプロジェクト内にも作成されます。

      注意

      このオプションは、Phrase プロジェクトテンプレート 設定で ジョブを事前翻訳完了時に完了に設定すべてのジョブが完了したときにプロジェクトを完了に設定 が同時に有効になっている場合、正しく仕事しません。

    • AEMへのインポート後にPhraseジョブステータスを納品済みに設定 

    • 解析を生成する 

      アクティブな場合、翻訳ジョブが送信されると、ファイルがインポートされたときに分析が自動的に生成されます。分析は、プロジェクトテンプレートの設定に関係なく、常に 言語<1> ごとに生成されます。 

    • 見積を作成 

      分析の自動生成が有効になっている場合、これらの分析に基づいて見積を作成できます。

従来バージョンを使用している場合は、サービス および サブミッターポータル 情報も必要になります。

翻訳統合機能を設定する

AEM用Phraseプラグインを使用する場合、翻訳ジョブ内のすべてのファイルが翻訳のために送信され、Phraseから返されます。プロジェクト 統合機能 設定を使用して、翻訳不要箇所や参考資料がプロジェクトに含まれないようにします。

  1. ツールで、Cloud Services に移動し、Translation Cloud Services をクリックします。

  2. 翻訳専用の新しい設定を作成します。

    • Translate Component StringsTranslate Tags がオフになっていることを確認します。

    • Translate page assetsDo not translate に設定します。

    • Assets タブで、ワークフローDo not translate に設定します。

  3. プロジェクトにまだ翻訳不要箇所や参考資料が含まれている場合は、Phrase で直接マークして削除します。

サイトに統合機能を適用する

サイト分類の異なる部分でデフォルトのPhraseプロバイダを設定します。サイトのルートノードでプロバイダを設定します。すべての子ページがこの設定を継承します。異なるプロバイダ設定を使用する必要があるノードで設定を上書きします(例:サイト全体では人間による翻訳を使用するが、コミュニティセクションでは機械翻訳を使用する場合)。

翻訳統合機能の適用方法:

  • 詳細タブで、新しく作成した設定をクラウド設定として選択します。

これらのページからコンテンツを追加する場合、翻訳可能なコンテンツのみが追加されます。参照パネルからプロジェクトが作成された場合、ルートページに関連付けられたクラウド設定を使用するように自動的に設定されます。

コンテンツを翻訳用に送信

コンテンツ(サイト、アセット)を翻訳用に送信するには、Adobe Experience Managerで翻訳プロジェクトを作成します。プロジェクトは、プロジェクトセクションで手動で作成するか、組み込みのワークフローを使用して作業を最小限に抑えることができます。

組み込みのワークフローを通じて送信するためのプロジェクトを準備するには、次の手順に従います:

  1. サイトビューから、ページに移動して選択し、参照パネルを開きます。

  2. 言語コピーをクリックし、レールの下部にある作成と翻訳セクションを展開します。

  3. 訳文言語を選択し、必要に応じてすべてのサブページを選択のチェックを外します。

  4. 多言語翻訳プロジェクトを作成を選択します。

    複数の訳文言語がある場合、言語ごとに個別のプロジェクトが作成されます。

  5. プロジェクトタイトルを入力し、作成をクリックします。

  6. プロジェクトセクションでプロジェクトに移動し、開きます。

  7. 最初のタイルの省略記号をクリックして、高度なプロジェクト設定を開きます。

    適切に設定されていれば、上記の手順で作成された設定が参照されます。

  8. ジョブを送信するには、ジョブタイルメニューから開始を選択します。

    数分以内に新しいプロジェクトが作成されます。

    • インポート時に、プロジェクトテンプレートからプロバイダが割り当てられ、AEMジョブアイテムのステータスが翻訳用にコミット済みに設定されます。

    • プロバイダによってジョブが受け入れられると、AEMジョブアイテムのステータスが翻訳中に変更されます。

    • ジョブが削除またはキャンセルされると、AEMジョブアイテムのステータスがキャンセル済みに変更されます。

    ヒント

    Adobe Experience Managerは、Webコンソールからアクセスする翻訳プラットフォーム設定で構成されたスケジュールで、ジョブステータスの更新をポーリングします。

    スケジューラCronプロパティを頻繁に実行するように設定すると(例:0 0/5 * * * ? *は5分ごとに翻訳ジョブステータスの更新をトリガーします)。

    プロジェクト詳細ページを更新すると、プルが強制的に実行されます。

  9. Phraseで、プロジェクトジョブを翻訳し、そのステータスを完了に設定します。完了すると、ジョブはAEMにインポートし直されます。

  10. 拒否された場合、ジョブの最初のワークフローステップがメール送信済みに設定され、残りのワークフローステップが新規に設定されます。

  11. AEMジョブアイテムが受け入れられると、プラグイン設定で構成されている通り、ジョブステータスが納品済みに更新されます。

参照パネルを使用した翻訳プロジェクトの作成に関する詳細については、Adobeドキュメントを参照してください。

その他

カスタム言語マッピング

オンプレミスAEM

Adobe Experience Managerの言語をPhraseの異なる言語(例:zhからzh_tw)にマッピングするには、以下の手順に従ってください。

このマッピングは、原文言語と訳文言語の両方に適用されます。

  1. CRXDE(/crx/de/index.jsp)を開きます。

  2. /apps/memsource-connector/language-mapping/フォルダを参照します。

  3. 新しいノードを作成します。

  4. Adobe Experience Managerの言語コードを名前として使用し(例:zh)、タイプ: nt:unstructuredを維持します。

  5. プロパティを追加します:

    • 名前: memsource言語

    • タイプ: 文字列

    • : 言語コード (例: zh_tw)

  6. すべて保存をクリックします。

マッピングされていない言語コードはそのまま送信されます。

AEM as a Cloud Service

AEM Cloud Servicesで言語マッピングを追加するには、以下の手順に従います。

  1. /conf/aem-memsource-plugin/language-mapping/フォルダに.content.xmlファイルを作成します。

  2. 作成したファイルを開き、以下をコピーして貼り付けます。

    <?xml version="1.0" encoding="UTF-8"?>
    <jcr:root xmlns:sling="http://sling.apache.org/jcr/sling/1.0" xmlns:jcr="http://www.jcp.org/jcr/1.0"
        jcr:primaryType="sling:Folder"/>
  3. /conf/aem-memsource-plugin/language-mapping/zh-cnフォルダに.content.xmlファイルを作成します。

  4. 作成したファイルを開き、以下をコピーして貼り付けます。

    <?xml version="1.0" encoding="UTF-8"?>
    <jcr:root xmlns:jcr="http://www.jcp.org/jcr/1.0"
              jcr:primaryType="nt:unstructured"
              memsourceLanguage="zh_cn">
    </jcr:root>
  5. ui.content/src/main/content/コンテンツ/META-INF/vault/filter.xmlにあるfilter.xmlファイルに、前の手順で作成したパスを追加します。

    <?xml version="1.0" encoding="UTF-8"?>
    <workspaceFilter version="1.0">
    ...
        <filter root="/conf/aem-memsource-plugin" mode="update"/>
        <filter root="/conf/aem-memsource-plugin/language-mapping" mode="update"/>
    </workspaceFilter>

プロジェクトID

翻訳ジョブが送信されると、プロジェクトIDとUIDが/content/projects/project-name/jcr:content/ダッシュボード/gadgets/translationjobPROPERTY_MEMSOURCE_PROJECT_IDおよびPROPERTY_MEMSOURCE_PROJECT_UIDプロパティとして保存されます。

これらのIDを使用して、AEM環境での表示やAPIでのプラグイン機能の拡張を行います。

AEMのトラブルシューティング

問題

原因

ソリューション

Cloud Managerが、/content/projects配下のtranslationObjectIDに対するクエリについて「インデックスなしのクエリ」アラートを報告します。

Phrase AEMコネクターは、実行時に割り当てられたtranslationObjectIDによって翻訳ジョブノードを特定します。この識別子は既存のリポジトリプロパティとして存在しないため、AEM as a Cloud Serviceは事前にインデックスを作成できず、フルトラバーサルにフォールバックします。これがCloud Managerによってフラグ付けされます。

/content/projectsをスコープとし、translationObjectIDにプロパティインデックスを持つ、タイプoak:QueryIndexDefinitionのカスタムOak/Luceneインデックス定義を追加します。インデックス定義は実行時に作成するのではなくコードパイプラインを通じてデプロイし、本番環境へのデプロイ前に非本番環境で検証してください。AEMインスタンス内のプロジェクトフォルダー構造にインデックスの範囲を限定し、可能な場合は/content/projects全体ではなく特定のプロジェクトフォルダーに絞り込んでください。インデックスの範囲が広すぎると、パフォーマンスに影響を与える可能性があるためです。デプロイ後、再インデックス作成が完了するとAEMはインデックス定義のreindexプロパティをfalseに設定します。これにより、再インデックス作成がエラーなしで終了し、それ以上の操作が不要であることが確認されます。

この記事は役に立ちましたか?

Sorry about that! In what way was it not helpful?

The article didn’t address my problem.
I couldn’t understand the article.
The feature doesn’t do what I need.
Other reason.

Note that feedback is provided anonymously so we aren't able to reply to questions.
If you'd like to ask a question, submit a request to our Support team.
Thank you for your feedback.