알레르겐링크
V5 통합 가이드!
'AllergenLink' 가져오기 엔드포인트를 사용하면 V5 추적성 내에서 상품을 알레르겐 그룹 에 신속하게 할당할 수 있습니다 .
이 가이드에서는 CSV 가져오기와 V5 API를 통한 JSON 사용을 통해 이 엔드포인트를 사용하는 방법에 중점을 둡니다.
차례
1. 기본 알레르겐 그룹
기본 V5 데이터베이스는 가장 일반적인 알레르겐 그룹을 다수 포함하고 있지만, 이 엔드포인트는 필요한 경우 추가 알레르겐 그룹을 만드는 데 사용할 수 있습니다. 포함된 표준 알레르겐 그룹은 아래 스크린샷에서 볼 수 있습니다.
이 엔드포인트는 상품 생성을 위한 것이 아니며, 상품 생성은 항상 ' 상품 ' 엔드포인트를 통해 수행해야 합니다.
2. API 링크
3. AllergenLink 현장 가이드
3.1. 기본 키
두 가지 수입 방법론 모두의 주요 키는 다음과 같습니다.
알레르겐_알레르겐 – 알레르겐 그룹의 이름(예: 밀, 글루텐 등).
Commodity_Code – 알레르겐 그룹에 할당될 상품의 고유 코드입니다.
3.2. 추가 필드
'알레르겐' 데이터베이스 클래스에서 추가할 수 있는 다른 옵션은 다음과 같습니다.
Allergen_TextColor – 알레르겐 그룹에 색상을 지정하기 위해 RGB 값을 입력할 수 있습니다. 동일한 알레르겐 그룹 내의 모든 제품에 대해 동일한 색상을 사용해야 합니다. 또한 이 방법을 사용하여 색상을 가져올 때 RGB 값은 쉼표로 구분할 필요가 없습니다(예: 219 125 33 대신 219, 125, 33).
4. 예제 데이터 세트
이 부분에서는 생산 과정에서 사용될 수 있는 5가지 재료를 특징으로 하는 간단한 예시 데이터 세트를 살펴보겠습니다.
따라서 여기서 우리는 다음 기본 알레르겐 그룹을 이러한 상품에 할당할 것입니다. CSV 가져오기의 경우 동시에 텍스트 색상도 할당할 것입니다.
- 가루 – 밀(빨간색) & 글루텐(보라색)
- 치즈 – 유제품(노란색)
- 달걀 – 계란(녹색)
- 대두 – 콩(파란색)
- 아몬드 – 견과류(오렌지)
5. 방법론
5.1. JSON – 가져오기
'AllergenLink' 가져오기 Endpoint/URI –
http://host:port/V5-API/api/integrate/import/allergen_link
견본:
'AllergenLink' 엔드포인트를 사용하면 다음과 같이 위 추가 사항에 대한 가져오기 파일을 구성할 수 있습니다.
이 샘플 JSON 파일은 여기에서 다운로드할 수 있습니다.
이를 시스템에 게시하면 모든 상품이 올바른 알레르기 그룹에 지정되었음을 확인할 수 있습니다. 이 경우 '견과류'의 아몬드가 해당됩니다.
5.2. CSV – 가져오기
CSV 가져오기의 경우 먼저 가져오기에 대한 헤더 파일을 구성해야 합니다.
헤더/열 정의 파일 이름: “allergenLink.csvh”
완성된 헤더 파일은 “<installdir>\SG Control Center\gateway\import\column_defs” 경로에 배치해야 합니다.
CSV 파일 이름 가져오기: “allergenLink-datetime.csv”
가져올 CSV 파일은 “<설치 디렉터리>\SG Control Center\gateway\import” 폴더에 넣어주세요.
견본:
헤더 파일:
아래에서 예시 헤더 파일을 볼 수 있습니다. 여기서 우리는 정의된 알레르겐 그룹에 상품을 할당하고 그룹에 색상을 추가합니다.
이러한 파일의 구조에 대한 자세한 내용은 메인 통합 페이지를 참조하십시오 . 샘플 헤더 파일은 여기에서 다운로드할 수 있습니다.
CSV 가져오기 파일:
그런 다음 헤더에서 정의된 데이터 포인트 순서를 사용하여 가져오기 파일을 구조화할 수 있습니다. 이 첫 번째 행은 Control Center에서 무시할 수 있으므로 가져오기를 위해 제출할 때 파일에 보관할 수 있습니다. 위의 요구 사항에 따른 가져오기 예는 다음과 같습니다.
RGB 값을 구분하는 데 일반적으로 사용되는 쉼표가 필요하지 않다는 점을 다시 한번 강조합니다. 이 샘플 가져오기 파일은 여기에서 다운로드할 수 있습니다.
그런 다음 위에 정의한 대로 이 파일을 가져오기 폴더에 놓을 수 있으며 가져오기가 완료되면 알레르겐 그룹 텍스트 색상이 업데이트된 것을 확인할 수 있습니다.
그리고 각 그룹을 살펴보면 우리가 원하는 알레르겐이 추가된 것을 볼 수 있습니다.
