Cumulus Importer

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.

0.1 Demoversion

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 10 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 Dokumentation 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\Canto\Cumulus Importer 8' und Mac OS X: 'Macintosh HD/Programme/Cumulus Importer 8') installiert haben oder Sie vorher die Zeile der Importschema-Datei, die den Pfad zur Textdatei enthält, geändert haben.

Die Demoversion des Cumulus Importers ist auf 10 Datensätze limitiert.

0.2 Danksagung

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 'CumulusImporter8.zip' erhalten. Zur Installation der Software entpacken Sie die gelieferte Datei 'CumulusImporter8.zip'. Sie erhalten einen Ordner mit Namen 'Cumulus Importer 8'. Wenn Sie das Produkt auf CD-ROM erhalten haben, enthält diese den Ordner 'Cumulus Importer 8' bereits im entsprechenden Verzeichnis zu Ihrem Betriebsystem ('Windows' oder 'MacOSX').

Installation unter Windows: kopieren Sie den gesamten Ordner samt Inhalt in das 'Canto'-Verzeichnis Ihrer Systemfestplatte ('C:\Programme\Canto').

Wenn Sie ein 64bit Windows Betriebsystem verwenden kopieren Sie den Ordner entsprechend in das 'Canto'-Verzeichnis Ihrer Systemfestplatte unter ('C:\Programme (x86)\Canto').

Installation unter Mac OS X: kopieren Sie den gesamten Ordner samt Inhalt 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:

Der Installationsordner des Cumulus Importer

CumulusImporter - Erweiterung für den Canto Cumulus Client zum Import der Daten
Der Ordner 'Dokumentation' enthält Informationen zur Verwendung des Programms im HTML-Format
Der Ordner 'Beispieldateien' enthält einen Cumulus Beispielkatalog, Textdateien und Importschema-Dateien, auf die in dieser Dokumentation Bezug genommen wird
Die README-Datei enthält weitere Informationen zur gelieferten Version des Cumulus Importers
Lizenz.txt enthält die Lizenzbedingungen zum Produkt

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 Client', unter Mac OS X ist dies 'Macintosh HD/Programme/Cumulus 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!

Der Cumulus Beispielkatalog vor der Datenübernahme

Um Textinformationen aus einer Textdatei in Cumulus mit Hilfe des Importers einzutragen, gehen Sie wie folgt vor:

Öffnen Sie den Cumulus Katalog, in den Sie die Informationen eintragen lassen möchten.
Öffnen Sie die Textdatei, die die Informationen enthält, die Sie in Cumulus importieren möchten, über den Menübefehl 'Importer>Öffnen...'.
Sie müssen festlegen, welche Informationen zu übernehmen sind und in welche Datensatz- oder Kategoriefelder die Informationen eingetragen werden sollen.

Es gibt drei verschiedene Arten, Informationen mit Hilfe des 'Cumulus Importers' zu übernehmen:

- Import in die Kategorienliste oder in eine Text-/Stringliste (Auswahlliste)
- Import in die Felder der Datensätze
- Import in die Felder der Kategorien

Das Importieren von Daten in eine Auswahlliste ist die einfachste Art des Imports. Dazu müssen Sie nur die Textinformation aus der Textdatei dem entsprechenden Listenfeld zuordnen und den Import starten.

Möchten Sie die gewählten Informationen in die Datensatzfelder des Cumulus Kataloges eintragen lassen, so müssen Sie einen Bezug zwischen den Daten in der Textdatei und dem Katalog herstellen. Sie definieren in diesem Fall ein bzw. mehrere Bezugsfelder und der 'Cumulus Importer' wird die Informationen nur dann übernehmen, wenn die Einträge in der Textdatei für dieses Feld mit dem aktuellen Feldwert in Cumulus übereinstimmen. Es wird also der Feldwert aus dem Bezugsfeld geholt und eine Suche in Cumulus gestartet, die alle Datensätze findet, die diesen Feldwert enthalten. Die Informationen werden dann, je nach Einstellung, in den ersten Datensatz oder in alle Datensätze des Suchergebnisses eingetragen.

Beispiel:

In Ihrer Textdatei ist der Dateiname als Information enthalten. Über den 'Cumulus Importer' stellen Sie den Bezug zwischen diesem Feld und dem Cumulus Feld 'Asset-Name' her. Beim Import der Daten sucht das Programm alle Datensätze, in denen der 'Asset-Name' dem gefundenen Dateinamen entspricht. Danach werden dann die Informationen, je nach Einstellung, in den ersten gefundenen Datensatz oder in alle gefundenen Datensätze des Suchergebnisses eingetragen.

