V7 to V8 Bedienungsanleitung - Wincan
←
→
Transkription von Seiteninhalten
Wenn Ihr Browser die Seite nicht korrekt rendert, bitte, lesen Sie den Inhalt der Seite unten
V7 to V8 Bedienungsanleitung
INHALTSVERZEICHNIS 1. Einführung .................................................................................................................................................3 2. Systemvoraussetzungen ...........................................................................................................................3 3. Installation des Konverters ........................................................................................................................3 4. Betrieb des Konverters ..............................................................................................................................7 5. Konfiguration des Konverters ..................................................................................................................10 6. Arbeitsweise des Konverters (Suchstrategie) .........................................................................................12 7. Kommandozeilen-Optionen .....................................................................................................................12 8. Logfile des Konverters .............................................................................................................................13 9. Feld-Mapping des Konverters .................................................................................................................14 10. Sonstiges ...............................................................................................................................................16 11. Deinstallation des Konverters................................................................................................................17
1. Einführung
Der „V7 to V8 Converter“ ist ein Programm zum Konvertieren von WinCan v7 Datenbanken (Projekten)
nach WinCan v8. Dieses Dokument beschreibt die Installation, Bedienung und Funktionsweise dieses
Konverters.
2. Systemvoraussetzungen
• Microsoft Windows 2000/XP Service Pack 2
• Das Kern-Setup von WinCan v8 (WinCan8CoreSetup.exe) muss installiert sein.
• Je nach Zieldatenbank müssen die entsprechenden Treiber vorinstalliert werden.
Der Konverter kann als „Standalone“ Produkt ohne irgendwelche Installationen von WinCan v8 verwendet
werden. Wird er als Komponente von WinCan v8 installiert, so entnimmt er zum Betrieb, der v8 Installation
einige Informationen (z.B. verwendete Sprache, verwendeter Katalog usw.), welche sonst von Hand
eingestellt werden müssen.
3. Installation des Konverters
Zur Installation wird das Programm „V7toV8Setup.exe“ gestartet.
Dieses Fenster ist das Startfenster des Installationsprogrammes. Bestätigen Sie dieses mit >.
August 2006 Seite 3 / 17Die Copyright-Informationen müssen mit und > bestätigt werden. August 2006 Seite 4 / 17
Geben Sie hier den Benutzer- und Firmennamen ein und bestätigen Sie erneut mit >. Im „Standalone“ Betrieb wird die Angabe eines Zielverzeichnisses verlangt. Wenn auf dem PC bereits eine WinCan v8 Installation vorhanden ist, so ist das Zielverzeichnis vorgegeben (..\\Utils\V7ToV8-Converter) und kann nicht verändert werden! Es wird empfohlen, auch im „Standalone“-Betrieb, das empfohlene Zielverzeichnis (..\\WinCan v8) beizubehalten, damit bei einer nachträglichen Installation von WinCan v8 alles im gewünschten WinCan- Verzeichnis zusammengefasst ist! Bestätigen Sie auch hier den nächsten Schritt mit >. Im drauffolgenden Fenster kann die Installation des Konverters mit gestartet werden. Falls eine Eingabe wiederholt werden muss, so kann mittels der Taste jeweils einen Schritt zurück gegangen werden. Bemerkung: Der Konverter kann v7 Access-Datenbanken nach v8 Access-Datenbanken oder v8 MSSQL-Server-Datenbanken konvertieren. Damit letzteres funktioniert, muss der ensprechende SQL-Server oder die MSDE (Microsoft Desktop Database Engine) installiert worden sein. Die MSDE ist ein integraler Bestandteil des eingangs erwähnten Kern-Setups (WinCan8CoreSetup.exe) und kann mit diesem auf Wunsch installiert werden. August 2006 Seite 5 / 17
Der Installationsvorgang läuft weitestgehend selbständig ab. Nach der Installation kann der Konverter ohne weitere Vorbereitungen verwendet werden. August 2006 Seite 6 / 17
4. Betrieb des Konverters
Der Converter wird über das Windows-Startmenü „> WinCan v8 >> Utils >>
>“ gestartet. Bemerkung: Als Programmsprache ist für den
Konverter nur Englisch verfügbar. Unabhängig davon, können aber auch Datenbanken
anderer Sprachen konvertiert werden.
Info- oder Titelzeile
Nach dem Start wird in der Info- bzw. Titelzeile die Konvertiersprache, Template und der Befahrungskatalog
angezeigt. Da noch keine Wahl der Quell-Datenbank getroffen wurde, werden hier die Standardwerte „USA“
und „Start.wtp“ angezeigt.
Als erste wird die v7 Quell-Datenbank (Src.-DB) ausgewählt – Vergewissern Sie sich bitte, dass es sich
dabei auch wirklich um eine WinCan v7 Datenbank handelt.
August 2006 Seite 7 / 17Als 2. wird das v8 Ziel-Verzeichnis (Dst.-Path) ausgewählt. Es muss dabei nur das Root-Verzeichnis der v8 Projekte angegeben werden und nicht das Projekt-Verzeichnis selbst. Der Konverter erstellt unter dem Root- Verzeichnis jeweils automatisch ein Unterverzeichnis mit dem Namen der Quell-Datenbank. An Hand obigen Beispiels werden die konvertierten Daten also im Verzeichnis „“ erstellt. Bemerkung: Der Konverter erstellt unter diesem Projekt-Verzeichnis die gesammte für WinCan v8 Projekte benötigte Verzeichnisstruktur - so wird die konvertierte v8 Datenbank selbst unter dem Verzeichnis „" abgelegt, die Bilder unter „“, die Videos unter „“ u.s.w. August 2006 Seite 8 / 17
Info- oder Titelzeile Nachem Quell-Datenbank und Ziel-Verzeichnis ausgewählt sind, kann mit der Konvertiervorgang ausgeführt werden. Je nach grösse der Datenbank und der Anzahl der zu kopierenden Bilder und Videos kann dieser Vorgang mehrere Minuten dauern. Der Konverter übernimmt dabei nich nur das Konvertieren der v7 Access 97 Datenbanken auf v8 Access 2000 Datenbanken bzw. MS SQL-Server Datenbanken, sondern kopiert auch alle vorhandenen externen Dateien eines v7 Projektes in die im v8 dafür vorgesehenen Unterverzeichnisse. Bemerkung: Unmittelbar nach betätigen der Start-Taste wird in der Info- bzw. Titelzeile die zur Konvertierung tatsächlich verwendeten Templates und Kataloge angezeigt. In obigem Beispiel handelt es sich dabei um ein spezielles US-Englisches Projekt (PACP) mit den üblichen Templates "Start.wtp" und dem speziellen Katalog "obs_pacp.mdb" für diese Quell- Datenbank. Der Konverter verfügt über eine spezielle Suchstrategie, mit welcher er die verwendeten Sprachen, Templates und Kataloge selber bestimmt. Diese Strategie hängt davon ab, ob der Konverter "Standalone" oder als Komponente nach WinCan v8 installiert wurde. Die Strategie kann aber vom Benutzer in der INI-Datei des Konverters angepasst werden. Nach Beendigung der Konvertierung kann die neue v8 Datenbank direkt mit WinCan 8 geöffnet und verwendet werden. August 2006 Seite 9 / 17
5. Konfiguration des Konverters
Wie ende letzen Abschnittes erwähnt, können einige Parameter des Konverters in dessen
INI-Datei (V7ToV8.ini) angepasst werden. Nachfolgend ein Auszug aus der INI-Datei des
Konverters und die Bedeutung der verwendeten Parameter (Schlüssel):
Alle mit ";" beginnenden
Anweisungen sind reine
;The WinCan V7.x to V8.0 Converter (User - INI - File) Kommentare und haben
keinen Einfluss auf die
Konvertierung.
[Application]
Title=V7ToV8-Converter
Product=WinCan 8.0 Converter-Tools
Version=V1.X.X Alle unter [Application]
LicenseTo=CD-LAB, CH-3280 Murten, Switzerland aufgeführten Anweisungen
Company=CD-LAB, CH-3280 Murten, Switzerland (Ausnahme: Language)
Copyright=(c)Copyright 2003 by CD-LAB, CH-3280 Murten dienen nur der Identifi-
Platform=Windows zierung des Programmes
Warning=! und haben keinen Einfluss
Language=USA auf die Konvertierung.
[Fonts]
Die Sektion [Fonts] wird
nicht benutzt und hat
[Environment] keinen Einfluss auf die
SQLServer=MSACCESS Konvertierung.
DefaultTemplateS=Start.wtp
DefaultCatNameS=
DefaultTemplateMH=Start.wtp
DefaultCatNameMH=
DefaultPACPTemplateS=pacp.wtp Unter [Environment]
DefaultPACPCatNameS=obs_pacp.mdb werden die für die Konver-
DefaultPACPTemplateMH=start.wtp tierung relevanten Einstel-
DefaultPACPCatNameMH=mh.mdb lungen vorgenommen.
DefaultPACPLookup=nassco_export.ori
GenerateSection=2
…
…
DebugMode=ALL Dieser besondere Schlüssel dient zur
Einstellung des Debug-bzw. Trace-
Levels.
Der Konverter kann zur einfacheren
Fehlersuche im Logfile (siehe Logfile)
Datenbankzugriffe proto-kollieren.
Mögliche Werte sind:
DebugMode=ALL, es werden alle
Zugriffe protokolliert /
DebugMode=ERRORS, es werden nur
Fehler proto-kolliert / DebugMode= ,
der Trace ist deaktiviert.
August 2006 Seite 10 / 17Tabellarische Auflistung der Schlüsselwerte:
Schlüssel Bedeutung Wert 1 Wert 2 Default
SQLServer1 Bestimmt das MSACCESS MSSQL Ohne Angaben ist
Format der Ziel- MSACCESS
Datenbank
DefaultTemplateS2 Das Template für Existierendes Start.wtp
Haltungen Template
DefaultCatNameS3 Der Haltungskatalog Existierender Leer, siehe Text
Katalog
DefaultTemplateMH --unbenuzt
DefaultCatNameMH4 Der Schachtkatalog Existierender Mh.mdb
Katalog
..PACPTemplateS5 Das Template für Existierendes Pacp.wtp
Haltungen, wenn ein PACP-Template
PACP Projekt
..PACPCatNameS Der Haltungskatalog, Existierender Obs_pacp.mdb
wenn ein PACP PACP-Katalog
Projekt
..PACPTemplateMH --unbenutzt
..PACPCatNameMH Der Schachtkatalog, Existierender Mh.mdb
wenn ein PACP PACP-Katalog
Projekt
..PACPLookup6 Der Nachschlage- Nassco_export.ori Nassco_export.ori
Katalog für PACP
Projekte
GenerateSection7 Haltungsgeneration 0=keine Siehe Text 0=keine
1
Zur Zeit stehen nur MS-ACCESS und MS SQL-Server Datenbanken als Zielformat zur Verfügung. Muss
von einem auf das andere Format gewechselt werden, so kann das nur durch Änderung dieses Schlüssels
in der INI-Datei (V7ToV8.ini) geschehen.
2
Als Template kann in den meisten Fällen "Start.wtp" für normale Projekte verwendet werden. Soll
permanent ein anderes verwendet werden, so kann dieses hier angegeben werden. Dieser Eintrag hat in
jedem Fall Priorität vor anderen Suchstrategien.
3
Falls ein spezieller Haltungskatalog verwendet werden soll, so kann dieser hier angegeben werden. Dieser
Eintrag hat dann Priorität vor allen anderen Suchstrategien. Falls dieser Eintrag leer bleibt, so wird bei
installiertem WinCan v8, automatisch dessen erster (sprachabhängiger) Haltungskatalog im
Sprachverzeichnis unter [Language=...] verwendet. Fehlt ein solcher Katalog (z.B. bei einer Standalone-
Installation), so wird der Standard-Katalog für Haltungen in US-Englisch "obs_english_us.mdb" verwendet.
4
Falls ein spezieller Schachtkatalog verwendet werden soll, so kann dieser hier angegeben werden. Dieser
Eintrag hat dann Priorität vor allen anderen Suchstrategien. Falls dieser Eintrag leer bleibt, so wird bei
installiertem WinCan v8, automatisch dessen erster (sprachabhängiger) Schachtkatalog im
Sprachverzeichnis unter [Language=...] verwendet. Fehlt ein solcher Katalog (z.B. bei einer Standalone-
Installation), so wird der Standard-Katalog für Schächte (in der Regel) "mh.mdb" verwendet.
5
Bei den sog. PACP-Projekten handelt es sich um eine spezielle amerikanische Befahrungs-Norm, welche
ein spezielles Template und Katalog zur Konvertierung verlangen. Im Moment gibt es nur ein
entsprechendes Template "Pacp.wtp" und ein ensprechender Katalog "Obs_pacp.mdb", welche verwendet
werden können. Aus diesem Grunde können alle Einträge unter "..PACP.." so belassen werden, wie sie
sind. Der Konverter bestimmt an Hand der Quell-Datenbank, ob es sich um ein PACP-Projekt handelt oder
nicht. Ist es ein PACP-Projekt, so gelten die Angaben unter den Schlüsseln "..PACP..", wenn nicht, so gelten
die Angaben und Suchstrategien unter den normalen Schlüsseln.
6
Der Konverter muss bei PACP-Projekten zwingend einen Vergleich der alten mit neuen PACP-Werten
(z.B. Befahrungscodes) machen und diese ggf. konvertieren oder eliminieren. Die Datenbank
"Nassco_export.ori" enthält alle dafür notwendigen Werte und der Eintrag kann (muss) so belassen
werden.
7
In manchen v7 Projekten haben Haltungen keinen eindeutigen Namen bzw. Identifizierung. In v8 wird
grundsätzlich mit einer eindeutigen Haltungsidentifizierung gearbeitet. Um diesen Konflikt zu umgehen, kann
der Konverter bei Bedarf einen bestimmten Haltungsnamen generieren (GenrateSection=1, benutzt den v7
Haltungsnamen plus eine fortlaufende Nummerierung / GenerateSection=2, generiert nach deutscher
Norm, also Name=von Schacht-bis Schacht), ansonsten wird nur der Quellname übernommen.
August 2006 Seite 11 / 176. Arbeitsweise des Konverters (Suchstrategie) Der Konverter versucht zuerst die Sprache der Konvertierung zu bestimmen. Dazu öffnet er als erstes die Projekt-Tabelle der Quell-Datenbank. Ist dort ein entsprechender Sprach-eintrag vorhanden, so gilt dieser für die Konvertierung (nach einem entsprechenden Mapping auf die v8 Sprachenregelung - siehe Abschnitt Mapping). Fehlt ein solcher Eintrag, so wird bei installiertem WinCan v8, die aktuelle Sprache von WinCan übernommen. Handelt es sich um eine Standalone-Installation (also ohne WinCan v8), so wird die Sprache der INI-Datei unter dem Schlüssel [Language..] verwendet. Fehlt dieser Eintrag ebenfalls, so wird als letzte Möglichkeit die Standard-Sprache "USA" als Default für die weitere Konvertierung verwendet. Bei den Templates und den Befahrungskatalogen gilt ein umgekehrtes Verfahren. Zuerst wird in der INI- Datei des Konvertes nachgeschaut, ob ein Template und/oder Katalog auf dem jeweiligen Schlüssel definiert ist. Dieser Lookup ist sprachunabhängig und hat, wie oben angedeutet, höchste Priorität. Sind in der INI- Datei keine entsprechenden Einträge vor-handen bzw. definiert, so wird bei vorhandener WinCan v8 Installation, das erste Template bzw. der erste Katalog unter dem vorbestimmten Sprachverzeichnis von WinCan v8 eingesetzt. Kann ein solches Sprachverzeichnis nicht bestimmt werden, so werden sowohl das Default-Template "Start.wtp" unter der Default-Sprache "USA" verwendet, als auch der der Default-Katalog "obs_english_us.mdb". 7. Kommandozeilen-Optionen Als Alternative zur INI-Datei, können gweisse Paramter des Konverters noch über die Kommandozeile eingestellt werden. Diese Möglichkeit ist vor allem dann hilfreich, wenn der Konverter im Batch-Betrieb oder mittels eines Taskmanagers, zeitgesteuert ausgeführt werden soll. /help - Hilfe über die Kommandozeilen-Optionen /oracle - - -zur Zeit nicht benutzt (nur Testbetrieb) /xml - erzeugt einen XML-Export der konvertierten Daten /overwrite - überschreibt eine existierende Ziel-Datenbank ohne Nachfrage /source: - Angabe der Quell-Datenbank /destin: - Angabe des Ziel-Verzeichnisses /auto - Vollständig automatische Konvertierung ohne Dialoge /comparator - Erzeugt Verifizierungsdaten zur Kontrolle der Konvertierung /pacp - Forciert eine PACP-Konvertierung (höchste Priorität) Eine typischer Kommandozeilenaufruf an Hand eingangs aufgeführtem Beispiel, könnte also wiefolgt aussehen: V8ToV8.exe /overwrite /source:C:\TEST\WinCan7_Proj\Nashville\05_12_2003.mdb /destin:C:\TEST\WinCan8_Proj /auto Eine derartige Kommandozeile konvertiert die v7 Datenbank "C:\TEST\WinCan7_Proj\Nash- ville\05_12_2003.mdb" völlig automatisch in das v8 Verzeichnis " C:\TEST\WinCan8_Proj", d.h. völlig ohne Interkation mit dem Benutzer. Dies ermöglicht, bei mehreren zu konver-tierenden Datenbanken, dies z.B. automatisch während der Nacht durchführen zu lassen. Allfällige (Fehler)ereignisse werden dabei in einem Logfile festgehalten. August 2006 Seite 12 / 17
8. Logfile des Konverters
Sämtliche Aktionen (Fehler), die der Konverter durchführt, werden in einem Logfile fest-gehalten. Das Logfile
befindet sich normalerweise im Installationsverzeichnis des Konvertes (typisch: "..\\WinCan
v8\Utils\V7ToV8-Converter") und es trägt dem Namen "v7tov8.txt".
Der Inhalt eines solchen Logfiles könnte wiefolgt aussehen (Auszug):
**************************************************************************************
* WinCan Release 7.x to Wincan Release 8.x Conversion Program Logfile *
**************************************************************************************
Date and Time :01.12.2005 09:47:22
Mapping file :C:\Project\V7ToV8\v7tov8_Mapping.def
WinCan Realease 7.x to be imported :C:\TEST\WinCan7_Proj\Nashville\05_12_2003.mdb
Converted WinCan Realease 8.x project in :C:\TEST\WinCan8_Proj\05_12_2003
**************************************************************************************
V7ToV8_Start: START converting at 09:47:22 ...
WinCanStructure: Erstelle/Aktualisiere WinCan 8.x \Root Verzeichnis 'C:\TEST\WinCan8_Proj\05_12_2003'
WinCanStructure: Erstelle/Aktualisiere WinCan 8.x ..\DB Verzeichnis
'C:\TEST\WinCan8_Proj\05_12_2003\DB'
...
WinCanStructure: Erstelle/Aktualisiere WinCan 8.x ..\Ini Verzeichnis
'C:\TEST\WinCan8_Proj\05_12_2003\Ini'
…
V7ToV8_Start: Open WinCan 7.x source database 'C:\TEST\WinCan7_Proj\Nashville\05_12_2003.mdb' ...
V7ToV8_Start: Create WinCan 8.0 destination database '05_12_2003' on server/engine 'Microsoft.Jet' with
file location in 'C:\TEST\WinCan8_Proj\05_12_2003\DB' ...
V7ToV8_CopyTemplate: Copy file/template 'C:\Program Files\WinCan
v8\WinCan\Scripts\create_wincan_mdb.tpl' to 'C:\TEST\WinCan8_Proj\05_12_2003\DB\05_12_2003.mdb' ...
V7ToV8_Start: Open WinCan 8.0 destination database
'C:\TEST\WinCan8_Proj\05_12_2003\DB\05_12_2003.mdb' on server/engine 'Microsoft.Jet' ...
V7ToV8_Start: Start to import/convert WinCan 7.x project data...
$$$$$EXECUTE$$$$$: P_T
$$$$$EXECUTE$$$$$: C_T
V7ToV8_ImportProjects: Import Client [], ID = {D7797303-2248-4816-8FEA-511CAC973A89}...
V7ToV8_ImportProjects: 0 WinCan 8.x AddInfo fields created...
V7ToV8_ImportProjects: Import Manager [], ID = {32DC1932-EB06-4FC5-8BEE-16EBDD4C56B8}...
V7ToV8_ImportProjects: 0 WinCan 8.x AddInfo fields created...
V7ToV8_ImportProjects: Import project [05_12_2003], ID = {AE4CCF60-CC93-44C9-B8A8-
7E2EF37FD971}...
V7ToV8_ImportProjects: 0 WinCan 8.x AddInfo fields created...
…
$$$$$EXECUTE$$$$$: M_T
V7ToV8_Start: 1 WinCan 8.x projects imported/converted..
V7ToV8_Start: Start to import/convert WinCan 7.x node data...
$$$$$EXECUTE$$$$$: N_T
V7ToV8_ImportNodes: Import node [S054-183], ID = {687ABEA0-4693-4F7E-9618-8E03E36E7A39}...
V7ToV8_ImportNodes: Import node [S052-371], ID = {2652533C-AE0A-42EF-BF56-7128315A0BA8}...
$$$$$EXECUTE$$$$$: UPDATE NI_T SET NI_T.NI_Section_ID = '{4E873F7D-C08A-4249-A050-
51C054BCEA9E}' WHERE (((NI_T.NI_Node_ID) = '{51DA4D46-1DCA-4BA9-A6C8-E70910D16F56}'))
V7ToV8_ImportSections: 0 WinCan 8.x AddInfo fields created...
V7ToV8_ImportSectionInspections: Check WinCan 8.x inclination file
'C:\TEST\WinCan7_Proj\Nashville\1.inc' ...
V7ToV8_ImportSectionInspections: Check WinCan 8.x inclination file
'C:\TEST\WinCan7_Proj\Nashville\05_12_2003_1.inc' ...
V7ToV8_ImportSectionInspections: Import inspection [i1], ID = {76E65BA9-75A5-4F70-A480-
C818C7AD27FF}...
V7ToV8_ImportSectionInspections: 0 WinCan 8.x AddInfo fields created...
August 2006 Seite 13 / 17V7ToV8_ImportInspectionObservations: Check WinCan 8.x video file
'C:\TEST\WinCan7_Proj\Nashville\05_12_2003_1_1a.mpg' ...
V7ToV8_ImportInspectionObservations: 0 WinCan 8.x AddInfo fields created...
V7ToV8_ImportInspectionObservations: Import observation, ID = {9581131D-0426-49D1-9708-
96C635C3A085}...
V7ToV8_ImportInspectionObservations: Check WinCan 8.x photo file 1
'C:\TEST\WinCan7_Proj\Nashville\05_12_2003_1_2a.jpg' ...
V7ToV8_ImportInspectionObservations: 0 WinCan 8.x AddInfo fields created...
V7ToV8_ImportInspectionObservations: Import observation, ID = {8D1199D6-8DE3-40C7-84C7-
90A6EC0B8B5D}...
V7ToV8_ImportInspectionObservations: Check WinCan 8.x photo file 1
'C:\TEST\WinCan7_Proj\Nashville\05_12_2003_1_3a.jpg' ...
V7ToV8_ImportInspectionObservations: 0 WinCan 8.x AddInfo fields created...
V7ToV8_ImportInspectionObservations: Import observation, ID = {63BB0A4C-9683-49E9-AE04-
08893CA871AD}...
V7ToV8_ImportInspectionObservations: Check WinCan 8.x photo file 1
'C:\TEST\WinCan7_Proj\Nashville\05_12_2003_1_4a.jpg' ...
V7ToV8_ImportInspectionObservations: 0 WinCan 8.x AddInfo fields created...
V7ToV8_ImportInspectionObservations: Import observation, ID = {68038495-27B9-4A56-BDC3-
2F813E008EF0}...
V7ToV8_ImportInspectionObservations: 0 WinCan 8.x AddInfo fields created...
…
Bemerkung: Bei den rot unterlegten Textpassagen handelt es sich um Debug-Informationen
bzw. Tracepoints, welche in der INI-Datei über den entsprechenden Schlüssel (siehe:
DebugMode=...) aktiviert werden können.
9. Feld-Mapping des Konverters
Der Konverter verfügt über eine Standard-Feld-Zuordnung, d.h. welche Feldwerte der v7 Datenbank,
welchen Feldwerten der v8 Datenbank zugeordnet werden. Im Dokument "V7ToV8 migration path.pdf"
(auffindbar im Installationsverzeichnis des Konverters) ist diese Zuordnung dokumentiert. Da sich die
Datenbanken der Version v7 und auch der Version v8 im Laufe der Weiterentwicklung stark verändert
haben, ist diese Zuordnung nicht für alle Projekte vollumfänglich gültig. Um diesem Manko und auch
zukünftigen Unter-schieden zu begegnen, kann das Standard-Feld-Mapping mit Hilfe einer Mapping-Datei
überschrieben werden. Die Mapping-Datei befindet sich ebenfalls im Installtionsverzeichnis des Konverters
mit dem Namen "V7ToV8_Mapping.def".
Bemerkung: Bei dieser Mapping-Datei handelt es sich um die Standard-Mapping-Datei. Eine
Mapping-Datei kann jedoch sprachspezifisch unter den jeweiligen Sprachverzeichnissen der
WinCan v8 Installation abgelegt werden. Dazu muss der Name der Mapping-Datei mit dem
sprachspezifischen Prefix versehen und in das ensprechende Unterverzeichnis kopiert
werden, also z.B. "USA_V7ToV8_Mapping.def" oder "GERMANY_V7ToV8_Mapping.def"
usw.
August 2006 Seite 14 / 17Nachfolgend ein Auszug aus der INI-Datei des Konverters und die Bedeutung der relevanten Parameter:
; The WinCan V7.x to V8.0 Mapping/Definition file Alle mit ";" beginnenden
; Anweisungen sind reine
; Format: TargetField=SourceField,TargetFieldType,Translation Kommentare und haben
; keinen Einfluss auf das
; TargetFieldType: Int, Bool, Float, Text, Date, Time Feld-Mapping
;
; Translation: OldValue1>NewValue1/OldValue2>NewValue2/..../OldValueN>NewValueN
;
[Mapping.Language]
ENGLISH_US=USA Die [Mapping.Language]
PACP=USA Sektion bestimmt das
ENGLISH_UK=UK Sprachmapping von v7 auf
FRENCH=FRANCE v8. Dies ist notwendig, da
GERMAN=GERMANY man hier teilweise unter-
SWISS_GERMAN=SUISSE_GE schiedliche Bezeichnungen
SWISS_FRENCH=SUISSE_FR verwendet hat. Format:
SWISS_ITALIEN=SUISSE_IT V7_SPRACHE=V8_SPRACHE
[Default.P_T]
[Mapping.P_T] Über die [Default.]
Sektion können den Feldern
[Default.C_T] sog. Default-Werte zuge-
ordnet werden. Da sind
[Mapping.C_T] Werte, die dann jeder neue
Datensatz in der Ziel-
[Default.S_T] Tabelle erhält. Format:
V8_FIELD_NAME=VALUE
[Mapping.S_T]
;S_SectionName=S_T.S_SectionName,Text
;S_SectionNumber=S_T.S_Counter,Text
[Default.SI_T] Über die [Mapping.]
Sektion wird das eigentliche
[Mapping.SI_T] Mapping der Felder vorge-
nommen (im Beispiel aus-
[Default.SO_T] kommentiert). Format:
V8_FIELD_NAME=V7_TAB
[Mapping.SO_T] LE.FIELD_NAME,TYPE.
;SO_Rate=O_T.O_Level,Int,R>91/S>92 Mit Hilfe der Typenangabe
wird eine explizite Typen-
[Default.N_T] konvertierung vorge-
nommen.
[Mapping.N_T]
[Default.NI_T] Ein Spezialfall stellt das Rating der
Befahrungen dar. Hier wird neben
[Mapping.NI_T] dem Feld-Mapping zusätzlich
noch ein Wert-Mapping
[Default.NO_T] vorgenom-men. In v7 Projekten
wurde das Rating für
[Mapping.NO_T] Reparaturen (R) und
Steckenschäden (S) mittels den
[Default.NE_T] 2 Buchstaben vorgenommen. In
v8 muss das auf die
[Mapping.NE_T] entsprechenden Zahlenwerte
gemappt werden. Format:
[Default.NC_T] V7_WERT1>V8_WERT1,
V7_WERT2>V8_WERT2 usw.
[Mapping.NC_T]
August 2006 Seite 15 / 17Damit das externe Feld-Mapping nicht mehr Schaden anrichtet als es nützt, sind wie bereits erwähnt, die meisten Felder für die Konvertierung bereits Programm intern gemappt, anders ausgedrückt, "hard-codiert". Damit das Mapping, auch in Zusammenhang mit den Default-Werten trotzdem funktioniert, läuft es in folgender Reihenfolge ab: 1. Zuweisung von Default-Werten mittels der Sektionen [Default.] 2. Zuweisung der v7-Werte mittels Programm interner Codierung (hard-coded). 3. Zuweisung der v7-Werte mittels der Sektionen [Mapping.] d.h. allfällige Default-Werte werden immer durch ihre realen Werte der v7 Datenbanken überschrieben (falls vorhanden), hard-codierte Zuweisungen werden immer durch ihre Definitionen in der externen Mapping- Datei überschrieben (falls vorhanden)! Bemerkung: Durch diese Reihenfolge ist sichergestellt, dass eine Konver-tierung auch durchgeführt werden kann, wenn kein externes Mapping definiert wurde. Das einzige was in der Mapping-Datei wirklich vorhanden sein muss, ist das Sprach-Mapping unter [Mapping.Language]. 10. Sonstiges Neben den bis hier aufgezählten Dateien, verfügt der Konverter noch über zwei zusätzliche Dateien, die für den Betrieb zwar notwendig sind, auf die Art und Weise der Konvertierung aber keinen Einfluss haben und deshalb ignoriert werden können. V7ToV8.default - (im Installationsverzeichnis des Konverters) Wird im Zusammenhang mit der INI-Datei verwendet und kann ignoriert werden. USA_V7ToV8.lng - (im Installationsverzeichnis des Konverters) Ist die Sprachdatei des Konverters und liegt, wie bereits erwähnt, zur Zeit nur in English vor. August 2006 Seite 16 / 17
11. Deinstallation des Konverters Der Konverter ist ein "Wegwerf-Artikel". Ist er einmal gebraucht und sind alle v7 Daten-banken konvertiert worde, so wird er nicht mehr gebraucht und kann im Prinzip wieder vom PC entfernt werden (spart Speicherplatz). Um den Konverter zu entfernen muss das Setup-Programm "V7ToV8Setup.exe" erneut aufgestartet werden. Stellen Sie danach den Schalter auf " und bestätigen Sie mit >. Das wars, das Unternehmen "WinCan v7 Projekte nach WinCan v8 konvertieren" ist damit abgeschlossen. August 2006 Seite 17 / 17
Sie können auch lesen
