Stapel Leistungen importieren

Grundlegende Informationen zum Stapel finden Sie unter Stapel definieren.

Funktion:

MCS_MDLEISTUNGMGR_IMPORTLEISTUNGEN

Parameter:

Importdatei STP_IMP_FILENAME	Importdatei (besteht aus Pfad und Datei mit Dateiendung)
Erste Zeile ignorieren STP_IGNORE_FIRSTLINE	Soll die erste Zeile der Importdatei für den Import ignoriert werden (weil es sich um eine Überschriftenzeile handelt)? 1 = Ja, 0 oder leer = Nein
Trennzeichen STP_IMP_SEPARATOR	Mit welchem Zeichen werden die Werte in der Datei getrennt? (z. B. ; )
Protokolldatei schreiben STP_ERRORFILE_WRITE	Im Feld "Protokolldatei schreiben" wird die Möglichkeit aktiviert, nicht importierte Zeilen in eine Protokolldatei zu schreiben. Nach Korrektur der noch fehlerhaften Datensätze können Sie diese Datei einfach erneut importieren. Der Speicherpfad wird im nächsten Feld "Protokolldateiname" definiert. 1 = Ja, 0 oder leer = Nein
Protokolldateiname STP_ERRORFILE_NAME	Zusätzlich zum Feld "Protokolldatei schreiben" wird hier das Verzeichnis zum Speichern der Protokolldatei angegeben. Der Dateiname entspricht immer der Importdatei mit der Endung ".err". Der Name ist aber grundsätzlich frei wählbar. Nachdem die Endung wieder auf ".csv" abgeändert worden ist, kann der Import erneut stattfinden.
Datei - Aktion Umbenennen STP_RENAME_IMPORTFILE	Soll die Datei nach dem Importieren durch einen angefügten Datumswert umbenannt werden? (Originalname der Datei wird zu "Originalname-JJJJMMDDHHNN") 1 = Ja, 0 oder leer = Nein
Datei - Aktion Verschieben STP_MOVE_IMPORTFILE	Soll die Datei nach dem Importieren verschoben werden? 1 = Ja, 0 oder leer = Nein
Sicherungsverzeichnis, in das die Datei verschoben werden soll STP_MOVEPATH_AFTERIMPORT	Pfad, an den die Datei nach dem Import verschoben werden soll. Dieser Parameter ist nur dann relevant, wenn der Parameter STP_MOVE_IMPORTFILE auf 1 steht.
STP_IMP_USEMACROS	Dieser Parameter wird automatisch auf 1 gesetzt, wenn entweder im "Makro nach Lesen" und/oder im "Makro vor Schreiben" ein Makro hinterlegt wurde und führt dazu, dass dieses auch ausgeführt wird.
Makro nach Lesen STP_ATTR_MACRO_AFTER_READ	Hinterlegen Sie "Makro nach Lesen", welches nach dem Einlesen der Datensätze durch die Importschnittstelle ausgeführt werden soll. Dieses Makro wird je Datenzeile in der Importdatei ausgeführt. Die betroffene Zeile wird nur dann importiert, wenn als Result:=True; geliefert wird!
Makro vor Schreiben STP_ATTR_MACRO_BEFORE_WRITE	Hinterlegen Sie "Makro vor Schreiben," welches vor dem Schreiben der eingelesenen Datensätze aus der Importschnittstelle in die Datenbank ausgeführt werden soll. Dieses Makro wird je Datenzeile in der Importdatei ausgeführt. Die betroffene Zeile wird nur dann importiert, wenn als Result:=True; geliefert wird! Der Parameter enthält die ID des Makros.

Über den Import von offenen Leistungen besteht die Möglichkeit, Leistungen in die LEA zu importieren, die aus einem Fremdsystem regelmäßig oder einmalig geschrieben werden (Barauslagen aus Eingangsrechnungen etc.).

Details zur Funktion selbst finden Sie in der Themenhilfe Leistungen importieren (Datenübernahme / CSV-Import offener Leistungen).

Zum Startzeitpunkt des Stapels gibt es aufgrund der äußerst seltenen Verwendung keine Empfehlung.

Sollte beim Start die Datei nicht vorhanden sein, wird der Import abgebrochen. Jeder Aufruf wird in der Logdatei BMDBUERO.LOG mitprotokolliert. Nicht übernommene Datensätze durch fehlerhafte Importdatensätze werden wie beim manuellen Import in der Logdatei STDCSVIMPORT.LOG protokolliert.

Beispiel

Seitenanfang

Hinweis zur Feldauswahl

Für einen erfolgreichen Import der Leistungen ist sowohl die Reihenfolge der Felder in der CSV-Datei (siehe CSV-Datei aufbauen) als auch die dazu angepasste Feldauswahl ausschlaggebend.

Hierfür muss einmal die Funktion Leistungen importieren gestartet und dem Programm manuell über eine Feldauswahl bekannt gegeben werden, wie der Aufbau der CSV-Datei aussieht, d. h., welche Spalte der Datei welchem Leistungsfeld entspricht. Der Import muss hierbei nicht durchgeführt werden, da das Fenster der Funktion Leistungen importieren nur für die Hinterlegung der Feldauswahl geöffnet werden muss.

Die Zuordnung der Daten zum richtigen Feld wird also nicht über die Feldnamen in der ersten Zeile der CSV-Datei getroffen, sondern durch die Feldreihenfolge in der Feldauswahl. Diese kann entweder in der Vorschau mit rechter Maustaste auf die Spaltenüberschriften → Feldauswahl → Bearbeiten oder über die Schaltfläche "Feldauswahl" im linken unteren Bereich angepasst werden. Die Bearbeitung und das Speichern der Feldauswahl ist erst nach Auswahl einer Importdatei möglich. Zusätzlich erhalten Sie eine Vorschau der ersten Datenzeilen entsprechend der herangezogenen Feldauswahl.

Diese Feldauswahl muss anschließend global gespeichert werden, um für den Import der Leistungen über den Stapel herangezogen zu werden! Weitere Änderungen von bereits verwendeten globalen gepeicherten Feldauswahlen haben hierbei direkte Auswirkungen auf den Stapel.

Siehe auch:

Leistungen importieren (Datenübernahme / CSV-Import offener Leistungen)