@AttachOSFileToNote
Syntax
@AttachOSFileToNote(NOTEHANDLE1;OPTIONS1;SINCE1;TEXT1);
@AttachOSFileToNote(NOTEHANDLE1;OPTIONS1;SINCE1;TEXTLIST1);
@AttachOSFileToNote(NOTEHANDLE1;OPTIONS1;SINCE1;TEXT1;TEXT2);
@AttachOSFileToNote(NOTEHANDLE1;OPTIONS1;SINCE1;TEXTLIST1;TEXTLIST2);
Beschreibung
Hängt an das Dokument mit dem NOTEHANDLE NOTEHANDLE1 die Files deren OSPATH(s) in dem/der TEXT/TEXTLISTE TEXT1/TEXTLIST1 angegeben sind.
Wird ein/eine TEXT/TEXTLIST TEXT2/TEXTLIST2 angegeben, werden die File-Attachments nach diesem/dieser benannt.
Die @Funktion gibt eine NUMBERLIST zurück bei die Elemente analog der Liste der anzuhängenden Files (TEXT1/TEXTLIST1)
auf 1 gesetzt werden wenn das File angehängt werden könnte bzw. 0 wenn es nicht angehängt werden konnte.
Wird TEXT2/TEXTLIST2 nicht angegeben, wird als File-Attachment File-Name der Name des angehängten Files verwendet ohne Pfad- und Device-Angaben (z. B. C:\TESTDAT\FILE1.TST -> FILE1.TST).
Mit dem TEXT OPTIONS1 kann man Optionen zum Anhängen der Files bestimmen:
H=Kompression Huffman (default)
N=Keine Kompression
Mit dem TD SINCE1 kann ein Zeitwert angegeben werden ab welcher File-Erstellungszeit ein File angehängt werden soll.
Soll ein File davon unabhängig angehängt werden muß der Zeitwert den @AnyAllDay zurückgibt verwendet werden.
SINCE1 kann nicht eine Uhrzeit alleine sein, sondern muß ein Datum beinhalten
(Also nicht [10:30:50], wohl aber [10.10.92 10:30:50] oder [10.10.92]).
Beispiel: @AttachOSFileToNote(NOTEHANDLE1;OPTIONS1;SINCE1;TEXT1)
DBHANDLE1:=@OpenDB("TEST.NSF");
VIEWHANDLE1:=@OpenView(DBHANDLE1;"TEST VIEW");
VIEWPOSITION1:=1:1:1:0:0:0:0:0:0:0;
NOTEHANDLE1:=@OpenNoteByPosition(DBHANDLE1;VIEWHANDLE1;VIEWPOSITION1;NOTEHANDLE1);
OPTIONS1:="N";
SINCE1:=@AnyAllDay;
TEXT1:="C:\\FILE1.TST";
AttRetList:=@AttachOSFileToNote(NOTEHANDLE1;OPTIONS1;SINCE1;TEXT1);
NOTEHANDLE1:=@CloseNote(NOTEHANDLE1;0);
VIEWHANDLE1:=@CloseView(VIEWHANDLE1);
DBHANDLE1:=@CloseDB(DBHANDLE1);
Es wird das File (wenn möglich) C:\FILE1.TST als FILE1.TST an das Dokument mit dem NOTEHANDLE NOTEHANDLE1 angehängt.
Wenn es möglich war das File C:\FILE1.TST an das Dokument mit dem NOTEHANDLE NOTEHANDLE1 anzuhängen, ist das Ergebnis in AttRetList 1, sonst 0.
Das File wurde unkomprimiert angehängt (OPTIONS1:="N").
Das Erstellungsdatum des Files wurde nicht berücksichtigt (SINCE1:=@AnyAllDay).
Beispiel: @AttachOSFileToNote(NOTEHANDLE1;OPTIONS1;SINCE1;TEXTLIST1)
DBHANDLE1:=@OpenDB("TEST.NSF");
VIEWHANDLE1:=@OpenView(DBHANDLE1;"TEST VIEW");
VIEWPOSITION1:=1:1:1:0:0:0:0:0:0:0;
NOTEHANDLE1:=@OpenNoteByPosition(DBHANDLE1;VIEWHANDLE1;VIEWPOSITION1;NOTEHANDLE1);
OPTIONS1:="N";
SINCE1:=@AnyAllDay;
TEXTLIST1:="C:\\FILE1.TST":"D:\\FILE2.TST";
AttRetList:=@AttachOSFileToNote(NOTEHANDLE1;OPTIONS1;SINCE1;TEXTLIST1);
NOTEHANDLE1:=@CloseNote(NOTEHANDLE1;0);
VIEWHANDLE1:=@CloseView(VIEWHANDLE1);
DBHANDLE1:=@CloseDB(DBHANDLE1);
Es werden die Files (wenn möglich) C:\FILE1.TST und D:\FILE2.TST als FILE1.TST und FILE2.TST an das Dokument mit dem NOTEHANDLE NOTEHANDLE1 angehängt.
Wenn es möglich war die Files C:\FILE1.TST und D:\FILE2.TST an das Dokument mit dem NOTEHANDLE NOTEHANDLE1 anzuhängen, ist das Ergebnis in AttRetList 1:1, sonst 0:0.
War es nur möglich das File D:\FILE2.TST an das Dokument mit dem NOTEHANDLE NOTEHANDLE1 anzuhängen wäre das Ergebnis in AttRetList 0:1.
War es nur möglich das File C:\FILE1.TST an das Dokument mit dem NOTEHANDLE NOTEHANDLE1 anzuhängen wäre das Ergebnis in AttRetList 1:0.
Die Files werden unkomprimiert angehängt (OPTIONS1:="N").
Die Erstellungsdati der Files werden nicht berücksichtigt (SINCE1:=@AnyAllDay).
Beispiel: @AttachOSFileToNote(NOTEHANDLE1;OPTIONS1;SINCE1;TEXT1;TEXT2)
DBHANDLE1:=@OpenDB("TEST.NSF");
VIEWHANDLE1:=@OpenView(DBHANDLE1;"TEST VIEW");
VIEWPOSITION1:=1:1:1:0:0:0:0:0:0:0;
NOTEHANDLE1:=@OpenNoteByPosition(DBHANDLE1;VIEWHANDLE1;VIEWPOSITION1;NOTEHANDLE1);
OPTIONS1:="H";
SINCE1:=[10.10.92];
TEXT1:="C:\\FILE1.TST";
TEXT2:="ATTACH1.TST";
AttRetList:=@AttachOSFileToNote(NOTEHANDLE1;OPTIONS1;SINCE1;TEXT1;TEXT2);
NOTEHANDLE1:=@CloseNote(NOTEHANDLE1;0);
VIEWHANDLE1:=@CloseView(VIEWHANDLE1);
DBHANDLE1:=@CloseDB(DBHANDLE1);
Es wird das File (wenn möglich) C:\FILE1.TST als ATTACH1.TST an das Dokument mit dem NOTEHANDLE NOTEHANDLE1 angehängt.
Wenn es möglich war das File C:\FILE1.TST an das Dokument mit dem NOTEHANDLE NOTEHANDLE1 anzuhängen, ist das Ergebnis in AttRetList 1, sonst 0.
Das File wird im Huffman-Code komprimiert angehängt (OPTIONS1:="H").
Das File wird nur angehängt wen es nach dem 10.10.92 erstellt oder geändert wurde(SINCE1:=[10.10.92]).
Beispiel: @AttachOSFileToNote(NOTEHANDLE1;OPTIONS1;SINCE1;TEXTLIST1;TEXTLIST2)
DBHANDLE1:=@OpenDB("TEST.NSF");
VIEWHANDLE1:=@OpenView(DBHANDLE1;"TEST VIEW");
VIEWPOSITION1:=1:1:1:0:0:0:0:0:0:0;
NOTEHANDLE1:=@OpenNoteByPosition(DBHANDLE1;VIEWHANDLE1;VIEWPOSITION1;NOTEHANDLE1);
OPTIONS1:="N";
SINCE1:=@AnyAllDay;
TEXTLIST1:="C:\\FILE1.TST":"D:\\FILE2.TST";
TEXTLIST2:="ATTACH1.TST":"ATTACH2.TST";
AttRetList:=@AttachOSFileToNote(NOTEHANDLE1;OPTIONS1;SINCE1;TEXTLIST1;TEXTLIST2);
NOTEHANDLE1:=@CloseNote(NOTEHANDLE1;0);
VIEWHANDLE1:=@CloseView(VIEWHANDLE1);
DBHANDLE1:=@CloseDB(DBHANDLE1);
Es werden die Files (wenn möglich) C:\FILE1.TST und D:\FILE2.TST als ATTACH1.TST und ATTACH2.TST an das Dokument mit dem NOTEHANDLE NOTEHANDLE1 angehängt.
Wenn es möglich war die Files C:\FILE1.TST und D:\FILE2.TST an das Dokument mit dem NOTEHANDLE NOTEHANDLE1 anzuhängen, ist das Ergebnis in AttRetList 1:1, sonst 0:0.
War es nur möglich das File D:\FILE2.TST an das Dokument mit dem NOTEHANDLE NOTEHANDLE1 anzuhängen wäre das Ergebnis in AttRetList 0:1.
War es nur möglich das File C:\FILE1.TST an das Dokument mit dem NOTEHANDLE NOTEHANDLE1 anzuhängen wäre das Ergebnis in AttRetList 1:0.
Die Files werden unkomprimiert angehängt (OPTIONS1:="N").
Die Erstellungsdati der Files werden nicht berücksichtigt (SINCE1:=@AnyAllDay).
