Data Collections
Empaqueta tags de tu planta en un conjunto curado y compartible — y publícalo como una API limpia para consumidores externos sin exponer jamás tus identificadores internos de tags.
¿Qué es una Data Collection?
Una Data Collection es un grupo nombrado y curado de tags de medición de una de tus plantas. Tú eliges qué tags incluir, asignas a cada uno un alias seguro para consumidores externos, opcionalmente agregas descripciones y rangos de visualización, y luego la publicas como fuente de datos activa.
Publicar exige que todos los tags tengan un alias asignado — la API nunca expone tags sin nombre orientado al consumidor.
Los consumidores externos (socios, herramientas analíticas, tableros) consultan la colección usando únicamente los alias definidos, sin ver nombres internos como FI-101 o TI-204.
Tags de planta (FI-101, TI-204…)
→ Data Collection (Curada · Con alias)
→ Consumidores externos (Socios · APIs · Tableros)Conceptos clave
| Concepto | Visibilidad | Descripción |
|---|---|---|
| Tag | Solo interno | Punto de medición crudo en tu planta (ej. FI-101). Nunca se expone al exterior. |
| Alias | Compartido | Nombre en snake_case seguro (ej. total_mill_feed_rate). Debe ser único dentro de la colección. |
| Descripción | Compartido | Explicación clara de qué mide el tag para que el consumidor entienda la señal. |
| Rango visual | Compartido | Sugerencias numéricas opcionales (Mín, Máx, Valor típico) para escalar gráficas. |
| Desviación estándar | Compartido | Desviación estándar esperada de la medición, útil como referencia de anomalías. |
| Estado | Ciclo de vida | Fluye por Draft → Active (Published) ↔ Paused → Archived. |
Dos formas de crear una Data Collection
Creación rápida (Quick Create)
Asigna nombre, elige tags y envía. La plataforma genera alias automáticamente con IA. Ideal para arrancar rápido y afinar detalles después.
- Ruta más ágil
- Alias generados por IA
- Editables en cualquier momento antes de publicar
Asistente paso a paso (Step-by-Step Wizard)
Flujo guiado de tres pasos: define identidad, selecciona tags y revisa cada alias, descripción y rango antes de crear. Recomendado para colecciones productivas compartidas con socios externos.
- Control completo campo por campo
- Alias de IA precargados y editables manualmente
- Metadatos y rangos en línea
¿Qué ve cada perfil?
| Campo | Propietario | Consumidor externo | Notas |
|---|---|---|---|
Nombre del tag (ej. FI-101) | Sí | No | Identificador interno — nunca expuesto |
Alias (ej. total_mill_feed_rate) | Sí | Sí | Campo público del contrato |
| Descripción | Sí | Sí | Metadato curado en lenguaje claro |
| Mín / Máx / Valor típico | Sí | Sí | Guías visuales opcionales |
| Desviación estándar | Sí | Sí | Referencia opcional |
| Nombre de la colección | Sí | Sí | — |
| Telemetría en vivo | Sí | Sí (cuando Active) | Sujeto a permisos de compartición |
| Ajustes de compartición | Sí | No | El propietario configura accesos y límites por share |
| Llaves API | Sí | Sí | El propietario crea llaves directas; externos crean llaves del share dentro de límites |
Cómo funciona la generación de alias con IA
Al crear una Data Collection, la plataforma genera automáticamente alias en snake_case con una estrategia en dos niveles:
- Descripción corta (≤ 40 caracteres): Se convierte directo a slug sin llamada a IA (ej.
"Total mill feed rate"→total_mill_feed_rate). - Descripción larga o vacía: Un modelo de IA genera un alias descriptivo a partir del nombre, descripción y unidades sin filtrar códigos internos de instrumento.
Todos los alias son únicos dentro de la colección (colisiones reciben _2, _3, etc.).
Preguntas frecuentes
- ¿Por qué no puedo publicar si indica que faltan alias?
Publicar requiere que cada tag tenga un alias asignado. Completa o genera los alias faltantes e intenta de nuevo. - ¿Los consumidores externos ven nombres reales como
FI-101?
Nunca. La API externa solo expone alias curados y UUIDs de tag propios de la colección. - ¿Pueden los externos crear sus propias llaves API?
Sí. Quienes reciben una invitación de compartición crean sus propias llaves sujetas a los límites de vigencia y cantidad configurados por el propietario.