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

August 2006 Seite 3 / 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 <Next >>.

August 2006 Seite 4 / 17

Die Copyright-Informationen müssen mit <I accept ...> und <Next >> bestätigt werden.

August 2006 Seite 5 / 17

Geben Sie hier den Benutzer- und Firmennamen ein und bestätigen Sie erneut mit <Next >>.

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 (..\<WinCanInstallDir>\Utils\V7ToV8-Converter) und kann nicht verändert werden! Es wird empfohlen, auch im „Standalone“-Betrieb, das empfohlene Zielverzeichnis (..\<ProgrammDir>\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 <Next >>. Im drauffolgenden Fenster kann die Installation des Konverters mit <Install> gestartet werden. Falls eine Eingabe wiederholt werden muss, so kann mittels der Taste << Back> 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 6 / 17

Der Installationsvorgang läuft weitestgehend selbständig ab. Nach der Installation kann der Konverter ohne weitere Vorbereitungen verwendet werden.

August 2006 Seite 7 / 17

4. Betrieb des Konverters Der Converter wird über das Windows-Startmenü „<Programme >> 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.

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.

Info- oder Titelzeile

August 2006 Seite 8 / 17

Als 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 „<Ausgewähltes Ziel-Verzeichnis\05_12_2003>“ 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 „<Ausgewähltes Ziel-Verzeichnis\05_12_2003\DB>" abgelegt, die Bilder unter „<Ausgewähltes Ziel-Verzeichnis\05_12_2003\Picture>“, die Videos unter „<Ausgewähltes Ziel-Verzeichnis\05_12_2003\Video>“ u.s.w.

August 2006 Seite 9 / 17

Nachem Quell-Datenbank und Ziel-Verzeichnis ausgewählt sind, kann mit <Start> 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.

Info- oder Titelzeile

August 2006 Seite 10 / 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): ;The WinCan V7.x to V8.0 Converter (User - INI - File) [Application] Title=V7ToV8-Converter Product=WinCan 8.0 Converter-Tools Version=V1.X.X LicenseTo=CD-LAB, CH-3280 Murten, Switzerland Company=CD-LAB, CH-3280 Murten, Switzerland Copyright=(c)Copyright 2003 by CD-LAB, CH-3280 Murten Platform=Windows Warning=! Language=USA [Fonts] [Environment] SQLServer=MSACCESS DefaultTemplateS=Start.wtp DefaultCatNameS= DefaultTemplateMH=Start.wtp DefaultCatNameMH= DefaultPACPTemplateS=pacp.wtp DefaultPACPCatNameS=obs_pacp.mdb DefaultPACPTemplateMH=start.wtp DefaultPACPCatNameMH=mh.mdb DefaultPACPLookup=nassco_export.ori GenerateSection=2 … … DebugMode=ALL

Alle mit ";" beginnenden Anweisungen sind reine Kommentare und haben keinen Einfluss auf die Konvertierung.

Alle unter [Application] aufgeführten Anweisungen (Ausnahme: Language) dienen nur der Identifi-zierung des Programmes und haben keinen Einfluss auf die Konvertierung.

Unter [Environment] werden die für die Konver-tierung relevanten Einstel-lungen vorgenommen.

Die Sektion [Fonts] wird nicht benutzt und hat keinen Einfluss auf die Konvertierung.

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 11 / 17

Tabellarische Auflistung der Schlüsselwerte:

Schlüssel Bedeutung Wert 1 Wert 2 Default SQLServer1 Bestimmt das

Format der Ziel-Datenbank

MSACCESS MSSQL Ohne Angaben ist MSACCESS

DefaultTemplateS2 Das Template für Haltungen

Existierendes Template

Start.wtp

DefaultCatNameS3 Der Haltungskatalog Existierender Katalog

Leer, siehe Text

DefaultTemplateMH --unbenuzt DefaultCatNameMH4 Der Schachtkatalog Existierender

Katalog Mh.mdb

..PACPTemplateS5 Das Template für Haltungen, wenn ein PACP Projekt

Existierendes PACP-Template

