Transport
Das Transportwesen dient zum einfachen Überspielen von Objekten zwischen mehreren Systemen. Dabei werden nur Strukturen übernommen und nicht z.B. Inhalte von Tabellen, Dimensionen, usw..
Vorrausetzung für einen sauberen Transport ist, dass das Entwicklungssystem (Quellsystem) vor den Änderungen gleich ist wie das Produktivsystem (Zielsystem) und am Produktivsystem keine weiteren Objekte angelegt werden.
Es gibt für den Import auch die Möglichkeit, diesen als Batch-Job zu starten, um einen Transport auch in der Nacht automatisiert durchführen zu können.
Konfigurationsparameter
svrconfig
Die Authentifizierung beim automatisierten Transportwesen erfolgt immer mittels SSPI mit dem Userkontext des Aufrufers. Dieser Benutzer muss aus Sicherheitsgründen in der SvrConfig.xml bei dem Eintrag TransportUserName hinterlegt werden.
coplanner.config.exe
Die Sichtbarkeit der Einträge "Transport" und "Clientseitige Checks" im Entwicklermenü am Client kann über den Eintrag ShowTransportEntries gesteuert werden.
Aufruf
Um das Transportwesen aufrufen zu können, muss man sich im Hersteller, PowerUser oder Partner-Modus befinden. Es gibt hier wenn man über CoPlanner auf das Entwicklungsmenü geht der Eintrag Transportwesen.
Über diesen Button öffnet sich dann der folgende Dialog:
Stichtag festlegen
Dieser Stichtag wird bei dem Export für die initiale Datumsauswahl, ab wann Objektänderungen für den Transport berücksichtigt werden herangezogen. Dieser Vorschlagswert kann dann im Assistenten übersteuert werden. Den aktuellen Stichtag sollte man auf jeden Fall durchführen, wenn das System gerade von einem Produktivsystem als Entwicklungssystem kopiert wurde.
Um den Stichtag festzulegen, die Schaltfläche bei "Stichtag festlegen" anklicken und auf "Assistent starten" klicken. Danach kommt eine Abfrage, ob man das aktuelle Datum als Stichtag setzen will. Der Stichtag wird später bei jedem Export automatisch auf das Datum und die Uhrzeit des Exports angepasst.
Export
Um einen Export zu starten, die Schaltfläche bei Export aktivieren und "Assistent starten" klicken. Es öffnet sich ein Dialog für die Auswahl des Datums, ab welchem Änderungen angezeigt werden sollen. Als Standardwert wird das Datum des festgelegten Stichtages herangezogen, welches entweder über die Option "Stichtag festlegen" vergeben ist oder das Datum des letzten Exports ist.
Import
Import via Batch-Job
Ein Transport kann mit folgender Syntax gestartet werden: Coplanner.exe "<ServerAdress>" "<Port>" "Transport=<FullyQualifiedFileNameToTransport>" Beispiel: Coplanner.exe "localhost" "8964" "Transport=c:\temp\testtransport.zip"
Logzeilen des Imports via Batchfile erhalten den Prefix [TRB].
Beispiel für ein Batchfile:
@echo off
start /wait Coplanner.exe "localhost" "8964" "Transport=c:\temp\myTransportPackage.zip"
IF %ERRORLEVEL% EQU 0 (
ECHO Transport finished with Exit Code 0
)
IF %ERRORLEVEL% NEQ 0 (
ECHO A problem occurred. See log for details.
ECHO Error: %ERRORLEVEL%
)
IF %ERRORLEVEL% EQU 5 (
ECHO Detail: Could not establish connection to server after 10 retries.
)
IF %ERRORLEVEL% EQU 11 (
ECHO Detail: Transport was cancelled because previous check was not successful. See server log for details.
)
IF %ERRORLEVEL% EQU 15 (
ECHO Detail: Transport was executed but the check of the target system was not successful. See server log for details.
)
pause