Möchten Sie die gewählten Informationen in die Kategoriefelder des Cumulus Kataloges eintragen lassen, so müssen Sie einen Bezug zwischen einem Feld aus der Textdatei und z.B. dem Kategorienamen herstellen. Sie definieren in diesem Fall nur ein eindeutiges Bezugsfeld und der 'Cumulus Importer' wird die Informationen nur dann übernehmen, wenn der Name in der Textdatei mit einem Kategorienamen in Cumulus übereinstimmt. Es wird also der Feldwert aus dem Bezugsfeld geholt und in Cumulus nach einer zugehörigen Kategorie gesucht. Die Informationen werden dann in die Kategoriefelder der ersten gefundenen Kategorie eingetragen.

Beispiel:

In Ihrer Textdatei ist der Kategoriename als Information enthalten. Über den 'Cumulus Importer' stellen Sie den Bezug zwischen diesem Feld und dem Kategorienamen her. Beim Import der Daten sucht das Programm die zugehörige Kategorie (das erste Vorkommen einer Kategorie mit diesem Namen). Danach werden dann die Informationen in die Felder der Kategorie eingetragen.
Definition von Zusatzinformationen

Wenn Sie Informationen in ein Textfeld (z.B. das Notizenfeld) oder in die Kategorienliste übernehmen, können Sie zu dem übernommenen Text noch Zusatzinformationen mit übergeben.

Beispiel 1 - Oberkategorien:

Es soll eine Liste von Produktnamen in die Kategorienliste übernommen werden. Wenn Sie die Kategorien übernehmen, werden diese neu angelegt und alphabetisch eingeordnet. Dies ist oft nicht gewünscht. Es soll in diesem Fall meist eine neue Kategorie angelegt werden (z.B. mit Name 'Produktnamen'), die dann als Oberkategorie für die neu zu erzeugenden Kategorien dient, d.h. alle neuen Kategorien werden als Unterkategorie von 'Produktnamen' angelegt.

Beispiel 2 - Zusatztext:

Es soll zusätzlicher Text in das 'Notizen'-Feld übernommen werden. In der Textdatei befindet sich z.B. die Preisinformation. Beim Import des Textes in den Datensatz stellt der 'Cumulus Importer' die Zusatzinformation dem übernommenen Text voran, so dass das 'Notizen'-Feld z.B. so aussehen könnte:

Preis in Euro: 4711

Der Zusatztext hilft Ihnen, Textinformation für den Anwender übersichtlich in ein Textfeld einzutragen.
Starten Sie die Übernahme der Textdaten über die Schaltfläche 'Daten importieren...'.

Ein Fortschrittbalken gibt Auskunft über den aktuellen Stand der Übernahme. Es wird, wenn dies in den Einstellungen gewählt wurde, eine Logdatei erzeugt, die allgemeine Meldungen und Fehlermeldungen (je nach Einstellung) enthält.
Die Einstellungen für die Datenübernahme aus einer Textdatei in einen Katalog können in einer Importschema-Datei abgespeichert werden. Neben den Feldzuordnungen werden auch die Voreinstellungen und der Name der Textdatei und des Cumulus Kataloges gespeichert. Sollten Sie also häufiger Daten gleicher Struktur in einen Katalog übernehmen müssen, so speichern Sie Ihre Einstellungen in einer Importschema-Datei ab. Diese können Sie dann bei Bedarf laden und müssen nicht alle Einstellungen und Zuordnungen erneut vornehmen.

3 Konfiguration der Datenübernahme

3.1 Feldzuordnung für den Import

Eine Beispielkonfiguration für die Datenübernahme mit dem Cumulus Importer: es werden Informationen in Datensätze eingetragen und neue Kategorien erzeugt, die diesen Datensätzen zugeordnet werden

Nach der Auswahl der Importdatei wird der Pfad zur Importdatei und der Name des Cumulus Kataloges angezeigt.

Import-Einstellungen für Daten aus der Beispieldatei 'Moebel.txt'

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.

Die Anzeige eines Datensatzes aus der Textdatei in der Liste der Feldwerte

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.

Sie können über einen Schalter die Übernahme des ersten Datensatzes aktivieren bzw. unterdrücken

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.

Es wird hier der fünfte von insgesamt 7 Datensätzen angezeigt

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:

