페이로드 데이터

Transparent Supply 는 표준 GS-1 데이터 유형 이상으로 지원을 확장하기 위한 페이로드 데이터 업로드 메소드를 제공합니다. 페이로드를 사용하여 사용자 정의 데이터 (예: 속성) 를 이벤트, 아이템 (품목, 일련번호 선적 컨테이너, 팔레트) 또는 로케이션에 첨부합니다.

페이로드 유형

페이로드는 <payloadTypeURI> 태그를 사용하여 포함된 데이터의 유형을 지정해야 합니다. 투명 공급 은 다음 페이로드 유형을 정의합니다.

키-값 쌍
센서 데이터
문자열

아래 예제 는 이러한 각 페이로드 유형에 사용해야 하는 <payloadTypeURI> 값을 표시합니다.

첨부 위치

제출된 페이로드는 항목 (제품 ID), EPC, 위치 (기능 ID) 또는 이벤트 (EPCIS 이벤트 ID) 에 첨부되어야 합니다. 페이로드에 다음 데이터 점 중 하나를 포함하십시오.

제품 ID-페이로드 XML에서 productList 요소를 사용하는 제품 ID입니다.
EPC (Electronic Product Code) - 페이로드 XML에서 epcList 요소를 사용하는 EPC-SSCC, FTLPN, SGTIN, SFTPI, LGTIN 또는 LFTPI.
위치 ID-페이로드 XML에서 locationList 요소를 사용하는 공급 체인 위치 (기능 ID).
EPCIS 이벤트 ID-페이로드 XML에서 eventIDList 요소를 사용하여 수수료, 해제, 집계, 집계, 변환 또는 관찰 이벤트의 경우.

참고: 아래의 컨텐츠 유형 예제 는 EPC에 첨부됩니다. <epc>urn:ibm:ift:product:serial:obj:1234567890123.LiveCow.lc11</epc> 을 참조하십시오.

사용 참고

페이로드 데이터를 업로드할 때 다음 사용법 참고를 고려하십시오.

투명한 공급 UI에 표시되는 유일한 페이로드 데이터는 지원되는 제품 ID 또는 기능 ID에 첨부되는 키-값 쌍입니다. 지원되는 형식은 GS1 SSCC, GTIN, SGTIN, LGTIN, GLN, EPC-SGLN및 해당 Transparent Supply 만 해당됩니다.
투명한 공급 UI에서 페이로드의 이름을 변경하려면 제목이 키이고 새 이름이 값인 키-값 쌍을 업로드하십시오.
페이로드 메시지는 32KB를 초과할 수 없습니다.
페이로드는 기본적으로 개인용 인타이틀먼트 모드를 사용합니다.
이벤트 ID에만 첨부된 페이로드는 페이로드의 인타이틀먼트 모드에 관계없이 다른 조직에 대해 권한이 부여되지 않습니다.

페이로드 데이터 제출

Transparent Supply 커넥터 API 자산 엔드포인트를 사용하여 페이로드를 제출하십시오. 페이로드 XML을 자산 매개변수 값 필드에 붙여넣고 시도하십시오 !를 클릭하십시오.

다음 예제는 각 페이로드 유형에 대한 XML을 설명합니다.

키-값 쌍

키-값 쌍 페이로드 데이터 유형을 사용하여 변수-값 조합 세트를 업로드하십시오.

키-값 쌍 페이로드 데이터는 다음 형식을 사용하여 지정해야 합니다.

<payloadTypeURI>urn:ibm:ift:payload:type:json:triple</payloadTypeURI>

다음 코드는 키-값 쌍 페이로드 데이터를 지정하는 샘플 페이로드를 표시합니다.

<ift:payload xmlns:ift="urn:ibm:ift:xsd:1">
  <payloadMessage>
    <payloadID>41b14d7a-5b04-11e9-bdaa-6c4008984c16</payloadID>
    <payloadTime>2019-03-01T08:00:00Z</payloadTime>
    <payloadContentType>application/json</payloadContentType>
    <payloadTypeURI>urn:ibm:ift:payload:type:json:triple</payloadTypeURI>
    <epcList>
      <epc>urn:ibm:ift:product:serial:obj:1234567890123.LiveCow.lc11</epc>
    </epcList>
    <payload>[{"key":"title", "value":"My test payload","type":"string"}, {"key": "Lot Number", "value": "LiveCow.lc11", "type": "string"}, {"key": "Lairage Intake Date", "value": "2019-03-01 08:00:00", "type": "string"}, {"key": "Herd Number", "value": "Herd-lc11", "type": "string"}, {"key": "Site Code", "value": "Site0001", "type": "string"}, {"key": "Eartag", "value": "Ear-lc11", "type": "string"}]</payload>
  </payloadMessage>
