MV2/Datenexportprofile

Aus ITscope GmbH - Wissensbasis

< MV2(Weitergeleitet von MV2/Anbindung von Fremdsystemen)
Wechseln zu: Navigation, Suche

Inhaltsverzeichnis

1 Allgemein

Die Datenexportprofile legen das Ausgabeformat einer Produktabfrage fest.

2 CSV-Datenprofile einrichten

2.1 Erstellen eines Datenprofils

Wählen Sie in der Menüleiste Export -> Datenprofile verwalten aus.
Wählen Sie Neues Profil und unter Standard wählen Sie das CSV Developer-Profil aus. Nun können Sie unter dem Reiter Format Datensatz modellieren auswählen, und die zu exportierenden Felder bestimmen. Um bei CSV-Dateien die Trennzeichen, Zeilentrenner, das Quotezeichen nach Ihren Wünschen anzupassen, klicken Sie auf den Button Formatdetails..

1. Export

2. Datenprofil verwalten

3. Neues Profil

4. CSV-Developer Profil Profil

5. Datenprofil bearbeiten

6. Anpassen von CSV-Trennzeichen, Zeilentrenner, Quoting


2.1.1 Ermitteln der DatenprofilId

Die Datenprofil-ID wird benötigt für Webservice-Abfragen.

Die Datenprofil-ID

2.2 Erstellen von Datenexportobjekten

Klicken Sie mit der rechten Maustaste in die weiße Fläche und wählen neues Exportobjekt aus. Geben Sie diesem neuen Exportobjekt einen Titel, einen Namen (inklusive der Dateiendung; Bsp. csv, txt) und wählen den Datensatztyp. Je nach ausgewähltem Datensatztyp unterscheiden sich die Felder, welche Ihnen zur Verfügung stehen.
Detaillierte Informationen finden Sie in unserer Übersicht der Datenexportfelder

Exportobjekt erstellen

2.3 Datenexportfelder hinzufügen und bearbeiten

Klicken Sie auf den Button Vordefinierte Felder einfügen und es erscheint eine Liste mit vordefinierten Datenexportfeldern (Mehrfach-Auswahl der Felder per STRG-Taste ist möglich)

1. Exportfelder hinzufügen

2. Vordefinierte Spalten

Haben Sie nun die gewünschten Felder ausgewählt, können Sie diese noch anpassen. Um den Spaltennamen zu ändern, überschreiben Sie den bereitsvorhandenen Namen. Möchten Sie den Inhalt der Spalte noch erweitern, wählen Sie den die entsprechende Spalte und klicken in das Feld Ausdruck. Klicken Sie auf den Button der nun erscheint und geben in den Editor Ihren neuen XPath Ausdruck ein, indem Sie den alten Ausdruck überschreiben.

Mögliche Ausdrücke für Exportfunktionen.

Spaltenausdruck ändern

Spaltenausdruck erweitern

Ein Bespiel für eine kleine Erweiterung könnte wie folgt aussehen: 

 var stock  = Xpath.eval("its:priceCalc($pcId, $suppliers)/stock");
 var status = Xpath.eval("its:priceCalc($pcId, $suppliers)/status");
 if (status == 1) {
	if (stock == 0) {
	        "10"; 
	} else {
		stock;
	}
} else {
	stock;
}

In diesem Beispiel wird der Bestand auf 10 gesetzt, wenn der Lieferant den Status 1 (sofort lieferbar) hat, aber keinen Bestand hat. Ansonsten wird der Wert des Lieferanten verwendet.

2.4 Exportparameter konfigurieren

Exportparameter können Sie im Reiter Parameter einstellen.
Nachfolgend die wichtigsten Parameter auf einen Blick:

Parameter Variable Beschreibung
CSV-Dateiheader csvHeader Hiermit können zusätzliche Zeilen am Anfang einer CSV-Datei hinzugefügt werden. Dies ist manchmal nötig, um den CSV-Export konform zum Zielformat zu machen, z.B. beim Amazon Sellercentral Export
Ignoriere Kreditorennummer ignoreCreditorNumber Ist der Parameter gesetzt, wird die LieferantenID bei Webserivce Responses nicht mehr, mit der im Lieferantenkonto gesetzten Kreditornummer, überschrieben. Siehe auch Kreditorennummer
Klassifizierung classId Hier geben Sie die Klassifizierung an, die im Export verwendet werden soll, um Produkten Kategorien zuzuordnen. Beachten Sie, daß Sie eine multilieferantenfähige Klassifizierung (z.B. CommerceDB) wählen müssen, wenn Sie Produkte verschiedenener Lieferanten exportieren.