Feld 1-4 (Produktgruppe, Produktname, Produkttyp und Designer ) sollen in die Kategorienliste eingetragen werden. Dabei soll zu jeder erzeugten Kategorie auch eine Oberkategorie erzeugt werden, so dass z.B. alle Produktgruppen-Kategorien dann unter einer Oberkategorie 'Produktgruppe' erscheinen.
Feld 5 (Farben) soll in das Datensatzfeld 'Farben' eingetragen werden. Bei diesem Feld handelt es sich im Cumulus Beispielkatalog 'Möbel' um ein Listenfeld. Neu erzeugte Listeneinträge werden vom Cumulus Importer automatisch alphabetisch sortiert.
Feld 6 (Preis in Euro) soll in das Datensatzfeld 'Preis in Euro' eingetragen werden. Bei diesem Feld handelt es sich im Cumulus Beispielkatalog 'Möbel' um ein Dezimalzahl-Feld. Der Text wird vom Cumulus Importer automatisch in eine Zahl umgewandelt.
Feld 7 (Bestellungen pro Monat) soll in das Datensatzfeld 'Bestellungen pro Monat' eingetragen werden. Bei diesem Feld handelt es sich im Cumulus Beispielkatalog 'Möbel' um ein Ganzzahl-Feld. Der Text wird vom Cumulus Importer automatisch in eine Zahl umgewandelt.
Feld 8 (Erscheinungsdatum) soll in das Datensatzfeld 'Erscheinungsdatum' eingetragen werden. Bei diesem Feld handelt es sich im Cumulus Beispielkatalog 'Möbel' um ein Datumsfeld. Der Text wird vom Cumulus Importer automatisch in ein Datum umgewandelt.

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.

Auswahl des Cumulus Feldtyps: Datensatz- oder Kategoriefeld

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 Datensatzfeld aus der Liste der Cumulus Felder

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:

Die Zusatzinformation zu einer Kategorie wird als Oberkategorie angelegt

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.

Sie aktualisieren Ihre Cumulus Feldliste, indem Sie 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.

Auswahl des Cumulus Feldtyps: Datensatz- oder Kategoriefelder

Bei der Übernahme in die Kategoriefelder muß ein Bezug zwischen dem Feld 'Kategoriename' und einem der zu übernehmenden Felder hergestellt werden.

Das Feld Kategoriename stellt den Bezug zur Kategorie her

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.

Wählen Sie das Kategoriefeld, in welches importiert werden soll

3.2.3 Cumulus Feldtypen

Canto Cumulus unterstützt eine lange Liste verschiedener Feldtypen:

Cumulus Liste der unterstützten 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
- Länge
- Bild
- Auflösung
- Asset-Referenz
- Audio
- Binär

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 Client\conf', unter Mac OS X ist dies 'Macintosh HD/Programme/Cumulus 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

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 8' Verzeichnis erzeugt und trägt den Namen 'Cumulus Importer Debug Log.txt'.

3.3 Datenimport - Beispiele

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\Canto\Cumulus Importer 8' unter Windows oder 'Macintosh HD/Programme/Cumulus Importer 8' 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:

Farben - das Feld ist vom Typ 'Liste'
Preis in Euro - das Feld ist vom Typ 'Dezimalzahl'
Bestellungen pro Monat - das Feld ist vom Typ 'Ganzzahl'
Erscheinungsdatum - das Feld ist vom Typ 'Datum'

Der Beispielkatalog enthält vor der Datenübernahme noch keine Kategorien und auch die zusätzlich angelegten Felder sind noch nicht gefüllt

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\Canto\Cumulus Importer 8' 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):

Öffnen Sie den Cumulus Beispiel-Katalog 'Möbel'.
Öffnen Sie die Textdatei 'Farben.txt', die die Informationen enthält, die Sie in das Listenfeld importieren möchten, über den Menübefehl 'Importer>Öffnen...'.
Auf der linken Seite erscheint 'rot' als erste Zeile der Textdatei. Klicken Sie auf 'rot' und den Button 'Auswählen...', um dem Text ein Feld in Cumulus zuzuordnen. Sie müssen sich entscheiden, ob Sie in Cumulus Datensatzfelder oder Kategoriefelder importieren möchten. Bei dem Feld 'Farben' handelt es sich um ein Datensatzfeld, also wählen Sie dieses aus.
In der erscheinenden Liste wählen Sie das Feld 'Farben' aus. Somit ist der Text dem Feld 'Farben' zugeordnet.
Wählen Sie im nachfolgenden Dialog 'Nein', da es sich nicht um ein Bezugsfeld handelt.
Sie können sich den zu übernehmenden Text genauer ansehen, indem Sie die einzelnen Textzeilen mit Hilfe der Button >> und << durchblättern.
Starten Sie die Datenübernahme mit Hilfe des Buttons 'Daten importieren...'.
Wenn Sie in den Programmeinstellungen den Schalter 'Fehler protokollieren' oder 'Meldungen protokollieren' aktiviert haben, werden Sie nach dem Speicherort für die Logdatei gefragt.
Ein Fortschrittsbalken zeigt den Fortschritt beim Importieren der Datensätze an.
Nach dem Importieren wird die Anzahl der Fehler und Meldungen angezeigt. Überprüfen Sie diese durch Öffnen der Logdatei.

Nach der Datenübernahme hat die Auswahlliste 'Farben' folgenden Inhalt:

Bei der Übernahme von Listeneinträgen werden diese alphabetisch sortiert

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):

