<< Click to Display Table of Contents >> Navigation:  Customization > LWCRM Object Model > Object LWCRM.Database

Als databasegegevens moeten worden opgevraagd of gewzijgid dan biedt dit object enkele handige eigenschappen en methoden.

 

 

Connection : ADO Connection

Hiermee kan de actuele connectie naar de database worden opgevraagd.

 

Voorbeeld

rstContact.Open strSQL, LWCRM.Database.Connection, adOpenForwardOnly, adLockReadOnly, adCmdText

 

 

DeleteObjectEntry : Boolean

Verwijderd de opgegeven tabelregel.

 

Syntax

blnRemoved = LWCRM.Database.DeleteObjectEntry( intObjectType, strPrimaryKeyValue )

 

Parameters

intObjectType

Geef het  objecttype door waarvan u een item wilt verwijderen.

 

strPrimaryKeyValue

De primary key waarmee de entry kan worden opgezocht.

 

Voorbeeld

blnRemoved = LWCRM.Database.DeleteObjectEntry( otContact, "00012" )

 

 

Execute : Long

Voert een Transact SQL statement op de database uit. Als resultaat wordt het aantal bijgewerkte of verwijderde records teruggegeven.

 

Syntax

lngEffectedRows = LWCRM.Database.Execute( strSQL )

 

Parameters

strSQL

Een voor de actieve database geldig Transact SQL statement.

 

Voorbeeld

lngEffectedRows = LWCRM.Database.Execute( "UPDATE StockTransactions SET Processed = 1 WHERE Processed = 0"  )

 

 

GetFieldValue : String

Retourneert de waarde van de eerste kolom van de eerst geselecteerde regel. Eventuele NULL waarden worden als 0 of als '' geretourneerd.

 

Syntax

strValue = LWCRM.Database.GetFieldValue( strSQL )

 

Parameters

strSQL

Een voor de actieve database geldig SQL statement.

 

Voorbeeld

strCountry = LWCRM.Database.GetFieldValue( " SELECT Name FROM Countries WHERE CountryCode = 'NL' "  )

 

 

Newkey : String

Genereert een nieuwe primary key op basis van het doorgegeven sleutelveld. Dit sleutelveld moet voorkomen in de tabel 'crmPrimaryId'.

 

Syntax

strKeyValue = LWCRM.Database.Newkey( strKeyFieldName )

 

Parameters

strKeyFieldName

De naam van het sleutelveld.

 

Voorbeeld

strAccountId = LWCRM.Database.Newkey( "AccountId" )

 

 

RetrieveXmlLayout : XML

Retourneert de record layout in XML formaat. Deze layout kan als basis dienen voor het vullen van nieuw toe te voegen records aan de desbetreffende tabel.

 

Syntax

xmlRow = LWCRM.Database.RetrieveXmlLayout( strTableName )

 

Parameters

strTableName

De naam van de tabel waarvan de recordstructuur moet worden opgehaald.

 

Voorbeeld

xmlAccounts = LWCRM.Database.RetrieveXmlLayout( "Accounts" )

 

 

SQLDelete : String

Genereert een correct DELETE statement, afhankelijk van het gebruikte type database.

 

Syntax

strSqlDelete = LWCRM.Database.SQLDelete( strTableName )

 

Parameters

strTableName

De naam van de tabel waarvoor een DELETE statement moet worden geretourneerd.

 

Voorbeeld

strSQL = LWCRM.Database.SQLDelete("Accounts") + " WHERE AccountId = '00001' "

 

 

SafeRowUpdate : Boolean

Slaat de waarde van alle tags in de XML op in het opgegeven record. Er wordt geen Update-actie uitgevoerd, dat moet de gebruiker zelf in zijn script doen.

 

Syntax

blnSuccess = LWCRM.Database.SafeRowUpdate( txtUserId, rstRow, xmlRowdata )

 

Parameters

strUserId

De ID van de huidige gebruiker, welke kan worden bepaald middels LWCRM.User.UserId

 

rstRow

Referentie naar de ADO Recordset welke moet worden bijgewerkt.

 

Voorbeeld

If LWCRM.Database.SafeRowUpdate( LWCRM.User.UserId, rstContact, xmlContact ) Then ...

rstContact.Update

 

 

LoadSQLQuery : String

Deze functie retourneert een databaseafhankelijk SQL statement, welke met de Query Builder is gedefinieerd.

 

Syntax

strSQL = LWCRM.Database.LoadSQLQuery( strSQLQueryId  )

 

Parameters

strSQLQueryId

Deze ID wordt gebruikt om de gewenste Query definitie op te zoeken in de tabel 'SQLQueries'

 

Voorbeeld

strSQL = LWCRM.Database.LoadSQLQuery( "00002" )

 

 

RetrieveColumnValue : Variant

Retourneert de kolomwaarde van de geselecteerde kolom. De regel wordt opgezocht met behulp van de doorgegeven Primary Key veldwaarde.

 

Syntax

varFieldValue = LWCRM.Database.RetrieveColumnValue( strTableName, strFieldName, varPrimaryKeyValue )

 

Parameters

strTableName

De naam van de tabel waarin het opgegeven veldwaarde moet worden opgezocht.

 

strFieldName

De naam van het veld waarvan het opgegeven veldwaarde moet worden opgezocht.

 

varPrimaryKeyValue

De waarde van het sleutelveld van de opgegeven tabel, waarin het opgegeven veld zich bevindt.

 

Voorbeeld

strCompanyName = LWCRM.Database.RetrieveColumnValue( "accounts", "name", "00211" )

 

 

ExportToCSV : Boolean

Met deze method kan een query direct wordt geexporteerd naar een extern CSV-bestand. Bij de export wordt het 'standaard' CSV-formaat aangehouden:

- de eerste regel bestaat uit een koptekst

- velden worden gescheiden door komma's

- regels worden afgesloten met een <enter>

- tekst wordt omsloten door dubbele quotes ( " )

- de komma's in bedragen wordt omgezet naar een punt ( . )

- het internationale datumformaat wordt gehanteerd (yyyy-mm-dd oftwel jaar-maand-dag)

- in de logische (ja/nee) velden wordt 'ja' met een '1' aangeduid en 'nee' met een '0'

 

Syntax

blnExported = LWCRM.Database.ExportToCSV( strSql, strFileName )

 

Parameters

strSql

Dit dient een geldige SQL expressie te zijn.

 

strFileName

De naam van het uitvoerbestand.

 

Voorbeeld

strSql = "SELECT * FROM contacts"

blnExported = LWCRM.Database.ExportToCSV( strSql, "c:\temp\test.csv" )

 

 

ExportToXLS : Boolean

Met deze method kan een query direct wordt geexporteerd naar een extern Microsoft Excel bestand (XLS-formaat).

 

Syntax

blnExported = LWCRM.Database.ExportToXLS( strSql, strFileName )

 

Parameters

strSql

Dit dient een geldige SQL expressie te zijn.

 

strFileName

De naam van het uitvoerbestand.

 

Voorbeeld

strSql = "SELECT * FROM contacts"

blnExported = LWCRM.Database.ExportToXLS( strSql, "c:\temp\test.xls" )