Beschreibung:
Fügt einen neuen relationalen Datensatz mit einer Datei hinzu. Die Datei wird in das erste gefundene Dokumentenfeld der relationalen Ansicht geschrieben. Alle weiteren Felder werden ignoriert.
Dokumentenfelder: (eingebettete) Datei, (eingebettete) Grafik oder DMS Dokument.
Parameter:
|
Parametername |
Typ |
Beschreibung |
|
oRecord |
Objekt |
Datensatz-Objekt, zu dem ein relationaler Datensatz angehängt werden soll, z. B. Firmen |
|
oRelation |
Objekt |
Relations-Objekt, in dem der neue relationale Datensatz mit der angehängten Datei eingefügt wird. |
|
sFile |
String |
Datei, welche hinzugefügt werden soll (gesamter Pfad + Dateiname). |
|
sDocDescriptionCfg |
String |
Dateiendung der zu verwendeten Dokumentenkonfiguration oder mit | getrennte Dokumentenkonfigurationsbezeichnung, welche in der Konfiguration der Dokumentenverwaltung angeben wurde, z. B. msg oder msg|E-Mails |
Rückgabewert:
Record
|
Wert |
Beschreibung |
|
Record |
Gültiges Record-Objekt. Kann mit If oObject Is Nothing Then überprüft werden. |
|
NULL |
Ungültiges Record-Objekt. Der relationale Datensatz mit der angefügten Datei konnte nicht erstellt werden. |
Wichtig: Das zurückgelieferte Record-Objekt muss unbedingt wieder freigeben werden (Set oObject = Nothing setzen), um den Speicher freizugeben!
Wenn der erzeugte Dokumentendatensatz zwar erzeugt, aber in der Tabelle anschließend nicht wiedergefunden werden konnte (z. B. aufgrund eines "INSTEAD OF INSERT"-Triggers), dann liefert die Methode kein Record-Objekt zurück, die Ablage hat jedoch im engeren Sinne "geklappt". Dieser spezifische Umstand kann per LastError.ErrorCode=1 und LastError.NativeErrorCode=1003 erkannt werden, wenn der Rückgabewert kein Record-Objekt liefert.