Cumulus Importer Version 6.6

EJaP (Embedded Java PlugIn) für die Canto Cumulus 6 Workgroup Edition oder SingleUser unter Mac OS X oder Windows

Inhalt

1. Einführung

Der Cumulus Importer ermöglicht Ihnen die automatische Datenübernahme aus einer Textdatei heraus in Ihre Canto Cumulus Kataloge ab Version 6 (Hinweis: wenn Sie Daten in Cumulus Kataloge der Version 5 importieren möchten, verwenden Sie bitte unseren Cumulus Importer 3.1). Somit wird es möglich, beliebige Informationen aus einem Warenwirtschaftsystem oder aus einem anderen Datenbanksystem 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 Kategorienfelder) die Werte eingetragen werden. Die Daten können in Textfelder, Textlisten oder in die Kategorienliste übernommen werden.

2. Installation

Wenn Sie die Software aus dem Internet heruntergeladen haben, haben Sie die Datei 'CumulusImporter66.zip' erhalten. Zur Installation der Software entpacken Sie die gelieferte Datei 'CumulusImporter66.zip'. Sie erhalten einen Ordner mit Namen 'Cumulus Importer 66'. Wenn Sie das Produkt auf CD-ROM erhalten haben, enthält diese den Ordner 'Cumulus Importer 66' 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.

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 6
  1. CumulusImporter.ejp - Erweiterung für Canto Cumulus zum Import der Daten
  2. Der Ordner 'Dokumentation' enthält Informationen zur Verwendung des Programms im HTML-Format
  3. Der Ordner 'Beispieldateien' enthält einen Cumulus Beispielkatalog, Textdateien und Importschema-Dateien, auf die in dieser Dokumentation Bezug genommen wird
  4. Die README-Datei enthält weitere Informationen zur gelieferten Version des Cumulus Importers

Zur Installation unter Windows kopieren Sie den Ordner 'Cumulus Importer 66' in das Verzeichnis 'C:\Programme'. Die enthaltenen Beispiele können nur verwendet werden, wenn Sie den Ordner (und alle enthaltenen Dateien und Ordner) in dieses Verzeichnis kopieren!

Unter Mac OS X kopieren Sie den Ordner 'Cumulus Importer 66' in das Verzeichnis 'Macintosh HD/Programme'.

In dem kopierten Ordner befindet sich die Cumulus Importer Applikation 'CumulusImporter.ejp'. Kopieren Sie diese Datei in den 'ejp'-Ordner des Installations-Ordners Ihrer Cumulus Anwendung (Cumulus Client oder Single User). Dieser befindet sich nach einer Standard-Installation unter Windows unter 'C:\Programme\Canto\Cumulus 6 Workgroup Client', unter Mac OS X ist dies 'Macintosh HD/Programme/Cumulus 6 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 die Cumulus Applikation 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 / Single User 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.

Es ist auch möglich, dass Sie eine Version des Cumulus Importer 6 ohne Seriennummer erhalten haben. Dies ist eventuell der Fall, wenn Sie eine ältere Version des Importers incl. des Updates auf Cumulus Importer 6 erworben haben. In diesem Fall brauchen Sie keine Seriennummer in den Canto Lizenz-Dialog einzugeben, da die Nummer bereits in der Software eingetragen ist. Sie erhalten dann bei der Lieferung einen entsprechenden Hinweis.

3. 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 5 Datensätze pro Session limitiert.

Die Vollversion der Software können Sie hier bestellen.

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 'Möbel.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 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 ( Windows: 'C:\Programme\Cumulus Importer 6' und Mac OS X: 'Macintosh HD/Programme/Cumulus Importer 6') installiert haben oder Sie vorher die Zeile der Importschema-Datei, die den Pfad zur Textdatei enthält, geändert haben.

4. 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 6 Beispielkatalog vor der Datenübernahme

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

  1. Öffnen Sie den Cumulus Katalog, in den Sie die Informationen eintragen lassen möchten.
  2. Öffnen Sie die Textdatei, die die Informationen enthält, die Sie in Cumulus importieren möchten, über den Menübefehl 'Importer>Öffnen...'.
  3. Sie müssen festlegen, welche Informationen zu übernehmen sind und in welche Datensatz- oder Kategorienfelder 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 Kategorienfelder 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 Kategorienfelder 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.
  4. 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.
  5. 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.
  6. 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.

5. Konfiguration der Datenübernahme

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

Import-Einstellungen für Daten aus der Beispieldatei 'Möbel.txt'

In dem oben gezeigten Beispiel werden Textinformationen aus einer Datei names 'Möbel.txt' in den Cumulus Katalog 'Möbel' übernommen. Die Textdatei enthält Produktdaten zu einer Vielzahl von Designer-Möbeln (Produktinformationen, Hersteller, Preisinformationen, ...).