Pacp.wtp

..PACPCatNameS Der Haltungskatalog, wenn ein PACP Projekt

Existierender PACP-Katalog

Obs_pacp.mdb

..PACPTemplateMH --unbenutzt

..PACPCatNameMH Der Schachtkatalog, wenn ein PACP Projekt

Existierender PACP-Katalog

Mh.mdb

..PACPLookup6 Der Nachschlage-Katalog für PACP Projekte

Nassco_export.ori Nassco_export.ori

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 12 / 17

6. 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:<file> - Angabe der Quell-Datenbank /destin:<dir> - 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 13 / 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: "..\<ProgrammDir>\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 14 / 17

V7ToV8_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 15 / 17

Nachfolgend ein Auszug aus der INI-Datei des Konverters und die Bedeutung der relevanten Parameter: ; The WinCan V7.x to V8.0 Mapping/Definition file ; ; Format: TargetField=SourceField,TargetFieldType,Translation ; ; TargetFieldType: Int, Bool, Float, Text, Date, Time ; ; Translation: OldValue1>NewValue1/OldValue2>NewValue2/..../OldValueN>NewValueN ; [Mapping.Language] ENGLISH_US=USA PACP=USA ENGLISH_UK=UK FRENCH=FRANCE GERMAN=GERMANY SWISS_GERMAN=SUISSE_GE SWISS_FRENCH=SUISSE_FR SWISS_ITALIEN=SUISSE_IT [Default.P_T] [Mapping.P_T] [Default.C_T] [Mapping.C_T] [Default.S_T] [Mapping.S_T] ;S_SectionName=S_T.S_SectionName,Text ;S_SectionNumber=S_T.S_Counter,Text [Default.SI_T] [Mapping.SI_T] [Default.SO_T] [Mapping.SO_T] ;SO_Rate=O_T.O_Level,Int,R>91/S>92 [Default.N_T] [Mapping.N_T] [Default.NI_T] [Mapping.NI_T] [Default.NO_T] [Mapping.NO_T] [Default.NE_T] [Mapping.NE_T] [Default.NC_T] [Mapping.NC_T]

Alle mit ";" beginnenden Anweisungen sind reine Kommentare und haben keinen Einfluss auf das Feld-Mapping

Die [Mapping.Language] Sektion bestimmt das Sprachmapping von v7 auf v8. Dies ist notwendig, da man hier teilweise unter-schiedliche Bezeichnungen verwendet hat. Format: V7_SPRACHE=V8_SPRACHE

Über die [Default.<Tabelle>]Sektion können den Feldern sog. Default-Werte zuge-ordnet werden. Da sind Werte, die dann jeder neue Datensatz in der Ziel-Tabelle erhält. Format: V8_FIELD_NAME=VALUE

Über die [Mapping.<Tabelle>] Sektion wird das eigentliche Mapping der Felder vorge-nommen (im Beispiel aus-kommentiert). Format: V8_FIELD_NAME=V7_TABLE.FIELD_NAME,TYPE. Mit Hilfe der Typenangabe wird eine explizite Typen-konvertierung vorge-nommen.

Ein Spezialfall stellt das Rating der Befahrungen dar. Hier wird neben dem Feld-Mapping zusätzlich noch ein Wert-Mapping vorgenom-men. In v7 Projekten wurde das Rating für Reparaturen (R) und Steckenschäden (S) mittels den 2 Buchstaben vorgenommen. In v8 muss das auf die entsprechenden Zahlenwerte gemappt werden. Format: V7_WERT1>V8_WERT1, V7_WERT2>V8_WERT2 usw.

August 2006 Seite 16 / 17

Damit 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.<Tabelle>] 2. Zuweisung der v7-Werte mittels Programm interner Codierung (hard-coded). 3. Zuweisung der v7-Werte mittels der Sektionen [Mapping.<Tabelle>] 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 17 / 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 " <Remove ...> und bestätigen Sie mit <Next >>. Das wars, das Unternehmen "WinCan v7 Projekte nach WinCan v8 konvertieren" ist damit abgeschlossen.