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.

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.

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)

Parameters

Keyword Type Description

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: Wed, Aug 16, 2023 (04:37:39 PM)

On This Page

FEEDBACK