Sets an environment variable stored in the user's notes.ini file (Windows, OS/2, and UNIX) or Notes® Preferences file (Macintosh).
@SetEnvironment( variableName ; value )
variableName
Text. The name of the environment variable, enclosed in quotation marks. If you enter a text list for the variableName, then every variable named in that list receives the specified value. If you store the field name in a variable, omit the quotation marks here.
value
Text. The value you want to give to variableName. If you use a text list for value, only the first value in the list is used; the rest are ignored.
Use @SetEnvironment when you want to set an environment variable from within another @function (such as @If or @Do). To set the environment variable outside of an @function, use @Environment or the ENVIRONMENT keyword.
@SetEnvironment cannot be used in column or selection formulas. Some formulas, such as scheduled agents, are run on the server instead of the user's workstation. In this case, the environment variables affected are the server's environment variables, not the workstation's.
To get the value of an environment variable, use @Environment.
You cannot use this function in Web applications. However, in Web applications, you can use predefined field names to gather information about the Web user's environment by requesting Common Gateway Interface (CGI) environment variables.
This function prepends a dollar sign ($) to the variable name when it stores the variable in the notes.ini (or Notes Preference) file. Use the SetEnvironmentVar method of the LotusScript® NotesSession class or the setEnvironmentVar method of the Java™ Session class if you want to create a variable without the prepended dollar sign.
@Environment("IEVersionMajor")
@Environment("OrderNumber";"0")
@Environment("ENVOfficeLocation")
Its input-translation formula is:
@Environment("ENVOfficeLocation"; OfficeLocation);
OfficeLocation
The first time the user creates a Profile document, the OfficeLocation field is blank, so the user types in the office location. When the document is saved, the contents of the OfficeLocation field are saved in the notes.ini or Notes Preferences file. The next time the user creates a Profile document, the office location is retrieved from the environment variable ENVOfficeLocation, and the user doesn't have to type it in again (unless the office location changes, in which case the user edits the field).
You could also write the input-translation formula using either @SetEnvironment or the ENVIRONMENT keyword, both of which achieve the same result:
@SetEnvironment("ENVOfficeLocation"; OfficeLocation);
OfficeLocation
or
ENVIRONMENT ENVOfficeLocation:= OfficeLocation;
OfficeLocation
@Environment("ENVBirthday")
Its input-translation formula uses @Text to convert the time value into text:
@SetEnvironment("ENVBirthday"; @Text(Birthday));
Birthday
Use @Text to write a similar input-translation formula for a number field.
Temporary := @Environment("OrderNumber");
Temporary2 := @If(Temporary="";"0";Temporary);
CurrentOrderNumber := @TextToNumber(Temporary2);
NextOrderNumber := CurrentOrderNumber + 1;
ENVIRONMENT OrderNumber := @Text(NextOrderNumber);
@Text(CurrentOrderNumber);
@If(@Environment(OrderNumber)=""; @SetEnvironment("OrderNumber";"0"); @Return(@Environment("OrderNumber")))
The Set Group agent looks up the list of group names stored in column 1 of the Service Requests - By Group view, prompts the user to select a group name, and then stores the selected name in the TmpName environment variable before running the "(Set Group Helper)" agent. The "(Set Group Helper)" agent then retrieves the group name from the user's notes.ini or Notes Preferences file and stores it in the Group name field for all selected documents.
Set Group agent executes once:
GroupList:=@DbColumn("":"NoCache";"";
"Service Requests\\By Group";1);
Group:=@Prompt([OKCancelEditCombo];"Choose a group";"Choose
a group";"Marketing";GroupList);
Tmp1:=@Environment("TmpName";Group);
@Command([RunAgent];"(Set Group Helper)");
(Set Group Helper) agent runs on each selected document:
FIELD Group:=@Environment("TmpName");
SetEnvironmentVar method of LotusScript NotesSession class
setEnvironmentVar method of Java Session class