Skip to main content

Class ListAgent

Namespace: SuperOffice.WebApi.Agents
Assembly: SuperOffice.WebApi.dll
Collection of all services that works with Lists. These are typical lists of data shown in dropdown list, checkbox lists, etc.

Inheritance

objectAgentBaseListAgent

Implements

IListAgent, IAgentBase, IDisposable

Inherited Members

AgentBase._json, AgentBase._binary, AgentBase._config, AgentBase._client, AgentBase._disposeClient, AgentBase.Merge(RequestOptions), AgentBase.BuildRequestFromObject(HttpMethod, string, object, WebApiOptions, string), AgentBase.BuildRequestFromStream(HttpMethod, string, Stream, WebApiOptions, string), AgentBase.BuildRequestFromObjectWithStream(HttpMethod, string, object, Stream, WebApiOptions, string), AgentBase.ParseAuthorization(IAuthorization), AgentBase.CancelRequest(), AgentBase.SendRequestObject(HttpMethod, string, object, WebApiOptions, string), AgentBase.SendRequestObjectWithStream(HttpMethod, string, object, Stream, WebApiOptions, string), AgentBase.SendRequest(HttpRequestMessage, RequestOptions), AgentBase.ThrowOnResponseErrorAsync(HttpRequestMessage, HttpResponseMessage), AgentBase.ParseResponse<T&gt;(HttpResponseMessage), AgentBase.Finally(RequestOptions), AgentBase.Dispose(), AgentBase.Configuration, AgentBase.Client, AgentBase.HasRunningRequest, AgentBase.ClientCancellationTokenSource, AgentBase.ProgressListener, AgentBase.UploadProgressListener, object.ToString(), object.Equals(object), object.Equals(object, object), object.ReferenceEquals(object, object), object.GetHashCode(), object.GetType(), object.MemberwiseClone()

Examples

