Sie wollen Ihre Produkte im Internet verkaufen?

Transkript

1 Sie wollen Ihre Produkte im Internet verkaufen? Sie suchen eine kostengünstige Lösung? Sie wollen sofort loslegen?

2 Schnelleinstieg Auf einen Blick Arconn ist ein Java basierter Webshop mit einem Redaktionssystem für die Verwaltung Ihrer Webseiten. Es bietet Ihnen als Betreiber dieses Webshops bequeme Funktionalitäten, die Ihnen einen Auftritt im Internet erleichtern. Selbstständiges Aktualisieren und Erweitern von Inhalten. Dieser Bearbeitungsschritt erfolgt lokal auf Ihrem Rechner. Unbegrenzte Artikelanzahl Unbegrenzte Kategorien und Unterkategorien Arconn Anmeldung Nach der Anmeldung für den Administratorzugriff können Sie als Betreiber dieses Webshops den Inhalt Ihrer Webseiten hochladen. Ihre Kunden verwenden ebenfalls dieses Anmeldungsprozedere, um Bestellungen aufzugeben und um sich über den Status von Bestellungen zu informieren. Seite 1

3 Schnelleinstieg Arconn Datentransfer: Aktualisierung und Archivierung der Inhalte Sie können als Webshop-Betreiber auf einfache Art und Weise Ihre Katalog- und Kundendaten verwalten. Den aktuellen Datenbestand können Sie herunterladen und archivieren. Erweiterte und modifizierte Daten für den Inhalt Ihrer Webseiten können Sie direkt von Ihrer Festplatte hochladen und aktivieren. Einzelheiten über die Datenverwaltung finden Sie im Kapitel "Demoversion". Seite 2

4 Technische Spezifikationen Browserbasierte Verwaltung Die Verwaltung erfolgt auschliesslich über einen Webbrowser (Microsoft Internet Explorer 6 oder Mozilla Firefox). Komfortable Warenkorb-Funktionalität Dem Warenkorb hinzugefügte Artikel werden in der jeweiligen Artikelgruppe und im Warenkorb dargestellt. Im Warenkorb können die Artikel einzeln oder insgesamt wieder entfernt werden. Suchfunktion Suchbegriffe werden mit der Volltext-Suchfunktion in der Beschreibung und im Titel der Artikel erfasst. Ausgewählte Treffer werden im Artikelkatalog mit der zugehörigen Kategorie in der Baumstruktur dargestellt. SSL-verschlüsselter Bestellvorgang Der Bestellvorgang geschieht über ein gesichertes Übertragungsprotokoll mit 128 Bit-Datenverschlüsselung. Auftragsbestätigung Der Kunde erhält für jede Bestellung eine Auftragsbestätigung per . Die Auftragsbestätigung ist der im PDF-Format beigefügt. Archivierung der Bestellungen Ein angemeldeter Kunde kann seine früheren Bestellungen abrufen und den Bestellstatus feststellen. Diese Information wird über ein gesichertes Übertragungsprotokoll vermittelt und bezieht sich darauf, ob ein Auftrag bearbeitet, ausgeliefert resp. bezahlt wurde. Seite 3

5 Demoversion Für eine Demoversion mit Administratorzugriff müssen Sie sich zuerst die Zugangsdaten beschaffen. Diese werden Ihnen per zugestellt, nachdem Sie sich dafür angemeldet haben. Diese Anmeldung erfolgt auf der Webseite Die Demoversion enthält neben den (zufallsgenerierten) Daten für den Inhalt des Webshops auch verschlüsselte Zugangsdaten. Wenn Sie Ihre eigenen Daten hochladen, werden zuvor sämtliche Daten in der Datenbank gelöscht und Ihre eigenen Daten in die Datenbank eingefügt. Damit Sie sich später (vor Ablauf der Demoversion) wieder anmelden können, müssen Ihre eigenen Daten auch die Zugangsdaten enthalten, die für die Authentifizierung benötigt werden. Diese stehen Ihnen aber erst dann zur Verfügung, wenn Sie die Daten der Demoversion herunterladen. Danach können Sie Ihre eigenen Daten für den Inhalt des Webshops entweder modifizieren oder von Grund auf neu definieren. Übersicht Dieser Abschnitt beschreibt, wie der Arconn Online-Webshop für den Administratorzugriff in der Demoversion zu benutzen ist und welche Aspekte besonders zu berücksichtigen sind. Grundsätzlich besteht nach der Anmeldung die Möglichkeit, den aktuellen Zustand der Datenbank auszulesen und als Sicherungskopie lokal auf die Festplatte zu kopieren. Diese Datei kann offline modifiziert oder grundsätzlich neu erstellt und anschliessend hochgeladen werden. Mit "Download" werden sämtliche Daten aus der Datenbank ausgelesen und als Zip-Datei auf die Festplatte kopiert. Mit "Upload" werden die aktualisierten Daten von der Festplatte in die Datenbank übertragen. Diese Datei kann unkomprimiert oder als Zip-Datei in komprimierter Form vorliegen. Damit die aktualisierten Daten hochgeladen werden können, ist zu beachten, dass diese in einem bestimmten Format vorliegen müssen. Wenn das nicht der Fall ist, wird der Upload abgebrochen und der ursprüngliche Zustand der Datenbank wieder hergestellt. Seite 4

6 Demoversion: Download Download Aufbau der Zip-Datei Die heruntergeladene Zip-Datei kann unter Windows mit dem bekannten WinZip-Programm oder unter Unix mit dem Befehl unzip entpackt werden. Sie enthält zwei Arten Archiveinträgen: Der Archiveintrag mit dem Prefix "Catalog" im Namen beschreibt als XML-Dokument die Struktur der Produktekategorien und -unterkategorien. Diese werden weiter unten im Detail präsentiert. Alle anderen Archiveinträge beschreiben mit SQL-Anweisungen den Inhalt der Datenbank. Diese enthält insgesamt 8 Tabellen. Die Produkte des Webshops sind in der Tabelle products definiert. Die anderen Tabellen dienen der Infrastruktur des Webshops (Verwaltung der Kunden, Bestellungen, Berechtigungen, Daten für die Authentifizierung etc). Die Archiveinträge mit dem Suffix "products.txt" enthalten SQL-Anweisungen für die Produktedefinitionen der Produkte-Tabelle. Die Produkte-Tabelle products Die Daten für die Produkte-Tabelle werden mit der Anweisung: INSERT INTO `products` VALUES (); definiert. In den Klammern sind die Werte in einer festgelegten Reihenfolge aufgeführt. Die Reihenfolge dieser Werte, deren Wertetypen und Bedeutung werden im folgenden an einem Beispiel dargelegt: INSERT INTO `products` VALUES ( '1001', // 1. Produkte-ID 'c1', // 2. Produktekategorie-ID '1001.jpg', // 3. Bilddatei 474, // 4. Lagerbestand 10.00, // 5. Preis 1, // 6. Verfügbarkeit (1 oder true, 0 oder false) 1995, // 7. Erscheinungsjahr 'Produktname', // 8. Produktname 'Beschreibung: ' // 9. Produktebeschreibung: Umbrüche auf mehrere 'Ich bin ' // Zeilen nicht duch Komma getrennt. Jede Zeile 'käuflich.' // in Anführungszeichen. ); Die Produktetabelle enthält 9 Felder, deren Werte für einen einzelnen Datensatz durch Komma getrennt sind. Der Wertebereich für jedes Feld ist aus der folgenden Tabelle zu entnehmen: Seite 5

7 Demoversion: Download Pos. Bedeutung Typ Bereich 1 Produkte-ID Zeichen (varchar) Max.: 8 Zeichen 2 Produktekategorie Zeichen (varchar) Max.: 32 Zeichen 3 Bilddatei Zeichen (varchar) Max.: 12 Zeichen (oder null) 4 Lagerbestand Ganzzahl (int) Min.: , Max.: Preis Fliesskommazahl (float) +/-3.4E+38 Dezimaltrennzeichen ist Punkt 6 Verfügbarkeit Ganzzahl (tinyint) 1 (oder true), 0 (oder false) 7 Erscheinungsjahr Ganzzahl (smallint) Min.: -0, Max.: (oder null) 8 Produktbezeichnung Zeichen (varchar) Max.: 96 Zeichen 9 Beschreibung Zeichen (text) Max.: Zeichen Die Werte in der Produkte-Tabelle, die Text enthalten (1.-3., 8. und 9. Feld), stehen in Anführungszeichen. Bei Umbrüchen auf mehrere Zeilen (im 9. Feld) ist jede Zeile in Anführungszeichen gesetzt. Solche Zeilen sind nicht durch Komma getrennt. Der Wert für die Produktekategorie legt die Zuordnung der Produkte in der Katalog-Baumstruktur fest (siehe nächstes Kapitel). Als Grafikformate für die referenzierte Bilddatei können JPEG, GIF und PNG verwendet werden (siehe Kapitel "Dateien komprimieren") Produktekategorien Die Produktekategorien sind im Archiveintrag mit dem Prefixnamen "Catalog" in der Standardsprache XML beschrieben. Jede Produktekategorie wird in einer Baumstruktur mit einem Knotenelement (vorgegebener Elementname: Node) und drei Attributen (name, opened und id) definiert. Beachten Sie die korrekte Verschachtelung mit Starttag (<Node>) und Endtag (</Node>) innerhalb des übergeordneten Elements. Das folgende Beispiel soll das illustrieren: <?xml version="1.0" encoding="iso "?> <!DOCTYPE Node SYSTEM "test.dtd" > <!-- Wurzelelement --> <Node name="top" opened="0" id="c" > <Node name="produktegruppe 1" opened="0" id="c1" > <Node name="produktegruppe 1.1" opened="0" id="c1.1" > <Node name="produktegruppe 1.1.1" opened="0" id="c1.1.1" > </Node> <Node name="produktegruppe 1.1.2" opened="0" id="c1.1.2" > </Node> <!-- weitere Elemente --> </Node> </Node> </Node> Seite 6

8 Demoversion: Upload Die Attribute und deren Werte haben folgende Bedeutung: Atttribut name: Name der Produktekategorie, wie er im Arconn Webshop angezeigt wird. Attribut opened: Gibt die Standardeinstellung für die Anzeige untergeordneter Kategorien im Arconn Webshop an (0: geschlossen, 1: geöffnet) Attribut id: Bezeichnung, auf die sich der Wert im zweiten Feld der Produkte-Tabelle products bezieht (Produktekategorie-ID). Upload Die einfachste Möglichkeit, den Upload vorzubereiten besteht darin, die heruntergeladene Zipdatei zu entpacken und die Archiveinträge in ein neues Verzeichnis zu kopieren. Anschliessend können diese kopierten Dateien entsprechend den Hinweisen in den Abschnitten "Die Produkte-Tabelle products" und "Produktekategorien" mit einem gewöhnlichen Texteditor (zb. Notepad unter Windows) bearbeitet werden (Zeichensatz ANSI). Wenn Sie Microsoft Word verwenden, achten Sie darauf, die Datei mit dem Typ "Text only, (*.txt)" zu speichern. Danach können Sie die Dateien zu einem Archiv verpacken und hochladen. Formatierung und Sonderzeichen Wenn die Felder der Produktetabelle bearbeitet werden, ist darauf zu achten, dass die 5 Felder, die Zeichen enthalten, in einfachen (') oder doppelten (") Anführungszeichen gesetzt sind (Produkte-ID, Produktegruppe, Bilddatei, Produktename und Produktebeschreibung). Längere Texte im Feld für die Produktebeschreibung können auf mehrere Zeilen umgebrochen werden, wobei jede Zeile ebenfalls in Anführungszeichen zu setzen ist. Solche umgebrochenen Zeilen dürfen nicht durch Komma voneinander getrennt. Wenn ein Text selbst Anführungszeichen enthalten soll, muss ein umgekehrter Schrägstrich (\' resp. \") voranstellt sein. Dasselbe gilt auch für einen umgekehrten Schrägstrich (\\). Im XML-Dokument (für die Produktekategorien) müssen die Werte für die drei Attribute ebenfalls in einfache (oder doppelte) Anführungszeichen gesetzt werden. Falls spezielle Zeichen benötigt werden (wie zb. mathematische Symbole und griechische Zeichen), können sie auf sog. Entitäten zurückgreifen. Solche Zeichen müssen eingefasst werden mit einem Ampersand (&) und einem Semikolon (;). Beispielsweise wird für das griechische Lambda (Λ) die Kürzung λ verwendet. Eine Liste dieser speziellen Zeichen finden Sie unter Seite 7

9 Demoversion: Upload Kommentare Das XML-Dokument für die Produktekategorien kann Kommentare im XML-Stil enthalten. Diese müssen innerhalb der Startsequenz "<!--" und der Endsquenz "-->" stehen und sind nicht zulässig innerhalb von anderen Begrenzungen, die mit < beginnen und > enden. Zudem unterliegt diese Art von Kommentierung zwei weiteren Einschränkungen: Er darf nicht vor der XML-Deklaration stehen (<?xml version= "1.0" encoding= "ISO "?>) und im Kommentar darf die Zeichenfolge "--" nicht enthalten sein. Die Tabellentaten mit den SQL-Anweisungen können ebenfalls innerhalb bestimmter Kennzeichnungen Kommentare enthalten, die bei der Ausführung ignoriert werden. Die Demoversion im Arconn Online Webshop unterstützt vier Kommentarmöglichkeiten: Kommentar im Stil C Text ab einer '/*'-Sequenz bis und zur nächsten '*/'-Sequenz. Die abschliessende Sequenz muss nicht in derselben Zeile stehen, so dass ein Kommentar mehrere Zeilen umfassen kann. Kommentar im Stil C++ Text ab zwei aufeinenderfolgenden Schrägstrichen (//) bis zum Zeilenende. Kommentar im Stil MySQL: # Text ab einer # bis zum Zeilenende. Kommentar im Stil MySQL: -- Text ab einer '--'-Sequenz bis zum Zeilenende. Nach dem zweiten Bindestrich muss ein Leerschlag folgen. Dateinamen Für die Dateinamen beim Speichern müssen Sie folgendes beachten: Der Dateiname für das XML-Dokument (mit den Produktekategorien) ist nicht beliebieg wählbar. Der Anfang dieses Dateinamens muss "Catalog" lauten. Alle anderen Dateinamen sind beliebieg wählbar, dürfen aber nicht mit "Catalog" beginnen. Dateigröße Wenn Sie eine Datei bearbeiten, die Sie als Archiveintrag für eine zip-datei verwenden wollen, sollten Sie darauf achten, dass sie nicht größer als 1 MB wird. Fügen Sie in dem Fall einfach eine weitere Datei hinzu. Die maximale Grösse aller Archiveinträge liegt bei 180 MB (unkomprimiert). Seite 8

10 Demoversion: Upload Dateien komprimieren (verpacken) Sie können jedem Produkt eine Bilddatei zuordnen. Der Dateiname der Bilddatei muss in der Werteliste der insert-anweisung für die Produktetabelle an der 3. Position stehen. Wenn Sie keine Bilddatei zuordnen, muss an dieser Stelle der Wert null stehen. Die Dateien mit den Tabellendaten und den Produktekategorien und die Bilddateien können Sie unter Windows mit dem WinZip-Programm zu einem Archiv verpacken. Dazu müssen die Bilddateien in einem Verzeichnis mit dem Namen "images" vorhanden sein. Dieses images-verzeichnis muss im selben Verzeichnis liegen wie die Dateien mit den Tabellendaten und den Produktekategorien. 1. Legen Sie mit WinZip ein neues Archiv in einem Verzeichnis an. In diesem Verzeichnis werden Sie das fertig erstellte Archiv schliesslich hochladen. 2. Geben Sie dem neuen Archiv einen (beliebigen) Namen. Standardmässig lautet die Dateiendung.zip. 3. Fügen Sie im neu erstellten Verzeichnis (mit den aktualisierten Dateien) sämtliche Dateien hinzu, indem Sie unter Dateinamen "*.*" eingeben. Wählen Sie unter "Aktion" "Dateien hinzufügen" aus. 4. Aktivieren Sie unter "Ordner" die Option "Mit Unterverzeichnissen" (damit gegebenenfalls auch das Verzeichnis images erfasst wird) und deaktivieren Sie die Option "Vollständige Pfadangaben". 5. Klicken Sie auf die Schaltfläche "Mit Platzhaltern hinzufügen". Unter Linux können Sie die Archivdatei anlegen mit dem zip-befehl. Wenn Sie beispielsweise die Archiveinträge mit Dateiendung.txt und alle Bilder im images-verzeichnis verpacken wollen, geben Sie in der Konsole folgendes ein: zip zipdateiname *.txt images/* Unkomprimierte Datei hochladen Sie können auch eine einzelne unkomprimierte Datei hochladen. Allerdings müssen Sie dabei folgendes berücksichtigen: Die Dateien mit den Tabellendaten und den Produktekategorien müssen in einer Datei untergebracht werden. Diese Datei kann einen beliebigen Namen haben. Eine unkomprimierte Datei muss (genauso wie eine komprimierte Datei) den Inhalt sämtlicher 8 Tabellen enthalten. Das XML-Dokument muss nach den Tabellendaten folgen. Die Dateigrösse ist auf 20 MB beschränkt. Es können keine Bilder hochgeladen werden. Seite 9

11 Demoversion: Upload Natürlich ist es auch möglich, eine einzelne Datei mit den Tabellendaten und den (anschliessenden) Produktekategorien (mit oder ohne Bilder) zu einer Zipdatei zusammenzufassen. Upload-Vorgang Der Upload-Vorgang kann mehrere Minuten dauern. Wenn beim Upload keine Fehler aufgetreten sind, wird ein Hinweis ausgegeben, dass die Datei hochgeladen wurde. Andernfalls werden der ursprüngliche Zustand wieder hergestellt und eine Meldung ausgegeben, der auf die Fehlerursache hinweist (zb. SQL- oder XML-Syntaxfehler mit Archiv- und Zeilenangabe). Seite 10