Saltar al contenido principal

DOCUMENTACIÓN CON IA

¿Qué desea saber?

Almacenamiento remoto (FTP, SFTP, SMB)

Almacenamiento remoto copia archivos desde la cámara a servidores en su propia red. Puede enviar tres tipos de archivos:

SalidaLo que envía
ImágenesJPEGs de las piezas inspeccionadas: la captura sin procesar, una copia con los overlays de las herramientas dibujados, o ambos
MetadatosEl resultado de la inspección de cada captura como un archivo JSON, y un registro de resultados continuo en CSV o JSONL
Respaldos de recetasCopias programadas de sus recetas, diarias o semanales

Puede configurar dos destinos, por ejemplo un servidor para imágenes y otro para respaldos. Cada destino es un servidor FTP (o FTPS), un servidor SFTP o un recurso compartido SMB de Windows.

Vaya a Integration → Remote Storage:

OV Spark Pro Remote Storage Overview: los pasos Agregar un destino, Probar la conexión y Elegir qué enviar, y un diagrama de Imágenes, Metadatos y Respaldos de recetas fluyendo a dos destinos

El panel izquierdo lista la Vista general, sus dos Destinos y las tres Salidas, cada una con su propio interruptor de encendido/apagado. No se envía nada hasta que active al menos una salida.

