커스텀필드링크

V5 통합 가이드!

'CustomFieldLink' 가져오기 엔드포인트는 제품별로 제품 라벨에 인쇄할 수 있는 사용자 정의 라벨 메시지를 상품(일반적으로 완제품 공식)에 빠르게 할당하는 데 사용할 수 있습니다.

이것이 어떻게 작동하는지에 대한 자세한 정보와 사용자 정의 필드 사용의 다양한 예를 찾을 수 있습니다. 여기에서 확인하세요.

이 가이드에서는 CSV 가져오기와 V5 API를 통한 JSON 사용을 통해 이 엔드포인트를 사용하는 방법에 중점을 둡니다.

차례

1. 컨트롤 센터 레이아웃

사용자 정의 필드 세부 정보를 제어 센터에서 보는 것과 연관시키는 방법 측면에서, V5 API와 Gateway를 사용하여 위쪽 'CustomField' 패널을 채워 사용자 정의 필드의 이름을 지정하고 레이블 매개변수 세부 정보를 입력하고, 아래쪽 'CustomFieldLink' 패널을 채워 사용자 정의 필드에 상품을 할당하고 위쪽 패널에 설정된 레이블 매개변수로 다시 불러올 수 있는 수식별 정보를 입력합니다.

 
'CustomFieldLink' 엔드포인트를 사용하여 두 패널을 채웁니다.

2. API 링크

이 'CustomFieldLink' 클래스의 정의에 대해 자세히 알아보려면 다음 링크를 참조하세요.

커스텀필드링크 

3. CustomFieldLink 필드 가이드

3.1. 기본 키

'CustomFieldLink' 엔드포인트를 통해 가져오는 경우 기본 키는 다음과 같습니다.

필드 이름 – 우리가 추가하거나, 우리의 공식을 할당하는 사용자 정의 필드에 대한 고유한 이름입니다. 위에서 'Distributed By'로 볼 수 있습니다.

상품코드 – 사용자 정의 필드 그룹에 할당할 상품/제품 공식의 고유 코드입니다.

3.2. 필수 입력 사항

우리는 '에서 가져오기를 구체화하기 위해 다른 필요한 데이터를 추가할 수 있습니다.사용자 정의 필드'와'커스텀필드링크' 데이터베이스 클래스. 이것들은 다음과 같습니다:

 

CustomField에서:

필드_레이블매개변수 - 새 사용자 정의 필드 그룹을 만드는 경우 필요한 매개변수로, 이 그룹에서 사용자 정의 데이터를 회수하는 데 레이블에 사용되는 매개변수입니다. 위의 제어 센터 예에서 이것이 'DIST'임을 알 수 있습니다.

필드_기본값 - 레이블 매개변수가 사용될 때 회수되는 기본값은 하단의 'CustomFieldLink' 패널에서 이를 재정의할 상품/공식별 값이 없는 경우입니다. 위의 제어 센터 예에서 이것이 'SG Systems LLC'인 것을 볼 수 있습니다.

 

CustomFieldLink에서:

Data – 사용자 정의 필드 그룹의 라벨 매개변수가 라벨에 사용될 때 해당 상품/공식에 대한 라벨에서 회수할 정보입니다.

4. 예제 데이터 세트

이 부분에서는 이미 생성된 'Distributed By'에 할당할 수 있는 3가지 다른 제품 공식을 특징으로 하는 간단한 예제 데이터 세트를 살펴보겠습니다. 각각에 고유한 배포 메시지를 제공합니다. 또한 'PREP' 라벨 매개변수가 있는 'Preparation Instructions'라는 새 사용자 지정 필드 그룹을 추가합니다.

  

따라서 우리는 시스템에 다음 데이터를 추가할 것입니다.

  • P006 :
    • 배포자 : ABC 유통.
    • 준비 지침 : 사용 전 세척하세요.
  • P007 :
    • 배포자 : 데이브의 유통업체
    • 준비 지침 : 사용 전 세척하세요.
  • P008 :
    • 배포자 : SGS 유통.
    • 준비 지침 : 사용 전 세척하세요.

5. 방법론

5.1. JSON – 가져오기

'CustomFieldLink' Endpoint/URI 가져오기 –

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

엔드포인트 설명

견본:

'CustomFieldLink' 엔드포인트를 사용하면 다음과 같이 위 추가 사항에 대한 가져오기 파일을 구성할 수 있습니다.

 

여기서 '준비 지침' 그룹을 만들었으므로 이 가져오기에 레이블 매개변수를 포함해야 했다는 점에 유의하세요. '배포자' 그룹의 경우 이것이 필요하지 않으며 가져오기에서 그룹 이름만 참조하면 됩니다.

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

그리고 이것을 시스템에 게시하면 샘플 수식이 '배포자' 그룹에 추가된 것을 볼 수 있으며, 하단 패널의 '데이터' 열에 고유한 메시지가 표시됩니다.

  

그리고 우리는 또한 우리의 새로운 그룹이 3명 모두에 대해 동일한 '준비 지침'을 갖도록 만들어졌음을 볼 수 있습니다.

  

5.2. CSV – 가져오기

CSV 가져오기의 경우 먼저 가져오기에 대한 헤더 파일을 구성해야 합니다.

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

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

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

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

 

견본:

헤더 파일:

아래에서 예시 헤더 파일을 볼 수 있습니다. 여기서는 정의된 사용자 정의 필드 그룹에 상품을 할당하고 위에서 정의한 대로 새 그룹을 추가합니다.

 

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

 

CSV 가져오기 파일:

그런 다음 헤더에서 정의된 데이터 포인트 순서를 사용하여 가져오기 파일을 구조화할 수 있습니다. 이 첫 번째 행은 Control Center에서 무시할 수 있으므로 가져오기를 위해 제출할 때 파일에 보관할 수 있습니다. 위의 요구 사항에 따른 가져오기 예는 다음과 같습니다.

 

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

JSON 가져오기와의 차이점은 CSV 가져오기 메커니즘으로 인해 이 경우 '배포자' 그룹에 대한 'DIST' 레이블 매개변수를 포함해야 한다는 것입니다.

그런 다음 위에 정의한 대로 이 파일을 가져오기 폴더에 놓을 수 있으며 가져오기가 완료되면 사용자 정의 필드 그룹이 적절히 업데이트/추가된 것을 볼 수 있습니다.

 

과 :

  

이 페이지가 도움이 되었나요?
가능아니