Queries the database for the specified asset, and then loads an instance of the asset into memory as an object.
It is inadvisable to use this tag for loading a flex asset. To display data from flex assets, use Assetset Tags .
siteName"] [DEPTYPE="exact|exists|greater|none"] [EDITABLE="true|false] [OPTION="editable|readonly|readonly_complete"] [FLUSHONVOID="true|false]/>
- Input. The name to use to identify the asset after it is retrieved and stored as an object in memory. All references to the asset by other
ASSET.GET, for example) during this session use this name to identify the asset.
- Input. The asset type of the asset that you want to retrieve from the database. Typically, you provide
OBJECTID. In special cases, when you know that a specific
FIELD/VALUEpair can uniquely identify the asset, you can provide
- Input. The object ID of the asset. It is required unless you use
FIELD/VALUEpair (defined below). Errno is set to -10006 only if objectid does not have a numeric value. There is no verification on whether the object exists or not. Note, if
OBJECTIDis used, the
SITEparameter value will be ignored.
- Input. Used in a pair of values with
VALUEto identify the asset by supplying a field name whose corresponding value uniquely identifies the asset. Note that if the
FIELD/VALUE/SITEcombination that you supply identifies more than one asset, Sites sets errno to -10009.
- Input. Used in a pair of values with
FIELDto identify the asset by supplying a value for a field that uniquely identifies the asset.
- Input. Specifies site name. Used when using
VALUEto identify a unique asset. Note, if the
SITEis supplied, and an attribute for the selected
TYPEis larger the value defined in cc.bigtext (futuretense.ini), the attribute value returned will be the path and file name where the content is stored.
- When the using the ASSET.LOAD tag in a template, and the assets using this template have been approved for export, this attribute specifies whether approval dependency is
Legal values are:
exact(default)-Specifies a version dependency. The version of the dependent asset must be equal to the version of the asset when it was approved.
exists -Specifies that any version of the asset satisfies the dependency condition.
greater -Specifies the asset must be at a or above a certain version.
none -Specifies there is no approval dependency on the asset.
- Input. Set to true if the asset is being loaded with intent to edit. By default this is false. When set to true, all the asset data is loaded into memory as a unit. Otherwise, some data, such as blob data and asset associations may be loaded as needed. Note, setting this parameter to
trueis equivalent to setting option to
- Input. For peformance reasons, not all of the data for an asset is necessarily loaded on asset.load. Setting this value controls how much of the ancilliary data of the asset id loaded.
Legal values are:
readonly(default) -- The asset is loaded for read only. Attempt to save the asset data will result in error. Asset associations and site information is not loaded. This option should be used on the live site for best performance.
editable-- All asset data is loaded and available for editing. Note, this option is equivalent to using the
readonly_complete-- All asset data is loaded but not avalailable for editing. Attempt to save the asset data will result in error.
- Input. Set to true if the asset is being loaded in a template whose primary purpose is to display the asset. By default, this set to false. When set to true, the page cache for this page will be flushed if the asset fails to load or the asset has been deleted (i.e., it's status field is marked 'VO', for void). This prevents the page cache on the mirror destination from containing pagelets of deleted assets.
This tag executes a database query to retrieve an instance of the specified asset and then puts the instance into memory (session information), assigning it the name provided by the
NAMEparameter. That object is then available until the session is flushed (the root element exits) or the name is overwritten. Object names are global in scope.
You can identify the asset that you want to load with its asset type and object ID, or the asset type combined with a
FIELD/VALUE/SITEcombination that uniquely identifies the asset.
Typically, each template element starts with an
ASSET.LOADtag so that subsequent code can extract and display the loaded data on pages for your online site.
The possible values of
Value Description -101 No rows returned. -10001 The implementing class is invalid. -10002 There is a missing method for the implementing class. -10003 The method could not be invoked successfully. -10004 A required parameter is missing. -10005 The requested object is not in the object pool (is not loaded into memory). -10006 The object ID is not of numeric value. -10009 More than one object met the specified criteria.
This code loads an article asset, identifying it by type and object ID. It then displays the name and description of the article:<ASSET.LOAD NAME="MainArticle" TYPE="Article" OBJECTID="Variables.cid" FLUSHONVOID="true"/> <ASSET.SCATTER NAME="MainArticle" PREFIX="main" /> <ICS.GETVAR NAME="main:name"/>,<ICS.GETVAR NAME="main:description"/>
This code loads a page asset, identifying it by type and a
FIELD/VALUE/SITEcombination. It then displays the name and description of the page:<ASSET.LOAD NAME="NewsSectionFront" TYPE="Page" FIELD="name" VALUE="News" SITE="Variables.site"/> <ASSET.GET NAME="NewsSectionFront" FIELD="name" /> <ASSET.GET NAME="NewsSectionFront" FIELD="description" /> <ICS.GETVAR NAME="name"/>,<ICS.GETVAR NAME="description"/>
Home > Contents > Index >
Oracle XML Tag Reference
Copyright (c) 2013, 2019, Oracle and/or its affiliates. All rights reserved.