Appending BOCollections to Collections

To append a BOCollection to an ApiCollection:

ApiCollection.addBOCollection(ApiBOCollection)

Adds all items held by the BOCollection you pass as a parameter to an ApiCollection. Note, however, that having done this you throw away the typical behaviour of BOCollections, whose current state is projected to the database automatically: the added objects become ordinary items in the ApiCollection.

As a result, no changes made to the objects copied from BOCollection to ApiCollection will be reflected to the database automatically unless you commit the appropriate transaction. On the other hand, the BOCollection behaviour will be maintained when you use a corresponding method provided by ApiBOCollection to include another BOCollection.