Captura de transacciones

Cómo la aplicación prueba que las capturas se guardan antes de tratarlas como completas.

Tenga la seguridad de que, cuando la aplicación es responsable de guardar una captura en su computadora, supervisa el guardado como una transacción de captura. La transacción no se considera completa solo porque se disparó el obturador o se detuvo la grabación de una película. La aplicación también debe probar que el archivo esperado en el lado de la computadora llegó correctamente a su destino final en la ruta.

Esto es más importante durante sesiones de alto volumen o críticas, como retratos escolares, lotes de productos, trabajo de evidencia, documentación médica, soportes de copia y otras sesiones donde una pérdida de guardado podría afectar muchas decisiones posteriores.

Lo que protege una transacción

Una transacción de captura protege el guardado en el lado de la computadora.

Si su modo de guardado espera un archivo de imagen o película en la computadora, la aplicación supervisa la transferencia del SDK, el guardado final en la ruta y la prueba del archivo final antes de tratar la captura como exitosa. Si la captura es solo de tarjeta, la aplicación no espera un archivo final en la ruta de la computadora para esa captura.

El objetivo es simple: evitar la situación peligrosa en la que la cámara tomó una foto, pero el archivo que esperaba en la computadora está ausente, incompleto o no está donde el flujo de trabajo lo espera.

Capturas del SDK remoto heredado

En modo SDK remoto heredado, la aplicación recibe datos de medios del SDK de Nikon y los guarda a través de la tubería final de la ruta.

Para un guardado de imagen fija o película en el lado de la computadora, la transacción verifica que:

El SDK entregó los datos de medios esperados.
Se seleccionó la ubicación final de la ruta.
La aplicación escribió los datos en un archivo temporal pre-publicación .ttctmp.
El archivo temporal fue renombrado con la extensión final de imagen o película.
El archivo final existe.
El tamaño del archivo final coincide con los datos recibidos del SDK.
El atributo de archivo de solo lectura se aplicó cuando esa configuración está habilitada.

El .ttctmp archivo es un archivo temporal pre-publicación. Evita que los monitores de carpetas, escáneres antivirus, scripts y navegadores de imágenes reaccionen a un archivo final parcialmente escrito. El archivo final renombrado es la prueba que importa para la transacción de captura.

Capturas del SDK unificado Z v2

En modo SDK unificado Z v2, Nikon primero escribe imágenes fijas en el lado de la computadora en una carpeta de preparación específica para la captura. La aplicación luego audita los originales preparados y los copia a través de las reglas normales de la ruta a su destino final.

Para guardados de imagen fija en el lado de la computadora, la transacción verifica que:

Se creó una carpeta de preparación GUID específica para la captura.
La solicitud de StartShooting de Nikon fue exitosa.
El estado de disparo alcanzó un estado terminal.
Se encontraron archivos preparados dentro de la carpeta de preparación esperada.
Los tamaños de los archivos preparados se estabilizaron antes de la copia final.
La aplicación copió cada original preparado a un archivo temporal en la ruta final.
El archivo temporal fue renombrado con la extensión final.
El archivo final existe y coincide con el tamaño del original preparado.
El manifiesto de captura registra el resultado de la auditoría.

Los originales preparados se conservan para recuperación y soporte. La aplicación no elimina automáticamente los originales preparados producidos por Nikon después de la copia final en la ruta.

Qué sucede si la prueba falla

Si la aplicación no puede probar que una captura requerida en el lado de la computadora se guardó correctamente, lo trata como un fallo crítico en el guardado de la captura.

Cuando esto sucede:

Aparece una alerta de error de orientación en la parte superior de la aplicación.
El registro registra el modo del SDK, el cuerpo, el modo de guardado, la fase fallida, las rutas relevantes y los conteos de bytes cuando están disponibles.
Los comandos de flujo de trabajo de captura pendientes se cancelan para que una secuencia no siga disparando en la misma falla.
Los mensajes de listo normal o de progreso no deben ocultar la alerta de falla.
Si está habilitado, la aplicación desconecta el cuerpo después de que se genera la alerta.

Lea primero la alerta de orientación. Luego abra el registro si necesita la información de diagnóstico detallada.

Desconectar después de un error crítico en el guardado de la captura

Configuraciones Cuerpo Transacciones incluye Desconectar después de un error crítico en el guardado de la captura.

Habilite esto cuando continuar después de un guardado fallido sea peor que detener la sesión. Para trabajos de producción críticos, desconectar suele ser la opción más segura porque hace que el problema sea obvio y evita que más capturas entren en la misma ruta de guardado fallido.

Déjelo deshabilitado si desea que la cámara permanezca conectada mientras lee la alerta y decide qué hacer a continuación. La aplicación aún genera la alerta de error de orientación y escribe los detalles del registro cuando la configuración está desactivada.

Pruebas del camino de falla

Configuraciones Cuerpo Transacciones también incluye banderas de prueba de captura de depuración específicas del SDK. Estas banderas provocan deliberadamente fallos en las transacciones de captura para que pueda confirmar que la alerta, el registro, la cancelación del flujo de trabajo y el comportamiento de desconexión opcional son visibles antes de confiar en el flujo de trabajo en producción.

Utilice estas solo durante una sesión de prueba. Déjelas deshabilitadas para disparos normales.

Banderas de prueba de captura de depuración heredadas:

Forzar error de captura del SDK heredado
Forzar error de transferencia heredado
Forzar fallo en el guardado final de la RUTA
Forzar desajuste de tamaño final de la RUTA

Banderas de prueba de captura de depuración v2:

Forzar error de captura del SDK v2
Forzar fallo de auditoría de preparación v2
Forzar fallo en el guardado final de la RUTA
Forzar desajuste de tamaño final de la RUTA
Forzar ruta guardada inesperada del SDK

Después de un fallo forzado, confirme que vio la alerta de error de orientación, que el registro contiene una entrada DEBUG TEST, y que el cuerpo se desconectó si se habilitó Desconectar después de un error crítico en el guardado de la captura. Luego desactive la bandera de prueba antes de continuar con el trabajo de captura normal.

Qué enviar al soporte

Si se comunica con el soporte después de un fallo en la transacción de captura, incluya:

El título y el mensaje de la alerta de orientación.
El archivo de registro.
El modo activo del SDK de Nikon.
El modelo del cuerpo conectado.
El modo de guardado de la captura.
La carpeta final de la ruta que esperaba.
La carpeta de preparación v2 o el manifiesto de captura cuando se utilizó el SDK unificado Z v2.

Esta evidencia generalmente hace que la falla sea reconstruible sin adivinar.