<a id=“SuperOffice_WebApi_Agents_ArchiveAgent”></a> Class ArchiveAgent
Namespace: SuperOffice.WebApi.AgentsAssembly: SuperOffice.WebApi.dll ArchiveList functions of all kinds
Inheritance
object ← AgentBase ← ArchiveAgentImplements
IArchiveAgent, IAgentBase, IDisposableInherited 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>(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 (ArchiveAgent agent = new ArchiveAgent(mySession)) { // call methods on agent here… }</code></pre>Constructors
<a id=“SuperOffice_WebApi_Agents_ArchiveAgent__ctor_System_Net_Http_HttpClient_”></a> ArchiveAgent(HttpClient)
Constructor: ArchiveList functions of all kindsParameters
httpClient HttpClient
Use this HTTP client instead of making own HttpClient instance.
<a id=“SuperOffice_WebApi_Agents_ArchiveAgent__ctor_SuperOffice_WebApi_WebApiOptions_System_Net_Http_HttpClient_”></a> ArchiveAgent(WebApiOptions, HttpClient)
Constructor: ArchiveList functions of all kindsParameters
options WebApiOptions
Base URL and authentication values.
httpClient HttpClient
Optional: Use this HTTP client instead of making a new one.
Methods
<a id=“SuperOffice_WebApi_Agents_ArchiveAgent_CreateDefaultArchiveListResultAsync_SuperOffice_WebApi_RequestOptions_”></a> CreateDefaultArchiveListResultAsync(RequestOptions)
Set default values into a new ArchiveListResult. NetServer calculates default values on the entity, which is required when creating/storing a new instanceParameters
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<ArchiveListResult> A blank ArchiveListResult<a id=“SuperOffice_WebApi_Agents_ArchiveAgent_ExportArchiveAsync_System_String_System_String_System_String___System_String___SuperOffice_WebApi_Data_ArchiveOrderByInfo___SuperOffice_WebApi_Data_ArchiveRestrictionInfo___System_String_System_String___System_Int32_SuperOffice_WebApi_RequestOptions_”></a> ExportArchiveAsync(string, string, string[], string[], ArchiveOrderByInfo[], ArchiveRestrictionInfo[], string, string[], int, RequestOptions)
Exports the target archive to a downloadable format.Parameters
providerName string
The name of the archive provider to use; it will be created via the ArchiveProviderFactory from a plugin
context string
Context parameter, url-encoded string context parameter for ArchiveProvider constructor
desiredEntities string[]
Comma separated list of the names of the desired entities.
columns string[]
Comma separated list of the names of the columns wanted; supports display names
sortOrder ArchiveOrderByInfo[]
restrictions ArchiveRestrictionInfo[]
exportType string
To what format the archive should be exported; Excel, etc.
selectedRowIds string[]
estimatedRowCount int
The estimated amount of rows to be exported. Used to determine if the operation should be run as a batch task or immediately.
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<ExportArchiveResult><a id=“SuperOffice_WebApi_Agents_ArchiveAgent_GetActivityFilterAsync_SuperOffice_WebApi_RequestOptions_”></a> GetActivityFilterAsync(RequestOptions)
Get activity filter for the specified list.Parameters
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<ActivityFilter> The activity filter for the specified list<a id=“SuperOffice_WebApi_Agents_ArchiveAgent_GetArchiveConfigurationAsync_System_String_System_String_SuperOffice_WebApi_RequestOptions_”></a> GetArchiveConfigurationAsync(string, string, RequestOptions)
Get the configuration for one archive. The configuration is keyed by a combination of archive provider name and gui name. The archive provider name must match an archive provider plugin; the gui name is an arbitrary string used to distinguish multiple occurrences of the same underlying provider in a gui.Parameters
guiName string
String that identifies the archive in the GUI, must be the same when fetching and storing configurations, but does not otherwise have to match anything.
providerName string
Name of archive provider, must match one of the plugins known to the ArchiveProviderFactory.
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<ArchiveConfiguration> Archive configuration consisting of column information, orderby information and entities<a id=“SuperOffice_WebApi_Agents_ArchiveAgent_GetArchiveConfigurationV2Async_System_String_System_String_System_String_System_String_SuperOffice_WebApi_RequestOptions_”></a> GetArchiveConfigurationV2Async(string, string, string, string, RequestOptions)
Get the configuration for one archive. The configuration is keyed by a combination of archive provider name (plus optional context), gui name, and optional table binding. The archive provider name must match an archive provider plugin; the gui name is an arbitrary string used to distinguish multiple occurrences of the same underlying provider in a gui.Parameters
guiName string
String that identifies the archive in the GUI, must be the same when fetching and storing configurations, but does not otherwise have to match anything.
providerName string
Name of archive provider, must match one of the plugins known to the ArchiveProviderFactory.
context string
Context parameter, url-encoded string context parameter for ArchiveProvider constructor. Optional, but required for archives that depend on a context - for instance Quote archives that need to know their QuoteConnectionId to be meaningful
ownerKeys string
Name/value string containing ownership binding information. The first should resolve to a table/primarykey, such as selection=123. Future functionality may allow multiple/extended keys
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<ArchiveConfiguration> Archive configuration consisting of column information, orderby information and entities<a id=“SuperOffice_WebApi_Agents_ArchiveAgent_GetArchiveConfigurationWithContextAsync_System_String_System_String_System_String_SuperOffice_WebApi_RequestOptions_”></a> GetArchiveConfigurationWithContextAsync(string, string, string, RequestOptions)
Get the configuration for one archive, with context parameter. The configuration is keyed by a combination of archive provider name and gui name. The archive provider name must match an archive provider plugin; the gui name is an arbitrary string used to distinguish multiple occurrences of the same underlying provider in a gui.Parameters
guiName string
String that identifies the archive in the GUI, must be the same when fetching and storing configurations, but does not otherwise have to match anything.
providerName string
Name of archive provider, must match one of the plugins known to the ArchiveProviderFactory.
context string
Context parameter, url-encoded string context parameter for ArchiveProvider constructor
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<ArchiveConfiguration> Archive configuration consisting of column information, orderby information and entities<a id=“SuperOffice_WebApi_Agents_ArchiveAgent_GetArchiveList2Async_System_String_System_String_System_String_System_String_System_String_System_Int32_System_Int32_SuperOffice_WebApi_RequestOptions_”></a> GetArchiveList2Async(string, string, string, string, string, int, int, RequestOptions)
Get a page of data for an archive using a restriction string. The columns returned will be those set as chosen columns, using either the SetChosenColumns service or the corresponding SelectableMDOList.SetSelected.Parameters
guiName string
The GUI name of the archive list, used to retrieve the currently configured set of columns (otherwise manipulated using the ArchiveConfiguration service)
providerName string
The name of the archive provider to use; it will be created via the ArchiveProviderFactory from a plugin
sortOrder string
Sort order for the archive. Can be null, which indicates ‘no particular order’
restriction string
Archive restrictions as string. e.g. “name = ‘baz’ or category oneOf (1,2,3)”. Archives will generally throw an exception if no restrictions are set. Pass in an empty array if you really do not want restrictions, but remember that you may end up fetching the first page of millions of rows.
entities string
Comma separated list of entities to include. Can be null, which indicates ‘include all entities’
page int
Page number, page 0 is the first page. Negative page numbers are interpreted as number of rows to skip.
pageSize int
Page size, which should be kept reasonable (say, no more than 1000 rows at a time)
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<ArchiveListItem[]> Array of archive list items, where each item represents one row of data (row level data + the requested columns)<a id=“SuperOffice_WebApi_Agents_ArchiveAgent_GetArchiveListAsync_System_String_System_String_SuperOffice_WebApi_Data_ArchiveOrderByInfo___SuperOffice_WebApi_Data_ArchiveRestrictionInfo___System_String___System_Int32_System_Int32_SuperOffice_WebApi_RequestOptions_”></a> GetArchiveListAsync(string, string, ArchiveOrderByInfo[], ArchiveRestrictionInfo[], string[], int, int, RequestOptions)
Get a page of data for an archive. The columns returned will be those set as chosen columns, using either the SetChosenColumns service or the corresponding SelectableMDOList.SetSelected.Parameters
guiName string
The GUI name of the archive list, used to retrieve the currently configured set of columns (otherwise manipulated using the ArchiveConfiguration service)
providerName string
The name of the archive provider to use; it will be created via the ArchiveProviderFactory from a plugin
sortOrder ArchiveOrderByInfo[]
Sort order for the archive. Can be null, which indicates ‘no particular order’
restriction ArchiveRestrictionInfo[]
Archive restrictions. Archives will generally throw an exception if no restrictions are set. Pass in an empty array if you really do not want restrictions, but remember that you may end up fetching the first page of millions of rows.
entities string[]
Which entities to include. Can be null, which indicates ‘include all entities’
page int
Page number, page 0 is the first page. Negative page numbers are interpreted as number of rows to skip.
pageSize int
Page size, which should be kept reasonable (say, no more than 1000 rows at a time)
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<ArchiveListItem[]> Array of archive list items, where each item represents one row of data (row level data + the requested columns)<a id=“SuperOffice_WebApi_Agents_ArchiveAgent_GetArchiveListByColumns2Async_System_String_System_String_System_String_System_String_System_String_System_Int32_System_Int32_SuperOffice_WebApi_RequestOptions_”></a> GetArchiveListByColumns2Async(string, string, string, string, string, int, int, RequestOptions)
Get a page of results for an archive list, explicitly specifying the restrictions as a string, orderby and chosen columns.Parameters
providerName string
The name of the archive provider to use; it will be created via the ArchiveProviderFactory from a plugin
columns string
An array of the names of the columns wanted.
sortOrder string
Sort order for the archive as string (‘name asc, dept desc’). Can be null, which indicates ‘no particular order’
restrictions string
Archive restrictions as string (‘category = 1 and business oneOf (1,2,3)’). Archives will generally throw an exception if no restrictions are set. Pass in an empty array if you really do not want restrictions, but remember that you may end up fetching the first page of millions of rows.
entities string
Comma separated list of entities to include. Can be null, which indicates ‘include all entities’
page int
Page number, page 0 is the first page. Negative page numbers are interpreted as number of rows to skip.
pageSize int
Page size, which should be kept reasonable (say, no more than 1000 rows at a time)
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<ArchiveListItem[]> Array of archive list items, where each item represents one row of data (row level data + the requested columns)<a id=“SuperOffice_WebApi_Agents_ArchiveAgent_GetArchiveListByColumnsAsync_System_String_System_String___SuperOffice_WebApi_Data_ArchiveOrderByInfo___SuperOffice_WebApi_Data_ArchiveRestrictionInfo___System_String___System_Int32_System_Int32_SuperOffice_WebApi_RequestOptions_”></a> GetArchiveListByColumnsAsync(string, string[], ArchiveOrderByInfo[], ArchiveRestrictionInfo[], string[], int, int, RequestOptions)
Get a page of results for an archive list, explicitly specifying the restrictions, orderby and chosen columns.Parameters
providerName string
The name of the archive provider to use; it will be created via the ArchiveProviderFactory from a plugin
columns string[]
An array of the names of the columns wanted.
sortOrder ArchiveOrderByInfo[]
Sort order for the archive. Can be null, which indicates ‘no particular order’
restriction ArchiveRestrictionInfo[]
Archive restrictions. Archives will generally throw an exception if no restrictions are set. Pass in an empty array if you really do not want restrictions, but remember that you may end up fetching the first page of millions of rows.
entities string[]
Which entities to include. Can be null, which indicates ‘include all entities’
page int
Page number, page 0 is the first page. Negative page numbers are interpreted as number of rows to skip.
pageSize int
Page size, which should be kept reasonable (say, no more than 1000 rows at a time)
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<ArchiveListItem[]> Array of archive list items, where each item represents one row of data (row level data + the requested columns)<a id=“SuperOffice_WebApi_Agents_ArchiveAgent_GetArchiveListByColumnsWithContext2Async_System_String_System_String_System_String_System_String_System_String_System_Int32_System_Int32_System_String_SuperOffice_WebApi_RequestOptions_”></a> GetArchiveListByColumnsWithContext2Async(string, string, string, string, string, int, int, string, RequestOptions)
Get a page of results for an archive list with context parameter, explicitly specifying the restrictions as a string, orderby and chosen columns.Parameters
providerName string
The name of the archive provider to use; it will be created via the ArchiveProviderFactory from a plugin
columns string
Comma separated names of the columns wanted.
sortOrder string
Comma separated list of columns to sort order for the archive. e.g.: “name asc, dept desc, registeredBy” Can be null, which indicates ‘no particular order’
restriction string
Archive restrictions as string. e.g. “name startsWith ‘foo’ and (dept = ‘bar’ or dept = ‘baz’)” Archives will generally throw an exception if no restrictions are set. Pass in an empty array if you really do not want restrictions, but remember that you may end up fetching the first page of millions of rows.
entities string
Comma separated list of entities to include. Can be null, which indicates ‘include all entities’
page int
Page number, page 0 is the first page. Negative page numbers are interpreted as number of rows to skip.
pageSize int
Page size, which should be kept reasonable (say, no more than 1000 rows at a time)
context string
Context parameter, url-encoded string context parameter for ArchiveProvider constructor
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<ArchiveListItem[]> Array of archive list items, where each item represents one row of data (row level data + the requested columns)<a id=“SuperOffice_WebApi_Agents_ArchiveAgent_GetArchiveListByColumnsWithContextAsync_System_String_System_String___SuperOffice_WebApi_Data_ArchiveOrderByInfo___SuperOffice_WebApi_Data_ArchiveRestrictionInfo___System_String___System_Int32_System_Int32_System_String_SuperOffice_WebApi_RequestOptions_”></a> GetArchiveListByColumnsWithContextAsync(string, string[], ArchiveOrderByInfo[], ArchiveRestrictionInfo[], string[], int, int, string, RequestOptions)
Get a page of results for an archive list with context parameter, explicitly specifying the restrictions, orderby and chosen columns.Parameters
providerName string
The name of the archive provider to use; it will be created via the ArchiveProviderFactory from a plugin
columns string[]
An array of the names of the columns wanted.
sortOrder ArchiveOrderByInfo[]
Sort order for the archive. Can be null, which indicates ‘no particular order’
restriction ArchiveRestrictionInfo[]
Archive restrictions. Archives will generally throw an exception if no restrictions are set. Pass in an empty array if you really do not want restrictions, but remember that you may end up fetching the first page of millions of rows.
entities string[]
Which entities to include. Can be null, which indicates ‘include all entities’
page int
Page number, page 0 is the first page. Negative page numbers are interpreted as number of rows to skip.
pageSize int
Page size, which should be kept reasonable (say, no more than 1000 rows at a time)
context string
Context parameter, url-encoded string context parameter for ArchiveProvider constructor
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<ArchiveListItem[]> Array of archive list items, where each item represents one row of data (row level data + the requested columns)<a id=“SuperOffice_WebApi_Agents_ArchiveAgent_GetArchiveListByColumnsWithHeader2Async_System_String_System_String_System_String_System_String_System_String_System_Int32_System_Int32_System_String_SuperOffice_WebApi_RequestOptions_”></a> GetArchiveListByColumnsWithHeader2Async(string, string, string, string, string, int, int, string, RequestOptions)
Get a page of results for an archive list, explicitly specifying the restrictions as strings, orderby and chosen columns; as well as a name/value string formatted set of options. The return value includes a header that has various extra information, in addition to the actual rows.Parameters
providerName string
The name of the archive provider to use; it will be created via the ArchiveProviderFactory from a plugin
columns string
Comma separated string of the names of the columns wanted.
sortOrder string
Comma separated string of sort order for the archive. e.g. “name asc, dept desc” Can be null, which indicates ‘no particular order’
restriction string
Archive restrictions. e.g. “category = 2 or business oneOf (2,3,4)” Archives will generally throw an exception if no restrictions are set. Pass in an empty array if you really do not want restrictions, but remember that you may end up fetching the first page of millions of rows.
entities string
Comma separated list of entities to include. Can be null, which indicates ‘include all entities’
page int
Page number, page 0 is the first page. Negative page numbers are interpreted as number of rows to skip.
pageSize int
Page size, which should be kept reasonable (say, no more than 1000 rows at a time)
options string
name=value&… formatted set of options. “rowcount=true” will cause the rowcount to be calculated and populated.
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<ArchiveListResult> Header with optional row count, plus array of archive list items, where each item represents one row of data (row level data + the requested columns)<a id=“SuperOffice_WebApi_Agents_ArchiveAgent_GetArchiveListByColumnsWithHeaderAsync_System_String_System_String___SuperOffice_WebApi_Data_ArchiveOrderByInfo___SuperOffice_WebApi_Data_ArchiveRestrictionInfo___System_String___System_Int32_System_Int32_System_String_SuperOffice_WebApi_RequestOptions_”></a> GetArchiveListByColumnsWithHeaderAsync(string, string[], ArchiveOrderByInfo[], ArchiveRestrictionInfo[], string[], int, int, string, RequestOptions)
Get a page of results for an archive list, explicitly specifying the restrictions, orderby and chosen columns; as well as a name/value string formatted set of options. The return value includes a header that has various extra information, in addition to the actual rows.Parameters
providerName string
The name of the archive provider to use; it will be created via the ArchiveProviderFactory from a plugin
columns string[]
An array of the names of the columns wanted.
sortOrder ArchiveOrderByInfo[]
Sort order for the archive. Can be null, which indicates ‘no particular order’
restriction ArchiveRestrictionInfo[]
Archive restrictions. Archives will generally throw an exception if no restrictions are set. Pass in an empty array if you really do not want restrictions, but remember that you may end up fetching the first page of millions of rows.
entities string[]
Which entities to include. Can be null, which indicates ‘include all entities’
page int
Page number, page 0 is the first page. Negative page numbers are interpreted as number of rows to skip.
pageSize int
Page size, which should be kept reasonable (say, no more than 1000 rows at a time)
options string
name=value&… formatted set of options. “rowcount=true” will cause the rowcount to be calculated and populated.
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<ArchiveListResult> Header with optional row count, plus array of archive list items, where each item represents one row of data (row level data + the requested columns)<a id=“SuperOffice_WebApi_Agents_ArchiveAgent_GetArchiveListByColumnsWithHeaderWithContext2Async_System_String_System_String_System_String_System_String_System_String_System_Int32_System_Int32_System_String_System_String_SuperOffice_WebApi_RequestOptions_”></a> GetArchiveListByColumnsWithHeaderWithContext2Async(string, string, string, string, string, int, int, string, string, RequestOptions)
Get a page of results for an archive list, with context parameter, explicitly specifying the restrictions as strings, orderby and chosen columns; as well as a name/value string formatted set of options. The return value includes a header that has various extra information, in addition to the actual rows.Parameters
providerName string
The name of the archive provider to use; it will be created via the ArchiveProviderFactory from a plugin
columns string
Comma separated list of the names of the columns wanted.
sortOrder string
Sort order for the archive. “name asc, dept desc” Can be null, which indicates ‘no particular order’
restriction string
Archive restrictions as string. “updated > ‘2009.1.1’ and registeredBy = 2” Archives will generally throw an exception if no restrictions are set. Pass in an empty array if you really do not want restrictions, but remember that you may end up fetching the first page of millions of rows.
entities string
Comma separated list of entities to include. Can be null, which indicates ‘include all entities’
page int
Page number, page 0 is the first page. Negative page numbers are interpreted as number of rows to skip.
pageSize int
Page size, which should be kept reasonable (say, no more than 1000 rows at a time)
options string
name=value&… formatted set of options. “rowcount=true” will cause the rowcount to be calculated and populated.
context string
Context parameter, url-encoded string context parameter for ArchiveProvider constructor
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<ArchiveListResult> Header with optional row count, plus array of archive list items, where each item represents one row of data (row level data + the requested columns)<a id=“SuperOffice_WebApi_Agents_ArchiveAgent_GetArchiveListByColumnsWithHeaderWithContextAsync_System_String_System_String___SuperOffice_WebApi_Data_ArchiveOrderByInfo___SuperOffice_WebApi_Data_ArchiveRestrictionInfo___System_String___System_Int32_System_Int32_System_String_System_String_SuperOffice_WebApi_RequestOptions_”></a> GetArchiveListByColumnsWithHeaderWithContextAsync(string, string[], ArchiveOrderByInfo[], ArchiveRestrictionInfo[], string[], int, int, string, string, RequestOptions)
Get a page of results for an archive list, with context parameter, explicitly specifying the restrictions, orderby and chosen columns; as well as a name/value string formatted set of options. The return value includes a header that has various extra information, in addition to the actual rows.Parameters
providerName string
The name of the archive provider to use; it will be created via the ArchiveProviderFactory from a plugin
columns string[]
An array of the names of the columns wanted.
sortOrder ArchiveOrderByInfo[]
Sort order for the archive. Can be null, which indicates ‘no particular order’
restriction ArchiveRestrictionInfo[]
Archive restrictions. Archives will generally throw an exception if no restrictions are set. Pass in an empty array if you really do not want restrictions, but remember that you may end up fetching the first page of millions of rows.
entities string[]
Which entities to include. Can be null, which indicates ‘include all entities’
page int
Page number, page 0 is the first page. Negative page numbers are interpreted as number of rows to skip.
pageSize int
Page size, which should be kept reasonable (say, no more than 1000 rows at a time)
options string
name=value&… formatted set of options. “rowcount=true” will cause the rowcount to be calculated and populated.
context string
Context parameter, url-encoded string context parameter for ArchiveProvider constructor
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<ArchiveListResult> Header with optional row count, plus array of archive list items, where each item represents one row of data (row level data + the requested columns)<a id=“SuperOffice_WebApi_Agents_ArchiveAgent_GetArchiveListWithContext2Async_System_String_System_String_System_String_System_String_System_String_System_Int32_System_Int32_System_String_SuperOffice_WebApi_RequestOptions_”></a> GetArchiveListWithContext2Async(string, string, string, string, string, int, int, string, RequestOptions)
Get a page of data for an archive using restrictions as strings, with context parameter. The columns returned will be those set as chosen columns, using either the SetChosenColumns service or the corresponding SelectableMDOList.SetSelected.Parameters
guiName string
The GUI name of the archive list, used to retrieve the currently configured set of columns (otherwise manipulated using the ArchiveConfiguration service)
providerName string
The name of the archive provider to use; it will be created via the ArchiveProviderFactory from a plugin
sortOrder string
Sort order for the archive. e.g. “name asc, dept desc” Can be null, which indicates ‘no particular order’
restriction string
Archive restrictions as string. e.g. “name gt ‘B’ or dept = ‘baz’” Archives will generally throw an exception if no restrictions are set. Pass in an empty array if you really do not want restrictions, but remember that you may end up fetching the first page of millions of rows.
entities string
Comma separated list of entities to include. Can be null, which indicates ‘include all entities’
page int
Page number, page 0 is the first page. Negative page numbers are interpreted as number of rows to skip.
pageSize int
Page size, which should be kept reasonable (say, no more than 1000 rows at a time)
context string
Context parameter, url-encoded string context parameter for ArchiveProvider constructor
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<ArchiveListItem[]> Array of archive list items, where each item represents one row of data (row level data + the requested columns)<a id=“SuperOffice_WebApi_Agents_ArchiveAgent_GetArchiveListWithContextAsync_System_String_System_String_SuperOffice_WebApi_Data_ArchiveOrderByInfo___SuperOffice_WebApi_Data_ArchiveRestrictionInfo___System_String___System_Int32_System_Int32_System_String_SuperOffice_WebApi_RequestOptions_”></a> GetArchiveListWithContextAsync(string, string, ArchiveOrderByInfo[], ArchiveRestrictionInfo[], string[], int, int, string, RequestOptions)
Get a page of data for an archive, with context parameter. The columns returned will be those set as chosen columns, using either the SetChosenColumns service or the corresponding SelectableMDOList.SetSelected.Parameters
guiName string
The GUI name of the archive list, used to retrieve the currently configured set of columns (otherwise manipulated using the ArchiveConfiguration service)
providerName string
The name of the archive provider to use; it will be created via the ArchiveProviderFactory from a plugin
sortOrder ArchiveOrderByInfo[]
Sort order for the archive. Can be null, which indicates ‘no particular order’
restriction ArchiveRestrictionInfo[]
Archive restrictions. Archives will generally throw an exception if no restrictions are set. Pass in an empty array if you really do not want restrictions, but remember that you may end up fetching the first page of millions of rows.
entities string[]
Which entities to include. Can be null, which indicates ‘include all entities’
page int
Page number, page 0 is the first page. Negative page numbers are interpreted as number of rows to skip.
pageSize int
Page size, which should be kept reasonable (say, no more than 1000 rows at a time)
context string
Context parameter, url-encoded string context parameter for ArchiveProvider constructor
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<ArchiveListItem[]> Array of archive list items, where each item represents one row of data (row level data + the requested columns)<a id=“SuperOffice_WebApi_Agents_ArchiveAgent_GetAvailableColumnsAsync_System_String_System_String_SuperOffice_WebApi_RequestOptions_”></a> GetAvailableColumnsAsync(string, string, RequestOptions)
Return list of all columns supported by an archive provider. See also GetArchiveConfiguration.Parameters
providerName string
The name of the archive provider to use; it will be created via the ArchiveProviderFactory from a plugin
context string
Optional context parameter, url-encoded string context parameter for ArchiveProvider constructor
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<ArchiveColumnInfo[]> Array of all columns supported by the archive provider.<a id=“SuperOffice_WebApi_Agents_ArchiveAgent_GetAvailableEntitiesAsync_System_String_System_String_SuperOffice_WebApi_RequestOptions_”></a> GetAvailableEntitiesAsync(string, string, RequestOptions)
Return list of all entities supported by an archive provider. See also GetArchiveConfiguration.Parameters
providerName string
The name of the archive provider to use; it will be created via the ArchiveProviderFactory from a plugin
context string
Optional context parameter, url-encoded string context parameter for ArchiveProvider constructor
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<MDOListItem[]> Array of all entity types supported by the archive provider. MDOListItem.Name = DisplayName, Tooltip = DisplayTooltip, Type = code name, StyleHint = optional/mandatory, IconHint=DefaultShow<a id=“SuperOffice_WebApi_Agents_ArchiveAgent_GetGroupAssociateIdsAsync_System_Int32___SuperOffice_WebApi_RequestOptions_”></a> GetGroupAssociateIdsAsync(int[], RequestOptions)
Returns the associate ids that belongs to the given groupsParameters
groupIds int[]
Array of group ids
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<int[]> Array of associate ids<a id=“SuperOffice_WebApi_Agents_ArchiveAgent_GetProviderNamesAsync_SuperOffice_WebApi_RequestOptions_”></a> GetProviderNamesAsync(RequestOptions)
Return list of all archive provider namesParameters
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<string[]> Array of all archive provider names.<a id=“SuperOffice_WebApi_Agents_ArchiveAgent_GetRelatedData2Async_System_String_System_Int32_System_String_SuperOffice_WebApi_RequestOptions_”></a> GetRelatedData2Async(string, int, string, RequestOptions)
Get data for fields related to a table record. While this method /can/ be used to fetch plain fields, that is not the intended usage and it does not replace the Entity.Get methods available for that purpose. Nor does it replace the generic DotSyntax/Dynamic archive provider.Parameters
table string
The root table to get related data for, such as ‘ticket’ or ‘y_car’
recordId int
The primary key of the root table to get related data for
fields string
Names of fields as a comma-separated list - these need to be valid in the DotSyntax for this table, and can be arbitrarily deep. Example: ‘title,created_by.associate_id.person.fullName, x_comment’. Do not start with the root table name.
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<RelatedData[]> Array of field => ArchiveColumnData objects<a id=“SuperOffice_WebApi_Agents_ArchiveAgent_GetRelatedDataAsync_System_String_System_Int32_System_String___SuperOffice_WebApi_RequestOptions_”></a> GetRelatedDataAsync(string, int, string[], RequestOptions)
Get data for fields related to a table record. While this method /can/ be used to fetch plain fields, that is not the intended usage and it does not replace the Entity.Get methods available for that purpose. Nor does it replace the generic DotSyntax/Dynamic archive provider.Parameters
table string
The root table to get related data for, such as ‘ticket’ or ‘y_car’
recordId int
The primary key of the root table to get related data for
fields string[]
Names of fields - these need to be valid in the DotSyntax for this table, and can be arbitrarily deep. Examples: ‘title’, ‘created_by.associate_id.person.fullName’, ‘x_comment’. Do not start with the root table name.
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<RelatedData[]> Array of field => ArchiveColumnData objects<a id=“SuperOffice_WebApi_Agents_ArchiveAgent_SetActivityFilterAsync_SuperOffice_WebApi_Data_ActivityFilter_SuperOffice_WebApi_RequestOptions_”></a> SetActivityFilterAsync(ActivityFilter, RequestOptions)
Set activity filter for the specified list.Parameters
activityFilter ActivityFilter
New activity filter
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<a id=“SuperOffice_WebApi_Agents_ArchiveAgent_SetChosenColumnsAsync_System_String_System_String_System_String___SuperOffice_WebApi_RequestOptions_”></a> SetChosenColumnsAsync(string, string, string[], RequestOptions)
Set the currently chosen columns for the given gui name/provider name combination. This service corresponds to the SetSelected method of the SelectableMDOList service, for a list called archiveColumns: plus the archive provider name and gui name as its additionalInfo.Parameters
guiName string
String that identifies the archive in the GUI, must be the same when fetching and storing configurations, but does not otherwise have to match anything.
providerName string
Name of archive provider, must match one of the plugins known to the ArchiveProviderFactory.
chosenColumns string[]
Array of column names, where array order indicates left to right order in the archive.
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<a id=“SuperOffice_WebApi_Agents_ArchiveAgent_SetChosenColumnsV2Async_System_String_System_String_System_String_System_String_System_String___SuperOffice_WebApi_RequestOptions_”></a> SetChosenColumnsV2Async(string, string, string, string, string[], RequestOptions)
Set the currently chosen columns for the given gui name/provider name combination. This service corresponds to the SetSelected method of the SelectableMDOList service, for a list called archiveColumns: plus the archive provider name and gui name as its additionalInfo.Parameters
guiName string
String that identifies the archive in the GUI, must be the same when fetching and storing configurations, but does not otherwise have to match anything.
providerName string
Name of archive provider, must match one of the plugins known to the ArchiveProviderFactory.
context string
Context parameter, url-encoded string context parameter for ArchiveProvider constructor. Optional, but required for archives that depend on a context - for instance Quote archives that need to know their QuoteConnectionId to be meaningful
ownerKeys string
Name/value string containing ownership binding information. The first should resolve to a table/primarykey, such as selection=123. Future functionality may allow multiple/extended keys
chosenColumns string[]
Array of column names, where array order indicates left to right order in the archive.
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<a id=“SuperOffice_WebApi_Agents_ArchiveAgent_SetChosenEntitiesAsync_System_String_System_String_System_String___SuperOffice_WebApi_RequestOptions_”></a> SetChosenEntitiesAsync(string, string, string[], RequestOptions)
Set the currently chosen entities for the given gui name/provider name combination. This service corresponds to the SetSelected method of the SelectableMDOList service, for a list called archiveEntities: plus the archive provider name and gui name as its additionalInfo.Parameters
guiName string
String that identifies the archive in the GUI, must be the same when fetching and storing configurations, but does not otherwise have to match anything.
providerName string
Name of archive provider, must match one of the plugins known to the ArchiveProviderFactory.
entities string[]
Array of entity names
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<a id=“SuperOffice_WebApi_Agents_ArchiveAgent_SetChosenEntitiesV2Async_System_String_System_String_System_String_System_String_System_String___SuperOffice_WebApi_RequestOptions_”></a> SetChosenEntitiesV2Async(string, string, string, string, string[], RequestOptions)
Set the currently chosen entities for the given gui name/provider name combination. This service corresponds to the SetSelected method of the SelectableMDOList service, for a list called archiveEntities: plus the archive provider name and gui name as its additionalInfo.Parameters
guiName string
String that identifies the archive in the GUI, must be the same when fetching and storing configurations, but does not otherwise have to match anything.
providerName string
Name of archive provider, must match one of the plugins known to the ArchiveProviderFactory.
context string
Context parameter, url-encoded string context parameter for ArchiveProvider constructor. Optional, but required for archives that depend on a context - for instance Quote archives that need to know their QuoteConnectionId to be meaningful
ownerKeys string
Name/value string containing ownership binding information. The first should resolve to a table/primarykey, such as selection=123. Future functionality may allow multiple/extended keys
entities string[]
Array of entity names
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<a id=“SuperOffice_WebApi_Agents_ArchiveAgent_SetColumnWidthsAsync_System_String_System_String___SuperOffice_WebApi_RequestOptions_”></a> SetColumnWidthsAsync(string, string[], RequestOptions)
Set the column widths for the given set of columns and GUI name.Parameters
guiName string
String that identifies the archive in the GUI, must be the same when fetching and storing configurations, but does not otherwise have to match anything.
columnWidths string[]
Array of column widths. A column width is specified either as a fixed number of character (10c) or as a percentage (10%). Percentages will be recalculated so that they add up to exactly 100 when the configuration is fetched again.
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<a id=“SuperOffice_WebApi_Agents_ArchiveAgent_SetColumnWidthsV2Async_System_String_System_String_System_String_System_String_System_String___SuperOffice_WebApi_RequestOptions_”></a> SetColumnWidthsV2Async(string, string, string, string, string[], RequestOptions)
Set the column widths for the given set of columns and GUI name.Parameters
guiName string
String that identifies the archive in the GUI, must be the same when fetching and storing configurations, but does not otherwise have to match anything.
providerName string
Name of archive provider, must match one of the plugins known to the ArchiveProviderFactory.
context string
Context parameter, url-encoded string context parameter for ArchiveProvider constructor. Optional, but required for archives that depend on a context - for instance Quote archives that need to know their QuoteConnectionId to be meaningful
ownerKeys string
Name/value string containing ownership binding information. The first should resolve to a table/primarykey, such as selection=123. Future functionality may allow multiple/extended keys
columnWidths string[]
Array of column widths. A column width is specified either as a fixed number of character (10c) or as a percentage (10%). Percentages will be recalculated so that they add up to exactly 100 when the configuration is fetched again.
requestOptions RequestOptions
Override language/culture codes on this request.