Interface IdBatchAdminSession

All Superinterfaces:
AutoCloseable, Closeable, IdAdminSession, OsidSession, OsidSession
public interface IdBatchAdminSession extends IdAdminSession

This session creates Ids in bulk. The data for create is provided by the consumer via the form object. OsidForms are requested for each create or update and may not be reused.

Create operations differ in their usage. To create an Id , an IdForm is requested using getIdFormsForCreate() specifying the desired reference, resource, and record Types or none if no record Types are needed. Each of the returned IdForms will indicate that it is to be used with a create operation and can be used to examine metdata or validate data prior to creation. Once an IdForm is submiited to a create operation, it cannot be reused with another create operation unless the first operation was unsuccessful. Each IdForm corresponds to an attempted transaction.

The IdForms returned from getIdFormsForCreate() may be linked to the originating request through the peer Ids of the IdForm .

Once a batch of IdForms are submitted for create, a CreateResponse is returned for each IdForm , although the ordering is not defined. Only errors that pertain to the entire create operation are returned from createIds() , errors specific to an individual IdForm are indicated in the corresponding CreateResponse . CreateResponses may be linked to the originating IdForm through the IdForm Id .