AEM 파일 이름에 지원되지 않는 문자로 인한 에셋 업로드 및 메타데이터 오류 해결
AEM Assets에서는 에셋 및 폴더 이름에 대해 엄격한 유효성 검사를 수행하므로 파일 이름에 *, /, :, #, %, & 또는 {}와 같이 지원되지 않는 문자가 포함되어 있으면 업로드, 메타데이터 업데이트, 게시 작업 및 API 응답이 실패합니다. AEM UI는 이러한 문자를 완전히 차단하는 반면, 대량 가져오기 및 API 섭취는 자동으로 살균하거나 URL을 인코딩하고 Dynamic Media 또는 Assets API와 같은 다운스트림 시스템은 끊어진 경로를 반환합니다. 그 원인은 기본 JCR 저장소인 AEM 및 연결된 시스템이 해당 문자를 안전하게 저장하거나 처리할 수 없기 때문입니다. 영향을 받는 에셋의 이름을 허용된 문자만 사용하도록 바꾸고 다시 수집하면 업로드, 메타데이터 편집, 게시 및 클린 API 경로가 복원됩니다.
설명 description
환경:
- Adobe Experience Manager as a Cloud Service
- Adobe Experience Manager Managed Services
- Adobe Experience Manager 6.5(온-프레미스)
- AEM Assets, 벌크 가져오기 및 Assets API
- Dynamic Media(Scene7) 및 Asset Share Commons
문제/증상:
- AEM UI 업로드가 실패하고 문자 "*/:
[`]`라는 메시지가 표시됩니다 파일 이름 ""에는 |#%{}& 기호를 사용할 수 없습니다. - 파일 이름에 #이 포함된 경우 게시 관리에서 선택한 리소스가 유효하지 않습니다을(를) 반환합니다.
- 파일 이름에 & 또는 기타 잘못된 문자가 포함된 자산에 대한 메타데이터를 업데이트할 수 없습니다.
- 자산 이름에 특수 문자가 있어 자산 관계가 관계를 업데이트할 수 없습니다.
- 대량 가져오기 또는 S3 가져오기는
%27에 아포스트로피(%)를 이스케이프 처리하여 자산의 이름을%25로 바꿉니다. - Assets API는 지원되지 않는 문자가 ?로 디코딩되는 손상된 경로(예: 위 첨자 + ?)를 반환합니다.
근본 원인:
AEM, 기본 JCR 저장소 및 Dynamic Media와 Assets API와 같은 다운스트림 시스템은 특정 문자가 포함된 에셋 이름을 안전하게 저장하거나 처리할 수 없습니다. AEM UI는 클라이언트측 유효성 검사를 시행하는 반면, 일괄 가져오기 및 API 수집은 JCR 정리 및 URL 인코딩 규칙을 적용합니다. 지원되지 않는 문자로 인해 수집 실패, 메타데이터 업데이트 실패, 게시 문제 및 API 응답이 중단됩니다.
확인하는 방법
- AEM 변형에 대한 금지된 문자 목록에 대해 파일 이름을 확인합니다. UI 오류 메시지에 잘못된 문자
* / : [ \ ] | # % { } ? & ;=이(가) AEM as a Cloud Service에 표시되고 AEM 6.5에 대해 동일한 집합이 표시됩니다. - 수동 UI 업로드, S3 가져오기, 벌크 가져오기, 패키지 관리자 또는 API와 같은 에셋을 수집한 방법을 결정합니다. 잘못된 문자에 대해 수동 업로드는 즉시 실패하고, S3 및 일괄 가져오기는 자동으로 살균하며, 패키지 관리자는 유효성 검사를 무시합니다.
해결 방법 resolution
다음 단계에 따라 문제를 해결하십시오.
- 지원되지 않는 문자를 제거하려면 에셋 이름을 바꾸십시오. AEM UI에서 에셋을 선택하고 속성을 연 다음 이름을 바꾸거나 허용된 문자만 사용하는 정리된 파일 이름으로 에셋을 다시 업로드합니다. 메타데이터 업데이트, 게시 또는 관계인지 여부에 관계없이 실패한 작업을 다시 시도하십시오.
- 수백 또는 수천 개의 자산에 영향을 주는 대량 문제의 경우 체계적인 이름 변경을 적용합니다. 정리된 이름 지정 규칙 정의 — & 를 "and"로 바꾸기, # 제거 및 공백을 하이픈으로 바꾸기 — 그런 다음 수정된 파일을 AEM으로 다시 수집하거나 소스 시스템 또는 업스트림 DAM에서 자동화 스크립트를 실행하여 업로드하기 전에 이름을 정리합니다. 이전에 유효하지 않은 에셋을 검색하고 업데이트된 이름을 확인합니다.
- 다운스트림 통합의 유효성을 확인합니다. 정리된 이름을 확인하면 Asset Share Commons 썸네일 및 다운로드, 더 이상 표시되지 않는 Assets API 경로 관련 문제가 해결됩니까? 문자 및 Dynamic Media 업로드 및 검색 워크플로입니다. 검색, API 호출 및 게시 플로우를 테스트합니다.
- 수정 사항을 확인합니다. 정리된 파일 이름으로 자산을 다시 업로드하고 유효성 검사 경고 없이 업로드하는지, 메타데이터가 저장되는지, 게시 관리가 선택한 리소스가 유효하지 않음 오류 없이 실행되는지, Assets API가 ? 자.
문제가 지속되는 경우
파일 이름을 정리한 후에도 업로드, 메타데이터 편집 또는 게시가 계속 실패하거나 API 응답에 허용된 문자만 포함된 파일 이름에 대한 잘못된 경로 서식이 표시되거나 벌크 임포터가 환경 간에 일관되지 않게 작동하는 경우 Adobe 지원 센터에 문의하십시오. 정확한 파일 이름, 업로드 방법, 환경 URL, 오류 메시지 및 스크린샷을 제공합니다.