Properties, Events and Methods

MemberDescription
addfieldvalueThis method will add a value the a field property of the oData object. Before adding the value it will validate it's datatype. If incorrect it will return False and an error message placed in cErrorMsg (Public).
o.addfieldvalue( tcFieldName, tvFieldValue, tlChangeDataType)
cleardataThis method will clear all results and data values in the object. Best used when you want to keep using most of the settings of the object but just want to clear existing data and errors (Public)
o.cleardata()
createadataThis populates the property aData as an array representation of oData. oData must have already been loaded for this to work (Public)
o.createadata()
createnewid
o.createnewid( tcTableID)
createorowsThis method converts the passed in cursor to a collection in property oRows (Public)
o.createorows( tcCursor)
cursortoxmlThis save the cursor to xml and adds index and structure information to the XML (Public)
o.cursortoxml( tccursor, tlTableNode, tlOmitHeader)
deletequery This method will delete all records resulting from the query. You must include only the "Where" part of the query. (Public)
o.delete()
deletequeryThis method will delete all records resulting from the query. You must include only the "Where" part of the query. (Public)
o.deletequery( tcFilter)
foxcommandThis executes a fox command and returns the results. Only to be used by peoplel who know what there doing (Public)
o.foxcommand( tcCommand, tlNoReturn)
foxstructuretostringReturns a string used to re create a fox table (Public)
o.foxstructuretostring( tcCursorName,tlModified)
getblankrecordRetrieves an empty record and creates an empty oData member. Note no defaults are set.
o.getblankrecord()
getfieldvalueThis method returns the value of a field from a table record. The record retireved is governed by the passed in filter (Public)
o.getfieldvalue( tcField, tcFilter)
getorowsitemThis is used to retrieve items from the oRows property. This is necessary due to issues with visual basic accessing the oRows property (Public)
o.getorowsitem( tnItem)
getparentpkvalueReturns the value of the Parent PK fo rthe loaded record
o.getparentpkvalue()
getpkvalueThis is a simple method for retrieving the PK value of a business object (Public)
o.getpkvalue()
importfromtableThis method will import data from another table. It will only apply matched field names
o.importfromtable( tcFileName, tcMatchonExpression ,tcDefaultValueRecord, tcImportIDField, tcIgnoreFields)
importfromxmlImports data from an xml file
o.importfromxml( tcFileName, tcMatchonExpression ,tcDefaultValueRecord, tcImportIDField, tcIgnoreFields)
isvalidReturns true if the passed in value is valid for the passed in field name (Public)
o.isvalid( tcValue, tcField, tcFilter)
loadparent Loads an instance of the parent into the member oParent
o.load()
loadtableThis method pulls a copy of the table down from the data server (Public)
o.loadtable( tcFilter, tcAlias, tcSelect, tlIsChild, lnResultMode)
loginuserThis performs the promatrix login. If the password is not valid then it returns false
o.loginuser( tcID)
makecdataThis creates an xml version of odata and places into (Public)
o.makecdata()
newrecord Exactly the same as the New command. Introduced so as to avoid command conflict in Languages in .NET
o.new( llNoNewPK)
newrecordExactly the same as the New command. Introduced so as to avoid command conflict in Languages in .NET
o.newrecord( llnonewpk)
opendatabaseexclusive Tries to open a data base exclusively
o.open()
opendatabaseexclusive Tries to open a data base exclusively
o.opendatabase( tcDataBase, tlExclusive)
opendatabaseexclusiveTries to open a data base exclusively
o.opendatabaseexclusive( tcDataBase)
query
o.query( lcSelect as String ,
lcCursor as String ,
lnResultmode as Integer ,
llEditable as Boolean ,
lLoadFirstRecord as Boolean ,
tcTableList as String ,
tlNoNulls as Boolean
)
recordvalidateValidates data in a record (Public)
o.recordvalidate()
resetResets dynamic properties to default (Public)
o.reset()
savetableinfo Stores inex and table structure info to object
o.save()
seterror
o.seterror()
settableSets the table properties of the object with the table name passed in (Public)
o.settable( tcTable)
submitasynchjob
o.submitasynchjob()
validateexcludedfieldMethod to test if validation is excluded for the passed in field (Public)
o.validateexcludedfield( tcField)
caliasThe Alias of the master file.
casynchjobidID for Asycnh Job when submitted
cblockreasonThe reason for the data object block (Public)
cconnectioncodeThe code for the connection to use. This code relates to local a table holding connection settings (Public)
cdataAn XML Vrsion of odata for Http communication (Public)
cdatabaseThe name of the database in which to find the tables (Public)
cdatadictionarypathHolds the path to the data dictiionary tables
cdatapathLocation of the data
cdatatablestructureHolds the data structure of odata
cerrormsgAny error messages that occurred.
cfieldvalidationexcludelistAny fields in this list will not be validated. Used for saving child records of for parent records that haven't been saved yet (Public)
cfilenameFilename of the master file of this business object.
cfilterThis property will hold any filter to be applied to the query and loadtable methods. This will be added to filter parameter
chookprogramfileThis holds the location of the hook file to use for the hook server
chttpmethodThe name of the method being called via HTTP
chttpparametersHolds an XML listing of parameteters being passed via HTTP
chttpservernameThe server name for the HTTPCOM (Public)
clastmodfieldModified by InfoToday: Holds the name of the last modified field
clocaltablenameThis is the name that the data object will use for working on a local copy of the table related to this data object. IT_Datagrid and also table updates use this to know which table to use (Public)
cparentqueryexpressionThis can hold the field expression to use when doing queries. It is used so that we can match index expressions exactly to improve speed. This is used if parent values are provided (Public)
cparentvalueThis is the code for the parent information. This can be used to determine properties of parent and also to obntain table names for this object (Public)
cpasswordUser Password (Public)
cpkexpressionThis expression defines any operation to perform before locating the PK value. It will be evaluated with the assumption that the PK value will be in the variable lcPKValue (Public)
cpkfieldThe field used as the primary key in the table. This field must be an integer or numeric field.
cpkidtypeSpecifies data type of the pk id - "C" for character or "N" for numeric
cpkqueryexpressionThis can hold the field expression to use when doing queries. It is used so that we can match index expressions exactly to improve speed. This is used if PK values are provided (Public)
cpkvalueHolds character PK Values (Public)
cpropertiesreturnedonlyThis comma deleimited list of properties are returned only from the HTTP server
cpropertiestopassbothwaysThis comma delimited list of properties will be passed over HTTP to the server. All others will be ignored
cpropertiestosendonlyThis comma delimited list of properties will be passed over HTTP to the server but only in the to server direction.
cproxypassThe password to use for Proxy Connections (Public)
cproxyserverAddress of proxy server (Public)
cproxyuserThe domain\User to use for proxy connections (Public)
cresultxmlMethods returning XML will return the XML in this property.
csystemcodeHolds the code for a system. This can be referenced by the systems class to get connection properties (Public)
ctableThis holds the name of the table within the database. cFileName will hold the physiacl table file name (Public)
ctablestructureHolds the structure of the table so it can be recreated on the client if required
cuseridUser ID (Public)
lallowpksetIf this is true the users will be allowed to set the PK value of a table. This is useful when using the oTable object
lallowwriteThis is a read only property. It is used to totally block write access to the table being accessed by this object. It cannot be changed (Public)
lblockedFlags wether access to the table represented by this data object is blocked. Blockeaso could hold the reason for the block (Public)
lcheckrequiredUsed to switch of rams value checks for new records created by the ITRDS
lcreateidonnewIf this is true then a unique id is assigned to New records. To assign IDs on save then use the lCreateIDONSave (Public)
lcreateidonsaveIf this is true then a unique id is assigned to records when saved. To assign IDs on New then use the lCreateIDONNew (Public)
lcustomvalidationThis is an override switch for all custom validation
ldocustompostdeletelogicIf this is true then the custom Post Delete function "Table__PostDelete" will be called after promatrix validation.
ldocustompostsavelogicIf this is true then the custom Post Delete function "Table__PostSave" will be called after promatrix validation.
ldocustompredeletelogicIf this is true then the custom Post Delete function "Table__PreDelete" will be called after promatrix validation.
ldocustompresavelogicIf this is true then the custom Post Delete function "Table__PreSave" will be called after promatrix validation.
ldopostdeletelogicIf this is true then the PostDeleteLogic function is called after deleting (Public)
ldopredeletelogicIf this is true then then predeletelogic function is called prior to deleting the data (Public)
lerrorError flag for the previous operation. Note this property must be managed by the developer for custom methods.
lfieldvalidateIf this is set to true the the FieldValidate function is called first by the record validate function (Public)
lforceloginIf this is true then the user must provide a valid user id and password. This is checked on each method call. See also cUserID and cPassword
lgettablepropertiesonopenIf this is true then the table proerties such as PK field are loaded on open without the user having to manually set them. Setting this to True may slow things down.
lincludedeletedinqueryThis property is for foxpro tables where the query function is to include deleted records (Public)
lincludefoxstructurefromqueryIf this is true then when the query command is issued the fox structure is included in the XML returned
lisasynchprocessThis is used to denote when a process is actually running as an asynch process.
lnoformatfieldsIf this is true then the formatfields method just returns the value without trying to format the value
lopenexclusiveThis flag is used by the open method to open the table exlusively (Public)
lpostsavelogicIf this is true then the method PostSaveLogic will be called after each record save (Public)
lposttounprocessedIf this isi true then when posting batcb transactions they will be assigned to an existing open batch for the current user if possible
lpresavehookserverIf this is true then the hook server is called just prior to committing the changes
lpresavelogicIf this is true then as part of the serverside validation it will call the PreSaveLogic method before saving the record. If this returns false then we exit without saving. (Public)
lpromatrixvalidateIf this is set to true then promatrix validation is carried out
lrecordvalidateFlag to determine if we need to validate each record using the RecordValidate method (Public)
lstoreindexesFlag to determine if indexes are stored (Public)
lstoretablestructureFlag to tell if table structure is stored in this.cTableStructure
lsubmitasasynchprocessDenotes if the method should be submitted as an asynchronous process. Only supported on some methods
lusedefaultvaluesFlag to determine if we need to populate the record with default values (Public)
luseglobaldatasystemThis flag sets whether a data object should use the global data system object to set it's data mode settings (Public)
luseproxyUsed to determine if a proxy server is used for Http connection (Public)
luseseekandreplaceThis tells the ITRDS to use seek commands instead of query commands and replace statements instead of save commands where possible. This improves speed but should only be used when speed is crucial
lusetransactionsTells data modification to use transactions for greater data integrity. Default is True (Public)
lvalidateonsaveFlag that determines whether a Valid
lzlibcompressionIf this is true then everything aside from the soap header is compressed
nhttptimeoutThe timeout for a call to http server. Default = 40secs
nvpmversionHolds the version number of visual promatix used to create the system
nxmlschematypeThis property allows you to specify the type of schema used when returning data via HTTP. 0 = None, 2 = In line Schema and 'Row' format, 3 = In Line VFP Schema and 'Row' syntax, 4 = In Line VFP Schema with FoxPro CursortoXML format
odataData member that receives all of the field names as property values.
oparentHolds an instance of the parent object for this object (Public)
orowsA collection of data rows. Gets populated by the ConvertData method and also it can be the results of the Query method. For non foxpro developers see also the GetoRowsItem method (Public)
vencodedHolds encoded data. Created using the it_encoding class


Last Updated: 16/10/2005