설명서Experience Cloud KCS

서식, 구분 기호 또는 헤더 문제로 인해 AEM CSV 메타데이터 가져오기 또는 내보내기가 실패합니다

마지막 업데이트: 2026년 6월 21일

Adobe Experience Manager에서 파일에서 잘못된 구분 기호를 사용하거나, 숨겨진 빈 행을 포함하거나, 잘못된 스키마 헤더를 포함하는 경우 CSV 기반 메타데이터 가져오기 및 내보내기가 실패하거나 예기치 않게 동작합니다. 가져온 값이 저장된 내부 값과 일치하지 않으면 제어 어휘 필드를 업데이트하지 못하며, 헤더가 올바르게 정의되지 않은 경우 다중 값 필드를 단일 문자열로 가져옵니다. 스프레드시트 편집 시 형식 변경이 발생하여 파일이 올바르게 표시되더라도 스키마 CSV 가져오기가 실패합니다. 이 문제를 해결하려면 CSV 구조를 검토하고 다중 값 필드에 파이프 구분 기호를 사용한 다음 다시 가져오기 전에 헤더와 저장된 값을 확인하십시오.

설명 description

환경

  • Adobe Experience Manager as a Cloud Service
  • AEM Assets 기본 사항
  • AEM Managed Services

문제/증상:

  • CSV 파일로 메타데이터 가져오기에 실패하고 데이터 형식이 잘못되었습니다.
  • 다중 값 필드는 별도의 값 대신 하나의 연결된 문자열로 가져옵니다.
  • 제공된 템플릿을 사용하는 경우에도 드롭다운 옵션 CSV 가져오기가 실패합니다.
  • 가져오기 작업이 완료되어도 메타데이터 값은 업데이트되지 않습니다.
  • 다중 값 날짜 필드는 가져온 후 부분적으로 업데이트되거나 값이 사라집니다.

근본 원인:

AEM에서는 메타데이터 가져오기에 대해 엄격한 CSV 형식이 필요합니다. 다중 값 필드에는 구분 기호로 파이프 문자 |이(가) 필요하지만 내보낸 값은 가독성을 위해 쉼표나 세미콜론으로 나타날 수 있습니다. 편집하는 동안 숨겨진 빈 행, 따옴표 또는 기타 서식 변경으로 인해 가져오기 오류가 발생할 수 있습니다. 다중 값 유형 표기법 누락을 포함한 잘못된 열 헤더로 인해 AEM에서 다중 값 데이터를 단일 문자열로 처리할 수 있습니다. 드롭다운 또는 제어 어휘 필드에서 저장된 내부 값 대신 표시 레이블을 사용하는 경우에도 업데이트가 실패할 수 있습니다.

해결 방법 resolution

AEM에서 CSV 파일을 사용하여 메타데이터 문제를 해결하고 성공적으로 가져오려면 다음 단계를 수행합니다.

  1. 자산 메타데이터 가져오기 중 또는 메타데이터 스키마 드롭다운 CSV 가져오기 중 문제가 발생하는지 식별합니다.
  2. 일반 텍스트 편집기에서 CSV를 열고 완전히 비어 있는 후행 행을 제거합니다.
  3. 값이 |(으)로 구분되도록 모든 다중 값 필드를 업데이트하십시오(예: value1|value2|value3).
  4. 다중 값 필드가 내보낸 AEM CSV에 사용되는 스키마 포맷과 일치하도록 CSV 헤더를 수정합니다.
  5. 드롭다운 또는 제어 어휘 필드의 경우, 표시 레이블을 AEM에서 사용하는 정확히 저장된 내부 값으로 바꿉니다.
  6. 메타데이터 스키마 드롭다운 가져오기에 실패한 경우 메타데이터 스키마 편집기에서 새 템플릿을 다운로드하고 스프레드시트 애플리케이션이 아닌 일반 텍스트 편집기에 행을 추가합니다.
  7. 다중 값 날짜 필드를 가져온 후에도 값이 손실되는 경우 깨끗한 로컬 CSV로 다시 테스트하십시오. 문제가 계속되면 Adobe 지원 센터에 문의하십시오.
  8. 가져오기 전에 스프레드시트 파일을 .csv(으)로 변환하십시오.
  9. 문제가 지속되면 Adobe 지원에 문의하고 실패한 CSV 파일, 메타데이터 스키마 정의, 오류 화면 기록 및 샘플 자산 경로를 제공하십시오.

관련 읽기

recommendation-more-help
experience-cloud-kcs-help-kbarticles