removePortfolioContent

Purpose

This operation removes one or more proposals/projects and assets to a parent portfolio.

Function

You can use this operation to remove a set of content (proposals, projects, or assets) to a parent portfolio.

Related Information

The following related operation

• addPortfolioContent

Input

The following fields are required:

• The ID of the parent portfolio

• An array of request IDs of proposals/projects and assets

Return

This operation does not return any data.

Java Interface

RemovePortfolioContentResponseDocument
RemovePortfolioContent(RemovePortfolioContentDocument in)

Parameters	Description
RemovePortfolioContentDocument	Wrapper for the input of this operation. The input includes the following fields: Long portfolioId - parent portfolio ID Long[] requestIds - request IDs of the content to be removed

Java Examples

public void testRemovePortfolioContent(long portfolioId, long[]
ids) throws Exception {
       System.out.println("testRemovePortfolioContent started
...");
       PortfolioServiceStub PFM = new PortfolioServiceStub(ctx,
WSURL);
       RemovePortfolioContentDocument removeContentDoc =
RemovePortfolioContentDocument.Factory.newInstance();
       RemovePortfolioContent content =
removeContentDoc.addNewRemovePortfolioContent();
       content.setPortfolioId(portfolioId);
       content.setReqIdsArray(ids);
       PFM.removePortfolioContent(removeContentDoc);
       System.out.println("testRemovePortfolioContent
completed");
    }

Errors and Exceptions

When an error occurs on this operation, you will see a description of the root cause in the server log or in the response message:

The server log content is similar to the following:

Exception in thread "main" org.apache.axis2.AxisFault:
<exception:exceptionDetails xmlns:exception="http://
www.mercury.com/ppm/ws/exception">
<exception:detail>[root cause description] </exception:detail>
</exception:exceptionDetails>

Possible root cause descriptions:

Message Code	Message	Cause(s)	Possible Corrective Action
exception.authorization	You do not have the privilege to take this action. Please consult your PPM Administrator.	You are not authorized to create a portfolio.	Check the user licenses and privileges (access grants)
com.mercury.itg.exceptions.ObjectNotFoundException	Cannot load the {0} with the specified id: {1}. {0} may be deleted by another user.	A portfolio with the specified name or ID cannot be found.	Check the portfolio name or ID.