Ruta

Construir carpetas de destino y nombres de archivos a partir de plantillas y tokens

La Ruta controla dónde se guardan los archivos multimedia recién creados en el ordenador. El valor de la Ruta es una plantilla. Puede contener texto normal de carpetas y nombres de archivos, además de tokens que se reemplazan cuando se guarda el archivo.

Por ejemplo, c:\images\@GCT4 guarda archivos en c:\images y utiliza un contador global de cuatro dígitos para el nombre del archivo.

No escriba la extensión del archivo en el campo Ruta. La aplicación añade la extensión para el tipo de medio que se está guardando.

Controles de página

La ruta es la plantilla editable para la carpeta de destino y el nombre del archivo.
Seleccionar carpeta inserta una ruta de carpeta desde el selector de carpetas de Windows.
La vista previa muestra un ejemplo de la próxima ruta resuelta, incluyendo una extensión de muestra.
El contador global y el contador de perfil muestran los valores actuales del contador utilizados por los tokens de contador.
Configurar junto a un contador abre un pequeño editor. Introduzca el nuevo valor, luego use Aplicar o Cancelar.
Ejemplos muestra u oculta patrones de plantilla útiles agrupados por tipo de token.
Seleccione una plantilla de ejemplo y presione Ctrl+C cuando desee copiarla, luego péguela en la Ruta.
La carpeta de preparación del SDK de Nikon Z v2 es donde Nikon escribe primero los originales para la captura de imágenes fijas del lado de la computadora del SDK unificado Z v2.

La vista previa se actualiza a medida que edita la Ruta. Si se encuentran caracteres de ruta o nombre de archivo no válidos, o si la ruta resuelta contiene un nombre reservado de Windows, la vista previa reemplaza la parte insegura con guiones bajos y muestra una advertencia.

Configuración rápida

Abre Path desde la navegación principal.
Selecciona una carpeta o escribe una ruta de carpeta.
Añade un patrón de nombre de archivo después de la carpeta.
Utiliza un token de contador o de marca de tiempo para que cada captura pueda producir un nombre de archivo único.
Revisa la vista previa.
Guarda el perfil cuando el Path deba ser reutilizado más tarde.

Empieza simple. Un buen primer template es:

c:\images\@GCT4

Esto utiliza el contador global como el nombre de archivo. Después de que eso funcione, añade carpetas, marcas de tiempo, valores de ASK o carpetas de extensión según sea necesario.

Ejemplos

Utiliza los ejemplos en la página de Ruta como puntos de partida. Copia uno, pégalo en Ruta, edítalo para tus nombres de carpeta y observa la vista previa.

Ejemplos de contadores

c:\images\@GCT4 utiliza un contador global de cuatro dígitos como nombre de archivo.
c:\images\@PCT3 utiliza un contador de perfil de tres dígitos como nombre de archivo.
c:\images\captures\img-@GCT5 antepone un contador global de cinco dígitos con img-.
c:\images\profiles\@PCT4 utiliza un contador de perfil de cuatro dígitos en una carpeta específica del perfil.
c:\images\global-@GCT3\profile-@PCT3 utiliza ambos contadores en los nombres de las carpetas.

Ejemplos de fecha y carpeta

c:\images\flowers\@D1 utiliza una marca de tiempo precisa hasta el milisegundo.
c:\images\flowers\@D3\@D1 crea una carpeta para cada día y un nombre de archivo con marca de tiempo.
c:\images\@YYYY\@MM\@DD\@GCT4 crea carpetas de año, mes y día con un nombre de archivo de contador.
c:\images\@YYYY-@MM\@D1 crea una carpeta de mes y un nombre de archivo con marca de tiempo.
c:\images\utc\@UYYYY\@UMM\@UDD\@UD1 utiliza carpetas de fecha UTC y un nombre de archivo con marca de tiempo UTC.
c:\images\runs\@GRP\@GCT4 coloca archivos de la misma ejecución bajo una carpeta de marca de tiempo de ejecución.
c:\images\@D3\@HH@NN@SS-@ZZ crea una carpeta diaria y un nombre de archivo basado en el tiempo.
c:\images\@D2\@YYYY-@MM-@DD-@HH@NN@SS-@ZZ crea una carpeta de marca de tiempo y un nombre de archivo de fecha/hora personalizado.

