Exportieren von ONIX-Dateien

Inhalt

Manuell

Einzelner Export

Über die Detailseite eines Produkts (nur in den Stammdaten) ist es möglich, über das Dropdownmenü (Onix-Datei-Download) eine ONIX-Datei mit einem der verfügbaren Profile (Onixempfänger) zu erstellen. Die in der Liste verfügbaren Onixempfänger sind in der Tabelle ERPSERVICE.ONIXEMPFAENGERENTITY definiert (auf die Spalte "VISIBLE" achten)

Massenexport

Neben dem einzelnen Export ist es auch möglich, mehrere Produkte innerhalb einer ONIX-Datei zu exportieren. Wie auch bei anderen Exporten ist diese Option sowohl über die erweiterte Suche, als auch über die Merkliste möglich:

Direkter Versand von Onix-Dateien an VLB/Amazon

Ab sofort ist es im ERP möglich, Onix-Exporte für VLB und Amazon direkt beim Export auf dem jeweiligen Server des Empfängers abzulegen. Dazu kann über die Merkliste oder die erweiterte Stammdatensuche im Export-Dialog der Punkt "Exportieren und versenden" gewählt werden:

Daraufhin werden die Versand-Ziele in einem zusätzlichen Dialog angezeigt:

Wählen Sie den betreffenden Server aus und klicken noch einmal auf "Exportieren und versenden", wird die Onix-Datei wie gewohnt erstellt und sofort auf dem Ziel-Server abgelegt.

Hinweis: Beim VLB gibt es zwei Versand-Ziele, da Michelin-Titel auf einen separaten Account hochgeladen werden müssen:

Achten Sie bitte selbstständig darauf, das richtige Versand-Ziel zu wählen.

Durch diese Funktionalität ist es nicht mehr nötig, beispielsweise Amazon-Onix-Dateien erst an den IT-Service zu senden, damit sie durch die IT hochgeladen werden.

Die Versandmöglichkeit ist aktuell freigeschaltet für folgende Abteilungen:
- Verlagsservice
- eCommerce
- IT

Automatisch über die Schnittstelle

Anders als beim manuellen ONIX-Export, wird der automatische ONIX-Export nicht über die Benutzeroberfläche sondern über einen GET-Request auf eine URL initiert.

Die Definitionen befinden sich unter /erp-storage/export/service in Form von XML-Dateien. Der folgende Codeblock zeigt die Definition "GuU_Amazon_Ratgeber.xml":

<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<!-- Definition für ExportService -->

<ExportServiceDefinition>
	<ExportHandlerClass>de.guu.erp.onix.OnixExportHandler</ExportHandlerClass>
	<EntityClass>de.guu.erp.persistence.produkt.ProduktEntity</EntityClass>
	<MandantId>7</MandantId>
	<ExportVorlageType>STAMMDATEN</ExportVorlageType>
	<ExportVorlage>Amazon (Onix 3.0)</ExportVorlage>
	<JpqlSelection>SELECT e FROM ProduktEntity e WHERE SQL('? IN (SELECT PRODUKT_ID FROM VW.ONIX_SELEKTION_GUU_RATGEBER)', e.id)</JpqlSelection>
</ExportServiceDefinition>


  • ExporthandlerClass: Definiert den zu nutzenden ExportHandler. Es existieren folgende ExportHandler
    • OnixExportHandler
    • CsvExportHandler
    • DokumentExportHandler
    • ExcelExportHandler
    • PdfExportHandler
  • EntityClass: Definiert den Objekttypen der Datei
  • MandantId: Mandant, für den diese Exportdefinition gilt
    • 7: Gräfe und Unzer
    • 3: Hoffmann und Campe
    • 6: Hatje Cantz
  • ExportVorlageType: Enum, dass die Art der Vorlage definiert. Folgende Typen sind verfügbar:
    • STAMMDATEN
    • HERSTELLUNG
    • KALKULATION
    • TITELUEBERSICHT
    • KUNDEN
  • ExportVorlage: Name der Exportvorlage
  • JpqlSelection: JPQL-Query der Exportselektion (welche Produkte/Titel exportiert werden sollen)


Das folgende Diagramm zeigt, durch welche Klassen und Methoden der Datenfluss läuft:

Logik ProductAvailability

Onix 3.0

Weitere Informationen: