Namespace: OpenEdge.DataAdmin.DataAccess
Type: Class DataAccess
Parent Classes:
Progress.Lang.Object
OpenEdge.DataAdmin.DataAccess.DataAccess

Inherits: Progress.Lang.Object
Implements: OpenEdge.DataAdmin.DataAccess.IDataAccess

/* Copyright (c) 2010 by progress Software Corporation
/*
/* all rights reserved. no part of this program or document
/* may be reproduced in any form or by any means without
/* permission in writing from progress Software Corporation.
Author(s):hdaniels
Created:Wed Feb 10 03:01:11 EST 2010
/*using OpenEdge.DataAdmin.DataSource.DataSource.



Method Summary
  Options Name Purpose
  ActivateChildRelations (handle)
  LOGICAL AddUniqueOrNone (character, QueryString) /** return true if the table is not in the search and not added or if it can be unquely identified and was added false - in search query and not avail ? - in search query and ambiguous or joined to others with OR */
  Progress.Lang.Error ClientTransactionError (Error)
  CHARACTER ColumnExpression (character, character, character) /* (part of IQueryMap interface used by QueryString to map query */
  CHARACTER ColumnSortSource (character) /* (part of IQueryMap interface used by QueryString to map query) kept here because many subclasses still implement Iquerymap */
  CHARACTER ColumnSource (character) /* return source columns for query mapping (part of IQueryMap interface used by QueryString to map query */
  Create ()
  OpenEdge.DataAdmin.DataSource.IDataSource CreateReadSource (character)
  OpenEdge.DataAdmin.DataSource.IDataSource CreateSaveSource (character)
  DeactivateChildRelations (handle)
  OpenEdge.DataAdmin.DataSource.IDataSource DestroySources ()
  FetchData (IFetchRequest) /* TODO - make abstract */
  CHARACTER FindTableJoinValues (character, character) /* returns a join expression on current values of the table i example : "_StorageObject._PartitionId = " + quoter(_Tenant._Tenantid) blank is not found ? is ambiguous or complex expression with other tables (or non existing) Called from ParentJoinQuery, and must be overridden with unique find for related tables if this functionality is needed. */
  CHARACTER FindUniqueOrNoneQuery (character, character)
  OpenEdge.DataAdmin.DataSource.IDataSource GetReadSource (character) /* used by data access for fill when data sources needs access to each other subclass must implement createReadSource */
  OpenEdge.DataAdmin.DataSource.IDataSource GetSaveSource (character) /* used by data access for save traverse through the dataset tree subclass must implement createSaveSource This is an all or none - the data access objects that use this use it for all It is generic enough to be used by all */
  OpenEdge.DataAdmin.DataSource.IDataSource GetSource (character, log)
  refreshBuffer (handle)
  SaveBuffer (handle, integer)
  SaveBuffers (handle)
  SaveChildBuffers (IDataSource, handle, integer)
  OpenEdge.DataAdmin.Message.ISaveRequest SaveData (ISaveRequest) /* */
  StartDataSources ()
  ThrowPrepareError (Error, character, character)

Constructor Summary
  Options Name Purpose
  DataAccess ()

Property Summary
  Options Name Purpose
  OpenEdge.DataAdmin.DataSource.DatabaseInfo DatabaseInfo
  HANDLE DatasetHandle
  CHARACTER Url
  OpenEdge.DataAdmin.Lang.WebUtil WebUtil


Method Detail
Top

ActivateChildRelations (handle)

Parameters:
phbuffer HANDLE
 
Top

LOGICAL AddUniqueOrNone (character, QueryString)

Purpose: return true if the table is not in the search and not added
or if it can be unquely identified and was added
false - in search query and not avail
? - in search query and ambiguous or joined to
others with OR
Parameters:
pcTable CHARACTER
 
pQueryStr OpenEdge.DataAdmin.Lang.QueryString
 
Returns LOGICAL
 
Top

Progress.Lang.Error ClientTransactionError (Error)

Parameters:
e Progress.Lang.Error
 
Returns Progress.Lang.Error
 
Top

CHARACTER ColumnExpression (character, character, character)

