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

Contact Template

bulkRemove() - Available since version 1.3.4

Deletes contacts that match the search criteria

See Also

rb.contact.getrb.contact.count

Syntax

number = rb.contact.bulkRemove(keywords, flags)

Parameters

The 'bulkRemove' method takes 2 parameters:

Name Type/Value Range/Length Description
keywordsarray of stringsarray of 0-10 keyword strings, of < 128 characters each Required. A list of up to 10 keywords to be searched for. Keywords are additive (that is to say that searches will match any entry which contains any of the keywords
flagsstruct searchFlagssee definition Required. Flags, see definition of searchflags

Results

The 'bulkRemove' method returns number:

Type/Value Range/Length Description
number -1, 0, or a positive integercount of contact records deleted from the database, or -1 to indicate that the search failed (invalid search parameters)

Remarks

Calling parameters are exactly the same as the get and count methods.
Use this call to physically remove all contact records from the database that match the search criteria specified.

Note: only INDIVIDUALS can be deleted using this method. An attempt to remove communities or OUs will cause an exception to be returned to the application.

The keywords array holds a list of all keywords to be searched for. Wildcards of % (representing any length of unspecified characters) and _ (representing a single unspecified character) can be used in the search. Only alphabetical characters and numbers may be used in a search.

Whitebeam release 1.3.36
(loadtime : 194ms)