Öffnen Sie den Cumulus Beispiel-Katalog 'Möbel'.
Öffnen Sie die Textdatei 'Möbel.txt', die die Informationen enthält, die Sie in die Kategorienliste importieren möchten, über den Menübefehl 'Importer>Öffnen...'.
In der linken Spalte erscheint die Liste der Felder der ersten Zeile der Textdatei. Selektieren Sie die ersten 5 Zeilen gleichzeitig (Produktgruppe, Produktname, Produkttyp, Designer, Farbe), um den Texten ein Feld in Cumulus zuzuordnen. Alle Felder sollen in die Kategorienliste übernommen werden. Sie müssen sich entscheiden, ob Sie in Cumulus Datensatzfelder oder Kategoriefelder importieren möchten. Bei der Kategorienliste handelt es sich um ein Datensatzfeld mit Namen 'Kategorien', also wählen Sie dieses aus.
In der erscheinenden Liste wählen Sie das Feld 'Kategorien' aus. Somit ist der Text dem Feld 'Kategorien' zugeordnet.
Wählen Sie im nachfolgenden Dialog 'Nein', da es sich nicht um ein Bezugsfeld handelt.
Sie können sich den zu übernehmenden Text genauer ansehen, indem Sie die einzelnen Textzeilen mit Hilfe der Button >> und << durchblättern.
Aktivieren Sie den Schalter 'Ersten Datensatz bei der Datenübernahme ignorieren', da in der Textdatei die erste Zeile nur die Feldnamen, aber keine Daten enthält.
Zu den Kategorien soll jeweils eine Oberkategorie erzeugt werden, damit die Kategorien sortiert im Kategoriebaum erscheinen. Klicken Sie die erste Zeile an geben Sie in der Spalte 'Zusatzinformation' den Namen der Oberkategorie 'Produktgruppe' ein.
Wiederholen Sie den Schritt 7 für die Zeilen 2-5 und ordnen Sie die Oberkategorien Produktname, Produkttyp, Designer und Farbe zu.
Starten Sie die Datenübernahme mit Hilfe des Buttons 'Daten importieren...'.
Wenn Sie in den Programmeinstellungen den Schalter 'Fehler protokollieren' oder 'Meldungen protokollieren' aktiviert haben, werden Sie nach dem Speicherort für die Logdatei gefragt.
Ein Fortschrittsbalken zeigt den Fortschritt beim Importieren der Datensätze an.
Nach dem Importieren wird die Anzahl der Fehler und Meldungen angezeigt. Überprüfen Sie diese durch Öffnen der Logdatei.

Nach der Datenübernahme hat die Kategorienliste des Kataloges 'Möbel' folgenden Inhalt:

Die Kategorien wurden als Unterkategorien erzeugt

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

Da unter 'Zusatzinformation' kein Wert angegeben wurde, wird diese Kategorienhierarchie unter der Master-Kategorie 'Alle' ($All) angelegt.

Wenn Sie die Kategorien in der Kategorien-Ebene 'Kategorien' erzeugen möchten, müssen Sie folgende Einstellungen verwenden:

Diese Einstellung erzeugt die folgende Kategorie-Struktur:

Da unter 'Zusatzinformation' der Wert '$Categories' angegeben wurde, wird diese Kategorienhierarchie unter der Master-Kategorie 'Kategorien' ($Categories) angelegt.

Auch bei der Anwendung der Zusatzinformationen können Sie Hierarchien verwenden:

Diese Einstellung erzeugt die folgende Kategorie-Struktur im $Categories-Kategorienbaum:

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):

