Sets the value of a field in a profile document or creates a profile document.

Syntax

@SetProfileField( profilename ; fieldname ; value ; uniqueKey )

Parameters

profilename

Text. The name of the profile document that contains the field you want to access. If no profile document exists by this name, Lotus Notes/Domino creates one.

Text. The name of the field you want to access.

Text, number, time-date, time-date range, or list thereof. The value to which you want to set the field.

Text. Optional. A unique key that identifies the profile document.

value

The value to which you set the field.

Use this function to create a profile document in a Web application. The EditProfile @command does not work on the Web. If no document exists with the name specified as the first parameter of this function, Lotus Notes/Domino creates a profile document with that name. Use @GetProfileField to access data from the profile document.

The value can be anything and does not have to match the type of the field as defined on a form. This function does not reset flags on an existing field and does not set flags for a newly stored field. For example, a Readers field does not become plain text by assigning a text value; and a newly stored field cannot be made a Readers field. The LotusScript and Java classes allow this manipulation through NotesItem and Item.

Language cross-reference

EditProfile method of LotusScript NotesUIWorkspace class

Example
See Also

Profile forms
@GetProfileField
EditProfile @Command
EditProfileDocument @Command
@Functions with ECL security
Getting and setting environment variables
Accessing data outside the current document and database
"The hidden power of Profile documents" on the Lotus Developer Domain

Glossary