> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superoffice.com/llms.txt
> Use this file to discover all available pages before exploring further.
# SuperOffice.WebApi.Agents.PreferenceAgent
# \\ Class PreferenceAgent
Namespace: [SuperOffice.WebApi.Agents](SuperOffice.WebApi.Agents.md)\
Assembly: SuperOffice.WebApi.dll
Preferences, user interface tab configuration
```csharp theme={null}
public class PreferenceAgent : AgentBase, IPreferenceAgent, IAgentBase, IDisposable
```
#### Inheritance
[object](https://learn.microsoft.com/dotnet/api/system.object) ←
[AgentBase](SuperOffice.WebApi.Agents.AgentBase.md) ←
[PreferenceAgent](SuperOffice.WebApi.Agents.PreferenceAgent.md)
#### Implements
[IPreferenceAgent](SuperOffice.WebApi.Agents.IPreferenceAgent.md),
[IAgentBase](SuperOffice.WebApi.Agents.IAgentBase.md),
[IDisposable](https://learn.microsoft.com/dotnet/api/system.idisposable)
#### Inherited Members
[AgentBase.\_json](SuperOffice.WebApi.Agents.AgentBase.md#SuperOffice_WebApi_Agents_AgentBase__json),
[AgentBase.\_binary](SuperOffice.WebApi.Agents.AgentBase.md#SuperOffice_WebApi_Agents_AgentBase__binary),
[AgentBase.\_config](SuperOffice.WebApi.Agents.AgentBase.md#SuperOffice_WebApi_Agents_AgentBase__config),
[AgentBase.\_client](SuperOffice.WebApi.Agents.AgentBase.md#SuperOffice_WebApi_Agents_AgentBase__client),
[AgentBase.\_disposeClient](SuperOffice.WebApi.Agents.AgentBase.md#SuperOffice_WebApi_Agents_AgentBase__disposeClient),
[AgentBase.Merge(RequestOptions)](SuperOffice.WebApi.Agents.AgentBase.md#SuperOffice_WebApi_Agents_AgentBase_Merge_SuperOffice_WebApi_RequestOptions_),
[AgentBase.BuildRequestFromObject(HttpMethod, string, object, WebApiOptions, string)](SuperOffice.WebApi.Agents.AgentBase.md#SuperOffice_WebApi_Agents_AgentBase_BuildRequestFromObject_System_Net_Http_HttpMethod_System_String_System_Object_SuperOffice_WebApi_WebApiOptions_System_String_),
[AgentBase.BuildRequestFromStream(HttpMethod, string, Stream, WebApiOptions, string)](SuperOffice.WebApi.Agents.AgentBase.md#SuperOffice_WebApi_Agents_AgentBase_BuildRequestFromStream_System_Net_Http_HttpMethod_System_String_System_IO_Stream_SuperOffice_WebApi_WebApiOptions_System_String_),
[AgentBase.BuildRequestFromObjectWithStream(HttpMethod, string, object, Stream, WebApiOptions, string)](SuperOffice.WebApi.Agents.AgentBase.md#SuperOffice_WebApi_Agents_AgentBase_BuildRequestFromObjectWithStream_System_Net_Http_HttpMethod_System_String_System_Object_System_IO_Stream_SuperOffice_WebApi_WebApiOptions_System_String_),
[AgentBase.ParseAuthorization(IAuthorization)](SuperOffice.WebApi.Agents.AgentBase.md#SuperOffice_WebApi_Agents_AgentBase_ParseAuthorization_SuperOffice_WebApi_Authorization_IAuthorization_),
[AgentBase.CancelRequest()](SuperOffice.WebApi.Agents.AgentBase.md#SuperOffice_WebApi_Agents_AgentBase_CancelRequest),
[AgentBase.SendRequestObject(HttpMethod, string, object, WebApiOptions, string)](SuperOffice.WebApi.Agents.AgentBase.md#SuperOffice_WebApi_Agents_AgentBase_SendRequestObject_System_Net_Http_HttpMethod_System_String_System_Object_SuperOffice_WebApi_WebApiOptions_System_String_),
[AgentBase.SendRequestObjectWithStream(HttpMethod, string, object, Stream, WebApiOptions, string)](SuperOffice.WebApi.Agents.AgentBase.md#SuperOffice_WebApi_Agents_AgentBase_SendRequestObjectWithStream_System_Net_Http_HttpMethod_System_String_System_Object_System_IO_Stream_SuperOffice_WebApi_WebApiOptions_System_String_),
[AgentBase.SendRequest(HttpRequestMessage, RequestOptions)](SuperOffice.WebApi.Agents.AgentBase.md#SuperOffice_WebApi_Agents_AgentBase_SendRequest_System_Net_Http_HttpRequestMessage_SuperOffice_WebApi_RequestOptions_),
[AgentBase.ThrowOnResponseErrorAsync(HttpRequestMessage, HttpResponseMessage)](SuperOffice.WebApi.Agents.AgentBase.md#SuperOffice_WebApi_Agents_AgentBase_ThrowOnResponseErrorAsync_System_Net_Http_HttpRequestMessage_System_Net_Http_HttpResponseMessage_),
[AgentBase.ParseResponse\\using SuperOffice.WebApi;
using SuperOffice.WebApi.Agents;
var mySession = new WebApiOptions("[http://example.com/super/api](http://example.com/super/api)");
mySession.Authorization = new AuthorizationUsernamePassword("user", "pass");
using (PreferenceAgent agent = new PreferenceAgent(mySession))
\{
// call methods on agent here...
}\\
## Constructors
### \\ PreferenceAgent(HttpClient)
Constructor: Preferences, user interface tab configuration
```csharp theme={null}
public PreferenceAgent(HttpClient httpClient)
```
#### Parameters
`httpClient` [HttpClient](https://learn.microsoft.com/dotnet/api/system.net.http.httpclient)
Use this HTTP client instead of making own HttpClient instance.
### \\ PreferenceAgent(WebApiOptions, HttpClient)
Constructor: Preferences, user interface tab configuration
```csharp theme={null}
public PreferenceAgent(WebApiOptions options, HttpClient httpClient = null)
```
#### Parameters
`options` [WebApiOptions](SuperOffice.WebApi.WebApiOptions.md)
Base URL and authentication values.
`httpClient` [HttpClient](https://learn.microsoft.com/dotnet/api/system.net.http.httpclient)
Optional: Use this HTTP client instead of making a new one.
## Methods
### \\ CreateDefaultPreferenceAsync(RequestOptions)
Set default values into a new Preference.
NetServer calculates default values on the entity, which is required when creating/storing a new instance
```csharp theme={null}
public Task CreateDefaultPreferenceAsync(RequestOptions requestOptions = null)
```
#### Parameters
`requestOptions` [RequestOptions](SuperOffice.WebApi.RequestOptions.md)
Override language/culture codes on this request.
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task-1)\<[Preference](SuperOffice.WebApi.Data.Preference.md)\>
A blank Preference
### \\ CreateDefaultPreferenceDescriptionAsync(RequestOptions)
Set default values into a new PreferenceDescription.
NetServer calculates default values on the entity, which is required when creating/storing a new instance
```csharp theme={null}
public Task CreateDefaultPreferenceDescriptionAsync(RequestOptions requestOptions = null)
```
#### Parameters
`requestOptions` [RequestOptions](SuperOffice.WebApi.RequestOptions.md)
Override language/culture codes on this request.
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task-1)\<[PreferenceDescription](SuperOffice.WebApi.Data.PreferenceDescription.md)\>
A blank PreferenceDescription
### \\ CreateDefaultPreferenceDescriptionLineAsync(RequestOptions)
Set default values into a new PreferenceDescriptionLine.
NetServer calculates default values on the entity, which is required when creating/storing a new instance
```csharp theme={null}
public Task CreateDefaultPreferenceDescriptionLineAsync(RequestOptions requestOptions = null)
```
#### Parameters
`requestOptions` [RequestOptions](SuperOffice.WebApi.RequestOptions.md)
Override language/culture codes on this request.
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task-1)\<[PreferenceDescriptionLine](SuperOffice.WebApi.Data.PreferenceDescriptionLine.md)\>
A blank PreferenceDescriptionLine
### \\ DeleteFromSectionAndKeyAsync(string, string, RequestOptions)
Gets a PreferenceDescription based on the section and key
```csharp theme={null}
public Task DeleteFromSectionAndKeyAsync(string section, string key, RequestOptions requestOptions = null)
```
#### Parameters
`section` [string](https://learn.microsoft.com/dotnet/api/system.string)
The PreferenceDescription-section
`key` [string](https://learn.microsoft.com/dotnet/api/system.string)
The PreferenceDescription-key
`requestOptions` [RequestOptions](SuperOffice.WebApi.RequestOptions.md)
Override language/culture codes on this request.
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)
This method has no return value
### \\ DeletePrefDescLinesByPrefDescIdAsync(int, RequestOptions)
Delete the PrefDescLines associated with Preference Description Id in the SuperOffice database
```csharp theme={null}
public Task DeletePrefDescLinesByPrefDescIdAsync(int prefDescId, RequestOptions requestOptions = null)
```
#### Parameters
`prefDescId` [int](https://learn.microsoft.com/dotnet/api/system.int32)
Primary key of the Preference Description that contains PrefDescLines to delete
`requestOptions` [RequestOptions](SuperOffice.WebApi.RequestOptions.md)
Override language/culture codes on this request.
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)
Nothing
### \\ DeletePrefDescLinesByPrefDescIdsAsync(int\[], RequestOptions)
Delete the PrefDescLines associated with Preference Description Ids in the SuperOffice database
```csharp theme={null}
public Task DeletePrefDescLinesByPrefDescIdsAsync(int[] prefDescIds, RequestOptions requestOptions = null)
```
#### Parameters
`prefDescIds` [int](https://learn.microsoft.com/dotnet/api/system.int32)\[]
Primary keys of the Preference Descriptions that contains PrefDescLines to delete
`requestOptions` [RequestOptions](SuperOffice.WebApi.RequestOptions.md)
Override language/culture codes on this request.
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)
Nothing
### \\ DeletePreferenceAsync(int, RequestOptions)
Delete a preference by id
```csharp theme={null}
public Task DeletePreferenceAsync(int id, RequestOptions requestOptions = null)
```
#### Parameters
`id` [int](https://learn.microsoft.com/dotnet/api/system.int32)
The id of the preference to delete
`requestOptions` [RequestOptions](SuperOffice.WebApi.RequestOptions.md)
Override language/culture codes on this request.
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)
This method has no return value
### \\ DeletePreferenceDescriptionAsync(int, RequestOptions)
Deletes the PreferenceDescription
```csharp theme={null}
public Task DeletePreferenceDescriptionAsync(int preferenceDescriptionId, RequestOptions requestOptions = null)
```
#### Parameters
`preferenceDescriptionId` [int](https://learn.microsoft.com/dotnet/api/system.int32)
The identity of the PreferenceDescription
`requestOptions` [RequestOptions](SuperOffice.WebApi.RequestOptions.md)
Override language/culture codes on this request.
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)
### \\ DeletePreferenceDescriptionLineAsync(int, RequestOptions)
Deletes the PreferenceDescriptionLine
```csharp theme={null}
public Task DeletePreferenceDescriptionLineAsync(int preferenceDescriptionLineId, RequestOptions requestOptions = null)
```
#### Parameters
`preferenceDescriptionLineId` [int](https://learn.microsoft.com/dotnet/api/system.int32)
The identity of the PreferenceDescriptionLine
`requestOptions` [RequestOptions](SuperOffice.WebApi.RequestOptions.md)
Override language/culture codes on this request.
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)
### \\ DeletePreferenceDescriptionLinesAsync(int\[], RequestOptions)
Delete the PrefDescLines in the SuperOffice database
```csharp theme={null}
public Task DeletePreferenceDescriptionLinesAsync(int[] prefDescLineIds, RequestOptions requestOptions = null)
```
#### Parameters
`prefDescLineIds` [int](https://learn.microsoft.com/dotnet/api/system.int32)\[]
Primary keys of the PrefDescLines to delete
`requestOptions` [RequestOptions](SuperOffice.WebApi.RequestOptions.md)
Override language/culture codes on this request.
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)
Nothing
### \\ DeletePreferencesAsync(int\[], RequestOptions)
Delete some preferences by id
```csharp theme={null}
public Task DeletePreferencesAsync(int[] ids, RequestOptions requestOptions = null)
```
#### Parameters
`ids` [int](https://learn.microsoft.com/dotnet/api/system.int32)\[]
The ids of the preference to delete
`requestOptions` [RequestOptions](SuperOffice.WebApi.RequestOptions.md)
Override language/culture codes on this request.
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)
This method has no return value
### \\ GetAllAsync(RequestOptions)
Gets a list of all PreferenceDescriptions in the system.
```csharp theme={null}
public Task GetAllAsync(RequestOptions requestOptions = null)
```
#### Parameters
`requestOptions` [RequestOptions](SuperOffice.WebApi.RequestOptions.md)
Override language/culture codes on this request.
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task-1)\<[PreferenceDescription](SuperOffice.WebApi.Data.PreferenceDescription.md)\[]\>
All PreferenceDescriptions in the system
### \\ GetAllFromSectionAsync(string, RequestOptions)
Gets all PreferenceDescription-items in the specified section
```csharp theme={null}
public Task GetAllFromSectionAsync(string section, RequestOptions requestOptions = null)
```
#### Parameters
`section` [string](https://learn.microsoft.com/dotnet/api/system.string)
The PreferenceDescription-section
`requestOptions` [RequestOptions](SuperOffice.WebApi.RequestOptions.md)
Override language/culture codes on this request.
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task-1)\<[PreferenceDescription](SuperOffice.WebApi.Data.PreferenceDescription.md)\[]\>
All PreferenceDescriptions found.
### \\ GetFromSectionAndKeyAsync(string, string, RequestOptions)
Gets a PreferenceDescription based on the section and key
```csharp theme={null}
public Task GetFromSectionAndKeyAsync(string section, string key, RequestOptions requestOptions = null)
```
#### Parameters
`section` [string](https://learn.microsoft.com/dotnet/api/system.string)
The PreferenceDescription-section
`key` [string](https://learn.microsoft.com/dotnet/api/system.string)
The PreferenceDescription-key
`requestOptions` [RequestOptions](SuperOffice.WebApi.RequestOptions.md)
Override language/culture codes on this request.
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task-1)\<[PreferenceDescription](SuperOffice.WebApi.Data.PreferenceDescription.md)\>
A PreferenceDescription or null
### \\ GetNetServicesStatusUrlAsync(RequestOptions)
Returns URL to status service. e.g. '[https://help.superoffice.com/sodispatcher/v1/status](https://help.superoffice.com/sodispatcher/v1/status)' Returns NULL if status does not need to be checked yet.
```csharp theme={null}
public Task GetNetServicesStatusUrlAsync(RequestOptions requestOptions = null)
```
#### Parameters
`requestOptions` [RequestOptions](SuperOffice.WebApi.RequestOptions.md)
Override language/culture codes on this request.
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task-1)\<[string](https://learn.microsoft.com/dotnet/api/system.string)\>
NULL or URL of the status service that returns an XML or JSON block.
### \\ GetPreferenceAsync(int, RequestOptions)
Get a preference by id
```csharp theme={null}
public Task GetPreferenceAsync(int id, RequestOptions requestOptions = null)
```
#### Parameters
`id` [int](https://learn.microsoft.com/dotnet/api/system.int32)
The id of the preference to load
`requestOptions` [RequestOptions](SuperOffice.WebApi.RequestOptions.md)
Override language/culture codes on this request.
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task-1)\<[Preference](SuperOffice.WebApi.Data.Preference.md)\>
The preference loaded
### \\ GetPreferenceByNameAndIdAsync(string, string, PreferenceLevel, int, RequestOptions)
Get a preference by name and owner id.
```csharp theme={null}
public Task GetPreferenceByNameAndIdAsync(string prefSection, string prefKey, PreferenceLevel prefLevel, int ownerId, RequestOptions requestOptions = null)
```
#### Parameters
`prefSection` [string](https://learn.microsoft.com/dotnet/api/system.string)
The preference section name. e.g. 'Functions'. See SuperOffice.CRM.UserPreferenceStrings for constants.
`prefKey` [string](https://learn.microsoft.com/dotnet/api/system.string)
The preference key name. e.g. 'ShowTipsAtStart'. See SuperOffice.CRM.UserPreferenceStrings for constants.
`prefLevel` [PreferenceLevel](SuperOffice.WebApi.Data.PreferenceLevel.md)
The preference level to read. Undefined (0) means to return the preference defined closest to the user.
`ownerId` [int](https://learn.microsoft.com/dotnet/api/system.int32)
The preference owner id, individual or group.
`requestOptions` [RequestOptions](SuperOffice.WebApi.RequestOptions.md)
Override language/culture codes on this request.
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task-1)\<[Preference](SuperOffice.WebApi.Data.Preference.md)\>
The preference. Note that id = 0 and value = null if preference not found in the database at the requested pref-level.
### \\ GetPreferenceByNameAsync(string, string, PreferenceLevel, RequestOptions)
Get a preference by name
```csharp theme={null}
public Task GetPreferenceByNameAsync(string prefSection, string prefKey, PreferenceLevel prefLevel, RequestOptions requestOptions = null)
```
#### Parameters
`prefSection` [string](https://learn.microsoft.com/dotnet/api/system.string)
The preference section name. e.g. 'Functions'. See SuperOffice.CRM.UserPreferenceStrings for constants.
`prefKey` [string](https://learn.microsoft.com/dotnet/api/system.string)
The preference key name. e.g. 'ShowTipsAtStart'. See SuperOffice.CRM.UserPreferenceStrings for constants.
`prefLevel` [PreferenceLevel](SuperOffice.WebApi.Data.PreferenceLevel.md)
The preference level to read. Undefined (0) means to return the preference defined closest to the user.
`requestOptions` [RequestOptions](SuperOffice.WebApi.RequestOptions.md)
Override language/culture codes on this request.
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task-1)\<[Preference](SuperOffice.WebApi.Data.Preference.md)\>
The preference. Note that id = 0 and value = null if preference not found in the database at the requested pref-level.
### \\ GetPreferenceDescriptionAsync(int, RequestOptions)
Gets a specific PreferenceDescription object.
```csharp theme={null}
public Task GetPreferenceDescriptionAsync(int preferenceDescriptionId, RequestOptions requestOptions = null)
```
#### Parameters
`preferenceDescriptionId` [int](https://learn.microsoft.com/dotnet/api/system.int32)
The identifier of the PreferenceDescription object
`requestOptions` [RequestOptions](SuperOffice.WebApi.RequestOptions.md)
Override language/culture codes on this request.
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task-1)\<[PreferenceDescription](SuperOffice.WebApi.Data.PreferenceDescription.md)\>
PreferenceDescription
### \\ GetPreferenceDescriptionLineAsync(int, RequestOptions)
Gets a specific PreferenceDescriptionLine object.
```csharp theme={null}
public Task GetPreferenceDescriptionLineAsync(int preferenceDescriptionLineId, RequestOptions requestOptions = null)
```
#### Parameters
`preferenceDescriptionLineId` [int](https://learn.microsoft.com/dotnet/api/system.int32)
The identifier of the PreferenceDescriptionLine object
`requestOptions` [RequestOptions](SuperOffice.WebApi.RequestOptions.md)
Override language/culture codes on this request.
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task-1)\<[PreferenceDescriptionLine](SuperOffice.WebApi.Data.PreferenceDescriptionLine.md)\>
PreferenceDescriptionLine
### \\ GetPreferenceDescriptionLineFromIdAndValueAsync(int, string, RequestOptions)
Get a preference description line from a prefDesc\_id and a prefValue
```csharp theme={null}
public Task GetPreferenceDescriptionLineFromIdAndValueAsync(int prefDescId, string prefValue, RequestOptions requestOptions = null)
```
#### Parameters
`prefDescId` [int](https://learn.microsoft.com/dotnet/api/system.int32)
The id of the preference description this line is connected to
`prefValue` [string](https://learn.microsoft.com/dotnet/api/system.string)
The value of the description line to return
`requestOptions` [RequestOptions](SuperOffice.WebApi.RequestOptions.md)
Override language/culture codes on this request.
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task-1)\<[PreferenceDescriptionLine](SuperOffice.WebApi.Data.PreferenceDescriptionLine.md)\>
The preference description line matching the id and the value
### \\ GetPreferenceDescriptionLinesByPrefDescIdAsync(int, RequestOptions)
Get all preference description lines from a prefDesc\_id
```csharp theme={null}
public Task GetPreferenceDescriptionLinesByPrefDescIdAsync(int prefDescId, RequestOptions requestOptions = null)
```
#### Parameters
`prefDescId` [int](https://learn.microsoft.com/dotnet/api/system.int32)
The id of the preference description this line is connected to
`requestOptions` [RequestOptions](SuperOffice.WebApi.RequestOptions.md)
Override language/culture codes on this request.
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task-1)\<[PreferenceDescriptionLine](SuperOffice.WebApi.Data.PreferenceDescriptionLine.md)\[]\>
The preference description lines matching the id
### \\ GetPreferencesAsync(PreferenceSpec\[], RequestOptions)
Get one or more preferences based on a set of specifications.\
The prefDisplayvalue and prefDisplaytooltip are blank (faster processing relative to GetPreferencesWithDisplayValues)
```csharp theme={null}
public Task GetPreferencesAsync(PreferenceSpec[] specifications, RequestOptions requestOptions = null)
```
#### Parameters
`specifications` [PreferenceSpec](SuperOffice.WebApi.Data.PreferenceSpec.md)\[]
Array of preference specifications. The key value may be \* (asterisk), which means 'all keys within section'. Note that the semantics of this are more strictly 'all keys actually set at any accessible level for this associate'; you will NOT get entries for preferences that might exist, but have no set value anywhere. You can also have askerisk as the section name. In that case the specification array must contain exactly one entry and the key must also be asterisk. This will return all known preferences in all sections for your associate. It might be a lot, tests have shown that a heavily used database can accumulate up to 500 preferences on a single associate. If the Sentry table/field right preferences have been used, the number could be a lot greater!
`requestOptions` [RequestOptions](SuperOffice.WebApi.RequestOptions.md)
Override language/culture codes on this request.
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task-1)\<[Preference](SuperOffice.WebApi.Data.Preference.md)\[]\>
Array of preference values for your given specification(s). More strictly: 'all keys actually set at any accessible level for this associate'; you will NOT get entries for preferences that might exist, but have no set value anywhere.
### \\ GetPreferencesWithDisplayValuesAsync(PreferenceSpec\[], RequestOptions)
Get one or more preferences based on a set of specifications\
The PrefDisplayValue and PrefDisplaytooltip are populated, at some additional processing cost.
```csharp theme={null}
public Task GetPreferencesWithDisplayValuesAsync(PreferenceSpec[] specifications, RequestOptions requestOptions = null)
```
#### Parameters
`specifications` [PreferenceSpec](SuperOffice.WebApi.Data.PreferenceSpec.md)\[]
Array of preference specifications. The key value may be \* (asterisk), which means 'all keys within section'. Note that the semantics of this are more strictly 'all keys actually set at any accessible level for this associate'; you will NOT get entries for preferences that might exist, but have no set value anywhere. You can also have askerisk as the section name. In that case the specification array must contain exactly one entry and the key must also be asterisk. This will return all known preferences in all sections for your associate. It might be a lot, tests have shown that a heavily used database can accumulate up to 500 preferences on a single associate. If the Sentry table/field right preferences have been used, the number could be a lot greater!
`requestOptions` [RequestOptions](SuperOffice.WebApi.RequestOptions.md)
Override language/culture codes on this request.
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task-1)\<[Preference](SuperOffice.WebApi.Data.Preference.md)\[]\>
Array of preference values for your given specification(s). More strictly: 'all keys actually set at any accessible level for this associate'; you will NOT get entries for preferences that might exist, but have no set value anywhere.\
The PrefDisplayValue and PrefDisplaytooltip are populated, at some additional processing cost.
### \\ GetTabOrderAsync(string, RequestOptions)
Gets the tab order.
```csharp theme={null}
public Task GetTabOrderAsync(string tabName, RequestOptions requestOptions = null)
```
#### Parameters
`tabName` [string](https://learn.microsoft.com/dotnet/api/system.string)
Name of the tab control
`requestOptions` [RequestOptions](SuperOffice.WebApi.RequestOptions.md)
Override language/culture codes on this request.
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task-1)\<[TabOrder](SuperOffice.WebApi.Data.TabOrder.md)\>
Tab order. Array of strings. Each string represent a named tab.
### \\ GetTabOrdersAsync(RequestOptions)
```csharp theme={null}
public Task GetTabOrdersAsync(RequestOptions requestOptions = null)
```
#### Parameters
`requestOptions` [RequestOptions](SuperOffice.WebApi.RequestOptions.md)
Override language/culture codes on this request.
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task-1)\<[TabOrder](SuperOffice.WebApi.Data.TabOrder.md)\[]\>
### \\ GetXsrfPathsAsync(string, RequestOptions)
Returns paths that XSRF cookies should be set on
```csharp theme={null}
public Task GetXsrfPathsAsync(string hostname, RequestOptions requestOptions = null)
```
#### Parameters
`hostname` [string](https://learn.microsoft.com/dotnet/api/system.string)
The hostname that we are storing paths for.
`requestOptions` [RequestOptions](SuperOffice.WebApi.RequestOptions.md)
Override language/culture codes on this request.
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task-1)\<[string](https://learn.microsoft.com/dotnet/api/system.string)\[]\>
Paths that XSRF cookies should be set for: \['/cs', '/crm']
### \\ GetXsrfValueAsync(RequestOptions)
Returns the XSRF token value and last update time for the current user
```csharp theme={null}
public Task GetXsrfValueAsync(RequestOptions requestOptions = null)
```
#### Parameters
`requestOptions` [RequestOptions](SuperOffice.WebApi.RequestOptions.md)
Override language/culture codes on this request.
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task-1)\<[XsrfValue](SuperOffice.WebApi.Data.XsrfValue.md)\>
The XSRF token value and timestamp
### \\ SaveFromSectionAndKeyAsync(string, string, PreferenceDescription, RequestOptions)
Update a PreferenceDescription based on the section and key
```csharp theme={null}
public Task SaveFromSectionAndKeyAsync(string section, string key, PreferenceDescription preferenceDescription, RequestOptions requestOptions = null)
```
#### Parameters
`section` [string](https://learn.microsoft.com/dotnet/api/system.string)
The PreferenceDescription-section
`key` [string](https://learn.microsoft.com/dotnet/api/system.string)
The PreferenceDescription-key
`preferenceDescription` [PreferenceDescription](SuperOffice.WebApi.Data.PreferenceDescription.md)
The PreferenceDescription to save.
`requestOptions` [RequestOptions](SuperOffice.WebApi.RequestOptions.md)
Override language/culture codes on this request.
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task-1)\<[PreferenceDescription](SuperOffice.WebApi.Data.PreferenceDescription.md)\>
Saved PreferenceDescription
### \\ SavePreferenceAsync(Preference, RequestOptions)
Save this preference
```csharp theme={null}
public Task SavePreferenceAsync(Preference preference, RequestOptions requestOptions = null)
```
#### Parameters
`preference` [Preference](SuperOffice.WebApi.Data.Preference.md)
Preference to be saved. All fields must be filled in, and the preference will be saved on the Associate level only. Setting for other levels is an administrative task and not available through this service.
`requestOptions` [RequestOptions](SuperOffice.WebApi.RequestOptions.md)
Override language/culture codes on this request.
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)
This method has no return value
### \\ SavePreferenceDescriptionAsync(PreferenceDescription, RequestOptions)
Updates the existing PreferenceDescription or creates a new PreferenceDescription if the id parameter is 0.
```csharp theme={null}
public Task SavePreferenceDescriptionAsync(PreferenceDescription preferenceDescription, RequestOptions requestOptions = null)
```
#### Parameters
`preferenceDescription` [PreferenceDescription](SuperOffice.WebApi.Data.PreferenceDescription.md)
The PreferenceDescription that is saved.
`requestOptions` [RequestOptions](SuperOffice.WebApi.RequestOptions.md)
Override language/culture codes on this request.
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task-1)\<[PreferenceDescription](SuperOffice.WebApi.Data.PreferenceDescription.md)\>
New or updated PreferenceDescription
### \\ SavePreferenceDescriptionLineAsync(PreferenceDescriptionLine, RequestOptions)
Updates the existing PreferenceDescriptionLine or creates a new PreferenceDescriptionLine if the id parameter is 0.
```csharp theme={null}
public Task SavePreferenceDescriptionLineAsync(PreferenceDescriptionLine preferenceDescriptionLine, RequestOptions requestOptions = null)
```
#### Parameters
`preferenceDescriptionLine` [PreferenceDescriptionLine](SuperOffice.WebApi.Data.PreferenceDescriptionLine.md)
The PreferenceDescriptionLine that is saved.
`requestOptions` [RequestOptions](SuperOffice.WebApi.RequestOptions.md)
Override language/culture codes on this request.
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task-1)\<[PreferenceDescriptionLine](SuperOffice.WebApi.Data.PreferenceDescriptionLine.md)\>
New or updated PreferenceDescriptionLine
### \\ SavePreferenceDescriptionLinesAsync(PreferenceDescriptionLine\[], RequestOptions)
Saves the PreferenceDescriptionLine array in the SuperOffice database
```csharp theme={null}
public Task SavePreferenceDescriptionLinesAsync(PreferenceDescriptionLine[] preferenceDescriptionLines, RequestOptions requestOptions = null)
```
#### Parameters
`preferenceDescriptionLines` [PreferenceDescriptionLine](SuperOffice.WebApi.Data.PreferenceDescriptionLine.md)\[]
The PreferenceDescriptionLine array to save.
`requestOptions` [RequestOptions](SuperOffice.WebApi.RequestOptions.md)
Override language/culture codes on this request.
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task-1)\<[PreferenceDescriptionLine](SuperOffice.WebApi.Data.PreferenceDescriptionLine.md)\[]\>
The updated PrefDesc lines (If the PreferenceDescriptionLine array was new, it returns with id's set.
### \\ SavePreferenceEntitiesAsync(Preference\[], bool, RequestOptions)
Save this set of preferences.
```csharp theme={null}
public Task SavePreferenceEntitiesAsync(Preference[] preferences, bool removeLowerLevels, RequestOptions requestOptions = null)
```
#### Parameters
`preferences` [Preference](SuperOffice.WebApi.Data.Preference.md)\[]
Preferences to be saved. Note that all fields must be filled in.
`removeLowerLevels` [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
If this is true, all user preferences on lower levels will be deleted
`requestOptions` [RequestOptions](SuperOffice.WebApi.RequestOptions.md)
Override language/culture codes on this request.
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)
### \\ SavePreferenceEntityAsync(Preference, bool, RequestOptions)
Saves a complete preference object, on any level and any target. Preference administrator rights are required to use this
```csharp theme={null}
public Task SavePreferenceEntityAsync(Preference preference, bool removeLowerLevels, RequestOptions requestOptions = null)
```
#### Parameters
`preference` [Preference](SuperOffice.WebApi.Data.Preference.md)
The preference object to be saved
`removeLowerLevels` [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
If this is true, all user preferences on lower levels will be deleted
`requestOptions` [RequestOptions](SuperOffice.WebApi.RequestOptions.md)
Override language/culture codes on this request.
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task-1)\<[Preference](SuperOffice.WebApi.Data.Preference.md)\>
Returns the saved preference
### \\ SavePreferencesAsync(Preference\[], RequestOptions)
Save this set of preferences. Note this method DOES NOT look at level/targetId - it only saves on behalf of the CURRENT USER.
```csharp theme={null}
public Task SavePreferencesAsync(Preference[] preferences, RequestOptions requestOptions = null)
```
#### Parameters
`preferences` [Preference](SuperOffice.WebApi.Data.Preference.md)\[]
Preferences to be saved. Note that all fields must be filled in, and the preference will be saved on the Associate level only! Setting for other levels is an administrative task and not available through this service.
`requestOptions` [RequestOptions](SuperOffice.WebApi.RequestOptions.md)
Override language/culture codes on this request.
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)
### \\ SaveTabOrderAsync(TabOrder, RequestOptions)
Saves the tab order. The order is saved pr. user.
```csharp theme={null}
public Task SaveTabOrderAsync(TabOrder tabOrder, RequestOptions requestOptions = null)
```
#### Parameters
`tabOrder` [TabOrder](SuperOffice.WebApi.Data.TabOrder.md)
Name of the tab control
`requestOptions` [RequestOptions](SuperOffice.WebApi.RequestOptions.md)
Override language/culture codes on this request.
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)
This method has no return value
### \\ SaveTabOrdersAsync(TabOrder\[], RequestOptions)
```csharp theme={null}
public Task SaveTabOrdersAsync(TabOrder[] tabOrders, RequestOptions requestOptions = null)
```
#### Parameters
`tabOrders` [TabOrder](SuperOffice.WebApi.Data.TabOrder.md)\[]
`requestOptions` [RequestOptions](SuperOffice.WebApi.RequestOptions.md)
Override language/culture codes on this request.
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)
### \\ SetXsrfPathsAsync(string, string\[], RequestOptions)
Update the paths that need XSRF cookies
```csharp theme={null}
public Task SetXsrfPathsAsync(string hostname, string[] paths, RequestOptions requestOptions = null)
```
#### Parameters
`hostname` [string](https://learn.microsoft.com/dotnet/api/system.string)
The hostname that we are storing paths for.
`paths` [string](https://learn.microsoft.com/dotnet/api/system.string)\[]
Paths that XSRF cookies should be set for: \['/cs', '/crm']
`requestOptions` [RequestOptions](SuperOffice.WebApi.RequestOptions.md)
Override language/culture codes on this request.
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)
This method has no return value
### \\ SetXsrfValueAsync(string, RequestOptions)
Sets the XSRF token value for the current user
```csharp theme={null}
public Task SetXsrfValueAsync(string xsrfValue, RequestOptions requestOptions = null)
```
#### Parameters
`xsrfValue` [string](https://learn.microsoft.com/dotnet/api/system.string)
The XSRF value to store
`requestOptions` [RequestOptions](SuperOffice.WebApi.RequestOptions.md)
Override language/culture codes on this request.
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)
This method has no return value
### \\ UpdateNetServicesStatusAsync(string, RequestOptions)
Update the NetServices preferences with values contained in the content from the Status URL
```csharp theme={null}
public Task UpdateNetServicesStatusAsync(string xml_or_json, RequestOptions requestOptions = null)
```
#### Parameters
`xml_or_json` [string](https://learn.microsoft.com/dotnet/api/system.string)
The text that was returned by getting the Status URL
`requestOptions` [RequestOptions](SuperOffice.WebApi.RequestOptions.md)
Override language/culture codes on this request.
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)
This method has no return value