설명서Commerce관리 시스템 안내서

데이터 가져오기

Last update: Wed Apr 10 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • Beginner
  • Intermediate
  • Admin
  • Leader

모든 제품 유형에 대한 데이터를 스토어로 가져올 수 있습니다. 또한 제품, 고급 가격 데이터, 고객 데이터, 고객 주소 데이터 및 제품 이미지를 가져올 수 있습니다. 가져오기는 다음 작업을 지원합니다.

  • 추가/업데이트
  • 바꾸기
  • 삭제

가져오기 지침

새 엔티티

  • 엔티티는 CSV 파일에 지정된 속성 값과 함께 추가됩니다.
  • 기본값이 설정되지 않은 필수 속성의 경우 값이 없거나 잘못된 값이 있으면 엔티티(해당 행)를 가져올 수 없습니다.
  • 기본값이 설정된 필수 속성의 경우 엔티티(해당 행)를 가져오고 값이 없거나 잘못된 값이 있는 경우 속성에 대해 기본값이 설정됩니다.
  • 복합 데이터가 올바르지 않으면 엔티티(해당 행)를 가져올 수 없습니다.

기존 엔티티

  • 복잡한 데이터가 아닌 속성의 경우, 비필수 속성에 대한 빈 값을 포함하여 가져오기 파일의 값이 기존 값을 바꿉니다.
  • 필수 속성에 대한 값이 없거나 잘못된 값이 있으면 기존 값이 대체되지 않습니다.
  • 엔티티에 대한 복합 데이터가 유효하지 않은 경우 가져오기 동작 드롭다운 메뉴에서 엔티티 삭제 를 선택한 경우를 제외하고 엔티티(해당 행 또는 행)를 가져올 수 없습니다.

복잡한 데이터

가져오기 파일에 지정된 속성이 있고 해당 값이 정의된 값 집합에서 파생된 경우 다음이 적용됩니다.

  • 값이 정의된 값 집합에 아직 포함되지 않은 경우 행을 가져올 수 있으며, 기본값이 정의된 경우 속성에 대해 설정됩니다.
  • 값이 정의된 집합에 이미 포함되어 있으면 해당 행을 가져올 수 없습니다.
  • 가져오기 파일에서 시스템에 아직 정의되지 않은 속성 이름을 지정하면 해당 속성 이름이 만들어지지 않고 해당 값을 가져오지 않습니다.

