CSFSaveHistory

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

Use the CSFSaveHistory pipeline component to record the history string in one of three locations: the User Profile object, the ASP Session Collection, or the HTTP Cookie.

Intended use: Content Selection pipeline, Record stage.

Configuration Values

You can determine where the CSFSaveHistory pipeline component saves the history string by setting component properties. Use the following boxes on the Save History tab of the Component Properties dialog box to determine this information. You must choose one of the following options.

Box

Description

User Profile Object

The property in the user profile to store the history string. The default is Advertising Info.Campaign History.

ASP Session Collection

The key in the Session object containing the history string. Requires that the component be configured with the proper key and that the pipeline be executing in ASP.NET. This is the default option.

HTTP Cookie

The key in the Cookies object containing the history string. This option requires that the component be configured with the proper key and that the pipeline be executing in ASP.NET context.

Values Read

The CSFSaveHistory pipeline component reads the following values from the indicated dictionary.

Key

Dictionary

Description

_history

Order

The history string that is retrieved.

Values Written

None.

Errors

The CSFSaveHistory pipeline component returns error level 3 (OPPERRORLEV_FAIL) when an error occurs.

Remarks

Saves the history string in one of the same three locations that the CSFSaveHistory pipeline component can use as a source.

The property page for this component supports the same three choices as the property page for the CSFSaveHistory pipeline component.

When using the User Profile object option, it is possible to use either a field that is mapped to a data column in a table, or a field that is not mapped. If the field is not mapped, the history string is persisted only for the duration of the user session and is later timed out of the profile cache. This method is more efficient than using the mapped method, but the mapped method allows the history string to persist across sessions. The unmapped option does not allow you to load balance Domain Name Server (DNS) network requests by sending the incoming requests to the next server in a list (round-robin load balancing).

See Also

Other Resources

CSFLoadHistory

Pipeline Component Reference