Auswahl der Textdatei für den Datenimport

Wählen Sie also erst einmal die Textdatei aus, die die zu übernehmenden Daten enthält. Benutzen Sie hierzu das Menü 'Datei>Öffnen'.

Die Anzeige des ersten Datensatzes aus der Textdatei in der linken Liste

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

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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 Kategorienfelder übernehmen möchten.

Auswahl des Cumulus Feldtyps: Datensatz- oder Kategorienfeld

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 Kategorienfeld 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 Kategorienfelder übernehmen, so müssen Sie das Programm beenden und beim nächsten Aufruf 'Kategorienfelder' 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 den nachfolgenden Dialog mit 'Ja' bestätigen.

Der Feldname in der Zeile wird dann mit einem '+'-Zeichen in Klammern 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 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.

Die Zuordnung der weiteren Felder geschieht analog. Wie Sie dieses Importschema verwenden, erfahren Sie im Beispiel 4.

5.2 Weitere Informationen zur Konfiguration

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

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

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

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

5.3 Datenübernahme in Felder der Kategorienliste

Es können mit Hilfe des 'Cumulus Importers' auch Daten in Kategorienfelder übernommen werden. Die Konfiguration der Datenübernahme erfolgt entsprechend den Anweisungen bzgl. der Konfiguration der Übernahme in die Datensatzfelder.

5.3.1 Übernahme in Kategorienfelder

Damit Sie Informationen aus der Textdatei in die Kategorienfelder des Cumulus Kataloges übernehmen können, müssen Sie sich beim ersten Zuordnen eines Cumulus Feldes im angezeigten Dialog für 'Kategorienfelder' entscheiden.

Auswahl des Cumulus Feldtyps: Datensatz- oder Kategorienfelder

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

Wählen Sie ein Kategorienfeld aus der Liste

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 Kategorienfeld zugeordnet werden. Wichtig: Kategorienamen müssen zur Verwendung dieser Funktion eindeutig sein, da ansonsten einfach die erste gefundene Kategorie des gesuchten Namens verwendet wird.