Paso 1: Agregar un destino​

  1. En el panel izquierdo, haga clic en Destino 1.

  2. Elija el Protocolo:

    ProtocoloUsar paraNotas
    FTPLa mayoría de las unidades de almacenamiento en red (NAS) y servidores FTPModo pasivo. Marque Usar TLS (FTPS) para cifrar; el certificado del servidor debe ser válido
    SFTPServidores Linux, y cualquier otro al que acceda mediante SSH, el protocolo de inicio de sesión remoto seguroLa clave de host del servidor se aprende en la primera prueba exitosa
    SMBRecursos compartidos de archivos de WindowsSMB 2 y 3. Ingrese el nombre del Recurso compartido, y un Dominio si su red utiliza uno
  3. Complete Host (solo el nombre del servidor o la dirección IP, sin ftp://, puerto o carpeta), Puerto, Usuario y Contraseña.

  4. Opcionalmente establezca una Carpeta. En FTP y SFTP, una ruta sin / inicial es relativa a la carpeta de inicio de la cuenta, por ejemplo inspections/line3. En SMB es una carpeta dentro del recurso compartido.

  5. Para renombrar el destino, haga clic en el lápiz junto a su nombre. El nombre aparece en el panel y en la Vista general.

Destino 1 con SFTP seleccionado, mostrando Host, Puerto, Usuario, Contraseña, Clave de host de confianza, Carpeta y el botón Probar conexión

Avanzado: tiempos de espera, cargas en paralelo contiene los tiempos de espera de conexión e inactividad (de 1 a 600 segundos) y Cargas en paralelo. La mayoría de los servidores FTP permiten dos conexiones por usuario.

Use una cuenta dedicada

Solicite a TI una cuenta que solo pueda escribir en la carpeta de inspección. La cámara necesita crear carpetas y escribir archivos; no necesita eliminar nada, y nunca toca archivos que ya estén en el servidor.

Paso 2: Probar la conexión​

Haga clic en Probar conexión. La cámara realiza cinco verificaciones y se detiene en la primera que falle, con el motivo y la solución:

  1. Resolver el nombre del host
  2. Conectar al puerto (con TLS, si eligió FTPS)
  3. Iniciar sesión (en SMB, también abrir el recurso compartido)
  4. Crear la carpeta
  5. Escribir, anexar y eliminar un archivo de prueba de 1 KB
MensajeQué significa
Nombre de host no encontradoRevise la ortografía o utilice la dirección IP
Conexión rechazadaPuerto incorrecto, o el servicio no está en ejecución en el servidor
Tiempo de espera agotado, Servidor inaccesibleNo se puede llegar al servidor desde la red de la cámara. Revise el enrutamiento y los firewalls
Inicio de sesión rechazadoUsuario o contraseña incorrectos. En SMB también puede requerirse el dominio
No se permite crear carpetas, No se permite escribirLa cuenta no tiene permiso en esa carpeta
Recurso compartido no encontradoEl nombre del recurso compartido SMB es incorrecto
Falló el handshake TLSEl certificado FTPS no es de confianza, o TLS no está habilitado en el servidor
No se permite eliminarInofensivo. El archivo de prueba quedó en el servidor; las cargas no necesitan eliminar

Luego haga clic en Guardar en la barra inferior de la página.

SFTP: verifique la huella digital de la clave de host

La primera prueba SFTP exitosa confía en la clave de host del servidor y muestra su huella digital. Compárela con la que su equipo de TI le proporcionó. Si la clave llega a cambiar, la cámara rechaza las cargas y reporta Clave de host cambiada. Esto ocurre después de una reinstalación del servidor, o si otra máquina está respondiendo como ese servidor. Confirme con TI antes de presionar Olvidar y probar nuevamente.

Paso 3: Elegir qué enviar​

Haga clic en una salida en el panel lateral, seleccione su Destino, configúrelo y active Habilitado. Dos salidas pueden compartir un mismo destino.

Imágenes​

Salida de imágenes: Destino, Qué capturas, Carpeta y Nombre de archivo con rutas de ejemplo, y el enlace Mostrar tokens

Qué capturas decide qué se sube:

OpciónEnvía
Todas las capturasCada inspección
Solo fallosResultados de Fallar y No inspeccionado
Solo aprobadosResultados de Aprobar
Fallos + 1 de cada N aprobadosCada fallo, más un aprobado por cada N (1 a 10,000)

Carpeta y Nombre de archivo son plantillas construidas con tokens, y la línea debajo de cada campo muestra un ejemplo de la ruta que produce. Los valores predeterminados son:

  • Carpeta: {camera}/{YYYY}/{MM}/{DD}
  • Nombre de archivo: {YYYY}{MM}{DD}_{hh}{mm}{ss}{ms}_{trigger_id}_{result}

Luego elija la imagen en sí. Imagen sin procesar es la captura exactamente como se tomó. Imagen anotada es la misma captura con las superposiciones de las herramientas dibujadas encima: cajas, etiquetas, mapas de calor y regiones. Active una u otra, o ambas. Cada una tiene su propio:

  • Tamaño: Completo 2592×1944, Mitad 1296×972 o Cuarto 648×486. Las imágenes más pequeñas ahorran espacio en el servidor y ancho de banda; las superposiciones se dibujan igual en todos los tamaños
  • Calidad (1–100): calidad JPEG, 85 de forma predeterminada
  • Ocultar tipos de superposición (solo anotada): omitir Cajas, Polígonos, Arcos, Líneas, Puntos, Texto, Mapas de calor o Máscaras

Salida de imágenes con la lista de tokens expandida, Imagen sin procesar e Imagen anotada ambas activadas, cada una con Tamaño y Calidad, y la lista Ocultar tipos de superposición abierta

Ancho de banda estimado en la parte inferior calcula los MB/s y GB por día para su configuración, al ritmo al que se ejecuta la receta, o a 60 inspecciones por minuto si aún no se ha ejecutado. Compárelo con lo que el servidor y la red pueden soportar.

La configuración de imágenes está bloqueada en Producción

Qué capturas, tamaño, calidad, los interruptores de sin procesar y anotada, y los tipos de superposición ocultos solo pueden cambiarse en Configuración, porque modifican el trabajo que se realiza en cada inspección. El destino, la carpeta y el nombre de archivo pueden cambiarse en cualquier momento.

Tokens para nombres de carpeta y archivo​

Haga clic en Mostrar tokens que puede usar en nombres de carpeta y archivo, luego haga clic en un token para insertarlo en el último campo que editó.

GrupoTokens
Fecha{YYYY} {YY} {MM} {DD} {hh} {mm} {ss} {ms} {timestamp} (milisegundos epoch)
Dispositivo{camera} (nombre de la cámara), {hostname}, {serial}, {model}
Inspección{recipe}, {recipe_id}, {trigger_id}, {capture_id}, {result}, {variant}
PLC / HTTP{trigger.<key>}, cualquier campo que haya llevado el disparo, como un número de pieza enviado por el PLC

Reglas que la cámara aplica:

  • El nombre de archivo debe incluir {trigger_id}, {capture_id} o {timestamp}, para que dos capturas nunca puedan sobrescribirse entre sí
  • Las carpetas pueden usar / para anidar; el nombre de archivo no
  • {variant} solo funciona en el nombre de archivo. Si tanto sin procesar como anotada están activadas y lo omite, se añaden _raw y _annotated automáticamente
Incluya el número de pieza en el nombre de archivo

Si el PLC envía un número de pieza o de serie con el disparo, agréguelo con {trigger.<key>}. Quien busque una pieza específica en el servidor podrá entonces encontrar su imagen por nombre, sin abrir la cámara.

Metadatos​

Salida de metadatos: Qué capturas, Carpeta, archivo JSON por captura y Registro de resultados con Formato CSV o JSONL, Nuevo archivo Diario u Horario, y Nombre del archivo de registro

Los metadatos usan las mismas opciones de Qué capturas y el mismo nombre de archivo que las imágenes, para que ambos coincidan. Tiene dos partes, y puede activar una o ambas:

  • Archivo JSON por captura: un archivo con el mismo nombre que su imagen, terminado en .json. Contiene la hora de captura, los datos del disparo, la receta, el resultado general, el resultado de cada herramienta, la puntuación y el detalle, y las rutas de las imágenes subidas con él
  • Registro de resultados: un archivo creciente con una línea por captura, en CSV (se abre en Excel) o JSONL (un registro JSON por línea, para scripts y bases de datos). Elija Diario u Horario para cuando comience un nuevo archivo. El nombre del archivo de registro debe incluir {DD} para archivos diarios, y también {hh} para los horarios

Incluir detalle de herramienta añade el resultado completo de cada herramienta a ambos. Un registro nunca mezcla recetas: si las columnas cambian a mitad de un periodo, se inicia un nuevo archivo en vez de corromper el anterior.

Algunos servidores no pueden anexar

Si el servidor no puede agregar a un archivo existente, la cámara lo indica y escribe el registro de resultados como un archivo por captura. Las imágenes y los archivos JSON no se ven afectados.

Copias de seguridad de recetas​

Copias de seguridad de recetas: Respaldar ahora, Destino, Qué (Todas las recetas o Solo receta activa), Cuándo (Diario o Semanal), Hora, Carpeta, Incluir imágenes de entrenamiento, Última ejecución y Próxima ejecución

AjusteOpciones
QuéTodas las recetas, o Solo receta activa
CuándoDiario, o Semanal en un día de la semana elegido
HoraHora en formato 24 horas, en la zona horaria propia de la cámara (mostrada bajo el campo)
Incluir imágenes de entrenamientoApagado: paquetes compactos que se ejecutan pero no pueden reentrenarse. Encendido: paquetes completos desde los que puede reentrenar; se omiten las recetas cuyo paquete superaría 2 GB

Cada ejecución escribe un paquete por receta, más un manifest.json que lista cada archivo con su receta, versión y suma de verificación. Respaldar ahora ejecuta uno inmediatamente, usando los ajustes guardados. Última ejecución y Próxima ejecución muestran lo que ocurrió y lo que está pendiente.

Una ejecución que coincida con otra copia de seguridad, importación o exportación espera y se ejecuta en cuanto puede, en vez de fallar. Si la cámara estaba apagada cuando correspondía una copia de seguridad, se ejecuta una vez cuando la cámara vuelve.

Las copias de seguridad contienen las contraseñas de sus servidores

Cada paquete de receta, programado o exportado a mano, lleva los ajustes de la cámara, incluyendo las contraseñas de Almacenamiento remoto en texto plano. Cualquiera que pueda leer la carpeta de respaldo puede leer esas contraseñas. Proteja esa carpeta como un archivo de credenciales.

Verificar que esté funcionando​

El Overview muestra el resumen de cada salida, lo que se ha subido desde el arranque y cualquier cosa en espera en la cola.

EstadoQué significaQué hacer
EnviandoLos archivos se están enviando normalmenteNada
ReintentandoFalló una conexión; la cámara reintenta por sí solaEjecute Probar conexión para reintentar de inmediato
Descartando capturasEl servidor es más lento que la línea, por lo que la cola se llenó y se descartaron los trabajos más antiguosEnvíe imágenes más pequeñas, envíe solo los fallos, o agregue Subidas en paralelo
BloqueadoUn error permanente, como una falla de certificado. Las subidas a ese destino se detienenCorrija el ajuste, luego ejecute Probar conexión; una prueba exitosa reanuda las subidas
El Almacenamiento remoto es una copia, no el registro

La inspección sigue ejecutándose pase lo que pase con el servidor, y la propia Biblioteca de la cámara se mantiene como el registro completo. Una subida fallida se registra en Registros de diagnóstico, pero la pieza aún se inspecciona y su resultado aún llega al PLC.

A dónde ir después​