签出
AutoCheckOut 可以通过命令行对组件进行签出。为此，必须输入以下命令：
"C:\Programs\vdogClient\VDogAutoCheckOut.exe" /rd:{ClientArchive} "/dirR:{相对组件路径}" /Account:{用户} /Password:{密码} [/domain:{域名}] [/WithBackups:{Y/N}] [/NumberOfArchive:{数量}/Password:{密码} [/domain:{域名}] [/WithBackups:{Y/N}] [/NumberOfArchives:{数量}] /Domain:{域名}
也可以通过组件 ID 而不是相对路径来指定要签出的组件。为此，必须输入以下命令：
"C:\Programs\vdogClient\VDogAutoCheckOut.exe" /rd:{ClientArchive} "/CID:{组件 ID}" /Account:{用户}/Password:{密码} [/domain:{域名}] [/WithBackups:{Y/N}] [/NumberOfArchives:{数量}] /Domain:{域名}
例如，通过 AutoCheckOut，还可以在每次登录前自动签出组件的当前版本。
命令行调用所需的参数和数值见下表。
Warning
如果本地更改被覆盖，通过命令行签出不会发出警告。
| 参数 | 描述 | 值 | 默认 |
|---|---|---|---|
| /rd:{ClientArchive} | 客户端存档的完全合格路径 | ||
| /dirR:{相对组件路径} | 用于指定要签出的组件或目录的相对路径。 如果不指定，则签出所有组件。用户对指定路径至少应有读取权限。该参数和 CID: 二选一，必须 填写其中一个；若两者都填写，系统将忽略 /dirR: 参数。 | ||
| /CID：{组件 ID} | 用于指定要签出的组件 ID。 用户对指组件径至少应有读取权限。该参数和 /dirR: 二选一，必须 填写其中一个。若两者都填写，系统将忽略 /dirR: 参数。 | ||
| /account:{用户} | 执行签出的用户名 | ||
| /domain:{域名} | 用户的域名（可选） | ||
| /password:{密码} | 用户的密码 | ||
| /有备份：{Y/N} | 指定备份是否也应签出（可选）。 | Y：备份也签出。 N：不签出任何备份。 | N |
| /NumberOfArchives:{数量} | 指定要签出多少存档（可选）。 | 0（所有存档）。 | |
| /版本：{版本号} | 指定要签出的版本（可选）。 | 当前版本的编号。 | |
| /LockState:{锁定状态} | 指定执行签出的锁定状态。 | /LockState:UnderDevelopment：为签出设置了 开发中 的锁定状态。 /LockState:LockForOtherUsers: 为签出设置了已锁定 的锁定状态。 | 该参数为可选参数。如果未指定，则不会设置锁定状态。 |
| /WithStdLibs:{Y/N} | 指定在签出过程中，链接的标准库是否也被签出。 | Y：链接的标准库也被签出。 N：链接的标准库未签出。 | N |
| /comment:{评论} | 在签入签出日志中显示的评论。该项为可选项。 | 空字符串 |
示例
命令行调用
"C:\Program Files\vdogClient\VDogAutoCheckOut.exe" /rd:d:\vdClientArchive "/dirR:\Hall 1\Factory 1\Area 1\SimaticS7" /Account:{用户} /Password:{密码} /WithBackups:N /NumberOfArchives:0
通过 bat 文件登录时自动签出组件
REM 签出流程（一个组件）
"C:\Program Files\vdogClient\VDogAutoCheckOut.exe" /rd:d:\vdClientArchive "/dirR:\Hall 1\Factory 1\Area 1\SimaticS7" /Account:{用户} /Password:{密码} /WithBackups:N /NumberOfArchives:0
REM 启动 UserClient（一个组件）
"C:\Program Files\vdogClient\VDogClient.exe" /rd:d:\vdClientArchive /Account:{用户} /Password:{密码}
通过 bat 文件登录时自动签出所有组件
REM 签出流程（所有组件）
"C:\Program Files\vdogClient\VDogAutoCheckOut.exe" /rd:d:\vdClientArchive /dirR: /Account:{用户} /Password:{密码} /WithBackups:Y /NumberOfArchives:1
REM 启动 UserClient（所有组件）
C:\Program Files\vdogClient\VDogClient.exe /rd:d:\vdClientArchive /Account:{用户} /Password:{密码}
返回值
| 参数 | 描述 |
|---|---|
| 0 | 未发生错误。至少有一个组件被签出。 |
| 1 | 无法执行签出操作 或 至少有一个签出失败。 |
| 2 | 没有发现可以被签出的组件（例如由于权限缺失）。 |
| 1000 | 登录错误 |
相关主题