NetworkedPlanet | TMCore Engine API Guide |
Several of the methods of the Transaction class that identify items to be deleted from a topic map support the use of wildcard values to be passed in parameters. These methods should be thought of as selecting for deletion all those items that match the criteria specified in the parameters to the method. Where string values are matched, the SQL wildcard characters (% and _) are allowed, enabling you to select all occurrences with a string value that starts "Test" by passing "Test%" as the string match value for example. Where topics are matched, a value of -1 can be passed to match any topic.
The main exceptions to this rule are where the methods have a parameter that specifies the parent topic or association to be affected - in this case a non-negative object OID value is required; and also where the methods take an array of integers to define a scope - to match any scope (including the unconstrained scope), pass null as the value of the scope matching parameter, otherwise the scope you specify must exactly match the scope of the item to be deleted.