</ift:payload>

센서 데이터

센서 페이로드 데이터 유형을 사용하여 센서 디바이스에서 수집한 측정치를 업로드하십시오. 모든 문자열은 센서 데이터 유형의 값으로 허용됩니다. 페이로드는 32KB를 초과할 수 없습니다.

예를 들어, 주변 (위치 온도) 또는 프로브 (제품 온도) 를 기록할 수 있습니다. sensor 페이로드 데이터 유형은 다음 형식을 사용하여 지정되어야 합니다.

<payloadTypeURI>urn:ibm:ift:payload:type:json:sensor:v2</payloadTypeURI>

다음 코드는 지정된 위치에 대한 샘플 주변 온도 (화씨) 센서 데이터 페이로드를 표시합니다.

<ns0:payload xmlns:ns0="urn:ibm:ift:xsd:1">
  <payloadMessage>
    <payloadID>urn:uuid:00000000-0000-0000-0000-00003b9acc47</payloadID>
    <payloadTime>2020-01-15T00:00:00Z</payloadTime>
    <payloadContentType>application/json</payloadContentType>
    <payloadTypeURI>urn:ibm:ift:payload:type:sensor:v2</payloadTypeURI>
    <locationList>
      <location>urn:ibm:ift:location:extension:loc:0070217.5043.0</location>
    </locationList>
    <payload>
      {"payload": {"readings": [{"value": 48.97403963890513, "time": "2020-01-14T00:00:00Z"},
      {"value": 49.38640811696154, "time": "2020-01-14T00:15:00Z"},
      {"value": 49.482325803716854, "time": "2020-01-14T00:30:00Z"},
      {"value": 49.7178481505353, "time": "2020-01-14T00:45:00Z"},
      {"value": 55.114865776213215, "time": "2020-01-14T03:15:00Z"},  
      {"value": 93.69268608689146, "time": "2020-01-14T23:30:00Z"},
      {"value": 94.4938525640488, "time": "2020-01-14T23:45:00Z"}],
      "device_id": "S00001", "type": "gs1:Temperature", "uom": "FAH",
      "reading_type": "urn:ibm:ift:sensor:readingtype:ambient"}}
</payload>
  </payloadMessage>
</ns0:payload>

다음 코드는 지정된 제품 인스턴스 (EPC) 및 하위 위치에 대한 샘플 프로브 온도 (화씨) 센서 데이터 페이로드를 표시합니다.

<?xml version="1.0" encoding="UTF-8"?>
<ift:payload xmlns:ift="urn:ibm:ift:xsd:1">
  <payloadMessage>
    <payloadID>string</payloadID>
    <payloadTime>2018-09-28T21:49:45Z</payloadTime>
    <payloadContentType>application/json</payloadContentType>
    <payloadTypeURI>urn:ibm:ift:payload:type:sensor:v2</payloadTypeURI>
    <eventIDList/>
    <epcList>
      <epc>urn:ibm:ift:product:serial:obj:0614141000000.107346.2016</epc>
    </epcList>
    <locationList>
      <location>urn:ibm:ift:location:extension:loc:1234567890123.store-123.toy-department</location>
    </locationList>
    <payload>
      {
        "payload": {
          "reading_type": "urn:ibm:ift:sensor:readingtype:probe",
          "device_id": "S00001",
          "uom": "FAH",
          "type": "gs1:Temperature",
          "readings": [
            {
              "time": "2018-09-12T01:00:00.000Z",
              "value": 45
            },
            {
              "time": "2018-09-12T01:05:00.000Z",
              "value": 40
            }
          ]
        }
      }
    </payload>
  </payloadMessage>
</ift:payload>

문자열

string 페이로드 데이터 유형을 사용하여 문자열을 업로드하십시오. string 페이로드 데이터 유형은 다음 형식을 사용하여 지정해야 합니다.

<payloadTypeURI>string</payloadTypeURI>

<ift:payload xmlns:ift="urn:ibm:ift:xsd:1">
  <payloadMessage>
    <payloadID>41b14d7a-5b04-11e9-bdaa-6c4008984c16</payloadID>
    <payloadTime>2019-03-01T08:00:00Z</payloadTime>
    <payloadContentType>application/json</payloadContentType>
    <payloadTypeURI>string</payloadTypeURI>
    <epcList>
    <epc>urn:ibm:ift:product:serial:obj:1234567890123.LiveCow.lc11</epc>
    </epcList>
<payload>
Any customized string up to the 32 KB length limit.
</payload>
  </payloadMessage>
  </ift:payload>