Whitebeam Template Reference Documentation

Site Map
 
Home
 
Application Guide
Reference
  Installation
  Configuration
  XML Markup
  JavaScript Classes
  ROM
  Templates
  Environment
  Dev Process
  Tools
  External Links
  Example libraries
Community
Contact Whitebeam
To-Do
Download
Credits
Licence
Whitebeam Users
 
 
 

Whitebeam Template Reference Documentation

System Template

removeByItem() - Available since version 1.3.9

Removes all files referenced by a specific catalogue item ID

See Also

rb.file.remove()    rb.file.get()    rb.file.create()    rb.file.modify()   

Syntax

number = rb.file.removeByItem(itemID)

Parameters

The 'removeByItem' method takes 1 parameter:

Name Type/Value Range/Length Description
itemIDnumberValid catalogue item ID Required. Delete all items associated with the specified item ID.

Results

The 'removeByItem' method returns number:

Type/Value Range/Length Description
number count Number of files removed

Remarks

This method takes a catalogue itemID and deletes all files associated with that item (that is all files in the 'fileRefs' array).

As well as deleting the file objects the method also removes the corresponding entry in the fileRef array - on successful completion of this method the 'fileRefs' array in the item will be empty.

This method is most useful as part of a process for deleting an item.

Note: if a file object is shared with other items references in those items (fileRefs) will not be modified.

removeByItem was introduced with version 1.3.9
Whitebeam release 1.3.36
(loadtime : 59ms)