The site dictionary is an instance of the Dictionary object that contains a copy of the Commerce Server site configuration stored in the Site.csc file. Commerce Server sites access the site configuration using the site dictionary.
The site configuration, available through the site dictionary, includes information such as the path to the site directory, the secure host, and the nonsecure host. The configuration also contains the names of lists of named connection strings and named queries used in the Commerce Server site.
In Commerce Server 3.0 sites, this Dictionary object must be named MSCSSite
.
The following code, from the Clocktower Global.asa file, creates and initializes the site dictionary from the Site.csc file (for an explanation of this code, see ReadDictionaryFromFile):
REM -- Read Site Dictionary
Set FD = Server.CreateObject("Commerce.FileDocument")
Set MSCSSite = Server.CreateObject("Commerce.Dictionary")
Call FD.ReadDictionaryFromFile( Server.MapPath("/clocktower") + "/config/site.csc",
"Metabase", MSCSSite)
Set FD = Nothing
The site dictionary contains the following named values.
Value | Description |
CloseRedirectURL | URL of a Web page to display to the customer when the Commerce Server site is closed. |
ConnectionStringMap | Dictionary object containing connection strings that are available to the site. |
DefaultConnectionString | Default connection string for the site. |
DisableHTTPS | Integer that indicates whether to disable secure HTTP. Zero (0)=enabled; one (1)=disabled. |
DisplayName | The Commerce Server site’s full name. |
NonsecureHostName | Name of the nonsecure host, used by the Page.URL and Page.SURL methods to format the URL on the pages. |
SecureHostName | Name of the secure host, used by the Page.URL and Page.SURL methods to format the URL on the pages. |