Siebel Object Interfaces Reference > Interfaces Reference > Application Methods >

SetProfileAttr Method

SetProfileAttr is used in personalization to assign values to attributes in a user profile.

Syntax

Application.SetProfileAttr(name, value)

Returns

Not applicable

Usage

SetProfileAttr assigns the value value to the attribute in a user profile indicated by name. If the profile attribute specified in the argument string already exists, the corresponding persistent profile attribute in the application is updated with the new value. If the profile attribute specified in the argument string does not exist in the list of persistent profile attributes, it is created as a dynamic profile attribute, without quotation marks encompassing the name.

In Browser Script, using SetProfileAttr() triggers a round trip to the server and back, creating a performance overhead each time it is used.

Used With

Browser Script, COM Data Control, COM Data Server, Server Script, Java Data Bean, Mobile Web Client Automation Server

Example

The following example is in Browser Script:

function Applet_PreInvokeMethod (name, inputPropSet)

{
   if (name == "hobbyReq") {
      var hobby = theApplication().GetProfileAttr("Hobby");

      
      if (hobby == "") {
         hobby = prompt("Please enter your favorite hobby");      
         theApplication().SetProfileAttr("Hobby", hobby);
      }
      return ("CancelOperation");
   }
   else
      return ("ContinueOperation");
}

This following examples show how to exchange information between applet server scripts and applet browser scripts. In an applet server script, a customer profile attribute called MyProAttr is set to "Hello World" using the SetProfileAttr method. In applet browser scripts, you can retrieve the profile attribute using GetProfileAttr method.

The following example is in Siebel eScript:

function WebApplet_PreInvokeMethod (MethodName)
{

   if (MethodName == "MyCustomMethod") {

      TheApplication().SetProfileAttr("MyProAttr", "Hello World eScript");
      return (CancelOperation);

   }
   return (ContinueOperation);

}

The following example is in Siebel VB:

Function WebApplet_PreInvokeMethod (MethodName As String) As Integer

If MethodName = "MyCustomMethod" Then

   TheApplication.SetProfileAttr "MyProAttr", "Hello World VB"
   WebApplet_PreInvokeMethod = CancelOperation
Else
   WebApplet_PreInvokeMethod = ContinueOperation
End If

End Function

See Also

Name Method. For more information on user profile attributes, read Applications Administration Guide.