Aktionen

CSV: Unterschied zwischen den Versionen

Aus mention Software GmbH WIKI

(Die Seite wurde neu angelegt: „==mention®Connect - CSV - Schnittstelle - Funktionsumfang == * Import von Bestellungen aus CSV Dateien. ** Individuelle Spalten Zuordnung für Versand-, Rech…“)
 
Zeile 1: Zeile 1:
 
==mention®Connect - CSV - Schnittstelle - Funktionsumfang ==
 
==mention®Connect - CSV - Schnittstelle - Funktionsumfang ==
 
* Import von Bestellungen aus CSV Dateien.  
 
* Import von Bestellungen aus CSV Dateien.  
** Individuelle Spalten Zuordnung für Versand-, Rechnungsadresse sowie auch Positionsdaten.
+
** Individuelle Spaltenzuordnung für Versand-, Rechnungsadresse sowie Positionsdaten.
** Optional Überwachung von Verzeichnissen mit, das Verzeichnis wird überwacht, gespeicherte Dateien werden sofort nach eintreffen verarbeitet. Für die Aktivierung muss 'Interv. Bestellungen' eine Zahl größer NULL eingetragen werden
+
** Optional Überwachung von Verzeichnissen, gespeicherte Dateien werden sofort nach Eintreffen verarbeitet. Für die Aktivierung muss bei 'Interv. Bestellungen' eine Zahl größer 0 eingetragen werden
** Importieren von CSV Dateien von einem SFTP / FTP Server (optional)
+
** Importieren von CSV-Dateien von einem SFTP- / FTP-Server (optional)
  
 
** Manueller Import mit einem Dateiauswahl-Dialog.
 
** Manueller Import mit einem Dateiauswahl-Dialog.
* Export Versandbestätigungen als CSV Datei
+
* Export Versandbestätigungen als CSV-Datei
 
** Ausgabe von Versandbestätigungen mit einem selbstdefinierten Format.
 
** Ausgabe von Versandbestätigungen mit einem selbstdefinierten Format.
 
** '''Achtung''' Spaltenüberschriften werden nicht exportiert
 
** '''Achtung''' Spaltenüberschriften werden nicht exportiert
** Für die Aktivierung muss innerhalb Upload-Intervall eine Zahl größer NULL eingetragen werden
+
** Für die Aktivierung muss innerhalb Upload-Intervall eine Zahl größer 0 eingetragen werden
* Einstellungen können Importiert und Exportiert werden.
+
* Einstellungen können importiert und exportiert werden.
  
 
* Export von Artikeldaten (seit dem 28.06.2018)
 
* Export von Artikeldaten (seit dem 28.06.2018)
Zeile 27: Zeile 27:
 
| Verz. Best.
 
| Verz. Best.
 
| Das zu überwachende Verzeichnis
 
| Das zu überwachende Verzeichnis
| Beachten Sie bitte, dass in diesem Verzeichnis das Schreibrecht finden lassen sollte. Im autmatischem Betrieb werden Dateien welche verarbeitet wurden in ein Unterverzeichnis Imported verschoben um sicher zu stellen, dass die Datei nicht ein weiters Mal verarbeitet wird
+
| Stellen Sie bitte sicher, dass Connect Schreibzugriff auf dieses Verzeichnis hat. Im autmatischen Betrieb werden zu verarbeitende Dateien in ein Unterverzeichnis Imported verschoben, um sicher zu stellen, dass die Datei nicht ein weiters Mal verarbeitet wird.
 
|-
 
|-
 
| Datei Präfix
 
| Datei Präfix
 
| selbsterklärend
 
| selbsterklärend
| Es werden nur Dateien verarbeitet die einem bestimmten Schema entsprechen, hierbei handelt es sich um den vorangestellten Text. Beispiel 'order_', hierbei werden nur Dateien verarbeitet welche mit dem Text order_ beginnen
+
| Es werden nur Dateien verarbeitet, die einem bestimmten Schema entsprechen. Hierbei handelt es sich um den vorangestellten Text. Beispiel 'order_', hierbei werden nur Dateien verarbeitet welche mit dem Text order_ beginnen.
 
|-
 
|-
 
| Datei Extension
 
| Datei Extension
Zeile 37: Zeile 37:
 
| Beispiel 'csv'
 
| Beispiel 'csv'
 
|-
 
