com.filenet.rm.bds
Interface BaseBulkService
- public interface BaseBulkService
Method Summary
Modifier and Type | Method and Description |
---|---|
|
cancelBatch()
Cancels any current batch for this
BulkDeclarationService instance
so that a subsequent startBatch(String) call can be made.
|
executeBatch()
Executes all operations that have been placed in the current batch since the previous
startBatch(String) call.
|
|
getBatchResultItems()
Returns the array of BatchResultItems from the current active batch.
|
|
getConfigurationInfo()
Returns the current
Configuration collection belonging to
this BulkDeclarationService instance.
|
|
|
getContextInfo()
Returns the current connection context
Map in use by this
BulkDeclarationService instance.
|
|
isInBatch()
Indicates whether or not a batch is currently active for this
BulkDeclarationService
instance.
|
reexecuteBatch(boolean removeFailedOperations)
Re-executes the current batch.
|
|
|
startBatch(java.lang.String batchName)
Called to designate the start of a new batching operation.
|
Method Detail
getContextInfo
- java.util.Map getContextInfo()
Map
containing the context elements. getConfigurationInfo
- Configuration getConfigurationInfo( )
Configuration
collection belonging to
this BulkDeclarationService
instance.
startBatch
- void startBatch(java.lang.String batchName)
executeBatch
or resetBatch
call is made.
batchName
- optional name for this batch. Can be null
. isInBatch
- boolean isInBatch()
BulkDeclarationService
instance.
true
if a batch is currently active. cancelBatch
- void cancelBatch()
BulkDeclarationService
instance
so that a subsequent startBatch(String)
call can be made.
Any pending operations contained in the batch are discarded.
This method is primarily intended to be used when a given batch operation
(e.g., BulkDeclarationService.declareRecord(String, RecordDefinition)
) fails
due to an immediate validation error, and it desired that all pending batch operations
should be discarded.
Can be called even if a pending batch is not active.
executeBatch
- BatchResultItem[] executeBatch( )
startBatch(String)
call. All such operations
are sent to the CE as a single bulk payload and performed as a single transaction.
BatchResultItem
instances, each of which is associated
with each of the operations contained by the batch. a
- BDSException
for any execution error. reexecuteBatch
- BatchResultItem[] reexecuteBatch( boolean removeFailedOperations)
Primarily intended for use when a previous executeBatch()
(or reexecuteBatch
) has failed due to a retryable
CE exception such as a transaction timeout or database deadlock. Can also be used to
retry a failed batch by first removing all individual operations that previously failed
due to validation errors.
When the
For example, if a non-existent record class name was provided as part of a removedFailedOperations
parameter is
true
, the ability
of the
BulkDeclarationService
to determine which operation(s) actually failed
during the previous execution attempt is dependent upon where the failure was detected. If the
failure was detected within the BDS component during its validation phase, then the
corresponding failed operation typically can be determined and will be removed during a subsequent
reexecuteBatch
call. However, if the failure was
detected during the execution phase (i.e., was detected by the CE server), then there
is typically no knowledge as to which operation caused the failure and no operation
will be removed from the batch during any subsequent
reexecuteBatch
call.
RecordDefinition
which became part of a declareRecord
operation, this error would be detected
during the BDS validation process because examination of the a potential record's record class
is required as part of the P8 RM business logic. A subsequent reexecuteBatch
call
would be able to successfully remove this failed operation. On the other hand, if a non-existent
document class name was provided as part of a DocumentDefinition
that became part of a
createDocument
or createDocumentAndDeclareRecord
operation, this error would
not be detected until the entire batch was sent to the CE server for execution. In this case,
the BDS would not know which operation was faulty and, thus, would not be able to remove
the faulty operation from the batch on a subsequent reexecuteBatch
call.
removeFailedOperations
- true
to force removal of previously
failed operations before re-executing the remaining
operations of the batch. BatchResultItem
instances, each of which is associated
with each of the operations contained by the batch. a
- BDSException
for any execution error. getBatchResultItems
- BatchResultItem[] getBatchResultItems( )
BatchResultItem
instances, each of which is associated
with each of the operations contained by the batch.
Map
in use by this BulkDeclarationService instance. This context information is used by the lower level transport layer to establish communications with the P8 Content Engine.Two forms of context sets are supported based upon the underlying transport type as determined by the context
Map
item keyBDSConstants.CONTEXT_TRANSPORT_TYPE
:BDSConstants.CONTEXT_TRANSPORT_TYPE
item contains either of valuesBDSConstants.TRANSPORT_TYPE_BDP
orBDSConstants.TRANSPORT_TYPE_BDP40_WSI
.BDSConstants.CONTEXT_TRANSPORT_TYPE
item contains the valueBDSConstants.TRANSPORT_TYPE_BDP40_JACE
.When the CE WebServices transport is used the following context
Map
items are required (example values are given in []):BDSConstants.CONTEXT_PROTOCOL
- wire protocol ["http"]BDSConstants.CONTEXT_SERVER
- name of CE server ["localhost"]BDSConstants.CONTEXT_PORT
- IP port number ["9080"]BDSConstants.CONTEXT_SERVICE
- WSI Service name ["FNCEWS35Service"]BDSConstants.CONTEXT_ENDPOINT
- WSI Endpoint name ["FNCEWS35DIME"]BDSConstants.CONTEXT_BINDING
- WSI Binding name ["FNCEWS35DimePort"]BDSConstants.CONTEXT_USERNAME
- clear text usernameBDSConstants.CONTEXT_PASSWORD
- clear test passwordWhen the CE JACE transport is used the following context
Map
items are required (example values are given in []):BDSConstants.CONTEXT_URI
- CE JACE URI ["iiop://CEserver:9080/FileNet/Engine"]BDSConstants.CONTEXT_USERNAME
- clear text usernameBDSConstants.CONTEXT_PASSWORD
- clear text password