@GetDominoUsers

Diese @Function liest die angegebenen Felder TEXT/TEXTLIST FIELDLIST für alle im Domino Directory des angegebenen Domino-Servers TEXT SERVER registrierten Benutzer aus.
Die zurückgegebenen Feldwerte werden als TEXTLIST oder HUGETEXTLIST bereitgestellt. Dabei werden die Werte der angeforderten Felder eines Benutzerdokuments jeweils zu einem Listenelement zusammengefasst und durch den angegebenen Trennstring voneinander getrennt.

TEXT SERVER:
Hier wird der abzufragende Server angegeben. Für den lokalen Server einen Leerstring ("") angeben.

TEXT/TEXTLIST FIELDLIST:
Dieser Parameter bestimmt die abzufragenden Felder aus den Personen-Dokumenten aus den Adressbüchern der abgefragten Servers.
Die Felder müssen im Adressbuch-Dokument den Datentyp TEXT oder TEXTLIST aufweisen, Felder mit anderen Datentypen werden als Leerstring ("") interpretiert. Bei einem TEXTLIST-Feld wird jeweils nur das erste Element zurückgegeben.
Beispiele:
FullName, ShortName, FirstName, MiddleInitial, LastName, AltFullName, AltFullNameLanguage, InternetAddress, MailServer, MailFile, MailDomain, MailSystem, MailAddress, MessageStorage, …

FN LOOKUPFLAGS:
DEC   BIT   Bedeutung
0001   01   Liefert alle Einträge in der Ansicht zurück.
0002   02   Beschränkt die Suche auf die erste Names-Datenbank mit der angegebenen Ansicht. Weitere Names-Datenbanken werden nicht berücksichtigt, auch wenn dort ein Treffer vorhanden wäre.
0032   06   Die Suche wird nach dem ersten Treffer nicht beendet, sondern nach weiteren passenden Einträgen fortgesetzt.
0256   09   Stellt sicher, dass die verwendeten Namespaces (Ansichten) vor der Suche auf den aktuellen Stand gebracht werden.
Um mehrere Flags anzugeben werden die Werte der betreffenden Flags addiert oder durch @BitVektor aufgebaut.
Der Default ist 33 (Bits 01, 06).

TEXT RETDATATYPE:
Hier wird der gewünschte Rückgabe-Datentyp angegeben.
TL   TEXTLIST (default)
HTL   HUGETEXTLIST

TEXT SEPERATORSTRING:
Hier wird der Trennstring für die Abgrenzung der angeforderten Felder angegeben.
Der Default-String ist ein Komma ",".
Beispiel:
Es werden FullName und MailServer angefordert, dann kann ein Element wie folgt aussehen (mit dem Default-Trennzeichen Komma):
CN=Max Mustermann/O=ACME/C=DE,CN=MAIL-SERVER-01/O=ACME/C=DE

TEXT VIEWNAME:
Hier wird der Name der Ansicht angegeben, die in den Adressbüchern als Quelle genutzt werden soll.
Der Default ist "$People", es kann aber auch eine andere Ansicht, wie z.B. "$Users" genutzt werden.

Als Return-Wert liefert die @Function bei einem Fehler @ERROR andernfalls eine Liste mit den angeforderten Feldern im gewünschten Datentyp zurück.

Beispiel: @GetDominoUsers(SERVER;FIELDLIST;LOOKUPFLAGS;RETDATATYPE;SEPERATORSTRING;VIEWNAME);

SERVER:="";
FIELDLIST:="FullName":"MailServer";
LOOKUPFLAGS:=1;
RETDATATYPE:="TL";
SEPERATORSTRING:="##";
VIEWNAME:="$People";
RET:=@GetDominoUsers(SERVER;FIELDLIST;LOOKUPFLAGS;RETDATATYPE;SEPERATORSTRING;VIEWNAME);
@LogReport(@Implode(RET;@Newline);3);

Es werden auf dem lokalen Server in der Ansicht "$People" alle Dokumente abgefragt und die Felder FullName und MailServer angefordert.
Der Rückgabe-Datentyp ist TEXTLIST und das Trennzeichen für die Felder eines Dokuments ist "##".
Das Ergebnis der Abfrage wird im APILOG ausgegeben.