DIE TECHNIK DAHINTER

Wie funktioniert
der SQLShipper?

Direkter Datenbankzugriff. Einfaches SQL-Mapping.
Alle Möglichkeiten von BarcodeShipping.

01 / DIE VERBINDUNG

Jede Datenbank.
Ein direkter Zugang.

Da BarcodeShipping eine JAVA-basierte Anwendung ist, kann diese mittels der JDBC-API auf jede beliebige Datenbank, welche über JDBC-Treiber verfügt, zugreifen und dort Operationen – sogenannte SQL-Statements – ausführen. Abhängig von den Befehlen können somit die Daten gelesen (select) oder geschrieben bzw. aktualisiert (insert / update) werden.

Auch Datenbanken, die lediglich über einen nativen oder einen ODBC-Treiber verfügen, können über entsprechende „JDBC ODBC Bridge Driver“ bzw. „Partial Java JDBC Driver“ erreicht und angebunden werden.

Sogar Systeme, deren Datenbank z.B. lediglich über eine Middleware zugreifbar ist, können über „Pure Java JDBC Driver“ verknüpft werden.

JDBC-Anbindung: JDBC-ODBC Bridge, Partial Java Driver, Pure Java Driver und JDBC Driver im Vergleich
Die verschiedenen Wege der JDBC-Datenbankanbindung
02 / DAS MAPPING

Ihre Daten. Richtig zugeordnet.

Ist der JDBC Datenbankzugriff erst definiert, können Sie nun Abfragen mittels des SQLShippers an Ihre Datenbank senden.

Im Prinzip funktioniert jede Abfrage an Ihre Shop-Datenbank per SQL-Befehl, bei dem die Inhalte – auch kombinierte – auf das entsprechende Attribut in BarcodeShipping gemappt werden:

SQL-Mapping
SELECT ID AS orderID, …, strasse AS shipToStreet
FROM Customers;
03 / DIE SQL-STATEMENTS

Fünf Statements.
Ein vollständiger Versandprozess.

Es stehen hierzu 5 verschiedene Typen von SQL-Statements im SQLShipper zur Verfügung, die im Folgenden beschrieben werden.

01

PreviewQuery

Über die „PreviewQuery“ können Sie per einfachem SQL-Statement Auftragsdaten aus Ihrer ggf. proprietären Shop-Datenbank ins BarcodeShipping holen und zur Anzeige bringen.

Bsp. „previewQuery“:
previewQuery
SELECT df_empfstat
              || ‚-‚
              || df_niederlas
              || ‚-‚
              || df_datauftannahme
              || ‚-‚
              || df_lfdnrauftrag                       AS orderid,
       df_pod                                          AS ordernumber,
       df_empfname1                                    AS shiptoname,
       l.df_lkz_iata                                   AS shiptocountry,
       ’processing‘                                AS status,
       df_datauftannahme                               AS orderedat,
       df_datauftannahme                               AS createdat,
       df_niederlas                                          AS paymentmethod,
       df_pod_reference ex_hwb from “dba“.tb_auftragsdaten    aleft
JOIN   dba.tb_laender lon a.df_empflkz = l.df_lkzwheredf_datauftannahme > CONVERT(date, now() – 1 )
AND    df_niederlas = ‚cas’and df_pod_reference IS NULL
AND    df_auftrags_status IN (3,1)
AND    df_empfstat   IN ( ‚r03‘)
AND    l.df_lkz_iata != ‚kv’“
02

OrderQuery

Mit der „OrderQuery“ können Sie über einen weiteren SQL-Befehl die Daten einzelner Bestellungen aus Ihrem Auftragsvolumen einsehen und zur Verarbeitung innerhalb BarcodeShippings nutzen.

