현재 위치 :

홈
API
방식

방식

V5 통합 가이드!

V5 Traceability와 고객 ERP 시스템 간의 공식 통합을 통해 공식/레시피/자재 명세서를 가져올 수 있으며, 이를 통해 예약할 수 있습니다. 작업 지시 생산 배치 or 제품 V5 터미널을 사용합니다.

V5 Traceability의 공식화 모듈 작동 방식에 대한 자세한 내용은 모듈 가이드를 참조하세요. 여기에서 확인하세요.

차례

제어 센터 레이아웃
API 링크
통합 템플릿
수식 필드 가이드
방법론

1. 컨트롤 센터 레이아웃

제어 센터에 표시되는 내용과 수식 세부 정보를 어떻게 연관시킬 수 있는지에 관해 V5 API와 게이트웨이를 사용하여 상위 항목을 모두 채울 것입니다. ‘Formula’ 수식 헤더 데이터를 입력하는 패널과 하단 ‘Formula Step’ 수식 단계 세부정보를 입력하는 패널입니다.

통합 방법에 따라 다음을 활용하게 됩니다. ‘Formula’ ‘FormulaStep’ 끝점을 사용하여 두 패널을 모두 채우고 수식 설정을 완료합니다.

2. API 링크

이러한 데이터베이스 클래스의 정의에 대해 자세히 알아보려면 다음 링크를 참조하십시오.

공식

공식 단계

3. 통합 템플릿

수식용 통합 템플릿을 다운로드할 수 있습니다. 여기에서 확인하세요.

4. 수식 필드 가이드

4.1. 기본 키

기본 키는 V5 API 내의 각 테이블에 대한 고유 식별자입니다. 을 위한 Formula, 이것은:

commodity.code – 공식의 기본 상품 코드입니다. 공식/레시피 번호입니다.

럭셔리 FormulaStep, 기본 키는 다음과 같습니다.

formula.commodity.code – 위에서 설명한 대로 공식 자체에 대한 동일한 상품 코드입니다.

sequence – 공식 설정 내에서 개별 공식 단계의 순서(예: 1, 2, 3 등)를 결정하는 데 사용됩니다.

4.2. 필수 입력 사항

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

럭셔리 Formula:

type - 수식의 유형입니다. 이 값은 0(배치 공식의 경우) 또는 1(제품 공식의 경우)이어야 합니다.

defaultSize – '기본 크기'라는 공식이 나옵니다.

commodity.units.code – 공식이 생성되는 중량 단위. 명시되지 않은 경우 데이터베이스의 기본 측정 단위로 공식이 생성됩니다.

럭셔리 FormulaStep:

type – 공식 단계 유형.

단계 유형은 다음과 같습니다.

0 – 무게
1 – 키 입력
2 – 질문
3 – 메시지
4 – 컨테이너 변경
5 – 제품 구성요소
6 – 제품 포장
7 – 서브믹스
8 – 데이터 정렬
9 - 대량 처리
10 - 선택 사항
11 – 스캔
12 - 개정
13 – 일시 중지

4.3. 선호 분야

기본 필드는 해당 수식에 대한 추가 정보를 추가하는 데 사용되며, 필수는 아니지만 V5 추적성 내에서 기능을 추가할 때 유용합니다.

럭셔리 Formula 해당 필드는 다음과 같습니다.

commodity.units.code – 공식이 생성되는 중량 단위. 명시되지 않은 경우 데이터베이스의 기본 측정 단위로 공식이 생성됩니다.

minimumProducts - 생산할 수 있는 배치의 최소 크기

maximumProducts – 생산할 수 있는 배치의 최대 크기입니다.

럭셔리 FormulaStep 해당 필드는 다음과 같습니다.

sequence – 배합 단계의 순서, 즉 생산 중에 처리되어야 하는 순서.

commodity.code – 특정 단계에 사용되는 상품/성분

targetQty – 특정 단계의 목표 가중치

unit.code – 특정 단계의 단위

question.question– 이 단계가 질문이나 메시지인 경우 이 필드를 사용하여 입력할 수 있습니다.

기본 키와 필수 필드 섹션에서 본 것처럼 이 2' 사이를 이동할 수 있습니다.formula'와'formulaStep' 클래스를 사용하므로 해당 클래스를 성공적으로 탐색할 수 있는 경우 두 클래스 모두에 사용할 수 있도록 위의 데이터 포인트를 포함할 수 있습니다.

4.4. 추가 필드

다음과 같은 추가 필드도 포함될 수 있습니다. FormulaStep:

upperTol - 해당 특정 단계에 대한 상한 허용 오차, 즉 최대 중량은 공식이 생성될 때 허용되는 목표 수량을 초과할 수 있습니다.

