Function DE Version 4.60

@OpenAttachedFile

Attachments Database Export Import Note

Syntax

@OpenAttachedFile(NOTEHANDLE1;FNATTACHMENTNUMBER2;MODE3);
@OpenAttachedFile(NOTEHANDLE1;TEXTATTACHMENTNAME2;MODE3);

Beschreibung

Öffnet das angehängte File mit der Attachment-Number FN FNATTACHMENTNUMBER2 oder mit dem internen (eindeutigen) Attachment-Namen TEXT TEXTATTACHMENTNAME2 und gibt einen OBJECTFILEHANDLE darauf zurück. Mit TEXT MODE3 kann der Modus des Öffnens bestimmt werden.

MODE2:
A=(Append)   Wird als Option aktzeptiert aber ignoriert.
B=(Binary)   Keine Umsetzung von CR in CRLF und umgekehrt (ist immer gesetzt)
C=(Create)    Wird als Option aktzeptiert aber ignoriert.
E=(Error)   Wird als Option aktzeptiert aber ignoriert.
R=(Read)   Öffnen zum Lesen von Daten (ist immer gesetzt)
T=(Text)   Wird als Option aktzeptiert aber ignoriert.
W=(Write)   Wird als Option aktzeptiert aber ignoriert.
Z=(Zero)   Wird als Option aktzeptiert aber ignoriert.
N=(No Cache)   Keinen Cache für dieses File benutzten (Bei komprimierten Object’s wird diese Option ignoriert)

Beipiel: @OpenAttachedFile(NOTEHANDLE1;FNATTACHMENTNUMBER2;MODE3);

DBHANDLE1:=@OpenDB("TESTDB\\TESTDB1.NSF");
NOTEID:=8450;
NOTEHANDLE1:=@OpenNoteByID(DBHANDLE1;NOTEID;NOTEHANDLE1);

FNATTACHMENTNUMBER2:=1;
MODE3:="RB";
OBJECTFILEHANDLE1:=@OpenAttachedFile(NOTEHANDLE1;FNATTACHMENTNUMBER2;MODE3);

READ_TEXT:=@ReadAttachedFile(OBJECTFILEHANDLE1;"A";10);
@LogReport(READ_TEXT);
OBJECTFILEHANDLE1:=@CloseAttachedFile(OBJECTFILEHANDLE1);

NOTEHANDLE1:=@CloseNote(NOTEHANDLE1;0);
DBHANDLE1:=@CloseDB(DBHANDLE1);

Es wird die DB mit dem OSPATH "TESTDB\\TESTDB1.NSF" geöffnet.
Es wird das Dokument mit der NOTEID 8450 geöffnet.
Das erste File-Attachment dieses Dokuments wird geöffnet.
Es werden die ersten 10 Byte dieses File-Attachment als TEXT ausgelesen und im APILOG ausgegeben.
Das File-Attachment wird wieder geschlossen.
Das Dokument wird wieder geschlossen.
Die DB wird wieder geschlossen.

Beipiel: @OpenAttachedFile(NOTEHANDLE1;TEXTATTACHMENTNAME2;MODE3);

DBHANDLE1:=@OpenDB("TESTDB\\TESTDB1.NSF");
NOTEID:=8450;
NOTEHANDLE1:=@OpenNoteByID(DBHANDLE1;NOTEID;NOTEHANDLE1);

TEXTATTACHMENTNAME2:="TEST.DAT";
MODE3:="RB";
OBJECTFILEHANDLE1:=@OpenAttachedFile(NOTEHANDLE1;TEXTATTACHMENTNAME2;MODE3);

READ_TEXT:=@ReadAttachedFile(OBJECTFILEHANDLE1;"A";10);
@LogReport(READ_TEXT);
OBJECTFILEHANDLE1:=@CloseAttachedFile(OBJECTFILEHANDLE1);

NOTEHANDLE1:=@CloseNote(NOTEHANDLE1;0);
DBHANDLE1:=@CloseDB(DBHANDLE1);

Es wird die DB mit dem OSPATH "TESTDB\\TESTDB1.NSF" geöffnet.
Es wird das Dokument mit der NOTEID 8450 geöffnet.
Das File-Attachment mit dem Namen "TEST.DAT", dieses Dokuments, wird geöffnet.
Es werden die ersten 10 Byte dieses File-Attachment als TEXT ausgelesen und im APILOG ausgegeben.
Das File-Attachment wird wieder geschlossen.
Das Dokument wird wieder geschlossen.
Die DB wird wieder geschlossen.