Class LinksBySourceProviderBase<MainExtenderType>

Base class for link data providers that are addressed by source - that is, where the source (left) side of the link is a known appointment, sale or document, and we wish to retrieve the right side.

Inheritance
Object
ExtensibleColumnsBase
QueryProviderBase<ArchiveRow>
TypedQueryProviderBase<ArchiveRow, MainExtenderType>
LinksBySourceProviderBase<MainExtenderType>
LinksBySourceProviderLeftBase<MainExtenderType>
LinksBySourceProviderRightBase<MainExtenderType>
Inherited Members
Namespace: SuperOffice.CRM.ArchiveLists
Assembly: SoDataBase.dll
Syntax
public abstract class LinksBySourceProviderBase<MainExtenderType> : TypedQueryProviderBase<ArchiveRow, MainExtenderType>, IArchiveProviderQueryMapping, IArchiveQueryProvider, IArchiveProviderExtensible, IArchiveTypedProvider<ArchiveRow>, IArchiveTypedProviderBase, IArchiveProvider, IArchiveProviderHasRows, IArchiveProviderHasColumns, IArchiveProviderHasEntities, IPlugin where MainExtenderType : IArchiveExtender, new()
Type Parameters
Name Description
MainExtenderType

Type of the main data extender to use
Remarks

This class processes the sourceXXX restrictions and sets up the join to the relations table, as well as setting default link hints on the generated rows. These providers are the ones used to retrieve the Links archives initially. The Web client will then parse the rows and switch to use ByDestination addressing, which is what is needed to Edit the Links archive, based on state maintained by the client.

The Extenders used for BySource addressing derive directly from the respective bases (such as SaleExtenderBase), since they are connected to a query on a different table (relations, for the links). ByDestination addressing uses root extenders (such as SaleSaleExtender), since the restriction applies directly to the table we'll be fetching from.

To support bidirectional link fetching, we subclass into Left and Right variants, each with a corresponding Extender. The Extnder handles joingin and population, while the Left and Right provider subclasses handle restrictions. It's still BySource as seen by the LinksProvider system.

Constructors

LinksBySourceProviderBase(ArchiveRowTypeInfo)

Create the provider, set up c ustom processing for the source restrictions (appointment, sale, document). Instantiate the main extender, which is our type parameter. register the entity.

Declaration
protected LinksBySourceProviderBase(ArchiveRowTypeInfo entity)
Parameters
Type Name Description
ArchiveRowTypeInfo entity

Entity that we are processing

Fields

_colRelationId

Declaration
protected ArchiveColumnInfo _colRelationId
Field Value
Type Description
ArchiveColumnInfo

_colRelcomment

Declaration
protected ArchiveColumnInfo _colRelcomment
Field Value
Type Description
ArchiveColumnInfo

_colSourceAppointmentRestrictionId

Declaration
protected ArchiveColumnInfo _colSourceAppointmentRestrictionId
Field Value
Type Description
ArchiveColumnInfo

_colSourceContactRestrictionId

Declaration
protected ArchiveColumnInfo _colSourceContactRestrictionId
Field Value
Type Description
ArchiveColumnInfo

_colSourceDocumentRestrictionId

Declaration
protected ArchiveColumnInfo _colSourceDocumentRestrictionId
Field Value
Type Description
ArchiveColumnInfo

_colSourcePersonRestrictionId

Declaration
protected ArchiveColumnInfo _colSourcePersonRestrictionId
Field Value
Type Description
ArchiveColumnInfo

_colSourceProjectRestrictionId

Declaration
protected ArchiveColumnInfo _colSourceProjectRestrictionId
Field Value
Type Description
ArchiveColumnInfo

_colSourceSaleRestrictionId

Declaration
protected ArchiveColumnInfo _colSourceSaleRestrictionId
Field Value
Type Description
ArchiveColumnInfo

_colSourceSelectionRestrictionId

Declaration
protected ArchiveColumnInfo _colSourceSelectionRestrictionId
Field Value
Type Description
ArchiveColumnInfo

_numDestinationRestrictions

Declaration
protected int _numDestinationRestrictions
Field Value
Type Description
Int32

_relationsTable

Declaration
protected RelationsTableInfo _relationsTable
Field Value
Type Description
RelationsTableInfo

LinkDescription

Declaration
public const string LinkDescription = "linkDescription"
Field Value
Type Description
String

LinkId

Declaration
public const string LinkId = "linkId"
Field Value
Type Description
String

Properties

PrimaryTable

Declaration
public override TableInfo PrimaryTable { get; }
Property Value
Type Description
TableInfo
Overrides
SuperOffice.CRM.ArchiveLists.TypedQueryProviderBase<SuperOffice.CRM.ArchiveLists.ArchiveRow, MainExtenderType>.PrimaryTable

TableToExtend

Declaration
public override TableInfo TableToExtend { get; }
Property Value
Type Description
TableInfo
Overrides
SuperOffice.CRM.ArchiveLists.QueryProviderBase<SuperOffice.CRM.ArchiveLists.ArchiveRow>.TableToExtend

Methods

InnerMapFields()

Declaration
public override void InnerMapFields()
Overrides
SuperOffice.CRM.ArchiveLists.QueryProviderBase<SuperOffice.CRM.ArchiveLists.ArchiveRow>.InnerMapFields()

InnerPopulateRowFromReader(SoDataReader, ArchiveRow)

Override: Set row navigation based on the entity name and row primary key

Declaration
protected override void InnerPopulateRowFromReader(SoDataReader reader, ArchiveRow row)
Parameters
Type Name Description
SoDataReader reader
ArchiveRow row
Overrides
SuperOffice.CRM.ArchiveLists.TypedQueryProviderBase<SuperOffice.CRM.ArchiveLists.ArchiveRow, MainExtenderType>.InnerPopulateRowFromReader(SuperOffice.Data.SoDataReader, SuperOffice.CRM.ArchiveLists.ArchiveRow)

ProcessRestrictions()

Override: Process one (1) source restriction, via the base class and CustomBinding mechanism of the RestrictionHelper.

Declaration
protected override bool ProcessRestrictions()
Returns
Type Description
Boolean
Overrides

ProcessSourceRestriction(TableInfo, ArchiveRestrictionInfo, ArchiveSelect)

Declaration
protected abstract void ProcessSourceRestriction(TableInfo sourceTable, ArchiveRestrictionInfo restriction, ArchiveSelect targetQuery)
Parameters
Type Name Description
TableInfo sourceTable
ArchiveRestrictionInfo restriction
ArchiveSelect targetQuery

Implements

Extension Methods

EnumUtil.MapEnums<From, To>(From)