Dados de carga útil

Fornecimento Transparente fornece o método de upload de dados de carga útil para estender o suporte além dos tipos de dados padrão GS-1 . Use uma carga útil para anexar dados definidos pelo usuário (como atributos) a eventos, itens (lotes de produtos, contêineres de envio em série, pallets) ou locais.

Tipos de carga útil

As cargas úteis devem especificar o tipo de dados contidos, usando a tag <payloadTypeURI> . Fornecimento Transparente define os seguintes tipos de carga útil.

Os exemplos abaixo mostram o valor <payloadTypeURI> que deve ser usado para cada um desses tipos de carga útil.

Pontos de anexo

Uma carga útil enviada deve anexar a um item (ID do Produto), um EPC, localização (ID do Facility) ou evento (ID do evento EPCIS). Inclua um dos seguintes pontos de dados em sua carga útil:

  • Identificador do produto-Identificador do produto usando o elemento productList no XML de carga útil.
  • Código de Produto Eletrónico (EPC)-An EPC-SSCC, FTLPN, SGTIN, SFTPI, LGTIN ou LFTPI usando o elemento epcList no XML de carga útil.
  • Identificador De Localização-Localização da cadeia de suprimentos (ID do Facility) usando o elemento locationList no XML de carga útil.
  • ID do Evento EPCIS-Para um evento de Comissão, Decommissão, Agregação, Desagregação, Transformação ou Observação, utilizando o elemento eventIDList no XML de carga útil.
Nota: O tipo de conteúdo exemplos abaixo anexa a um EPC: <epc>urn:ibm:ift:product:serial:obj:1234567890123.LiveCow.lc11</epc>

Observações de uso

Considere as seguintes notas de uso quando você está fazendo o upload de dados de carga útil.

  • Os únicos dados de carga útil visíveis na UI Fonte Transparente são pares de valor chave que são anexados a um ID de Produto ou ID de Instalação suportado. Os formatos suportados são o GS1 SSCC, GTIN, SGTIN, LGTIN, GLN e EPC-SGLN e seus equivalentes Transparent Supply apenas.
  • Para alterar o nome da carga útil na UI Suprimento Transparente , faça o upload de um par de valor chave com Título como chave e o novo nome como valor.
  • As mensagens de carga útil não podem exceder 32 KB.
  • Cargas úteis usam o modo de autorização privada por padrão.
  • As cargas úteis anexadas apenas aos IDs de evento não são autorizadas para outras organizações, independentemente do modo de autorização da carga útil

Enviar dados de carga útil

Envie sua carga útil usando o terminal Fornecimento transparente API do conector ativos . Cole seu XML de carga útil no campo ativo Parâmetro Valor e clique no Experimente isso!

Os exemplos a seguir descrevem o XML para cada tipo de carga útil:

Pares chave-valor

Use o tipo de dados de carga útil do par de valor da chave para fazer o upload de qualquer conjunto de combinações de valor variável.

Os dados de carga útil de pares de valor da chave devem ser especificados usando o seguinte formato:

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

O código a seguir mostra uma carga útil de amostra que especifica os dados de carga útil de pares chave-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>

Dados de sensor

Use o tipo de dados de carga útil do sensor para fazer upload de medidas coletados por dispositivos de sensor Qualquer sequência é aceita como o valor para o tipo de dados do sensor. A carga útil não pode exceder 32 kb.

Por exemplo, ambiente (temperatura do local) ou análise (temperatura do produto) pode ser registrado. O tipo de dados de carga útil sensor deve ser especificado usando o formato a seguir:

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

O código a seguir mostra uma amostra temperatura ambiente (em Fahrenheit) carga de dados do sensor para o especificado location:

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

O código a seguir mostra uma carga de dados de dados do sensor temperatura da análise (em Fahrenheit) para a instância de produto especificada (EPC) e sublocação:

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

Sequências

Use o tipo de dados de carga útil string para fazer o upload de qualquer string. O tipo de dados de carga útil da string deve ser especificado usando o seguinte 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>