Creative Cloud アプリのキャッシュを更新するには、Adobe Asset Link をインストール/再インストールする前にアプリを閉じてください。
最終更新日 :
2024年4月24日
|
次にも適用 : Creative Cloud for enterprise
ここでは、Adobe Asset Link を使用するときに発生した問題を解決するためのトラブルシューティングについて説明します。
Adobe Asset Link パネルの概要
Adobe Asset Link は、Photoshop、Illustrator、InDesign、XD などの Adobe Creative Cloud アプリに、エクステンションとしてインストールされます。
インストールして構成した後は、Adobe Illustrator や InDesign でウィンドウ／エクステンション／ Adobe Asset Link を選択して、Adobe Asset Link パネルを開くことができます。
Photoshop で Adobe Asset Link パネルを開くには、ウィンドウ／エクステンション（従来）／Adobe Asset Link を選択します。
Adobe XD で Adobe Asset Link パネルを開くには、プラグイン／Adobe Asset Link を選択します。
Adobe Asset Link を使用して、Adobe Experience Manager Assets に保存されているデジタルアセットにアクセスし、使用、編集します。Experience Manager Assets に新しいアセットをアップロードできます。Adobe Asset Link を使用したアセットの管理について詳しく説明します。
注意：
- ブラウジング中にアセットのサムネイルは表示されないがアセットのプレビューが表示できる場合は、管理者に連絡して、Adobe Experience Manager Managed Services（AMS）を最新のサービスパックで更新してください。
- Adobe Asset Link パネルにアクセスできない場合は、管理者にトラブルシューティング手順を問い合わせてください。
トラブルシューティングに着手する前に
Adobe Asset Link パネルを使用できない場合は、特定のエラーのトラブルシューティングを開始する前に、以下の手順を実行してください。
-
-
Adobe Asset Link が、次の場所にある com.adobe.assetlink フォルダーにインストールされていることを確認します。
- macOS の場合：/Library/Application Support/Adobe/CEP/extensions
- Windows の場合：C:\Program Files (x86)\Common Files\Adobe\CEP\extensions
問題が発生した場合は、既存のバージョンの Adobe Asset Link を削除してから、新しいバージョンの再インストールまたはインストールを試みてください。既存のバージョンを削除するには、com.adobe.assetlink フォルダーを削除します。次に Adobe Asset Link の最新バージョンをインストールします。
-
次の場所に assetlink-settings.json ファイルが存在することを確認します。
- macOS の場合： /Users/<ユーザー名>/Library/Application Support/Adobe/CEP/extensions
- Windows の場合：C:\Users\<ユーザー名>\AppData\Roaming\Adobe\CEP\extensions
-
Enterprise ID または Federated ID を使用して Creative Cloud デスクトップアプリケーションにログインしていることを確認します。
-
Creative Cloud デスクトップアプリケーションで、ファイル同期が有効であることを確認します。
-
アクティビティモニター（macOS の場合）またはタスクマネージャー（Windows の場合）を使用して、CoreSync という名前のプロセスが実行されていることを確認します。
-
管理者の場合は、次のことを確認します。
- すべての IMS 設定が適切に指定されている。
- Adobe Admin Console で、ユーザーの Business ID、Enterprise ID または Federated ID が、Experience Manager サーバーで構成されているユーザーグループに追加されている。
- Experience Manager サーバーで構成されている IMS ユーザーグループが、Experience Manager の dam-users グループの一部である。
-
S3 をデータストアとしてデプロイした Experience Manager 6.5.5 以降で Adobe Asset Link を使用している場合は、プラットフォーム API が正しく機能しているかどうかを確認してください。
https://<サーバー>:<ポート>/platform/content/dam にアクセスして、接続に問題がないことを確認します。Platform API が正しく機能している場合、トップレベルの DAM オブジェクトの JSON 表現が応答として返されます。Platform API が適切に動作していない場合は、応答コード 500 のエラーが生成され、Adobe Asset Link は Experience Manager に接続できません。エラーを解決するには、S3 データストアコネクタをバージョン 1.10.12 以降にアップグレードします。
-
Adobe Asset Link を Apple M1 デバイスの Adobe Illustrator、InDesign、XD に対応させるには、Adobe Asset Link および XD 用 Adobe Asset Link を最新のバージョンにアップグレードしてください。Adobe Asset Link は、Rosetta エミュレーションモードの M1 デバイスで Adobe Photoshop をサポートします。Rosetta で Photoshop を実行する方法については、Photoshop Apple Silicon 版を参照してください。
エラーシナリオ
Adobe Asset Link パネルの使用中に起こりうるエラーシナリオと、それらを解決する手順を次に示します。
エラー
Adobe Extension Manager コマンドラインツール（ExManCmd）を使用してエクステンションをインストールする際に、Abort trap: 6 エラーが表示されます。
理由
Adobe Asset Link が macOS にインストールできません。Windows の場合は、エラーが表示されずにインストールに失敗します。
この問題を解決するには、次の操作を行います。
-
Creative Cloud デスクトップ版を終了します。
-
次の場所から 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 は検出サービスワークフローにリダイレクトされます。
Photoshop、InDesign、Illustrator などの Creative Cloud アプリケーションでは、クライアント側で Adobe Asset Link エクステンション（パネル）のロギングを DEBUG または TRACE レベルで有効にします。手順は簡単です。1 行のテキストファイルを assetlink-override.json という名前で作成します。
このファイルに次の行を記述します（DEBUG レベルのロギングの場合）：
{ "LOG_LEVEL":"debug" }.
TRACE レベルのロギングの場合、次のように値を 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%（通常は、C:\Users\<ユーザー名>\AppData\Local\Temp に解凍されます）
ログファイルの名前は adobe-assetlink-APPN-99.9.9.logです。
APPN は PHXS、IDSN または ILST のいずれかで、99 は CC アプリケーションのバージョン番号を表す数字です。Photoshop の場合、ファイル名は次のようになります。
adobe-assetlink-PHXS-19.1.2.log
ログファイルのサイズは数 KB です。
接続エラーの診断にはクライアントログとサーバーログの両方が必要です。クライアントログは接続問題のデバッグに役立ちます。
