Creative Cloud デスクトップ版を終了します。
ここでは、Adobe Asset Link の使用中に発生した問題を解決するためのトラブルシューティングについて説明します。
Adobe Asset Link パネルの概要
Adobe Asset Link は、Creative Cloud アプリ(Photoshop、Illustrator、InDesign)に拡張機能としてインストールされます。インストールと設定が完了したら、Illustrator と InDesign では ウィンドウ/拡張機能/Adobe Asset Link から、Photoshop では ウィンドウ/拡張機能(レガシー)/Adobe Asset Link からパネルを開きます。このパネルを使用して、Adobe Experience Manager Assets に保存されているデジタルアセットにアクセス、使用、編集を行い、新しいアセットをアップロードします。Adobe Asset Link を使用したアセット管理について学習します。
参照中にアセットのサムネイルが表示されないが、アセットのプレビューは表示できる場合は、管理者に Adobe Experience Manager Managed Services(AMS)を最新のサービスパックで更新するよう依頼してください。
Adobe Asset Link パネルにアクセスできない場合は、管理者にトラブルシューティングの指導を求めてください。
トラブルシューティングに着手する前に
Adobe Asset Link パネルを使用できない場合は、特定のエラーのトラブルシューティングを行う前に、以下のチェックを完了してください:
- Adobe Asset Link をインストールまたは再インストールする前に、アプリキャッシュを更新するため Creative Cloud アプリを閉じてください。
- Adobe Asset Link が com.adobe.assetlink フォルダーにインストールされていることを確認してください:macOS /Library/Application Support/Adobe/CEP/extensions、Windows C:\Program Files (x86)\Common Files\Adobe\CEP\extensions。問題がある場合は、com.adobe.assetlink フォルダーを削除して既存のバージョンを削除してから、最新バージョンをインストールしてください。
- assetlink-settings.json ファイルが以下の場所にあることを確認してください:macOS /Users/<username>/Library/Application Support/Adobe/CEP/extensions、Windows C:\Users\<username>\AppData\Roaming\Adobe\CEP\extensions。
- Creative Cloud デスクトップアプリケーションで Enterprise ID または Federated ID でサインインしていることを確認してください。
- Creative Cloud デスクトップアプリケーションでファイル同期が有効になっていることを確認してください。
- アクティビティモニター(macOS)またはタスクマネージャー(Windows)を使用して、CoreSync という名前のプロセスが実行されていることを確認してください。
管理者の場合は、以下も確認してください:
- すべての IMS 設定が正しく行われています。
- Adobe Admin Console で、ユーザーの法人、エンタープライズ版、または Federated ID が Experience Manager サーバーで設定されたユーザーグループに追加されます。
- Experience Manager サーバーで設定された IMS ユーザーグループは、Experience Manager の dam-users グループの一部です。
S3 をデータストアとしてデプロイした Experience Manager 6.5.5 以降で Adobe Asset Link を使用する場合は、Platform API が機能していることを確認してください。https://<server>:<port>/platform/content/dam にアクセスして接続の問題を確認してください。Platform API が機能している場合、応答は上位レベルの DAM オブジェクトの JSON 表現になります。不具合により 500 エラーが返され、Adobe Asset Link の接続が失敗します。これを解決するには、S3 データストアコネクターをバージョン 1.10.12 以降にアップグレードしてください。
Apple M1 デバイス上の Illustrator と InDesign で Adobe Asset Link との互換性を確保するには、Adobe Asset Link を最新バージョンにアップグレードしてください。Adobe Asset Link は、Rosetta エミュレーションモードで M1 デバイス上の Photoshop をサポートしています。Apple シリコンで Photoshop を実行する方法については、Photoshop for Apple silicon を参照してください。
エラーシナリオ
以下は、Adobe Asset Link パネルで発生する可能性があるエラーと、それらを解決するための手順です。
エラー
Adobe Extension Manager コマンドラインツール(ExManCmd)を使用してエクステンションをインストールする際に、Abort trap: 6 エラーが表示されます。
理由
Adobe Asset Link が macOS にインストールできません。 Windows の場合は、エラーが表示されずにインストールに失敗します。
この問題を解決するには、次の操作を行います。
次の場所から ExMan.db を削除します。
macOS の場合:/Library/Application Support/Adobe/Extension Manager CC/Configuration/DB
Windows の場合:C:\ProgramData\Adobe\Extension Manager CC\Configuration\DB
Creative Cloud デスクトップ版を再起動し、手順 1 で使用したのと同じ資格情報を使ってでログインします。
Adobe Asset Link エクステンションを含むパッケージを再インストールします。 Adobe Asset Link パネルがインストールされます。
エラー
|
このサービスにアクセスするには、Enterprise ID または Federated ID を使用して Creative Cloud アカウントにログインしてください。 Creative Cloud エンタープライズ版アカウントをお持ちでない場合は、IT 管理者に問い合わせてください。 |
理由
このエラーは、Adobe Creative Cloud からログアウトした場合、または Adobe Asset Link パネルで ID にアクセスできない場合に表示されます。
このエラーを解決するには、次の手順を実行します。
Creative Cloud アプリケーションにログインしていることを確認します。
使用している Creative Cloud アプリを終了して再起動します。
アドビの web サイトを開くことができるかどうかを確認します。
エラー
理由
このエラーは、Adobe ID を使用してログインした状態で、Adobe Asset Link にアクセスしようとすると表示されます。 Creative Cloud エンタープライズ版アカウントをお持ちでない場合は、IT 管理者にお問い合わせください。
エラー
|
このサービスへのアクセス権限がない場合は、IT 管理者に連絡してアクセス権限を取得してください。 |
理由
このエラーは、Experience Manager サーバーへの必要なアクセス権限がない場合に表示されます。
このエラーを解決するには、IT 管理者に連絡して Experience Manager サーバーが稼働しているかどうかを確認してください。
エラー
|
アクセスしようとしている Experience Manager Assets サーバーにアクセスできません。 詳しくは、Adobe Experience Manager の管理者にお問い合わせください。 |
理由
このエラーは、Experience Manager サーバーへの接続中にネットワーク接続が切断された場合、または Experience Manager サーバーが使用できない場合に表示されます。
エラーを修正するには、インターネットに接続していることを確認し、次の手順を実行します。
Experience Manager サーバーが稼働しているかどうかを確認します。
使用している Creative Cloud アプリを終了して再起動します。
Asset Link パネルを起動します。
エラー
|
お使いの Creative Cloud エンタープライズ版アカウントに、この Experience Manager Assets サーバーへのアクセス権限がない可能性があります。 サポートが必要な場合は、Adobe Experience Manager の管理者にお問い合わせください。 |
理由
このエラーは、Creative Cloud エンタープライズ版アカウントが、Experience Manager Assets サーバーにアクセスする権限を持っていない場合に表示されます。
認証エラーはまた、ローカルの assetlink-settings.json ファイル内の 1 つ以上の設定が誤っている場合にも発生する可能性があります(詳しくは、こちらのドキュメントを参照してください)。 サポートが必要な場合は、Experience Manager の管理者にお問い合わせください。 具体的には、このエラーは以下の状況で発生します。
- ユーザーが Experience Manager サーバーへのアクセスを許可されていない。
- ユーザーアカウントが、Experience Manager で構成された IMS グループに追加されていない。
- ユーザーアカウントに追加された IMS グループが Experience Manager IMS グループと一致しません。
- assetlink-settings.json ファイルに誤った aemPort が含まれている。
- aemServer の値が、assetlink-settings.json ファイルに指定されていない。
プロキシ環境を使用しているお客様は、Adobe Asset Link の使用がブロックされています。 プロキシ環境は、Adobe Asset Link ではまだサポートされていません。
ユーザーが Experience Manager へのアクセスを許可されていない場合、アカウントが追加されていない場合、または Experience Manager の IMS グループと一致していない場合は、次の手順を実行します。
Admin Console のユーザーのページで、ユーザーアカウントを検索します。
ユーザーのリストから、関連のユーザーの名前をクリックします。
「ユーザーグループ」で、関連付けられている IMS グループが Experience Manager と一致していることを確認します。
Experience Manager グループマッピングは、aem-instance/system/console/configMgr/Adobe Granite OAuth IMS Provider/グループマッピングで確認できます。
AEM 6.4 以降では、グループマッピングが明示的に定義されていない場合、IMS ユーザーグループが Experience Manager の dam-users グループの一部であることを確認してください
ユーザーが Experience Manager の IMS グループに関連付けられていない場合は、ユーザーグループを編集して Experience Manager が構成されているユーザーグループを割り当てます。
assetlink-settings.json ファイル内の aemPort と aemServer の値を確認する方法については、「assetlink-settings.json ファイルの構成およびすべてのデバイスの追加」を参照してください。 それでもエラーが表示される場合は、IT 管理者に連絡して次のことを確認してください。
- Experience Manager サーバーにアクセスするための適切な権限がある。
- ユーザーが、Experience Manager で構成された IMS グループに追加されている。
新規ユーザーとして Adobe Asset Link を起動したときに(ホームビューではなく)「新しい環境の追加」ビューが表示される場合は、以下のいずれかを実行してください。
- Adobe Asset Link の最新ビルドにアップデートします。
- オペレーティングシステムに応じて、コンピューターの以下の場所に、CEP/extensions フォルダーが存在することを確認します。 フォルダーがまだ存在しない場合は作成します。
- Windows の場合:C:\Users\<ユーザー名>\AppData\Roaming\Adobe\CEP\extensions
- macOS の場合:/Users/<ユーザー名>/Library/Application Support/Adobe/CEP/extensions
- Windows の場合:C:\Users\<ユーザー名>\AppData\Roaming\Adobe\CEP\extensions
エラー
|
接続しようとしている Experience Manager Assets サーバーが応答しません。 詳しくは、Adobe Experience Manager の管理者にお問い合わせください。 |
理由
このエラーは、Experience Manager サーバーに接続できない場合に表示されます。
このエラーを解決するには、IT 管理者に連絡して Experience Manager サーバーが稼働していることを確認してください。
エラー
|
インターネットに接続されていません。 |
理由
このエラーは、インターネットに接続されていない場合に表示されます。
このエラーを修正するには、コンピューターがインターネットに接続されていることを確認してください。
InDesign 2020 以降の Adobe Asset Link コンテキストメニューから「リンクを配置」オプションを使用すると、次のエラーが発生することがあります。 InDesign Client ID である InDesignAem2 が、Experience Manager サーバー内の承認済みリストに直接追加されていることを確認してください。
承認済みリストに Client ID を追加する方法については、「設定パッケージを使用した Experience Manager の設定。
」を参照してください。
Experience Manager Assets を Cloud Service インスタンスとして使用している場合、これは必要ありません。 これは、AMS および Experience Manager Assets のオンプレミスインスタンスにのみ適用されます。
Experience Manager 上のリンクされたアセットへの変更は、ローカルの InDesign キャッシュを削除しない限り、InDesign のユーザーには表示されないことがあります。 この問題は、リンクされたアセットのメタデータに対する不十分な権限が原因の 1 つです。
この問題を解決するには、CRxDeの /content/dam/dam:batch ノードで、ユーザーが「変更」アクセス権を持っていることを確認してください。
Experience Manager Assets と Adobe Asset Link のアセット検索で結果が異なる場合は、視覚的類似性検索を実行して一貫性のある結果を取得してください。
クライアントサイドログの有効化
接続エラーの診断にはクライアントログとサーバーログの両方が必要であるため、クライアントサイドログは接続の問題をデバッグするのに役立ちます。
Creative Cloud アプリ(Photoshop、InDesign、Illustrator)では、Adobe Asset Link エクステンションの DEBUG レベルや TRACE レベルでクライアントサイドログ記録を簡単に実行できます。 これには、1 行のコードを含む Assetlink-override.json という名前のテキストファイルを作成するだけです。
DEBUG レベルログの場合、このファイルには次のコード行を指定します。
{"LOG_LEVEL":"DEBUG"}
TRACE レベルログを有効にするには、次のように値をトレースに変更します。
{"LOG_LEVEL":"TRACE"}
このファイルは、assetlink-settings.json ファイルと同じ場所に配置してください。
- macOS:/Users/<ユーザー名>/Library/Application Support/Adobe/CEP/extensions
- Windows:C:\Users\<ユーザー名>\AppData\Roaming\Adobe\CEP\extensions
ここで、「ユーザー名」はコンピューターのログイン ID です。
Creative Cloud アプリケーション(Photoshop、InDesign、Illustrator)を再起動します。 Adobe Asset Link が再起動すると、一時ディレクトリに適切なログレベルのログファイルが作成されます。
オペレーティングシステムに応じて、一時ディレクトリが次の場所に作成されます。
- macOS の場合:/tmp
- Windows: %TEMP% (which usually resolves to C:\Users\ユーザー名\AppData\Local\Temp)
ログファイル名は、adobe-assetlink-APPN-99.9.9.log です。
「APPN」 は、PHXS、IDSN、ILST のいずれかです。 数字「99」は、Creative Cloud アプリのバージョン番号と置き換えられます。 例えば Photoshop の場合は、次のようなファイル名になります。
adobe-assetlink-PHXS-19.1.2.log
ログファイルのサイズは、わずか数キロバイトです。
接続エラーの診断にはクライアントログとサーバーログの両方が必要であるため、クライアントログは接続の問題をデバッグするのに役立ちます。
Adobe XD の Adobe Asset Link で DEBUG レベルまたは TRACE レベルのクライアントサイドのログを有効にするには、1 行のテキストファイル assetlink-override.json を作成します。
DEBUG レベルログの場合、このファイルには次のコード行を指定します。
{"LOG_LEVEL":"DEBUG"}
TRACE レベルログを有効にするには、次のように値をトレースに変更します。
{"LOG_LEVEL":"TRACE"}
このファイルは、storage.json ファイルと同じ場所に配置してください。
- macOS:~/Library/Application/Support/Adobe/UXP/PluginsStorage/SPRK/External/61d229b9/PluginData
- Windows:C:\Users\<username>\AppData\Roaming\Adobe\UXP\PluginsStorage\SPRK\External\61d229b9\PluginData
ここで、「ユーザー名」はコンピューターのログイン ID です。
Adobe XD を再起動します。 Adobe Asset Link が再起動すると、次の場所に適切なログレベルのログファイルが作成されます。
- macOS:~/Library/Application/Support/Adobe/UXP/PluginsStorage/SPRK/External/61d229b9/PluginData/logs
- Windows:C:\Users\<user>\AppData\Roaming\Adobe\UXP\PluginsStorage\SPRK\External\61d229b9\PluginData\logs
ログファイル名は、adobe-assetlink-XD-4X.X.XX.XX.xxx.log です。
ログファイルのサイズは、わずか数キロバイトです。
X の値は、使用している Adobe XD のバージョンによって異なります。 ただし、Adobe XD バージョン 41.0 以上を使用する必要があります。
assetlink-settings.json を使用してエンドポイントを手動で設定する方法
新規ユーザーの場合、ユーザーのアカウントを作成する前にマシンをプロビジョニングできます。 オペレーティングシステムに応じて、次のいずれかの場所に assetlink-settings.json ファイルをコピーします。
- macOS の場合:/Library/Application Support/Adobe/CEP/extensions
- Windows の場合:\Program Files (x86)\Common Files\Adobe\CEP\extensions
新規ユーザーが Adobe Asset Link を起動すると、システムの場所に設定ファイルがあるかどうかがスキャンされます。 その後、オペレーティングシステムに応じて、次のいずれかのユーザー領域にファイルがコピーされます。
- macOS の場合:../Library/Application Support/Adobe/CEP/extensions
- Windows: ..\AppData\Adobe\CEP\extensions (Windows)
管理者は必ずユーザーに assetlink-settings.json ファイルが含まれているフォルダーへの読み取り権限を付与してください。 管理者はまた、デプロイされたマシンを今後使用するすべてのユーザーに対し、そのフォルダーに対する読み取り権限を付与する必要があります。
デバイスでフォルダーパスが使用できない場合は、手動で CEP/extensions フォルダーを作成します。
サンプルの assetlink-settings.json ファイルをダウンロードして、テキストエディターで開きます。
1 つ以上の Experience Manager Assets エンドポイントを含めるようにファイルを修正します。
{"aemServer":"SERVERNAME","aemPort":"SERVERPORT","aemScheme":"PROTOCOL"}
|
パラメーター |
説明 |
|---|---|
|
SERVERNAME |
Experience Manager サーバーの名前または URL |
|
SERVERPORT |
Experience Manager サーバーのポート番号 |
|
PROTOCOL |
Experience Manager サーバーの URL のプロトコルスキーム。 HTTP または HTTPS を使用します。 |
例えば、Experience Manager サーバーの URL が、http://content.demo.com:4502 である場合、.json ファイルは次のコードを含む必要があります。
- {"aemServer":"content.demo.com","aemPort":"4502","aemScheme":"http"}
以下に、その他のサンプル .json ファイルを示します。
- {"aemServer":"author.customer.com","aemPort":"443","aemScheme":"https"}
- {"aemServer":"localhost","aemPort":"4502","aemScheme":"http"}
- {"aemServer":"author-nossl.customer.com","aemPort":"80","aemScheme":"http"}
json ファイルを使用して XD 用 Adobe Asset Link に Experience Manager 環境を追加する
XD 用 Adobe Asset Link に Experience Manager 環境を追加するには、特定の環境の URL を含む assetlink-settings.json ファイルをアップデートしてください。
assetlink-settings.json ファイルを構成して、新しい Experience Manager インスタンスを指定します。 Adobe XD を起動し、次の場所から storage.json ファイルを開きます。
- macOS:Users/<ユーザー名>/Library/Application/Support/Adobe/UXP/PluginsStorage/SPRK/External/61d229b9/PluginData
- Windows:C:\Users\<ユーザー名>\AppData\Roaming\Adobe\UXP\PluginsStorage\SPRK\External\61d229b9\PluginData
このファイルには、以下のエントリが含まれています
{"aemEnvironments": [{ "root": url, "title": title }],
"activeAemEnvironmentRoot": url,
"viewMode": "grid}
この「url」を、Experience Manager Assets インスタンスの URL に置き換えます。 URL は引用符で囲みます。 ファイルを保存して閉じます。 Adobe XD を終了して再起動すると、Experience Manager Assets に接続されます。
assetlink-settings.json ファイルが異なる場合、XD 用 Adobe Asset Link は検出サービスワークフローにリダイレクトされます。