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

ASSET.ADDMEMBERS

This tag adds child assets to an asset that can contain child assets.

Syntax

<ASSET.ADDMEMBERS
      NAME="assetName" 
      LIST="list of members"
      FIELD="meta attribute name"/>

Parameters

NAME (required)

Input. Name assigned the previously created or loaded asset.

LIST (required)

Input. The list of member assets to add as children to the loaded asset. The list must contain the columns: membertype, memberid, and ordinal. The ordinal number is temporary and merely represents the order within the passed-in list. It is the tag's responsibility to create reasonable ordinal values for the members.

FIELD (required)

Input. The asset's attribute name in which to store the member assets. Legal values in include Association-unnamed, Association-named or the name of any attribute which accepts multiple assets.

Description

This tag adds members to an asset which can accept asset children.

errno

The possible values of errno include:

Value	Description
-10004	A required parameter is missing.
-10005	The requested object is not in the object pool (is not loaded into memory).
-12007	The list did not have correct columns.
-12070	Asset was not fully loaded. Tag requires ASSET.LOAD with editable flag to fully load asset.

Example

Add 3 Articles to a Collection as unnamed associations.

<ASSET.LOAD NAME="aCollection" TYPE="Collection" OBJECTID="Variables.id"/>
<ASSET.LIST TYPE="Article" PUBID="SessionVariables.pubid" LIST="articles"/>
<SETCOUNTER NAME="ordinal" VALUE="1"/>
<LISTOBJECT.CREATE NAME="lo" COLUMNS="membertype,memberid,ordinal"/>
<LOOP COUNT="3">
	
	<GOTOROW LIST="collections" ROWNUM="Counters.ordinal"/>
	<LISTOBJECT.ADDROW NAME="lo" membertype="Article" memberid="articles.id" ordinal="Counters.ordinal"/>
	<INCCOUNTER NAME="ordinal" VALUE="1"/>
	
</LOOP>
<LISTOBJECT.TOLIST NAME="lo" LISTVARNAME="add2list" />

<ASSET.ADDMEMBERS NAME="aCollection" FIELD="Association-unnamed" LIST="add2list"/>
<ASSET.SAVE NAME="newasset"/>

See Also

ASSET.LOAD
ASSET.ADDCHILD
ASSET.CHANGEREF
ASSET.CANTAKEACTION
ASSET.CHILDREN
ASSET.CHILDTYPES
ASSET.REMOVEMEMBERS
ASSET.REORDER
ASSET.SAVE

		Home >	Contents >	Index >
	FatWire XML Tag Reference Copyright 2005 by FatWire Software All rights reserved.