@ReplicateWithFormula

Repliziert die Datenbank mit dem DBHANDLE DBHANDLE1 mit der Datenbank mit dem DBHANDLE DBHANDLE2, wobei nur die Dokumente repliziert werden, die der Notes-Kompatiblen Selection-Formula TEXT/TEXTLIST FORMULA3 entsprechen. Wenn für FORMULA3 eine TEXTLIST übergeben wird, wird das erste Elements als Selections-Formula für die DB mit dem DBHANDLE1 angewendet und das zweite Elements entsprechend für die DB mit dem DBHANDLE2. FNLIST FNLIST4 ist eine Liste mit Rechten bei der das erste Element die Rechte der Replizierung in der ersten Datenbank angibt und das zweite Element die Rechte in der zweiten Datenbank. Es ist nicht erforderlich daß die Datenbanken Repliken voneinander sind. In FN FNREPLICATIONFLAGS6 können Optionen im Replicator aktivieren oder deaktivieren.

Es wird eine FNLIST zurückgegeben:

Element   Bedeutung
1   UpdateCount DBHANDLE1
2   CreateCount DBHANDLE1
3   DeleteCount DBHANDLE1
4   UpdateCount DBHANDLE2
5   CreateCount DBHANDLE2
6   DeleteCount DBHANDLE2

FNLIST4:

Bit   HEX   Bedeutung
01   0001   Lesen
02   0002   Schreiben
03   0004   Ändern
04   0008   Löschen

Der optionale Parameter NOTECLASSES NOTECLASSES5 dient zur Einschränkung der Dokumente die in der Selection-Formula TEXT FORMULA3 berücksichtigt werden. Wird kein Parameter5 angegeben wird die Selection-Formula TEXT FORMULA3 auf Documente der NOTECLASS 1 (Documents) angewendet.

NOTECLASSES5:
DEC   BIT   Bedeutung

00000   XX   No Notes   keine Dokumente
00001   01   Documents   Daten-Dokumente
00002   02   Policy-Note   Über-DB-Dokument
00004   03   Form-Note   Masken-Design-Dokumente
00008   04   View-Note   Ansicht-Design-Dokumente
00016   05   Icon-Note   Piktogramm-Dokument
00032   06   Design-Collection-Note   Ansicht-Dokumente
00064   07   ACL-Info-Note   ACL-Info-Dokument
00128   08   Help-Index-Note   
00256   09   Help-Note   Hilfe-DB-Dokument
00512   10   Filter-Note   Macro-Design-Dokumente
01024   11   Feld-Note   Feld-Design-Dokumente
02048   12   Replication-Note   Replikations-Dokumente
04096   13   Privat_Design   Privat-Design-Dokumente

32768   16   Default-Note of Each   Von jedem das Vorgabe-Dokument

32767   01-15   Notes   Alle Dokumente
32766   02-15   All Non-Document-Notes   Alle nicht Daten-Dokumente

(Um mehrere Dokumenten-Klassen anzugeben werden die Werte der betreffenden Klassen addiert oder durch @BitVektor aufgebaut)

FNREPLICATIONFLAGS6:
Bit   HEX   Bedeutung
01   0001   Lokalisieren von Links (Doc;View;DB) in Datenbanken mit unterschiedlicher ReplicaID.
02   0002   Reserviert
03   0004   "NOTE changed during the REPLICATION process, …" Fehlermeldungen werden nicht ausgegeben.

FNLISTERROR7:
Bei Verwendung des optionalen Return-Parameter FNLISTERROR7, wird in diesem eine Error-Statistik zurückgegeben.

Element   Bedeutung
1   Error UpdateCount DBHANDLE1
2   Error CreateCount DBHANDLE1
3   Error DeleteCount DBHANDLE1
4   Error UpdateCount DBHANDLE2
5   Error CreateCount DBHANDLE2
6   Error DeleteCount DBHANDLE2

Beispiel: @ReplicateWithFormula(DBHANDLE1;DBHANDLE2;FORMULA3;FNLIST4)

DBHANDLE1:=@OpenDB("TESTRP1.NSF");
DBHANDLE2:=@OpenDB("TESTRP2.NSF");
FORMULA3:="SELECT Form=\"TEST FORM\"";
FNLIST4:=@BitVektor(1:2:3:4);
FNLIST4:=FNLIST4:FNLIST4;
@LogReport(@ReplicateWithFormula(DBHANDLE1;DBHANDLE2;FORMULA3;FNLIST4));
DBHANDLE2:=@CloseDB(DBHANDLE2);
DBHANDLE1:=@CloseDB(DBHANDLE1);

Es wird die Datenbank "TESTRP1.NSF" mit der Datenbank "TESTRP2.NSF" repliziert, und das Ergebnis ausgeben. Repliziert werden hierbei nur die Dokumente, die der Selection-Formula entsprechen.