签出

AutoCheckOut允许你使用命令行来检出组件。要做到这一点，请输入以下命令。

"C:\Program Files\vdogClient\VDogAutoCheckOut.exe" /rd:<{ClientArchive}>"/dirR:<相对路径>" /Account:<User> /Password:<Password> [/domain:<Domain>] [/WithBackups:<Y/N>] [/NumberOfArchives:<Number>]

您也可以通过输入组件的 ID 而非相对路径来选择您想签出的组件。为此，您必须输入以下命令：

"C:\Program Files\vdogClient\VDogAutoCheckOut.exe" /rd:<ClientArchive> "/CID:<Component ID<" /Account:<User> /Password:<Password> [/domain:<Domain>] [/WithBackups:<Y/N>] [/NumberOfArchives:<Number>]

AutoCheckOut 也可以用来在每次登录前自动签出一个组件的当前版本。

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

当使用命令行执行Check-Out时，如果本地更改将被覆盖，你将不会被通知。

参数 描述
/rd:<ClientArchive> 客户端存档的完全限定路径。
/dirR:<相对路径>

要签出的组件或目录的相对路径。

如果没有指定值，所有可用的组件都将被签出。用户必须至少有对路径的读取访问权限。它可以被指定为/CID:的替代品。必须传递两个参数之一。如果两者都传递，/dirR: 将被忽略。
/CID:<组件ID>

要签出组件的组件 ID

用户必须至少有对组件的读取访问权限。可以被指定为 /dirR:的替代品。必须传递两个参数之一。如果两者都传递，/dirR: 被忽略。
/account:<用户名>

执行签出的用户名称
/domain:<域名>

用户的域（可选）
/password:<密码>

用户的密码
/WithBackups:<Y/N>

指定是否也应签出备份（可选）。可能的值：

Y: 也签出备份。

N: 不签出备份。

默认值是 N。

/NumberOfArchives:

<数量>

指定应该签出多少存档（可选）

默认值是 0（所有存档）。
/Version:<版本号>

指定应该签出哪个版本（可选）。

默认值是当前版本的编号。
/LockState:<LockState>

指定执行签出的状态。可能的值：

/LockState:UnderDevelopment:签出期间设置开发中状态。

/LockState:LockForOtherUsers:签出期间设置被用户锁定状态。

该参数是可选的。如果没有指定，将不设置锁定状态。
/WithStdLibs:<Y/N>

指定在签出期间是否也要签出链接的标准库。可能的值：

Y: 链接的标准库也已被签出。

N: 链接的标准库尚未被签出。

默认值是 N。
/comment:{comment}

签入-签出日志中显示的评论。

条目是可选的。默认值是一个空字符串。

 

示例

命令行调用

"C:\Program Files\vdogClient\VDogAutoCheckOut.exe" /rd:d:\vdClientArchive "/dirR:\Hall 1\Plant 1\Area 1\SimaticS7" /Account:User /Password:<Password> /WithBackups:N /NumberOfArchives:0

 

登录时自动签出一个组件：

bat文件如下：

REM Check-Out procedure

"C:\Program Files\vdogClient\VDogAutoCheckOut.exe" /rd:d:\vdClientArchive "/dirR:\Hall 1\Plant 1\Area 1\SimaticS7" /Account:User /Password:<Password>/WithBackups:N /NumberOfArchives:0

 

REM Open the UserClient

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

 

登录时自动签出所有组件：

bat文件如下：

REM Check-Out procedure

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

 

REM Open the UserClient

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

 

返回值

参数 描述
0 没有发生错误。至少签出了一个组件。
1 无法执行签出或者至少有一个签出返回错误。
2 没有发现可以签出的组件（例如，由于用户没有必需的权限）。
1000 登录错误

 

相关主题
UserClient -> 签出