잘못된 파일

  • 모든 행이 잘못된 경우 파일을 가져올 수 없습니다.
  • 존재하지 않는 서비스 데이터나 복잡한 데이터 이름은 가져오기 파일에 지정됩니다(예: _<non-existing name> 제목.

Adobe Commerce의 가져오기 프로세스는 BOM(바이트 순서 표시)을 사용하는 UTF-8로 인코딩된 파일을 제대로 인식하지 못할 수 있습니다. BOM이 포함된 파일은 가져오기 프로세스 중에 문제나 실패를 초래할 수 있습니다.

가져오기 작업

작업
설명
추가/업데이트
새 제품 데이터가 데이터베이스의 기존 항목에 대한 기존 제품 데이터에 추가됩니다. 을 제외한 모든 필드 sku 를 업데이트할 수 있습니다.

임포트 데이터에 지정된 신규 세금 분류는 자동으로 생성됩니다.

가져오기 파일에 지정된 새 제품 범주가 자동으로 만들어집니다.

가져오기 파일에 지정된 새 SKU는 자동으로 만들어집니다​

참고: ​제품의 경우 가져오기를 통해 SKU를 제외한 모든 필드를 업데이트할 수 있습니다.

중요 사항: 웹 사이트 또는 범주와 같은 여러 필드 값은 추가/업데이트 가져오기 동작. 이러한 필드는 CSV 파일에 나열되지 않으면 가져오기 후 데이터베이스에 유지됩니다.
바꾸기
기존 제품 데이터가 새 데이터로 교체됩니다.

중요 사항: ​기존 제품 데이터가 지워지고 시스템의 모든 참조가 손실되므로 데이터를 바꿀 때 주의하십시오.

가져오기 데이터의 SKU가 기존 엔티티의 SKU와 일치하는 경우 SKU를 포함한 모든 필드가 삭제되고 CSV 데이터를 사용하여 새 레코드가 만들어집니다. CSV 파일이 데이터베이스에 없는 SKU를 참조하는 경우 오류가 발생합니다. 데이터를 확인하여 오류를 표시할 수 있습니다.
삭제
데이터베이스에 있는 가져오기 데이터의 모든 엔티티는 데이터베이스에서 삭제됩니다.

삭제는 SKU를 제외하고 가져오기 데이터의 모든 열을 무시합니다. 데이터의 다른 모든 속성을 무시할 수 있습니다.

CSV 파일이 데이터베이스에 없는 SKU를 참조하는 경우 오류가 발생합니다. 데이터를 확인하여 오류를 표시할 수 있습니다.

가져오기 프로세스

가져오기 파일의 크기는 의 설정에 따라 결정됩니다. php.ini 서버에 있는 파일입니다. 에 대한 시스템 메시지 가져오기 페이지는 현재 크기 제한을 나타냅니다. 기본 크기는 2MB입니다.

등호, 보다 큼 및 보다 작음 기호, 작은따옴표와 큰따옴표, 백슬래시, 파이프 및 앰퍼샌드 기호와 같은 특수 문자는 데이터 전송 중에 문제를 일으킬 수 있습니다. 이러한 특수 문자가 올바르게 해석되도록 다음과 같이 표시할 수 있습니다. 이스케이프 시퀀스. 예를 들어 데이터에 와 같은 텍스트 문자열이 포함된 경우 code="str", code="str2"를 사용하여 텍스트를 큰따옴표로 묶도록 선택하면 원래 큰따옴표가 데이터의 일부로 인식됩니다. 시스템에 큰따옴표 집합이 나타나면 큰따옴표 바깥쪽 집합이 실제 데이터를 둘러싸고 있음을 인식합니다.

제품 데이터를 가져올 때 새 제품 데이터가 데이터베이스의 기존 제품 데이터 항목에 추가됩니다. 가져오기를 통해 SKU를 제외한 모든 필드를 업데이트할 수 있습니다. 기존의 모든 제품 데이터가 가져온 새 데이터로 대체됩니다. 데이터를 바꿀 때 주의하십시오. 기존의 모든 제품 데이터가 지워지고 시스템의 모든 참조가 손실됩니다.

데이터 가져오기 {width="600" modal="regular"}

1단계: 데이터 준비

  1. 다음에서 관리자 사이드바, 이동 System > Data Transfer>Import.

  2. 아래 가져오기 설정, 설정됨 Entity Type 다음 중 하나를 수행합니다.

    • Advanced Pricing
    • Products
    • Customer Finances
    • Customers and Addresses
    • Customers Main File
    • Customer Addresses
    • Stock Sources

  3. 클릭 Download Sample File.

  4. 웹 브라우저의 다운로드 위치에서 내보내기 파일을 찾아 파일을 엽니다.

    샘플 파일에는 제품 유형에 대한 자리 표시자 데이터가 있는 열 제목이 포함되어 있습니다.

    데이터 샘플 파일 가져오기 {width="600" modal="regular"}

  5. 샘플 파일의 구조를 검사하고 이를 사용하여 CSV 가져오기 파일을 준비합니다. 열 제목의 맞춤법이 올바른지 확인하십시오.

  6. 가져오기 파일의 크기가 메시지에 표시된 제한을 초과하지 않는지 확인합니다.

    데이터 가져오기 크기 알림 {width="600"}

  7. 가져오기 데이터에 제품 이미지에 대한 경로가 포함된 경우 이미지 파일이 적절한 위치에 업로드되었는지 확인하십시오.

    상거래 서버의 기본 위치는 다음과 같습니다. pub/media/import.

    이미지가 외부 서버에 있는 경우 이미지가 포함된 디렉토리에 대한 전체 URL이 있는지 확인합니다.

2단계: 가져오기 동작 선택

데이터 가져오기 동작 {width="600" modal="regular"}

  1. 설정 Import Behavior 다음 중 하나를 수행합니다.

    • Add/Update (제품의 경우 가져오기를 통해 SKU를 제외한 모든 필드를 업데이트할 수 있습니다.)
    • Replace
    • Delete

  2. 데이터를 가져올 때 오류가 발생할 때 발생하는 상황을 확인하려면 다음 중 하나를 선택하십시오.

    • Stop on Error
    • Skip error entries

  3. 대상 Allowed Errors Count ​가져오기를 취소하기 전에 발생할 수 있는 오류 수를 입력합니다.

    기본값은 10입니다.

  4. 쉼표()의 기본값을 사용합니다.,에 대한 ) Field separator.

  5. 쉼표()의 기본값을 사용합니다.,에 대한 ) Multiple value separator.

    CSV 파일에서 쉼표가 기본 구분 기호입니다. 다른 문자를 사용하려면 CSV 파일의 데이터가 지정한 문자와 일치하는지 확인하십시오.

  6. 기본값 수락 _EMPTY_VALUE_ 대상 Empty attribute value constant.

  7. 데이터에서 로 찾을 수 있는 특수 문자를 묶으려면 이스케이프 시퀀스 ​를 선택하고 Fields Enclosure 확인란.