Ejemplos de extensión

c:\images\flowers\@EXT1\pic-@GCT4 crea carpetas y nombres de archivo basados en la extensión, como pic-0001.
c:\images\@EXT1\@D1 almacena cada tipo de medio en una carpeta de extensión en minúsculas con un nombre de archivo de marca de tiempo.
c:\images\@EXT2\@BFN almacena cada tipo de medio en una carpeta de extensión en mayúsculas y mantiene el nombre de archivo base.

Ejemplos de nombre de archivo base

c:\images\@BFN utiliza el nombre de archivo generado por el cuerpo de la cámara, sin su extensión.
c:\images\@D3\@BFN coloca los nombres de archivo generados por el cuerpo en una carpeta diaria.
c:\images\@EXT1\body-@BFN almacena los nombres de archivo generados por el cuerpo por tipo de medio y añade un prefijo body-.

Ejemplos de ASK y escáner

c:\images\product\@ASK1#1:Client#\@SCASK1#*2:SKU!#\@GCT4 utiliza un cliente escrito y un SKU escaneado requerido para fotografía de productos, luego envía desde el SKU.
c:\images\ecommerce\@ASK1#1:Brand#\@SCASK1#*2:Style#\@ASK2#3:Color#\@ASK3#4:Angle!#\@GCT4 captura fotos de catálogo por marca, estilo escaneado, color y ángulo final.
c:\images\real-estate\@ASK1#1:Property#\@ASK2#2:Room#\@ASK3#3:View#\@GCT4 agrupa imágenes de bienes raíces por propiedad, habitación y vista.
c:\images\museum\@SCASK1#*1:Accession#\@ASK1#2:Object#\@ASK2#3:Side!#\@GCT4 utiliza un código de barras de acceso requerido para fotografía de objetos de museo.
c:\images\lab\@SCASK1#*1:Sample#\@ASK1#2:Test#\@ASK2#3:Stage!#\@GCT4 vincula imágenes de laboratorio a una muestra escaneada, prueba y etapa.
c:\images\lab\plates\@SCASK1#*1:Plate#\@ASK1#2:Well#\@ASK2#3:Channel!#\@GCT4 organiza imágenes de placas por placa escaneada, pozo y canal.
c:\images\specimens\@ASK1#1:Project#\@SCASK1#*2:Specimen#\@ASK2#3:Tray#\@ASK3#4:Position!#\@GCT4 documenta bandejas de especímenes con un escaneo de espécimen requerido.
c:\images\forensics\@SCASK1#*1:Case#\@SCASK2#*2:Evidence#\@ASK1#3:View!#\@GCT4 utiliza identificadores de caso y evidencia escaneados requeridos.
c:\images\forensics\@ASK1#*1:Case#\@ASK2#2:Scene#\@ASK3#3:Room#\@ASK4#4:Detail!#\@GCT4 organiza fotos de escenas forenses por caso escrito, escena, habitación y detalle.
c:\images\custody\@SCASK1#*1:Case#\@SCASK2#*2:Bag#\@SCASK3#*3:Item!#\@GCT4 captura fotos de artículos de cadena de custodia a partir de códigos de caso, bolsa y artículo escaneados.
c:\images\school\@ASK1#1:School#\@ASK2#2:Grade#\@SCASK1#*3:Student!#\@GCT4 utiliza un ID de estudiante escaneado requerido para retratos escolares.
c:\images\school-projects\@ASK1#1:School#\@ASK2#2:Class#\@ASK3#3:Project#\@SCASK1#4:Student#\@GCT4 documenta proyectos de aula con un ID de estudiante escaneado opcional.
c:\images\scan-service\@ASK1#1:Client#\@SCASK1#*2:Order#\@ASK2#3:Album#\@GCT4 organiza el escaneo de fotos antiguas por cliente, orden escaneada requerida y álbum.
c:\images\slides\@SCASK1#*1:Order#\@ASK1#2:Box#\@ASK2#3:Slot!#\@GCT4 rastrea el escaneo de diapositivas por escaneo de orden requerido, caja y ranura.
c:\images\archive\@ASK1#1:Family#\@ASK2#&2:Year#\@ASK3#3:Event#\@ASK4#4:Person!#\@GCT4 admite la restauración de archivos familiares, con un marcador visible cuando el año es desconocido.

