路径

从模板和令牌构建目标文件夹和文件名

路径控制新创建的媒体文件在计算机上的保存位置。路径值是一个模板。它可以包含普通的文件夹和文件名文本，以及在文件保存时被替换的令牌。

例如，c:\images\@GCT4 将文件保存在 c:\images 下，并使用四位数的全局计数器作为文件名。

在路径字段中不要输入文件扩展名。应用程序会为正在保存的媒体类型附加扩展名。

页面控制

路径是目标文件夹和文件名的可编辑模板。
选择文件夹从 Windows 文件夹选择器插入文件夹路径。
预览显示下一个解析路径的示例，包括一个示例扩展名。
全局计数器和配置文件计数器显示当前计数器值，这些值由计数器令牌使用。
在计数器旁边设置会打开一个小编辑器。输入新值，然后使用应用或取消。
示例显示或隐藏按令牌类型分组的有用模板模式。
选择一个示例模板并在想要复制时按 Ctrl+C，然后将其粘贴到路径中。
Nikon Z SDK v2 暂存文件夹是 Nikon 首先为统一 Z SDK v2 计算机端静态捕捉写入原始文件的地方。

当您编辑路径时，预览会更新。如果发现无效的路径或文件名字符，或者解析的路径包含保留的 Windows 名称，预览会用下划线替换不安全的部分并显示警告。

快速设置

从主导航打开路径。
选择一个文件夹或输入一个文件夹路径。
在文件夹后添加文件名模式。
使用计数器或时间戳令牌，以便每次捕捉都能生成唯一的文件名。
检查预览。
当路径应该在以后重用时保存配置文件。

从简单开始。一个好的第一个模板是：

c:\images\@GCT4

这使用全局计数器作为文件名。在那之后，按需添加文件夹、时间戳、ASK 值或扩展文件夹。

示例

使用路径页面上的示例作为起点。复制一个，粘贴到路径中，编辑以适应您的文件夹名称，并查看预览。

计数器示例

c:\images\@GCT4 使用四位数的全局计数器作为文件名。
c:\images\@PCT3 使用三位数的配置文件计数器作为文件名。
c:\images\runs\@GRP\@GRPCTR3 使用三位数的组计数器，在每个新组中从 000 开始。
c:\images\captures\img-@GCT5 在 img- 前加上五位数的全局计数器。
c:\images\profiles\@PCT4 在特定于配置文件的文件夹中使用四位数的配置文件计数器。
c:\images\global-@GCT3\profile-@PCT3 在文件夹名称中使用两个计数器。

日期和文件夹示例

c:\images\flowers\@D1 使用精确到毫秒的时间戳。
c:\images\flowers\@D3\@D1 为每一天创建一个文件夹和一个时间戳文件名。
c:\images\@YYYY\@MM\@DD\@GCT4 创建年、月和日文件夹，并使用计数器文件名。
c:\images\@YYYY-@MM\@D1 创建一个月文件夹和一个时间戳文件名。
c:\images\utc\@UYYYY\@UMM\@UDD\@UD1 使用 UTC 日期文件夹和 UTC 时间戳文件名。
c:\images\runs\@GRP\@GCT4 将来自同一次运行的文件放在一个运行时间戳文件夹下。
c:\images\@D3\@HH@NN@SS-@ZZ 创建一个每日文件夹和一个基于时间的文件名。
c:\images\@D2\@YYYY-@MM-@DD-@HH@NN@SS-@ZZ 创建一个时间戳文件夹和一个自定义日期/时间文件名。

扩展示例

c:\images\flowers\@EXT1\pic-@GCT4 创建基于扩展名的文件夹和文件名，例如 pic-0001。
c:\images\@EXT1\@D1 将每种媒体类型存储在小写扩展名文件夹中，并使用时间戳文件名。
c:\images\@EXT2\@BFN 将每种媒体类型存储在大写扩展名文件夹中，并保留主体文件名。

主体文件名示例

