Updating User Profile Data

If your application provides functionality for users to update their addresses and related profile data, you will use methods in the DataUpdateService to insert, update, and delete user address profile records and notes to the school related to profile changes. Keep in mind that any changes submitted using these methods do not immediately update the Ascendance database, but are held for approval (with a ‘pending’ status) in the same manner as profile changes made by users through My BackPack.

Each of these operations returns a ResultAddress or ResultNotes data object which includes a status code to indicate whether the operation was successful, and if not, the object also provides an error code to identify the problem. See ResultAddressErrors or ResultNotesErrors for lists of all possible errors. You will need to provide logic for handling of the various error types.

Insert Methods

The insert methods allow for creation of a new residential, work, or additional contact address, and/or a note to the school. If the operation is successful, a new address record number is returned.

Update Methods

The update methods allow you to make changes to specific components of an address record (i.e. a mailing block, email addresses, a phone block, or a work block). You must provide the address record number for an existing address in the database, or a newly created (pending) address. All changes will completely overwrite existing values, and so must include a complete data set for the item being updated.

Delete Methods

The delete methods allow for existing or pending address records and/or pending notes to the school to be marked for removal.