Framework:Transport - Revision history

Admin at 06:42, 18 August 2016

2016-08-18T06:42:12Z

← Older revision		Revision as of 08:42, 18 August 2016
Line 93:		Line 93:
	\| <span style="color: darkblue;">'''Hint'''</span>  If a mask is imported which already exists in the system it will be overwritten and all existing user views will be deleted.		\| <span style="color: darkblue;">'''Hint'''</span>  If a mask is imported which already exists in the system it will be overwritten and all existing user views will be deleted.
	\|}		\|}


	{\| {{Bausteindesign1}}		{\| {{Bausteindesign1}}

Admin at 06:41, 18 August 2016

2016-08-18T06:41:56Z

← Older revision		Revision as of 08:41, 18 August 2016
Line 88:		Line 88:
	If inconsistencies exist they are displayed. Finish will execute the import.		If inconsistencies exist they are displayed. Finish will execute the import.


			{\| {{Bausteindesign1}}
			\|-
			\| <span style="color: darkblue;">'''Hint'''</span>  If a mask is imported which already exists in the system it will be overwritten and all existing user views will be deleted.
			\|}

	{\| {{Bausteindesign1}}		{\| {{Bausteindesign1}}

Admin at 08:17, 31 March 2016

2016-03-31T08:17:12Z

← Older revision		Revision as of 10:17, 31 March 2016
Line 16:		Line 16:


	[[Image:FW_Aufruf_Transport.png\|thumb\|center\|Framework, ~~Opentransport~~]]		[[Image:FW_Aufruf_Transport.png\|thumb\|center\|Framework, Open transport]]

	Using this button the following dialog is opened.		Using this button the following dialog is opened.

Admin at 08:16, 31 March 2016

2016-03-31T08:16:55Z

← Older revision		Revision as of 10:16, 31 March 2016
Line 12:		Line 12:


	==Open==		==Open transport==
	To ~~openthe~~ transport it is necessary to be logged in as Manufacturer, PowerUser or Partner-Mode. You can find the transport in the developer mode accessible via CoPlanner.		To open the transport it is necessary to be logged in as Manufacturer, PowerUser or Partner-Mode. You can find the transport in the developer mode accessible via CoPlanner.

Admin at 08:16, 31 March 2016

2016-03-31T08:16:36Z

← Older revision		Revision as of 10:16, 31 March 2016
Line 12:		Line 12:


	==~~Call~~==		==Open==
	To ~~call the~~ transport it is necessary to be logged in as Manufacturer, PowerUser or Partner-Mode. You can find the transport in the developer mode accessible via CoPlanner.		To openthe transport it is necessary to be logged in as Manufacturer, PowerUser or Partner-Mode. You can find the transport in the developer mode accessible via CoPlanner.


	[[Image:FW_Aufruf_Transport.png\|thumb\|center\|Framework, ~~Call transport~~]]		[[Image:FW_Aufruf_Transport.png\|thumb\|center\|Framework, Opentransport]]

	Using this button the following dialog is opened.		Using this button the following dialog is opened.

Admin at 15:29, 30 March 2016

2016-03-30T15:29:43Z

Admin at 15:26, 30 March 2016

2016-03-30T15:26:25Z

← Older revision		Revision as of 17:26, 30 March 2016
Line 104:		Line 104:
	{\| {{Bausteindesign1}}		{\| {{Bausteindesign1}}
	\|-		\|-
	\| <span style="color: darkblue;">'''Hint'''</span>  Import of table with calculated measures. <br>		\| <span style="color: darkblue;">'''Hint'''</span>  Import of table with calculated measures <br>
	If a new table is imported it is possible that warnings are raised inside the logging. The reason is that an actualisation of the table will be done afterwards and therefore the fields are not identified.		If a new table is imported it is possible that warnings are raised inside the logging. The reason is that an actualisation of the table will be done afterwards and therefore the fields are not identified.
	After a completed transport these calculated measures are transferred correctly and there are no further errors with that calculated measures.		After a completed transport these calculated measures are transferred correctly and there are no further errors with that calculated measures.

Admin at 15:24, 30 March 2016

2016-03-30T15:24:39Z

Show changes

Admin at 15:19, 30 March 2016

2016-03-30T15:19:48Z

← Older revision		Revision as of 17:19, 30 March 2016
Line 1:		Line 1:
	~~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~~.~~.<br>~~		The Transport is used for a simple transfer of objects between several systems. Only structures are transferred without table content, dimension and so on.
	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.		For a clean transport it is required that the source system equals the target system before the update and that no more objects are created on the target system.

	~~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~~.		There is also the possibility to start the import as Batch-Job to execute an automatic transport during the night.

	==~~Konfigurationsparameter~~==		==Configuration parameter==
	===[[~~Technik~~:CoPlanner-Server#SvrConfig.xml\|SvrConfig.xml]]===		===[[Technics:CoPlanner-Server#SvrConfig.xml\|SvrConfig.xml]]===
	~~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~~.		Authentication of the automatic transport occurs always using SSPI with user context of the caller. This user has to be entered in the field TransportUserName in SrvConfig.xml due to security regulations.

	===[[~~Technik~~:CoPlanner_Win-Client#coplanner.exe.~~config_Datei~~\|Coplanner.exe.config]]===		===[[Technics:CoPlanner_Win-Client#coplanner.exe.config_File\|Coplanner.exe.config]]===
	~~Die Sichtbarkeit der Einträge~~ "Transport" ~~und~~ "~~Clientseitige~~ Checks" ~~im Entwicklermenü am Client kann über den Eintrag~~ ShowTransportEntries ~~gesteuert werden~~.		Visibility of "Transport" and "Checks on the client side" in developer mode on the client is configured by ShowTransportEntries.


	==~~Aufruf~~==		==Call==
	~~Um das Transportwesen aufrufen zu können, muss man sich im Hersteller~~, PowerUser ~~oder~~ Partner-~~Modus befinden~~.		To call the transport it is necessary to be logged in as Manufacturer, PowerUser or Partner-Mode. You can find the transport in the developer mode accessible via CoPlanner.
	~~Es gibt hier wenn man über~~ CoPlanner ~~auf das Entwicklungsmenü geht der Eintrag Transportwesen~~.

	[[Image:FW_Aufruf_Transport.png\|thumb\|center\|Framework, Aufruf Transport]]		[[Image:FW_Aufruf_Transport.png\|thumb\|center\|Framework, Aufruf Transport]]

	~~Über diesen Button öffnet sich dann der folgende Dialog:~~		Using this button the following dialog is opened.

	[[Image:FW_Transportwesen_Dialog.png\|thumb\|center\|Framework, Dialog Transport]]		[[Image:FW_Transportwesen_Dialog.png\|thumb\|center\|Framework, Dialog Transport]]

Admin: Created page with "Das Transportwesen dient zum einfachen Überspielen von Objekten zwischen mehreren Systemen. Dabei werden nur Strukturen übernommen und nicht z.B. Inhalte von Tabellen, Dimen..."

2016-03-30T14:55:02Z

Created page with "Das Transportwesen dient zum einfachen Überspielen von Objekten zwischen mehreren Systemen. Dabei werden nur Strukturen übernommen und nicht z.B. Inhalte von Tabellen, Dimen..."

New page

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==
===[[Technik:CoPlanner-Server#SvrConfig.xml|SvrConfig.xml]]===
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.

===[[Technik:CoPlanner_Win-Client#coplanner.exe.config_Datei|Coplanner.exe.config]]===
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.

[[Image:FW_Aufruf_Transport.png|thumb|center|Framework, Aufruf Transport]]

Über diesen Button öffnet sich dann der folgende Dialog:

[[Image:FW_Transportwesen_Dialog.png|thumb|center|Framework, Dialog Transport]]

===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. Dieses Datum kann aber auf jedes beliebige Datum gesetzt werden. Mit dem Aktualisieren Button neben dem Datumsfeld kann man das Datum wieder auf den festgelegten Stichtag geben. Mit Strg+Klick auf den Aktualisieren Button wird das Datum auf den 01.01.0001 gesetzt.

[[Image:FW_Transport_Auswahl_Stichtag.PNG|thumb|center|Framework, Dialog Datumsauswahl bei Export]]

Mit "Weiter" erhält man nun eine Liste von den Objekten, die sich nach dem angegebenen Datum geändert haben. Gegliedert ist diese Liste in Objektverwaltung, BI-Center und Formatvorlagen.
Ordner kann man nicht extra anwählen, diese werden immer für die entsprechend gewählten Objekte mit exportiert.

In diesem Fenster werden die Objekte mit dem Datum der letzten Änderung angezeigt und können für den Export an- und abgewählt werden. Über das Kontextmenü auf der linken Spalte gibt es die Möglichkeit alle Objekte anzuwählen, alle Objekte abzuwählen und einen csv Export der Liste zu erstellen. Bei dem Export werden folgende Spalten exportiert: Name, ObjectType, ObjectTypeDetail, ModDate, ModDateDe, Path.
Im unterem Bereich steht ein Suchfeld zur Verfügung. Per Klick auf die Anzahl der Suchergebnisse werden alle Suchergebnisse für den Export aktiviert.

[[Image:FW_Transport_Exportliste.PNG|thumb|center|Framework, Liste bei Export mit Kontextmenü]]

Mit "Fertigstellen" muss man den Speicherort und den Namen für das Exportpaket vergeben. Danach wird das Paket erstellt und es gibt eine Information, wenn der Transport abgeschlossen ist.

{| {{Bausteindesign1}}
|-
| '''Hinweis'''  Folgende Objekttypen sind vom Export/Import ausgeschlossen:
:* AggMasken
:* PDFBerichte
|}

{| {{Bausteindesign1}}
|-
| '''Hinweis'''  Folgende Systemobjekte sind vom Export/Import ausgeschlossen:
:* tb_Benutzer
:* tb_BenutzerGruppen
:* tb_BenutzerGruppenDetails
:* sys_Import_History
:* sys_BenutzerGruppenDimDetails
:* sys_Anwendungseigenschaften
:* autoexec
:* sys_ML_Objects
:* sys_ML_Strings
:* sys_Menue
|}

===Import===
Um einen Import zu starten, die Schaltfläche bei Import aktivieren und "Assistent starten" klicken.

Es öffnet sich ein Dialog, in dem das zu transportierende Paket ausgewählt werden muss. Danach gelangt man mit "Weiter" zum nächsten Schritt.

[[Image:FW_Transport_Import_Auswahl.JPG|thumb|center|Framework, Transportpaket auswählen]]

Es öffnet sich die Liste der Objekte, welche importiert werden können. Es besteht auch hier wieder die Möglichkeit Objekte an- und abzuwählen. Über das Kontextmenü auf der linken Spalte können wieder alle Objekte gleichzeitig abgewählt und angewählt werden. Zusätzlich gibt es die Option, sich nur Objekte zu importieren, welche schon am System vorhanden sind.
In dieser Übersicht wird auch dargestellt, was sich geändert hat. Hier werden nur Feldänderungen und Dimensions- bzw. LookUp-Änderungen dargestellt. Änderungen wie Planabhängig, etc. werden nicht extra ausgewiesen, aber sehr wohl importiert.
Wenn die entsprechenden Objekte ausgewählt wurden gelangt man mit "Weiter" zum nächsten Schritt.

[[Image:FW_Transport_Import_Uebersicht.jpg|thumb|center|Framework, Auswahl der Objekte die importiert werden sollen]]

Es werden nun Systemchecks durchgeführt, ob der Import sauber ausgeführt werden kann. Ist das der Fall bekommt man die Meldung "Die Modellkonstistenzprüfung liefert keine Fehler oder Inkonsistenzen". Hat man Inkonsistenzen, so werden diese angeführt. Mit "Fertigstellen" kann der Import nun ausgeführt werden.

{| {{Bausteindesign1}}
|-
| '''Hinweis'''  Wenn man während des Imports die Objektverwaltung/BI-Center offen hat, empfiehlt es sich danach ein Refresh der Objektverwaltung zu machen.
|}

{| {{Bausteindesign1}}
|-
| '''Hinweis'''  Wenn man am Quellsystem den Namen von Tabellen, usw. ändert und diese dann in das Zielsystem kopieren will, gibt es den Namen/Id Konflikt. Diese Objekte müssen dann zuerst am Zielsystem auf den Namen angepasst werden, um einen Transport durchführen zu können. Bei einem manuellen Import kann man diese Objekte erst gar nicht für den Import anwählen, sie werden aber zur Info aufgelistet.
|}

{| {{Bausteindesign1}}
|-
| '''Hinweis'''  Importieren von Tabellen mit berechneten Feldern 
Wenn eine Tabelle neu importiert wird kann es auftreten, dass Warnungen im Log entstehen. Das kommt daher, weil das Aktualisieren der Tabelle erst später gemacht wird und die Felder daher nicht erkannt werden. Nach abgeschlossenem Transport sind diese aber korrekt im System und es treten keine Probleme mit den berechneten Feldern auf.
|}

===Import via Batch-Job===
Man kann einen Import auch über einen Batch-Job anstarten. Voraussetzung für das Durchlaufen solcher Importe ist aber, dass die Modellkonsistenzüberprüfungen, welche vor dem tatsächlichen Import durchgeführt werden, ohne Fehler durchlaufen.

Ein Transport kann mit folgender Syntax gestartet werden:
Coplanner.exe "<ServerAdress>" "<Port>" "Transport=<FullyQualifiedFileNameToTransport>" 
Beispiel:
<source lang="winbatch">Coplanner.exe "localhost" "8964" "Transport=c:\temp\testtransport.zip"</source>

Der Übertragungsmodus hier ist immer native und kann nicht eingestellt werden.

Nach dem automatisierten Import wird das "PostTransportMacro" sofern es am System zur Verfügung steht ausgeführt. Das Makro muss an keiner bestimmten Stelle in der Struktur in der Objektverwaltung vorhanden sein. In diesem Makro kann man angeben, dass z.B. ein CreateViews ausgeführt wird.

Logzeilen des Imports via Batchfile erhalten den Prefix [TRB].

Beispiel für ein Batchfile:
<source lang="winbatch">

@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
</source>

__NOEDITSECTION__

[[Category:Framework|Transport]]
[[Category:Administration|Transport]]
[[en:Framework:Transport]]

← Older revision		Revision as of 17:29, 30 March 2016
Line 16:		Line 16:


	[[Image:FW_Aufruf_Transport.png\|thumb\|center\|Framework, ~~Aufruf Transport~~]]		[[Image:FW_Aufruf_Transport.png\|thumb\|center\|Framework, Call transport]]

	Using this button the following dialog is opened.		Using this button the following dialog is opened.

	[[Image:FW_Transportwesen_Dialog.png\|thumb\|center\|Framework, ~~Dialog~~ Transport]]		[[Image:FW_Transportwesen_Dialog.png\|thumb\|center\|Framework, Transport dialog]]


Line 36:		Line 36:
	Using Ctrl+Click on the actualisation button the date will be set to 01.01.0001.		Using Ctrl+Click on the actualisation button the date will be set to 01.01.0001.

	[[Image:FW_Transport_Auswahl_Stichtag.PNG\|thumb\|center\|Framework, ~~Dialog Datumsauswahl bei Export~~]]		[[Image:FW_Transport_Auswahl_Stichtag.PNG\|thumb\|center\|Framework, Datechoose dialog at export]]

	"Next" shows a list of elements which have been changed after the selected date. This list is separated in Object Administration, BI-Center an style sheets. It is not possible to select folders extra because these folders are always exported with the associated object.		"Next" shows a list of elements which have been changed after the selected date. This list is separated in Object Administration, BI-Center an style sheets. It is not possible to select folders extra because these folders are always exported with the associated object.
Line 43:		Line 43:
	These columns are exported: Name, ObjectType, ObjectTypeDetail, ModDate, ModDateDe, Path. In the below section a search field is available. A click on the number of search results will activate all search results for the export.		These columns are exported: Name, ObjectType, ObjectTypeDetail, ModDate, ModDateDe, Path. In the below section a search field is available. A click on the number of search results will activate all search results for the export.

	[[Image:FW_Transport_Exportliste.PNG\|thumb\|center\|Framework, ~~Liste bei Export mit Kontextmenü~~]]		[[Image:FW_Transport_Exportliste.PNG\|thumb\|center\|Framework, List at export with context menu]]

	"Finish" asks for a storage location and name of the export package. Afterwards the package is created and an information is shown when the transport is finished.		"Finish" asks for a storage location and name of the export package. Afterwards the package is created and an information is shown when the transport is finished.
Line 76:		Line 76:
	A new dialog will be opened to select the package which should be transferred.		A new dialog will be opened to select the package which should be transferred.

	[[Image:FW_Transport_Import_Auswahl.JPG\|thumb\|center\|Framework, ~~Transportpaket auswählen~~]]		[[Image:FW_Transport_Import_Auswahl.JPG\|thumb\|center\|Framework, Choose transport package]]

	A List of objects is shown which can be imported. Here you have also the possibility to select or unselect objects. The context menu on the left column offers again the possibility to select or unselect all objects.		A List of objects is shown which can be imported. Here you have also the possibility to select or unselect objects. The context menu on the left column offers again the possibility to select or unselect all objects.
Line 83:		Line 83:
	If you have selected all appropriate objects you can go further with "Next".		If you have selected all appropriate objects you can go further with "Next".

	[[Image:FW_Transport_Import_Uebersicht.jpg\|thumb\|center\|Framework, ~~Auswahl der Objekte die importiert werden sollen~~]]		[[Image:FW_Transport_Import_Uebersicht.jpg\|thumb\|center\|Framework, Selection of objects which should be imported]]

	Now system checks are operated to prove if the import can be executed successfully. If that check was successful the message "The model rigidity check provides no errors or inconsistencies" is shown.		Now system checks are operated to prove if the import can be executed successfully. If that check was successful the message "The model rigidity check provides no errors or inconsistencies" is shown.