현재 위치 :

홈
API
작업/생산 주문

작업/생산 주문

V5 통합 가이드!

V5 Traceability와 고객의 ERP 시스템 간의 작업/생산 주문 통합을 통해 배치 및 제품 공식에 대한 작업 주문을 V5 Traceability 내에서 예약할 수 있습니다. 이러한 세부 정보를 통해 V5 터미널에서 해당 작업을 처리할 수 있습니다.

차례

제어 센터 레이아웃
API 링크
통합 템플릿
작업/생산 주문 현장 가이드
방법론

1. 컨트롤 센터 레이아웃

작업 세부 정보를 제어 센터에 표시되는 내용과 연결하는 방법과 관련하여 주로 V5 API를 사용하여 위쪽 '작업' 패널을 채워 이러한 세부 정보를 아래쪽 '작업 라인' 패널의 정보로 가져오고 내보낼 것입니다. 공식/레시피 설정에 따라 자동으로 채워집니다.

V5 게이트웨이를 사용하면 여기에 데이터를 쉽게 채울 수 있습니다. ‘Job’ 끝점. 그러나 다음을 활용하는 보다 진보된 접근 방식을 취할 수 있습니다. ‘PreBatch’ 끝점. 아래에서 이 두 가지를 모두 사용하는 방법을 살펴보겠습니다.

2. API 링크

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

Job

PreBatch

3. 통합 템플릿

작업/생산 주문에 대한 통합 템플릿을 다운로드할 수 있습니다. 여기에서 확인하세요.

4. 작업/생산 주문 현장 가이드

4.1. 기본 키

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

jobNumber - 작업의 고유 식별 코드입니다.

formula.commodity.code – 예약할 배합표의 고유 식별 코드입니다.

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

jobLine.job.jobNumber - 위와 같이 작업의 고유 식별 코드입니다.

BatchSeq – 특정 작업 라인에 대한 배치의 생산 순서.

4.2. 필수 입력 사항

제어 센터에서 유효한 작업 라인을 채우려면 SG에서 다른 필드가 필요합니다. 을 위한 Job, 이것은:

products - 이 작업의 최상위(작업) 라인에 의해 배치당 필요한 제품 수(공식의 기본 단위와 관련됨)입니다.

럭셔리 PreBatch, 이것은:

products - 개별 배치에서 생산해야 하는 제품 수입니다.

4.3. 선호 분야

기본 필드는 해당 작업에 대한 더 많은 정보를 추가하는 역할을 하며, 필수는 아니지만 V5 Traceability 내에서 추가 기능을 제공할 때 유용합니다. 을 위한 Job, 여기에는 다음이 포함될 수 있습니다.

batchesRequired - 작업에 필요한 배치 수입니다. 이것이 없으면 시스템은 제품의 양(위에 설명된)과 기본 크기 + 최소/최대 제품 생산할 배치 수를 계산합니다.

status - 작업을 가져오는 상태(0 = 보류 중, 1 = 예약됨, 2 = 진행 중, 3 = 완료, 4 = 테스트 중, 5 = 보류 중)이며 작업은 일반적으로 '1' 상태로 가져옵니다. 나중에 수동으로 예약하지 않는 한 '0' 상태로 가져올 수 있습니다.

이 필드는 다음에도 적용될 수 있습니다. PreBatch API 내에서 작업 개체로 이동한 후입니다.

4.4. 추가 필드

추가 필드도 Job 다음과 같은 엔드포인트:

productionDate - 작업이 생성될 날짜입니다. 존재하지 않는 경우 공백으로 가져오므로 작업이 터미널에서 항상 표시될 수 있습니다.

럭셔리 PreBatch, 우리는 아래의 동일한 필드로 이동할 수 있습니다 jobLine.job.productionDate. 그러나 우리는 다음을 사용할 수도 있습니다. jobLine.productionDate 필드는 전체 작업 자체가 아닌 개별 작업 라인의 생산 날짜에 영향을 미치므로 생산 프로세스를 더욱 엄격하게 제어할 수 있습니다.

5. 방법론

통합에 사용되는 방법에 따라 다음 엔드포인트를 사용하여 가져오기를 용이하게 할 수 있습니다. 이는 다음 중 하나일 수 있습니다.

