Update Documents in a Repository
The following table lists fetch actions that update documents in a repository.
Action | Description | Method to override |
---|---|---|
/action=fetch&fetchaction=Delete
|
Delete specified documents from the repository. | Remove
|
/action=fetch&fetchaction=Insert
|
Insert a document or documents into a repository. | Insert
|
/action=fetch&fetchaction=Update
|
Update the metadata for specified documents in the repository. | Update
|
/action=fetch&fetchaction=Hold
|
Apply a legal hold to the specified documents in the repository. | Hold
|
/action=fetch&fetchaction=ReleaseHold
|
Remove a legal hold from the specified documents in the repository. |
Like the Collect
fetch action (see Retrieve Documents from a Repository), these actions are passed a collection of DocInfo
objects, each of which contains an identifier. Like the Collect
fetch action, s
uccess
or f
ailed
must be called on each object to indicate whether the document was processed successfully.
The DocInfo
objects passed to Delete
, Hold
, ReleaseHold
and Update
DocInfo
objects passed to Update
also contain the metadata to set in the repository.
The DocInfo
objects passed to Insert
contain document content and metadata, including information about where in the repository the new file should be inserted. This information could be part of the reference, identifier, or metadata. It is up to you to specify what information is required.
If you want to use the Insert
action to insert documents that contain only metadata, you must features
method on ConnectorBase
to enable insertion of metadata-only documents
public int features() { int features = super.features(); features |= Features.InsertAllowMetadataOnly; return features; }