Satzaufbau / Syntax (zusammengesetzter Ex- / Import)
Auf dieser Hilfe-Seite erfahren Sie mehr zum Satzaufbau / Syntax der zusammengesetzten Formel (zusammengesetzter Ex- / Import).
Diesen erreichen Sie über Registerkarte: DATEI - SCHNITTSTELLEN - IMPORT bzw. EXPORT. Für "Listen mit Positionen" stehen zusammengesetzte Exporte / Importe zur Verfügung.
In der Software erreichen Sie den Export- bzw. Import-Bereich alternativ auch über Registerkarte: START - Schaltfläche: SCHNITTSTELLEN.
Hinweis:
Die hier beschriebenen Beispiele richten sich an den Import - der Export ist analog hierzu zu sehen.
Kopfzeile (muss immer angegeben werden)
Satzaufbau / Syntax:
Beispiel für den Aufbau einer Kopfzeile (beispielhaft zum Verständnis):
- K;Vorgangsart;Adressnummer;Rechnungsanschrift ILN / GLN;Lieferanschrift ILN / GLN;Datum;
Die Formel wird folgenderma0en im Editor erfasst:
K;«Vog.Art»;«Vog.ReILN»;«Vog.Li.ILN»;«Vog.AdrNr»;«Vog.Dat»;
In der Formel wird durch das "K" der Segmentanfang der Kopfzeile definiert
Gefolgt von: der Vorgangsart, der Adressnummer, der Rechnungsanschrift ILN / GLN, der Lieferanschrift ILN / GLN und des Vorgangs-Datums.
Bitte beachten:
Am Ende (in der letzten Zeile) des Import-Layouts und in der Import-Datei muss ein SHIFT + ENTER stehen. So ist gewährleistet, dass für jeden neuen Datensatz ein Umbruch in der Textdatei existiert.
Erläuterungen der einzelnen Felder
| Feldbeschreibung | Bedeutung | Angabe |
|---|---|---|
| K | Definiert die Kopfzeile und muss als K angegeben werden | muss |
| Vorgangsart | Die Vorgangsart welche verwendet werden soll | muss |
| Adressnummer | Die Adressnummer des Kundens welche verwendet werden soll | muss |
| Rechnungsanschrift ILN / GLN | ILN / GLN der Rechnungsanschrift | kann |
| Lieferanschrift ILN / GLN | ILN / GLN der Lieferanschrift | kann |
| Datum | Vorgangdatum im Format: TT.MM.JJJJ | kann |
Beispiel für einen Import (mit Dummyfeld für im Import nicht benötigte Felder)
In diesem Beispiel soll eine existierende Import-Datei eingeladen werden, in welcher die Vorgangsart, Vorgangsadressnummer und das Datum eingeladen werden. Nicht benötigte Felder, die in der Import-Datei vorliegen, werden an den betroffenen Feldern im Import-Layout jeweils durch ein Dummy-Feld ersetzt.
Im Beispiel wurde die Export-Datei nach folgendem Muster erstellt:
K;«Vog.Art»;«Vog.ReILN»;«Vog.Li.ILN»;«Vog.AdrNr»;«Vog.Dat»; sowie SHIFT + ENTER am Ende der Formel.
Der erfolgte Export steht nun als Textdatei zur Verfügung mit folgendem Inhalt:
Rot hervorgehoben im Bild sind die Felder für ILN / GLN der Rechnungs- sowie Lieferanschrift. Diese sollen im Beispiel nicht importiert werden. In der Abbildung sind drei Datensätze zu sehen. Dabei sind die ILN / GLN-Felder in den ersten beiden Datensätzen befüllt, im dritten Datensatz sind die Felder für ILN / GLN leer.
- Import-Datei:
Die in der Import-Datei enthaltenen ILN /GLN -Felder zwischen der Adressnummer und dem Datum sollen für das Beispiel bewusst nicht übernommen werden.
Zur Erinnerung: Die Export-Datei war folgendermaßen aufgebaut:
K;«Vog.Art»;«Vog.ReILN»;«Vog.Li.ILN»;«Vog.AdrNr»;«Vog.Dat»;
- Import-Layout:
Um die beiden die ILN / GLN der Rechnungs- und Lieferanschrift in keinem Feld während des Imports zuzuordnen, können beim Import sogenannte "Dummy-Felder" eingefügt werden - diese werden an die Stelle platziert, an der das Feld vorhanden ist, welches nicht übernommen werden soll.
K;«Vog.Art»;«Vog.AdrNr»;«Dummy»;«Dummy»;«Vog.Li.ILN»;«Vog.Dat»;
- Hierdurch wird ein Vorgang mit der Vorgangsart "Rechnung I", für die Adressnummer: "10000" mit dem Vorgangsdatum: "01.10.2025" angelegt.
Rot hervorgehoben im Bild sehen Sie die beiden Dummy-Dateien, die für das Import-Layout eingesetzt wurden.
Werte, bei denen ein Dummy-Feld zugeordnet wurden, werden nicht beachtet / zugeordnet. Somit werden die beiden Felder für ILN / GLN bewusst beim Import ignoriert.
Datenzeile (optionale Angabe)
Satzaufbau / Syntax:
D;Artikelnummer;Menge;
Hier wird durch das "D" der Segmentanfang der Datenzeile definiert - gefolgt von: der Artikelnummer und der Menge.
Beachten Sie
Am Ende (in der letzten Zeile) des Import-Layouts und in der Import-Datei muss ein ENTER stehen.
Erläuterungen der einzelnen Felder
| Feldbeschreibung | Bedeutung | Angabe |
|---|---|---|
| D | Definiert die Datenzeile und muss als D angegeben werden | muss |
| Artikelnummer | Artikelnummer oder Barcode (EAN), welche bereits in der büro+ existiert | muss |
| Menge | Menge des Artikels | muss |
Beispiel
- Import-Layout:
D;«Vog.VPo.ArtNr»;«Vog.VPo.Mge»;
- Import-Datei:
K;Bestellung vom Kunden;10000;;;01.01.2024;
D;ArtikelNr1;5;
- Hierdurch wird ein Vorgang mit der Vorgangsart "Bestellung vom Kunden", für die Adressnummer: "10000" mit dem Vorgangsdatum: "01.01.2024" angelegt (Import-Layout für die Kopfzeile beachten).
- Außerdem wird eine Vorgangsposition mit der Artikel-Nummer: "ArtikelNr1" mit der Menge: "5" für diesen Vorgang eingefügt.
Fußzeile (optionale Angabe)
Satzaufbau / Syntax:
F;Vorgangs-Belegnummer;Vorgangsart;Gesamtpreis netto des Vorgangs;Gesamtpreis brutto des Vorgangs;
Hier wird durch das "F" der Segmentanfang der Fußzeile definiert - gefolgt von: der Vorgangs-Belegnummer, der Vorgangsart, des Gesamtpreises netto und des Gesamtpreises brutto.
Bitte beachten:
Am Ende (in der letzten Zeile) des Import-Layouts und in der Import-Datei muss ein ENTER stehen.
Erläuterungen der einzelnen Felder
| Feldbeschreibung | Bedeutung | Angabe |
|---|---|---|
| F | Definiert die Fußzeile und muss als F angegeben werden | muss |
| Vorgangsbelegnummer | Die Nummer welche als Belegnummer verwendet werden soll | kann |
| Vorgangsart | Die Vorgangsart welche verwendet werden soll (Hinweis: Ignoriert die Angabe aus der Kopfzeile bzgl. dessen Vorgangsart) | muss |
| Gesamtpreis (netto) des Vorgangs | Gesamtpreis des Vorgangs in netto | muss |
| Gesamtpreis (brutto) des Vorgangs | Gesamtpreis des Vorgangs in brutto | muss |
Beispiel
- Import-Layout:
F;«Vog.BelegNr»;«Vog.Art»;«Vog.GPreisNt»;«Vog.GPreisBt»;
- Import-Datei:
K;;10000;;;01.01.2024;
F;;Bestellung vom Kunden;100,00;119,00
- Hierdurch wird ein Vorgang mit der Vorgangsart "Bestellung vom Kunden", für die Adressnummer: "10000" mit dem Vorgangsdatum: "01.01.2024" angelegt (Import-Layout für die Kopfzeile und Datenzeile beachten).
- Außerdem wird eine Vorgangsposition mit der Artikel-Nummer: "ArtikelNr1" mit der Menge: "5" für diesen Vorgang eingefügt.