mirror of
https://github.com/OpenXE-org/OpenXE.git
synced 2024-12-25 14:10:28 +01:00
25 lines
5.8 KiB
Plaintext
25 lines
5.8 KiB
Plaintext
<h1>Belege Importer</h1><p>Die App Belege Importer erlaubt es Ihnen, alte Belege (Aufträge, Lieferscheine, Rechnungen usw.) per CSV zu Xentral zu importieren. Die App Belege Importer arbeitet mit einem Prozessstarter. Damit der Import klappt, muss der Prozessstarter ausgeführt werden.</p><h2>Allgemeines</h2><p>Unter Administration → AppStore → Belege Importer finden Sie eine Anwendung, mithilfe der Sie unterschiedliche Dokumente in Xentral hochladen können:</p><ul><li>Angebote</li><li>Aufträge</li><li>Lieferscheine</li><li>Rechnungen</li><li>Gutschriften</li><li>Preisanfragen</li><li>Bestellungen</li><li>Produktionen</li><li>Proformarechnungen</li><li>Adressen (Dafür ist aber die <strong>"Import/Export Zentrale"</strong> auch geeignet)</li></ul><p>Wenn Sie die App aufrufen, gelangen Sie in die folgende Startansicht:<br /><a href="./index.php?module=dateien&action=send&id=4766"><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=belegeimport&fileid=4766" style="width: 1000px; height: 370px;" /></a><br />Im oberen Bereich "Datei importieren" können Sie:</p><ul><li>auswählen, welche Datei Sie hochladen möchten (1)</li><li>auswählen, welche Belegart Sie hochladen möchten (2)</li><li>festlegen, welchen Status Ihr Beleg erhalten soll (3)</li><li>über den Button den Upload Ihrer Dokumente veranlassen (4)</li><li>den Zwischenspeicher leeren, falls Sie Ihre Belege doch nicht mehr hochladen möchten bzw. Änderungen daran vornehmen möchten (5)</li><li>Falls der Prozessstarter nicht aktiv sein sollte, erscheint dies in einer Info-Box (6)</li></ul>Der Import läuft in zwei Schritten. Zunächst werden alle Daten in einer Zwischentabelle gespeichert. Diese Daten können im Anschluss noch einmal geprüft werden, wobei Abweichungen in z.b. der Adresse rot dargestellt werden. Um die Daten entgültig ins System zu schreiben muss man den Button "Import starten" drücken:<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=belegeimport&fileid=4767" style="width: 1000px; height: 472px;" /><h2>Formate</h2><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=belegeimport&fileid=4768" style="width: 1000px; height: 509px;" /><p>Im Reiter <strong>"Formate"</strong> finden Sie eine Aufstellung über alle importierbaren Felder mit einer Kurzbeschreibung. Die exakten Feldnamen müssen in der ersten Zeile Ihrer Datei auch als Spaltenüberschriften enthalten sein, wobei für jede Position des Belegs eine neue Zeile benötigt wird.<br />Im Folgenden werden die Pflichtangaben nochmal kurz erklärt:</p><ul><li><strong>beleg_belegnr:</strong> Die Belegnummer, für Spezialverhalten, siehe <strong>NEW</strong></li><li><strong>beleg_kundennummer:</strong> Kundennumer, mit der Ihr Beleg verknüpft wird</li><li><strong>artikel_nummer:</strong> Artikelnummer der Position</li><li><strong>artikel_bezeichnung:</strong> Bezeichnung der Position</li><li><strong>artikel_menge:</strong> Mengenangabe der Position</li><li><strong>artikel_preis:</strong> Preis dieser Position</li></ul><p>Beachten Sie bitte, dass beim Import keinesfalls Änderungen an Stammdaten vorgenommen werden, d.h. weder an den Stammdaten der Artikel noch der Adressen. Entsprechend werden Ihnen Abweichungen von den Stammdaten in rot angezeigt, sodass Sie diese wahlweise korrigieren können oder beibehalten, wobei dann eine Übernahme ausschließlich für die importierten Belege gilt. Haben Sie einmal Ihre Datei hochgeladen, können Sie sich in der Übersicht ansehen, ob alles so erkannt und zugeordnet wird, wie Sie sich das vorgestellt hatten, bevor Sie anschließend auf den Button "Belege jetzt importieren" klicken.</p><h2>Schlüsselworte</h2><p>Der Belegimporter unterstützt zusätzlich zwei Schlüsselworte für dynamische Belegnummern.</p><h3>NEW</h3><p>Das Schlüsselwort NEW erzeugt bei jedem Vorkommen eine neue fortlaufende Belegnummer basierend auf der Art des Imports. <strong>WICHTIG:</strong> Nachdem eine Zeile mit NEW vorkommt, sollte für die restliche Datei keine Zeilen mit statischer Belegnummer mehr folgen. In sehr ungünstigen Fällen könnte es sonst dazu führen, dass Artikel auf den falschen Beleg gebucht werden. Wenn der Status 'angelegt' gesetzt ist, wird jede Belegnummer die nicht PARENT ist als NEW betrachtet. Die hierbei vergebenen (ENTWURF_X_) Belegnummern sind jedoch nur temporär und dienen der Zuordnung der einzelnen Artikel. Beim tatsächlichen Import werden die Belegnummern anschließend verworfen.</p><h3>PARENT</h3><p>Das Schlüsselwort PARENT übernimmt die Belegnummer aus der vorherigen Zeile. Dadurch ist es möglich Artikel zu Belegen zu gruppieren, selbst wenn diese noch keine Belegnummer haben. Sollte die erste Zeile der CSV Datei die Belegnummer PARENT haben, wird sie als NEW betrachtet und eine neue Belegnummer wird erstellt.</p><p><strong>Beispiel:</strong></p>beleg_belegnr;beleg_kundennummer;artikel_bezeichnung;artikel_nummer;artikel_preis;artikel_menge<pre>123;999;Artikel 1; 101; 1; 1
|
|
124;999;Artikel 2; 102; 1; 1
|
|
PARENT;999;Artikel 3; 103; 1; 1
|
|
125;999;Artikel 4; 104; 1; 1
|
|
NEW;999;Artikel 5; 105; 1; 1
|
|
NEW;999;Artikel 6; 106; 1; 1
|
|
PARENT;999;Artikel 7; 107; 1; 1
|
|
PARENT;999;Artikel 8; 108; 1; 1
|
|
NEW;999;Artikel 9; 109; 1; 1
|
|
PARENT;999;Artikel 10; 110; 1; 1</pre><p><strong>Erzeugt folgende Struktur:</strong></p><pre>123
|
|
-Artikel 1
|
|
124
|
|
-Artikel 2
|
|
-Artikel 3
|
|
125
|
|
-Artikel 4
|
|
30001
|
|
-Artikel 5
|
|
30002
|
|
-Artikel 6
|
|
-Artikel 7
|
|
-Artikel 8
|
|
30003
|
|
-Artikel 9
|
|
-Artikel 10</pre> |