Show Menu
トピック×

Adobe Experience Manager デスクトップアプリケーションのトラブルシューティング

Adobe Experience Manager(AEM)デスクトップアプリケーションは、リモート Adobe Experience Manager デプロイメントのデジタルアセット管理(DAM)リポジトリに接続します。デスクトップアプリケーションは、ユーザーのコンピューター上でリポジトリ情報と検索結果を取得し、ファイルやフォルダーをダウンロードおよびアップロードします。また、AEM Assets ユーザーインターフェイスとの競合を管理する機能も備えています。
デスクトップアプリケーションのトラブルシューティング、ベストプラクティス、制限事項について説明します。

ベストプラクティス

一般的な問題の回避やトラブルシューティングを図るには、次のベストプラクティスに従います。
  • デスクトップアプリケーションの動作の仕組みを理解する :使用を開始する前に、少し時間を割いてデスクトップアプリケーションの動作の仕組みを理解してください。Adobe Experience Manager の Web インターフェイスとデスクトップアプリケーションの連携、リポジトリマッピング、アセットキャッシング、ローカルでの保存、バックグラウンドでのアップロードについて把握します。 動作の仕組み を参照してください。
  • サポートされていない文字をフォルダー名に使用しない :フォルダーの作成やアップロードの際には、空白や無効な文字を使用しないでください。該当する文字のリストについては、 Adobe Experience Manager Assets でのフォルダーの作成 を参照してください。Adobe Experience Manager の一部の使用例では、サポートされていない文字がフォルダー名に使用されていた場合、影響を受ける可能性があります。
  • 競合を回避するためのベストプラクティス :複数のアセットに対する共同作業で競合が発生する可能性を避けるには、 編集上の競合の回避 を参照してください。
  • 大きな階層フォルダーにはフォルダーアップロードを使用する :Assets Web インターフェイスなどの方法を使用するのではなく、Adobe Experience Manager デスクトップアプリケーションを使用して大きなフォルダーをアップロードしてください。デスクトップアプリケーションでは、ログ記録と監視をおこないながら、アセットをバックグラウンドでアップロードします。 アセットの一括アップロード を参照してください。
  • 最新バージョンを使用する :常にデスクトップアプリケーションの最新バージョンを使用します。デスクトップアプリケーションの新しいバージョンをインストールする場合や Adobe Experience Manager の新しいバージョンにアップグレードする場合は、その前に必ず互換性を確認してください。 リリースノート を参照してください。
  • 同じドライブ文字を使用する :組織全体で同じドライブ文字を使用して、Adobe Experience Manager DAM にマッピングします。他のユーザーが配置したアセットを表示するには、同じパスを使用する必要があります。同じドライブ文字を使用することで、DAM アセットのパスが一定になります。別のユーザーが異なるドライブ文字を使用した場合でも、アセットはそのまま残り、削除されません。
  • ネットワークに注意を払う :Adobe Experience Manager デスクトップアプリケーションのパフォーマンスには、ネットワークのパフォーマンスが重要です。ファイル転送や一括操作に対する応答が遅くなった場合は、大量のネットワークトラフィックを発生させる可能性のある機能やアプリを無効にしてください。
  • デスクトップアプリケーションでサポートされていない使用例 :Assets の移行(計画ツールなどのツールが必要)や負荷の高い DAM 操作(大きなフォルダーの移動、大規模なアップロード、高度なメタデータ検索を使用したファイル検索など)にはデスクトップアプリケーションを使用しません。また、同期クライアントとしても使用しないでください(Microsoft OneDrive や Adobe Creative Cloud デスクトップ同期などの同期クライアントとは設計原則や使用パターンが異なります)。
  • タイムアウト :現在、デスクトップアプリケーションには、一定時間の経過後に Adobe Experience Manager サーバーとデスクトップアプリケーションの間の接続を切断するための設定可能なタイムアウト値がありません。サイズの大きいアセットをアップロードする際に、しばらくして接続がタイムアウトした場合、アプリケーションはアップロードタイムアウトを長くして、アセットのアップロードを数回再試行します。デフォルトのタイムアウト設定を変更するお勧めの方法はありません。

トラブルシューティング方法

デスクトップアプリケーションの問題をトラブルシューティングするには、以下の情報を把握しておいてください。また、それにより、サポートを依頼する場合にも、アドビカスタマーケアに問題を伝えやすくなります。

ログファイルの場所

Experience Manager デスクトップアプリケーションは、オペレーティングシステムに応じて次の場所にログファイルを保存します。
Windows の場合: %LocalAppData%\Adobe\AssetsCompanion\Logs
Mac の場合: ~/Library/Logs/Adobe\ Experience\ Manager\ Desktop
多数のアセットをアップロードする際に一部のファイルをアップロードできなかった場合は、 backend.log ファイルを参照して、アップロードに失敗したファイルを特定します。
サポートの要請またはチケットに関してAdobeカスタマーケアと連絡を取る際、ログファイルを共有して、カスタマーケアチームがこの問題を理解するのに役立てるように依頼することができます。 Logs フォルダー全体をアーカイブして、カスタマーケアの担当者と共有します。