/* (part of IQueryMap interface used by QueryString to map query
Parameters:
pcColumn CHARACTER
 
pcOperator CHARACTER
 
pcValue CHARACTER
 
Returns CHARACTER
 
Top

CHARACTER ColumnSortSource (character)

/* (part of IQueryMap interface used by QueryString to map query)
kept here because many subclasses still implement Iquerymap
Parameters:
pcColumn CHARACTER
 
Returns CHARACTER
 
Top

CHARACTER ColumnSource (character)

/* return source columns for query mapping
(part of IQueryMap interface used by QueryString to map query
Parameters:
pcColumn CHARACTER
 
Returns CHARACTER
 
Top

Create ()
Top

OpenEdge.DataAdmin.DataSource.IDataSource CreateReadSource (character)

Parameters:
pcName CHARACTER
 
Returns OpenEdge.DataAdmin.DataSource.IDataSource
 
Top

OpenEdge.DataAdmin.DataSource.IDataSource CreateSaveSource (character)

Parameters:
pcName CHARACTER
 
Returns OpenEdge.DataAdmin.DataSource.IDataSource
 
Top

DeactivateChildRelations (handle)

Parameters:
phbuffer HANDLE
 
Top

OpenEdge.DataAdmin.DataSource.IDataSource DestroySources ()

Returns OpenEdge.DataAdmin.DataSource.IDataSource
 
Top

FetchData (IFetchRequest)

/* TODO - make abstract
Parameters:
msg OpenEdge.DataAdmin.Message.IFetchRequest
 
Top

CHARACTER FindTableJoinValues (character, character)

/* returns a join expression on current values of the table i
example : "_StorageObject._PartitionId = " + quoter(_Tenant._Tenantid)
blank is not found
? is ambiguous or complex expression with other tables (or non existing)
Called from ParentJoinQuery, and must be overridden with unique find
for related tables if this functionality is needed.
Parameters:
pTable CHARACTER
 
pFind CHARACTER
 
Returns CHARACTER
 
Top

CHARACTER FindUniqueOrNoneQuery (character, character)

Parameters:
pcTable CHARACTER
 
pcQuery CHARACTER
 
Returns CHARACTER
 
Top

OpenEdge.DataAdmin.DataSource.IDataSource GetReadSource (character)

/* used by data access for fill when data sources needs access to each other
subclass must implement createReadSource
Parameters:
pcName CHARACTER
 
Returns OpenEdge.DataAdmin.DataSource.IDataSource
 
Top

OpenEdge.DataAdmin.DataSource.IDataSource GetSaveSource (character)

/* used by data access for save traverse through the dataset tree
subclass must implement createSaveSource
This is an all or none - the data access objects that use this use it for all
It is generic enough to be used by all
Parameters:
pcName CHARACTER
 
Returns OpenEdge.DataAdmin.DataSource.IDataSource
 
Top

OpenEdge.DataAdmin.DataSource.IDataSource GetSource (character, log)

Parameters:
pcName CHARACTER
 
plSave LOGICAL
 
Returns OpenEdge.DataAdmin.DataSource.IDataSource
 
Top

refreshBuffer (handle)

Parameters:
pds HANDLE
 
Top

SaveBuffer (handle, integer)

Parameters:
phBuffer HANDLE
 
pistate INTEGER
 
Top

SaveBuffers (handle)

Parameters:
phDataset HANDLE
 
Top

SaveChildBuffers (IDataSource, handle, integer)

Parameters:
pdatasource OpenEdge.DataAdmin.DataSource.IDataSource
 
phBuffer HANDLE
 
piState INTEGER
 
Top

OpenEdge.DataAdmin.Message.ISaveRequest SaveData (ISaveRequest)

/*
Parameters:
pSaveReq OpenEdge.DataAdmin.Message.ISaveRequest
 
Returns OpenEdge.DataAdmin.Message.ISaveRequest
 
Top

StartDataSources ()
Top

ThrowPrepareError (Error, character, character)

Parameters:
e Progress.Lang.Error
 
pQuery CHARACTER
 
cname CHARACTER
 


Constructor Detail
Top

DataAccess ()


Property Detail
Top

OpenEdge.DataAdmin.DataSource.DatabaseInfo DatabaseInfo

Returns OpenEdge.DataAdmin.DataSource.DatabaseInfo
 
Top

HANDLE DatasetHandle

Returns HANDLE
 
Top

CHARACTER Url

Returns CHARACTER
 
Top

OpenEdge.DataAdmin.Lang.WebUtil WebUtil

Returns OpenEdge.DataAdmin.Lang.WebUtil