profilesWebService Element

  • Article

For the latest version of Commerce Server 2007 Help, see the Microsoft Web site.

The profilesWebService element provides the means to configure the behavior of the Profiles Web service. This element is required, and should be used only in the web.config file for the Profiles Web Service (<drive>:\Inetpub\wwwroot\ProfilesWebService\Web.config).

The following table lists the attributes of the profilesWebService element.

Attribute

Data type

Description

authorizationPolicyPath

String

File path of the Windows Authorization Manager authorization policy store. If the disableAuthorization attribute is true, this attribute is not validated.

This attribute is required.

backgroundThreadActive

String

Determines whether the Profiles Web service will run a background thread that will periodically clean up expired entries from the profile object cache.

If the value of this attribute is true, the background thread will be run. If false, the thread will not be run.

The value of this attribute must represent a Boolean.

This attribute is optional.

bypassProfileCache

String

Determines whether the Profiles Web service will always go to the data source when retrieving profile instances.

If the value of this attribute is true, the Profiles Web service will always go to the data source when retrieving profile instances. If false, the Profiles Web service will not always go to the data source.

Setting the value to true effectively disables caching at the Web service. The purpose of this flag is to enable the Profiles Web service to operate in a Web farm deployment without the risk of cache inconsistency between servers.

The value of this attribute must represent a Boolean.

This attribute is optional.

connectionRetries

String

The number of times the Profiles Web Service will retry connecting to a data source before failing.

The value of this attribute must represent an integer.

This attribute is optional.

connectionRetryDelaySeconds

String

The number of seconds to wait between attempts to connect to a data source.

The value of this attribute must represent an integer.

This attribute is optional.

disableAuthorization

String

Determines whether the Profiles Web service will perform authorization checks.

If the value of this attribute is true, the Web service will not perform any authorization checks. If false, authorization checks will be performed.

The value of this attribute must represent a Boolean.

This attribute is optional.

keyIndex

String

Specifies which private key token corresponds to. Valid values are the following:

  • 1 (for privateKey1)

  • 2 (for privateKey2)

  • The value of this attribute must represent an integer.

  • This attribute is optional.

privateKey1

String

Hexadecimal string that represents the private key for keyIndex 1.

Alternatively, you can use the format: registry:{hive}[\{subkey}],[{valuename}] where hive is the key hive name (for example, HKEY_LOCAL_MACHINE) and subkey is an optional subkey name. If valuename is not specified, the (Default) value is used. Keys formatted in this manner are encrypted in the specified registry value. You can create these types of keys using Using the Profile Key Manager with the /reg flag.

This attribute is optional.

privateKey2

String

Hexadecimal string that represents the private key for keyIndex 2.

Alternatively, you can use the format: registry:{hive}[\{subkey}],[{valuename}] where hive is the key hive name (for example, HKEY_LOCAL_MACHINE) and subkey is an optional subkey name. If valuename is not specified, the (Default) value is used. Keys formatted in this manner are encrypted in the specified registry value. You can create these types of keys using Using the Profile Key Manager with the /reg flag.

This attribute is optional.

profileObjectAgeoutTimeMilliseconds

String

The number of milliseconds that an unreferenced profile object can remain in the cache without being discarded.

The value of this attribute must represent an integer.

This attribute is optional.

profileObjectCacheSize

String

The size of the Profiles Web service profile object cache.

The value of this attribute must represent an integer.

This attribute is optional.

profileSchemaCacheSize

String

The size of the Profiles Web service profile schema cache.

The value of this attribute must represent an integer.

This attribute is optional.

publicKey

String

Hexadecimal string that represents the public key that the Profiles Web service uses.

Alternatively, you can use the format: registry:{hive}[\{subkey}],[{valuename}] where hive is the key hive name (for example, HKEY_LOCAL_MACHINE) and subkey is an optional subkey name. If valuename is not specified, the (Default) value is used. Keys formatted in this manner are encrypted in the specified registry value. You can create these types of keys using Using the Profile Key Manager with the /reg flag.

This attribute is optional.

searchResultsLimit

String

The maximum number of records that can be returned from a search operation. This only affects SELECT bulk query operations through the agent/Web service.

The value of this attribute must represent an integer.

This attribute is optional.

siteName

String

The name of the site with which this Web service is operating.

This attribute is required and is automatically set during the Pup process.

Example

<configuration>
    <CommerceServer>
        <profilesWebService
            siteName=”string”
            authorizationPolicyPath=”string”
            disableAuthorization=”boolean”
            searchResultsLimit=”integer”
            bypassProfileCache=”Boolean"
            profileObjectCacheSize=”integer”
            profileSchemaCacheSize=”integer”
            backgroundThreadActive=”Boolean”
            profileObjectAgeoutTimeMilliseconds=”integer”
            connectionRetries=”integer”
            connectionRetryDelaySeconds=”integer”
            publicKey=”string”
            keyIndex=”integer”
            privateKey1=”string”
            privateKey2=”string”>
            <presentationConfiguration>
                <cultureConfig filePath=”string” isDefault=”bool”/>
                …
            </presentationConfiguration>
        </profilesWebService>
    </CommerceServer>
<configuration>  />

See Also

Other Resources

Web.Config Configuration Settings

profiles Element