Close-DeliveryNote

EulandaXtools — Funktionsreferenz

Close-DeliveryNote

ÜBERSICHT

Bucht (schließt) einen Lieferschein über eine SQL-Prozedur, basierend auf ID oder Nummer.

SYNTAX

Close-DeliveryNote [[-DeliveryNoteId] <int>] [[-DeliveryNoteNo] <int>] [[-Conn] <__ComObject>]
    [[-Udl] <string>] [[-ConnStr] <string>] [<CommonParameters>]

BESCHREIBUNG

Die Funktion führt die Prozedur `dbo.cn_lfBuchen` in der EULANDA-Datenbank aus, um einen Lieferschein zu schließen (zu buchen). Als Identifikation kann entweder die Lieferschein-ID (`DeliveryNoteId`) oder die Lieferschein-Nummer (`DeliveryNoteNo`) verwendet werden.

Eine offene ADODB-Verbindung kann direkt übergeben werden (`Conn`) oder indirekt über eine UDL-Datei (`Udl`) oder einen Connection-String (`ConnStr`). Die Hilfsfunktion `Get-Conn` wird verwendet, um die Verbindung ggf. automatisch herzustellen.

Im Fehlerfall wird eine aussagekräftige Ausnahme geworfen. Die Verbindung bleibt erhalten.

PARAMETER

-DeliveryNoteId

Type: int

Die interne ID des Lieferscheins (Feld `lf_id`). Wenn gesetzt, wird diese bevorzugt verwendet.

-DeliveryNoteNo

Type: int

Die externe Lieferscheinnummer (Feld `lf_Nummer`). Nur erforderlich, wenn keine ID übergeben wird.

-Conn

Type: __ComObject

Optional: Eine bestehende, offene ADODB-Verbindung. Falls geschlossen, wird sie geöffnet.

-Udl

Type: string

Optional: Pfad zu einer UDL-Datei, aus der die Verbindung hergestellt wird, falls `Conn` nicht angegeben ist.

-ConnStr

Type: string

Optional: Connection-String zur Herstellung der Verbindung, falls weder `Conn` noch `Udl` angegeben sind.

AUSGABEN

None

Gibt bei Erfolg nichts zurück. Bei Fehlern wird eine Exception geworfen.

BEISPIELE

Close-DeliveryNote -DeliveryNoteId 1023 -ConnStr "Provider=SQLOLEDB;Data Source=SQL1;Initial Catalog=EULANDA;Integrated Security=SSPI"
Close-DeliveryNote -DeliveryNoteNo 300152 -Udl "C:\Verbindung\Eulanda.udl"

VERWANDTE LINKS

Get-Conn