| ©2003-2008, Heymann Consulting |
|
| Cumulus Importer - Version 7.5.0 | |
| Dokumentation | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Inhalt | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
0.1 Demoversion 3 Konfiguration der Datenübernahme 3.1 Feldzuordnung für den
Import 3.2.1 Aktualisieren
der Cumulus Feldliste 3.3.1 Beispiel
1: Import in ein Auswahllistenfeld 5.1 Einstellungen zur Importdatei 7.1 Feedback & Support |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 0 Einführung | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Der Cumulus Importer ermöglicht Ihnen die automatische Datenübernahme aus einer Textdatei heraus in Ihre Canto Cumulus Kataloge (Hinweis: wenn Sie Daten in Cumulus Kataloge der Version 5 importieren möchten, verwenden Sie bitte unseren Cumulus Importer 3.1.1). Somit wird es möglich, beliebige Informationen aus einem Warenwirtschaftsystem oder aus einem anderen Datenbanksystem heraus zu übernehmen. Die benötigten Daten werden aus Ihrer Datenbank in einem Standardformat (z.B. Feldwerte durch ein Tabulatorzeichen getrennt) exportiert. Sie bestimmen, in welche Cumulus-Felder (Datensatz- oder Kategoriefelder) die Werte eingetragen werden. Die Daten können in Felder beliebigen Typs (Text-, Listen-, Zahlen-, Datumsfelder, ...) oder in die Kategorienliste übernommen werden. Dabei werden Datensatzfelder und Kategoriefelder unterstützt. Die Demoversion ist eine voll funktionsfähige Version des 'Cumulus Importers', so dass Sie die Software intensiv testen können. Die Anzahl der Datensätze, die mit der Demoversion des Importers in den Cumulus Katalog eingetragen werden können, ist auf 5 Datensätze pro Session limitiert. Die Vollversion der Software können Sie bestellen, indem Sie hier klicken. Zum Cumulus Importer gehören auch eine Vielzahl von Beispieldateien. Zum Nachvollziehen der hier in der Readme-Datei erläuterten Beispiele verwenden Sie bitte den Cumulus Katalog 'Moebel.ccf', der sich im Ordner 'Beispieldateien' befindet. Zusätzlich befinden sich zwei Textdateien in diesem Verzeichnis, die Daten für den Import enthalten. Im Unterverzeichnis 'Importschemadateien' finden Sie einige Beispiele für die Zuordnung von Feldern aus der Textdatei zu Feldern im Cumulus Beispielkatalog. Da in einer Importschema-Datei u.a. der Pfad zur Textdatei abgelegt wird, können Sie diese nur verwenden, wenn Sie das Programm (und damit auch die Beispieldateien) im Standard-Verzeichnis (Windows: 'C:\Programme\Cumulus Importer 75' und Mac OS X: 'Macintosh HD/Programme/Cumulus Importer 75') installiert haben oder Sie vorher die Zeile der Importschema-Datei, die den Pfad zur Textdatei enthält, geändert haben. Wir möchten uns bei allen Personen bedanken, die geholfen haben, dieses Produkt zu entwickeln. Vielen Dank an alle aktuellen Cumulus Importer Kunden, die durch Ihre Verbesserungsvorschläge geholfen haben, dieses nützliche Produkt zu entwickeln. Wir freuen uns auf Ihr Feedback, welches uns auch weiterhin helfen wird, dieses Produkt noch weiter zu verbessern.
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 1 Installation | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Wenn Sie die Software aus dem Internet heruntergeladen haben, haben Sie die Datei 'CumulusImporter75.zip' erhalten. Zur Installation der Software entpacken Sie die gelieferte Datei 'CumulusImporter75.zip'. Sie erhalten einen Ordner mit Namen 'Cumulus Importer 75'. Wenn Sie das Produkt auf CD-ROM erhalten haben, enthält diese den Ordner 'Cumulus Importer 75' bereits im entsprechenden Verzeichnis zu Ihrem Betriebsystem ('Windows' oder 'MacOSX'). Installation unter Windows: kopieren Sie den Ordner in das 'Programme'-Verzeichnis Ihrer Systemfestplatte ('C:\Programme'). Installation unter Mac OS X: kopieren Sie den Ordner in das 'Programme'-Verzeichnis Ihrer Systemfestplatte ('Macintosh HD/Programme'). Es ist wichtig, dass sich der Ordner an dem angegebenen Ort befindet, da Sie nur so die mitgelieferten Beispiele ohne weitere Änderung verwenden können. Der Ordner enthält die folgenden Dateien:
In dem kopierten Ordner befindet sich die Cumulus Importer Applikation im Verzeichnis 'CumulusImporter'. Kopieren Sie den Ordner samt Inhalt in den 'ejp'-Ordner des Installations-Ordners Ihrer Cumulus Client Anwendung. Dieser befindet sich nach einer Standard-Installation unter Windows unter 'C:\Programme\Canto\Cumulus 7 Workgroup Client', unter Mac OS X ist dies 'Macintosh HD/Programme/Cumulus 7 Workgroup Client'. Unter Mac OS X öffnen Sie diesen Ordner, indem Sie den Installations-Ordner Ihrer Cumulus Anwendung öffnen und dann die Taste STRG bzw. CTRL drücken und gleichzeitig das Symbol Ihrer Cumulus Anwendung auswählen, um das Kontextmenü für die Anwendung zu erhalten. In diesem Menü wählen Sie 'Paketinhalt zeigen' und öffnen erst 'Contents' und dann 'MacOS'. Dort finden Sie den 'ejp' Ordner. Sobald Sie den Cumulus Client erneut starten, können Sie die Funktionen nutzen, die der Cumulus Importer bietet. Der Cumulus Importer erzeugt innerhalb der Cumulus Applikation sein eigenes Menü mit Namen 'Importer'. Wenn Sie eine Vollversion des Produktes erworben haben, müssen Sie vor der Verwendung die mitgelieferte Seriennummer im Lizenzdialog angeben, indem Sie den Menü-Befehl 'Lizenz...' wählen:
Die Lizenzangaben werden im Konfigurationsverzeichnis des Cumulus Client lokal gespeichert. Wenn Sie den Cumulus Importer auf verschiedenen Rechnern einsetzen möchten, müssen Sie also die Seriennummer auf all diesen Rechnern angeben, bevor Sie die Version voll nutzen können. |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 2 Anwendung | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Wichtig: bevor Sie mit Hilfe des 'Cumulus Importers' Informationen in Ihren Cumulus Katalog übernehmen, müssen Sie unbedingt eine Sicherheitskopie Ihrer Cumulus Katalogdatei anlegen! Der Datenimport ist NUR rückgängig zu machen, wenn Sie eine Sicherheitskopie des Kataloges vorab angelegt haben, die im Notfall wieder eingespielt werden kann!
Um Textinformationen aus einer Textdatei in Cumulus mit Hilfe des Importers einzutragen, gehen Sie wie folgt vor:
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 3 Konfiguration der Datenübernahme | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
3.1 Feldzuordnung für den Import
Nach der Auswahl der Importdatei wird der Pfad zur Importdatei und der Name des Cumulus Kataloges angezeigt.
In dem oben gezeigten Beispiel werden Textinformationen aus einer Datei names 'Moebel.txt' in den Cumulus Katalog 'Möbel' übernommen. Die Textdatei enthält Produktdaten zu einer Vielzahl von Designer-Möbeln (Produktinformationen, Hersteller, Preisinformationen, ...). Wählen Sie also erst einmal die Textdatei aus, die die zu übernehmenden Daten enthält. Benutzen Sie hierzu das Menü 'Importer>Öffnen...' und wählen Sie die Datei 'Moebel.txt', die sich im Verzeichnis 'Beispieldateien' befindet.
Der 'Cumulus Importer' zeigt Ihnen den ersten Datensatz der Textdatei in der linken Spalte der Tabelle an. Dabei werden die Felder untereinander fortlaufend angezeigt. Die Feldwerte sind standardmäßig in der Importdatei durch Tabulator-Zeichen voneinander getrennt. D.h. die erste Zeile der Textdatei lautet wie folgt: Produktgruppe Tabulator Produktname Tabulator Produkttyp Tabulator Designer Tabulator Farbe Tabulator Preis in Euro Tabulator Bestellungen pro Monat Tabulator Erscheinungsdatum Tabulator Dateiname Eine Vielzahl von Datenbanksystemen verwenden dieses Exportformat standardmäßig (u.a. auch Cumulus beim Exportieren der Daten aus dem Cumulus Katalog). Wenn Ihre Textdatei statt des Tabulator-Zeichens ein Semikolon verwendet, können Sie dies in den Einstellungen zum Programm umstellen, so dass Ihre Textdatei korrekt erkannt wird. Oft enthält die erste Zeile der Exportdatei noch keine Daten, sondern die Namen der Felder aus der Datenbank (wie in diesem Beispiel), die Sie nicht in Cumulus übernehmen möchten. Sie können den Importer so einstellen, dass die erste Zeile beim Datenimport ignoriert wird.
Im unteren Teil des Fensters sehen Sie die Anzahl der Datensätze in der Datei. Bei dieser Anzahl handelt es sich um die echte Anzahl der Zeilen in der Textdatei, also wird in unserem Beispiel auch weiterhin die Anzahl 7 angezeigt, auch wenn wir den Cumulus Importer auffordern, die erste Zeile der Datei zu ignorieren.
Diese Beispiel-Datei enthält nur 6 Datensätze, die übernommen werden sollen. Mit Hilfe der beiden Schaltflächen (<< und >>) können Sie sich innerhalb der Daten der Textdatei bewegen, um zu überprüfen, ob Sie die Daten wirklich korrekt zugeordnet haben. Ein Datensatz der Textdatei besteht in unserem Beispiel aus 9 Feldern. Damit der Cumulus Importer die Information in die richtigen Datensätze importieren kann, müssen wir einen Bezug zwischen den Daten der Textdatei und den Cumulus Datensätzen herstellen. Sie müssen hierzu ein Bezugsfeld definieren, über die der Datensatz eindeutig identifiziert werden kann. In unserer Beispieldatei ist der Dateiname enthalten und der Dateiname ist im Cumulus Katalog eindeutig, somit kann dies unser Bezugskriterium sein. Selektieren Sie die 9. Zeile (Dateiname) und ordnen Sie das Cumulus Feld 'Asset-Name' zu, indem Sie die Zeile in der Tabelle selektieren und danach den Button 'Auswählen...' benutzen. (Hinweis: der Dateiname ist in Cumulus im Feld 'Asset-Name' gespeichert, nicht im Datensatznamen!). Danach definieren Sie das Feld als Bezugsfeld, indem Sie im Dialag 'Bezugsfeld?' den 'Ja'-Button klicken. Der Importer wird nun bei jeder Übernahme der Daten nach einem Datensatz suchen, dessen Feld 'Asset-Name' mit dem 9. Feld in der Textdatei übereinstimmt. Wird kein entsprechender Datensatz gefunden, wird gegebenenfalls eine Meldung in der Logdatei eingetragen. Es sollen hier die folgenden Informationen übernommen werden:
Zuerst müssen Sie die Zeile anklicken, zu der ein Cumulus Feld zugeordnet werden soll. Es wird die Schaltfläche 'Auswählen' aktiv und Sie können ein Cumulus-Feld über diesen Button aus der Liste wählen. Bevor Sie ein Feld auswählen können, müssen Sie sich entscheiden, ob Sie Informationen in Datensatzfelder oder in Kategoriefelder übernehmen möchten.
In unserem Beispiel möchten wir Informationen in Felder in den Cumulus Datensätzen eintragen lassen. Wählen Sie also in dem Dialog die Schaltfläche 'Datensatzfelder'. Wenn Sie in Cumulus Kategorien erzeugen lassen möchten, dann ist dies übrigens auch der Eintrag in ein Datensatzfeld, denn das Kategoriefeld ist eines der Datensatzfelder! Hinweis: ab diesem Zeitpunkt können bis zum nächsten Neustart der Applikation nur noch Informationen in die Datensatzfelder übernommen werden. Möchten Sie später weitere Informationen in Kategoriefelder übernehmen, so müssen Sie das Programm beenden und beim nächsten Aufruf 'Kategoriefelder' als Feldtyp wählen.
Wählen Sie ein Feld aus der angezeigten Cumulus Feldliste, in diesem Fall das Feld 'Asset-Name'. Somit wird der 'Cumulus Importer' den Inhalt von Feld 9 in das Cumulus-Feld 'Asset-Name' eintragen. Sie können jederzeit diese Zuordnung aufheben, indem Sie die Zeile in der rechten Liste wählen und die Rückschritt-Taste (Backspace) oder die Entfernen-Taste (Entf) betätigen. Wir möchten aber, dass das Feld nicht zugeordnet wird, sondern dass es einen Bezug zwischen den Daten der Textdatei und dem Cumulus Katalog herstellt. Den Bezug erzeugen Sie, indem Sie 'Feld ist Bezugsfeld zu den Datensätzen' auswählen:
Der Cumulus Importer erzeugt für Bezugsfelder beim Import eine entsprechende Suchbedingung, um die zugehörigen Datensätze im Katalog zu finden. Sie können die Suchbedingung konfigurieren, diese wird dann im Dialog unter 'Erzeugte Suchbedingung' angezeigt. In den meisten Fällen wird sicherlich 'ist' als Bedingung gewählt werden, damit eine eindeutige Zuordnung erfolgt, aber auch 'beginnt' oder 'enthält' könnte unter Umständen eine eindeutige Zuordnung liefern. Der Feldname in der Zeile wird dann mit der Suchbdeingung in eckigen Klammern (Beispiel: Asset-Name [ist]) markiert. Sie können jederzeit diese Zuordnung aufheben, indem Sie die Zeile wählen und die Rückschritt-Taste (Backspace) oder Entfernen-Taste (Entf) betätigen (Feldzuordnung entfernen). Bei der Übernahme wird der 'Cumulus Importer' nach Datensätzen in Cumulus suchen, deren Asset-Name dem Eintrag in der Textdatei entspricht und die Informationen werden dann dem Datensatz bzw. den Datensätzen (siehe Voreinstellungen) zugeordnet. Nun sollen die Kategorien übernommen werden. Selektieren Sie einfach die Zeilen 1-4 gleichzeitig und wählen Sie über die 'Auswählen'-Schaltfläche das Feld 'Kategorien' aus. Die Kategorien sollen nicht alphabetisch auf oberster Ebene in die Kategorienliste aufgenommen werden, sondern sie sollen als Unterkategorien von Oberbegriffen angelegt werden. Wählen Sie die Namen der Oberkategorien, indem Sie in der Spalte 'Zusatzinformation' den Namen der Oberkategorie eingeben:
Zusatzinformationen kann man auch für Textfelder definieren. Dort wird die Zusatzinformation dann dem zu übernehmenden Text vorangestellt. Wie dies funktioniert, erfahren Sie in Beispiel 3: Importer in Datensatzfelder (Notizenfeld). Die Zuordnung der weiteren Felder geschieht analog. Wie Sie dieses Importschema verwenden, erfahren Sie im Beispiel 4: Importer in Datensatzfelder. 3.2 Weitere Informationen zur Konfiguration 3.2.1 Aktualisieren der Cumulus Feldliste Beim ersten Öffnen der Auswahl holt sich der 'Cumulus Importer' die Namen aller Felder des Cumulus Kataloges. Wenn Sie die Feldstruktur des Cumulus Kataloges in der Zwischenzeit geändert haben, müssen Sie die Liste erst aktualisieren, indem Sie das aktuelle Importfenster schließen und ein neues Importfenster öffnen.
3.2.2 Datenübernahme ohne Datenimport in die Datensätze Es können mit Hilfe des 'Cumulus Importers' auch Daten übernommen werden, ohne dass Sie den Datensätzen zugeordnet werden (ohne Definition eines Bezugsfeldes). Dies ist der Fall, wenn Sie einfach Daten in die Kategorienliste oder in eine Auswahlliste importieren möchten. Ein Beispiel zur Datenübernahme ohne Einträge in Datensätze finden Sie im Beispiel 1 und im Beispiel 2. 3.2.2.1 Übernahme in die Kategorienliste Sie können die neuen Kategorienamen wie gewohnt zuordnen. Diese werden dann in der Kategorienliste eingetragen, ohne dass diese den Datensätzen zugeordnet werden. Natürlich ist es auch möglich, Oberkategorien zu vergeben. Ein Beispiel zur Datenübernahme in die Kategorienliste finden Sie im Beispiel 2. 3.2.2.2 Übernahme in eine Textliste Auch der Inhalt einer Textliste kann mit Hilfe des Importers gesetzt werden. Auch hier ist die Zuordnung zu Datensätzen nicht notwendig. Wenn Einträge in die Textliste übernommen werden, werden diese an die vorhandene Liste angehängt. Ist ein Eintrag in der Liste schon vorhanden, so wird dieser Eintrag ignoriert und nicht erneut eingetragen. Ein Beispiel zur Datenübernahme in eine Auswahlliste finden Sie im Beispiel 1. 3.2.3 Datenübernahme in Felder der Kategorienliste Es können mit Hilfe des 'Cumulus Importers' auch Daten in Kategoriefelder übernommen werden. Die Konfiguration der Datenübernahme erfolgt entsprechend den Anweisungen bzgl. der Konfiguration der Übernahme in die Datensatzfelder. 3.2.3.1 Übernahme in Kategoriefelder Damit Sie Informationen aus der Textdatei in die Kategoriefelder des Cumulus Kataloges übernehmen können, müssen Sie sich beim ersten Zuordnen eines Cumulus Feldes im angezeigten Dialog für 'Kategoriefelder' entscheiden.
Bei der Übernahme in die Kategoriefelder muß ein Bezug zwischen dem Feld 'Kategoriename' und einem der zu übernehmenden Felder hergestellt werden.
Die Einstellungen zur Übernahme der Information in die Felder der gefundenen Kategorie erfolgt wie gewohnt. Dabei können auch wieder eine Vielzahl von Feldern gleichzeitig einem Kategoriefeld zugeordnet werden. Wichtig: Kategorienamen müssen zur Verwendung dieser Funktion eindeutig sein, da ansonsten einfach die erste gefundene Kategorie des gesuchten Namens verwendet wird.
Canto Cumulus unterstützt eine lange Liste verschiedener Feldtypen:
Der Cumulus Importer unterstützt all die Feldtypen, die für die Datenübernahme relevant sind. Die aktuelle Version des Importers unterstützt die folgenden Feldtypen nicht: - Datengröße All diese Feldtypen werden intern von Cumulus verwendet und der Import von Metadaten könnte Ihre Cumulus Kataloge unbrauchbar machen. Daher verhindert der Cumulus Importer das Importieren in diese Feldtypen. 3.2.4 Versteckte Debug Funktion Die Cumulus Importer Logdatei zeigt alle Meldungen und Fehler an, die während des Imports der Daten aufgetreten sind. Wenn Sie noch mehr technische Informationen erhalten wollen, was während des Imports mit den Daten geschieht, können Sie das Debug Log aktivieren. Fügen Sie in der Importer Lizenzdatei die Zeile 'debug=true' hinzu, um das Log zu aktivieren. Die Cumulus Importer Lizenzdatei finden Sie unter Windows unter 'C:\Programme\Canto\Cumulus 7 Workgroup Client\conf', unter Mac OS X ist dies 'Macintosh HD/Programme/Cumulus 7 Workgroup Client'. Dort halten Sie die Taste STRG bzw. CTRL gedrückt und klicken gleichzeitig das Symbol Ihrer Cumulus Anwendung an, um das Kontextmenü für die Anwendung zu erhalten. In diesem Menü wählen Sie 'Paketinhalt zeigen' und öffnen 'Contents' und dann 'MacOS'. Dort finden Sie den 'conf' Ordner, der die Lizenzdatei enthält.
Die Cumulus Importer Lizenzdatei können Sie im Verzeichnis 'conf' in Ihrem Cumulus Client Installationsverzeichnis finden ('ImporterLicense.properties'). Es handelt sich um eine Textdatei, die mit jedem Editor geändert werden kann. Die Debug Log Datei wird dann im 'Cumulus Importer 75' Verzeichnis erzeugt und trägt den Namen 'Cumulus Importer Debug Log.txt'. Um die Verwendung des Cumulus Importers zu verdeutlichen, werden mit der Software auch Beispieldateien mitgeliefert. Die Beispieldateien finden Sie im Installationsverzeichnis (standardmäßig 'C:\Programme\Cumulus Importer 75' unter Windows oder 'Macintosh HD/Programme/Cumulus Importer 75' unter Mac OS X). Bitte installieren Sie zur Benutzung der Beispieldateien den mitgelieferten Cumulus Katalog 'Möbel.ccf' und öffnen Sie diesen mit dem Cumulus Client. Die Datei zum Katalog befindet sich im Verzeichnis Beispieldateien. Nach der Installation des Cumulus Importers befindet sich ein Verweis auf das Beispieldateien-Verzeichnis im Programme-Menü. Der Beispielkatalog enthält 4 zusätzliche Felder:
Im Unterverzeichnis 'Importschemadateien' finden Sie einige Beispiele für die Zuordnung von Feldern aus der Textdatei zu Feldern im Cumulus Katalog. Da in einer Importschema-Datei u.a. der Pfad zur Textdatei abgelegt wird, können Sie diese nur verwenden, wenn Sie das Programm (und damit auch die Beispieldateien) im Standard-Verzeichnis 'C:\Programme\Cumulus Importer 75' installiert haben oder Sie vorher die Zeile der Importschema-Datei, die den Pfad zur Textdatei enthält, geändert haben.
3.3.1 Beispiel 1: Import in ein Auswahllistenfeld In diesem Beispiel soll eine Liste von Feldwerten in die Auswahlliste 'Farben' importiert werden. Die Textdatei 'Farben.txt' enthält die Liste der Farben. Die notwendigen Zuordnungen sind in einer Importschema-Datei namens 'Farben Importschema.txt' gespeichert, die sich im Verzeichnis 'Importschemadateien' befindet. In dem Beispielkatalog ist ein Feld mit Namen 'Farben' als Listenfeld bereits definiert. Bitte blenden Sie dies, wie gewohnt, in Ihrem Informationsfenster ein, um die Datenübernahme zu überprüfen. Zum Import der Daten gehen Sie wie folgt vor (oder verwenden die mitgelieferte Importschema-Datei):
Nach der Datenübernahme hat die Auswahlliste 'Farben' folgenden Inhalt:
3.3.2 Beispiel 2: Import in die Kategorienliste In diesem Beispiel sollen Informationen in die Kategorienliste importiert werden. Die Textdatei 'Möbel.txt' enthält u.a. Informationen zu Produktgruppen, -name, -typen, den Namen des Designers und die Farbe des Artikels. Die notwendigen Zuordnungen sind in einer Importschema-Datei namens 'Kategorien Importschema.txt' gespeichert, die sich im Verzeichnis 'Importschemadateien' befindet. Zum Import der Daten gehen Sie wie folgt vor (oder verwenden die mitgelieferte Importschema-Datei):
Nach der Datenübernahme hat die Kategorienliste des Kataloges 'Möbel' folgenden Inhalt:
Es besteht auch die Möglichkeit, komplette Kategoriestrukturen mit Hilfe des Cumulus Importers zu übernehmen. Dazu müssen Sie das Trennzeichen für den Kategorie-Level in den Voreinstellungen definieren.
Wenn Sie nun eine Kategorie übernehmen, die dieses Trennzeichen enthält, wird die Zeichenkette in einzelne Kategorienamen zerlegt und die hierarchische Struktur wird entsprechend erzeugt. So wird aus einem Kategorienamen Sport/Ballsportarten/Basketball die Kategorie-Struktur
Hinweis: dies gilt auch für die zusätzlichen Informationen (Erzeugung einer Oberkategorie oder Oberkategorienstruktur), die bei der Kategorie-Erzeugung definiert werden kann.
3.3.3 Beispiel 3: Import in Datensatzfelder (Notizenfeld) In diesem Beispiel sollen Informationen in das Notizenfeld der Datensätze importiert werden. Die Textdatei 'Möbel.txt' enthält u.a. Informationen zu Produktgruppen, -name, -typen, den Namen des Designers und die Farbe des Artikels. Die notwendigen Zuordnungen sind in einer Importschema-Datei namens 'Notizen Importschema.txt' gespeichert, die sich im Verzeichnis 'Importschemadateien' befindet. Zum Import der Daten gehen Sie wie folgt vor (oder verwenden die mitgelieferte Importschema-Datei):
Nach der Datenübernahme hat das Notizenfeld des Kataloges 'Möbel' für die übernommenen Datensätze folgenden oder ähnlichen Inhalt:
3.3.4 Beispiel 4: Import in Datensatzfelder In diesem Beispiel sollen Informationen in Datensatzfelder importiert werden. Die notwendigen Zuordnungen für dieses Beispiel sind in einer Importschema-Datei namens 'Alle Felder Importschema.txt' gespeichert, die sich im Verzeichnis 'Importschemadateien' befindet. Zum Import der Daten gehen Sie wie folgt vor (oder verwenden die mitgelieferte Importschema-Datei):
Nach der Datenübernahme hat der Katalog 'Möbel' folgenden Inhalt
Es besteht auch die Möglichkeit, komplette Kategoriestrukturen mit Hilfe des Cumulus Importers zu übernehmen. Dazu müssen Sie das Trennzeichen für den Kategorie-Level in den Voreinstellungen definieren.
Wenn Sie nun eine Kategorie übernehmen, die dieses Trennzeichen enthält, wird die Zeichenkette in einzelne Kategorienamen zerlegt und die hierarchische Struktur wird entsprechend erzeugt. So wird aus einem Kategorienamen Sport/Ballsportarten/Basketball die Kategorie-Struktur
Hinweis: dies gilt auch für die zusätzlichen Informationen (Erzeugung einer Oberkategorie oder Oberkategorienstruktur), die bei der Kategorie-Erzeugung definiert werden kann. |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 4 Menübefehle | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Öffnen... Wählen Sie die Textdatei aus, deren Informationen Sie in Ihren Cumulus Katalog importieren möchten. Importschema öffnen... Wählen Sie die Importschema-Datei aus, deren Voreinstellungen Sie für die Datenübernahme verwenden möchten. Neben den Feldzuordnungen werden auch die Programmeinstellungen, der Name und Pfad der Textdatei und der Name des Cumulus Kataloges gespeichert. Importschema speichern... Sie können die Einstellungen der Datenübernahme des Cumulus Importers in einer Importschema-Datei speichern. Neben den Feldzuordnungen werden auch die Programmeinstellungen, der Name und Pfad der Textdatei und der Name des Cumulus Kataloges gespeichert. Einstellungen... Wählen Sie 'Einstellungen...', um in die Voreinstellungen zum Cumulus Importer zu gelangen. Die Voreinstellungen finden Sie unter 'Benutzereinstellungen>Cumulus Importer EJaP'. Lizenz... Wenn Sie eine Vollversion des Produktes erworben haben, geben Sie in diesem Dialog Ihre Seriennummer ein. Info... Im Info-Dialog erhalten Sie Informationen zur aktuellen Version Ihres Cumulus Importers. Desweiteren werden Ihre Registrationsinformationen angezeigt.
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 5 Programmeinstellungen | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
5.1 Einstellungen zur Importdatei
Feld-Trennzeichen Hiermit legen Sie das Zeichen fest, mit welchem Ihre Felder in der Textdatei getrennt sind. Sie haben die Wahl zwischen dem Tabulator-Zeichen ('Tabulator' eingeben, nicht einfach Tab drücken!) und einem beliebigen einzelnen Zeichen. Die meisten Datenbanksysteme exportieren Daten Tabulator-getrennt. Kategorien-Trennzeichen Hiermit legen Sie das Zeichen fest, mit welchem Ihre Kategorien in einem Feld der Textdatei getrennt sind. Sie können hier ein beliebiges Zeichen eingeben (z.B. Komma oder Semikolon). Bitte stellen Sie sicher, dass diese Parameter für die Datei, die Sie importieren möchten, korrekt gesetzt sind, da es ansonsten zu Fehlern bei der Übernahme der Daten kommen kann. Trennzeichen für Kategorie-Level Der Parameter ermöglicht die Übernahme von Kategorien in die Liste incl. deren hierarchischer Struktur. Ein Beispiel: Kategorie-Level Trennzeichen: / Zu übernehmende Kategorie: Sport/Ballsportarten/Basketball Ist '/' als Trennzeichen für die Kategorie-Level definiert, so wird die Kategorie in drei einzelne Kategorien zerlegt. Dabei ist 'Sport' die Oberkategorie und 'Ballsportarten' wird als deren Unterkategorie auf 2. Ebene angelegt. 'Basketball' wird als Unterkategorie zu 'Ballsportarten' erzeugt. Hinweis: Derselbe Mechanismus wird auch bei der Definition der Kategorie-Zusatzinformationen verwendet, d.h. enthält der Name der neuen Oberkategorie auch das Trennzeichen, wird eine entsprechende Struktur angelegt und alle zu erzeugenden neuen Kategorien werden als Unterkategorie dieser Struktur erzeugt. 5.2 Einstellungen zu Canto Cumulus
Textfeld-Information belassen/überschreiben Wenn ein Eintrag in einem Cumulus Textfeld vorgenommen wird, kann der 'Cumulus Importer' den im Feld vorhandenen Text überschreiben oder den neuen Text an den vorhandenen anhängen. Setzen Sie den Schalter auf 'überschreiben', so überschreibt der neue Text den im Feld vorhandenen. Setzen Sie den Schalter auf 'belassen', so wird der neue Text an den vorhandenen angehängt. Import in den ersten gefundenen Datensatz / alle Datensätze Wenn Sie einen Bezug zwischen der Textdatei und dem Cumulus Katalog definiert haben, kann es vorkommen, dass dieser Bezug nicht eindeutig ist, d.h. dass bei einer Suche nach Datensätzen zum Bezugskriterium mehr als ein Datensatz gefunden wird. Sie können steuern, ob nur der erste Datensatz oder alle Datensätze die Information erhalten sollen. Setzen Sie den Schalter auf 'erster Datensatz', so wird die Information nur in den ersten gefundenen Datensatz eingetragen, auch wenn es eventuell mehrere Datensätze gibt, die das Bezugkriterium erfüllen. Setzen Sie den Schalter auf 'alle Datensätze', so wird die Information in alle Datensätze eingetragen, die das Bezugskriterium erfüllen. 5.3 Einstellungen zur Logdatei
Fehler protokollieren Wenn Sie diesen Schalter aktivieren, werden alle Fehlermeldungen in der Protokolldatei eingetragen. Fehlermeldungen sind z.B. Fehler beim Lesen aus der Textdatei oder Fehler beim Schreiben in die Cumulus Datensätze. Dieser Schalter sollte immer angewählt sein! Meldungen protokollieren Wenn Sie diesen Schalter aktivieren, werden alle allgemeinen Meldungen in der Protokolldatei eingetragen. Allgemeine Meldungen enthalten z.B. Informationen über den gerade bearbeiteten Datensatz und können genauere Auskunft im Fehlerfall geben. Sollte es also zu Fehlermeldungen kommen, schalten Sie bitte auch die Meldungen ein, damit Sie herausfinden können, warum die Daten eventuell nicht korrekt übernommen werden können. |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 6 Die Importdatei | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Die benötigten Daten werden aus einer Datenbank, einem Warenwirtschaftsystem oder z. B. aus Microsoft Excel oder Word in einem Standardformat (Feldwerte durch ein Tabulatorzeichen oder Semikolon getrennt) exportiert. Viele Programme bieten unter dem Menübefehl 'Datei sichern...' eine Option, Text durch Tabulator-Zeichen getrennt, abzuspeichern. Andere Programme bieten diese Möglichkeit unter einem Befehl wie 'Export...'. Export aus Microsoft Excel In Microsoft Excel selektieren Sie einfach den Datenbereich, den Sie exportieren möchten und speichern die Daten über den Befehl 'Sichern unter...'. Im Sichern-Dialog wählen Sie dann die Option 'Text (Tabs getrennt)'. Somit sind Ihre Daten bereit für die Übernahme in Cumulus. Export aus Datenbanksystemen, z.B. Microsoft Access, Claris FileMaker, ... In allen gängigen Datenbanken gibt es die Möglichkeit, die gespeicherten Daten zu exportieren. Dabei können Sie immer angeben, in welchem Format die Daten abgelegt werden sollen. In FileMaker z.B. aktivieren Sie das Exportieren über den Menübefehl 'Datensätze exportieren...'. Speichern Sie dann die Daten mit der Typ-Option 'Text mit Tab', damit der Cumulus Importer die Daten übernehmen kann. |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 7 Weitere Informationen | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Ihr Feedback zu unserem Produkt ist sehr Willkommen! Bitte senden Sie Ihre Fragen zum Produkt an die Email-Addresse support@heymann-consulting.de. Wir versuchen Ihre Anfrage umgehend zu beantworten und unsere Produkte nach Ihren Anforderungen immer weiter zu verbessern. Hinweis: wir bieten keine Telefon-Hotline zu dem Produkt an, also senden Sie bitte all Ihre Anfragen an die angegebene Email-Adresse. Wir hoffen, dass Sie unser Produkt nutzen können, um Ihren Workflow zu optimieren. 7.2 Fragen und Antworten - Frequently Asked Questions (FAQs) FAQ 1: Warum dauert das Importieren der Daten bei bestimmten Katalogen so extrem lange? Sie verwenden vermutlich einen Cumulus Katalog, der nicht in Ihrem Netzwerk erstellt wurde bzw. dessen Asset-Referenzen nicht korrekt sind. Das das Importieren dann sehr langsam ist, basiert auf einem Cumulus Bug, den es schon seit Cumulus 2.5(!) gibt (schon in der damaligen AppleScript Implementierung). Cumulus prüft beim Schreiben in den Datensatz die Asset-Referenz (auch wenn dies überhaupt nicht notwendig ist!). Dabei wird dann nach Servern oder IP-Adressen gesucht, die evtl. in Ihrem Netzwerk nicht (mehr) existieren. Wenn dann Ihr Routing entsprechend konfiguriert ist, wird die Suche auch noch im Internet fortgesetzt. Lösung/Workaround: Sie müssen verhindern, dass die Asset-Referenzen von Cumulus aufgelöst (geprüft) werden können, indem Sie die Asset-Stores für MacOS (Mac OS-Dateisystem) und Windows (Windows-Dateisystem) vor dem Importieren abschalten. Dies müssen Sie in dem von Ihnen verwendeten Asset-Handling-Set (das ist wohl meistens 'Allgemein') unter 'Module' tun. Der Unix-Asset-Store scheint von dem Problem nicht betroffen zu sein. Bitte vergessen Sie nicht, die Asset-Stores nach dem Import wieder einzuschalten. FAQ 2: Warum werden die Kategorien beim Import nicht angelegt? Das Importieren von Kategorien und das Zuordnen dieser neuen Kategorien zu den Datensätzen muss in 2 Schritten erfolgen. Importieren Sie zuerst die Kategorien in den Cumulus Katalog (ohne eine Zuordnung zu den Datensätzen). Nachdem die Kategorien im Katalog vorhangen sind, können Sie in einem 2. Import den Datensätzen zugeordnet werden. Ein Beispiel für das Importieren von Kategorien in die Kategorienliste finden Sie im Beispiel 2: Import in die Kategorienliste. Nach dem Anlegen der Kategorien können diese dann den Datensätzen zugeordnet werden, wie in Beispiel 4: Import in Datensatzfelder. |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 8 Version History | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Version 7.5 - Januar 2008 Offizielles Release des Cumulus Importers für Canto Cumulus 7.5. Neben einer Vielzahl kleiner Modifikationen wurden die folgenden Änderungen wurden implementiert: - für Canto Cumulus 7.5 optimiert Version 6.6 - November 2005 Offizielles Release des Cumulus Importers für Canto Cumulus 6.6. Die neue Version enthält einen neuen Lizenzierungsmechanismus und Verbesserungen in der Protokollierung. Die folgenden Änderungen wurden implementiert: - die Version unterstützt nun die Java Classes von Canto Cumulus
6.6 Workgroup/Enterprise Edition, Single User und MediaDex Version 6.0.4 - August 2005 Die Version 6.0.4 wurde für die Verwendung mit Cumulus 6.6 angepasst. Durch einen Fehler in den Canto Java Classes kann die Version 6.0.3 des Cumulus Importers leider nicht mit Cumulus 6.6 verwendet werden. Desweiteren wurde für den Importer unter Windows ein Windows-spezifischer Zeilenumbruch in der Logdatei implementiert und die Zusatzinformation wird nun vor dem Import nicht mehr getrimmt (führende und nachfolgende Leerzeichen werden nicht mehr entfernt). Version 6.0.3 Die Version 6.0.3 liefert in der Logdatei Informationen über alle Suchkriterien, zu denen keine Datensätze gefunden wurden. Zusätzlich wird die Zeilennummer protokolliert, wenn aus der Zeile der Importdatei keine gültige Suchbedingung konstruiert werden kann. Desweiteren wurde ein Problem mit unsauberen Importdateien behoben. Wenn die Anzahl der Spalten innerhalb der Importdatei variierten, stoppte die Applikation beim Zugriff auf Zeilen mit mehr als den in der Zuordnung definierten Spalten. Beim Import wird nun die Zeichenkombination CR LF durch das entsprechende Unicode-Äquivalent ersetzt. Version 6.0.2 Die Version 6.0.2 behebt einen Bug beim Import von Kategorienebenen in die Kategorienliste. Desweiteren ist nun auch der Import in 'Nur Datum' Felder möglich. Version 6.0.1 Die Version 6.0.1 erweitert die Zuordnung von Kategorien zu Datensätzen. Nun können Sie nicht nur einzelne Kategorien den Datensätzen zuordnen, sondern ganze Kategorienhierarchien. Dabei wird immer die unterste Kategorie der Kategorienhierarchie zugeordnet. Die Kategorienamen in der zu übernehmenden Kategorienhierarchie müssen durch das in den Voreinstellungen spezifizierte Kategorie-Level-Trennzeichen getrennt sein. Dem Produkt wurde von Canto ein neuer Produktnummernkreis zugeordnet. Die neuen Produkt-IDs beginnen nun mit 11202-... . Sollten Sie zu Ihrem Produkt noch eine ältere Produkt-ID (11200-...) bekommen haben, so können Sie diese kostenlos austauschen lassen. Version 6.0 Die Version 6.0 ist die erste Version des Cumulus Importers für Canto Cumulus 6.0 und höher und basiert auf der von Canto mit Release 6 eingeführten EJaP-Technologie (Embedded Java PlugIn). Die ersten Versionen des Importers (1.0, 2.0 und 2.5) waren nur für MacOS verfügbar (Technologie: AppleScript) und die Version 3.x war und ist auch für Windows verfügbar. Diese Versionen unterstützen den Import in Cumulus Kataloge der Version 5. |
| Cumulus Importer | |
| ©2003-2008, Heymann Consulting |
|
