@ExtractOSFileFromNote

Kopiert eines oder mehrere File-Attachments, deren Namen oder Position(en) (siehe @AttachmentInfo) in TEXT/TEXTLIST/FN/FNLIST TEXT1/TEXTLIST1/FN1/FNLIST1 angegeben wird/werden, aus dem Dokument mit dem NOTEHANDLE NOTEHANDLE1 als Dateien auf ein Laufwerk bzw. einen OSPath.
Die @Funktion gibt eine NUMBERLIST zurück bei der die Elemente analog der Liste der zu extrahierdenden File-Attachments (TEXT1/TEXTLIST1/FN1/FNLIST1) auf 1 gesetzt werden wenn das File-Attachment als File erstellt werden könnte bzw. 0 wenn es nicht erstellt werden konnte.

Mit dem TEXT OPTIONS1 wird angegeben ob der TEXT/TEXTLIST TEXT2/TEXTLIST2 als Pfad ("P") für alle Dateien oder als FileName ("F") für das jeweils korrespondierende Element des vierten Parameters der @Funktion gelten soll.
Außerdem kann angegeben werden ob bestehende Files überschrieben werden sollen ("O") und ob nicht existierende Verzeichnisse erstellt werden sollen ("D").
Die Optionen können kombiniert werden (z.B. "POD" (Path/Overwrite/Directory Create oder "FO" File/Overwrite).

OPTIONS1:
P=Path
F=File
O=Overwrite
D=Directory create

Mit dem TD SINCE1 kann ein Zeitwert angegeben werden ab welcher File-Erstellungszeit ein File-Attachment extrahiert werden soll.
Soll ein File davon unabhängig extrahiert 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]).

TEXT1/TEXTLIST1:
Name(n) des/der zu extrahierenden angehängten Files.

FN1/FNLIST1:
Position(en) des/der zu extrahierenden angehängten Files in der Attechment-List.

TEXT2/TEXTLIST2:
Bei Option P:
OSPath an den die Files geschrieben werden sollen.
Bei Option F:
File-Names die die extrahierten Files auf der Platte haben sollen.

Beispiel: @ExtractOSFileFromNote(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);

SINCE1:=@AnyAllDay;
OPTIONS1:="FOD";
TEXT1:="Attach1.TST";
TEXT2:="C:\\TEST\\FILE1.TST";
AttRetList:=@ExtractOSFileFromNote(NOTEHANDLE1;OPTIONS1;SINCE1;TEXT1;TEXT2);

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

Es wird das File-Attachment (wenn möglich) mit dem Namen "Attach1.TST" aus dem Dokument mit dem NOTEHANDLE NOTEHANDLE1 als File "C:\\TEST\\FILE1.TST" angelegt.
Wenn es möglich war das File "C:\\TEST\\FILE1.TST" zu erstellen, ist das Ergebnis in AttRetList 1, sonst 0.
Das Erstellungsdatum des Files wurde nicht berücksichtigt (SINCE1:=@AnyAllDay).
Die OPTIONS1 ("FOD") bedeuten hier:
TEXT2 gilt als FileName, eine bestehende Datei gleichen Namens würde überschrieben und sollte ein Verzeichnis C:\TEST nicht existieren würde es angelegt.

Beispiel: @ExtractOSFileFromNote(NOTEHANDLE1;OPTIONS1;SINCE1;FN1;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);

SINCE1:=@AnyAllDay;
OPTIONS1:="FOD";
FN1:=1;
TEXT2:="C:\\TEST\\FILE1.TST";
AttRetList:=@ExtractOSFileFromNote(NOTEHANDLE1;OPTIONS1;SINCE1;FN1;TEXT2);

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

Es wird das File-Attachment (wenn möglich) mit der Position 1 in der Attachment-List aus dem Dokument mit dem NOTEHANDLE NOTEHANDLE1 als File "C:\\TEST\\FILE1.TST" angelegt.
Wenn es möglich war das File "C:\\TEST\\FILE1.TST" zu erstellen, ist das Ergebnis in AttRetList 1, sonst 0.
Das Erstellungsdatum des Files wurde nicht berücksichtigt (SINCE1:=@AnyAllDay).
Die OPTIONS1 ("FOD") bedeuten hier:
TEXT2 gilt als FileName, eine bestehende Datei gleichen Namens würde überschrieben und sollte ein Verzeichnis C:\TEST nicht existieren würde es angelegt.

Beispiel: @ExtractOSFileFromNote(NOTEHANDLE1;OPTIONS1;SINCE1;TEXTLIST1;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);

SINCE1:=@AnyAllDay;
OPTIONS1:="POD";
TEXTLIST1:="Attach1.TST":"Attach2.TST":"Attach3.TST";
TEXT2:="C:\\TEST";
AttRetList:=@ExtractDetachOSFileFromNote(NOTEHANDLE1;OPTIONS1;SINCE1;TEXTLIST1;TEXT2);

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

