Create(ISchema, String, Byte[], Boolean):UserApplicationSettings

Creates or updates a user profile.

A user profile is a data object that has been defined in the schema management.

Since no names can be assigned for user profiles, the unique feature is the schema plus an instance name. The combination of schema and instance name may only occur together once per user as a profile. This method makes it possible to instantiate several user profiles of a type. These profiles can be used in different contexts of a project. For example, a user profile can be defined which defines data for a portal. There may be different portals that are operated in an onion.net instance. Thus one user profile of the same schema could be instantiated per portal for one and the same user.

Parameter

schema

Type: Onion.Client.ISchema

This parameter is the schema the user profile follows.

instance

Type: System.String

This parameter indicates an instance name. This name can be freely assigned. No blanks or special characters should be used. "default" should be used as the default name.

xmlAsUtf8

Type: System.Byte[]

This parameter contains the Xml of the data object.

overwrite

Type: System.Boolean

This parameter controls whether a data object is to be overwritten, in the case that there is already a profile with the schema and instance name.

If false is indicated as the value, then an exception of the type DataObjectAlreadyExistsException is triggered in the case that the instance of the schema already exists.