Bsp. „orderQuery“:
orderQuery
SELECTDF_NDL || ‚-‚ || df_datauftannahme || ‚-‚ || df_lfdnrauftrag AS ordernumber,df_pod AS orderid,df_pod ||
(
       SELECT char(13)
                     || ‚mfr-‚
                     || z.df_nr_ausfuhranmeldung
       FROM   dba.tb_zolldaten z
       WHERE  a.df_datauftannahme = z.df_datauftannahme
       AND    a.df_lfdnrauftrag = z.df_lfdnrauftrag
       AND    a.df_niederlas = z.df_niederlas ) AS ‚reference‘,’processing‘ AS status,df_niederlas AS paymentmethod, ‚eur‘ AS currency,df_empfname1 AS shiptofirstname,df_empfname2 AS shiptomiddlenme, df_empfname3 AS shiptolastname,l.df_lkz_iata AS shiptocountry,df_empfstr AS shiptostreet,df_empfhnr AS shiptohousenumber,df_empfhnrzusatz AS shiptoadditionallines, df_empfplz AS shiptopostcode,df_empfort AS shiptocity,df_ruf_empf AS shiptophone FROM dba.tb_auftragsdaten a LEFT JOIN dba.tb_laender l ON a.df_empflkz = l.df_lkz where df_datauftannahme > CONVERT(date, now() – 30 )
AND
df_niederlas = ‚cas‘
AND
df_pod_reference IS nulland df_auftrags_status IN (3,
                                              1)
AND
df_empfstat IN (‚r01‘,
                ‚r03‘)
AND
df_pod = :orderId“
03

ItemQuery

Mittels dem SQL-Befehl in der ItemQuery können Sie wiederum einzelne Items aus einer Bestellung anzeigen und verarbeiten.

Bsp. „itemQuery“:
itemQuery
SELECT ‚1‘                               AS itemid,
       ’1′                               AS sku,
       ‚123‘                             AS ean,
       a.df_inhalt                           AS NAME,
       ‚de‘                              AS country,
       ’123456789′                       AS commoditycode,
       a.df_warenwert                        AS price,
       Replace(a.df_real_kg,‘,‘,‘.‘) AS weight,
       a.df_anzpack                          AS quantityinvoiced,
       a.df_anzpack                          AS quantityordered,
       ‚0‘                               AS quantityshipped from “dba“.tb_auftragsdaten a where df_datauftannahme > CONVERT(date, now() – 30 )
AND    df_niederlas = ‚cas’and df_pod_reference IS nulland df_auftrags_status IN (3,1)
AND    df_empfstat                                                     IN (‚r01‘,
                                                                           ‚r03‘)
AND    df_pod = :orderId“IGNOREGENERATEDKEYS: true
04

UpdateOrderStatement

Damit Informationen wie z.B. die Trackingnummer zu einer Bestellung an die gewünschte Stelle Ihrer Datenbank zurückgeschrieben wird, steht das „UpdateOrderStatement“ zur Verfügung. Somit werden die benötigten Versandinformationen auch in Ihrem Shopsystem verfügbar gemacht.

Bsp. „updateOrderStatements“:
updateOrderStatements
UPDATE „dba“.tb_auftragsdaten
SET    df_pod_reference = :shipment.trackingnumber
WHERE  df_pod = :orderId
AND    df_niederlas

              || ‚-‚
              || df_datauftannahme
              || ‚-‚
              || df_lfdnrauftrag = :orderNumber
AND    df_niederlas = ‚cas‘
AND    df_pod_reference IS NULL
AND    df_auftrags_status IN (3,1)
AND    df_empfstat   IN (‚r01‘,
                         ‚r03‘)“UPDATEORDERITEMSTATEMENTS: []
05

OrderItemUpdateStatement

Kann frei formuliert und genutzt werden, um ein UPDATE oder INSERT Statement auszuführen. Beispielsweise, um den Bestand eines Artikels oder den Versandstatus zu aktualisieren.

Beispielkonfiguration SQLShipper innerhalb BarcodeShippings:
OrderItemUpdateStatement
UPDATE kbestellpositionen
SET    shipped_qantity = :item.quantitycomplete
WHERE  bestellpost_id = :item.id
DER NÄCHSTE SCHRITT

Anleitung gesucht?

Dann klicken Sie doch gerne hier!

Zur Anleitung