LassoScript Utility
Basics Browse Detail

[Cache_Store]

Tag Link [Cache_Store] Category Utility
Type Substitution Source Available Yes
Support Preferred Version 7.0
Change Unchanged Data Source Any
Output Type None Security Tag
Implementation LCAPI Sets Lasso 8.5, Lasso 8.0, Lasso 7.0

Description

Caches the value of a named variable. Requires a -Content parameter that specifies the name of an object variable to be cached. Does not return a value to the page.

Syntax

[Cache_Store: -Name='Cache_Name', -Content=$Variable]

Parameters

Required Parameters
-Content Specifies the the LDML variable to be cached.
-Name Specifies the name of the cache. The name of the cache identifies the cached contents so it can be referenced on several pages. This is the only required parameter.
Optional Parameters
-Expires Specifies how many seconds the cached contents should last. If the cached contents is older than the time interval specified, then new content values will be cached on the next page load.
-Session Specifies the name of a session that the cached content should be stored in. This allows the cached content to be user specific. If no -Session parameter is specified, then the content will be stored in a global variable instead.
-UseGlobal Can be used in concert with -Session to store cached data in both a global variable and a session. All caches are stored in a global variable by default if neither -Session or -UseGlobal is specified.

Examples

To cache an LDML object without returning its value to the page:

Use the [Cache_Store] tag. The example below adds a variable named Data to the cache. Whenever the Data variable is called while the cache is not expired, any instance of the Data variable will be replaced with its cached value.

[Var:'Data'='This is some data']
[Cache_Object: -Name='Cache_Name', -Expires=3600, -Content=$Data]