Home > Contents > Index >
Template Tag TOC  |   Alpha TOC  |   Tag Family TOC  |   Purpose TOC  |   Annotated TOC  |   Index 



Loads all assets specified in the input list and creates objects with names made up of the prefix name plus a counter.



TYPE (required)
Type of the asset to load.

LIST (optional)
You must use either the LIST or IDS parameter. Name of an object containing the object IDs of assets to load.

IDS (optional)
You must use either the LIST or IDS parameter. A variable containing a semicolon-separated list of asset IDs to load.

IDFIELD (optional)
Name of the field in the list object which specifies the object ID of the asset. The default value is ID.

PREFIX (required)
Base name of the loaded asset. The object name consists of this value plus a counter incremented by 1 for each asset loaded. A variable named Prefix+Total holds the number of assets loaded.

DEPTYPE (optional)
When the ASSET.LOADALL tag is used in a template and assets using this template are approved for export, this parameter specifies whether approval dependency is exact, exists, or none. The default value is exact.

Legal values are:

EDITABLE (optional)
Input. Set to true if the assets are 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.
OPTION (optional)
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 editable="true" parameter.
    • readonly_complete -- All asset data is loaded but not avalailable for editing. Attempt to save the asset data will result in error.


Loads into memory all assets specified, assigning the object a name, composed of the prefix plus a counter.

If a list is passed as input and the asset type is a basic asset type and the list contains at least as many columns as the primary storage table for the asset type, the asset is loaded from the list without further querying of the database. If the asset type is not a basic asset or the list passed has fewer columns than the number of columns in the asset type's primary storage table, then the id is extracted and used to load the asset data into memory.

If a string is passed with a list of ids, those are used to load the asset data. Note that the order of ids in the list is not retained - the loaded asset objects may be in any order.

A variable, with a name consisting of the [prefix]Total indicates how many assets were loaded.


This example loads all images in the database and applies the names img1, img2, img3, etc. Because the input list contains all the fields of the asset type's primary storage table, the asset is loaded from the list data without further queries to the database.

This example loads all the images for a particular publication from the AssetPublication table. This makes at least one query to get the assets to load.

This example loads assets by passing a semicolon separated list of IDs. This is useful as the Post element of a form where the user checked the IDs of assets that the user wanted to use.

Error Numbers

The possible values of errno include:

Revision tracking error.
The implementing class is invalid.
There is a missing method for the implementing class.
The method could not be invoked successfully.
A required parameter is missing.

See Also


  Home > Contents > Index >

Oracle XML Tag Reference
Copyright (c) 2013, 2019, Oracle and/or its affiliates. All rights reserved.