ログファイル内の詳細レベルの変更

ログファイル内の詳細レベルを変更するには:
  1. アプリケーションが実行されていないことを確認します。
  2. Windowsシステムの場合:
    1. コマンドウィンドウを開きます。
    2. 次のコマンドを実行して、 Adobe Experience Manager デスクトップアプリケーションを起動します。
    set AEM_DESKTOP_LOG_LEVEL=DEBUG&"C:\Program Files\Adobe\Adobe Experience Manager Desktop.exe
    
    
    Macシステムの場合:
    1. ターミナルウィンドウを開きます。
    2. 次のコマンドを実行して、 Adobe Experience Manager デスクトップアプリケーションを起動します。
    AEM_DESKTOP_LOG_LEVEL=DEBUG open /Applications/Adobe\ Experience\ Manager\ Desktop.app
    
    
有効なログレベルは、DEBUG、INFO、WARN、ERRORです。 ログの詳細度はDEBUGで最も高く、ERRORで最も低くなります。

デバッグモードの有効化

トラブルシューティングをおこなう場合、デバッグモードを有効にして、ログに詳細情報を取得できます。
有効なログレベルは、DEBUG、INFO、WARN、ERRORです。 ログの詳細度はDEBUGで最も高く、ERRORで最も低くなります。
Macでデバッグモードでアプリを使用するには:
  1. ターミナルウィンドウまたはコマンドプロンプトを開きます。
  2. 次のコマンドを実行して、 Experience Manager デスクトップアプリケーションを起動します。
    AEM_DESKTOP_LOG_LEVEL=DEBUG open /Applications/Adobe\ Experience\ Manager\ Desktop.app .
Windowsでデバッグモードを有効にするには:
  1. コマンドウィンドウを開きます。
  2. 次のコマンドを実行して、 Experience Manager デスクトップアプリケーションを起動します。
AEM_DESKTOP_LOG_LEVEL=DEBUG&"C:\Program Files\Adobe\Adobe Experience Manager Desktop.exe .

キャッシュのクリア

以下の手順を実行します。
  1. アプリケーションを開始し、AEMインスタンスに接続します。
  2. 右上隅の「楕円」をクリックし、を選択して、アプリケーションの環境設定を開き Preferencesます。
  3. を表示しているエントリを見つけ Current Cache Sizeます。 この要素の横にあるごみ箱アイコンをクリックします。
キャッシュを手動でクリアするには、次の手順に従います。
これは潜在的に破壊的な操作です。 にアップロードされていないローカルファイルの変更がある場合 Adobe Experience Manager、これらの変更は処理を続行すると失われます。
キャッシュは、アプリケーションの環境設定にあるアプリケーションのキャッシュディレクトリを削除することでクリアされます。
  1. アプリケーションを起動します。
  2. 右上隅の「楕円」を選択し、を選択して、アプリケーションの環境設定を開き Preferencesます。
  3. 値をメモしてお Cache Directory きます。
    このディレクトリには、エンコードされた Adobe Experience Manager エンドポイントにちなんだ名前のサブディレクトリがあります。 The names is an encoded version of the targeted Adobe Experience Manager URL. For example, if the application is targeting localhost:4502 then the directory name will be localhost_4502 .
To clear the cache, delete the desired Encoded Adobe Experience Manager Endpoint directory. または、環境設定で指定したディレクトリ全体を削除すると、アプリケーションで使用されているすべてのインスタンスのキャッシュがクリアされます。
Clearing Adobe Experience Manager desktop app's cache is a preliminary troubleshooting task that can resolve several issues. キャッシュのクリアは、アプリの環境設定からおこないます。 環境設定の指定 を参照してください。キャッシュフォルダーのデフォルトの場所は次のとおりです。

Know the Adobe Experience Manager desktop app version

バージョン番号を確認するには:
  1. アプリケーションを起動します。
  2. 右上隅の「三点リーダー」をクリックし、カーソルを合わ Helpせて、をクリックし Aboutます。
    この画面には、バージョン番号が表示されます。

配置されたアセットが表示されない

サポートファイル(INDD ファイルなど)に自分自身または他のクリエイティブプロフェッショナルが配置したアセットが表示されない場合は、次の点を確認してください。
  • サーバーへの接続。信頼性の低いネットワーク接続では、アセットのダウンロードが停止するおそれがあります。
  • ファイルサイズ。サイズの大きいアセットは、ダウンロードと表示に時間がかかります。
  • ドライブ文字の一貫性。AEM DAM を別のドライブ文字にマッピングしている間に、自分自身または他の共同利用者がアセットを配置した場合、配置されたアセットは表示されません。
  • 権限。配置されたアセットを取得する権限があるかどうかを確認するには、AEM 管理者に問い合わせてください。