5.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\Cumulus Importer 66' unter Windows oder 'Macintosh HD/Programme/Cumulus Importer 66' 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 oder Ihrer SingleUser-Version. 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:

  1. Farben - das Feld ist vom Typ 'Liste'
  2. Preis in Euro - das Feld ist vom Typ 'Dezimalzahl'
  3. Bestellungen pro Monat - das Feld ist vom Typ 'Ganzzahl'
  4. 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\Cumulus Importer 6' installiert haben oder Sie vorher die Zeile der Importschema-Datei, die den Pfad zur Textdatei enthält, geändert haben.

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

  1. Öffnen Sie den Cumulus Beispiel-Katalog 'Möbel'.
  2. Ö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...'.
  3. 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 Kategorienfelder importieren möchten. Bei dem Feld 'Farben' handelt es sich um ein Datensatzfeld, also wählen Sie dieses aus.
  4. In der erscheinenden Liste wählen Sie das Feld 'Farben' aus. Somit ist der Text dem Feld 'Farben' zugeordnet.
  5. Wählen Sie im nachfolgenden Dialog 'Nein', da es sich nicht um ein Bezugsfeld handelt.
  6. Sie können sich den zu übernehmenden Text genauer ansehen, indem Sie die einzelnen Textzeilen mit Hilfe der Button >> und << durchblättern.
  7. Starten Sie die Datenübernahme mit Hilfe des Buttons 'Daten importieren...'.
  8. Wenn Sie in den Programmeinstellungen den Schalter 'Fehler protokollieren' oder 'Meldungen protokollieren' aktiviert haben, werden Sie nach dem Speicherort für die Logdatei gefragt.
  9. Ein Fortschrittsbalken zeigt den Fortschritt beim Importieren der Datensätze an.
  10. 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.

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

  1. Öffnen Sie den Cumulus Beispiel-Katalog 'Möbel'.
  2. Ö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...'.
  3. 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 Kategorienfelder importieren möchten. Bei der Kategorienliste handelt es sich um ein Datensatzfeld mit Namen 'Kategorien', also wählen Sie dieses aus.
  4. In der erscheinenden Liste wählen Sie das Feld 'Kategorien' aus. Somit ist der Text dem Feld 'Kategorien' zugeordnet.
  5. Wählen Sie im nachfolgenden Dialog 'Nein', da es sich nicht um ein Bezugsfeld handelt.
  6. Sie können sich den zu übernehmenden Text genauer ansehen, indem Sie die einzelnen Textzeilen mit Hilfe der Button >> und << durchblättern.
  7. 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.
  8. 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.
  9. Wiederholen Sie den Schritt 7 für die Zeilen 2-5 und ordnen Sie die Oberkategorien Produktname, Produkttyp, Designer und Farbe zu.
  10. Starten Sie die Datenübernahme mit Hilfe des Buttons 'Daten importieren...'.
  11. Wenn Sie in den Programmeinstellungen den Schalter 'Fehler protokollieren' oder 'Meldungen protokollieren' aktiviert haben, werden Sie nach dem Speicherort für die Logdatei gefragt.
  12. Ein Fortschrittsbalken zeigt den Fortschritt beim Importieren der Datensätze an.
  13. 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:

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.

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

  1. Öffnen Sie den Cumulus Beispiel-Katalog 'Möbel'.
  2. Ö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...'.
  3. 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 Kategorienfelder importieren möchten. Beim Notizenfeld handelt es sich um ein Datensatzfeld mit Namen 'Notizen', also wählen Sie dieses aus.
  4. In der erscheinenden Liste wählen Sie das Feld 'Notizen' aus. Somit ist der Text dem Feld 'Notizen' zugeordnet.
  5. Wählen Sie im nachfolgenden Dialog 'Nein', da es sich nicht um ein Bezugsfeld handelt.
  6. Sie können sich den zu übernehmenden Text genauer ansehen, indem Sie die einzelnen Textzeilen mit Hilfe der Button >> und << durchblättern.
  7. 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.
  8. 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.
  9. 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.
  10. 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.
  11. 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!).
  12. Wählen Sie im nachfolgenden Dialog 'Ja', da es sich hier um das Bezugsfeld für diesen Import handelt.
  13. 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.
  14. Starten Sie die Datenübernahme mit Hilfe des Buttons 'Daten importieren...'.
  15. Wenn Sie in den Programmeinstellungen den Schalter 'Fehler protokollieren' oder 'Meldungen protokollieren' aktiviert haben, werden Sie nach dem Speicherort für die Logdatei gefragt.
  16. Ein Fortschrittsbalken zeigt den Fortschritt beim Importieren der Datensätze an.
  17. 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

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

  1. Öffnen Sie den Cumulus Beispiel-Katalog 'Möbel'.
  2. Öffnen Sie die Textdatei 'Möbel.txt', die die Informationen enthält, die Sie importieren möchten, über den Menübefehl 'Importer>Öffnen...'.
  3. 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 Kategorienfelder importieren möchten. Wir möchten in diesem Beispiel in Cumulus Datensatzfelder importieren, denn auch das Kategorienfeld selbst ist ein Cumulus Datensatzfeld. Wählen Sie das Feld 'Kategorien'.
  4. Wählen Sie im nachfolgenden Dialog 'Nein', da es sich nicht um ein Bezugsfeld handelt.
  5. Sie können sich den zu übernehmenden Text genauer ansehen, indem Sie die einzelnen Textzeilen mit Hilfe der Button >> und << durchblättern.
  6. 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.
  7. Wiederholen Sie den Schritt 7 für die Zeilen 2-4 und ordnen Sie die Oberkategorien Produktname, Produkttyp und Designer zu.
  8. 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.
  9. 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.
  10. 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.
  11. 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.
  12. 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.
  13. 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.
  14. Wählen Sie im nachfolgenden Dialog 'Ja', da es sich hier um das Bezugsfeld handelt.
  15. 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.
  16. Starten Sie die Datenübernahme mit Hilfe des Buttons 'Daten importieren...'.
  17. Wenn Sie in den Programmeinstellungen den Schalter 'Fehler protokollieren' oder 'Meldungen protokollieren' aktiviert haben, werden Sie nach dem Speicherort für die Logdatei gefragt.
  18. Ein Fortschrittsbalken zeigt den Fortschritt beim Importieren der Datensätze an.
  19. 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

Die Informationen und Kategorien wurden den einzelnen Datensätzen zugordnet

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.

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

Info...

Im Info-Dialog erhalten Sie Informationen zur aktuellen Version Ihres Cumulus Importers. Desweiteren werden Ihre Registrationsinformationen angezeigt.

7. Programmeinstellungen

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

7.2 Einstellungen zu Canto Cumulus

Die Einstellungen zu den Datensätzen im Cumulus Katalog

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.

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

8. Die Exportdatei

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.

9. Versionshistorie

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.

10. Weitere Hinweise

Fragen und Anregungen senden Sie bitte an die Email-Adresse support@heymann-consulting.de. Wir stehen Ihnen gerne für Rückfragen zur Verfügung.

10.1 Fragen & 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 Kapitel 5.3.2 Beispiel 2: Import in die Kategorienliste. Nach dem Anlegen der Kategorien können diese dann den Datensätzen zugeordnet werden, wie in Kapitel 5.3.4 Beispiel 4: Import in Datensatzfelder.

© 2001-2005 Heymann Consulting, Media Asset Management

Brandstwiete 36, 20457 Hamburg
info@heymann-consulting.de, http://www.heymann-consulting.de