Öffnen Sie den Cumulus Beispiel-Katalog 'Möbel'.
Öffnen Sie die Textdatei 'Möbel.txt', die die Informationen enthält, die Sie in das Notizenfeld der Datensätze importieren möchten, über den Menübefehl 'Importer>Öffnen...'.
In der linken Spalte erscheint die Liste der Felder der ersten Zeile der Textdatei. Selektieren Sie die ersten 8 Zeilen gleichzeitig (Produktgruppe, Produktname, Produkttyp, Designer, Farbe, Preis in Euro, Bestellungen pro Monat, Erscheinungsdatum), um den Texten ein Feld in Cumulus zuzuordnen. Alle Felder sollen in die Notizenfelder der Datensätze übernommen werden. Sie müssen sich entscheiden, ob Sie in Cumulus Datensatzfelder oder Kategoriefelder importieren möchten. Beim Notizenfeld handelt es sich um ein Datensatzfeld mit Namen 'Notizen', also wählen Sie dieses aus.
In der erscheinenden Liste wählen Sie das Feld 'Notizen' aus. Somit ist der Text dem Feld 'Notizen' zugeordnet.
Wählen Sie im nachfolgenden Dialog 'Nein', da es sich nicht um ein Bezugsfeld handelt.
Sie können sich den zu übernehmenden Text genauer ansehen, indem Sie die einzelnen Textzeilen mit Hilfe der Button >> und << durchblättern.
Aktivieren Sie den Schalter 'Ersten Datensatz bei der Datenübernahme ignorieren', da in der Textdatei die erste Zeile nur die Feldnamen, aber keine Daten enthält.
Zu den Daten soll jeweils ein Zusatztext erzeugt werden, damit die übernommenen Daten im Notizenfeld besser lesbar sind. Klicken Sie die erste Zeile an und geben Sie in der Spalte 'Zusatzinformation' den Namen des Zusatztextes (z.B. 'Produktgruppe: ' ) ein.
Wiederholen Sie den Schritt 7 für die Zeilen 2-8 und ordnen Sie die Oberkategorien Produktname, Produkttyp, Designer, Farbe, Preis in Euro, Bestellungen pro Monat und Erscheinungsdatum zu.
WICHTIG: Die Datenübernahme kann nur dann funktionieren, wenn der 'Importer' weiß, in welche Datensätze der Text eingetragen werden soll. Sie müssen also einen Bezug zwischen den Daten in der Textdatei und den Cumulus Datensätze herstellen. Sie müssen hierzu ein Bezugsfeld definieren, über die der Datensatz eindeutig identifiziert werden kann. In unserem 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. (Hinweis: der Dateiname ist in Cumulus im Feld 'Asset-Name' gespeichert, nicht im Datensatznamen!).
Wählen Sie im nachfolgenden Dialog 'Ja', da es sich hier um das Bezugsfeld für diesen Import handelt.
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.
Starten Sie die Datenübernahme mit Hilfe des Buttons 'Daten importieren...'.
Wenn Sie in den Programmeinstellungen den Schalter 'Fehler protokollieren' oder 'Meldungen protokollieren' aktiviert haben, werden Sie nach dem Speicherort für die Logdatei gefragt.
Ein Fortschrittsbalken zeigt den Fortschritt beim Importieren der Datensätze an.
Nach dem Importieren wird die Anzahl der Fehler und Meldungen angezeigt. Überprüfen Sie diese durch Öffnen der Logdatei.

Nach der Datenübernahme hat das Notizenfeld des Kataloges 'Möbel' für die übernommenen Datensätze folgenden oder ähnlichen Inhalt:

Die Zusatzinformation wird vor dem Feldwert im Notizenfeld eingetragen

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):

Öffnen Sie den Cumulus Beispiel-Katalog 'Möbel'.
Öffnen Sie die Textdatei 'Möbel.txt', die die Informationen enthält, die Sie importieren möchten, über den Menübefehl 'Importer>Öffnen...'.
In der linken Spalte erscheint die Liste der Felder der ersten Zeile der Textdatei. Selektieren Sie die ersten 4 Zeilen gleichzeitig (Produktgruppe, Produktname, Produkttyp, Designer), um die Texte in die Kategorienliste zu übernehmen. Sie müssen sich entscheiden, ob Sie in Cumulus Datensatzfelder oder Kategoriefelder importieren möchten. Wir möchten in diesem Beispiel in Cumulus Datensatzfelder importieren, denn auch das Kategoriefeld selbst ist ein Cumulus Datensatzfeld. Wählen Sie das Feld 'Kategorien'.
Wählen Sie im nachfolgenden Dialog 'Nein', da es sich nicht um ein Bezugsfeld handelt.
Sie können sich den zu übernehmenden Text genauer ansehen, indem Sie die einzelnen Textzeilen mit Hilfe der Button >> und << durchblättern.
Zu den Kategorien soll jeweils eine Oberkategorie erzeugt werden, damit die erzeugten Kategorien übersichtlich dargestellt werden. Klicken Sie die erste Zeile an und geben Sie in der Spalte 'Zusatzinformation' den Namen des Zusatztextes (z.B. 'Produktgruppe' ) ein.
Wiederholen Sie den Schritt 7 für die Zeilen 2-4 und ordnen Sie die Oberkategorien Produktname, Produkttyp und Designer zu.
Ordnen Sie dem Textfeld, welches die Farben enthält (Zeile 5), das Cumulus Feld 'Farben' zu, indem Sie auf Zeile 5 links doppelklicken und aus der erscheinenden Liste der Felder 'Farben' auswählen. In diesem Fall wird der Text in ein Listenfeld importiert, wenn die Liste bereits die entsprechenden Listeneinträge enthält. Wählen Sie im nachfolgenden Dialog 'Nein', da es sich nicht um ein Bezugsfeld handelt.
Ordnen Sie dem Textfeld, welches den Preis enthält (Zeile 6), das Cumulus Feld 'Preis in Euro' zu, indem Sie auf Zeile 6 links doppelklicken und aus der erscheinenden Liste der Felder 'Preis in Euro' auswählen. In diesem Fall wird der Text in ein Feld vom Typ Dezimalzahl importiert. Der Cumulus Importer wird die Umwandlung des Textes in eine Dezimalzahl vornehmen. Wählen Sie im nachfolgenden Dialog 'Nein', da es sich nicht um ein Bezugsfeld handelt.
Ordnen Sie dem Textfeld, welches die Anzahl der Bestellungen enthält (Zeile 7), das Cumulus Feld 'Bestellungen pro Monat' zu, indem Sie auf Zeile 7 links doppelklicken und aus der erscheinenden Liste der Felder 'Bestellungen pro Monat' auswählen. In diesem Fall wird der Text in ein Feld vom Typ Ganzzahl importiert. Der Cumulus Importer wird die Umwandlung des Textes in eine Ganzzahl vornehmen. Wählen Sie im nachfolgenden Dialog 'Nein', da es sich nicht um ein Bezugsfeld handelt.
Ordnen Sie dem Textfeld, welches das Erscheinungsdatum enthält (Zeile 8), das Cumulus Feld 'Erscheinungsdatum' zu, indem Sie auf Zeile 8 links doppelklicken und aus der erscheinenden Liste der Felder 'Erscheinungsdatum' auswählen. In diesem Fall wird der Text in ein Feld vom Typ Datum importiert. Der Cumulus Importer wird die Umwandlung des Textes in ein Datum vornehmen. Wählen Sie im nachfolgenden Dialog 'Nein', da es sich nicht um ein Bezugsfeld handelt.
WICHTIG: Die Datenübernahme kann nur dann funktionieren, wenn der Cumulus Importer weiss, in welche Datensätze der Text eingetragen werden soll. Sie müssen also einen Bezug zwischen den Daten in 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 dieser 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. (Hinweis: der Dateiname ist in Cumulus im Feld 'Asset-Name' gespeichert, nicht im Datensatznamen!). 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.
Wählen Sie im nachfolgenden Dialog 'Ja', da es sich hier um das Bezugsfeld handelt.
Aktivieren Sie den Schalter 'Ersten Datensatz bei der Datenübernahme ignorieren', da in der Textdatei die erste Zeile nur die Feldnamen, aber keine Daten enthält, die wir importieren möchten.
Starten Sie die Datenübernahme mit Hilfe des Buttons 'Daten importieren...'.
Wenn Sie in den Programmeinstellungen den Schalter 'Fehler protokollieren' oder 'Meldungen protokollieren' aktiviert haben, werden Sie nach dem Speicherort für die Logdatei gefragt.
Ein Fortschrittsbalken zeigt den Fortschritt beim Importieren der Datensätze an.
Nach dem Importieren wird die Anzahl der Fehler und Meldungen angezeigt. Überprüfen Sie diese durch Öffnen der Logdatei.

