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

 

asset:loadall

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

Syntax

Parameters

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 comma or 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 PrefixTotal holds the number of assets loaded. The first asset loaded will be named Prefix0.

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.

Description

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.

Example

This example loads active collections and names them coll1, coll2, coll3, etc.

This example loads Image assets with the specified ids.

Error Numbers

The possible values of errno include:

Value
Description
-1000
Revision tracking error.
-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.

See Also

asset:load
asset:list

   Home > Contents > Index >

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