Dati del payload

Tipi di payload

I payload devono specificare il tipo di dati contenuti, utilizzando la tag <payloadTypeURI> . Transparent Supply definisce i seguenti tipi di payload.

• Coppie chiave-valore
• Dati sensore
• Stringhe

Gli esempi riportati di seguito mostrano il valore <payloadTypeURI> che deve essere utilizzato per ognuno di questi tipi di payload.

Punti di collegamento

Un payload inoltrato deve essere collegato a un elemento (ID prodotto), un EPC, ubicazione (ID funzione) o evento (ID evento EPCIS). Includi uno dei seguenti punti di dati nel tuo payload:

• Identificativo prodotto - Identificativo prodotto utilizzando l'elemento productList nell'XML del payload.
• EPC (Electronic Product Code) - un EPC - SSCC, FTLPN, SGTIN, SFTPI, LGTIN o LFTPI utilizzando l'elemento epcList nel payload XML.
• Identificativo ubicazione - Posizione della catena di fornitura (ID funzione) utilizzando l'elemento locationList nel payload XML.
• ID evento EPCIS - Per un evento Commissione, Disattivazione, Aggregazione, Disaggregazione, Trasformazione o Osservazione utilizzando l'elemento eventIDList nell'XML del payload.

Note d'utilizzo

Considerare le seguenti note di utilizzo quando si caricano i dati del payload.

• Gli unici dati di payload visibili nell'interfaccia utente Transparent Supply sono coppie chiave - valore collegate a un ID prodotto o a un ID funzione supportato. I formati supportati sono GS1 SSCC, GTIN, SGTIN, LGTIN, GLN ed EPC - SGLN e i relativi equivalenti Transparent Supply .
• Per modificare il nome del payload nell'IU Transparent Supply , carica una coppia chiave - valore con Titolo come chiave e il nuovo nome come valore.
• I messaggi di payload non possono superare i 32 KB.
• I payload utilizzano la modalità di titolarità privata per impostazione predefinita.
• I payload allegati solo agli ID evento non sono autorizzati ad altre organizzazioni indipendentemente dalla modalità di titolarità del payload.

Inoltra dati payload

Inoltra il tuo payload utilizzando l'endpoint Fornitura trasparente API connettore asset . Incolla il tuo XML del payload nel campo asset Parameter Value e fai clic su Try it out!.

I seguenti esempi descrivono l'XML per ciascun tipo di payload:

Coppie chiave-valore

Utilizzare il tipo di dati del payload della coppia chiave - valore per caricare qualsiasi serie di combinazioni variabile - valore.

I dati del payload delle coppie chiave - valore devono essere specificati utilizzando il formato seguente:

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

Il seguente codice mostra un payload di esempio che specifica i dati del payload delle coppie chiave - valore:

<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>

Dati sensore

Utilizzare il tipo di dati del payload sensor per caricare le misurazioni raccolte dalle unità sensore. Qualsiasi stringa viene accettata come valore per il tipo di dati del sensore. Il payload non può superare i 32 kb.

Ad esempio, è possibile registrare l' ambiente (temperatura dell'ubicazione) o la sonda (temperatura del prodotto). Il tipo di dati del payload sensor deve essere specificato utilizzando il seguente formato:

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

Il seguente codice mostra un payload di dati del sensore temperatura ambiente (in Fahrenheit) di esempio per l' ubicazionespecificata:

<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>

Il seguente codice mostra un esempio di temperatura della sonda (in Fahrenheit) del payload dei dati del sensore per l'EPC ( product instance) e sublocationspecificati:

<?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>

Stringhe

Utilizzare il tipo di dati del payload string per caricare qualsiasi stringa. Il tipo di dati payload string deve essere specificato utilizzando il seguente formato:

<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>