統合機能

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. ユーザー名とパスワードを入力します。

  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. 保存をクリックします。

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

備考

一部の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)

    すべての設定が「従来型クラウドサービス」>「AEM用Memsource翻訳プラグイン」から消去されます。

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

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

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

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

AEM as a Cloud Service

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

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

    <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サービスの設定コンテナを作成します(例:人手翻訳用に1つの設定、機械翻訳専用に別の設定を作成)。

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

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

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

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

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

    接続をクリックします。

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

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

翻訳統合機能の設定

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

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

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

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

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

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

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

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

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

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

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

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

コンテンツを送信して翻訳

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

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

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

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

  3. 訳文言語を選択し、必要に応じて Select all sub-pages のチェックを外します。

  4. Create Multi-language Translation Project を選択します。

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

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

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

  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に更新されます。

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言語コードを名前(例:zh)として使用し、タイプ: NT:unstructuredを維持します。

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

    • 名前: memsourceLanguage

    • タイプ: 文字列

    • : 言語コード(例: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/dashboard/gadgets/translationjobPROPERTY_MEMSOURCE_PROJECT_IDおよびPROPERTY_MEMSOURCE_PROJECT_UIDプロパティとして保存されます。

プラグインの機能を拡張するために、AEM環境またはAPIでの表示にこれらのIDを使用します。

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

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.