Check-Out
Der AutoCheckOut ermöglicht es Komponenten über die Kommandozeile auszuchecken. Dazu muss folgender Befehl eingegeben werden:
| "C:\Programme\vdogClient\VDogAutoCheckOut.exe" /rd:{ClientArchive} "/dirR:{Relativer Komponentenpfad}" /Account:{Benutzer} /Password:{Passwort} [/domain:{Domäne}] [/WithBackups:{Y/N}] [/NumberOfArchives:{Anzahl}] |
Die Komponente, die ausgecheckt werden soll, kann alternativ auch über ihre Komponenten-ID, statt über ihren relativen Pfad angegeben werden. Dazu muss folgender Befehl eingegeben werden:
| "C:\Programme\vdogClient\VDogAutoCheckOut.exe" /rd:{ClientArchive} "/CID:{Komponenten-ID}" /Account:{Benutzer} /Password:{Passwort} [/domain:{Domäne}] [/WithBackups:{Y/N}] [/NumberOfArchives:{Anzahl}] |
Mit AutoCheckOut kann z.B. auch die aktuelle Version einer Komponente automatisch vor jedem Login ausgecheckt werden.
Die notwendigen Parameter und Werte für den Kommandozeilenaufruf können Sie der folgenden Tabelle entnehmen.
Beim Check-Out über die Kommandozeile wird keine Warnung ausgegeben, wenn lokale Änderungen überschrieben werden.
| Parameter | Beschreibung |
|---|---|
| /rd:{ClientArchive} | Voll qualifizierter Pfad zum Clientarchiv |
| /dirR:{Relativer Komponentenpfad} |
Relativer Pfad der Komponente / des Verzeichnisses, die/das ausgecheckt werden soll
|
| /CID:{Komponenten-ID} |
Komponenten-ID der Komponente, die ausgecheckt werden soll
|
| /account:{Benutzer} |
Name des Benutzers, der den Check-Out vornimmt |
| /domain:{Domäne} |
Domäne des Benutzers (optional) |
| /password:{Passwort} |
Passwort des Benutzers |
| /WithBackups:{Y/N} |
Angabe, ob auch Backups ausgecheckt werden sollen (optional). Mögliche Werte: Y: Es werden auch Backups ausgecheckt. N: Es werden keine Backups ausgecheckt. Der Standardwert ist N. |
| /NumberOfArchives:{Anzahl} |
Angabe, wie viele Archive ausgecheckt werden sollen (optional) Der Standardwert ist 0 (alle Archive). |
| /Version:{Nummer der Version} |
Angabe, der Version, die ausgecheckt werden soll (optional). Der Standardwert ist die Nummer der aktuellen Version. |
| /LockState:{Sperrstatus} |
Angabe des Sperrstatus, mit dem der Check-Out ausgeführt wird /LockState:UnderDevelopment: Beim Check-Out wird der Sperrstatus In Bearbeitung gesetzt. /LockState:LockForOtherUsers: Beim Check-Out wird der Sperrstatus Gesperrt gesetzt. Der Parameter ist optional. Wenn er nicht angegeben wird, wird kein Sperrstatus gesetzt. |
| /WithStdLibs:{Y/N} |
Angabe, ob beim Check-Out auch die verknüpften Standardbibliotheken ausgecheckt werden. Mögliche Werte: Y: Die verknüpften Standardbibliotheken werden mit ausgecheckt. N: Die verknüpften Standardbibliotheken werden nicht mit ausgecheckt. Der Standardwert ist N. |
| /comment:{comment} |
Kommentar, der im CheckIn-CheckOut-Log angezeigt wird Die Angabe ist optional. Der Standardwert ist ein leerer String. |
Wird kein Wert angegeben, werden alle verfügbaren Komponenten ausgecheckt. Der Benutzer muss mindestens Leserechte auf den Pfad haben. Kann alternativ zu CID: angegeben werden. Einer der beiden Parameter muss übergeben werden. Werden beide übergeben, wird /dirR: ignoriert.
Beispiele
Kommandozeilenaufruf
| "C:\Programme\vdogClient\VDogAutoCheckOut.exe" /rd:d:\vdClientArchive "/dirR:\Halle 1\Werk 1\Bereich 1\SimaticS7" /Account:{Benutzer} /Password:{Passwort} /WithBackups:N /NumberOfArchives:0 |
Automatischer Check-Out einer Komponente beim Login per Bat-Datei:
|
REM CheckOut-Vorgang "C:\Programme\vdogClient\VDogAutoCheckOut.exe" /rd:d:\vdClientArchive "/dirR:\Halle 1\Werk 1\Bereich 1\SimaticS7" /Account:{Benutzer} /Password:{Passwort} /WithBackups:N /NumberOfArchives:0
REM Starten des UserClients "C:\Program Files\vdogClient\VDogClient.exe" /rd:d:\vdClientArchive /Account:{Benutzer} /Password:{Passwort} |
Automatischer Check-Out aller Komponenten beim Login per Bat-Datei:
|
REM CheckOut-Vorgang "C:\Programme\vdogClient\VDogAutoCheckOut.exe" /rd:d:\vdClientArchive /dirR: /Account:{Benutzer} /Password:{Passwort} /WithBackups:Y /NumberOfArchives:1
REM Starten des UserClients C:\Programme\vdogClient\VDogClient.exe /rd:d:\vdClientArchive /Account:{Benutzer} /Password:{Passwort} |
Rückgabewerte
| Argument | Beschreibung |
|---|---|
| 0 | Keine Fehler aufgetreten. Mindestens eine Komponente wurde ausgecheckt. |
| 1 | Es konnte kein Check-Out durchgeführt werden oder mindestens ein Check-Out verlief fehlerhaft. |
| 2 | Es wurden keine Komponenten gefunden, die ausgecheckt werden konnten (z.B. aufgrund fehlender Rechte). |
| 1000 | Fehler beim Login |
| Verwandte Themen |
|---|
| UserClient -> Check-Out |