Nach der Datenübernahme hat der Katalog 'Möbel' folgenden Inhalt

Die Kategorien wurden als Unterkategorien strukturiert einsortiert und
die Informationen wurden den einzelnen Datensätzen zugordnet

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

Die Cumulus Importer Voreinstellungen

5.1 Einstellungen zur Importdatei

Die 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.

Zeichen-Encoding

Sie können hier das Zeichen-Encoding angeben, welches beim Speichern der Textdatei verwendet wurde. Dies ist notwendig, wenn die Textdatei Sonderzeichen oder Umlaute enthält (z.B. enthalten die mitgelieferten Beispiele Umlaute ä, ö, ü und ß) und die Datei auf einer anderen Plattform importiert werden soll (Mac OS X/Windows).

Daher verwenden die mitgelieferten Importschema-Dateien als Zeichen-Encoding den Wert 'ISO-8859-1'. Dies erlaubt das korrekte Lesen der Feldwerte mit Umlauten unter Mac OS X, obwohl die Dateien unter Windows gespeichert wurden. Klicken Sie auf Gültige Zeichen-Encodings, um im Web eine Liste von gültigen Zeichen-Encodings anzuzeigen. Wenn der Text auf derselben Platform gespeichert wurde, auf der er später auch importiert wird, ist die Angabe des Zeichen-Encodings nicht notwendig, da in diesem Fall automatisch beim Schreiben und Lesen das Encoding des Betriebsystems verwendet wird.

Gängige Zeichenencodings der verschiedenen Plattform sind:

Windows = ISO-8859-1, windows-1252
Mac OS X = UTF-8, UTF-16

5.2 Einstellungen zu Canto Cumulus

Die Einstellungen zu den Datensätzen im Cumulus Katalog

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.

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.

Fehlende Kategorien in der Kategorienliste vor dem Importieren in das Kategorien-Feld erzeugen

Wenn Sie den Schalter 'Nur vorhandene Kategorien zuordnen' aktivieren, werden nur Kategorien dem Datensatz zugeordnet, die bereits im Kategorienbaum existieren. Wenn eine Kategorie im Baum nicht existiert, kann diese auch dem Datensatz nicht zugeordnet werden. In diesem Fall ist also ein Import von Kategorien ein zwei-stufiger Prozess, da erst einmal beim ersten Import in den Kategorienbaum importiert werden muss, was dann in einem zweiten Importlauf zugeordnet werden kann.

