Class ArchiveColumnsProviderBase
This is the base class that translates the list of available columns of an Archive Provider into an MDO list suitable for feeding the archive configuration dialog. It is a generic provider in the sense that it handles all known archive providers (via the plugin factory); if any particular archive needs special treatment then code to do so should be added here.
This class has two derived classes, one for choosing display columns and one for choosing orderby columns. The difference is in the filtering of columns, and how the current configuration is merged in.Inheritance
Inherited Members
Namespace: SuperOffice.CRM.Lists
Assembly: SoDataBase.dll
Syntax
public abstract class ArchiveColumnsProviderBase : ArchiveConfigurationProviderBase, IDynamicMDOProvider, ISoListProvider, ISoList
Remarks
The AcceptColumn(ArchiveColumnInfo) and AcceptProvider abstract methods are overriden by subclasses and used to restrict the columns and archive providers handled. By default, the standard derived classes will handle all archive providers, but a partner may implement a new subclass which handles some set of providers. By setting the priority parameter of the DynamicMDOProviderPlugin attribute to less than int.MaxValue-100000, the value used by the standard classes, such a partner class may pre-empt the standard classes for its supported providers.
Constructors
ArchiveColumnsProviderBase()
Constructor
Declaration
public ArchiveColumnsProviderBase()
Remarks
The AcceptColumn(ArchiveColumnInfo) and AcceptProvider abstract methods are overriden by subclasses and used to restrict the columns and archive providers handled. By default, the standard derived classes will handle all archive providers, but a partner may implement a new subclass which handles some set of providers. By setting the priority parameter of the DynamicMDOProviderPlugin attribute to less than int.MaxValue-100000, the value used by the standard classes, such a partner class may pre-empt the standard classes for its supported providers.
Fields
HeadingIdStart
This is the base class that translates the list of available columns of an Archive Provider into an MDO list suitable for feeding the archive configuration dialog. It is a generic provider in the sense that it handles all known archive providers (via the plugin factory); if any particular archive needs special treatment then code to do so should be added here.
This class has two derived classes, one for choosing display columns and one for choosing orderby columns. The difference is in the filtering of columns, and how the current configuration is merged in.Declaration
public const int HeadingIdStart = 20000
Field Value
Type | Description |
---|---|
int |
Remarks
The AcceptColumn(ArchiveColumnInfo) and AcceptProvider abstract methods are overriden by subclasses and used to restrict the columns and archive providers handled. By default, the standard derived classes will handle all archive providers, but a partner may implement a new subclass which handles some set of providers. By setting the priority parameter of the DynamicMDOProviderPlugin attribute to less than int.MaxValue-100000, the value used by the standard classes, such a partner class may pre-empt the standard classes for its supported providers.
_context
This is the base class that translates the list of available columns of an Archive Provider into an MDO list suitable for feeding the archive configuration dialog. It is a generic provider in the sense that it handles all known archive providers (via the plugin factory); if any particular archive needs special treatment then code to do so should be added here.
This class has two derived classes, one for choosing display columns and one for choosing orderby columns. The difference is in the filtering of columns, and how the current configuration is merged in.Declaration
protected string _context
Field Value
Type | Description |
---|---|
string |
Remarks
The AcceptColumn(ArchiveColumnInfo) and AcceptProvider abstract methods are overriden by subclasses and used to restrict the columns and archive providers handled. By default, the standard derived classes will handle all archive providers, but a partner may implement a new subclass which handles some set of providers. By setting the priority parameter of the DynamicMDOProviderPlugin attribute to less than int.MaxValue-100000, the value used by the standard classes, such a partner class may pre-empt the standard classes for its supported providers.
_providerEntity
This is the base class that translates the list of available columns of an Archive Provider into an MDO list suitable for feeding the archive configuration dialog. It is a generic provider in the sense that it handles all known archive providers (via the plugin factory); if any particular archive needs special treatment then code to do so should be added here.
This class has two derived classes, one for choosing display columns and one for choosing orderby columns. The difference is in the filtering of columns, and how the current configuration is merged in.Declaration
protected string _providerEntity
Field Value
Type | Description |
---|---|
string |
Remarks
The AcceptColumn(ArchiveColumnInfo) and AcceptProvider abstract methods are overriden by subclasses and used to restrict the columns and archive providers handled. By default, the standard derived classes will handle all archive providers, but a partner may implement a new subclass which handles some set of providers. By setting the priority parameter of the DynamicMDOProviderPlugin attribute to less than int.MaxValue-100000, the value used by the standard classes, such a partner class may pre-empt the standard classes for its supported providers.
_providerName
This is the base class that translates the list of available columns of an Archive Provider into an MDO list suitable for feeding the archive configuration dialog. It is a generic provider in the sense that it handles all known archive providers (via the plugin factory); if any particular archive needs special treatment then code to do so should be added here.
This class has two derived classes, one for choosing display columns and one for choosing orderby columns. The difference is in the filtering of columns, and how the current configuration is merged in.Declaration
protected string _providerName
Field Value
Type | Description |
---|---|
string |
Remarks
The AcceptColumn(ArchiveColumnInfo) and AcceptProvider abstract methods are overriden by subclasses and used to restrict the columns and archive providers handled. By default, the standard derived classes will handle all archive providers, but a partner may implement a new subclass which handles some set of providers. By setting the priority parameter of the DynamicMDOProviderPlugin attribute to less than int.MaxValue-100000, the value used by the standard classes, such a partner class may pre-empt the standard classes for its supported providers.
Properties
InternalNamePrefix
This property should return the name prefix used to build the SoList provider name from the archive data provider name
Declaration
protected override string InternalNamePrefix { get; }
Property Value
Type | Description |
---|---|
string |
Overrides
Remarks
The AcceptColumn(ArchiveColumnInfo) and AcceptProvider abstract methods are overriden by subclasses and used to restrict the columns and archive providers handled. By default, the standard derived classes will handle all archive providers, but a partner may implement a new subclass which handles some set of providers. By setting the priority parameter of the DynamicMDOProviderPlugin attribute to less than int.MaxValue-100000, the value used by the standard classes, such a partner class may pre-empt the standard classes for its supported providers.
NamePrefix
The prefix used to differentiate our lists from all other MDO lists. To avoid naming collisions, if an archive is called 'activity' then the list we generate here will be called NamePrefix+'activity'. SupportedLists returns a list of the names we support (including prefix).
Declaration
public static string NamePrefix { get; }
Property Value
Type | Description |
---|---|
string |
Remarks
The AcceptColumn(ArchiveColumnInfo) and AcceptProvider abstract methods are overriden by subclasses and used to restrict the columns and archive providers handled. By default, the standard derived classes will handle all archive providers, but a partner may implement a new subclass which handles some set of providers. By setting the priority parameter of the DynamicMDOProviderPlugin attribute to less than int.MaxValue-100000, the value used by the standard classes, such a partner class may pre-empt the standard classes for its supported providers.
Methods
AcceptColumn(ArchiveColumnInfo)
This method will be called once for every available column of the underlying archive provider. By returning true, this method indicates that the column should be included as an item in the final MDO list.
Declaration
protected abstract bool AcceptColumn(ArchiveColumnInfo column)
Parameters
Type | Name | Description |
---|---|---|
ArchiveColumnInfo | column | Column information |
Returns
Type | Description |
---|---|
bool | true if column should be in constructed MDO list |
Remarks
The AcceptColumn(ArchiveColumnInfo) and AcceptProvider abstract methods are overriden by subclasses and used to restrict the columns and archive providers handled. By default, the standard derived classes will handle all archive providers, but a partner may implement a new subclass which handles some set of providers. By setting the priority parameter of the DynamicMDOProviderPlugin attribute to less than int.MaxValue-100000, the value used by the standard classes, such a partner class may pre-empt the standard classes for its supported providers.
BuildItem(int, ArchiveColumnInfo)
Build an ISoListItem based on the column info
Declaration
protected virtual ISoListItem BuildItem(int id, ArchiveColumnInfo columnInfo)
Parameters
Type | Name | Description |
---|---|---|
int | id | Unique ID to assign |
ArchiveColumnInfo | columnInfo | Column information |
Returns
Type | Description |
---|---|
ISoListItem | List item, including can order by indicator |
Remarks
The AcceptColumn(ArchiveColumnInfo) and AcceptProvider abstract methods are overriden by subclasses and used to restrict the columns and archive providers handled. By default, the standard derived classes will handle all archive providers, but a partner may implement a new subclass which handles some set of providers. By setting the priority parameter of the DynamicMDOProviderPlugin attribute to less than int.MaxValue-100000, the value used by the standard classes, such a partner class may pre-empt the standard classes for its supported providers.
BuildList(string, string, string, bool)
This method is called during stage 2 of the two-phase construction process (from the Construct method). The actual implementation of the list construction, including new'ing the _rootItems and _headingItems collections is done here. Note that _historyItems is by default always empty for this kind of list, so it is pre-allocated as such by the base class.
Declaration
protected override void BuildList(string providerName, string guiControl, string searchValue, bool forceFlatList)
Parameters
Type | Name | Description |
---|---|---|
string | providerName | |
string | guiControl | Name of GUI control, if provided by caller |
string | searchValue | Search value, if provided by caller |
bool | forceFlatList | Should the resulting list be forced to flat format (root items only) |
Overrides
Remarks
The AcceptColumn(ArchiveColumnInfo) and AcceptProvider abstract methods are overriden by subclasses and used to restrict the columns and archive providers handled. By default, the standard derived classes will handle all archive providers, but a partner may implement a new subclass which handles some set of providers. By setting the priority parameter of the DynamicMDOProviderPlugin attribute to less than int.MaxValue-100000, the value used by the standard classes, such a partner class may pre-empt the standard classes for its supported providers.