デスクトップアプリのユーザーインターフェイス上のファイルに対する編集が、 Adobe Experience Manager すぐに反映されません

Adobe Experience Manager デスクトップアプリケーションでは、ユーザーがファイルに対するすべての編集を完了するタイミングを決定できます。 ファイルのサイズと複雑さに応じて、新しいバージョンのファイルをに転送し直すのにかなりの時間がかかり Adobe Experience Managerます。 ファイルの編集が完了し、自動的にアップロードされるのを推測する代わりに、ファイルが前後に転送される回数を最小限に抑えるためのアプリケーション呼び出しのデザイン。 ユーザは、ファイルの変更をアップロードすることを選択して、にファイルの転送を開始す Adobe Experience Manager るようお勧めします。

macOS でアップグレードする際の問題

macOS で AEM デスクトップアプリケーションをアップグレードするときに問題が発生することがあります。これは、AEM デスクトップアプリケーションの古いシステムフォルダーによって、AEM デスクトップアプリケーションの新しいバージョンが正しく読み込まれなくなるからです。この問題を修正するには、以下のフォルダーおよびファイルを手動で削除します。
以下の手順を実行する前に、 Adobe Experience Manager Desktop アプリケーションを macOS のアプリケーションフォルダーからゴミ箱にドラッグします。次に、ターミナルを開き、以下のコマンドを実行します。パスワードを求められたら入力します。
sudo rm -rf ~/Library/Application\ Support/com.adobe.aem.desktop
sudo rm -rf ~/Library/Preferences/com.adobe.aem.desktop.plist
sudo rm -rf ~/Library/Logs/Adobe\ Experience\ Manager\ Desktop

sudo find /var/folders -type d -name "com.adobe.aem.desktop" | xargs rm -rf
sudo find /var/folders -type d -name "com.adobe.aem.desktop.finderintegration-plugin" | xargs rm -rf

ファイルをアップロードできない

デスクトップアプリケーションを AEM 6.5.1 以降で使用している場合は、S3 または Azure コネクタをバージョン 1.10.4 以降にアップグレードします。これで、 OAK-8599 に関連するファイルアップロード失敗の問題が解決されます。 インストール手順 を参照してください。

Experience Manager デスクトップアプリの接続の問題

一般的な接続の問題が発生している場合は、次に、デスクトップアプリの動作に関する詳細情報を入手する方法を示し Experience Manager ます。
要求ログの確認
Experience Manager デスクトップアプリでは、送信されたすべての要求と各要求の応答コードが専用のログファイルに記録されます。
  1. これら request.log の要求を表示するには、アプリケーションのログディレクトリを開きます。
  2. ログ内の各行は、リクエストまたは応答を表します。 リクエストには、リクエストされたURLの後に続く > 文字が含まれます。 応答には、 < 文字の後に応答コードと要求されたURLが続きます。 各行のGUIDを使用して、リクエストと応答を照合できます。
アプリケーションの埋め込みブラウザーによって読み込まれたリクエストの確認
アプリケーションのリクエストの大部分は、リクエストログに記録されます。 ただし、役立つ情報がここにない場合は、アプリケーションの埋め込みブラウザーから送信されるリクエストを調べると役立ちます。 これらのリクエストの表示方法については、 SAML節 を参照してください。

SAMLログイン認証が機能しません

デスクトッ Experience Manager プアプリがSSO対応(SAML) Adobe Experience Manager インスタンスに接続しない場合は、この節を参照してトラブルシューティングを行ってください。 SSOプロセスは様々で複雑な場合もあります。これらの接続に対応するために、アプリケーションの設計が最適です。 ただし、一部の設定では、追加のトラブルシューティングが必要です。
SAMLプロセスが最初に要求されたパスにリダイレクトされない場合や、最後にリダイレクトされるのは、 Adobe Experience Manager デスクトップアプリで設定されたものとは異なるホストに対する場合があります。 この問題が発生していないことを確認するには:
  1. Web ブラウザーを開きます。
  2. アドレスバー <AEM host>/content/dam.json にURLを入力します。
    例えば、 <AEM host> ターゲット Adobe Experience Manager インスタンスで置き換え http://localhost:4502/content/dam.json ます。
  3. Log in to the Adobe Experience Manager instance.
  4. ログインが完了したら、アドレスバーでブラウザーの現在のアドレスを確認します。 最初に入力したURLと完全に一致する必要があります。
  5. また、前のすべてが、 /content/dam.json デスクトップアプリの設定で設定されたターゲット Adobe Experience Manager​Adobe Experience Manager 値と一致していることを確認してください。