Aktivieren Sie den Schalter 'Fehlende Kategorien erzeugen', wird vor dem Import die Kategorie(nhierarchie) erst im Kategorienbaum erzeugt und danach sofort dem Datensatz zugeordnet.

Fehlende Listeneinträge vor dem Importieren in ein Feld vom Typ Textliste erzeugen

Wenn Sie den Schalter 'Nur vorhandene Listeneinträge zuordnen' aktivieren, werden nur Listeneinträge dem Datensatz zugeordnet, die bereits im Listenfeld existieren. Wenn ein Listeneintrag nicht existiert, kann dieser auch nicht dem Datensatz zugeordnet werden. In diesem Fall ist also ein Import ein zwei-stufiger Prozess, da erst einmal beim ersten Import in das Listenfeld importiert werden muss, was dann in einem zweiten Importlauf zugeordnet werden kann.

Aktivieren Sie den Schalter 'Fehlende Listeneinträge erzeugen', wird vor dem Import der fehlenden Listeneintrag im Feld erzeugt und dann sofort dem Datensatz zugeordnet.

5.3 Einstellungen zum Cumulus Importer

Die Einstellungen zum Cumulus Importer - Metadaten Suchen und Ersetzen

Metadaten während des Imports suchen und ersetzen

Mit dieser Funktion können Sie Metadaten während des Imports ersetzen lassen. Die Konfiguration erfolgt über eine Liste von Ersetzungsbedingungen, wobei die Listeneinträge durch das Zeichen '|' separiert werden. Es gilt folgende Notation:

Suchtext1=Ersetzungstext1|Suchtext2=Ersetzungstext2|Suchtext3=Ersetzungstext3|...

Es wird also nach dem Text 'Suchtext' gesucht und dieser wird durch den Text 'Ersetzungstext' ersetzt.

Beispiel:

Der zu importierende Text: Canto<reg/> Cumulus<reg/> Bilddatenbank wird durch folgenden Import-Text ersetzt: Canto® Cumulus® Bilddatenbank.

Mit Hilfe dieser Funktion können Sie z.B. auch Zeilenumbrüche einfügen. Da die Feldwerte der Importdatei einzeilig sind, können Sie keine normalen Zeilenumbrüche verwenden. Sie können aber z.B. HTML-Zeilenumbrüche mit dieser Funktion beim Importieren durch 'echte' Zeilenumbrüche ersetzen.

Die Zuordnung '<br/>=\n' ermöglicht dies.

Somit wird aus dem Importtext: 'Deutschland<br/>Frankreich<br/>Spanien<br/>Griechenland' durch die Ersetzungsregel im Cumulus Textfeld der Wert:

Deutschland
Frankreich
Spanien
Griechenland

Der Feldwert also enthält dann die notwendigen Zeilenumbrüche.

Mit Hilfe dieser Funktion können also auch HTML-Texte beim Import automatisch in normalen Text umgestzt werden.

5.4 Einstellungen zur Logdatei

Die Einstellungen zur Protokolldatei

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

7.1 Spezielle Funktionen des Cumulus Importers

Neben den Basis-Funktionen, die den Import in einen Cumulus Katalog ermöglichen, enthält der Cumulus Importer eine Vielzahl von Funktionen, die die Konfiguration des Imports oder die Zusammenarbeit mit Cumulus erleichtern.

In diesem Kapitel werden einige dieser Funktionen beleuchtet.

7.1.1 Unterstützung von Multi-Katalog-Kollektionen

Im Cumulus Client können Sie eine Vielzahl von Katalogen gleichzeitig in einem oder in einer beliebigen Anzahl von Fenstern öffnen (evtl. sogar mehrfach).

Wenn Sie vor dem Import eine Vielzahl von Katalogen geöffnet haben, wird der Cumulus Importer nach dem Katalog fragen, in den Sie importieren möchten:

Es sind 2 Kataloge geöffnet - in welchen Katalog soll importiert werden?

Wenn Sie Importschemadateien verwenden, in denen ja der Name des Cumulus Kataloges eingetragen ist, in den importiert werden soll, so wird der Cumulus Importer alle offenen Fenster im Client prüfen, ob dieser Katalog in einem der Fenster geöffnet ist. Ist dies der Fall, kann der Import beginnen, ansonsten werden Sie zum Öffnen des passenden Kataloges aufgefordert.

7.1.2 Listenfelder mit Mehrfachauswahl

Ein Cumulus Katalog unterstützt auch Listenfelder mit Mehrfachauswahl. Im Beispielkatalog des Cumulus Importers 'Moebel' finden Sie ein Listenfeld 'Multi Farben', welches als Listenfeld mit Mehrfachauswahl (Checkbox 'Mehrfachauswahl zulassen') definiert ist.