c:\images\@BFN 使用相机主体生成的文件名，不带扩展名。
c:\images\@D3\@BFN 将主体生成的文件名放入每日文件夹中。
c:\images\@EXT1\body-@BFN 按媒体类型存储主体生成的文件名，并添加 body- 前缀。

ASK 和扫描仪示例

c:\images\product\@ASK1#1:Client#\@SCASK1#*2:SKU!#\@GCT4 使用输入的客户和所需的扫描 SKU 进行产品摄影，然后从 SKU 提交。
c:\images\ecommerce\@ASK1#1:Brand#\@SCASK1#*2:Style#\@ASK2#3:Color#\@ASK3#4:Angle!#\@GCT4 按品牌、扫描样式、颜色和最终角度捕捉目录照片。
c:\images\real-estate\@ASK1#1:Property#\@ASK2#2:Room#\@ASK3#3:View#\@GCT4 按物业、房间和视图对房地产图像进行分组。
c:\images\museum\@SCASK1#*1:Accession#\@ASK1#2:Object#\@ASK2#3:Side!#\@GCT4 使用所需的接收条形码进行博物馆物品摄影。
c:\images\lab\@SCASK1#*1:Sample#\@ASK1#2:Test#\@ASK2#3:Stage!#\@GCT4 将实验室图像与扫描样本、测试和阶段关联。
c:\images\lab\plates\@SCASK1#*1:Plate#\@ASK1#2:Well#\@ASK2#3:Channel!#\@GCT4 按扫描板、孔和通道组织板成像。
c:\images\specimens\@ASK1#1:Project#\@SCASK1#*2:Specimen#\@ASK2#3:Tray#\@ASK3#4:Position!#\@GCT4 使用所需的样本扫描记录标本托盘。
c:\images\forensics\@SCASK1#*1:Case#\@SCASK2#*2:Evidence#\@ASK1#3:View!#\@GCT4 使用所需的扫描案例和证据标识符。
c:\images\forensics\@ASK1#*1:Case#\@ASK2#2:Scene#\@ASK3#3:Room#\@ASK4#4:Detail!#\@GCT4 按输入的案例、场景、房间和细节组织法医现场照片。
c:\images\custody\@SCASK1#*1:Case#\@SCASK2#*2:Bag#\@SCASK3#*3:Item!#\@GCT4 从扫描案例、袋子和物品代码捕捉链条保管物品照片。
c:\images\school\@ASK1#1:School#\@ASK2#2:Grade#\@SCASK1#*3:Student!#\@GCT4 使用所需的扫描学生 ID 进行学校肖像。
c:\images\school-projects\@ASK1#1:School#\@ASK2#2:Class#\@ASK3#3:Project#\@SCASK1#4:Student#\@GCT4 使用可选的扫描学生 ID 记录课堂项目。
c:\images\scan-service\@ASK1#1:Client#\@SCASK1#*2:Order#\@ASK2#3:Album#\@GCT4 按客户、所需的扫描订单和相册组织旧照片扫描。
c:\images\slides\@SCASK1#*1:Order#\@ASK1#2:Box#\@ASK2#3:Slot!#\@GCT4 按所需的订单扫描、盒子和插槽跟踪幻灯片扫描。
c:\images\archive\@ASK1#1:Family#\@ASK2#&2:Year#\@ASK3#3:Event#\@ASK4#4:Person!#\@GCT4 支持家庭档案恢复，当年份未知时会显示一个可见的占位符。

令牌

令牌是文件夹或文件名中的占位符。令牌以 @ 开头，并且不区分大小写。

在计算预览和保存文件时，令牌会被替换。当保存的路径应包含变化的数据（例如计数器、日期/时间值、扫描仪值或主体生成的文件名）时，请使用令牌。

文件名在其文件夹中应是唯一的。如果生成的文件名已存在，应用程序会添加一个重复后缀，例如 (2)。当您想避免重复时，请使用计数器、时间戳或主体生成的文件名。

计数器令牌