|-
| Csv-Datei
+
| CSV-Datei
 
| selbsterklärend
 
| selbsterklärend
| Wählen Sie hier eine Beispiel Datei welche als Format für das einlesen der Bestellung dient. Nachdem die Datei ausgewählt wurden, werden die Zuordnungen generiert.  
+
| Wählen Sie hier eine Beispieldatei welche als Formatvorlage für das Einlesen der Bestellung dient. Nachdem die Datei ausgewählt wurde, werden die Zuordnungen generiert.  
 
|-
 
|-
 
| Spalten Trenner
 
| Spalten Trenner
 
| Wertetrennung innerhalb der CSV Datei
 
| Wertetrennung innerhalb der CSV Datei
| Beispiel Inhalt ";" Nach einer Änderung des Trennzeichens werden die Zuordnungsdropdowns neu initialisiert, es kann vorkommen, dass dann vorhandene Zuweisungen nicht mehr gültig sind.
+
| Beispiel Inhalt ";" Nach einer Änderung des Trennzeichens werden die Zuordnungsdropdowns neu initialisiert, es kann vorkommen, dass Zuweisungen erneut vorgenommen werden müssen.
 
|-
 
|-
 
| Text Qualifizierer
 
| Text Qualifizierer
 
| selbsterklärend
 
| selbsterklärend
| Es kommt vor, dass Textinhalte mit Anführungszeichen versehen sind
+
| Es kommt vor, dass Textinhalte mit Anführungszeichen versehen sind.
 
|-
 
|-
 
| Remote-Pfad
 
| Remote-Pfad
Zeile 54: Zeile 54:
 
wird die gefundenen Dateien in das Verzeihnis &quot;Verz. Best.&quot; gespeichert. <br />
 
wird die gefundenen Dateien in das Verzeihnis &quot;Verz. Best.&quot; gespeichert. <br />
 
'''Hinweis'''<br />
 
'''Hinweis'''<br />
Es wird für das Abrufen der Datei Präfix und auch die Datei Extension verwendet. Hierbei können auch Wildcards als Stern * verwendet werden, der Stern steht für ein beliebiges Zeichen.
+
Es wird für das Abrufen der Datei-Präfix wie auch die Dateierweiterung verwendet. Hierbei können auch Wildcards als Stern * verwendet werden, der Stern steht für ein beliebiges Zeichen.
 
|-
 
|-
 
| Remote-Passwort
 
| Remote-Passwort
 
| selbsterklärend
 
| selbsterklärend
| Das Quell Verzeichnis eine Passwort Authentifizierung benötigt, ist hier das Passwort für Remote-Pfad zu hinterlegen
+
| Wenn das Quellverzeichnis eine Passwort-Authentifizierung benötigt, ist hier das Passwort für den Remote-Pfad zu hinterlegen.
 
|-
 
|-
 
| Zuordnung Bestellungen
 
| Zuordnung Bestellungen
 
| selbsterklärend
 
| selbsterklärend
| Essentiell hierbei ist die Zuordnung der externe Bestellnummer, nach dieser Spalte werden die in der CSV Datei enthaltenen Bestellpositionen gruppiert
+
| Essentiell hierbei ist die Zuordnung der externen Bestellnummer, nach dieser Spalte werden die in der CSV-Datei enthaltenen Bestellpositionen gruppiert
 
|-
 
|-
 
| Zuordnung Bestell-Positionen  
 
| Zuordnung Bestell-Positionen  
Zeile 68: Zeile 68:
 
| Essentiell hierbei ist die Zuordnung der Artikelnummer in mention bzw. die EAN Nummer (ab mention®Connect 28.06.2018)
 
| Essentiell hierbei ist die Zuordnung der Artikelnummer in mention bzw. die EAN Nummer (ab mention®Connect 28.06.2018)
 
|-
 
|-
| '''Versandstatus''' (Achtung Idee und Spiel unterstützt keinen Versandstatus)
+
| '''Versandstatus''' (Achtung: Idee und Spiel unterstützt keinen Versandstatus)
| Definition der CSV Datei für den Versandstatus
+
| Definition der CSV-Datei für den Versandstatus
| Fügen Sie neue Spalten mit der '+' Schaltfläche zu, sollte die Position nicht stimmen, kann diese über das grüne Viereck verschoben werden  
+
| Fügen Sie neue Spalten mit der '+' Schaltfläche zu, sollte die Position nicht stimmen, kann diese über das grüne Viereck verschoben werden.
 
