Cuando tenga decenas o cientos de dispositivos, añádalos desde un archivo CSV en lugar de uno por uno. Cada importación se revisa primero («Every import is dry-run first: nothing is written until somebody reviews what would happen.»), después se aplica, y puede deshacerse. Los dispositivos nuevos reciben sus credenciales de inmediato, entregadas en un archivo que puede descargar una sola vez.
Las importaciones se realizan en la página Imports (dirección /admin/settings/imports, en la sección Organisation del menú). La página está disponible cuando el módulo de importación está activado en su organización. Necesita el permiso para crear dispositivos.
Prepare el archivo
El archivo es CSV, guardado en UTF-8, separado por comas, punto y coma o tabulaciones, con los nombres de las columnas en la primera línea. Hasta 1.000 filas por archivo. Seleccione Download a template en el asistente de importación para obtener un archivo con todas las columnas y una fila de ejemplo.
| Columna | Significado | Reglas |
|---|---|---|
name | Nombre del dispositivo (único en esta cuenta) | Obligatorio. |
label | Etiqueta | Texto libre opcional. |
type | Tipo de dispositivo | Opcional, por ejemplo pump-controller. |
profile | Nombre del perfil de dispositivo (vacío = el perfil predeterminado) | El perfil debe existir. |
serial | Número de serie | Opcional, hasta 32 caracteres de A–Z a–z 0–9 . _ : -. Único en la plataforma. |
mac | Dirección MAC | Opcional. Se guarda en la información adicional del dispositivo. |
credentialType | Tipo de credencial (vacío = ACCESS_TOKEN) | ACCESS_TOKEN o MQTT_BASIC. X.509 nunca se importa. |
mqttUsername | Usuario MQTT (MQTT_BASIC; vacío = generado) | Único en la plataforma. |
mqttClientId | ID de cliente MQTT (MQTT_BASIC, opcional) | De 1 a 64 caracteres de A–Z a–z 0–9 . _ : -. |
attr:<key> | Un atributo de servidor | Hasta 50 columnas de atributos, valores de hasta 4.096 caracteres. |
shared:<key> | Un atributo compartido | Igual que el anterior. |
Ejemplo:
name,label,profile,serial,credentialType,attr:maxTemp,shared:cfg.report_interval_s
pump-house-01,Pump house north,Water pumps,SN-000123,ACCESS_TOKEN,80,300
pump-house-02,Pump house south,Water pumps,SN-000124,MQTT_BASIC,75,300Advertencia
Nunca incluya un secreto en el archivo. Una columna con nombre de secreto (token, password, secret, key, credential, claim code) se rechaza, y también una celda que parezca un token de acceso. Hermetry crea las credenciales por sí mismo.
Importar
- Abra Imports y seleccione New import.
- Archivo: en What to import, elija IoT devices, seleccione el CSV file y mantenga activada la opción The first line holds the column names. El asistente muestra cuántas filas ha encontrado.
- Columnas: compruebe que cada campo tiene la columna correcta de su archivo («Columns with matching names are already filled in.»). Las columnas que empiezan por
attr:oshared:se toman tal cual. Elija When a record already exists:
| Estrategia | Efecto |
|---|---|
| Añadir solo registros nuevos; informar de los existentes | Un nombre que ya existe es un error. |
| Actualizar solo registros existentes | Solo se cambian los nombres existentes; el resto se omite. |
| Añadir registros nuevos y actualizar los existentes | Ambas acciones. |
| Añadir registros nuevos y omitir los existentes | Los nombres existentes se omiten. |
- Seleccione Check the file. Se revisa cada fila; todavía no se escribe nada. El paso Check muestra Rows in the file, Ready to import, Will be skipped y Have a problem, con Rows with a problem (Row, Field, Problem).
- Corrija el archivo y seleccione Pick another file, o seleccione Import n rows y confirme. Las filas con problemas se dejan fuera.
Lo que rechaza la revisión
| Problema | Significado |
|---|---|
| El nombre aparece más de una vez en este archivo. | Cada nombre una vez por archivo. Lo mismo para los números de serie y los usuarios MQTT. |
| Ningún perfil de dispositivo se llama «…». | Cree primero el perfil, o deje la columna vacía para usar el perfil predeterminado. |
| Ya existe un dispositivo llamado «…». | Elija «skip duplicates» para importar solo las filas nuevas, o «update» para cambiar los dispositivos existentes. |
| Una importación no cambia el número de serie de un dispositivo existente. | Los números de serie son fijos. |
| El perfil «…» no permite … | El perfil no permite el tipo de credencial. Elija otro perfil o tipo de credencial. |
| Ya hay un dispositivo registrado con este número de serie. | Una unidad con licencia se añade reclamándola, no mediante importación. |
| Este usuario MQTT ya está en uso. | Los usuarios son únicos en la plataforma. |
El límite de dispositivos de su plan se comprueba para todo el archivo antes de escribir nada: un archivo que no cabe se rechaza completo, indicando las cifras.
Qué cambia una actualización
Una actualización cambia la etiqueta, el tipo, el perfil, la dirección MAC y los atributos, y guarda los valores anteriores para deshacer. Nunca cambia un número de serie ni una credencial («The credential of an existing device is not changed by an import; renew it from the device page.»). Subir el mismo archivo otra vez es seguro: nada se crea dos veces y no se genera de nuevo ninguna credencial; el asistente avisa de que ese mismo archivo ya se importó.
Descargar las credenciales
Después de una importación que añadió dispositivos, el paso Result ofrece One more step: Download the new devices’ credentials. «The access tokens and MQTT passwords of the devices this import added, in one file you can download once, within 15 minutes of the import. Keep it safe: it is not shown again.»
- Solo la persona que ejecutó la importación puede descargarlo.
- Después de la descarga, o tras 15 minutos, desaparece («Done. This cannot be repeated.»).
- Un dispositivo cuyo archivo se perdió recibe nuevas credenciales en su propia página con Rotate secret.
Deshacer
El paso Result y la lista de importaciones ofrecen Undo this import: «Records it added are removed and records it changed are put back as they were.» Para los dispositivos:
- un dispositivo creado se elimina solo mientras nunca se haya conectado,
- un dispositivo actualizado recupera los valores que tenía antes de la importación.
Las filas que no se pueden restaurar se cuentan («n rows could not be put back.»).