计数器令牌创建随时间增加的文件名。令牌末尾的数字控制最小位数。

@GCT1 到 @GCT6 使用存储在应用程序设置中的全局计数器。
@PCT1 到 @PCT6 使用存储在当前配置文件中的配置文件计数器。
@GRPCTR2 到 @GRPCTR4 使用从零开始的组计数器，每个新 @GRP 组。

例如：

@GCT1 可以生成 1。
@GCT4 可以生成 0001。
@PCT3 可以生成 001。
@GRPCTR3 在 000 开始一个新组。

计数器在文件保存后前进。当保存完成时，应用程序会更新下一个预览所使用的计数器值。对于 RAW 加 JPEG 捕捉，来自同一图像的两个文件使用相同的计数器值，并且在成对完成后计数器前进。当组完成时，组计数器重置为零，以便下一个 @GRP 组从零开始。

日期和时间令牌

本地时间令牌使用计算机的本地时间。

@D1 是 YYMMDDHHNNSSZZZ，包括毫秒。
@D2 是 YYMMDDHHNNSS。
@D3 是 YYMMDD。
@D4 是 YYMM。
@YYYY 是四位数的年份。
@YY 是两位数的年份。
@MM 是月份。
@DD 是日期。
@HH 是 24 小时制的小时。
@NN 是分钟。
@SS 是秒。
@ZZ 是毫秒。
@GRP 是多图像运行开始的时间戳。

UTC 令牌使用协调世界时。它们与带有 U 前缀的本地令牌名称匹配：

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

当您需要一个非常不可能重复的时间戳文件名时，请使用 @D1 或 @UD1。

ASK 令牌

ASK 令牌创建数据输入字段。当路径包含 ASK 令牌时，应用程序可以在捕捉之前或保存工作使用路径之前询问您一个值。有关完整的 ASK 工作流程和语法参考，请打开 ASK 帮助页面。

基本 ASK 令牌是：

@ASK1#Title# 到 @ASK9#Title#

扫描仪 ASK 令牌是：

@SCASK1#Title# 到 @SCASK9#Title#

在 # 字符之间的文本成为字段标题。例如：

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

这会创建名为国家和城市的字段，然后使用它们的值作为文件夹名称。

当值应该被输入时，请使用 @ASK。当值通常由扫描仪提供时，请使用 @SCASK。SCASK 字段仍然可以手动输入。

ASK 描述符标记

在 # 字符之间的文本可以在标题之前或之后包含小标记：

* 在开头标记字段为必填。
& 在开头保持在解析路径中可见的占位符，当字段为空时。
数字和冒号，例如 1:，设置数据输入顺序。
! 在结尾使字段完成提交配置的应用程序操作。

例如：

@SCASK1#*1:ID# 创建一个名为 ID 的必填扫描仪字段，并将其放在第一位。
@ASK2#&2:Province# 创建一个可选的省字段，并在路径为空时显示 ask2。
@ASK3#3:City!# 创建一个城市字段，并在字段完成时提交配置的应用程序操作。

如果可选的 ASK 值为空且没有 & 标记，则会折叠为空。当令牌是整个文件夹段时，路径会删除空段，以便解析路径不会保留重复的反斜杠。

必填字段在为空或无效时会阻止 ASK 提交。当提交被阻止时，焦点会移动到第一个需要注意的字段。

扩展令牌

扩展令牌允许路径根据输出文件类型变化。

@EXT1 是小写的媒体扩展名。
@EXT2 是大写的媒体扩展名。

例如：

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

这可以创建不同的文件夹，例如 jpg, nef, 或 mov，具体取决于保存的媒体类型。

主体生成的文件名令牌

@BFN 使用相机主体生成的文件名，不带扩展名。

例如，如果主体生成的名称是 DSC_0032.JPG，则 @BFN 解析为 DSC_0032。

主体生成的文件名仅在提供者提供时可用。对于相机工作流程，这通常取决于捕捉和目标模式。如果提供者不提供主体生成的文件名，请改用计数器或时间戳令牌。