|-
 
|-
 
| '''Artikel-Export'''  
 
| '''Artikel-Export'''  
 
| selbsterklärend
 
| selbsterklärend
| Über diese Einstellungen können Artikel in ein lokales Verzeichnis / SFTP oder FTP Verzeichnis exportiert werden
+
| Über diese Einstellungen können Artikel in ein lokales Verzeichnis bzw. SFTP- oder FTP-Verzeichnis exportiert werden
 
[[Datei:CSV-Artikel-Export-Einstellung.PNG]]
 
[[Datei:CSV-Artikel-Export-Einstellung.PNG]]
 
|-
 
|-
 
| Artikel exp.  
 
| Artikel exp.  
 
| Aktiv / Inaktiv
 
| Aktiv / Inaktiv
| Ist die Einstellung aktiv, werden automatische Artikel exporte ausgeführt (Voraussetzung in Upload-Intervall wurde ein Zeitintervall hinterlegt)
+
| Ist die Einstellung aktiv, werden automatisch Artikelexporte ausgeführt (Voraussetzung: in Upload-Intervall wurde ein Zeitintervall hinterlegt)
 
|-
 
|-
 
| Wohin   
 
| Wohin   

Version vom 20. Mai 2020, 12:24 Uhr

mention®Connect - CSV - Schnittstelle - Funktionsumfang

  • Import von Bestellungen aus CSV Dateien.
    • Individuelle Spaltenzuordnung für Versand-, Rechnungsadresse sowie Positionsdaten.
    • Optional Überwachung von Verzeichnissen, gespeicherte Dateien werden sofort nach Eintreffen verarbeitet. Für die Aktivierung muss bei 'Interv. Bestellungen' eine Zahl größer 0 eingetragen werden
    • Importieren von CSV-Dateien von einem SFTP- / FTP-Server (optional)
    • Manueller Import mit einem Dateiauswahl-Dialog.
  • Export Versandbestätigungen als CSV-Datei
    • Ausgabe von Versandbestätigungen mit einem selbstdefinierten Format.
    • Achtung Spaltenüberschriften werden nicht exportiert
    • Für die Aktivierung muss innerhalb Upload-Intervall eine Zahl größer 0 eingetragen werden
  • Einstellungen können importiert und exportiert werden.
  • Export von Artikeldaten (seit dem 28.06.2018)
    • Formatierung der Ausgabe über XSLT
    • Export nach SFTP / FTP oder lokales Verzeichnis möglich
    • Derzeit mögliche Daten Netto, Brutto, Bestand, Artikelnummer (aranummer), EAN-Code (Products_ean), Name, herstellerName, ProductsStatus (Online / Offline)

Konfiguration

Einstellungen:

Feld Bedeutung oder Verwendungszweck Beispiel
Verz. Best. Das zu überwachende Verzeichnis Stellen Sie bitte sicher, dass Connect Schreibzugriff auf dieses Verzeichnis hat. Im autmatischen Betrieb werden zu verarbeitende Dateien in ein Unterverzeichnis Imported verschoben, um sicher zu stellen, dass die Datei nicht ein weiters Mal verarbeitet wird.
Datei Präfix selbsterklärend Es werden nur Dateien verarbeitet, die einem bestimmten Schema entsprechen. Hierbei handelt es sich um den vorangestellten Text. Beispiel 'order_', hierbei werden nur Dateien verarbeitet welche mit dem Text order_ beginnen.
Datei Extension Dateiendung Beispiel 'csv'
CSV-Datei selbsterklärend Wählen Sie hier eine Beispieldatei welche als Formatvorlage für das Einlesen der Bestellung dient. Nachdem die Datei ausgewählt wurde, werden die Zuordnungen generiert.
Spalten Trenner Wertetrennung innerhalb der CSV Datei Beispiel Inhalt ";" Nach einer Änderung des Trennzeichens werden die Zuordnungsdropdowns neu initialisiert, es kann vorkommen, dass Zuweisungen erneut vorgenommen werden müssen.
Text Qualifizierer selbsterklärend Es kommt vor, dass Textinhalte mit Anführungszeichen versehen sind.
Remote-Pfad optional wenn Dateien von einem SFTP / FTP Server heruntergeladen werden sollen sftp://username@example.com/Quell/Verzeichnis/ oder ftp://username@example.com/Quell/Verzeichnis/

