현재 위치 :

홈
API
측정 단위

측정 단위

V5 통합 가이드!

V5 Traceability와 고객의 ERP 시스템 간의 측정 단위 통합을 통해 ERP/타사 시스템에서 사용하는 측정 단위를 V5 Traceability로 보낼 수 있습니다. 그런 다음 이러한 단위를 V5 Traceability 시스템 내에서 창고 및 제형/생산에 적용할 수 있습니다.

V5 추적 시스템의 유연성은 케이스와 드럼과 같은 대량의 수량에 대한 사용자 정의 단위 변환을 설정하고 상품별 변환율을 설정할 수 있는 기능을 통해 완전히 사용자 정의 단위 설정을 가능하게 합니다. 특정 변환율은 아래 예에서 볼 수 있듯이 특정 밀도의 품목에 특히 유용합니다.

여기서 살펴볼 'WeightUnit'과 'UnitCommodity' 클래스에 대해서는 가져오기만 가능합니다. JSON이나 CSV 방식을 통한 내보내기는 불가능합니다.

V5 추적성에서 측정 단위가 작동하는 방식에 대한 자세한 내용은 모듈 가이드를 참조하세요. 여기에서 확인하세요.

1. 컨트롤 센터 레이아웃

제어 센터에서 보는 것과 단위 및 상품별 환율을 어떻게 연관시킬 수 있는지 살펴보면, 여기 위쪽 패널은 측정 단위를 입력하는 데 사용되고, 아래쪽 패널은 위쪽 패널에서 선택한 단위에 대한 상품별 환율을 입력하는 데 사용됩니다.

하단 패널에 주어진 상품에 대한 항목이 없는 경우, 상품이 해당 단위와 함께 사용될 때 시스템은 상단 패널에 설정된 변환율로 돌아갑니다. 하단 패널에 상품을 추가하고 변환율을 추가하면('UnitCommodity') 상단 패널의 변환율을 재정의합니다.

V5 Gateway를 사용하면 두 패널을 쉽게 채울 수 있습니다.

2. API 링크

단위를 추가하는 데 사용할 2개의 데이터베이스 클래스에 대한 정의에 대해 자세히 알아보려면 다음 링크를 참조하세요.

무게 단위

단위상품

3. 통합 템플릿

WeightUnit(측정 단위)에 대한 통합 템플릿을 다운로드할 수 있습니다. 여기에서 확인하세요.

UnitCommodity(상품별 변환율)에 대한 통합 템플릿을 다운로드할 수 있습니다. 여기에서 확인하세요.

4. 단위 현장 가이드

4.1. 기본 키

기본 키는 V5 API 내의 각 테이블에 대한 고유 식별자입니다.

럭셔리 무게 단위, 이것은:

암호 – 측정 단위(예: g, kg, lb, oz 등)에 대한 고유 코드

럭셔리 단위상품, 기본 키는 다음과 같습니다.

단위.코드 – 위와 같이 측정 단위의 고유 코드입니다.

상품 코드 – 특정 환율을 적용할 상품의 고유 코드입니다.

4.2. 필수 입력 사항

제어 센터에 유효한 항목을 채우기 위해 SG가 요구하는 기타 필드는 다음과 같습니다.

럭셔리 무게 단위:

전환율 - 데이터베이스에서 ID가 1인 단위와 관련된 이 단위의 환율입니다.

럭셔리 단위상품:

전환율 – 특정 상품에 대한 특정 환율.

4.3. 선호 분야

선호 필드는 측정 단위에 더 많은 정보를 추가하는 데 사용됩니다.무게 단위), 필수는 아니지만 V5 추적성과 관련된 기능이라면 유용합니다.

설명 - 단위 설명(킬로, 파운드 등)

4.4. 추가 필드

추가 필드도 포함될 수 있습니다. 무게 단위같은 :

노트 – 단위에 대한 추가 참고 사항

5. 방법론

