4.4 DATEV: Integration - Datenquellen

4.4.1 Reportdatenquellen für die einzelnen DATEV-Exporte

Für jeden DATEV-Exporttyp ("Rechnungsexport", "Kundenexport", Umsatzexport") ist im DATEV-Nuclet eine Report-Datenquellenvorlage ("DATEV Client Billing Export", "DATEV Client Export", "DATEV Turnover Export") vorgesehen.

Diese Datenquellen müssen anwendungsspezifisch angepasst werden:

• einerseits an die tatsächlich genutzten Businessobjekte und Datenbanktabellen,
• anderseits an die im CSV-Export gewünschten bzw. benötigten Spalteninformationen.

Dabei ist zu beachten

1. Die Anzahl, die Reihenfolge und die Titel der vom SELECT zurückgegebenen Spalten sind beliebig.
2. Die Titel der Spalten werden so wie angegeben in die Export-CSV geschrieben (sofern der Export als "mit Titelzeile" konfiguriert wurde)
3. Die Pflichtparameter "date_from" und "date_until" beschreiben den zu exportierenden Zeitraum.
4. Es ist sinnvoll, bereits exportierte Datensätze zu markieren, so dass diese bei einem Folgeexport nicht erneut angezogen werden.
   
   

/**
 * Anmerkungen:
 *
 * - "intid_reference" ist ein Pflichtfeld, das der Zuordnung der Referenzobjekte zum DATEV-Export dient
 * - "date_from" und "date_until" sind Pflichtparameter zur Kennzeichnung des zu exportierenden Zeitraumes
 * - "datexportdatumdatev" ist das Export-Datum zur Kennzeichnung bereits exportierter Datensätze (s.o.)
 *
 */

SELECT 
    buchungsposition.intid "intid_reference",
    buchungsposition.datdatum "Datum",
    buchungsposition.strgegenkonto "Gegenkonto",
    buchungsposition.strkonto "Konto",
    buchungsposition.strbelegfeld "Belegfeld 1",    
    buchungsposition.dblumsatz "Umsatz",
    buchungsposition.strwaehrung "Währung",
	buchungsposition.strbuchungstext "Buchungstext"
FROM 
    em65_buchungsposition buchungsposition
WHERE
    buchungsposition.datdatum BETWEEN '$date_from' AND '$date_until'
AND buchungsposition.datexportdatumdatev IS NULL

Sourcecode 4.4.1: Beispielanpassung für die Datenquelle "DATEV Turnover"

4.4.2 Dynamische Entitäten je Exporttyp

Die Layouts für die DATEV-Exporte sind je Exporttyp konfiguriert. Die Layouts unterscheiden sich im abhängigen Unterformular "Referenzen", in dem sich die in einem Export enthaltenen Referenzobjekte (z.B. Rechnungen, Umsätze, Kunden) angezeigt werden können.

Für jeden DATEV-Exporttyp ("Rechnungsexport", "Kundenexport", Umsatzexport") ist dafür im DATEV-Nuclet ein Dynamisches Businessobjekt ("DATEV Client Billing References", "DATEV Client References", "DATEV Turnover References") vorgesehen.

Diese Datenquellen müssen anwendungsspezifisch angepasst werden:

• einerseits an die tatsächlich genutzten Businessobjekte und Datenbanktabellen,
• anderseits an die an der Anwendungsoberfläche anzuzeigenden Spalteninformationen.

Dabei ist zu beachten

1. Die Anzahl, die Reihenfolge und die Titel der vom SELECT zurückgegebenen Spalten sind beliebig.
2. Die Titel der Spalten werden, so wie es im SQL definiert ist, von der Anwendung angezeigt – das Anzeigeverhalten lässt sich aber auch im jeweiligen Layout anpassen.
3. Die Pflichtparameter "INTID_T_UD_GENERIC_OBJECT" und "INTID" müssen vorhanden sein, so wie es bei Dynamischen Businessobjekten üblich ist (siehe dazu den Abschnitt "Dynamische Businessobjekte" in der Nuclos-Wiki).

/** 
 * Anmerkungen:
 * 
 * - "INTID_T_UD_GENERICOBJECT" und "INTID" sind Pflichtfelder für Dynamische Entitäten (s.o.)
 * - Join zwischen Referenzobjekt "Buchungsposition" und "DATEV Information" erfolgt über Pflichtfeld "DATEV Information" (siehe Abschnitt 3)
 *
 */

SELECT     
    datevinformation.intid "INTID_T_UD_GENERICOBJECT",
    buchungsposition.intid "INTID",
    'Umsatz' "Typ",
    buchungsposition.datdatum "Datum",
    buchungsposition.strbelegfeld "Referenz",
    buchungsposition.dblumsatz "Betrag",
    buchungsposition.strwaehrung "Währung"
FROM 
    def_buchungsposition buchungsposition,
    def_datevinformation datevinformation
WHERE
    datevinformation.intid = buchungsposition.intid_strdatevinformation