Tokens

Un token es un marcador de posición en una carpeta o nombre de archivo. Los tokens comienzan con @ y no son sensibles a mayúsculas y minúsculas.

Los tokens se reemplazan cuando se calcula la vista previa y cuando se guarda un archivo. Utiliza tokens cuando la ruta guardada deba incluir datos cambiantes como contadores, valores de fecha/hora, valores de escáner o nombres de archivo generados por el cuerpo.

Los nombres de archivo deben ser únicos en su carpeta. Si un nombre de archivo generado ya existe, la aplicación añade un sufijo de duplicado como (2). Utiliza contadores, marcas de tiempo o nombres de archivo generados por el cuerpo cuando desees evitar duplicados.

Tokens de contador

Los tokens de contador crean nombres de archivo que aumentan con el tiempo. El número al final del token controla el número mínimo de dígitos.

@GCT1 a través de @GCT6 utilizan el contador global almacenado en la configuración de la aplicación.
@PCT1 a través de @PCT6 utilizan el contador del perfil almacenado en el perfil actual.

Por ejemplo:

@GCT1 puede producir 1.
@GCT4 puede producir 0001.
@PCT3 puede producir 001.

Los contadores avanzan después de que se guarda un archivo. Cuando se completa el guardado, la aplicación actualiza los valores de contador utilizados por la siguiente vista previa.

Tokens de fecha y hora

Los tokens de hora local utilizan la hora local del ordenador.

@D1 es YYMMDDHHNNSSZZZ, incluyendo milisegundos.
@D2 es YYMMDDHHNNSS.
@D3 es YYMMDD.
@D4 es YYMM.
@YYYY es el año de cuatro dígitos.
@YY es el año de dos dígitos.
@MM es el mes.
@DD es el día.
@HH es la hora en formato de 24 horas.
@NN es el minuto.
@SS es el segundo.
@ZZ es el milisegundo.
@GRP es la marca de tiempo para el inicio de una ejecución de múltiples imágenes.

Los tokens UTC utilizan el Tiempo Universal Coordinado. Coinciden con los nombres de los tokens locales con un prefijo U:

@UD1, @UD2, @UD3, y @UD4
@UYYYY, @UYY, @UMM, @UDD
@UHH, @UNN, @USS, @UZZ
@UGRP

Utiliza @D1 o @UD1 cuando necesites un nombre de archivo de marca de tiempo que sea muy poco probable que se repita.

Tokens ASK

Los tokens ASK crean campos de entrada de datos. Cuando la ruta contiene un token ASK, la aplicación puede pedirte un valor antes de que la captura o el trabajo de guardado utilice la ruta. Para el flujo de trabajo completo de ASK y la referencia de sintaxis, abre la página de ayuda de ASK.

Los tokens ASK básicos son:

@ASK1#Title# a @ASK9#Title#

Los tokens ASK del escáner son:

@SCASK1#Title# a @SCASK9#Title#

El texto entre los caracteres # se convierte en el título del campo. Por ejemplo:

c:\images\@ASK1#Country#\@SCASK1#City#\@GCT4

Esto crea campos llamados País y Ciudad, y luego utiliza sus valores como nombres de carpetas.

