統合機能

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ページから、Integrationsセクションまでスクロールします。

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

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

  3. New connectorをクリックします。

    Create connectorページが開きます。

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

  5. Hostを入力します。

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

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

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

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

  7. ページHTMLに含まれるリンクを変更するには、URL rewrite rule を regex で指定します。

    例:

    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. Integrationsページから、削除するコネクタを選択します。

  2. Deleteをクリックします。

    Delete connectorウィンドウが開きます。

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

    コネクタが削除され、コネクタのリストが表示されます。

備考

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

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

備考

一部の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. ジョブタイルメニューからエクスポートを選択します。

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

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

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

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

AEM設定

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

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

オンプレミスAEM

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

    レガシーCloud Services > Memsource Translation Plugin for AEMからすべての設定が消去されます。

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

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

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

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

AEM as a Cloud Service

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

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

    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つの設定が必要です。

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

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

    例:

    重要度の高いコンテンツには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. 「ツール」でクラウドサービスに移動し、Translation Cloud Servicesをクリックします。

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

    • コンポーネント文字列を翻訳とタグを翻訳のチェックが外れていることを確認します。

    • ページアセットを翻訳を翻訳しないに設定します。

    • アセットタブで、翻訳ワークフローを翻訳しないに設定します。

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

サイトへの翻訳統合の適用

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

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

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

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

翻訳用コンテンツを送信

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

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

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

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

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

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

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

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

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

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

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

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

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

    • インポート時に、プロジェクトテンプレートからプロバイダーが割り当てられ、AEMジョブアイテムのステータスがCommitted for translationに設定されます。

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

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

    ヒント

    Adobe Experience Managerは、Web ConsoleからアクセスするTranslation Platform Configurationで構成されたスケジュールに従って、ジョブステータスの更新をポーリングします。

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

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

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

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

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

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

その他

カスタム言語マッピング

オンプレミスAEM

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

このマッピングは、ソース言語とターゲット言語の両方に適用されます。

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

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

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

  4. NameとしてAdobe Experience Manager言語コード(例: zh)を使用し、Type: nt:unstructuredを維持します。

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

    • Name: memsourceLanguage

    • タイプ文字列

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

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

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

AEM as a Cloud Service

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

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

  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>

Project IDs

翻訳ジョブが送信されると、Project 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で警告される原因です。

oak:QueryIndexDefinitionタイプのカスタムOak/Luceneインデックス定義を追加し、/content/projectsにスコープを設定して、translationObjectIDにプロパティインデックスを作成してください。インデックス定義は実行時に作成するのではなく、コードパイプラインを通じてデプロイし、本番環境にデプロイする前に非本番環境で検証してください。インデックスのスコープは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.