데이터 내보내기 및 가져오기¶

Gem Logic은 CSV 및 기타 파일 형식을 사용하여 데이터를 대량으로 내보내고 가져올 수 있도록 지원합니다. 이는 다른 시스템에서 데이터를 마이그레이션하거나, 대량 업데이트를 수행하거나, 보고서를 생성할 때 유용합니다.

다른 시스템에서 Gem Logic으로 데이터를 마이그레이션하는 단계별 가이드는 :doc:`data_migration`을 참조하십시오.

내보내기 및 가져오기 작업은 대부분의 목록 보기에서 Actions 메뉴를 통해 사용할 수 있습니다.

데이터 내보내기¶

데이터를 내보내려면, 내보내려는 레코드의 목록 보기(예: 제품, 연락처, 주문)로 이동하여 작업 메뉴를 클릭하십시오. 다운로드 아이콘을 선택하여 내보내기 대화 상자를 엽니다.

여러 내보내기 형식 중에서 선택하실 수 있습니다:

내보낸 파일에는 현재 필터와 일치하는 모든 레코드가 포함됩니다. 데이터를 좁히려면 내보내기 전에 필터를 적용하십시오.

모든 내보내기는 기록됩니다. 해당 목록 보기의 :menuselection:`작업 –> 내보내기 이력`에서 과거 내보내기를 확인하실 수 있습니다. 거기에서 이전에 내보낸 파일을 다시 다운로드하실 수 있습니다.

데이터를 가져오려면 목록 보기로 이동하여 :menuselection:`작업 –> 가져오기`를 클릭하십시오. CSV 파일을 업로드할 수 있는 가져오기 대화 상자가 열립니다.

가져오기 전에 가져오기 대화 상자에서 빈 CSV 템플릿을 다운로드하십시오. 템플릿은 두 가지 형식으로 제공됩니다:

템플릿에는 두 개의 헤더 행과 함께 사용 가능한 모든 열이 포함되어 있습니다. 첫 번째 행은 각 필드를 설명하고, 두 번째 행에는 내부 필드 이름이 포함되어 있습니다. 이러한 헤더 행을 수정하거나 제거하지 마십시오.

세 번째 행부터 데이터를 입력하십시오. 필요하지 않은 열을 삭제하고 필요에 따라 재배치하실 수 있습니다.

새 레코드를 생성하려면 id 열을 비워 두십시오. Gem Logic이 가져오기 시 각 새 레코드에 자동으로 ID를 할당합니다.

기존 레코드를 업데이트하려면 업데이트하려는 레코드의 올바른 데이터베이스 ID가 포함된 id 열을 포함하십시오. 먼저 기존 데이터를 내보내서 이러한 ID를 얻으실 수 있습니다.

id 열에 기존 레코드와 일치하는 값이 포함되어 있으면 Gem Logic은 새 레코드를 생성하는 대신 CSV 행의 값으로 해당 레코드를 업데이트합니다.

팁

일반적인 작업 흐름은 먼저 기존 데이터를 내보내고, 내보낸 파일에서 필요한 값을 수정한 다음 다시 가져오는 것입니다. 내보낸 파일에는 데이터베이스 ID가 포함되어 있으므로 가져오기 시 기존 레코드가 업데이트됩니다.

모든 가져오기는 기록됩니다. 해당 목록 보기의 :menuselection:`작업 –> 가져오기 이력`에서 과거 가져오기를 확인하실 수 있습니다. 각 가져오기 항목은 상태를 표시하며 원본 파일 또는 발생한 오류가 포함된 보고서를 다운로드하실 수 있습니다.

제품 가져오기는 다른 가져오기와 동일한 일반적인 흐름을 따릅니다. 빈 CSV 템플릿(US 쉼표 구분 또는 EU 세미콜론 구분)을 다운로드하고, 행을 입력한 다음 :menuselection:`Stock –> 제품 –> 작업 –> 가져오기`에서 파일을 업로드하십시오.

제품 관련 두 가지 세부사항:

기존 제품은 ``id``가 아닌 ``item_sku``로 일치됩니다. 행의 ``item_sku``가 Gem Logic에 이미 존재하는 경우 해당 제품은 행의 값으로 업데이트됩니다. 새롭거나 비어 있는 ``item_sku``가 있는 행은 새 제품을 생성합니다(필드를 비워 두면 SKU가 자동 생성됩니다).
제품 템플릿의 첫 번째 헤더 행은 예약되어 있으며 수정하거나 제거해서는 안 됩니다. 필요하지 않은 열을 삭제하고 자유롭게 재배치하실 수 있습니다.

업로드 후, 각 가져오기의 상태는 :menuselection:`Actions –> Import history`에서 확인할 수 있으며, 실패한 행에 대한 오류 보고서도 다운로드하실 수 있습니다.

제품을 가져올 때, 각 판매 채널의 가격은 세 개의 열이 함께 작동하는 트리플을 통해 설정됩니다:

제품당 최대 **5개의 트리플**을 설정하실 수 있습니다(price, price_2 … price_5, 각각 대응하는 pricing_rule_* 및 ``sales_channel_price_*``과 함께). 빈 트리플은 무시됩니다.

pricing_rule 열은 **다음 네 가지 값 중 하나**여야 합니다 — 그 외의 값은 해당 행을 거부합니다:

fixed_price — 판매 가격이 price 그대로와 동일
cost_multiplier — 판매 가격이 ``원가 × price``(여기서 ``원가``는 제품의 금속, 보석 및 구성 요소 원가의 합계)
price_per_carat — 판매 가격이 price × 제품 보석의 총 캐럿 중량
cost_based — 판매 가격이 제품의 원가와 동일; ``price``는 무시됨

``price``가 설정되고 ``sales_channel_price``가 비어 있는 경우, 규칙과 금액이 해당 제품의 **모든 판매 채널**에 적용됩니다.
``price``와 ``sales_channel_price``가 모두 설정된 경우, 규칙과 금액이 해당 판매 채널에만 적용됩니다. 추가 채널에는 두 번째 및 세 번째 트리플을 사용하십시오.
price``가 비어 있는 경우, 해당 트리플에 대해 가격 변경이 이루어지지 않습니다 — ``pricing_rule 또는 ``sales_channel_price``를 입력하더라도 마찬가지입니다.

기존 제품을 다시 가져올 때:

빈 pricing_rule``은 새 제품과 기존 제품을 업데이트할 때 모두 항상 규칙을 ``fixed_price``로 설정합니다. 다른 규칙(예: ``cost_multiplier 또는 price_per_carat)을 유지하려면 pricing_rule 열에 해당 값을 입력하십시오.

가져온 후, Gem Logic은 규칙에 따라 각 판매 채널의 판매 가격을 자동으로 재계산하므로, 일반 가격 열을 별도로 입력하실 필요가 없습니다.

다음 레코드 유형은 내보내기 및 가져오기를 지원합니다: