com.adobe.icc.services.api
Interface DocumentService

public interface DocumentService

Service interface for PortfolioDocument specific operations.

Method Summary

PortfolioDocument	activateDocument(String documentID, boolean updateDependencies) Deprecated.
PortfolioDocument	createDocument(PortfolioDocument Document) Create a new PortfolioDocument object.
PortfolioDocument	createTestDocument(String documentID) Deprecated.
void	deleteDocument(String documentID) Deprecated.
Boolean	documentExists(String documentName) Check if a Document exists by the given name.
List	getAllDocuments(Query query) List all PortfolioDocuments filtered by the given Query.
List	getDependentPortfolios(String documentID) The method returns a List of Portfolios that depend on the Document identified by the given documentID.
PortfolioDocument	getDocument(String documentID) Fetch the PortfolioDocument identified by the given documentID.
boolean	isReferenced(String documentID) Check if this Document is being referenced by any other asset (Portfolio/Document).
PortfolioDocument	markReadyToPublish(String documentID) Mark as ready to publish the PortfolioDocument identified by the given documentID.
PortfolioDocument	publishDocument(String documentID) Publish the PortfolioDocument identified by the given documentID.
PortfolioDocument	retrieveVersion(String documentId, Date publishDate) Returns the version of document that was published on or before the specified date.
PortfolioDocument	revertToLastPublished(String documentId) Reverts the document to the last published version.
boolean	updateDependencies(String oldDocumentID, String newDocumentID) Update the references of the old Document, in any dependent assets, with the new Document.
PortfolioDocument	updateDocument(PortfolioDocument Document) Update the given PortfolioDocument object.

Method Detail

createDocument

PortfolioDocument createDocument(PortfolioDocument Document)
                                 throws ICCException

Create a new PortfolioDocument object.

Parameters:

Document - The PortfolioDocument object to be created

Returns:

The created PortfolioDocument object

Throws:

ICCException

createTestDocument

PortfolioDocument createTestDocument(String documentID)
                                     throws ICCException

Deprecated.

Create a Test/Inactive version of a PortfolioDocument object, given the ID.

Parameters:

documentID - ID of the Document whose Inactive version is to be created.

Returns:

Created Inactive version of a PortfolioDocument object

Throws:

ICCException

deleteDocument

void deleteDocument(String documentID)
                    throws ICCException

Deprecated.

Delete the PortfolioDocument identified by the given documentID.

Parameters:

documentID - ID of the Document to be deleted.

Throws:

ICCException

markReadyToPublish

PortfolioDocument markReadyToPublish(String documentID)
                                     throws ICCException

Mark as ready to publish the PortfolioDocument identified by the given documentID.

Parameters:

documentID - ID of the PortfolioDocument.

Returns:

PortfolioDocument object marked for publishing

Throws:

ICCException

Since:

10.0.0.0

activateDocument

PortfolioDocument activateDocument(String documentID,
                                   boolean updateDependencies)
                                   throws ICCException

Deprecated.

Activate the PortfolioDocument identified by the given documentID.

Parameters:

documentID - Name of the Document to be activated

updateDependencies - Whether to set this new activated version in the dependent Assets.

Returns:

The activated PortfolioDocument object.

Throws:

ICCException

publishDocument

PortfolioDocument publishDocument(String documentID)
                                  throws ICCException

Publish the PortfolioDocument identified by the given documentID.

Parameters:

documentID - Name of the Document to be published

Returns:

The activated PortfolioDocument object.

Throws:

ICCException

Since:

10.0.0.0

updateDocument

PortfolioDocument updateDocument(PortfolioDocument Document)
                                 throws ICCException

Update the given PortfolioDocument object.

Parameters:

Document - The PortfolioDocument object to update

Returns:

The updated PortfolioDocument object

Throws:

ICCException

getAllDocuments

List getAllDocuments(Query query)
                     throws ICCException

List all PortfolioDocuments filtered by the given Query.

Parameters:

query - Query to select documents (supports only first level attributes/properties of an object).
The "attributeName" used in the Statement object should be the name of the property in the object (Document object, in this case).

Returns:

List of PortfolioDocument objects.

Throws:

ICCException

See Also:

Statement} and {@link Query}.

getDocument

PortfolioDocument getDocument(String documentID)
                              throws ICCException

Fetch the PortfolioDocument identified by the given documentID.

Parameters:

documentID - Id of the Document to be fetched.

Returns:

The PortfolioDocument identified by the given documentID.

Throws:

ICCException

documentExists

Boolean documentExists(String documentName)
                       throws ICCException

Check if a Document exists by the given name.

Parameters:

documentName - Name of the Document.

Returns:

True if a Document exists by the given name, False otherwise.

Throws:

ICCException

getDependentPortfolios

List getDependentPortfolios(String documentID)
                            throws ICCException

The method returns a List of Portfolios that depend on the Document identified by the given documentID.

Parameters:

documentID - ID of the Document whose dependencies are to be fetched.

Returns:

The dependencies of the given Document.

Throws:

ICCException

isReferenced

boolean isReferenced(String documentID)
                     throws ICCException

Check if this Document is being referenced by any other asset (Portfolio/Document).

Parameters:

documentID - ID of the Document whose dependencies are to be fetched.

Returns:

True, if the Document is being referenced, False otherwise.

Throws:

ICCException

updateDependencies

boolean updateDependencies(String oldDocumentID,
                           String newDocumentID)
                           throws ICCException

Update the references of the old Document, in any dependent assets, with the new Document.

Parameters:

oldDocumentID - ID of the old Document

newDocumentID - ID of the new Document, which should be set as the new reference

Returns:

true if the operation succeeds, false otherwise

Throws:

ICCException

revertToLastPublished

PortfolioDocument revertToLastPublished(String documentId)
                                        throws ICCException

Reverts the document to the last published version. If document is not published, it is removed from repository.

Parameters:

documentId - The Document ID.

Returns:

Reverted document.

Throws:

ICCException

Since:

10.0.0.0

retrieveVersion

PortfolioDocument retrieveVersion(String documentId,
                                  Date publishDate)

Returns the version of document that was published on or before the specified date.

Parameters:

documentId - The Document ID.

publishDate - specifies the date for fetching published document.

Returns:

version which was published on or before the specified date.

Throws:

ICCException

Since:

10.0.0.0