Nutzdaten

Transparent Supply stellt die Methode zum Hochladen von Nutzdaten bereit, um die Unterstützung über die Standarddatentypen GS-1 hinaus zu erweitern. Verwenden Sie Nutzdaten, um benutzerdefinierte Daten (z. B. Attribute) an Ereignisse, Artikel (Produktlose, serielle Versandcontainer, Paletten) oder Standorte anzuhängen.

Nutzdatentypen

Nutzdaten müssen den Typ der enthaltenen Daten mithilfe des Tags <payloadTypeURI> angeben. Transparent Supply definiert die folgenden Nutzdatentypen.

Die folgenden Beispiele zeigen den <payloadTypeURI> -Wert, der für jeden dieser Nutzdatentypen verwendet werden muss.

Anschlusspunkte

Übergebene Nutzdaten müssen einem Element (Produkt-ID), einem EPC, einer Position (Einrichtungs-ID) oder einem Ereignis (EPCIS-Ereignis-ID) zugeordnet werden. Fügen Sie einen der folgenden Datenpunkte in Ihre Nutzdaten ein:

  • Produkt-ID-Produkt-ID mithilfe des Elements productList in der Nutzdaten-XML.
  • Electronic Product Code (EPC)-Ein EPC-SSCC, FTLPN, SGTIN, SFTPI, LGTIN oder LFTPI unter Verwendung des Elements epcList in der Nutzdaten-XML.
  • Positionskennung-Position der Lieferkette (Einrichtungs-ID) mithilfe des Elements locationList in der Nutzdaten-XML.
  • EPCIS-Ereignis-ID-Für ein Ereignis vom Typ 'Provision', 'Decommission', 'Aggregation', 'Disaggregation', 'Transformation' oder 'Observation' unter Verwendung des Elements eventIDList in der Nutzdaten-XML.
Hinweis: Die folgenden Beispiele für den Inhaltstyp werden einem EPC zugeordnet: <epc>urn:ibm:ift:product:serial:obj:1234567890123.LiveCow.lc11</epc>

Hinweise zur Verwendung

Beachten Sie beim Hochladen von Nutzdaten die folgenden Hinweise zur Verwendung.

  • Die einzigen Nutzdaten, die in der Benutzerschnittstelle Transparent Supply sichtbar sind, sind Schlüssel/Wert-Paare, die einer unterstützten Produkt-ID oder Einrichtungs-ID zugeordnet sind. Unterstützte Formate sind GS1 SSCC, GTIN, SGTIN, LGTIN, GLN und EPC-SGLN sowie die entsprechenden Transparent Supply -Formate.
  • Um den Namen der Nutzdaten in der Benutzerschnittstelle Transparent Supply zu ändern, laden Sie ein Schlüssel/Wert-Paar mit dem Schlüssel 'Title' und dem neuen Namen als Wert hoch.
  • Nutzdatennachrichten dürfen 32 KB nicht überschreiten.
  • Nutzdaten verwenden standardmäßig den privaten Berechtigungsmodus.
  • Nutzdaten, die nur Ereignis-IDs zugeordnet sind, sind unabhängig vom Nutzungsrechtmodus der Nutzdaten nicht für andere Organisationen berechtigt.

Nutzdaten übergeben

Übergeben Sie Ihre Nutzdaten mithilfe des Endpunkts Transparent Supply Connector API assets . Fügen Sie Ihre Nutzdaten-XML in das Feld asset Parameter Wert ein und klicken Sie auf Try it out!.

Die folgenden Beispiele beschreiben die XML für jeden Nutzdatentyp:

Schlüssel/Wert-Paare

Verwenden Sie den Nutzdatentyp des Schlüssel/Wert-Paars zum Hochladen einer beliebigen Gruppe von Variablen-Wert-Kombinationen.

Die Nutzdaten der Schlüssel/Wert-Paare müssen im folgenden Format angegeben werden:

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

Der folgende Code zeigt Beispielnutzdaten, die die Nutzdaten von Schlüssel/Wert-Paaren angeben:

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

Sensordaten

Verwenden Sie den Nutzdatentyp sensor , um von Sensorgeräten erfasste Messungenhochzuladen. Eine beliebige Zeichenfolge wird als Wert für den Sensordatentyp akzeptiert. Die Nutzdaten dürfen 32 KB nicht überschreiten.

Beispielsweise kann Umgebungstemperatur (Standorttemperatur) oder Sonde (Produkttemperatur) aufgezeichnet werden. Der Nutzdatentyp sensor muss im folgenden Format angegeben werden:

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

Der folgende Code zeigt ein Beispiel für die Nutzdaten des Sensors Umgebungstemperatur (in Fahrenheit) für die angegebene Position:

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

Der folgende Code zeigt ein Beispiel für Nutzdaten der Sensordaten für die Sondentemperatur (in Fahrenheit) für die angegebene Produkt instanz (EPC) und Unterposition:

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

Zeichenfolgen

Verwenden Sie den Nutzdatentyp string , um eine beliebige Zeichenfolge hochzuladen. Der Nutzdatentyp string muss im folgenden Format angegeben werden:

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