lowerTol – 해당 특정 단계에 대한 허용 오차가 더 낮습니다. 즉, 공식이 생산될 때 최대 중량이 목표 수량 미만으로 허용될 수 있습니다.

schedule – 공식이 생성될 때 단계를 예약해야 하는지 여부. 서브믹스이고 마스터 포뮬러와 동시에 생성되어야 하는 단계에 유용합니다.

위에서 논의한 것처럼, 우리는 다음을 사용할 때 이러한 데이터 포인트를 계속 활용할 수 있습니다. ‘formula’ 간단히 말해서 ‘formulaStep’ 추가하여 수업 ‘formulaStep’ 위의 각각에.

5. 방법론

수식에 대한 통합 방법에 따라 일반적으로 다른 끝점을 사용합니다. API 통합의 경우 일반적으로 다음을 사용합니다. ‘Formula’및 CSV의 경우 ‘FormulaStep’. 이제 이 두 가지를 모두 살펴보고 이것이 왜 그런지 알 수 있습니다.

5.1. JSON – 가져오기

수식 :

우리는 다음을 활용할 수 있습니다. ‘Formula’ 엔드포인트를 사용하여 V5 Traceability에서 생산을 위한 새로운 공식을 생성합니다. 앞으로 살펴보겠지만 이 끝점을 사용하면 수식 헤더와 단계 정보를 하나의 파일에 쉽게 캡처할 수 있습니다.

‘Formula’ 끝점/URI 가져오기 –

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

엔드포인트 설명

이 샘플 가져오기의 경우 ‘Formula’ 끝점을 사용하면 아래와 같이 2개의 수식 단계를 사용하여 단일 수식에 대한 기본 가져오기 파일을 구성할 수 있습니다.

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

API 매뉴얼을 사용하여 이 가져오기에 사용해야 하는 다양한 클래스를 탐색하는 데 사용하는 경로를 표시할 수 있습니다. 에서 ‘Formula’ 클래스에서 우리가 사용하는 것은 모두 ‘type’ ‘productionLocation’. 여기에서 우리는 공식 상품 정보를 정의해야 하며, 이는 다음을 통과하여 수행할 수 있습니다. ‘Formula’ 에 ‘Commodity’. 여기에서 배합표 자체에 대한 상품 정보(해당 코드, 설명 등)를 입력할 수 있습니다.

그런 다음 공식 단계를 정의하려면 먼저 ‘FormulaStep’ 단계 유형, 목표 수량, 공차 등을 정의할 수 있는 클래스입니다. 여기에서 다시 다음으로 이동합니다. ‘Commodity’ 단, 여기에서는 클래스로 이동한 경로로 인해 위에서 이미 정의한 헤더 정보 대신 특정 공식 단계에 사용되는 성분에 대한 상품 정보를 정의하게 됩니다.

여기에서 우리는 두 곳 모두에서 횡단할 것입니다. ‘Commodity’ 도착하는 수업 ‘WeightUnit’ 클래스에서는 공식 자체는 물론 각 개별 단계에 대한 단위를 정의할 수 있습니다. 따라서 이를 위해 동일한 클래스를 사용하더라도 두 가지 다른 방식으로 도달했으며 이는 우리가 볼 수 있는 정의에 반영됩니다(commodity.units.code vs formulaStep.commodity.units.code), 원하는 경우 다른 단위를 사용할 수 있습니다.

위 JSON 파일을 생성하는 데 필요한 경로 찾기 요약은 여기에서 확인할 수 있습니다.

유사한 경로 찾기 방법을 사용하여 필요한 나머지 데이터 포인트를 구축할 수 있습니다.

위의 JSON 파일을 실행하면 이제 이 새로운 수식이 해당 단계와 함께 제어 센터의 '수식' 탭에 표시되는 것을 볼 수 있습니다.

공식단계:

‘FormulaStep’ 끝점/URI 가져오기 –

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

엔드포인트 설명

이 샘플 가져오기의 경우 ‘FormulaStep’ 끝점에서는 위에서 수행한 것과 동일한 수식을 가져오는 방법을 살펴보지만 이름만 변경하겠습니다. 이 끝점을 사용하여 이 파일을 아래와 같이 구성할 수 있습니다.

우리는 또한 사용할 수 있습니다 ‘FormulaStep’ V5 Traceability에서 생산을 위한 새로운 공식을 생성하기 위한 엔드포인트입니다. 이는 다음을 사용하는 것과 거의 같은 방식으로 작동합니다. ‘Formula’ 그러나 우리는 효과적으로 데이터베이스 클래스를 역순으로 순회해야 하므로, ‘Formula’ 에 ‘FormulaStep’, 우리는 ‘FormulaStep’ 에 ‘Formula’. 아래에서 이것이 어떻게 작동하는지 확인할 수 있습니다.

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

