Uma Data Series anexa leituras de medição com data e hora, como peso, dimensões, temperatura, umidade, emissões e posição de GPS, a um Produto (ou unidade logística) que já existe. Você faz o upload dessas leituras como um arquivo CSV pela aba Data Series. Internamente, esse arquivo é chamado de "Product Data"; no aplicativo, você o vê como uma Data Series.
Importante: Uma Data Series não cria Produtos. Ela apenas adiciona leituras a Produtos ou unidades logísticas que já existem. Se uma linha referenciar um Produto que ainda não foi comissionado, o upload é rejeitado com "Product ... does not exist." Para criar um Produto primeiro, registre um evento de Commission.
Uma Data Series também pode ser adicionada de forma programática pela API do OriginsNext. Consulte Como integrar com o OriginsNext?
Para saber o que é uma Data Series, consulte O que é uma Data Series?
Como ela difere dos outros uploads CSV
O OriginsNext tem três uploads CSV que cumprem funções diferentes:
Upload CSV | O que ele faz |
Product Template CSV | Define templates de catálogo (que tipo de coisa um produto é). |
Event CSV | Registra eventos do ciclo de vida. Um evento de Commission é o que de fato cria um produto. |
Data Series CSV (este) | Anexa leituras de sensor ou medição a produtos que já existem. |
Para fazer upload de templates em massa, consulte Como faço upload em massa de Product Templates com um arquivo CSV? Para fazer upload de eventos, consulte Como faço upload de Eventos com um arquivo CSV?
Fazer upload de uma Data Series
Para fazer upload de uma Data Series:
Abra Events em Product Traceability > Events.
Selecione a aba Data Series. O histórico de uploads lista cada arquivo (File Name, Uploaded By, Uploaded At).
Clique em + ADD DATA SERIES.
Arraste e solte seu arquivo CSV na caixa de upload, ou clique na caixa para procurá-lo.
Clique em Upload.
Quando bem-sucedido, as leituras são anexadas aos Produtos correspondentes, e o gráfico da Data Series aparece no Product Summary de qualquer Produto que tenha dados.
Formato do arquivo
O arquivo deve ser um .csv separado por vírgulas com uma linha de cabeçalho.
Os números usam . (ponto) como separador decimal.
As datas e horas usam o formato ISO 8601 e são armazenadas em UTC (por exemplo, 2024-01-15T10:30:00Z).
Cada linha referencia exatamente um ProductId ou LogisticUnitId, nunca os dois. Linhas em que ambos estão vazios são ignoradas.
A ordem das colunas não importa; as colunas são identificadas pelo nome do cabeçalho.
As colunas
Use estes cabeçalhos de coluna. Todas as colunas de medição são opcionais.
Coluna | O que significa |
ProductId ou LogisticUnitId | O produto existente (ProductId, por exemplo SKU.EXAMPLE001) ou unidade logística (LogisticUnitId, por exemplo LOGUNIT.UNIT001) ao qual a leitura pertence. Ambos usam o formato Type.ID. Informe exatamente um por linha, nunca os dois. |
Permission | Quem pode ver este dado. Valores aceitos: Public ou Private (o padrão é Private se deixado em branco). Private: apenas sua organização pode ver os dados, independentemente das permissões de compartilhamento do produto. Public: sua organização e quaisquer outros participantes com permissão para ver o produto podem ver os dados. |
TimeStampUtc | Quando a leitura foi feita, em UTC. Formato ISO 8601 (por exemplo, 2024-01-15T10:30:00Z). Opcional. |
WeightValue / WeightUOM | Peso e sua unidade (por exemplo, 12.5 / kg). |
LengthValue / LengthUOM, WidthValue / WidthUOM, HeightValue / HeightUOM | Dimensões e unidades (por exemplo, 150 / cm). |
HumidityValue / HumidityUOM | Umidade e unidade (por exemplo, 26 / %). |
TemperatureValue / TemperatureUOM | Temperatura e unidade (por exemplo, 4 / C). |
EmissionValue / EmissionUOM | Emissões e unidade (por exemplo, 10 / kg CO2e). |
Latitude, Longitude | Coordenadas de GPS em graus decimais (por exemplo, -27.435133 / 153.11496). Cada uma é opcional e independente. |
Other.<Name> | Qualquer coluna que comece com Other. é capturada como um campo personalizado de texto livre; a parte depois de Other. é o nome do campo (por exemplo, Other.BatchNumber). |
Arquivo de exemplo
A maneira mais rápida de montar seu arquivo é partir do CSV de exemplo da Data Series. Ele tem os cabeçalhos de coluna exatos que o upload espera e linhas de exemplo, então serve também como um exemplo prático. Mantenha a linha de cabeçalho, substitua as linhas de exemplo pelas suas próprias leituras e salve o arquivo como um .csv.
Regras
Cada linha precisa de exatamente um ID (um Produto ou uma unidade logística), ele deve ser válido, e o produto ou unidade já deve existir.
Todos os campos de medição são opcionais; uma linha pode carregar apenas uma leitura.
Valor e unidade devem vir em par: se você informar um valor, deve informar sua unidade, e vice-versa.
Cada valor de medição (e latitude/longitude) deve ser numérico.
As unidades não são verificadas contra uma lista fixa; por exemplo KG, kg, C, %, cm e kg CO2e são todas aceitas como texto livre.
Dica: Como as unidades são texto livre, combine um conjunto consistente dentro da sua organização (por exemplo, sempre 'kg' em vez de misturar 'kg' e 'KG') para que seus gráficos e relatórios fiquem organizados.
O que acontece quando você faz o upload
Tudo ou nada. Cada linha é validada primeiro. Se alguma linha falhar, todo o upload é rejeitado com a lista completa de erros (cada um citando o número da linha) e nada é salvo.
Processado imediatamente. Uma Data Series é processada na hora, então não há fila em segundo plano nem estado de rascunho (ao contrário do Event CSV).
Sem deduplicação. As leituras se acumulam como uma série temporal. Reenviar os mesmos dados adiciona mais linhas em vez de sobrescrever as existentes.
Cada upload é registrado no histórico de uploads na aba Data Series, e leituras individuais podem ser editadas depois.
Quem pode fazer upload
Sua organização deve estar inscrita em um recurso de rastreabilidade ou catálogo (Product Traceability, Add Traceability Data, ou Read/Edit Product Catalogue). Você só pode fazer upload de dados para um Produto ou unidade logística que você possua ou tenha sob custódia; caso contrário, você verá "You are not authorized to upload product data for ...".