‘Job’ or ‘Prebatch’ JSON 통합을 위한 엔드포인트.
‘Job’ CSV 파일 공유 통합을 위한 엔드포인트입니다.

내보내기는 다양한 방법으로 처리될 수 있으며, 이에 대해서는 아래에서 모두 살펴보겠습니다.

5.1. JSON – 가져오기

일:

우리는 다음을 활용할 수 있습니다. ‘Job’ V5 Traceability에서 생산을 위한 새로운 작업을 생성하는 엔드포인트입니다.

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

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

엔드포인트 설명

이 샘플 가져오기의 경우 ‘Job’ 엔드포인트를 사용하면 단일 작업에 대한 기본 가져오기 파일을 아래와 같이 구성할 수 있습니다.

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

API 매뉴얼을 사용하면 여기에서 우리가 여러 데이터 포인트를 사용하고 있음을 알 수 있습니다. ‘Job’ 이 파일을 구성하는 클래스입니다. 그러나 생성하려는 수식 코드를 올바르게 호출하려면 먼저 다음으로 이동해야 합니다. ‘Formula’ 클래스를 선택한 다음 ‘Commodity’ 정의하는 클래스 ‘Code’ 위에서 볼 수 있듯이 사용할 수 있는 데이터 포인트를 JSON 파일에 적절하게 중첩합니다.

아래에서 이 데이터 흐름 프로세스의 요약을 볼 수 있습니다.

위의 JSON 파일을 실행하면 이제 제어 센터의 '프로덕션' 탭에 작업이 표시되는 것을 볼 수 있습니다.

하단 패널에 작업 라인이 자동으로 생성되었음을 알 수 있습니다. 그만큼 ‘Job’ 엔드포인트는 다음을 기반으로 이 작업을 자동으로 수행합니다. 공식 구조.

사전 배치:

위에서 우리가 사용할 수 있는 것을 볼 수 있습니다. ‘Job’ V5 Traceability의 생산 계획에 간단한 작업을 입력하는 엔드포인트입니다. 그러나 작업 설정을 보다 정확하게 제어하려면 다음을 사용할 수 있습니다. ‘PreBatch’ 대신 URI를 사용하세요. 이를 통해 개별 배치 크기/제품 수 및 생산 위치와 같은 세부 사항을 지정할 수 있습니다.

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

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

엔드포인트 설명

이 샘플 가져오기의 경우 ‘PreBatch’ 엔드포인트를 사용하면 아래와 같이 여러 배치가 포함된 단일 작업에 대한 기본 가져오기 파일을 구성할 수 있습니다.

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

따라서 이 파일을 검토하면 '기본 빵 반죽' 공식의 배치 111개(제조 2에서 만들어지는 30파운드용 배치와 1파운드용 배치)를 사용하여 새 작업(Job-50)을 생성하고 있음을 알 수 있습니다. 2. API 매뉴얼을 보면 ‘PreBatch’ 클래스를 사용하면 여기에서 파일을 구성하기 위해 유사한 탐색 방법을 볼 수 있습니다.

위의 JSON 파일을 실행하면 이 새 작업이 생성된 것을 볼 수 있으며, 배치 보기를 살펴보면 배치 크기/생산 위치 및 사전 설정된 사용자 정의의 차이점을 볼 수 있습니다. 배치 번호. 원하는 경우 배치 시퀀싱도 여기에 포함될 수 있습니다.

5.2. JSON – 내보내기

V5 API에서 작업과 관련된 파일을 다시 수신하는 것과 관련하여 우리가 사용할 수 있는 IntegrationExport 및 ImportTransaction 클래스 모두에서 몇 가지 다른 옵션을 살펴보겠습니다.

일:

개별 작업 내보내기 끝점/URI –

http://host:port/V5-API/api/integrate/export/job/{jobNumber}

엔드포인트 설명

이 엔드포인트는 지정된 작업에 대한 모든 관련 정보가 포함된 JSON 파일을 내보냅니다. 방금 가져온 작업에 대한 작업 번호를 사용하여 이 요청을 실행하면 다음과 같은 파일이 생성됩니다.

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