上記の手順に従ってSAMLログインプロセスは正常に機能しますが、ユーザーはログインできません
ログインプロセスを表示する Adobe Experience Manager デスクトップアプリ内のウィンドウは、単にターゲットインスタンスのWebユーザーインターフェイスを表示するWebブラウザー Adobe Experience Manager です。
  • MacバージョンではWebViewが使用され ます
  • Windowsバージョンは、ChromiumベースのCefSharpを使用し ます
SAMLプロセスでこれらのブラウザーがサポートされていることを確認します。
さらにトラブルシューティングを行うために、ブラウザーが読み込もうとしている正確なURLを表示することができます。 次の情報を表示するには:
  1. ログイン試行を再現します。
  2. アプリケーションの ログディレクトリ に移動します。
  3. Windows の場合
    1. 「aemcompanionlog.txt」を開きます。
    2. 「ログインブラウザーアドレスの変更先」で始まるメッセージを検索します。 これらのエントリには、アプリケーションが読み込んだURLも含まれます。
    Macの場合:
    1. com.adobe.aem.desktop-nnnnnnnn-nnnnnn.log の場合、 n は、最新のファイル名のいずれかの数字に置き換えられます。
    2. 「loaded frame」で始まるメッセージを検索します。 これらのエントリには、アプリケーションが読み込んだURLも含まれます。
読み込まれるURLシーケンスを調べると、SAMLの最後のトラブルシューティングで何が悪いかを判断するのに役立ちます。

SSL 設定の問題

AEM デスクトップアプリケーションが HTTP 通信に使用するライブラリは SSL を厳格に適用します。ブラウザーでは成功する接続が、AEM デスクトップアプリケーションでは失敗することがあります。SSL を適切に設定するには、不足している中間証明書を Apache にインストールします。 中間 CA の証明書を Apache にインストールする を参照してください。
AEM DesktopがHTTP通信に使用するライブラリでは、厳密なSSLの強制が使用されます。 そのため、ブラウザーを通じて成功するSSL接続が、デスクトップアプリで失敗する場合があり Adobe Experience Manager ます。 これは、SSLの正しい設定を推奨し、セキュリティを強化するので、良いことですが、アプリケーションが接続できない場合に不満が生じる可能性があるからです。
この場合の推奨されるアプローチは、ツールを使用してサーバーのSSL証明書を分析し、問題を識別して修正できるようにすることです。 URLの提供時にサーバーの証明書を検査するWebサイトがあります。
一時的な対策として、デスクトップアプリで厳密なSSLの強制を無効にすることがで Adobe Experience Manager きます。 SSLの設定が正しくない原因を隠すことでセキュリティを低減できるので、長期的なソリューションとしては推奨されません。 厳密な強制を無効にするには:
  1. 任意のエディターを使用して、アプリケーションのJavaScript設定ファイルを編集します。このファイルは、(デフォルトでは)次の場所にあります(オペレーティングシステムに応じて)。
    Mac の場合: /Applications/Adobe Experience Manager Desktop.app/Contents/Resources/javascript/lib-smb/config.json
    Windows の場合: C:\Program Files (x86)\Adobe\Adobe Experience Manager Desktop\javascript\config.json
  2. ファイル内の次のセクションを探します。
    ...
    "assetRepository": {
        "options": {
    ...
    
    
  3. 次の手順を追加して、セクションを変更 "strictSSL": false します。
    ...
    "assetRepository": {
        "options": {
            "strictSSL": false,
    ...
    
    
  4. ファイルを保存し、デスクトップ Adobe Experience Manager アプリケーションを再起動します。

デスクトップアプリケーションが応答しない

まれに、デスクトップアプリケーションが応答しなくなって、白い画面だけが表示されたり、インターフェイスにオプションが表示されずにインターフェイスの下部にエラーが表示されたりする場合があります。このような場合には、以下をこの順に試します。
  • デスクトップアプリケーションインターフェイスを右クリックし、「 Refresh 」を選択します。
  • アプリケーションを終了して、再度開きます。
どちらの方法でも、DAM のルートフォルダーがデスクトップアプリケーションの初期状態として表示されます。

デスクトップアプリに関するその他のヘルプが必要です Experience Manager

次の情報を含むJiraチケットを作成します。
  • DAM - Companion App として使用し Componentます。
  • この問題を再現する詳細な手順については、を参照してくだ Descriptionさい。
  • 問題の再生中に取り込まれたデバッグレベルのログ。
  • 対象 AEM バージョン.
  • オペレーティングシステムのバージョン。
  • Adobe Experience Manager デスクトップアプリのバージョン。 アプリのバージョンを確認するには、デスクトップアプリのバージョン の検索を参照してください