Una Data Series adjunta lecturas de medición con marca de tiempo, como peso, dimensiones, temperatura, humedad, emisiones y posición de GPS, a un Producto (o unidad logística) que ya existe. Subes estas lecturas como un archivo CSV desde la pestaña Data Series. Internamente, este archivo se llama "Product Data"; en la aplicación lo ves como una Data Series.
Importante: Una Data Series no crea Productos. Solo agrega lecturas a Productos o unidades logísticas que ya existen. Si una fila hace referencia a un Producto que aún no ha sido comisionado, la subida se rechaza con "Product ... does not exist." Para crear un Producto primero, registra un evento de Commission.
Una Data Series también se puede agregar de forma programática mediante la API de OriginsNext. Consulta ¿Cómo me integro con OriginsNext?
Para saber qué es una Data Series, consulta ¿Qué es una Data Series?
En qué se diferencia de las otras subidas CSV
OriginsNext tiene tres subidas CSV que cumplen funciones distintas:
Subida CSV | Qué hace |
Product Template CSV | Define plantillas de catálogo (qué tipo de cosa es un producto). |
Event CSV | Registra eventos del ciclo de vida. Un evento de Commission es lo que realmente crea un producto. |
Data Series CSV (este) | Adjunta lecturas de sensor o medición a productos que ya existen. |
Para subir plantillas en masa, consulta ¿Cómo subo Product Templates en masa con un archivo CSV? Para subir eventos, consulta ¿Cómo subo Eventos con un archivo CSV?
Subir una Data Series
Para subir una Data Series:
Abre Events en Product Traceability > Events.
Selecciona la pestaña Data Series. El historial de subidas lista cada archivo (File Name, Uploaded By, Uploaded At).
Haz clic en + ADD DATA SERIES.
Arrastra y suelta tu archivo CSV en el cuadro de subida, o haz clic en el cuadro para buscarlo.
Haz clic en Upload.
Si tiene éxito, las lecturas se adjuntan a los Productos correspondientes, y el gráfico de la Data Series aparece en el Product Summary de cualquier Producto que tenga datos.
Formato del archivo
El archivo debe ser un .csv separado por comas con una fila de encabezado.
Los números usan . (punto) como separador decimal.
Las marcas de tiempo usan el formato ISO 8601 y se almacenan en UTC (por ejemplo, 2024-01-15T10:30:00Z).
Cada fila hace referencia a exactamente un ProductId o LogisticUnitId, nunca a ambos. Las filas en las que ambos están vacíos se ignoran.
El orden de las columnas no importa; las columnas se identifican por su nombre de encabezado.
Las columnas
Usa estos encabezados de columna. Todas las columnas de medición son opcionales.
Columna | Qué significa |
ProductId o LogisticUnitId | El producto existente (ProductId, por ejemplo SKU.EXAMPLE001) o unidad logística (LogisticUnitId, por ejemplo LOGUNIT.UNIT001) al que pertenece la lectura. Ambos usan el formato Type.ID. Indica exactamente uno por fila, nunca ambos. |
Permission | Quién puede ver este dato. Valores aceptados: Public o Private (el valor predeterminado es Private si se deja en blanco). Private: solo tu organización puede ver los datos, independientemente de los permisos de compartición del producto. Public: tu organización y cualquier otro participante con permiso para ver el producto pueden ver los datos. |
TimeStampUtc | Cuándo se tomó la lectura, en UTC. Formato ISO 8601 (por ejemplo, 2024-01-15T10:30:00Z). Opcional. |
WeightValue / WeightUOM | Peso y su unidad (por ejemplo, 12.5 / kg). |
LengthValue / LengthUOM, WidthValue / WidthUOM, HeightValue / HeightUOM | Dimensiones y unidades (por ejemplo, 150 / cm). |
HumidityValue / HumidityUOM | Humedad y unidad (por ejemplo, 26 / %). |
TemperatureValue / TemperatureUOM | Temperatura y unidad (por ejemplo, 4 / C). |
EmissionValue / EmissionUOM | Emisiones y unidad (por ejemplo, 10 / kg CO2e). |
Latitude, Longitude | Coordenadas de GPS en grados decimales (por ejemplo, -27.435133 / 153.11496). Cada una es opcional e independiente. |
Other.<Name> | Cualquier columna que empiece con Other. se captura como un campo personalizado de texto libre; la parte después de Other. es el nombre del campo (por ejemplo, Other.BatchNumber). |
Archivo de ejemplo
La forma más rápida de armar tu archivo es partir del CSV de ejemplo de la Data Series. Tiene los encabezados de columna exactos que la subida espera y filas de ejemplo, así que sirve también como un ejemplo práctico. Mantén la fila de encabezado, reemplaza las filas de ejemplo con tus propias lecturas y guarda el archivo como un .csv.
Reglas
Cada fila necesita exactamente un ID (un Producto o una unidad logística), debe ser válido, y el producto o unidad ya debe existir.
Todos los campos de medición son opcionales; una fila puede llevar solo una lectura.
El valor y la unidad deben ir en par: si indicas un valor, debes indicar su unidad, y viceversa.
Cada valor de medición (y latitud/longitud) debe ser numérico.
Las unidades no se verifican contra una lista fija; por ejemplo KG, kg, C, %, cm y kg CO2e se aceptan todas como texto libre.
Consejo: Como las unidades son texto libre, acuerda un conjunto consistente dentro de tu organización (por ejemplo, siempre 'kg' en lugar de mezclar 'kg' y 'KG') para que tus gráficos e informes se mantengan ordenados.
Qué pasa cuando subes el archivo
Todo o nada. Cada fila se valida primero. Si alguna fila falla, toda la subida se rechaza con la lista completa de errores (cada uno citando el número de línea) y no se guarda nada.
Procesado de inmediato. Una Data Series se procesa al instante, así que no hay cola en segundo plano ni estado de borrador (a diferencia del Event CSV).
Sin deduplicación. Las lecturas se acumulan como una serie temporal. Volver a subir los mismos datos agrega más filas en lugar de sobrescribir las existentes.
Cada subida se registra en el historial de subidas en la pestaña Data Series, y las lecturas individuales se pueden editar después.
Quién puede subir
Tu organización debe estar suscrita a una función de trazabilidad o catálogo (Product Traceability, Add Traceability Data, o Read/Edit Product Catalogue). Solo puedes subir datos para un Producto o unidad logística que poseas o tengas bajo custodia; de lo contrario, verás "You are not authorized to upload product data for ...".