无效路径和保留名称

Windows 路径不能包含每个字符。预览会用下划线替换无效的路径或文件名字符。

例如：

c:\images/@D1

斜杠在 Windows 路径中的该位置无效，因此预览将其替换为 _。

Windows 还保留一些文件夹和文件名段作为设备名称。请勿将这些名称用作整个文件夹或文件名段：

CON
PRN
AUX
NUL
COM1 到 COM9
LPT1 到 LPT9

这些名称即使有扩展名也不安全。例如，CON.jpg 仍被视为保留名称。文件夹或文件名段末尾的尾随句点或空格也不安全。

路径在令牌被替换后检查解析路径。这意味着 @ASK 或 @SCASK 值可以使路径无效，如果输入或扫描的值是保留名称之一。例如，这个模板本身是有效的：

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

但是如果客户值是 COM1，则解析路径无效。路径页面警告在解析路径安全之前保持可见。

路径可以包含尚不存在的文件夹。应用程序在保存文件时会创建所需的文件夹。

如果所选捕捉目标保存到计算机，例如计算机或卡 + 计算机，当解析路径无效时，应用程序会在相机触发之前阻止捕捉。它还会显示一个错误警报，解释路径必须在拍摄之前修复。

如果所选目标仅为卡，即使路径页面显示警告，应用程序仍然可以捕捉，因为不期望进行计算机端的最终路径保存。在切换回计算机端目标之前，请修复路径。

Nikon Z SDK v2 暂存文件夹

统一 Z SDK v2 静态捕捉在文件到达最终路径之前使用暂存文件夹。Nikon 将原始文件写入每次捕捉的暂存文件夹，然后 ControlMyNikon 审核捕捉并将这些原始文件复制到最终路径。

这使路径令牌、计数器、重复安全名称和最终目标行为与应用程序的其余部分保持一致。它还保留 Nikon 生成的暂存原件以供恢复。

使用具有足够可用空间的本地文件夹进行会话。请勿使用与最终路径相同的文件夹。ControlMyNikon 不会自动删除暂存原件，因此在确认最终文件后请手动清理暂存文件夹。

配置文件

路径和配置文件计数器是配置文件数据。当您希望当前路径在以后再次加载时，请保存当前配置文件。

全局计数器存储在应用程序设置中，以便可以跨配置文件继续使用。配置文件计数器与所选配置文件一起存储。

当所有配置文件应共享一个编号序列时，请使用全局计数器。当每个配置文件应有自己的编号序列时，请使用配置文件计数器。

故障排除

如果预览看起来不正确：

检查文件夹分隔符是否使用反斜杠。
检查路径中是否不包含文件扩展名。
检查没有文件夹或文件名段解析为保留的 Windows 名称，例如 CON, PRN, AUX, NUL, COM1 到 COM9, 或 LPT1 到 LPT9。
检查令牌拼写。
复制一个示例并从工作模板编辑。
用 c:\images\@GCT4 替换复杂模板，确认其预览正确，然后逐个添加令牌。

如果捕捉因无效路径被阻止：

检查预览下方的警告。
检查任何 @ASK 或 @SCASK 值，这些值用作文件夹或文件名段。
将保留名称例如 COM1 更改为正常值，例如 COM10, Client1, 或其他项目特定名称。
如果您故意只想在相机卡上保存，请将相机目标设置为卡。

如果文件保存时带有重复后缀：

添加一个计数器令牌。
使用 @D1 或其他高分辨率时间戳令牌。
仅在提供者提供唯一文件名时使用 @BFN。

如果 ASK 字段未出现：

确认令牌使用 @ASK1#Title# 或 @SCASK1#Title# 形式。
确保两个 # 字符都存在。
为每个字段使用唯一的 ASK 编号。

如果扫描仪数据未按预期发送：

对应该接收扫描仪值的字段使用 @SCASK 令牌。
检查扫描仪设置。
确认扫描仪在捕捉之前发送预期值。