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.

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
First Name	Text	Yes	No
Middle Name	Text	No	No
Last Name	Text	Yes	No
Nickname	Text	No	No
Supervisor*	User	No	No
Title	Text	No	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
Province	Text	No	No
ZIP Code	Text	No	No
Country	Text	No	No
Locale*	Text	No	No
Time Zone*	Text	No	No
Calendar*	Text	No	No
Custom Field 1	Text	No	No
Custom Field 2	Text	No	No
Custom Field 3	Text	No	No
Custom Field 4	Text	No	No
Custom Field 5	Text	No	No
Custom Field 6	Text	No	No
Custom Field 7	Text	No	No
Custom Field 8	Text	No	No
Custom Field 9	Text	No	No
Custom Field 10	Text	No	No

* See specific usage considerations for additional information.

Node outputs

This node does not return any values.

Usage considerations

Consider the following when using this smart service.

General considerations

• If the node is run without being assigned to a user (or a group), you must specify values for each of the node inputs. If you want to overwrite all fields, including setting some fields to null, set the Overwrite All Fields input to true. You can either manually enter data into the text field, or generate a value 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.

Specific considerations

• Supervisor: 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.
• Locale: The locale code of the user, such as en_US or de. If not provided, defaults to the environment's primary locale.
• Time Zone: The time zone ID of the user, such as America_New York or Europe/London. If not provided, defaults to the environment's primary time zone. To find the time zones available on your environment, view the Time Zone options in your User Settings or the Internationalization tab of the Admin Console.
• Calendar: The calendar of the user. If not provided, defaults to the environment's primary calendar. Valid values: gregorian, Epoch A T1, Epoch A T2, Epoch B T1, Epoch B T2, Umm Al Qura.

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( group, overwriteAllFields, firstName, middleName, lastName, nickname, supervisor, title, email, officePhone, mobilePhone, homePhone, address1, address2, address3, city, state, province, zipCode, country, locale, timeZone, calendar, customField1, customField2, customField3, customField4, customField5, customField6, customField7, customField8, customField9, customField10, 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. By default, this value is false.
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.
nickname	Text	The new nickname of the user.
supervisor	User	The new supervisor of the user.
title	Text	The new title 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.
province	Text	The new province of the user.
zipCode	Text	The new ZIP code of the user.
country	Text	The new country of the user.
locale	Text	The new locale code of the user, such as en_US or de. If not provided, defaults to the primary locale.
timeZone	Text	The time zone ID of the user, such as America_New York or Europe/London. If not provided, defaults to the environment's primary time zone. To find the time zones available on your environment, view the Time Zone options in your User Settings or the Internationalization tab of the Admin Console.
calendar	Text	The new calendar of the user. If not provided, defaults to the primary calendar. Valid values: gregorian, Epoch A T1, Epoch A T2, Epoch B T1, Epoch B T2, Umm Al Qura.
customField1	Text	The new value of custom field 1 of the user.
customField2	Text	The new value of custom field 2 of the user.
customField3	Text	The new value of custom field 3 of the user.
customField4	Text	The new value of custom field 4 of the user.
customField5	Text	The new value of custom field 5 of the user.
customField6	Text	The new value of custom field 6 of the user.
customField7	Text	The new value of custom field 7 of the user.
customField8	Text	The new value of custom field 8 of the user.
customField9	Text	The new value of custom field 9 of the user.
customField10	Text	The new value of custom field 10 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().

Feature compatibility

The table below lists this smart service function's compatibility with various features in Appian.

Feature	Compatibility	Note
Portals	Partially compatible	Can be used with Appian Portals if it is connected using an integration and web API.
Offline Mobile	Incompatible
Sync-Time Custom Record Fields	Incompatible
Real-Time Custom Record Fields	Incompatible
Process Reports	Incompatible	You cannot use this function to configure a process report.
Process Events	Incompatible	You cannot use this function to configure a process event node, such as a start event or timer event.

Feedback