여기에서 볼 수 있듯이 단계 측면에서 동일한 정보를 입력하고 수식 이름만 변경하고 있습니다. 여기에서 ‘formulaStep’ 클래스에 ‘formula’ 클래스, 그리고 이 정보가 각 수식 단계마다 중첩되어야 한다는 사실입니다.

이제 이 예제 JSON 파일을 실행하면 중복 수식은 이제 사용할 때 본 것과 동일한 설정으로 생성됩니다. ‘Formula’ 엔드 포인트.

5.2. JSON – 내보내기

V5 API에서 공식/레시피와 관련된 파일을 다시 수신하는 측면에서 여기서는 실제로 소비 데이터를 추적하지 않으므로 대신 단순히 공식의 구성/설정을 내보내겠습니다. 사용 가능한 옵션을 확인하면 이에 대한 몇 가지 옵션이 아직 남아 있습니다. ‘IntegrationExport’ 서비스:

수식 :

엔드포인트/URI 내보내기 –

http://host:port/V5-API/api/integrate/export/formula/{code}

엔드포인트 설명

이 끝점은 특정 수식에 대한 모든 관련 정보가 포함된 JSON 파일을 내보냅니다. 우리가 생성한 공식에 대해 이 GET 요청을 실행하면 ‘Formula’ 끝점을 통과하면 다음과 같은 반환 파일을 얻게 됩니다.

예제 JSON 파일을 다운로드할 수 있습니다. 여기에서 확인하세요.

All Formulas:

엔드포인트/URI 내보내기 –

http://host:port/V5-API/api/integrate/export/formulas

엔드포인트 설명

이 끝점은 시스템 내에 포함된 모든 수식 목록을 포함하는 JSON 파일을 내보냅니다. 이렇게 하면 각 수식의 헤더 데이터만 반환됩니다. 공식 단계를 검색하려면 아래를 참조하세요.

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

공식 단계:

엔드포인트/URI 내보내기 –

http://host:port/V5-API/api/integrate/export/formula_step/{code}/{sequence}

엔드포인트 설명

특정 수식의 특정 단계에 대한 데이터를 반환하도록 이 끝점을 구성할 수 있습니다. 시퀀스 번호를 사용하여 검색하려는 단계를 지정합니다. 위에서 만든 첫 번째 예제 수식의 1단계를 검색하기 위해 이 끝점에 도달하면 다음과 같은 결과를 얻게 됩니다.

이 예제 JSON 파일을 다운로드할 수 있습니다. 여기에서 확인하세요.

공식 단계:

엔드포인트/URI 내보내기 –

http://host:port/V5-API/api/integrate/export/formula_steps/{all}

엔드포인트 설명

이 끝점은 시스템 내의 모든 수식 단계 목록을 제공합니다. 다음 중 하나를 사용하여 반환을 변경할 수 있습니다. ‘/true’ or ‘/false’ 대신에 ‘/{all}’ 위의 URI에서. ‘True’ 시스템의 모든 단계 목록을 내보내는 반면 ‘false’ 이미 내보낸 것으로 표시되지 않은 단계 목록을 반환합니다.

이는 더 많은 단계가 있다는 점만 제외하면 위의 예와 레이아웃이 매우 유사해 보입니다. 의 예 ‘true’ 이 유형의 내보내기를 다운로드할 수 있습니다. 여기에서 확인하세요.

5.3. CSV – 가져오기

참고: 가져온 후에는 수식 헤더의 '수입 면제' 상자를 체크하여 수식을 변경으로부터 보호할 수 있습니다. 제어 센터. 이는 CSV 방법론에만 적용됩니다.

위의 JSON 예제에서 두 가지를 모두 사용할 수 있음을 확인했습니다. ‘formula’ ‘formulaStep’ 특정 방법론에 대한 끝점. 그러나 CSV 가져오기의 경우에는 ‘formulaStep’ 엔드 포인트.

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

완료된 헤더 파일은 다음 위치에 있어야 합니다. “<installdir>\SG Control Center\gateway\import\column_defs”

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

가져올 CSV는 다음 위치에 있어야 합니다. “<installdir>\SG Control Center\gateway\import”

헤더 파일:

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

이러한 파일을 구성하는 방법에 대한 자세한 내용은 다음을 참조하십시오. 기본 통합 페이지. 이 샘플 헤더 파일은 다운로드할 수 있습니다. 여기에서 확인하세요.

CSV 가져오기 파일:

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

다시 위의 JSON 방법을 통해 생성한 2의 중복 수식을 생성합니다. 수식에 대한 예제 csv 가져오기 파일은 다음과 같습니다.