The Directory Services path for read/write access is expressed in the format:
SimpleDBDS://RW/ConnectionString/Table/Key/Reserved/Marshalled Column/DateChanged/DateCreated/[KeyType]/KeyValue
where:
KeyType specifier | Data type of KeyValue specifier | |
---|---|---|
string | String (default) | |
long | 32-bit long integer | |
integer | 16-bit integer | |
single | Single-precision floating-point number | |
double | Double-precision floating-point number | |
currency | Currency | |
date | Date |
The ConnectionString¸ Table, Key, ProgID, MarshalColumn, and DateChanged parameters are identical to the corresponding parameters to the DBStorage.InitStorage method.
The Key parameter references a column in the table referenced by Table that the DBStorage object uses to key into the data source table. It is recommended that this column be configured at table creation to store only unique values.
The MarshalColumn parameter is used to store data that does not appropriately belong in any other column in the data source table. For example, should you specify my_column
as the column in which you want to store data, and no such column exists, then the value that you specify for that column will be stored in the column that you specify as MarshalColumn.
The following sample specifies a read/write ADSI provider that uses the connection string “DSN=cs; UID=sa;PWS=
”, and queries the Volcano Coffee shopper database, in which shopper_id
is the key. By default, the KeyType is string:
SimpleDBDS://RW/DSN=cs;UID=sa;PWD=/vc30_shopper/shopper_id//////Q0H4SE915ASH2KC000Q79QB17E500439
When this path is used to create a SimpleDBDS object, the object’s GetInfo method can be called to retrieve information from the vc30_shopper
table, where the value in the shopper_id
column matches the specified shopper ID.
The methods of the SimpleDBDS object are not usually used directly by ASP in a Commerce Server site. Instead, the AUO is configured to use SimpleDBDS as an ADSI provider, and the AUO is used to access customer information.
The read/write SimpleDBDS supports the following properties.
Property | Description |
---|---|
Name | Portion of the path following “SimpleDBDS://”. |
ADsPath | ADSI path. |
Parent | Name of the ADSI provider, in this case SimpleDBDS. |
The read/write SimpleDBDS supports the following methods.
Method | Description |
---|---|
Get | Retrieves value for a named property from the object. |
GetEx | Same function as Get. |
GetInfo | Reloads the object with property values that exist in the database. |
Put | Sets the value for a named property of an object. |
PutEx | Sets the value for a named property of an object, or allows a property to be cleared. |
SetInfo | Writes object property values to the metabase. |