Datos de carga útil

Suministro transparente proporciona el método de carga de datos de carga útil para ampliar el soporte más allá de los tipos de datos GS-1 estándar. Utilice una carga útil para adjuntar datos definidos por el usuario (como atributos) a sucesos, artículos (lotes de productos, contenedores de envío en serie, palés) o ubicaciones.

Tipos de carga útil

Las cargas útiles deben especificar el tipo de datos contenidos, utilizando la etiqueta <payloadTypeURI> . Suministro transparente define los siguientes tipos de carga útil.

Valores clave-valor
Datos de sensor
cadenas

Los ejemplos siguientes muestran el valor <payloadTypeURI> que se debe utilizar para cada uno de estos tipos de carga útil.

Puntos de conexión

Una carga útil enviada debe adjuntarse a un artículo (ID de producto), un EPC, una ubicación (ID de recurso) o un suceso (ID de suceso de EPCIS). Incluya uno de los siguientes puntos de datos en la carga útil:

Identificador de producto-Identificador de producto utilizando el elemento productList en el XML de carga útil.
Código de producto electrónico (EPC)-Un EPC-SSCC, FTLPN, SGTIN, SFTPI, LGTIN o LFTPI utilizando el elemento epcList en el XML de carga útil.
Identificador de ubicación-Ubicación de cadena de suministro (ID de recurso) utilizando el elemento locationList en el XML de carga útil.
ID de suceso de EPCIS-Para un suceso de Comisión, Desconexión, Agregación, Desagregación, Transformación u Observación utilizando el elemento eventIDList en el XML de carga útil.

Nota: El tipo de contenido ejemplos a continuación adjuntar a un EPC: <epc>urn:ibm:ift:product:serial:obj:1234567890123.LiveCow.lc11</epc>

Notas de uso

Tenga en cuenta las siguientes notas de uso cuando cargue datos de carga útil.

Los únicos datos de carga útil visibles en la interfaz de usuario de Suministro Transparente son pares de clave-valor que se adjuntan a un ID de producto o ID de recurso soportado. Los formatos soportados son GS1 SSCC, GTIN, SGTIN, LGTIN, GLN y EPC-SGLN y sus equivalentes únicamente de suministro transparente .
Para cambiar el nombre de la carga útil en la interfaz de usuario de Suministro Transparente , cargue un par de clave-valor con Título como clave y el nuevo nombre como valor.
Los mensajes de carga útil no pueden superar los 32 KB.
Las cargas útiles utilizan la modalidad de titularidad privada de forma predeterminada.
Las cargas útiles asociadas sólo a los ID de suceso no están autorizadas para otras organizaciones independientemente de la modalidad de titularidad de la carga útil.

Enviar datos de carga útil

Envíe la carga útil utilizando el punto final Transparent Supply API de conector activos . Pegue el XML de carga útil en el campo activo Parámetro Valor y pulse ¡pruébelo!.

Los ejemplos siguientes describen el XML para cada tipo de carga útil:

Valores clave-valor

Utilice el tipo de datos de carga útil de par de clave-valor para cargar cualquier conjunto de combinaciones de variable-valor.

Los datos de carga útil de pares de clave-valor deben especificarse utilizando el formato siguiente:

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

El código siguiente muestra una carga útil de ejemplo que especifica datos de carga útil de pares de clave-valor:

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

Datos de sensor

Utilice el tipo de datos de carga útil sensor para cargar mediciones recopiladas por dispositivos sensores. Cualquier serie se acepta como el valor para el tipo de datos de sensor. La carga útil no puede superar los 32 kb.

Por ejemplo, se puede registrar ambient (temperatura de ubicación) o sonda (temperatura del producto). El tipo de datos de carga útil sensor se debe especificar utilizando el formato siguiente:

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

El código siguiente muestra un ejemplo de carga útil de datos de sensor de temperatura ambiente (en Fahrenheit) para la ubicaciónespecificada:

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

El código siguiente muestra un ejemplo de carga útil de datos de sensor de temperatura de analizador (en Fahrenheit) para la instancia de producto (EPC) y sububicaciónespecificados:

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

cadenas

Utilice el tipo de datos de carga útil string para cargar cualquier serie. El tipo de datos de carga útil string se debe especificar utilizando el formato siguiente:

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