检出

AutoCheckOut 可以通过命令行对组件进行检出。为此，必须输入以下命令：

"C:\Programs\vdogClient\VDogAutoCheckOut.exe" /rd:{ClientArchive} "/dirR:{Relative component path}" /Account:{User} /Password:{Password} [/domain:{Domain}] [/WithBackups:{Y/N}] [/NumberOfArchive:{Number}/Password:{Password} [/domain:{Domain}] [/WithBackups:{Y/N}] [/NumberOfArchives:{Number}] /Domain:{Domain}

也可以通过组件 ID 而不是相对路径来指定要检出的组件。为此，必须输入以下命令：

"C:\Programs\vdogClient\VDogAutoCheckOut.exe" /rd:{ClientArchive} "/CID:{Component ID}" /Account:{User}/Password:{Password} [/domain:{Domain}] [/WithBackups:{Y/N}] [/NumberOfArchives:{Number}] /Domain:{Domain}

例如，通过 AutoCheckOut，还可以在每次登录前自动检出组件的当前版本。

命令行调用所需的参数和数值见下表。

Warning

如果本地更改被覆盖，通过命令行检出不会发出警告。

参数	描述	值	默认
/rd:{ClientArchive}	客户端存档的完全合格路径
/dirR:{相关组件路径}.	要检出的组件或目录的相对路径。如果未指定值，则会检出所有可用的组件。用户必须至少拥有该路径的读取权限。可指定为 CID: 的替代值。两个参数中必须有一个。如果两个参数都通过，/dirR: 将被忽略。
/CID：{组件 ID}	要借出组件的组件 ID。用户必须至少拥有该组件的读取权限。可指定为 /dirR: 的替代。两个参数中必须有一个被传递。如果两个参数都通过，/dirR: 将被忽略。
/account:{User}	执行检出的用户名
/domain:{域名}	用户的域名（可选）
/password:{password}	用户的密码
/有备份：{Y/N}	指定备份是否也应检入（可选）。	Y：备份也检入出。 N：不检入备份。	N
/档案数量：{数量}	指定要检出多少存档（可选）。		0（所有存档）。
/版本：{版本号}。	指定要检入的版本（可选）。		当前版本控制的编号。
/LockState:{LockStatus}（锁定状态	指定执行检出的锁定状态。	/LockState:UnderDevelopment：为检出设置了开发中的锁定状态。 /LockState:LockForOtherUsers: 锁定其他用户：为检出设置了已锁定的锁定状态。	该参数为可选参数。如果未指定，则不会设置锁定状态。
/WithStdLibs:{Y/N}	指定在检出过程中，链接的标准库是否也被检入。	Y：链接的标准库也已检入。 N：链接的标准库未检入。	N
/comment:{comment}	在检入检出日志中显示的注释。该说明为可选项。		空字符串

示例

命令行调用

"C:\Program Files\vdogClient\VDogAutoCheckOut.exe" /rd:d:\vdClientArchive "/dirR:\Hall 1\Factory 1\Area 1\SimaticS7" /Account:{User} /Password:{Password} /WithBackup:N /NumberOfArchive:0/Password:{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:{User} /Password:{Password} /WithBackup:N /NumberOfArchive:0/Password:{Password} /WithBackups:N /NumberOfArchives:0

REM 启动 UserClient（一个组件）

"C:\Program Files\vdogClient\VDogClient.exe" /rd:d:\vdClientArchive /Account:{User}/Password:{Password}

通过 bat 文件登录时自动检出所有组件

REM 检出流程（所有组件）

"C:\Program Files\vdogClient\VDogAutoCheckOut.exe" /rd:d:\vdClientArchive /dirR: /Account:{User} /Password:{Password} /WithBackups:Y /NumberOfArchive:1/Password:{Password} /WithBackups:Y /NumberOfArchives:1

REM 启动 UserClient（所有组件）

C:\Program Files\vdogClient\VDogClient.exe /rd:d:\vdClientArchive /Account:{User} /Password:{Password}/Password:{Password}

返回值

参数	描述
0	未发生错误。至少有一个部件被检出。
1	无法执行或至少一次检出失败。
2	没有发现可以检查出的组件（例如由于权限缺失）。
1000	登录错误

检出

示例