Product Concept Web Service

This service allows to manage Product Concepts and Product Proposals. The Product Concept is a representation of the Product BOM in the early concept phase and therefore reflects the to-be structure of a product. The Product Proposal captures the business case justification of a proposed product and is tightly linked to a Product Concept.

Life Cycle Status: Active

QName: {http://xmlns.oracle.com/apps/scm/productConceptDesign/concepts/conceptService/}ProductConceptService

Service WSDL URL: https://servername/fscmService/ProductConceptService?WSDL

Logical Business Objects

  • SCM : Product Concept Design : Product Proposal

Relationships

The following table describes how this service data object is related to other service data objects or business object services.

Relationship Type Object or Service

Handles

Concept Structure Object

Handles

Resource Object

Handles

Business Detail Translation

Handles

Product Proposal Object

Handles

Business Detail Object

Handles

Cost Object

Handles

Concept Object

Handles

Concept Translation

Handles

Concept Component Translation

Handles

Revenue Object

Handles

Concept Component Object

Operations

deleteCost

Use this method to delete the cost row.

Life Cycle Status: Active

Request Payload

Element Name Type Description

costId

long

Primary key of cost object.

Response Payload

Element Name Type Description

result

void

deleteRevenue

Use this method to delete the revenue row.

Life Cycle Status: Active

Request Payload

Element Name Type Description

revenueId

long

Primary key of revenue object.

Response Payload

Element Name Type Description

result

void

deleteResource

Use this method to delete the resource row.

Life Cycle Status: Active

Request Payload

Element Name Type Description

resourceId

long

Primary key of resource object.

Response Payload

Element Name Type Description

result

void

deleteConcept

Use this method to delete the concept row.

Life Cycle Status: Active

Request Payload

Element Name Type Description

masterId

long

Master Id of all Concept versions

Response Payload

Element Name Type Description

result

void

addComponent

Use this method to add a Concept Component to an existing structure line item in a Concept

Life Cycle Status: Active

Request Payload

Element Name Type Description

parentLineItemId

long

Concept Structure Id of the line item to which the user wants to add a component

name

string

Component name

Response Payload

Element Name Type Description

result

{http://xmlns.oracle.com/adf/svc/types/}LongResult

Return the id of the new concept component structure line item.

saveAsNewVersion

Use this method to copy the given version of a concept as a new version.

Life Cycle Status: Active

Request Payload

Element Name Type Description

conceptId

long

Primary key of the concept object

notes

string

Version notes describing the new version

Response Payload

Element Name Type Description

result

{http://xmlns.oracle.com/adf/svc/types/}LongResult

Return the id of the new concept version row.

deleteLineItem

Use this method to delete a Concept Structure Line Item

Life Cycle Status: Active

Request Payload

Element Name Type Description

conceptStructureId

long

Primary key of the Concept Structure Object

Response Payload

Element Name Type Description

result

void

saveAsNewConcept

Use this method to save an existing concept version as a new concept object.

Life Cycle Status: Active

Request Payload

Element Name Type Description

conceptId

long

Primary key of a concept object

proposalVersion

int

Version number of the proposal object

name

string

name of the new concept object

description

string

description of the new concept object

type

string

type of the new concept object

Response Payload

Element Name Type Description

result

{http://xmlns.oracle.com/adf/svc/types/}LongResult

Return the id of the new concept row.

createProductProposal

Use this method to create a Product Proposal.

Life Cycle Status: Active

Request Payload

Element Name Type Description

name

string

Name of Product Proposal.

currencyCode

string

Currency Code of Product Proposal.

description

string

Description of Product Proposal.

productProposal

Product Proposal Object

Product proposal object to create.

Response Payload

Element Name Type Description

result

Product Proposal Object

Return the new product proposal row.

getProductProposal

Use this method to get the latest version of the Product Proposal object.

Life Cycle Status: Active

Request Payload

Element Name Type Description

productProposalId

long

Primary key of product proposal object.

Response Payload

Element Name Type Description

result

Product Proposal Object

Return the product proposal.

addSubConcept

Use this method to add a so-called Subconcept, a reference to another concept, to an existing structure line item in a Concept.

Life Cycle Status: Active

Request Payload

Element Name Type Description

parentLineItemId

long

Concept Structure Id of the line item to which the user wants to add a sub concept.

conceptId

long

Primary key of the concept object which should be added to concept structure as a sub concept

Response Payload

Element Name Type Description

result

long

Return the id of the new concept component structure line item.

updateProductProposalStatus

Use this method to update the status of a product proposal.

Life Cycle Status: Active

Request Payload

Element Name Type Description

productProposalId

long

Primary key of the product proposal object.

productProposalStatus

string

Value to which the product proposal status should be changed.

Response Payload

Element Name Type Description

result

void

Warning/Error message if any from method.

saveAsNewProductProposalVersion

Use this method to copy the given version of a product proposal as a new version.

Life Cycle Status: Active

Request Payload

Element Name Type Description

productProposalId

long

Primary key of the product proposal object to be versioned.

versionNotes

string

Version notes describing the new version.

Response Payload

Element Name Type Description

result

Product Proposal Object

Return the new version of product proposal object.

getTeam

Use this method to return a list of team members who are associated with the concept and proposal.

Life Cycle Status: Active

Request Payload

Element Name Type Description

masterId

long

The parameter that contains the master ID of the concept.

Response Payload

Element Name Type Description

result

string

Returns a list of team members that are associated with the concept object.

addTeamMembers

Use this method to add team members to the concept and proposal.

Life Cycle Status: Active

Request Payload

Element Name Type Description

masterId

long

The parameter that contains the master ID of the concept.

userNames

string

The parameter that contains the list of user names to be added to the concept and proposal. The user name is the user login name.

Response Payload

Element Name Type Description

result

void

deleteTeamMembers

Use this method to delete team members from the concept and proposal.

Life Cycle Status: Active

Request Payload

Element Name Type Description

masterId

long

The parameter that contains the master ID of the concept.

userNames

string

The parameter that contains the list of user names to be deleted from the concept and proposal. The user name is the user login name.

Response Payload

Element Name Type Description

result

void

mergeProductProposal

Use this method to for the merge operation on Product Proposal.

Life Cycle Status: Active

Request Payload

Element Name Type Description

productProposal

Product Proposal Object

Product Proposal object to merge.

Response Payload

Element Name Type Description

result

{http://xmlns.oracle.com/apps/scm/productConceptDesign/concepts/conceptService/}ProductProposalResult

Return the product proposal.

findAllVersionsOfProductProposalByName

Use this method to search all versions of Product Proposal object by name.

Life Cycle Status: Active

Request Payload

Element Name Type Description

findCriteria

{http://xmlns.oracle.com/adf/svc/types/}FindCriteria

Criteria used to limit the search results.

Name

string

Product proposal name by which the search operation will be performed.

findControl

{http://xmlns.oracle.com/adf/svc/types/}FindControl

Not used.

Response Payload

Element Name Type Description

result

Product Proposal Object

Return the result of the product proposal search operation.

findProductProposalByName

Use this method to search Product Proposal object by name.

Life Cycle Status: Active

Request Payload

Element Name Type Description

findCriteria

{http://xmlns.oracle.com/adf/svc/types/}FindCriteria

Criteria used to limit the search results.

Name

string

Product proposal name by which the search operation will be performed.

findControl

{http://xmlns.oracle.com/adf/svc/types/}FindControl

Not used.

Response Payload

Element Name Type Description

result

Product Proposal Object

Return the result product proposal of the search operation.

getConcept

Use this method to get theConcept object including its structure

Life Cycle Status: Active

Request Payload

Element Name Type Description

conceptId

long

Primary key of concept object.

Response Payload

Element Name Type Description

result

{http://xmlns.oracle.com/apps/scm/productConceptDesign/concepts/conceptService/}ConceptResult

Return the concept row.

createConcept

Use this method to create a Concept.

Life Cycle Status: Active

Request Payload

Element Name Type Description

concept

Concept Object

Concept object to create

Response Payload

Element Name Type Description

result

{http://xmlns.oracle.com/apps/scm/productConceptDesign/concepts/conceptService/}ConceptResult

Return the new concept row.

mergeConcept

Use this method to for the merge operation on Concept.

Life Cycle Status: Active

Request Payload

Element Name Type Description

concept

Concept Object

Concept object to merge

Response Payload

Element Name Type Description

result

{http://xmlns.oracle.com/apps/scm/productConceptDesign/concepts/conceptService/}ConceptResult

Return the concept.

findAllVersionsOfConceptsByName

Use this method to search all versions of Concept object by name.

Life Cycle Status: Active

Request Payload

Element Name Type Description

findCriteria

{http://xmlns.oracle.com/adf/svc/types/}FindCriteria

Criteria used to limit the search results.

bvName

string

Concept name by which the search operation will be performed.

findControl

{http://xmlns.oracle.com/adf/svc/types/}FindControl

Not used

Response Payload

Element Name Type Description

result

Concept Object

Return the result concept of the search operation.

findConceptByName

Use this method to search Concept object by name.

Life Cycle Status: Active

Request Payload

Element Name Type Description

findCriteria

{http://xmlns.oracle.com/adf/svc/types/}FindCriteria

Criteria used to limit the search results.

bvName

string

Concept name by which the search operation will be performed.

findControl

{http://xmlns.oracle.com/adf/svc/types/}FindControl

Not used

Response Payload

Element Name Type Description

result

Concept Object

Return the result concept of the search operation.

getLineItem

Use this method to get theConcept structure object including its structure

Life Cycle Status: Active

Request Payload

Element Name Type Description

conceptStructureId

long

Primary key of a concept structure object

Response Payload

Element Name Type Description

result

Concept Structure Object

Return the concept structure line item.

updateLineItem

Use this method to update a concept structure line item

Life Cycle Status: Active

Request Payload

Element Name Type Description

conceptStructure

Concept Structure Object

Primary key of a concept structure object

Response Payload

Element Name Type Description

result

Concept Structure Object

Return the concept structure line item.

getComponent

Use this method to get a Concept Component

Life Cycle Status: Active

Request Payload

Element Name Type Description

componentId

long

Primary key of a concept component

Response Payload

Element Name Type Description

result

Concept Component Object

Return the concept component

updateComponent

Use this method to update a Concept Component

Life Cycle Status: Active

Request Payload

Element Name Type Description

component

Concept Component Object

Concept component to update

Response Payload

Element Name Type Description

result

Concept Component Object

Return the concept component

Security

The following tables list the privileges required to perform the service operations, and the duty roles that each privilege is granted to.

Service Operations to Privileges Mapping

Operation Name Privilege Code Privilege Name Privilege Description

All Operations

ACD_MANAGE_PRODUCT_PROPOSAL_PRIV

Manage Product Proposal

Allows for managing of a Product Proposal

Privileges to Duty Roles Mapping

Privilege Code Granted to Duty Role Code Granted to Duty Role Name Granted To Duty Role Description

ACD_MANAGE_PRODUCT_PROPOSAL_PRIV

ORA_ACE_PORTFOLIO_MANAGEMENT_DUTY

Portfolio Management

This duty allows for managing of a product portfolio.

ACD_MANAGE_PRODUCT_PROPOSAL_PRIV

ORA_ACD_PRODUCT_PROPOSAL_MANAGEMENT_DUTY

Product Proposal Management

This duty allows for managing of a product proposal. A person with this duty can perform all activities on a product proposal.

Duty Roles to Duty or Job Roles Mapping

Duty Role Code Granted to Duty or Job Role Code Granted to Duty or Job Role Name Granted To Duty or Job Role Description

ORA_ACD_PRODUCT_PROPOSAL_MANAGEMENT_DUTY

ORA_ACD_CONCEPT_DEVELOPMENT_DUTY

Concept Development

A person with this duty can perform concept development related duties such as managing of components within the concept. This duty does not allow for creating or deleting of a concept which is controlled by the Concept Management Duty