3단계: 가져오기 파일 식별

데이터 가져오기 파일 {width="600" modal="regular"}

  1. 클릭 Choose File 가져올 파일을 선택합니다.

  2. 가져오려고 준비한 CSV 파일을 찾아 클릭합니다.  Open.

  3. 대상 Images File Directory ​에 업로드된 이미지가 저장되는 Commerce 서버의 위치에 대한 상대 경로를 입력합니다.

    예: product_images.

    note note
    NOTE
    Adobe Commerce 및 Magento Open Source 시작 2.3.2 릴리스,에 지정된 경로 Images File Directory ​이미지 기본 디렉토리로 가져오기 위해 를 연결합니다. <Magento-root-folder>/var/import/images. 예를 들어 product_images 의 파일 <Magento-root-directory>/var/import/images/product_images 폴더를 삭제합니다. 이미지 가져오기 기본 디렉토리는 \Magento\ImportExport\etc\config.xml 파일. 원격 스토리지 모듈이 활성화된 경우 파일을 <remote-storage-root-directory>/var/import/images/product_images 폴더를 삭제합니다.

    제품 이미지 가져오기에 대한 자세한 내용은 제품 이미지 가져오기.

4단계: 가져오기 데이터 확인

  1. 오른쪽 위 모서리에서 을(를) 클릭합니다.  Check Data.

  2. 유효성 검사 프로세스가 완료될 때까지 잠시 기다립니다.

    가져오기 데이터가 유효한 경우 다음과 같은 메시지가 나타납니다.

    성공 메시지 - 파일이 유효합니다. {width="600"}

  3. 파일이 유효하면 Import.

    그렇지 않으면 메시지에 나열된 데이터의 각 문제를 수정한 다음 파일을 다시 가져오십시오.

  4. 오류가 발생하지 않는 한 가져오기 프로세스는 데이터 끝까지 계속됩니다.

    유효성 검사 결과에 오류 메시지가 나타나면 데이터의 문제를 수정하고 파일을 다시 가져옵니다.

    오류 메시지 - URL 키가 이미 있음 {width="600"}

    가져오기가 완료되면 메시지가 나타납니다.

가져오기 기록

Commerce는 시작 날짜 및 시간, 사용자, 실행 시간 및 가져온 파일에 대한 링크를 포함하여 스토어로 가져온 데이터의 레코드를 유지 관리합니다. 다음 실행 시간 는 가져오기 프로세스의 기간입니다.

가져오기 기록을 보려면 다음과 같이 하십시오.

다음에서 관리자 사이드바, 이동 System > Data Transfer>Import History.

데이터 가져오기 기록 {width="600" modal="regular"}

NOTE
기본적으로 가져오기 기록 파일은 <Magento-root-directory>/var/import_history 폴더를 삭제합니다. 원격 스토리지 모듈이 활성화된 경우 가져오기 기록 파일은 <remote-storage-root-directory>/import_export/import_history 폴더를 삭제합니다.
필드
설명
ID
전송을 지정하는 데 사용되는 내부 번호입니다.
Start Date & Time
전송이 발생한 특정 날짜 및 시간입니다.
User
전송을 수행한 고객.
Imported file
가져온 파일을 다운로드하기 위한 링크입니다.
Error file
해당 오류 파일.
Execution Time
가져오기 프로세스의 시간 간격입니다.
Summary
생성, 업데이트 및 삭제된 항목 수 또는 오류 메시지입니다.

다운로드하려면 가져옴/오류 파일, 클릭 Download.

recommendation-more-help
d3c62084-5181-43fb-bba6-1feb2fcc3ec1