統合機能

Adobe Experience Manager - AEM (TMS)

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

利用可能対象

  • エンタープライズプラン

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

利用可能対象

  • 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エディタおよびCATデスクトップエディタの両方で、原文または翻訳文のリアルタイムプレビューを提供します。

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

Phraseの要件:

  • オンプレミス環境にアクセスするには、企業ファイアウォールを通過する必要があります。

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

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

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

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

備考

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

削除されるタグの例として、FORM、IFRAME、SCRIPT、SVG、VIDEO、EMBED、OBJECT、またはbackground-image CSSプロパティなどがあります。

Phrase TMS設定

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

ヒント

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

  1. 設定Setup_gear.pngページから、連携セクションまでスクロールします。

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

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

  3. 新しいコネクタをクリックします。

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

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

  5. 必要に応じて、セキュアな接続を強制を有効にします。

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

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

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

  7. ライブプレビューのユーザー名とライブプレビューのパスワードを入力します。

  8. ページ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: (''))は書き換えられます。

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

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

備考

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

削除されるタグの例として、FORM、IFRAME、SCRIPT、SVG、VIDEO、EMBED、OBJECT、またはbackground-image CSSプロパティなどがあります。

翻訳ワークフローの設定

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

  • Access and Securityで、Allow loading of external content in Phrase CAT editorオプションを有効にします。

レガシーバージョンを使用している場合は、serviceとsubmitter portalを作成および検証する必要があります。設定を検証するには、以下の手順に従います。

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

  2. JobタイルメニューからExportを選択します。

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

  4. Phraseで、連携に使用されるSubmitter portalsに移動し、リストされているURLを開きます。

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

  6. 新しいプロジェクトが、設定したプロジェクトテンプレートから作成されたことを確認します。

AEM設定

プラグインのインストール

PhraseのPhrase Ecosystemページから、Downloadボタンを使用して最新のプラグインパッケージをダウンロードします。このプラグインは、購入した組織のみが利用できます。

オンプレミスAEM

  1. 6.2または6.3から6.4以降に移行する場合は、Classic UI管理ツール(/miscadmin#/etc/cloudservices/memsource-translation)から、すべてのレガシーCloud Services設定を削除してください。

    すべての設定が「Legacy Cloud Services > Memsource Translation Plugin for AEM」から表示されなくなります。

  2. ToolsのDeploymentで、Packagesに移動します。

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

  4. パッケージをアップロードを選択し、インストールファイルをアップロードしてください。

  5. 強制アップロードにチェックを入れて送信してください。

AEM as a Cloud Service

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

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

    repositories {
    
      リポジトリ
        <id>project.local</id>
        <name>プロジェクト</name>
        <url>file:${maven.multiModuleProjectDirectory}/repository</url>
      リポジトリ
    
    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 設定に埋め込みブロックを追加します:

    プラグイン
      <groupId>org.apache.jackrabbit</groupId>
      <artifactId>filevault-package-maven-plugin</artifactId>
      <extensions>true</extensions>
      設定
      <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つの設定が必要です。

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

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

    例:

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

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

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

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

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

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

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

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

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

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

    接続をクリックしてください。

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

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

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

      注意

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

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

    • 解析を生成する 

      有効にすると、翻訳ジョブが送信された後、ファイルがインポートされると自動的に分析が生成されます。分析は、プロジェクトテンプレートの設定に関係なく、常に 言語別 に生成されます。 

    • 見積を生成します。 

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

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

翻訳統合をセットアップする

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

  1. 「ツール」で クラウドサービス に移動し、翻訳クラウドサービス をクリックします。

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

    備考

    confの下に設定を作成します。/libsの下にあるエントリは、Adobeの読み取り専用デフォルトです。

    • Translate Component StringsとTranslate Tagsのチェックが外れていることを確認します。

    • Translate page assetsをDo not translateに設定します。

    • Assetsタブで、Translation WorkflowをDo not translateに設定します。

  3. プロジェクトに翻訳不可能なアセットや参照資料がまだ含まれている場合は、Phraseで直接マークして削除します。

サイトに翻訳統合を適用する

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

翻訳統合を適用するには:

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

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

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

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

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

  1. Sitesビューから、ページに移動して選択し、References Panelを開きます。

  2. Language Copiesをクリックし、レールの下部にあるCreate & Translateセクションを展開します。

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

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

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

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

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

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

    適切に構成されている場合、上記の手順で作成された構成が参照されます。

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

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

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

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

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

    ヒント

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

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

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

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

  10. 拒否された場合、ジョブの最初のワークフローステップはEmailedに設定され、残りのワークフローステップはNewに設定されます。

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

References Panelを使用した翻訳プロジェクトの作成に関する詳細は、Adobe documentationを参照してください。

その他

カスタム言語マッピング

オンプレミス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の言語コードをNameとして使用し(例:zh)、Type: nt:unstructuredを維持します。

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

    • Name:memsourceLanguage

    • 種類文字列

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

  6. Save Allをクリックします。

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

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/dashboard/gadgets/translationjobにPROPERTY_MEMSOURCE_PROJECT_IDおよびPROPERTY_MEMSOURCE_PROJECT_UIDプロパティとして保存されます。

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

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

問題

原因

ソリューション

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

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

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

Mavenビルドが、filevault-package-maven-pluginの検証エラー(「Package of type ‘APPLICATION’ is not supposed to contain any sub packages」や「Package of type ‘APPLICATION’ is not supposed to contain OSGi bundles or configurations」など)で失敗します。

プラグインバージョン3.1.18.6以前では、OSGiバンドルと設定ファイルがアプリケーションタイプのパッケージ内にパッケージ化されており、AEM as a Cloud Serviceの検証で拒否されます。

プラグインバージョン3.1.18.7以降にアップデートしてください。回避策として追加した場合は、Maven設定からskipSubPackageValidationを削除してください。

Translation Cloud Servicesの/libs下のリストにフレーズがありません。

/libs下の項目は、読み取り専用のAdobeデフォルトです。プラグインは、設定を/conf、/apps/aem-memsource-pluginおよび/var/memsource-tmsの下に保存します。

confの下に翻訳統合設定を作成してください。サーバー接続は、/conf/global/settings/cloudconfigs/translation/memsource-translationに個別に保存されます。

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

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.