wird die gefundenen Dateien in das Verzeihnis "Verz. Best." gespeichert.
Hinweis
Es wird für das Abrufen der Datei-Präfix wie auch die Dateierweiterung verwendet. Hierbei können auch Wildcards als Stern * verwendet werden, der Stern steht für ein beliebiges Zeichen.

Remote-Passwort selbsterklärend Wenn das Quellverzeichnis eine Passwort-Authentifizierung benötigt, ist hier das Passwort für den Remote-Pfad zu hinterlegen.
Zuordnung Bestellungen selbsterklärend Essentiell hierbei ist die Zuordnung der externen Bestellnummer, nach dieser Spalte werden die in der CSV-Datei enthaltenen Bestellpositionen gruppiert
Zuordnung Bestell-Positionen selbsterklärend Essentiell hierbei ist die Zuordnung der Artikelnummer in mention bzw. die EAN Nummer (ab mention®Connect 28.06.2018)
Versandstatus (Achtung: Idee und Spiel unterstützt keinen Versandstatus) Definition der CSV-Datei für den Versandstatus Fügen Sie neue Spalten mit der '+' Schaltfläche zu, sollte die Position nicht stimmen, kann diese über das grüne Viereck verschoben werden.
Artikel-Export selbsterklärend Über diese Einstellungen können Artikel in ein lokales Verzeichnis bzw. SFTP- oder FTP-Verzeichnis exportiert werden

CSV-Artikel-Export-Einstellung.PNG

Artikel exp. Aktiv / Inaktiv Ist die Einstellung aktiv, werden automatisch Artikelexporte ausgeführt (Voraussetzung: in Upload-Intervall wurde ein Zeitintervall hinterlegt)
Wohin Aktiv / Inaktiv Zielpfad Beispiel sftp://username@example.com/ziel/verzeichnis/catalog.csv oder sftp://username@example.com/ziel/verzeichnis/catalog.csv Es werden auch Datums-Platzhalter berücksichtigt. Zum Beispiel: catalog_{DateTime.Now.ToString("yyyy-MM-dd-hhmmss")}.csv Hinweise zur Datumsformatierung finden sie unter: https://docs.microsoft.com/de-de/dotnet/standard/base-types/custom-date-and-time-format-strings
Artikel-XSLT. Format für die Ausgabe der CSV Datei

Hinweis: Es wird nur xslt 1.0 unterstützt
https://de.wikipedia.org/wiki/XSL_Transformation

<xsl:stylesheet xmlns:xsl='http://www.w3.org/1999/XSL/Transform' version='1.0'>
<xsl:output method="text" encoding="utf-8"/>
<xsl:strip-space elements="*" /><xsl:template match="/">product-id-type<xsl:text>	</xsl:text>product-id<xsl:text>	</xsl:text>sku<xsl:text>	</xsl:text>item-price<xsl:text>	</xsl:text>condition-typ<xsl:text>	</xsl:text>quantity<xsl:text>&#xD;</xsl:text>
<xsl:for-each select="./ArrayOfProduct/Product">
<xsl:if test="Products_ean != ''">
EAN<xsl:text>	</xsl:text><xsl:value-of select='Products_ean'/><xsl:text>	</xsl:text><xsl:value-of select='aranummer'/><xsl:text>	</xsl:text><xsl:value-of select='Brutto'/><xsl:text>	</xsl:text>NEW<xsl:text>	</xsl:text><xsl:value-of select='Bestand'/><xsl:text>&#xD;</xsl:text>

    </xsl:if>
</xsl:for-each>
    </xsl:template>
</xsl:stylesheet>

Bitte beachten Sie die Zeilenumbrüche - Zeilen-Definitionen bitte nicht umbrechen
Richtig:

<xsl:value-of select='Products_ean'/><xsl:text>	</xsl:text><xsl:value-of select='aranummer'/>

Falsch (Artikelnummer in eine neue Zeile Umgebrochen)

<xsl:value-of select='Products_ean'/><xsl:text>	</xsl:text>
<xsl:value-of select='aranummer'/>

Beispielkonfiguration (ältere CSV Schnittstelle ohne Artikel-Export und Order-Import über einen Remote-Pfad)

Beispielkonfiguration. Hd39549-konfiguration.png