Wenn Sie in Felder mit Mehrfachauswahl importieren möchten, können Sie die einzelnen Werte einfach wie im Beispiel unten durch ',' separieren. Als Separator wird dabei das in den Voreinstellungen gesetzte 'Trennzeichen der Kategorien' verwendet (Standard: ',').

Die Einstellungen zum Importieren in das Listenfeld mit Mehrfachauswahl

Die einzelnen Werte werden dann dem Datensatz entsprechend zugeordnet. Dabei entscheidet die Voreinstellung, ob fehlende Listeneinträge beim Import angelegt werden oder nicht.

Im Beispiel unten wurden erst die Listeneinträge in einem 1. Import erzeugt und danach in einem 2. Import die Zuordnung vorgenommen.

Zuordnung im Listenfeld nach dem Import

In diesem Beispiel wurde die Voreinstellung auf 'Fehlende Listeneinträge erzeugen' gesetzt und in ein bisher leeres Listenfeld importiert:

Zuordnung im Listenfeld nach dem Import

Mit dieser Voreinstellung wird jeder benötigte Listenwert erst einmal in der Felddefinition angelegt und dann sofort dem Datensatz in einem Schritt zugeordnet.

7.2 Feedback & Support

Ihr Feedback zu unserem Produkt ist sehr Willkommen und ist uns wichtig!

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.

8 Version History

Version 8.0.0.3 - Juli 2010

Bugfix Release: die Anzeige des Produkt-Icons in Dialogen wurde von der mit dem Cumulus Client gelieferten JVM (Java Virtual Machine) nicht unterstützt. Die Anzeige des Icons wurde wurde im Lizenz- und Info-Dialog entsprechend entfernt.

Version 8.0 - April 2010 (Release 8.0.0.2)

Offizielles Release des Cumulus Importers für Canto Cumulus 8. Neben einer Vielzahl kleiner Modifikationen wurden die folgenden Änderungen diese implementiert:

- für Canto Cumulus 8 optimiert, basiert nun komplett auf den Cumulus Java Classes 8, welches die Import-Performance um etwa den Faktor 10 erhöht.

- Importieren von Kategorien und Listeneinträgen und gleichzeitiges Zuordnen zu Datensätzen in einem Durchlauf.
Beim Importieren in Datensätze können fehlende Kategorien (-Hierarchien) und fehlende Einträge in Listenfelder automatisch erzeugt werden, damit diese dem Datensatz zugeordnet werden können. Sie haben beide Optionen: nur die Kategorien und Listeneinträge zuzuordnen, die vorhanden sind, oder fehlende anzulegen.
- Unterstüztung von Zeilenumbrüchen in Textfeldern
- Suchen und Ersetzen beim Import in Textfelder, ermöglicht das Umwandeln von Sonderzeichen oder HTML tags beim Import und das Einfügen von Zeilenumbrüchen.
- das Zeichen-Encoding der Importdatei kann nun konfiguriert werden (ISO-8859-1, UTF-8, ...). Dies erlaubt den Import von Textdateien mit Sonderzeichen und Umlauten, die auf anderen Plattformen erstellt worden sind
- volle Unterstützung von Multi Katalog Kollektionen. Sie können nun mehrere Kataloge gleichzeitig geöffnet haben, während Sie in einen bestimmten Cumulus Katalog importieren.
- beim Import in Listenfelder mit Mehrfachauswahl sind nun auch Aufzählungen der Listenwerte möglich. Diese können beim Import in Datensätze direkt in der Felddefinition erzeugt werden.
- neue Limitierung der Demoversion: die Limitierung wurde auf 10 Datensätze erweitert.

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
- unterstützt die neuen Feldtypen von Cumulus 7.5
- bessere Performance durch Multi-Threaded Applikation
- optimierte Logdatei
- bessere Fehlerkontrolle vor dem Import
- optimierte Dialogdarstellung
- Debug-Funktion für komplizierte Importdateien
- Bezugsmarker (+) wurde ersetzt durch [is] oder [ist] oder [est]

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
- Kategorien-Hierarchien können den Datensätzen nun beim Import in einem Schritt zugeordnet werden (Beispiel: 'kat1/kat11/kat111,kat1/kat11/kat113,kat1/kat11/kat113')
- ein neuer Lizenznummern-Mechanismus (Lizenzdialog) wurde implementiert. Die neuen Seriennummern sind nun keine Cumulus Optionsnummer mehr. Somit ist auch die Anforderung eines neuen Aktivierungsschlüssels für die Cumulus Version nach der Installation nicht mehr notwendig.
- optimierter Fortschrittbalken, es wird nun zur besseren Orientierung des Anwenders angezeigt, welcher Datensatz gerade importiert wird
- die optimierte Logdatei protokolliert nun auch Informationen zu den verwendeten Voreinstellungen zum Import

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.

©2003-2010, Heymann Consulting
Cumulus Importer - Version 8.0.0