Usa @ASK cuando el valor deba ser escrito. Usa @SCASK cuando el valor es comúnmente proporcionado por un escáner. Los campos SCASK aún pueden ser escritos manualmente.

Marcadores de descriptor ASK

El texto entre los caracteres # puede incluir pequeños marcadores antes o después del título:

* al inicio marca el campo como obligatorio.
& al inicio mantiene un marcador visible en la ruta resuelta cuando el campo está vacío.
Un número y dos puntos, como 1:, establece el orden de entrada de datos.
! al final hace que la finalización del campo envíe la acción de la aplicación configurada.

Por ejemplo:

@SCASK1#*1:ID# crea un campo obligatorio capaz de escáner llamado ID y lo coloca primero.
@ASK2#&2:Province# crea un campo opcional de Provincia y muestra ask2 en la ruta mientras está vacío.
@ASK3#3:City!# crea un campo de Ciudad y envía la acción de la aplicación configurada cuando se completa el campo.

Si un valor ASK opcional está vacío y no tiene un marcador &, se colapsa a vacío. Cuando el token es el segmento completo de la carpeta, la ruta elimina el segmento vacío para que la ruta resuelta no mantenga barras invertidas duplicadas.

Los campos obligatorios bloquean el envío de ASK mientras estén vacíos o sean inválidos. Cuando el envío está bloqueado, el enfoque se mueve al primer campo que necesita atención.

Tokens de extensión

Los tokens de extensión permiten que la ruta varíe según el tipo de archivo de salida.

@EXT1 es la extensión de medios en minúsculas.
@EXT2 es la extensión de medios en mayúsculas.

Por ejemplo:

c:\images\@EXT1\pic-@GCT4

Esto puede crear carpetas separadas como jpg, nef, o mov, dependiendo del tipo de medio guardado.

Token de nombre de archivo generado por el cuerpo

@BFN utiliza el nombre de archivo generado por el cuerpo de la cámara sin su extensión.

Por ejemplo, si el nombre generado por el cuerpo es DSC_0032.JPG, @BFN se resuelve en DSC_0032.

Los nombres de archivo generados por el cuerpo solo están disponibles cuando el proveedor los suministra. Para flujos de trabajo de cámara, esto generalmente depende del modo de captura y destino. Si el proveedor no suministra un nombre de archivo generado por el cuerpo, utiliza un token de contador o de marca de tiempo en su lugar.

Rutas no válidas y nombres reservados

Las rutas de Windows no pueden contener todos los caracteres. La vista previa reemplaza los caracteres de ruta o nombre de archivo no válidos con guiones bajos.

Por ejemplo:

c:\images/@D1

La barra diagonal no es válida en una ruta de Windows en esa posición, por lo que la vista previa la reemplaza con _.

Windows también reserva algunos segmentos de carpeta y nombre de archivo para nombres de dispositivo. No utilice estos nombres como un segmento completo de carpeta o nombre de archivo:

CON
PRN
AUX
NUL
COM1 a COM9
LPT1 a LPT9

Estos nombres no son seguros incluso cuando tienen una extensión. Por ejemplo, CON.jpg sigue siendo tratado como un nombre reservado. Los puntos o espacios finales al final de un segmento de carpeta o nombre de archivo también son inseguros.

Path verifica la ruta resuelta después de que se reemplazan los tokens. Esto significa que un valor @ASK o @SCASK puede hacer que la ruta sea inválida si el valor ingresado o escaneado es uno de los nombres reservados. Por ejemplo, esta plantilla es válida por sí sola:

c:\images\@ASK1#Client#\@GCT4

Pero si el valor del Cliente es COM1, la ruta resuelta es inválida. La advertencia de la página de Path permanece visible hasta que la ruta resuelta sea segura.

La ruta puede incluir carpetas que aún no existen. La aplicación crea las carpetas necesarias al guardar el archivo.

Si el destino de captura seleccionado guarda en la computadora, como Computadora o Tarjeta + Computadora, la aplicación bloquea la captura antes de que se active la cámara cuando la ruta resuelta es inválida. También muestra una alerta de error explicando que la ruta debe ser corregida antes de disparar.

Si el destino seleccionado es solo Tarjeta, la aplicación aún puede capturar incluso cuando la página de Path muestra una advertencia, porque no se espera un guardado final de la ruta del lado de la computadora. Corrija la ruta antes de volver a un destino del lado de la computadora.

Carpeta de preparación del SDK de Nikon Z v2

La captura de imágenes fijas unificada del SDK de Z v2 utiliza una carpeta de preparación antes de que los archivos lleguen a la Ruta final. Nikon escribe el archivo o archivos originales en una carpeta de preparación por captura, luego ControlMyNikon audita la captura y copia esos originales a la Ruta final.

Esto mantiene los tokens de Ruta, contadores, nombres seguros contra duplicados y el comportamiento del destino final consistentes con el resto de la aplicación. También mantiene los originales preparados producidos por Nikon para su recuperación.

Utiliza una carpeta local con suficiente espacio libre para tu sesión. No utilices la misma carpeta que tu Ruta final. ControlMyNikon no elimina automáticamente los originales preparados, así que limpia la carpeta de preparación manualmente después de haber confirmado tus archivos finales.

Perfiles

El contador de ruta y perfil son datos del perfil. Guarda el perfil actual cuando desees que la ruta actual se cargue nuevamente más tarde.

El contador global se almacena en la configuración de la aplicación para que pueda continuar a través de los perfiles. El contador de perfil se almacena con el perfil seleccionado.

Utiliza el contador global cuando todos los perfiles deban compartir una secuencia de numeración. Utiliza el contador de perfil cuando cada perfil deba tener su propia secuencia de numeración.

Resolución de problemas

Si la vista previa no se ve bien:

Verifica que los separadores de carpetas usen barras invertidas.
Verifica que la ruta no incluya una extensión de archivo.
Verifica que ningún segmento de carpeta o nombre de archivo resuelva a un nombre reservado de Windows como CON, PRN, AUX, NUL, COM1 a través de COM9, o LPT1 a través de LPT9.
Verifica la ortografía de los tokens.
Copia un ejemplo y edítalo a partir de una plantilla que funcione.
Reemplaza plantillas complejas con c:\images\@GCT4, confirma que se previsualiza correctamente, luego agrega los tokens uno a la vez.

Si la captura está bloqueada por una ruta inválida:

Verifica la advertencia debajo de la vista previa.
Verifica cualquier valor de @ASK o @SCASK que se utilice como segmentos de carpeta o nombre de archivo.
Cambia nombres reservados como COM1 a un valor normal como COM10, Client1, o otro nombre específico del proyecto.
Si deseas guardar solo en la tarjeta de la cámara, establece el destino de la cámara en Tarjeta.

Si los archivos se guardan con sufijos duplicados:

Agrega un token de contador.
Usa @D1 u otro token de marca de tiempo de alta resolución.
Usa @BFN solo cuando el proveedor suministre un nombre de archivo único.

Si los campos ASK no aparecen:

Confirma que el token use la forma @ASK1#Title# o @SCASK1#Title#.
Asegúrate de que ambos caracteres # estén presentes.
Usa un número ASK único para cada campo.

Si los datos del escáner no van donde se esperaba:

Usa tokens @SCASK para los campos que deben recibir valores del escáner.
Verifica la configuración del escáner.
Confirma que el escáner esté enviando el valor esperado antes de la captura.

Configuración relacionada

Utiliza ASK para una explicación completa de los campos ASK, la sintaxis de marcadores, los valores requeridos, los campos compatibles con escáneres y los campos de envío. Utiliza Perfiles para guardar y recargar plantillas de Path. Utiliza Scanner cuando los valores de código de barras deben llenar los campos @SCASK.