Requirement Web Service

This represents the specifications that are needed to be supported by a product. These can be versioned and can be tied to Product Proposals and Product Concepts.

Life Cycle Status: Active

QName: {http://xmlns.oracle.com/apps/scm/customerNeedsManagement/requirements/requirementService/}RequirementService

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

Logical Business Objects

SCM : Product Requirements and Ideation Management : Requirement

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	Requirement Line Item Object
Handles	Requirement Object
Handles	Requirement Version Object
Handles	Requirement Version Translation
Handles	Requirement Translation

getLatestVersion

Use this method to get the latest requirement version object for the requirement object.

Life Cycle Status: Active

Request Payload

Element Name	Type	Description
requirementId	long	The parameter that contains the unique identifier from the application for the requirement object.

Response Payload

Element Name	Type	Description
result	Requirement Version Object	Returns the result of getting the latest version operation.

deleteLatestVersion

Use this method to delete the latest requirement version object from the requirement object.

Life Cycle Status: Active

Request Payload

Element Name	Type	Description
requirementId	long	The parameter that contains the unique identifier from the application for the requirement object.

Response Payload

Element Name	Type	Description
result	void

createNewVersion

Use this method to add a requirement version object to the requirement object.

Life Cycle Status: Active

Request Payload

Element Name	Type	Description
requirementId	long	The parameter that contains the unique identifier from the application for the requirement object.

Response Payload

Element Name	Type	Description
result	long	Return the result of the create new version operation.

deleteLineItem

Use this method to delete a requirement line item object from the requirement version object.

Life Cycle Status: Active

Request Payload

Element Name	Type	Description
lineId	long	The parameter that contains the unique identifier from the application for the requirement line item object.

Response Payload

Element Name	Type	Description
result	void

addLineItem

Use this method to add a requirement line item object to the requirement version object.

Life Cycle Status: Active

Request Payload

Element Name	Type	Description
parentLineItemId	long	The parameter that contains the unique identifier from the application for the parent requirement line item object to use for the new requirement line item object.
name	string	The parameter that contains the name of the requirement line item object to add to the requirement object.

Response Payload

Element Name	Type	Description
result	long	Return the result of the add line item operation.

getRequirement

Use this method to get a requirement object using the unique identifier from the application for the requirement object.

Life Cycle Status: Active

Request Payload

Element Name	Type	Description
requirementId	long	The parameter that contains the unique identifier from the application for the requirement object.

Response Payload

Element Name	Type	Description
result	{http://xmlns.oracle.com/apps/scm/customerNeedsManagement/requirements/requirementService/}RequirementResult	Returns the result of getting the requirement object.

createRequirement

Use this method to create a requirement object.

Life Cycle Status: Active

Request Payload

Element Name	Type	Description
requirement	Requirement Object	The parameter that contains a requirement object.

Response Payload

Element Name	Type	Description
result	{http://xmlns.oracle.com/apps/scm/customerNeedsManagement/requirements/requirementService/}RequirementResult	Returns the result of creating a requirement object.

updateRequirement

Use this method to update a requirement object using the unique identifier from the application for the requirement object.

Life Cycle Status: Active

Request Payload

Element Name	Type	Description
requirement	Requirement Object	The parameter that contains a requirement object.

Response Payload

Element Name	Type	Description
result	{http://xmlns.oracle.com/apps/scm/customerNeedsManagement/requirements/requirementService/}RequirementResult	Returns the result of updating the requirement object.

findRequirementFindRequirementByName

Use this method to search for a requirement object by name.

Life Cycle Status: Active

Request Payload

Element Name	Type	Description
findCriteria	{http://xmlns.oracle.com/adf/svc/types/}FindCriteria	The parameter that contains the search criteria to filter the search results.
bvName	string	The parameter that contains the requirement name to search for.
findControl	{http://xmlns.oracle.com/adf/svc/types/}FindControl	Not currently used.

Response Payload

Element Name	Type	Description
result	Requirement Object	Returns the result of searching for a requirement object using the requirement name.

updateLineItem

Use this method to update a requirement line item object using the unique identifier from the application for the requirement line item object.

Life Cycle Status: Active

Request Payload

Element Name	Type	Description
requirementLineItem	Requirement Line Item Object	The parameter that contains a requirement line item object.

Response Payload

Element Name	Type	Description
result	{http://xmlns.oracle.com/apps/scm/customerNeedsManagement/requirements/requirementService/}RequirementLineItemResult	Returns the result of updating the requirement line item object.

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	ACN_REVIEW_PRODUCT_REQUIREMENT_PRIV	Review Product Requirement	Allows viewing of a product Requirement with all its details
All Operations	ACN_MANAGE_PRODUCT_REQUIREMENT_PRIV	Manage Product Requirement	Allows managing of Requirement and all its Requirement lines within a requirement structure including managing of dependencies

Privileges to Duty Roles Mapping

Privilege Code	Granted to Duty Role Code	Granted to Duty Role Name	Granted To Duty Role Description
ACN_REVIEW_PRODUCT_REQUIREMENT_PRIV	ORA_ACN_REQUIREMENT_MANAGEMENT_DUTY	Requirement Management	This duty allows for performing all actions on a Requirement.
ACN_REVIEW_PRODUCT_REQUIREMENT_PRIV	ORA_ACE_PORTFOLIO_MANAGEMENT_DUTY	Portfolio Management	This duty allows for managing of a product portfolio.
ACN_REVIEW_PRODUCT_REQUIREMENT_PRIV	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
ACN_MANAGE_PRODUCT_REQUIREMENT_PRIV	ORA_ACN_REQUIREMENT_MANAGEMENT_DUTY	Requirement Management	This duty allows for performing all actions on a Requirement.