<pre><code class=“lang-csharp”>using SuperOffice.WebApi; using SuperOffice.WebApi.Agents; var mySession = new WebApiOptions(“http://example.com/super/api”); mySession.Authorization = new AuthorizationUsernamePassword(“user”, “pass”); using (ListAgent agent = new ListAgent(mySession)) { // call methods on agent here… }</code></pre>

Constructors

ListAgent(HttpClient)

Constructor: Collection of all services that works with Lists. These are typical lists of data shown in dropdown list, checkbox lists, etc.

Parameters

httpClient HttpClient Use this HTTP client instead of making own HttpClient instance.

ListAgent(WebApiOptions, HttpClient)

Constructor: Collection of all services that works with Lists. These are typical lists of data shown in dropdown list, checkbox lists, etc.

Parameters

options WebApiOptions Base URL and authentication values. httpClient HttpClient Optional: Use this HTTP client instead of making a new one.

Methods

AddFromListDefinitionAsync(int, ListItemEntity, RequestOptions)

Save a new list item for the specified list defintion

Parameters

udListDefinitionId int The name of the list definition, indicating which list to save the item to. item ListItemEntity The item to save requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ListItemEntity&gt; The saved list item

AddFromListNameAsync(string, ListItemEntity, RequestOptions)

Save a new list item for the specified list defintion

Parameters

udListDefinitionName string The name of the list definition, indicating which list to save the item to. item ListItemEntity The item to save requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ListItemEntity&gt; The saved list item

AddHierarchyToPathAsync(Domain, string, string, RequestOptions)

Add a hierarchy item to a path

Parameters

domain Domain Type of items to get path string Hierarchy path to parent item name string Name of node to add requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<HierarchyEntity&gt; The hierarchy node added to the path

ChangeCurrencyAsync(double, string, string, RequestOptions)

Recalculates the amount to the new currency.

Parameters

amount double The amount in the old currency fromCurrency string The old currency name toCurrency string The new currency name requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<double&gt; Amount in new currency

CreateDefaultAmountClassEntityAsync(RequestOptions)

Set default values into a new AmountClassEntity. NetServer calculates default values on the entity, which is required when creating/storing a new instance

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<AmountClassEntity&gt; A blank AmountClassEntity

CreateDefaultCategoryEntityAsync(RequestOptions)

Set default values into a new CategoryEntity. NetServer calculates default values on the entity, which is required when creating/storing a new instance

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<CategoryEntity&gt; A blank CategoryEntity

CreateDefaultCountryAsync(RequestOptions)

Gets a new country

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<Country&gt; A new country with default values

CreateDefaultCurrencyEntityAsync(RequestOptions)

Set default values into a new CurrencyEntity. NetServer calculates default values on the entity, which is required when creating/storing a new instance

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<CurrencyEntity&gt; A blank CurrencyEntity

CreateDefaultDocumentTemplateEntityAsync(RequestOptions)

Set default values into a new DocumentTemplateEntity. NetServer calculates default values on the entity, which is required when creating/storing a new instance

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<DocumentTemplateEntity&gt; A blank DocumentTemplateEntity

CreateDefaultDocumentTemplateLanguageAsync(int, string, RequestOptions)

Create a new document template language based on an existing template

Parameters

documentTemplateId int The id of the document template languageCode string The language code (‘en-US, ‘nb-NO’, etc) requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task Returns nothing - throws on error

CreateDefaultExtAppEntityAsync(RequestOptions)

Set default values into a new ExtAppEntity. NetServer calculates default values on the entity, which is required when creating/storing a new instance

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ExtAppEntity&gt; A blank ExtAppEntity

CreateDefaultHeadingEntityAsync(RequestOptions)

Set default values into a new HeadingEntity. NetServer calculates default values on the entity, which is required when creating/storing a new instance

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<HeadingEntity&gt; A blank HeadingEntity

CreateDefaultHeadingFromListDefinitionAsync(int, RequestOptions)

Get a heading for the specified list defintion

Parameters

udListDefinitionId int The id of the list definition, indicating which list to get the item from requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<HeadingEntity&gt; The loaded heading

CreateDefaultHierarchyEntityAsync(RequestOptions)

Set default values into a new HierarchyEntity. NetServer calculates default values on the entity, which is required when creating/storing a new instance

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<HierarchyEntity&gt; A blank HierarchyEntity

CreateDefaultListEntityAsync(RequestOptions)

Set default values into a new ListEntity. NetServer calculates default values on the entity, which is required when creating/storing a new instance

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ListEntity&gt; A blank ListEntity

CreateDefaultListItemEntityAsync(RequestOptions)

Set default values into a new ListItemEntity. NetServer calculates default values on the entity, which is required when creating/storing a new instance

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ListItemEntity&gt; A blank ListItemEntity

CreateDefaultPictureFolderEntityAsync(RequestOptions)

Set default values into a new PictureFolderEntity. NetServer calculates default values on the entity, which is required when creating/storing a new instance

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<PictureFolderEntity&gt; A blank PictureFolderEntity

CreateDefaultProjectTypeEntityAsync(RequestOptions)

Set default values into a new ProjectTypeEntity. NetServer calculates default values on the entity, which is required when creating/storing a new instance

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ProjectTypeEntity&gt; A blank ProjectTypeEntity

CreateDefaultRelationDefinitionEntityAsync(RequestOptions)

Set default values into a new RelationDefinitionEntity. NetServer calculates default values on the entity, which is required when creating/storing a new instance

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<RelationDefinitionEntity&gt; A blank RelationDefinitionEntity

CreateDefaultResourceEntityAsync(RequestOptions)

Set default values into a new ResourceEntity. NetServer calculates default values on the entity, which is required when creating/storing a new instance

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ResourceEntity&gt; A blank ResourceEntity

CreateDefaultSaleStageEntityAsync(RequestOptions)

Set default values into a new SaleStageEntity. NetServer calculates default values on the entity, which is required when creating/storing a new instance

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<SaleStageEntity&gt; A blank SaleStageEntity

CreateDefaultSaleTypeEntityAsync(RequestOptions)

Set default values into a new SaleTypeEntity. NetServer calculates default values on the entity, which is required when creating/storing a new instance

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<SaleTypeEntity&gt; A blank SaleTypeEntity

CreateDefaultTaskMenuAsync(RequestOptions)

Set default values into a new TaskMenu. NetServer calculates default values on the entity, which is required when creating/storing a new instance

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<TaskMenu&gt; A blank TaskMenu

CreateDefaultTicketCategoryEntityAsync(RequestOptions)

Set default values into a new TicketCategoryEntity. NetServer calculates default values on the entity, which is required when creating/storing a new instance

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<TicketCategoryEntity&gt; A blank TicketCategoryEntity

CreateDefaultTicketPriorityEntityAsync(RequestOptions)

Set default values into a new TicketPriorityEntity. NetServer calculates default values on the entity, which is required when creating/storing a new instance

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<TicketPriorityEntity&gt; A blank TicketPriorityEntity

CreateDefaultTicketRelationDefinitionEntityAsync(RequestOptions)

Set default values into a new TicketRelationDefinitionEntity. NetServer calculates default values on the entity, which is required when creating/storing a new instance

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<TicketRelationDefinitionEntity&gt; A blank TicketRelationDefinitionEntity

CreateDefaultTicketStatusEntityAsync(RequestOptions)

Set default values into a new TicketStatusEntity. NetServer calculates default values on the entity, which is required when creating/storing a new instance

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<TicketStatusEntity&gt; A blank TicketStatusEntity

CreateDefaultTicketTypeEntityAsync(RequestOptions)

Set default values into a new TicketTypeEntity. NetServer calculates default values on the entity, which is required when creating/storing a new instance

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<TicketTypeEntity&gt; A blank TicketTypeEntity

CreateDefaultWebPanelEntityAsync(RequestOptions)

Set default values into a new WebPanelEntity. NetServer calculates default values on the entity, which is required when creating/storing a new instance

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<WebPanelEntity&gt; A blank WebPanelEntity

DeleteAllFromListDefinitionAsync(int, RequestOptions)

Marks all items in the list deleted

Parameters

udListDefinitionId int The id of the list definition, indicating which list to delete the items from. Negative numbers indicate TableNumber value instead of UDListDefId. e.g. -64 = category. requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task This method has no return value

DeleteAllFromListNameAsync(string, RequestOptions)

Marks all items in the list deleted

Parameters

udListDefinitionName string The name of the list definition, indicating which list to delete the items from. requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task This method has no return value

DeleteAllHeadingsFromListDefinitionAsync(int, RequestOptions)

Delete all headings for list resolved by the provided id.

Parameters

id int The id of the list to look up. requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task This method has no return value

DeleteAllHeadingsFromNameAsync(string, RequestOptions)

Delete all headings for list resolved by the provided name.

Parameters

name string The name of the list to look up. requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task This method has no return value

DeleteAppTaskMenusAsync(RequestOptions)

Permanentely delete all task menus owned by your app; works in Online only, for registered Apps that send a valid ApplicationToken; otherwise nothing happens

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task This method has no return value

DeleteAppWebPanelsAsync(RequestOptions)

Permanentely delete all web panels owned by your app; works in Online only, for registered Apps that send a valid ApplicationToken; otherwise nothing happens

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task This method has no return value

DeleteDocumentTemplateLanguageAsync(int, string, RequestOptions)

Deletes language variant of the document template

Parameters

documentTemplateId int The id of the document template languageCode string The language code (‘en-US, ‘nb-NO’, etc) requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task This method has no return value

DeleteFromListDefinitionAsync(int, int, RequestOptions)

Delete a list item from the specified list defintion

Parameters

id int The identity of the list item to delete udListDefinitionId int The id of the list definition, indicating which list to delete the items from. Negative numbers indicate TableNumber value instead of UDListDefId. e.g. -64 = category. requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task This method has no return value

DeleteFromListNameAsync(int, string, RequestOptions)

Delete a list item from the specified list defintion

Parameters

id int The identity of the list item to delete udListDefinitionName string The name of the list definition, indicating which list to delete the items from. requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task This method has no return value

DeleteHierarchyEntityAsync(int, RequestOptions)

Deletes the HierarchyEntity

Parameters

hierarchyEntityId int The identity of the HierarchyEntity requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task

DeleteHierarchyFromPathAsync(Domain, string, RequestOptions)

Remove a hierarchy item and its children from a path

Parameters

domain Domain Type of items to get path string Hierarchy path to item to delete requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task This method has no return value

DeleteListEntityAsync(int, RequestOptions)

Deletes the ListEntity

Parameters

listEntityId int The identity of the ListEntity requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task

DeleteListEntityByNameAsync(string, RequestOptions)

Delete a ListEntity resolved by the provided name.

Parameters

name string The name of the list to delete. requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task This method has no return value

DeletePictureFolderEntityAsync(int, RequestOptions)

Deletes the PictureFolderEntity

Parameters

pictureFolderEntityId int The identity of the PictureFolderEntity requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task

DeleteProjectStatusAsync(int, RequestOptions)

Deletes a project status

Parameters

projectStatusId int The project status id to delete requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task No return

DeleteResourceEntityAsync(int, RequestOptions)

Deletes the ResourceEntity

Parameters

resourceEntityId int The identity of the ResourceEntity requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task

DeleteTaskMenuAsync(int, RequestOptions)

Deletes the TaskMenu

Parameters

taskMenuId int The identity of the TaskMenu requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task

DeleteTicketCategoryEntityAsync(int, RequestOptions)

Deletes the TicketCategoryEntity

Parameters

ticketCategoryEntityId int The identity of the TicketCategoryEntity requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task

DeleteTicketPriorityEntityAsync(int, RequestOptions)

Deletes the TicketPriorityEntity

Parameters

ticketPriorityEntityId int The identity of the TicketPriorityEntity requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task

DeleteTicketRelationDefinitionEntityAsync(int, RequestOptions)

Deletes the TicketRelationDefinitionEntity

Parameters

ticketRelationDefinitionEntityId int The identity of the TicketRelationDefinitionEntity requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task

DeleteTicketStatusEntityAsync(int, RequestOptions)

Deletes the TicketStatusEntity

Parameters

ticketStatusEntityId int The identity of the TicketStatusEntity requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task

DeleteTicketTypeEntityAsync(int, RequestOptions)

Deletes the TicketTypeEntity

Parameters

ticketTypeEntityId int The identity of the TicketTypeEntity requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task

DeleteWebPanelAsync(int, RequestOptions)

Hard-delete (real, permanent DELETE in the database) the given web panel. Use with care!

Parameters

id int Database id of web panel to delete requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task This method has no return value

GenerateNavigationUrlAsync(Navigation, string, RequestOptions)

This methods generates the navigation URL to be used to navigate to the panel

Parameters

visibleIn Navigation The visble in/navigation to generate for windowName string The name of the web panel window requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<string&gt; The navigation url

GetAllAutomatedCategoryUpdatesAsync(RequestOptions)

Save the automated category update settings

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<AutomatedCategoryUpdate[]&gt; Returns all settings

GetAllConsentSourceAsync(RequestOptions)

Gets array of all ConsentSource objects.

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ConsentSource[]&gt; Array of all ConsentSource objects

GetAllCountriesAsync(bool, RequestOptions)

Returns all available countries a contact or person could belong to.

Parameters

includeDeleted bool Include deleted items in result? requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<Country[]&gt; An array of all available countries

GetAllCurrenciesAsync(bool, RequestOptions)

Returns all currencies

Parameters

includeDeleted bool Include deleted items in result? requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<CurrencyEntity[]&gt; Array of currencies

GetAllDocumentTemplatesAsync(bool, RequestOptions)

Returns all templates

Parameters

includeDeleted bool Include deleted items in result? requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<DocumentTemplateEntity[]&gt; Array of all template items

GetAllDomainsAsync(RequestOptions)

Get list of all domains

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<Domain[]&gt; Domain types (scripts, extra tables, etc)

GetAllFromListDefinitionAsync(int, bool, RequestOptions)

Get all list items for the specified list defintion

Parameters

udListDefinitionId int The id of the list definition, indicating which list to get the item from. Negative numbers indicate TableNumber value instead of UDListDefId. e.g. -64 = category. includeDeleted bool Include deleted items in result? requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ListItemEntity[]&gt; The list items

GetAllFromListNameAsync(string, bool, RequestOptions)

Get all list items for the specified list defintion

Parameters

udListDefinitionName string The name of the list definition, indicating which list to get the item from. includeDeleted bool Include deleted items in result? requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ListItemEntity[]&gt; The list items

GetAllInDomainAsync(Domain, bool, RequestOptions)

Get all items in a domain

Parameters

domain Domain Type of items to get (scripts, extra tables, etc) children bool Include sub-items? requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<HierarchyEntity[]&gt; All items and child items within a domain

GetAllLegalBaseAsync(RequestOptions)

Gets array of all LegalBase objects.

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<LegalBase[]&gt; Array of all LegalBase objects

GetAllReasonSoldAsync(RequestOptions)

Gets array of all ReasonSold objects.

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ReasonSold[]&gt; Array of all ReasonSold objects

GetAllReasonStalledAsync(RequestOptions)

Gets array of all ReasonStalled objects.

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ReasonStalled[]&gt; Array of all ReasonStalled objects

GetAllSaleStagesAsync(bool, RequestOptions)

Returns all ratings

Parameters

includeDeleted bool Include deleted items in result? requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<SaleStageEntity[]&gt; Array of sale stage ratings

GetAllSaleTypeAsync(RequestOptions)

Returns all sale types as simple list items

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<SaleType[]&gt; Array of simple sale type list items

GetAllSaleTypeEntitiesAsync(bool, RequestOptions)

Returns all sale types as entities with stakeholders, guide and quote properties

Parameters

includeDeleted bool Include deleted items in result? requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<SaleTypeEntity[]&gt; Array of sale type entities with stakeholders, guide and quote properties

GetAllSelectionCategoryAsync(RequestOptions)

Gets array of all SelectionCategory objects.

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<SelectionCategory[]&gt; Array of all SelectionCategory objects

GetAllTasksAsync(bool, RequestOptions)

Returns all appointment tasks

Parameters

includeDeleted bool Include deleted items in result? requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<TaskListItem[]&gt; An array of all available tasks

GetAllTicketPrioritiesAsync(bool, RequestOptions)

Returns all available ticket priorities.

Parameters

includeDeleted bool Include deleted items in result? requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<TicketPriorityEntity[]&gt; An array of all available ticket priorities

GetAllTicketRelationDefinitionEntitiesAsync(RequestOptions)

Returns all non-built-in ticket relation definitions, including their source and destination ticket type associations.

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<TicketRelationDefinitionEntity[]&gt; An array of all non-built-in ticket relation definition entities

GetAmountClassEntityAsync(int, RequestOptions)

Gets a specific AmountClassEntity object.

Parameters

amountClassEntityId int The identifier of the AmountClassEntity object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<AmountClassEntity&gt; AmountClassEntity

GetAppTaskMenusAsync(RequestOptions)

Get all task menus owned by your app; works in Online only, for registered Apps that send a valid ApplicationToken

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<TaskMenu[]&gt; List of all task menus owned by the current App

GetAppWebPanelsAsync(RequestOptions)

Get all web panels owned by your app; works in Online only, for registered Apps that send a valid ApplicationToken

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<WebPanelEntity[]&gt; List of all web panels owned by the current App

GetBaseCurrencyAsync(RequestOptions)

Get the base currency, used for calculating exchange rates

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<CurrencyEntity&gt; The base currency that other currencies are expressed in terms of

GetBusinessAsync(int, RequestOptions)

Gets a specific Business object.

Parameters

businessId int The identifier of the Business object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<Business&gt; Business

GetBusinessListAsync(int[], RequestOptions)

Gets an array of specific Business objects.

Parameters

businessIds int[] The identifiers of the Business object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<Business[]&gt; Array of Business objects

GetBusinessesAsync(RequestOptions)

Returns all available businesses that a contact could have.

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<Business[]&gt; An array of all available businesses

GetCategoriesAsync(RequestOptions)

Returns all categories a contact could belong to

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<Category[]&gt; An array of all available categories

GetCategoryAsync(int, RequestOptions)

Gets a specific Category object.

Parameters

categoryId int The identifier of the Category object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<Category&gt; Category

GetCategoryEntityAsync(int, RequestOptions)

Gets a specific CategoryEntity object.

Parameters

categoryEntityId int The identifier of the CategoryEntity object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<CategoryEntity&gt; CategoryEntity

GetCategoryListAsync(int[], RequestOptions)

Gets an array of specific Category objects.

Parameters

categoryIds int[] The identifiers of the Category object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<Category[]&gt; Array of Category objects

GetCompetitorAsync(int, RequestOptions)

Gets a specific Competitor object.

Parameters

competitorId int The identifier of the Competitor object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<Competitor&gt; Competitor

GetCompetitorListAsync(int[], RequestOptions)

Gets an array of specific Competitor objects.

Parameters

competitorIds int[] The identifiers of the Competitor object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<Competitor[]&gt; Array of Competitor objects

GetCompetitorsAsync(RequestOptions)

Returns all competitors

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<Competitor[]&gt;

GetConsentPurposeAsync(int, RequestOptions)

Gets a specific ConsentPurpose object.

Parameters

consentPurposeId int The identifier of the ConsentPurpose object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ConsentPurpose&gt; ConsentPurpose

GetConsentPurposeListAsync(int[], RequestOptions)

Gets an array of specific ConsentPurpose objects.

Parameters

consentPurposeIds int[] The identifiers of the ConsentPurpose object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ConsentPurpose[]&gt; Array of ConsentPurpose objects

GetConsentPurposesAsync(RequestOptions)

Returns all defined purposes.

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ConsentPurpose[]&gt; An array of all defined purposes

GetConsentSourceAsync(int, RequestOptions)

Gets a specific ConsentSource object.

Parameters

consentSourceId int The identifier of the ConsentSource object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ConsentSource&gt; ConsentSource

GetConsentSourceListAsync(int[], RequestOptions)

Gets an array of specific ConsentSource objects.

Parameters

consentSourceIds int[] The identifiers of the ConsentSource object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ConsentSource[]&gt; Array of ConsentSource objects

GetConsentSourcesAsync(RequestOptions)

Returns all defined Sources.

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ConsentSource[]&gt; An array of all defined Sources

GetCountriesAsync(RequestOptions)

Returns all available countries a contact or person could belong to.

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<Country[]&gt; An array of all available countries

GetCountryAsync(int, RequestOptions)

Gets a specific Country object.

Parameters

countryId int The identifier of the Country object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<Country&gt; Country

GetCountryListAsync(int[], RequestOptions)

Gets an array of specific Country objects.

Parameters

countryIds int[] The identifiers of the Country object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<Country[]&gt; Array of Country objects

GetCreditedAsync(int, RequestOptions)

Gets a specific Credited object.

Parameters

creditedId int The identifier of the Credited object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<Credited&gt; Credited

GetCreditedListAsync(int[], RequestOptions)

Gets an array of specific Credited objects.

Parameters

creditedIds int[] The identifiers of the Credited object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<Credited[]&gt; Array of Credited objects

GetCreditedsAsync(RequestOptions)

Returns all credited

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<Credited[]&gt;

GetCurrenciesAsync(RequestOptions)

Returns all currencies

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<Currency[]&gt; Array of currencies

GetCurrencyAsync(int, RequestOptions)

Gets a specific Currency object.

Parameters

currencyId int The identifier of the Currency object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<Currency&gt; Currency

GetCurrencyEntityAsync(int, RequestOptions)

Gets a specific CurrencyEntity object.

Parameters

currencyEntityId int The identifier of the CurrencyEntity object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<CurrencyEntity&gt; CurrencyEntity

GetCurrencyListAsync(int[], RequestOptions)

Gets an array of specific Currency objects.

Parameters

currencyIds int[] The identifiers of the Currency object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<Currency[]&gt; Array of Currency objects

GetCustomerLanguageAsync(int, RequestOptions)

Gets a specific CustomerLanguage object.

Parameters

customerLanguageId int The identifier of the CustomerLanguage object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<CustomerLanguage&gt; CustomerLanguage

GetCustomerLanguageListAsync(int[], RequestOptions)

Gets an array of specific CustomerLanguage objects.

Parameters

customerLanguageIds int[] The identifiers of the CustomerLanguage object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<CustomerLanguage[]&gt; Array of CustomerLanguage objects

GetCustomerLanguagesAsync(RequestOptions)

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<CustomerLanguage[]&gt;

GetDeliveryTermAsync(int, RequestOptions)

Gets a specific DeliveryTerm object.

Parameters

deliveryTermId int The identifier of the DeliveryTerm object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<DeliveryTerm&gt; DeliveryTerm

GetDeliveryTermsAsync(RequestOptions)

Returns all DeliveryTerms in SuperOffice db.

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<DeliveryTerm[]&gt; An array of all available DeliveryTerms

GetDeliveryTypeAsync(int, RequestOptions)

Gets a specific DeliveryType object.

Parameters

deliveryTypeId int The identifier of the DeliveryType object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<DeliveryType&gt; DeliveryType

GetDeliveryTypesAsync(RequestOptions)

Returns all DeliveryTypes in SuperOffice db.

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<DeliveryType[]&gt; An array of all available DeliveryType

GetDepartmentAsync(int, RequestOptions)

Gets a specific Department object.

Parameters

departmentId int The identifier of the Department object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<Department&gt; Department

GetDepartmentListAsync(int[], RequestOptions)

Gets an array of specific Department objects.

Parameters

departmentIds int[] The identifiers of the Department object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<Department[]&gt; Array of Department objects

GetDepartmentsAsync(RequestOptions)

Getting all departments/user groups for the internal phone list with the user’s colleagues.

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<Department[]&gt; Returns all departments.

GetDocumentTemplateAsync(int, RequestOptions)

Gets a specific DocumentTemplate object.

Parameters

documentTemplateId int The identifier of the DocumentTemplate object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<DocumentTemplate&gt; DocumentTemplate

GetDocumentTemplateEntityAsync(int, RequestOptions)

Gets a specific DocumentTemplateEntity object.

Parameters

documentTemplateEntityId int The identifier of the DocumentTemplateEntity object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<DocumentTemplateEntity&gt; DocumentTemplateEntity

GetDocumentTemplateExtensionAsync(int, RequestOptions)

Get the file extension for the document template

Parameters

documentTemplateId int The primary key of the document template requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<string&gt; File name extension including ’.’: ‘.doc’ or ‘.xlsx’

GetDocumentTemplateLanguagesAsync(int, RequestOptions)

Get the supported language variations for a document template

Parameters

documentTemplateId int The id of the document template requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<string[]&gt; Returns the list of languages as ISO cultures (en-US, no, sv, etc)

GetDocumentTemplateListAsync(int[], RequestOptions)

Gets an array of specific DocumentTemplate objects.

Parameters

documentTemplateIds int[] The identifiers of the DocumentTemplate object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<DocumentTemplate[]&gt; Array of DocumentTemplate objects

GetDocumentTemplatePropertiesAsync(int, string[], RequestOptions)

Get document template properties

Parameters

documentTemplateId int The primary key id of the document template requestedProperties string[] An array of properties to get the values for requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<StringDictionary&gt; Dictionary of key=value pairs of requested properties

GetDocumentTemplateStreamFromIdAsync(int, string, string, RequestOptions)

Retrieve a stream to a document template based on its id

Parameters

documentTemplateId int Id of template to retrieve languageCode string Language variation of template to use. (ISO code: “en-US” or “nb-NO” etc). Used to select a template of the appropriate language. Can be overridden in SO ARC by user preference “PreferDocLang”. returnContentType string Accept content-type. Default “application/octet-stream”. Could also be “application/pdf”, “text/plain”, “text/html”, or “multipart/related” requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<byte[]&gt; Open stream to the template content

GetDocumentTemplateTaskAsync(int, RequestOptions)

Returns a Document Template list item as a TaskListItem. The appointment’s task is a Document template item when the appointment is a document.

Parameters

documentTemplateId int Id of the document template, i.e. the Appointment.TaskIdx requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<SoTask&gt; Document Template item as TaskListItem.

GetDocumentTemplateUrlAsync(int, bool, string, RequestOptions)

Get a url to the document template

Parameters

documentTemplateId int The id of the template writableUrl bool Get a writeable url to the document template? languageCode string The language code (‘en-US’, ‘nb-NO’, etc). Use empty string if not supported or used. requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<string&gt; The URL to the document template

GetDocumentTemplateUsedInProjectStageAsync(int, RequestOptions)

Get a String array of names in project guide that this template is used in

Parameters

documentTemplateId int The id of the template requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<string[]&gt; The name of the projectguides that use this template

GetDocumentTemplateUsedInSalesStageAsync(int, RequestOptions)

Get a String array of names in sales guide that this template is used in

Parameters

documentTemplateId int The id of the template requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<string[]&gt; The name of the salesguides that use this template

GetDocumentTemplatesAsync(RequestOptions)

Returns all available document templates

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<DocumentTemplate[]&gt; Array of DocumentTemplates

GetDocumentTemplatesTasksAsync(RequestOptions)

The appointment’s task is a Document template item when the appointment is a document.

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<SoTask[]&gt; Document Template list as a array of Tasks

GetDocumentTypesForPluginAsync(int, RequestOptions)

Get a list of document types supported by a given document plugin. Use the document template type when creating a new template.

Parameters

pluginId int Numeric document plugin id, corresponding to the doctmpl.AutoeventId, doctmpl.LoadTemplateFromPlugin. requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<IntStringDictionary&gt; Dictionary mapping document type id=name

GetEmarketingStrictModeAsync(RequestOptions)

Get the value of the Emarketing strict mode setting

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<bool&gt; Returns true if Emarkerint strict mode is set, false otherwise

GetExtAppEntityAsync(int, RequestOptions)

Gets a specific ExtAppEntity object.

Parameters

extAppEntityId int The identifier of the ExtAppEntity object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ExtAppEntity&gt; ExtAppEntity

GetFromListDefinitionAsync(int, int, RequestOptions)

Get a list item for the specified list defintion

Parameters

id int The identity of the list item to load udListDefinitionId int The id of the list definition, indicating which list to get the item from. Negative numbers indicate TableNumber value instead of UDListDefId. e.g. -64 = category. requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ListItemEntity&gt; The loaded list item

GetFromListNameAsync(int, string, RequestOptions)

Get a list item for the specified list defintion

Parameters

id int The identity of the list item to load udListDefinitionName string The name of the list definition, indicating which list to get the item from. requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ListItemEntity&gt; The loaded list item

GetHeadingEntityAsync(int, RequestOptions)

Gets a specific HeadingEntity object.

Parameters

headingEntityId int The identifier of the HeadingEntity object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<HeadingEntity&gt; HeadingEntity

GetHeadingsAsync(int, int, bool, RequestOptions)

Gets a selectable MDO list of the headings for this list item

Parameters

udListDefinitionId int The id of the list. Negative numbers indicate TableNumber value instead of UDListDefId. e.g. -64 = category. listItemId int The id of the list item showDeleted bool Set to true if you want deleted headings requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<SelectableMDOListItem[]&gt; Array of headings

GetHeadingsForListItemFromListNameAsync(string, int, bool, RequestOptions)

Gets a selectable MDO list of the headings for this list item

Parameters

udListDefinitionName string The name of the list definition, indicating which list to delete the items from. listItemId int The id of the list item showDeleted bool Set to true if you want deleted headings requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<SelectableMDOListItem[]&gt; Array of headings

GetHeadingsFromListDefinitionAsync(int, RequestOptions)

Gets headings for list resolved by the provided id.

Parameters

id int The id of the list to look up. requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<HeadingEntity[]&gt; List of headings

GetHeadingsFromNameAsync(string, RequestOptions)

Gets headings for list resolved by the provided name.

Parameters

name string The name of the list to look up. requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<HeadingEntity[]&gt; List of headings

GetHierarchyEntityAsync(int, RequestOptions)

Gets a specific HierarchyEntity object.

Parameters

hierarchyEntityId int The identifier of the HierarchyEntity object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<HierarchyEntity&gt; HierarchyEntity

GetHierarchyFromPathAsync(Domain, string, bool, RequestOptions)

Get a hierarchy item from a path

Parameters

domain Domain Type of items to get path string Hierarchy path to item children bool Include sub-items? requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<HierarchyEntity&gt; The hierarchy node at the path

GetInstalledLanguagesAsync(RequestOptions)

Returns the list of all languages installed in this database.

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<LanguageInfo[]&gt; Array of installed languages

GetLanguageInfoAsync(int, RequestOptions)

Gets a specific LanguageInfo object.

Parameters

languageInfoId int The identifier of the LanguageInfo object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<LanguageInfo&gt; LanguageInfo

GetLanguageInfoListAsync(int[], RequestOptions)

Gets an array of specific LanguageInfo objects.

Parameters

languageInfoIds int[] The identifiers of the LanguageInfo object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<LanguageInfo[]&gt; Array of LanguageInfo objects

GetLegalBaseAsync(int, RequestOptions)

Gets a specific LegalBase object.

Parameters

legalBaseId int The identifier of the LegalBase object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<LegalBase&gt; LegalBase

GetLegalBaseListAsync(int[], RequestOptions)

Gets an array of specific LegalBase objects.

Parameters

legalBaseIds int[] The identifiers of the LegalBase object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<LegalBase[]&gt; Array of LegalBase objects

GetLegalBasesAsync(RequestOptions)

Returns all defined bases.

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<LegalBase[]&gt; An array of all defined bases

GetLinkAsync(int, RequestOptions)

Gets a specific Link object.

Parameters

linkId int The identifier of the Link object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<Link&gt; Link

GetLinkListAsync(int[], RequestOptions)

Gets an array of specific Link objects.

Parameters

linkIds int[] The identifiers of the Link object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<Link[]&gt; Array of Link objects

GetListDefinitionsAsync(bool, RequestOptions)

Get a list of the lists - built-in and user-defined.

Parameters

includeDeleted bool Include deleted items in result? requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ListEntity[]&gt; The list definitions

GetListEntityAsync(int, RequestOptions)

Gets a specific ListEntity object.

Parameters

listEntityId int The identifier of the ListEntity object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ListEntity&gt; ListEntity

GetListEntityByNameAsync(string, RequestOptions)

Gets a ListEntity resolved by the provided name.

Parameters

name string The name of the list to look up. requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ListEntity&gt; A ListEntity or null.

GetListItemsForHeadingAsync(int, int, RequestOptions)

List of list items that is selected if under this heading

Parameters

udListDefinitionId int The id of the list. Negative numbers indicate TableNumber value instead of UDListDefId. e.g. -64 = category. headingId int The id of the heading requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<SelectableMDOListItem[]&gt; Array of selectable list items

GetListItemsForHeadingFromListNameAsync(string, int, RequestOptions)

List of list items that is selected if under this heading

Parameters

udListDefinitionName string The name of the list definition. headingId int The id of the heading requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<SelectableMDOListItem[]&gt; Array of selectable list items

GetListItemsForUserGroupAsync(int, int, RequestOptions)

List of list items that is visible in the usergroup

Parameters

udListDefinitionId int The id of the list. Negative numbers indicate TableNumber value instead of UDListDefId. e.g. -64 = category. groupId int The id of the usergroup requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<SelectableMDOListItem[]&gt; Array of selectable list items

GetListItemsForUserGroupFromListNameAsync(string, int, RequestOptions)

List of list items that is visible in the usergroup

Parameters

udListDefinitionName string The name of the list definition. groupId int The id of the usergroup requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<SelectableMDOListItem[]&gt; Array of selectable list items

GetLocalizedTextAsync(int, RequestOptions)

Gets a specific LocalizedText object.

Parameters

localizedTextId int The identifier of the LocalizedText object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<LocalizedText&gt; LocalizedText

GetLocalizedTextByTypeAsync(LocalizedTextType, int, int, RequestOptions)

Returns a localized text based on the resource id for the selected language.

Parameters

textType LocalizedTextType Type of the localized text resourceId int The resource id. This id has different meaning based on the LocalizedTextType. languageId int The LCID number of the language. requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<LocalizedText&gt; A LocalizedText carrier.

GetLocalizedTextListAsync(int[], RequestOptions)

Gets an array of specific LocalizedText objects.

Parameters

localizedTextIds int[] The identifiers of the LocalizedText object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<LocalizedText[]&gt; Array of LocalizedText objects

GetLocalizedTextsAsync(RequestOptions)

Gets all localized texts in the CRM database.

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<LocalizedText[]&gt; Array of LocalizedText objects

GetLocalizedTextsByLanguageIdAsync(int, RequestOptions)

Gets all localized text belonging to a specific language.

Parameters

languageId int The LCID number of the language. requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<LocalizedText[]&gt; Array of LocalizedText objects

GetLocalizedTextsByTypeAsync(LocalizedTextType[], RequestOptions)

Gets localized text by their type

Parameters

textTypes LocalizedTextType[] Array of LocalizedTextTypes. If null all texts are returned. requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<LocalizedText[]&gt; Array of LocalizedText objects

GetMrMrsAsync(int, RequestOptions)

Gets a specific MrMrs object.

Parameters

mrMrsId int The identifier of the MrMrs object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<MrMrs&gt; MrMrs

GetMrMrsListAsync(int[], RequestOptions)

Gets an array of specific MrMrs objects.

Parameters

mrMrsIds int[] The identifiers of the MrMrs object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<MrMrs[]&gt; Array of MrMrs objects

GetMrMrsesAsync(RequestOptions)

Returns all Items from the MrMrs table sorted by their value.

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<MrMrs[]&gt; All items from the MrMrs table sorted by their value

GetNeedCategoryUpdateForPersonAsync(int, int, int, int, RequestOptions)

Before saving a person with changed leadstatus, call this to see if we should ask for a userconfirmation to automatically update category on contact or person

Parameters

leadStatus int The new leadstatus that might trigger the category update personId int The person id that might trigger the category update contactId int The contact id that might get the resulting update categoryId int The person id that might get the resulting update requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<AutomatedCategoryUpdate&gt; Returns the info on the trigger that will update with userconfirmation. Returns void if no update or no need for confirmation

GetNeedCategoryUpdateForSaleAsync(SaleStatus, int, int, int, RequestOptions)

Before saving a sale, call this to see if the current changes on the sale should result in a userconfirmation dialog asking to automatically update category on contact or person

Parameters

saleStatus SaleStatus The new salestatus that might trigger the category update saleId int The sale id that might trigger the category update contactId int The contact id that might get the resulting update personId int The person id that might get the resulting update requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<AutomatedCategoryUpdate&gt; Returns the info on the trigger that will update with userconfirmation. Returns void if no update or no need for confirmation

GetOurCurrencyAsync(RequestOptions)

Gets the Our currency object if currency is enabled

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<Currency&gt; Our currency

GetOwnerCompanysCurrencyAsync(RequestOptions)

Get the currency of the user’s owner company

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<Currency&gt; Currency of the user’s owner company

GetPaymentTermAsync(int, RequestOptions)

Gets a specific PaymentTerm object.

Parameters

paymentTermId int The identifier of the PaymentTerm object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<PaymentTerm&gt; PaymentTerm

GetPaymentTermsAsync(RequestOptions)

Returns all PaymentTerms in SuperOffice db.

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<PaymentTerm[]&gt; An array of all available PaymentTerms

GetPaymentTypeAsync(int, RequestOptions)

Gets a specific PaymentType object.

Parameters

paymentTypeId int The identifier of the PaymentType object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<PaymentType&gt; PaymentType

GetPaymentTypesAsync(RequestOptions)

Returns all PaymentTypes in SuperOffice db.

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<PaymentType[]&gt; An array of all available PaymentTypes

GetPictureFolderEntityAsync(int, RequestOptions)

Gets a specific PictureFolderEntity object.

Parameters

pictureFolderEntityId int The identifier of the PictureFolderEntity object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<PictureFolderEntity&gt; PictureFolderEntity

GetPluginCapabilitiesAsync(int, RequestOptions)

Get a list of plugin-dependent capabilities for a given document archive plugin.<br/>A standard set of properties is defined in SuperOffice.CRM.Documents.Constants.Capabilities.

Parameters

pluginId int Numeric document plugin id, corresponding to the document.archiveProvider id or doctmpl.AutoeventId. requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<StringDictionary&gt; Dictionary mapping capability names=values

GetPluginListAsync(RequestOptions)

Get a list of installed document plugins

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<StringDictionary&gt; Dictionary mapping plugin id=plugin name

GetPositionAsync(int, RequestOptions)

Gets a specific Position object.

Parameters

positionId int The identifier of the Position object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<Position&gt; Position

GetPositionListAsync(int[], RequestOptions)

Gets an array of specific Position objects.

Parameters

positionIds int[] The identifiers of the Position object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<Position[]&gt; Array of Position objects

GetPositionsAsync(RequestOptions)

Returns all the positions a person could have.

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<Position[]&gt; An array of all available positions

GetPrioritiesAsync(RequestOptions)

Returns all priorities an appointment could have.

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<Priority[]&gt; An array of all available priorities

GetPriorityAsync(int, RequestOptions)

Gets a specific Priority object.

Parameters

priorityId int The identifier of the Priority object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<Priority&gt; Priority

GetPriorityListAsync(int[], RequestOptions)

Gets an array of specific Priority objects.

Parameters

priorityIds int[] The identifiers of the Priority object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<Priority[]&gt; Array of Priority objects

GetProductCategoriesAsync(RequestOptions)

Returns all ProductCategories in SuperOffice list.

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ProductCategory[]&gt; An array of all available ProductCategory

GetProductCategoryAsync(int, RequestOptions)

Gets a specific ProductCategory object.

Parameters

productCategoryId int The identifier of the ProductCategory object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ProductCategory&gt; ProductCategory

GetProductFamiliesAsync(RequestOptions)

Returns all ProductFamily in SuperOffice list.

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ProductFamily[]&gt; An array of all available ProductFamilies

GetProductFamilyAsync(int, RequestOptions)

Gets a specific ProductFamily object.

Parameters

productFamilyId int The identifier of the ProductFamily object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ProductFamily&gt; ProductFamily

GetProductTypeAsync(int, RequestOptions)

Gets a specific ProductType object.

Parameters

productTypeId int The identifier of the ProductType object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ProductType&gt; ProductType

GetProductTypesAsync(RequestOptions)

Returns all ProductTypes in SuperOffice list.

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ProductType[]&gt; An array of all available ProductTypes

GetProjectStatusAsync(int, RequestOptions)

Gets a specific ProjectStatus object.

Parameters

projectStatusId int The identifier of the ProjectStatus object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ProjectStatus&gt; ProjectStatus

GetProjectStatusListAsync(int[], RequestOptions)

Gets an array of specific ProjectStatus objects.

Parameters

projectStatusIds int[] The identifiers of the ProjectStatus object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ProjectStatus[]&gt; Array of ProjectStatus objects

GetProjectStatusesAsync(RequestOptions)

Gets all items from the Project Status (ProjStatus) table.

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ProjectStatus[]&gt; List of all Project statuses.

GetProjectTypeAsync(int, RequestOptions)

Gets a specific ProjectType object.

Parameters

projectTypeId int The identifier of the ProjectType object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ProjectType&gt; ProjectType

GetProjectTypeEntityAsync(int, RequestOptions)

Gets a specific ProjectTypeEntity object.

Parameters

projectTypeEntityId int The identifier of the ProjectTypeEntity object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ProjectTypeEntity&gt; ProjectTypeEntity

GetProjectTypeListAsync(int[], RequestOptions)

Gets an array of specific ProjectType objects.

Parameters

projectTypeIds int[] The identifiers of the ProjectType object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ProjectType[]&gt; Array of ProjectType objects

GetProjectTypesAsync(RequestOptions)

Gets all items from the Project Type (ProjType) table.

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ProjectType[]&gt; List of all project types.

GetQuickRepliesAsync(RequestOptions)

Method to return all quick replies for a given associate

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<QuickReply[]&gt; Array of quick replies

GetQuoteApproveReasonAsync(int, RequestOptions)

Gets a specific QuoteApproveReason object.

Parameters

quoteApproveReasonId int The identifier of the QuoteApproveReason object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<QuoteApproveReason&gt; QuoteApproveReason

GetQuoteApproveReasonListAsync(int[], RequestOptions)

Gets an array of specific QuoteApproveReason objects.

Parameters

quoteApproveReasonIds int[] The identifiers of the QuoteApproveReason object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<QuoteApproveReason[]&gt; Array of QuoteApproveReason objects

GetQuoteApproveReasonsAsync(RequestOptions)

Returns all available QuoteApproveReasons.

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<QuoteApproveReason[]&gt; An array of all non-deleted QuoteApproveReason

GetQuoteDenyReasonAsync(int, RequestOptions)

Gets a specific QuoteDenyReason object.

Parameters

quoteDenyReasonId int The identifier of the QuoteDenyReason object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<QuoteDenyReason&gt; QuoteDenyReason

GetQuoteDenyReasonListAsync(int[], RequestOptions)

Gets an array of specific QuoteDenyReason objects.

Parameters

quoteDenyReasonIds int[] The identifiers of the QuoteDenyReason object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<QuoteDenyReason[]&gt; Array of QuoteDenyReason objects

GetQuoteDenyReasonsAsync(RequestOptions)

Returns all available QuoteDenyReasons.

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<QuoteDenyReason[]&gt; An array of all non-deleted QuoteDenyReason

GetRatingAsync(int, RequestOptions)

Gets a specific Rating object.

Parameters

ratingId int The identifier of the Rating object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<Rating&gt; Rating

GetRatingListAsync(int[], RequestOptions)

Gets an array of specific Rating objects.

Parameters

ratingIds int[] The identifiers of the Rating object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<Rating[]&gt; Array of Rating objects

GetRatingsAsync(RequestOptions)

Returns all ratings

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<Rating[]&gt; Array of ratings

GetReasonAsync(int, RequestOptions)

Gets a specific Reason object.

Parameters

reasonId int The identifier of the Reason object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<Reason&gt; Reason

GetReasonListAsync(int[], RequestOptions)

Gets an array of specific Reason objects.

Parameters

reasonIds int[] The identifiers of the Reason object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<Reason[]&gt; Array of Reason objects

GetReasonSoldAsync(int, RequestOptions)

Gets a specific ReasonSold object.

Parameters

reasonSoldId int The identifier of the ReasonSold object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ReasonSold&gt; ReasonSold

GetReasonSoldListAsync(int[], RequestOptions)

Gets an array of specific ReasonSold objects.

Parameters

reasonSoldIds int[] The identifiers of the ReasonSold object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ReasonSold[]&gt; Array of ReasonSold objects

GetReasonStalledAsync(int, RequestOptions)

Gets a specific ReasonStalled object.

Parameters

reasonStalledId int The identifier of the ReasonStalled object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ReasonStalled&gt; ReasonStalled

GetReasonStalledListAsync(int[], RequestOptions)

Gets an array of specific ReasonStalled objects.

Parameters

reasonStalledIds int[] The identifiers of the ReasonStalled object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ReasonStalled[]&gt; Array of ReasonStalled objects

GetReasonsAsync(RequestOptions)

Returns all reasons

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<Reason[]&gt; Array of reasons

GetRelationDefinitionEntityAsync(int, RequestOptions)

Gets a specific RelationDefinitionEntity object.

Parameters

relationDefinitionEntityId int The identifier of the RelationDefinitionEntity object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<RelationDefinitionEntity&gt; RelationDefinitionEntity

GetResourceEntityAsync(int, RequestOptions)

Gets a specific ResourceEntity object.

Parameters

resourceEntityId int The identifier of the ResourceEntity object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ResourceEntity&gt; ResourceEntity

GetSaleStageEntityAsync(int, RequestOptions)

Gets a specific SaleStageEntity object.

Parameters

saleStageEntityId int The identifier of the SaleStageEntity object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<SaleStageEntity&gt; SaleStageEntity

GetSaleTypeAsync(int, RequestOptions)

Gets a specific SaleType object.

Parameters

saleTypeId int The identifier of the SaleType object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<SaleType&gt; SaleType

GetSaleTypeEntityAsync(int, RequestOptions)

Gets a specific SaleTypeEntity object.

Parameters

saleTypeEntityId int The identifier of the SaleTypeEntity object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<SaleTypeEntity&gt; SaleTypeEntity

GetSaleTypeListAsync(int[], RequestOptions)

Gets an array of specific SaleType objects.

Parameters

saleTypeIds int[] The identifiers of the SaleType object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<SaleType[]&gt; Array of SaleType objects

GetSelectionCategoryAsync(int, RequestOptions)

Gets a specific SelectionCategory object.

Parameters

selectionCategoryId int The identifier of the SelectionCategory object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<SelectionCategory&gt; SelectionCategory

GetSelectionCategoryListAsync(int[], RequestOptions)

Gets an array of specific SelectionCategory objects.

Parameters

selectionCategoryIds int[] The identifiers of the SelectionCategory object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<SelectionCategory[]&gt; Array of SelectionCategory objects

GetSoTaskAsync(int, RequestOptions)

Gets a specific SoTask object.

Parameters

soTaskId int The identifier of the SoTask object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<SoTask&gt; SoTask

GetSourceAsync(int, RequestOptions)

Gets a specific Source object.

Parameters

sourceId int The identifier of the Source object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<Source&gt; Source

GetSourceListAsync(int[], RequestOptions)

Gets an array of specific Source objects.

Parameters

sourceIds int[] The identifiers of the Source object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<Source[]&gt; Array of Source objects

GetSourcesAsync(RequestOptions)

Returns all sources

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<Source[]&gt; Array of sources

GetTaskListAsync(int[], RequestOptions)

Gets an array of specific SoTask objects.

Parameters

soTaskIds int[] The identifiers of the SoTask object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<SoTask[]&gt; Array of SoTask objects

GetTaskMenuAsync(int, RequestOptions)

Gets a specific TaskMenu object.

Parameters

taskMenuId int The identifier of the TaskMenu object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<TaskMenu&gt; TaskMenu

GetTaskMenuByProgIdAsync(string, RequestOptions)

Get a task menu using the ProgId key that was specified when it was created

Parameters

progId string String key that can be used to uniquely retrieve the taskmenu, set in the TaskMenu when saving requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<TaskMenu&gt; The task menu

GetTasksAsync(RequestOptions)

Returns all appointment tasks

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<SoTask[]&gt; An array of all available tasks

GetTicketCategoriesAsync(RequestOptions)

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<TicketCategoryEntity[]&gt;

GetTicketCategoriesForUserGroupsAsync(int[], RequestOptions)

Ticket categories for user groups

Parameters

userGroupIds int[] The ids of the user groups we want tickets categories from requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<MDOListItem[]&gt;

GetTicketCategoryAsync(int, RequestOptions)

Gets a specific TicketCategory object.

Parameters

ticketCategoryId int The identifier of the TicketCategory object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<TicketCategory&gt; TicketCategory

GetTicketCategoryEntityAsync(int, RequestOptions)

Gets a specific TicketCategoryEntity object.

Parameters

ticketCategoryEntityId int The identifier of the TicketCategoryEntity object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<TicketCategoryEntity&gt; TicketCategoryEntity

GetTicketCategoryListAsync(int[], RequestOptions)

Gets an array of specific TicketCategoryEntity objects.

Parameters

ticketCategoryEntityIds int[] The identifiers of the TicketCategoryEntity object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<TicketCategoryEntity[]&gt; Array of TicketCategoryEntity objects

GetTicketPrioritiesAsync(RequestOptions)

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<TicketPriority[]&gt;

GetTicketPriorityAsync(int, RequestOptions)

Gets a specific TicketPriority object.

Parameters

ticketPriorityId int The identifier of the TicketPriority object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<TicketPriority&gt; TicketPriority

GetTicketPriorityEntityAsync(int, RequestOptions)

Gets a specific TicketPriorityEntity object.

Parameters

ticketPriorityEntityId int The identifier of the TicketPriorityEntity object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<TicketPriorityEntity&gt; TicketPriorityEntity

GetTicketPriorityListAsync(int[], RequestOptions)

Gets an array of specific TicketPriority objects.

Parameters

ticketPriorityIds int[] The identifiers of the TicketPriority object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<TicketPriority[]&gt; Array of TicketPriority objects

GetTicketRelationDefinitionEntityAsync(int, RequestOptions)

Gets a specific TicketRelationDefinitionEntity object.

Parameters

ticketRelationDefinitionEntityId int The identifier of the TicketRelationDefinitionEntity object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<TicketRelationDefinitionEntity&gt; TicketRelationDefinitionEntity

GetTicketStatusEntityAsync(int, RequestOptions)

Gets a specific TicketStatusEntity object.

Parameters

ticketStatusEntityId int The identifier of the TicketStatusEntity object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<TicketStatusEntity&gt; TicketStatusEntity

GetTicketStatusListAsync(int[], RequestOptions)

Gets an array of specific TicketStatusEntity objects.

Parameters

ticketStatusEntityIds int[] The identifiers of the TicketStatusEntity object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<TicketStatusEntity[]&gt; Array of TicketStatusEntity objects

GetTicketStatusesAsync(RequestOptions)

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<TicketStatusEntity[]&gt;

GetTicketTypeEntityAsync(int, RequestOptions)

Gets a specific TicketTypeEntity object.

Parameters

ticketTypeEntityId int The identifier of the TicketTypeEntity object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<TicketTypeEntity&gt; TicketTypeEntity

GetTicketTypeListAsync(int[], RequestOptions)

Gets an array of specific TicketTypeEntity objects.

Parameters

ticketTypeEntityIds int[] The identifiers of the TicketTypeEntity object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<TicketTypeEntity[]&gt; Array of TicketTypeEntity objects

GetTicketTypesAsync(RequestOptions)

Get all TicketTypes

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<TicketTypeEntity[]&gt;

GetVisibleForUserGroupsAsync(int, int, RequestOptions)

List of User groups that this list item is visible for

Parameters

udListDefinitionId int The id of the list. Negative numbers indicate TableNumber value instead of UDListDefId. e.g. -64 = category. listItemId int The id of the list item requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<SelectableMDOListItem[]&gt; Array of selectable user groups

GetVisibleForUserGroupsFromListNameAsync(string, int, RequestOptions)

List of User groups that this list item is visible for

Parameters

udListDefinitionName string The name of the list definition. listItemId int The id of the list item requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<SelectableMDOListItem[]&gt; Array of selectable user groups

GetWebPanelByProgIdAsync(string, RequestOptions)

Get a web panel using the ProgId key that was specified when it was created

Parameters

progId string String key that can be used to uniquely retrieve the panel, set in the WebPanelEntity when saving requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<WebPanelEntity&gt; The Web panel information

GetWebPanelEntityAsync(int, RequestOptions)

Gets a specific WebPanelEntity object.

Parameters

webPanelEntityId int The identifier of the WebPanelEntity object requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<WebPanelEntity&gt; WebPanelEntity

GetWebPanelListAsync(RequestOptions)

Return a list of all web panels.

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<WebPanelEntity[]&gt; List of all web panels

GlobalChangeTicketStatusAsync(int, int, RequestOptions)

This method will change all references from one ticket status to another. Typically used in conjuction with delete

Parameters

fromTicketStatusId int The id of the ticket status to change from toTicketStatusId int The id of the ticket status to change to requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task Does not return anything

GlobalChangeTicketTypeAsync(int, int, RequestOptions)

Change all references from one ticket type to another. Typically used in conjuction with ticket type delete

Parameters

fromTicketTypeId int The id of the ticket type to change from toTicketTypeId int The id of the ticket type to change to requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task This method has no return value

MoveAllTicketsAsync(int, int, RequestOptions)

Move all tickets from one ticket category to another

Parameters

fromTicketCategoryId int The id of the category we want to move tickets from toTicketCategoryId int The id of the category we want to move the tickets to requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task This method has no return value

MoveListItemAsync(int, int, int, RequestOptions)

Move a list item up or down in the list based on rank

Parameters

udListDefinitionId int Id of the list. Negative numbers indicate TableNumber value instead of UDListDefId. e.g. -64 = category. listItemId int Id of the list item direction int -1 moves the item up one position, 1 moves the item down one position requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task

PerformNeededCategoryUpdateAsync(int, int, int, AutomatedCategoryUpdate, RequestOptions)

Does the actual update of the category. Ask the user first, if user confirmed yes, do automatically update category, this call will do that actual update

Parameters

personId int The person id that will get the resulting update contactId int The contact id that will get the resulting update categoryId int The category id person and contact will be updated to setting AutomatedCategoryUpdate The setting that triggered the update requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task This method has no return value

RebuildFullnamesAsync(RequestOptions)

Update the fullname field of all categories. Use this e.g. when changing parentId or renaming a category with children.

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task This method has no return value

SaveAllAutomatedCategoryUpdatesAsync(AutomatedCategoryUpdate[], RequestOptions)

Save the automated category update settings

Parameters

settings AutomatedCategoryUpdate[] All settings for autoupdate category requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<AutomatedCategoryUpdate[]&gt; Returns the saved settings

SaveAllFromListDefinitionAsync(int, ListItemEntity[], RequestOptions)

Save all list items for the specified list defintion

Parameters

udListDefinitionId int The id of the list definition, indicating which list to save the items to. Negative numbers indicate TableNumber value instead of UDListDefId. e.g. -64 = category. items ListItemEntity[] The list items requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ListItemEntity[]&gt; The list items

SaveAllFromListNameAsync(string, ListItemEntity[], RequestOptions)

Save all list items for the specified list defintion

Parameters

udListDefinitionName string The name of the list definition, indicating which list to save the items to. items ListItemEntity[] The list items requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ListItemEntity[]&gt; The list items

SaveAmountClassEntityAsync(AmountClassEntity, RequestOptions)

Updates the existing AmountClassEntity or creates a new AmountClassEntity if the id parameter is 0.

Parameters

amountClassEntity AmountClassEntity The AmountClassEntity that is saved. requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<AmountClassEntity&gt; New or updated AmountClassEntity

SaveCategoryEntityAsync(CategoryEntity, RequestOptions)

Updates the existing CategoryEntity or creates a new CategoryEntity if the id parameter is 0.

Parameters

categoryEntity CategoryEntity The CategoryEntity that is saved. requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<CategoryEntity&gt; New or updated CategoryEntity

SaveConsentPurposeAsync(ConsentPurpose, RequestOptions)

Save a ConsentPurpose object

Parameters

consentPurpose ConsentPurpose The ConsentPurpose object to save requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ConsentPurpose&gt; The saved ConsentPurpose object, updated with the ConsentPurposeId if it is a new database entry

SaveConsentSourceAsync(ConsentSource, RequestOptions)

Parameters

consentSource ConsentSource requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ConsentSource&gt;

SaveCountryAsync(Country, RequestOptions)

Saves a country

Parameters

country Country The country to save requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<Country&gt; The country that is saved

SaveCurrencyEntityAsync(CurrencyEntity, RequestOptions)

Updates the existing CurrencyEntity or creates a new CurrencyEntity if the id parameter is 0.

Parameters

currencyEntity CurrencyEntity The CurrencyEntity that is saved. requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<CurrencyEntity&gt; New or updated CurrencyEntity

SaveDocumentTemplateEntityAsync(DocumentTemplateEntity, RequestOptions)

Updates the existing DocumentTemplateEntity or creates a new DocumentTemplateEntity if the id parameter is 0.

Parameters

documentTemplateEntity DocumentTemplateEntity The DocumentTemplateEntity that is saved. requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<DocumentTemplateEntity&gt; New or updated DocumentTemplateEntity

SaveDocumentTemplateStreamAsync(int, byte[], string, int, RequestOptions)

Writes content in stream to document template file

Parameters

documentTemplateId int Identifier for document template content byte[] Stream containing content to be saved to document template file languageCode string Language variation of template to update. (ISO code: “en-US” or “nb-NO” etc). Used to select a template of the appropriate language. Can be overridden in SO ARC by user preference “PreferDocLang”. pluginId int Plugin to use for storing document content. 0 = SOARC. Use -1 to use the plugin specified in the template. requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<TemplateInfo&gt; Template info

SaveExtAppEntityAsync(ExtAppEntity, RequestOptions)

Updates the existing ExtAppEntity or creates a new ExtAppEntity if the id parameter is 0.

Parameters

extAppEntity ExtAppEntity The ExtAppEntity that is saved. requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ExtAppEntity&gt; New or updated ExtAppEntity

SaveFromListDefinitionAsync(int, int, ListItemEntity, RequestOptions)

Save a list item for the specified list defintion

Parameters

id int The identity of the list item to load udListDefinitionId int The id of the list definition, indicating which list to save the item to. Negative numbers indicate TableNumber value instead of UDListDefId. e.g. -64 = category. item ListItemEntity The item to save requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ListItemEntity&gt; The saved list item

SaveFromListNameAsync(int, string, ListItemEntity, RequestOptions)

Save a list item for the specified list defintion

Parameters

id int The identity of the list item to load udListDefinitionName string The name of the list definition, indicating which list to save the item to. item ListItemEntity The item to save requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ListItemEntity&gt; The saved list item

SaveHeadingEntityAsync(HeadingEntity, RequestOptions)

Updates the existing HeadingEntity or creates a new HeadingEntity if the id parameter is 0.

Parameters

headingEntity HeadingEntity The HeadingEntity that is saved. requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<HeadingEntity&gt; New or updated HeadingEntity

SaveHeadingFromListDefinitionAsync(int, HeadingEntity, RequestOptions)

Save new heading for list resolved by the provided id.

Parameters

id int The id of the list to look up. entity HeadingEntity The new heading to save requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<HeadingEntity&gt; The saved entity.

SaveHeadingFromNameAsync(string, HeadingEntity, RequestOptions)

Save new heading for list resolved by the provided name.

Parameters

name string The name of the list to look up. entity HeadingEntity The new heading to save requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<HeadingEntity&gt; The saved entity.

SaveHeadingsForListItemFromListDefinitionAsync(int, int, SelectableMDOListItem[], RequestOptions)

Saves the active headings for the list item.

Parameters

udListDefinitionId int The id of the list definition, indicating which list to delete the items from. Negative numbers indicate TableNumber value instead of UDListDefId. e.g. -64 = category. listItemId int The identity of the list item to delete headings SelectableMDOListItem[] The headings to save. requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<SelectableMDOListItem[]&gt; Array of headings

SaveHeadingsForListItemFromListNameAsync(string, int, SelectableMDOListItem[], RequestOptions)

Saves the headings for the list item.

Parameters

udListDefinitionName string The name of the list definition, indicating which list to update. listItemId int The identity of the list item headings SelectableMDOListItem[] The headings to save. requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<SelectableMDOListItem[]&gt; Array of selectable headings

SaveHeadingsFromListDefinitionAsync(int, HeadingEntity[], RequestOptions)

Save headings for list resolved by the provided id.

Parameters

id int The id of the list to look up. entities HeadingEntity[] The headings to save requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<HeadingEntity[]&gt; List of headings

SaveHeadingsFromNameAsync(string, HeadingEntity[], RequestOptions)

Save headings for list resolved by the provided name.

Parameters

name string The name of the list to look up. entities HeadingEntity[] The headings to save requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<HeadingEntity[]&gt; List of headings

SaveHierarchyEntityAsync(HierarchyEntity, RequestOptions)

Updates the existing HierarchyEntity or creates a new HierarchyEntity if the id parameter is 0.

Parameters

hierarchyEntity HierarchyEntity The HierarchyEntity that is saved. requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<HierarchyEntity&gt; New or updated HierarchyEntity

SaveLegalBaseAsync(LegalBase, RequestOptions)

Parameters

legalBase LegalBase requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<LegalBase&gt;

SaveListEntityAsync(ListEntity, RequestOptions)

Updates the existing ListEntity or creates a new ListEntity if the id parameter is 0.

Parameters

listEntity ListEntity The ListEntity that is saved. requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ListEntity&gt; New or updated ListEntity

SaveListEntityByNameAsync(string, ListEntity, RequestOptions)

Save a ListEntity resolved by the provided name.

Parameters

name string The name of the list to save. listEntity ListEntity The ListEntity to save. requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ListEntity&gt; A ListEntity or null.

SaveListItemEntityAsync(ListItemEntity, RequestOptions)

Save the ListItemEntity.

Parameters

listItemEntity ListItemEntity The ListItemEntity to save. requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ListItemEntity&gt; The saved ListItemEntity.

SavePictureFolderEntityAsync(PictureFolderEntity, RequestOptions)

Updates the existing PictureFolderEntity or creates a new PictureFolderEntity if the id parameter is 0.

Parameters

pictureFolderEntity PictureFolderEntity The PictureFolderEntity that is saved. requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<PictureFolderEntity&gt; New or updated PictureFolderEntity

SaveProjectTypeEntityAsync(ProjectTypeEntity, RequestOptions)

Updates the existing ProjectTypeEntity or creates a new ProjectTypeEntity if the id parameter is 0.

Parameters

projectTypeEntity ProjectTypeEntity The ProjectTypeEntity that is saved. requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ProjectTypeEntity&gt; New or updated ProjectTypeEntity

SaveQuickRepliesAsync(QuickReply[], RequestOptions)

Method to save all quick replies for a given associate

Parameters

quickReplies QuickReply[] Array of quick replies requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task

SaveRelationDefinitionEntityAsync(RelationDefinitionEntity, RequestOptions)

Updates the existing RelationDefinitionEntity or creates a new RelationDefinitionEntity if the id parameter is 0.

Parameters

relationDefinitionEntity RelationDefinitionEntity The RelationDefinitionEntity that is saved. requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<RelationDefinitionEntity&gt; New or updated RelationDefinitionEntity

SaveResourceEntityAsync(ResourceEntity, RequestOptions)

Updates the existing ResourceEntity or creates a new ResourceEntity if the id parameter is 0.

Parameters

resourceEntity ResourceEntity The ResourceEntity that is saved. requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<ResourceEntity&gt; New or updated ResourceEntity

SaveSaleStageEntityAsync(SaleStageEntity, RequestOptions)

Updates the existing SaleStageEntity or creates a new SaleStageEntity if the id parameter is 0.

Parameters

saleStageEntity SaleStageEntity The SaleStageEntity that is saved. requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<SaleStageEntity&gt; New or updated SaleStageEntity

SaveSaleTypeEntityAsync(SaleTypeEntity, RequestOptions)

Updates the existing SaleTypeEntity or creates a new SaleTypeEntity if the id parameter is 0.

Parameters

saleTypeEntity SaleTypeEntity The SaleTypeEntity that is saved. requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<SaleTypeEntity&gt; New or updated SaleTypeEntity

SaveTaskMenuAsync(TaskMenu, RequestOptions)

Updates the existing TaskMenu or creates a new TaskMenu if the id parameter is 0.

Parameters

taskMenu TaskMenu The TaskMenu that is saved. requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<TaskMenu&gt; New or updated TaskMenu

SaveTicketCategoryEntityAsync(TicketCategoryEntity, RequestOptions)

Updates the existing TicketCategoryEntity or creates a new TicketCategoryEntity if the id parameter is 0.

Parameters

ticketCategoryEntity TicketCategoryEntity The TicketCategoryEntity that is saved. requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<TicketCategoryEntity&gt; New or updated TicketCategoryEntity

SaveTicketPriorityEntityAsync(TicketPriorityEntity, RequestOptions)

Updates the existing TicketPriorityEntity or creates a new TicketPriorityEntity if the id parameter is 0.

Parameters

ticketPriorityEntity TicketPriorityEntity The TicketPriorityEntity that is saved. requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<TicketPriorityEntity&gt; New or updated TicketPriorityEntity

SaveTicketRelationDefinitionEntityAsync(TicketRelationDefinitionEntity, RequestOptions)

Updates the existing TicketRelationDefinitionEntity or creates a new TicketRelationDefinitionEntity if the id parameter is 0.

Parameters

ticketRelationDefinitionEntity TicketRelationDefinitionEntity The TicketRelationDefinitionEntity that is saved. requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<TicketRelationDefinitionEntity&gt; New or updated TicketRelationDefinitionEntity

SaveTicketStatusEntityAsync(TicketStatusEntity, RequestOptions)

Updates the existing TicketStatusEntity or creates a new TicketStatusEntity if the id parameter is 0.

Parameters

ticketStatusEntity TicketStatusEntity The TicketStatusEntity that is saved. requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<TicketStatusEntity&gt; New or updated TicketStatusEntity

SaveTicketTypeEntityAsync(TicketTypeEntity, RequestOptions)

Updates the existing TicketTypeEntity or creates a new TicketTypeEntity if the id parameter is 0.

Parameters

ticketTypeEntity TicketTypeEntity The TicketTypeEntity that is saved. requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<TicketTypeEntity&gt; New or updated TicketTypeEntity

SaveWebPanelEntityAsync(WebPanelEntity, RequestOptions)

Updates the existing WebPanelEntity or creates a new WebPanelEntity if the id parameter is 0.

Parameters

webPanelEntity WebPanelEntity The WebPanelEntity that is saved. requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<WebPanelEntity&gt; New or updated WebPanelEntity

SetDocumentPluginForAllDocumentTemplatesAsync(int, RequestOptions)

Sets the document-plugin to be used for all templates of type ‘document’.

Parameters

documentPluginId int The numerical ID of the document-plugin to use. requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task This method has no return value

SetDocumentTemplateFromDocumentTemplateAsync(int, DocumentTemplateEntity, RequestOptions)

Create a new document template based on another template

Parameters

sourceDocumentTemplateId int The document template to copy contents from. documentTemplateEntity DocumentTemplateEntity The new document template entity requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<DocumentTemplateEntity&gt; The new document template entity

SetDocumentTemplateStreamAsync(DocumentTemplateEntity, byte[], string, int, RequestOptions)

Store a document template from its stream. Since there is a potential for a name conflict (the file name stored by the document entity earlier may prove to be invalid), the (possibly amended) document entity is returned. The client should not assume that any earlier, cached entity information is valid.

Parameters

documentTemplateEntity DocumentTemplateEntity The document entity object that the binary data (document) should be stored to. Its file name may be amended by this call, see the return value stream byte[] The document as a stream. languageCode string The language code (‘en-US’, ‘nb-NO’, etc). Use empty string if not supported or used. pluginId int The plugin id to store the template with. 0 for SOArc requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<DocumentTemplateEntity&gt; Since there is a potential for a name conflict (the file name stored by the document entity earlier may prove to be invalid), the (possibly amended) document entity is returned. The client should not assume that any earlier, cached entity information is valid.

SetEmarketingStrictModeAsync(bool, RequestOptions)

Turn on the Emarketing strict mode, which will enable full GDPR rules concerning Emarketing consents and subscriptions

Parameters

enable bool Set to true to enable strict mode requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task A void return

SetHeadingsForListItemAsync(int, int, int[], bool, RequestOptions)

Set headings which this list item should be listed under

Parameters

udListDefinitionId int The id of the list. Negative numbers indicate TableNumber value instead of UDListDefId. e.g. -64 = category. listItemId int The id of the list item headingIds int[] The ids of the headings to set for this list item enable bool Set to true to enable, false to disable requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task

SetListItemsForHeadingAsync(int, int, int[], bool, RequestOptions)

Update listItems that will be visible for this usergroup

Parameters

udListDefinitionId int The id of the list. Negative numbers indicate TableNumber value instead of UDListDefId. e.g. -64 = category. headingId int The id of the heading listItemIds int[] The ids of the list items. enable bool True to enable, false to disable requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task

SetListItemsForHeadingFromListNameAsync(string, int, int[], bool, RequestOptions)

Update listItems under this heading

Parameters

udListDefinitionName string The name of the list definition. headingId int The id of the heading listItemIds int[] The ids of the list items. enable bool True to enable, false to disable requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task

SetListItemsForUserGroupAsync(int, int, int[], bool, RequestOptions)

Update listItems that will be visible for this usergroup

Parameters

udListDefinitionId int The id of the list. Negative numbers indicate TableNumber value instead of UDListDefId. e.g. -64 = category. usergroupId int The id of the userGroup listItemIds int[] The id of the list items. enable bool True to enable, false to disable requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task

SetListItemsForUserGroupFromListNameAsync(string, int, int[], bool, RequestOptions)

Update listItems that will be visible for this usergroup

Parameters

udListDefinitionName string The name of the list definition. usergroupId int The id of the userGroup listItemsID int[] The id of the list items. enable bool True to enable, false to disable requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task

SetRankOnHeadingsAsync(int, int[], RequestOptions)

Set rank order on headings

Parameters

udListDefinitionId int The id of the list. Negative numbers indicate TableNumber value instead of UDListDefId. e.g. -64 = category. headingIds int[] The ids of the headings in the order you want requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task

SetRankOnProjectActivityAsync(int, int[], RequestOptions)

Set rank order on project activity

Parameters

projectTypeStatusLinkId int The id of the list itemsIds int[] The ids of the items in the order you want requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task

SetRankOnProjectDocumentAsync(int, int[], RequestOptions)

Set rank order on project document

Parameters

projectTypeStatusLinkId int The id of the list itemsIds int[] The ids of the items in the order you want requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task

SetRankOnSaleActivityAsync(int, int[], RequestOptions)

Set rank order on sale activity

Parameters

saleTypeStageLinkId int The id of the list itemsIds int[] The ids of the items in the order you want requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task

SetRankOnSaleDocumentAsync(int, int[], RequestOptions)

Set rank order on project document

Parameters

saleTypeStageLinkId int The id of the list itemsIds int[] The ids of the items in the order you want requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task

SetTicketCategoriesForUserGroupAsync(int, int[], RequestOptions)

Set ticket categories for one user group

Parameters

userGroupId int The ids of the user groups we want tickets categories from categoryIds int[] The ids of the user groups we want tickets categories from requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task This method has no return value

SetTicketPrioritySortOrderAsync(int, int, RequestOptions)

This method will set sort order of ticket priority in a list

Parameters

ticketPriorityId int Id of ticket priority sortOrder int Indicates the sort order for this priority. 1 is first. Any records following this one will be renumbered automatically requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task This method has no return value

SetTicketRelationDefinitionSortOrderAsync(int, int, RequestOptions)

This method will set sort order of ticket relation definition in a list

Parameters

ticketRelationDefId int Id of ticket relation definition sortOrder int Indicates the sort order for this relation definition. 1 is first. Any records following this one will be renumbered automatically requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task This method has no return value

SetTicketStatusSortOrderAsync(int, int, RequestOptions)

This method will set sort order of ticket status in a list