이 클래스의 비교적 간단한 특성을 감안하면 JSON 또는 CSV 통합을 사용하여 V5로 단위를 가져올 수 있습니다. 누락된 단위를 시스템으로 가져오기 위한 초기 가져오기를 수행하는 관점에서 이를 살펴보겠습니다(weightUnit). 그런 다음 시스템의 단위를 사용하여 상품별 변환을 할당합니다(UnitCommodity). 두 엔드포인트/클래스에 대한 내보내기가 없다는 점에 다시 한 번 유의하세요.

6. 무게 단위

6.1. JSON – 가져오기

''WeightUnit' 가져오기 Endpoint/URI –

http://host:port/V5-API/api/integrate/import/unit

엔드포인트 설명

견본:

이 샘플 가져오기의 경우, 'WeighUnit' 엔드포인트를 사용하여 소개에서 위에 표시된 Control Center Units 테이블에 파운드와 온스를 추가합니다. 이를 위한 JSON 파일은 다음과 같습니다.

변환율은 항상 기본 단위(즉, 단위 표의 첫 번째 단위)를 기준으로 계산되므로 여기서는 킬로그램(kg)을 기준으로 계산합니다.

이 샘플 JSON 파일은 다운로드할 수 있습니다. 여기에서 확인하세요.

위 파일을 사용하면 새로운 단위가 제어 센터에 생성되었음을 확인할 수 있습니다.

6.2. JSON – 내보내기

'WeightUnit' 클래스에 대한 JSON 내보내기가 제공되지 않습니다.

6.3. CSV – 가져오기

헤더/열 정의 파일 이름: “weightUnit.csvh”

완료된 헤더 파일은 다음 위치에 있어야 합니다. “ \SG 제어 센터\게이트웨이\가져오기\column_defs”

CSV 파일 이름 가져오기: “weightUnit-datetime.csv”

가져올 CSV는 다음 위치에 있어야 합니다. “ \SG 제어 센터\게이트웨이\가져오기”

견본:

헤더 파일:

헤더 파일은 일반적으로 CSV 통합이 이루어지기 전에 SG Systems에서 컴파일되지만 아래에서 단위에 사용할 수 있는 기본적인 예를 볼 수 있습니다.

이러한 파일을 구성하는 방법에 대한 자세한 내용은 다음을 참조하십시오. 기본 통합 페이지.

이 샘플 헤더 파일은 다운로드할 수 있습니다. 여기에서 확인하세요.

CSV 가져오기 파일:

그런 다음 헤더에서 정의된 데이터 요소 순서를 사용하여 가져오기 파일을 구조화할 수 있습니다. SG Systems는 이를 위한 템플릿 파일을 제공하여 목록을 채울 때 항목을 더 명확하게 하기 위해 각 열에 대한 데이터 포인트를 나열할 수 있습니다. 이 첫 번째 행은 제어 센터에서 무시할 수 있으므로 가져오기를 위해 제출할 때 파일에 보관할 수 있습니다.

여기서는 위의 JSON 예제에서와 동일한 새로운 단위를 생성하는 것을 볼 수 있습니다. 다만 제어 센터에서 더 명확하게 표시되도록 단위의 코드에는 소문자를 사용했습니다.

이 샘플 가져오기 파일을 다운로드할 수 있습니다. 여기에서 확인하세요.

가져오기가 완료되면 새로운 단위가 다시 생성된 것을 볼 수 있습니다.

6.4. CSV – 내보내기

JSON 내보내기와 마찬가지로 'WeightUnit' 클래스에는 CSV 내보내기가 제공되지 않습니다.

7. 단위상품

7.1. JSON – 가져오기

'UnitCommodity' 가져오기 Endpoint/URI –

http://host:port/V5-API/api/integrate/import/unit_commodity

엔드포인트 설명

견본:

이 샘플 가져오기의 경우 'UnitCommodity' 엔드포인트를 사용하여 우유 리터에 대한 특정 단위 변환을 추가합니다. 위의 제어 센터에서 리터는 일반적으로 리터에서 kg으로 1:1 비율로 변환되는 것을 볼 수 있습니다. 즉, 1리터의 물은 1kg의 무게가 됩니다. 그러나 1.035리터의 우유는 이보다 약간 더 무겁습니다(XNUMXkg). 따라서 아래에서 JSON 가져오기를 위해 이를 설정하는 방법을 살펴보겠습니다.