모든 직업:

모든 작업 내보내기 끝점/URI

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

엔드포인트 설명

이 엔드포인트는 모든 항목의 목록을 포함하는 JSON 파일을 내보냅니다. 활동적인 상태가 '완료'가 아니거나 제어 센터에서 삭제된 작업으로 정의된 시스템의 작업입니다.

이 요청을 실행하면 위의 단일 작업 내보내기와 거의 동일하게 구성된 반환 JSON 파일을 받게 되지만 앞서 언급한 대로 모든 활성 작업이 포함됩니다.

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

우리는 또한 활용할 수 있습니다 트랜잭션 및 로그 엔드포인트 작업 및 생산 주문에 대한 보다 관련성 있는 정보를 검색합니다.

럭셔리 시스템 로그 엔드포인트는 다음과 같습니다.

작업 로그

소비/생산된 시스템 로그

5.3. CSV – 가져오기

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

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

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

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

헤더 파일:

헤더 파일은 일반적으로 CSV 통합이 발생하기 전에 SG Systems에서 컴파일되지만 이전에 정의된 헤더 파일을 사용하여 작업에 사용할 수 있는 기본 예를 볼 수 있습니다. 클래스 정의아래 :

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

CSV 가져오기 파일:

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

작업에 대한 예제 csv 가져오기 파일은 다음과 같습니다.

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

가져오기가 완료되면 위의 JSON 가져오기를 사용하여 생성한 작업과 함께 이러한 추가 작업이 제어 센터에 추가된 것을 확인할 수 있습니다.

5.4. CSV – 내보내기

JSON 내보내기와 마찬가지로 여기에는 몇 가지 다른 옵션이 있습니다. 간단히 시스템 내에서 작업 목록을 내보내는 것부터 시작할 수 있습니다.

작업/일정:

내보내기 CSV 파일 이름: “job.csvh”

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

내보내기 CSV 파일 이름: “job-datetime.csv”

내보내기용 CSV는 다음에서 생성됩니다. “<installdir>\SG Control Center\gateway\export”

이전에 정의한 클래스 정의를 사용하여 헤더 파일을 구성하여 반환할 데이터를 정의할 수 있습니다.

이 내보내기는 제어 센터의 게이트웨이 섹션에서 활성화되어야 합니다. 여기에서 '일정'을 내보내도록 선택할 수 있습니다.

헤더 파일:

이 경우 위에서 가져오기에 사용한 것과 동일한 헤더 파일을 사용하겠습니다.

CSV 내보내기 파일:

다음과 같은 반환 CSV 파일을 얻게 됩니다.

이 파일 형식의 예를 다운로드할 수 있습니다. 여기에서 확인하세요. 표시된 폴더에 헤더 파일이 없는 경우 CSV는 해당 폴더의 모든 데이터 포인트를 포함하는 내용을 내보냅니다. ‘Job’ 클래스입니다.

이 엔드포인트는 작업 목록만 내보내지만 몇 가지 다른 엔드포인트를 사용하여 소비 및 생산과 관련된 더 자세한 정보를 검색할 수 있습니다.

배치 로그:

내보내기 CSV 파일 이름: “BatchLog-datetime.csv”

내보내기용 CSV는 다음에서 생성됩니다. “<installdir>\SG Control Center\gateway\export”

V5 Traceability에서 작업 생산 데이터를 CSV 형식으로 다시 가져오는 가장 간단한 방법은 '배치 로그'를 사용하고 처리하는 것입니다.

다시 말하지만, 이 내보내기는 제어 센터의 게이트웨이 섹션에서도 활성화되어야 합니다. 여기에서 'Batch Logs(배치 로그)'를 내보내도록 선택할 수 있습니다.

CSV 내보내기 파일:

V5 게이트웨이는 기본적으로 데이터 포인트 세트 목록을 채우기 때문에 여기서 헤더 파일을 작성할 필요가 없습니다. 이 내보내기가 활성화되면 시스템은 다음을 내보냅니다. ‘BatchLog’ 작업 내의 배치가 시스템에 의해 완료될 때마다 파일을 제출하세요. 이에 대한 기본적인 예는 다음과 같습니다.