Wenn Sie die Klassifizierung eines einzelnen Lieferanten wählen, können nur dessen Produkte im Export mit Kategorien versehen werden.

Lieferanten suppliers Hier legen Sie sämtliche Lieferanten fest, die im Export berücksichtigt werden, z.B. für die Preiskalkulation.

Diese Lieferanten werden nicht benutzt, wenn der Parameter Portfolio-Lieferanten übernehmen gesetzt ist.

Portfolio-Lieferanten übernehmen overrideSuppliers übernimmt wenn gesetzt die eingestellten Lieferanten eines exportierten Produktportfolios
Mindestverfügbarkeit minAvail Dieser Parameter ist nur von Bedeutung, wenn Sie Felder wie z.B. minPriceAvailable oder minPriceStatus benutzen.

Dieser Parameter stellt keine allgemeine Filterung auf die Mindestverfügbarkeit dar.

Preiskalkulation pcId Preiskalkulation, per Default Auto-Kalkulation (wählt automatisch nach Priorität eine Preisregel aus)
Unterdrücke productsources-Tabelle hideProductSources dafür muß dann productId zum sources-Exportobjekt hinzugefügt werden
Zubehör hinzufügen crossref komplettes Setzen der Referenzproduktfelder,

nur für den Gebrauch im MarketViewer gedacht, nicht für CSV-Profile verwenden!

Zuordnungsqualität der Bezugsquellen mappingQuality Mindestqualität, die erfüllt sein muß damit eine Bezugsquelle im Export berücksichtigt wird.
Realtime-Abfrage realtime Realtimeabfrage von Preisen und Verfügbarkeiten. Dieser Parameter ist nur nach Freischaltung erhältlich, es gelten die Bedingungen für das korrekte Setzen des User-Agents

Datenprofilparameter

Falls Sie weitere Parameter für Ihr Datenprofil benutzen möchten, welche nicht freigeschaltet sind, so können Sie diese gerne bei uns nachfragen.

2.5 Exportfilter verwenden

Im Datenprofil unter dem Reiter Filter, können Sie Filter definieren, welchen Ihren Export einschränken. Klicken Sie dazu auf Neuer Filter und tragen einen Namen für Ihren Filter ein. Um nun einen Filterausdruck zu hinterlegen, klicken Sie den Button der nun im Feld Filterausdruck erscheint.

Filter erstellen

Filterausdruck eintragen

Das Beispiel zeigt einen Filter, der nur noch Produkte exportiert, die einen kalkulierten Preis > 0 haben.

Die häufigst benutzten Filter finden Sie unter Exportfilter-Beispiele.

2.6 Export

2.6.1 einzelne Produkte exportieren

Suchen Sie nach einem Artikel, den Sie gerne exportieren würden. Wählen Sie per Rechtsklick auf das Produkts „Produkt speichern unter…“

Angebot

Wählen Sie das gewünschte Exportprofil aus und drücken Sie den Exportieren-Knopf.

2.6.2 Produktlisten exportieren

Per Rechtsklick auf ein gefundenes Produkt können Sie dieses auf eine bestehende Produktliste setzen oder eine neue erstellen. Fügen Sie einige Produkte auf Ihre Liste hinzu, achten Sie jedoch darauf (um dieses Beispiel simpel zu halten), nur Produkte aus dem Reiter „Premium Produkte“ zu verwenden.

Im nächsten Schritt wählen Sie die eben erstellte Produktliste aus und wählen per Rechtsklick den Punkt „Exportieren“.

Export

Wählen Sie das gewünschte Exportprofil aus und drücken Sie den Exportieren Knopf.


2.6.3 Produktportfolio exportieren

Erstellen Sie ein Produktportfolio
Es gibt 2 verschiedene Arten ein Produktportfolio zu exportieren:
1.

Wählen des Portfolios über die Navigation

Exportieren

Wählen Sie das gewünschte Exportprofil aus und drücken Sie den Exportieren-Knopf.

2.

1. Export

2. Exportmanager

3. Produktportfolio wählen und exportieren

Wählen Sie das gewünschte Exportprofil aus und drücken Sie den Exportieren-Knopf.

2.7 Veröffentlichung einrichten

Erstellen Sie ein Produktportfolio. Über Rechtsklick können Sie ein neues Generierungsprofil anhängen, indem Sie ein Datenprofil aus der Liste wählen. Markieren Sie nun das eben angehängte Profil und klappen auf der rechten Seiten den Punkt Veröffentlichung auf.

  • Veröffentlichung aktiv: Ist der Haken aktiviert, wird die Veröffentlichung zu der im Generierungszeitplan eingetragenen Uhrzeit generiert.
  • Immer denselben Dateinamen verwenden: Setzen Sie den Haken um immer den selben Dateinamen (entspricht dem Name des Portfolios) beim Export zu erhalten. Ist der Haken nicht gesetzt wird an den Dateinamen (entspricht dem Name des Portfolios) das Datum angehängt (YYYYMMDD).
  • FTP: Tragen Sie Ihre FTP-Zugangsdaten ein. Achten Sie darauf korrekte Zugangsdaten einzutragen und prüfen Sie auch nach, ob in dem Zielverzeichnis das Schreibrecht gesetzt ist.
    • Host: Adresse Ihres FTP Servers, Unterverzeichnis werden mit / gesetzt. z.B. ftp://www.meinftp.de/verz1/verz2/verz3
    • Username: Zugangsname zum FTP Server
    • Passwort: Zugangspasswort zum FTP Server
    • Dateiname: Hier können Sie einen Dateinamen für Ihren Export vergeben. Dieses Feld ist optional und nur dann nötig, wenn Sie auf feste Dateinamen angewiesen sind. Der Haken Immer denselben Dateinamen verwenden' hat keine Wirkung auf diese Einstellung, d.h. der Dateiname bliebt bei jedem Export gleich. Die Dateiendung muss mit dem im Datenprofil eingestellten Format übereinstimmen
  • Email: Hier können Sie Ihre Email-Adresse (mehrere Email-Adressen mit ; trennen) hinterlegen dann erhalten Sie Ihren Export auch per Mail. Es werden nur Exporte versendet, die kleiner 20 MB sind. Berücksichtigen Sie auch die Größe Ihres Emailpostfaches.
  • Generierungszeitplan: Tragen Sie die gewünschten Zeiten im Crontab-Stil ein. Es sind bereits 2 auskommentierte (#) Zeilen in dem Editorfeld generiert, mit einer Beispiel Cronzeit. Sie müssen in diesem Feld eine Cronzeit eintragen, da sonst keine Generierung Ihres Portfolios stattfindet.

Nicht erlaubte Cronzeiten sind Einträge kleiner 1 Stunde.

  • 0 0/30 * * * ? entspricht einer Cronzeit von alle halbe Stunde ist nicht erlaubt.
  • 0 0 0/1 * * ? entspricht einer Cronzeit von jede Stunde ist erlaubt.
  • 0 0/120 * * * ? entspricht einer Cronzeit von alle 2 Stunden ist nicht erlaubt.
  • 0 0 0/2 * * ? entspricht einer Cronzeit von alle 2 Stunden ist erlaubt.

Zusammenfassend gesagt: es sind im Sekunden und Minutenbereich keine anderen Zeichen als 0..59 erlaubt.

Veröffentlichung

Veröffentlichung mit eigenem Dateinamen

Cronzeiten eintragen

3 XML-Datenprofile einrichten

3.1 Erstellen eines Datenprofils

Wählen Sie in der Menüleiste Export Datenprofile verwalten aus.
Wählen Sie Neues Profil und unter Standard wählen Sie das XML Developer-Profil aus. Nun können Sie unter dem Reiter Format Datensatz modellieren auswählen, und die zu exportierenden Felder bestimmen.

1. Export

2. Datenprofil verwalten

3. Neues Profil

4. XML-Developer Profil Profil

5. Datenprofil bearbeiten


3.2 Datenexportfelder hinzufügen und bearbeiten

Klicken Sie auf den Button Vordefinierte Felder einfügen und es erscheint eine Liste mit bereits verwendbaren Spalten. Setzen Sie einen Haken um die Spalten im Export zu erhalten.

Spalten auswählen

3.3 Exportparameter konfigurieren

Die wichtigsten Parameter finden Sie unter Exportparameter konfigurieren

3.4 Exportfilter verwenden

Die Filtereinstellung finden Sie unter Exportfilter verwenden

4 Fragen und Antworten

siehe Export FAQ

Von „http://www.itscope.de/wiki/MV2/Datenexportprofile“