Update User Profile Smart Service

Overview

The Update User Profile Service Node allows you to update a selected user's personal data, including their name, address, phone number, supervisor and title. Any fields not modified will retain their previous information. If you do not select a user, any changes made are applied to the user running the node. To be able to modify another user's information, you must be a System Administrator.

NOTE: The Update User Profile Service Node can only be executed by someone who is a System Administrator. Attempting to modify a user account other than your own, without sufficient user rights generates an error alert for the Process Administrator and pauses the process.

Properties

  • Category: Identity Management

  • Icon:

  • Assignment Options: Unattended/Attended

Configuration Options

This section contains tab configuration details specific to this smart service. For more information about common configurations see the Process Node Properties page.

Data Tab

Node Inputs

The Data tab displays all the node inputs and node outputs for the Smart Service node. You can add additional inputs and outputs, if needed. The default inputs generated for the Update User Profile node are:

Input Data Type Required Multiple
Choose User User Yes No
Overwrite All Fields Boolean No No
SSN (Deprecated) Text No No
First Name Text Yes No
Middle Name Text No No
Last Name Text Yes No
E-mail Text Yes No
Office Phone Text No No
Mobile Phone Text No No
Home Phone Text No No
Address 1 Text No No
Address 2 Text No No
Address 3 Text No No
City Text No No
State Text No No
Zip Code Text No No
Country Text No No
Supervisor User No No
Title Text No No

If the node is run without being assigned to a user (or a group) you must specify values for each of the Node Inputs listed in the table above. If you want to overwrite all fields, including setting some fields to null, set "Overwrite All Fields" to True. You can either manually enter data into the text-field, or a value can be generated using the Expression Editor. When using the Expression Editor, you can reference and modify process variables, rules, constants, and other data. The expressions then populate your Node Input values.

If the node is assigned, the Node Input values are typed by your assigned user(s) into a form.

NOTE: If the user selected for the Supervisor field has been deactivated since the profile was last updated, an error is thrown and the process pauses by exception until a valid user or no user is entered for the field.

Node Outputs

This node does not return any values.

a!updateUserProfile()

The Update User Profile smart service is available as an expression function that can be executed inside a saveInto on a Interface Component or as part of a Web API.

Syntax

a!updateUserProfile(user, overwriteAllFields, firstName, middleName, lastName, email, officePhone, mobilePhone, homePhone, address1, address2, address3, city, state, zipCode, country, supervisor, title,, onSuccess, onError)

Inputs

  • group (User): The user whose profile will be updated.
  • overwriteAllFields (Boolean): Set to true to overwrite all fields with the specified values (or null when no value is specified). Set to false to only overwrite fields with specified value and keep the original values when no value is specified.
  • firstName (Text): The new first name of the user.
  • middleName (Text): The new middle name of the user.
  • lastName (Text): The new last name of the user.
  • email (Text): The new email address of the user.
  • officePhone (Text): The new office phone number of the user.
  • mobilePhone (Text): The new mobile phone number of the user.
  • homePhone (Text): The new home phone number of the user.
  • address1 (Text): The new address of the user.
  • address2 (Text): The new address of the user.
  • address3 (Text): The new address of the user.
  • city (Text): The new city of the user.
  • state (Text): The new state of the user.
  • zipCode (Text): The new zip code of the user.
  • country (Text): TThe new country of the user.
  • supervisor (User): The new supervisor of the user.
  • title (Text): The new title of the user.
  • onSuccess (Any Type): A list of saves or an HTTP response to execute after the smart service executes successfully. Created with a!save() or a!httpResponse().
  • onError (Any Type): A list of saves or an HTTP response to execute when the smart service does not execute successfully. Created with a!save() or a!httpResponse().
Open in Github Built: Thu, Feb 23, 2023 (02:59:22 PM)

On This Page

FEEDBACK