Undocument Command Documented: ExpandNameList

[eknori]

via Chris Toohey: http://www.dominoguru.com/pages/01202009030630.html

@ExpandNameList

Example

The following Formula returns a list of SMTP Email Addresses for the members of the "LocalDomainAdmins" Group.

~names := @ExpandNameList("Domino/Server":"names.nsf"; "LocalDomainAdmins");

@For(
 n := 1;
 n <= @Elements(~names);
 n := n + 1;
 addrs := addrs : @NameLookup( [NoUpdate] ; ~names[n]; "internetaddress")
);

@Trim(addrs)


Returns a multi-value text list of members of the specified group from the specified Server and Domino Directory.

Note: This @Function has been undocumented since Release 5.

Syntax

@ExpandNameList(servername : notesdatabase ; groupname)

Parameters

    * servername

      Text. Specify the target Domino Server for your query.
    * notesdatabase

      Text. Specifiy the target NotesDatabase for your query.
    * groupname

      Text. Specify the target Group, by name, for your query.


Return value

    * valuelist

      Text list. A multi-value text list containing members of the queried Domino Directory Group. No value is returned for unmatched Groups. To display the return values in a dialog box using @Prompt, enclose this function in an @Text function.


Usage

@ExpandNameList cannot be used in form selection and view column formulas.

This simple function can be used to return a members list of a specified group. Since the members list returns as a simple text list, you can use that return value as you like! The above example shows this function in combination with the @NameLookup, which we use to return the internetaddress values for all members in the LocalDomainAdmins group.