Es werden die File-Attachments (wenn möglich) mit den Namen "Attach1.TST","Attach2.TST" und "Attach3.TST" aus dem Dokument mit dem NOTEHANDLE NOTEHANDLE1 als Files "C:\\TEST\\Attach1.TST","C:\\TEST\\Attach2.TST" und "C:\\TEST\\Attach3.TST" angelegt.
Wenn es möglich war die Files zu erstellen, ist das Ergebnis in AttRetList 1:1:1, sonst 0:0:0.
Konnte z.B. nur das File "C:\\TEST\\Attach2.TST" nicht erstellt werden (die anderen schon) wäre das Ergebnis in AttRetList 1:0:1.
Das Erstellungsdatum der Files wurde nicht berücksichtigt (SINCE1:=@AnyAllDay).
Die OPTIONS1 ("POD") bedeuten hier:
TEXT2 gilt als OSPath, bestehende Dateien gleichen Namens würden überschrieben und sollte ein Verzeichnis C:\TEST nicht existieren würde es angelegt.

Beispiel: @ExtractOSFileFromNote(NOTEHANDLE1;OPTIONS1;SINCE1;FNLIST1;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);

SINCE1:=@AnyAllDay;
OPTIONS1:="POD";
FNLIST1:=1:4:5;
TEXT2:="C:\\TEST\\FILE1.TST";
AttRetList:=@ExtractDetachOSFileFromNote(NOTEHANDLE1;OPTIONS1;SINCE1;FNLIST1;TEXT2);

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

Es werden die File-Attachments (wenn möglich) mit den Positionen 1,4 und 5 in der Attachment-List aus dem Dokument mit dem NOTEHANDLE NOTEHANDLE1 als Files mit dem jeweiligen Attachment-Namen in das Verzeichnis "C:\\TEST" angelegt.
Wenn es möglich war die Files zu erstellen, ist das Ergebnis in AttRetList 1:1:1, sonst 0:0:0.
Konnte z.B. nur das File mit der Position 5 nicht erstellt werden (die anderen schon) wäre das Ergebnis in AttRetList 1:1:0.
Das Erstellungsdatum des Files wurde nicht berücksichtigt (SINCE1:=@AnyAllDay).
Die OPTIONS1 ("POD") bedeuten hier:
TEXT2 gilt als OSPath, bestehende Dateien gleichen Namens würden überschrieben und sollte ein Verzeichnis C:\TEST nicht existieren würde es angelegt.

Beispiel: @ExtractOSFileFromNote(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);

SINCE1:=@AnyAllDay;
OPTIONS1:="FD";
TEXTLIST1:="Attach1.TST":"Attach2.TST":"Attach3.TST";
TEXTLIST2:="C:\\TEST\\FILE1.TST":"C:\\TEST\\FILE2.TST":"C:\\TEST\\FILE3.TST";
AttRetList:=@ExtractDetachOSFileFromNote(NOTEHANDLE1;OPTIONS1;SINCE1;TEXTLIST1;TEXTLIST2);

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

Es werden die File-Attachments (wenn möglich) mit den Namen "Attach1.TST","Attach2.TST" und "Attach3.TST" aus dem Dokument mit dem NOTEHANDLE NOTEHANDLE1 als Files "C:\\TEST\\FILE1.TST","C:\\TEST\\FILE2.TST" und "C:\\TEST\\FILE3.TST" angelegt.
Wenn es möglich war die Files zu erstellen, ist das Ergebnis in AttRetList 1:1:1, sonst 0:0:0.
Konnte z.B. nur das File "C:\\TEST\\FILE2.TST" nicht erstellt werden (die anderen schon) wäre das Ergebnis in AttRetList 1:0:1.
Das Erstellungsdatum der Files wurde nicht berücksichtigt (SINCE1:=@AnyAllDay).
Die OPTIONS1 ("FD") bedeuten hier:
TEXTLIST2 gilt als FileNameListe, bestehende Dateien gleichen Namens würden nicht überschrieben (das File könnte nicht angelegt werden -> also 0 in der AttRetList) und sollte ein Verzeichnis C:\TEST nicht existieren würde es angelegt.

Beispiel: @ExtractOSFileFromNote(NOTEHANDLE1;OPTIONS1;SINCE1;FNLIST1;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);

SINCE1:=@AnyAllDay;
OPTIONS1:="FOD";
FNLIST1:=1:4:5;
TEXTLIST2:="C:\\TEST\\FILE1.TST":"C:\\TEST\\FILE2.TST":"C:\\TEST\\FILE3.TST";
AttRetList:=@ExtractDetachOSFileFromNote(NOTEHANDLE1;OPTIONS1;SINCE1;FNLIST1;TEXTLIST2);

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

Es werden die File-Attachments (wenn möglich) mit den Positionen 1,4 und 5 in der Attachment-List aus dem Dokument mit dem NOTEHANDLE NOTEHANDLE1 als Files "C:\\TEST\\FILE1.TST","C:\\TEST\\FILE2.TST" und "C:\\TEST\\FILE3.TST" angelegt.
Wenn es möglich war die Files zu erstellen, ist das Ergebnis in AttRetList 1:1:1, sonst 0:0:0.
Konnte z.B. nur das File mit der Position 5 nicht erstellt werden (FileName "C:\\TEST\\FILE3.TST") (die anderen schon) wäre das Ergebnis in AttRetList 1:1:0.
Das Erstellungsdatum des Files wurde nicht berücksichtigt (SINCE1:=@AnyAllDay).
Die OPTIONS1 ("FOD") bedeuten hier:
TEXTLIST2 gilt als FileNameList, bestehende Dateien gleichen Namens würde überschrieben und sollte ein Verzeichnis C:\TEST nicht existieren würde es angelegt.