1. REST API for Oracle Fusion Cloud SCM
  2. Tasks
  3. Product Lifecycle Management
  4. Product Concepts

Create a product concept

post

/fscmRestApi/resources/11.13.18.05/productConcepts

Request

Header Parameters
  • If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
  • The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
  • Contains one of the following values: true or false. If true, the server performs an Upsert operation instead of a Create operation. During an Upsert operation, the server attempts to find an existing resource that matches the payload. If a match is found, the server updates the existing resource instead of creating a new one. If not found or false (default), the server performs a Create operation. Note that the Upsert operation isn't supported for date-effective REST resources.
Supported Media Types
Request Body - application/json ()
Root Schema : schema
Type: object
Show Source
  • Maximum Length: 1
    Default Value: Y
    Contains one of the following values: Y or N. If Y, then allow access to everyone who has proper privileges. If N, then allow access only to the team members with proper privileges. The default value is Y.
  • Concept Structure Line Items
    Title: Concept Structure Line Items
    The Concept Structure Line Items resource is used to manage the structure of the product concept.
  • Title: Currency
    Maximum Length: 15
    Default Value: USD
    Abbreviation that identifies the currency of the product concept.
  • Title: Description
    Maximum Length: 1000
    Description of the concept.
  • Title: Due Date
    Date when the concept is due.
  • Long description of the concept.
  • Title: Name
    Maximum Length: 150
    Name of the concept.
  • Product Proposals
    Title: Product Proposals
    The Product Proposals resource manages the product proposals. A product proposal represents a business plan for a proposed new concept, a new product, a sustaining product, or a product to be phased out. The product proposal contains financial information such as cost and revenue of the product. It also contains milestone and resource data that represents the execution details.
  • Relationships
    Title: Relationships
    The Relationships resource manages the objects related to a concept. The objects reference a concept, an item, or other objects.
  • Team Members
    Title: Team Members
    The Team Members resource manages the team members of the product proposal.
  • Maximum Length: 80
    Type of the product concept.
Nested Schema : Concept Structure Line Items
Type: array
Title: Concept Structure Line Items
The Concept Structure Line Items resource is used to manage the structure of the product concept.
Show Source
Nested Schema : Product Proposals
Type: array
Title: Product Proposals
The Product Proposals resource manages the product proposals. A product proposal represents a business plan for a proposed new concept, a new product, a sustaining product, or a product to be phased out. The product proposal contains financial information such as cost and revenue of the product. It also contains milestone and resource data that represents the execution details.
Show Source
Nested Schema : Relationships
Type: array
Title: Relationships
The Relationships resource manages the objects related to a concept. The objects reference a concept, an item, or other objects.
Show Source
Nested Schema : Team Members
Type: array
Title: Team Members
The Team Members resource manages the team members of the product proposal.
Show Source
Nested Schema : schema
Type: object
Show Source
  • Title: Actual Power
    Actual power consumption of this concept structure line item.
  • Title: Actual Weight
    Actual weight of this concept structure line item.
  • Title: Alternative
    Maximum Length: 1
    Default Value: n
    Checkbox to identify that the concept structure line item is an alternative.
  • Attachments
    Title: Attachments
    The attachments resource is used to view, create, and update attachments.
  • Title: Compliance
    Maximum Length: 30
    Compliance level of this concept structure line item.
  • Title: Description
    Description of the concept structure line item.
  • Title: Nonrecurring Cost
    Fixed cost of this concept structure line item.
  • Maximum Length: 1
    Default Value: n
    Checkbox to identify that the concept structure line item is assigned to solution alternative 1.
  • Maximum Length: 1
    Default Value: n
    Checkbox to identify that the concept structure line item is assigned to solution alternative 10.
  • Maximum Length: 1
    Default Value: n
    Checkbox to identify that the concept structure line item is assigned to solution alternative 11.
  • Maximum Length: 1
    Default Value: n
    Checkbox to identify that the concept structure line item is assigned to solution alternative 12.
  • Maximum Length: 1
    Default Value: n
    Checkbox to identify that the concept structure line item is assigned to solution alternative 13.
  • Maximum Length: 1
    Default Value: n
    Checkbox to identify that the concept structure line item is assigned to solution alternative 14.
  • Maximum Length: 1
    Default Value: n
    Checkbox to identify that the concept structure line item is assigned to solution alternative 15.
  • Maximum Length: 1
    Default Value: n
    Checkbox to identify that the concept structure line item is assigned to solution alternative 2.
  • Maximum Length: 1
    Default Value: n
    Checkbox to identify that the concept structure line item is assigned to solution alternative 3.
  • Maximum Length: 1
    Default Value: n
    Checkbox to identify that the concept structure line item is assigned to solution alternative 4.
  • Maximum Length: 1
    Default Value: n
    Checkbox to identify that the concept structure line item is assigned to solution alternative 5.
  • Maximum Length: 1
    Default Value: n
    Checkbox to identify that the concept structure line item is assigned to solution alternative 6.
  • Maximum Length: 1
    Default Value: n
    Checkbox to identify that the concept structure line item is assigned to solution alternative 7.
  • Maximum Length: 1
    Default Value: n
    Checkbox to identify that the concept structure line item is assigned to solution alternative 8.
  • Maximum Length: 1
    Default Value: n
    Checkbox to identify that the concept structure line item is assigned to solution alternative 9.
  • Title: Incidents
    Number of incidents for this concept structure line item.
  • Title: Lead Time
    Lead time of this concept structure line item.
  • Maximum Length: 255
    Level of the concept structure line item in the structure.
  • Title: Material Cost
    Actual material cost of this concept structure line item.
  • Metrics
    Title: Metrics
    The Metrics resource is used to view the concept structure metrics across different solution alternatives of the product concept.
  • Title: Name
    Maximum Length: 150
    Name of the concept structure line item.
  • Title: Nonmaterial Cost
    Actual nonmaterial cost of this concept structure line item.
  • Title: Manufacturers
    Number of manufacturers for this concept structure line item.
  • Value that uniquely identifies the parent of the concept structure line item.
  • Maximum Length: 255
    Level of the parent line item in the structure.
  • Title: Quantity
    Default Value: 1
    Quantity of the concept structure line item.
  • Relationships
    Title: Relationships
    The Relationships resource manages the objects related to a concept. The objects reference a concept, an item, or other objects.
  • Title: Revision
    Revision of the object associated with the concept structure line item.
  • Title: Risk
    Maximum Length: 30
    Risk of this concept structure line item.
  • Title: Score
    Score of this concept structure line item.
  • Title: Target Cost
    Target cost of this concept structure line item.
  • Title: Target Power
    Target power consumption of this concept structure line item.
  • Title: Target Weight
    Target weight of this concept structure line item.
  • Maximum Length: 400
    Value that uniquely identifies the item associated with this concept structure line item.
  • Title: Type
    Maximum Length: 30
    Type of the object associated with this concept structure line item.
  • Title: Type
    Type of the concept structure line item.
  • Title: Supplier
    Maximum Length: 150
    Supplier of this concept structure line item.
  • Title: Volume
    Expected volume of this concept structure line item.
Nested Schema : Attachments
Type: array
Title: Attachments
The attachments resource is used to view, create, and update attachments.
Show Source
Nested Schema : Metrics
Type: array
Title: Metrics
The Metrics resource is used to view the concept structure metrics across different solution alternatives of the product concept.
Show Source
Nested Schema : Relationships
Type: array
Title: Relationships
The Relationships resource manages the objects related to a concept. The objects reference a concept, an item, or other objects.
Show Source
Nested Schema : productConcepts-ConceptStructure-Attachments-item-post-request
Type: object
Show Source
Nested Schema : productConcepts-ConceptStructure-Metrics-item-post-request
Type: object
Show Source
Nested Schema : schema
Type: object
Show Source
Nested Schema : productConcepts-Proposal-item-post-request
Type: object
Show Source
Nested Schema : schema
Type: object
Show Source
Nested Schema : productConcepts-Team-item-post-request
Type: object
Show Source
Back to Top

Response

Supported Media Types

Default Response

The following table describes the default response for this task.
Headers
  • If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
  • The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Body ()
Root Schema : productConcepts-item-response
Type: object
Show Source
  • Maximum Length: 1
    Default Value: Y
    Contains one of the following values: Y or N. If Y, then allow access to everyone who has proper privileges. If N, then allow access only to the team members with proper privileges. The default value is Y.
  • Read Only: true
    Value that uniquely identifies the concept.
  • Title: Number
    Read Only: true
    Maximum Length: 100
    Number that uniquely identifies the concept.
  • Concept Structure Line Items
    Title: Concept Structure Line Items
    The Concept Structure Line Items resource is used to manage the structure of the product concept.
  • Title: Created By
    Read Only: true
    Maximum Length: 64
    Date when the user created the concept.
  • Title: Creation Date
    Read Only: true
    User who created the concept.
  • Title: Currency
    Maximum Length: 15
    Default Value: USD
    Abbreviation that identifies the currency of the product concept.
  • Title: Description
    Maximum Length: 1000
    Description of the concept.
  • Title: Due Date
    Date when the concept is due.
  • Title: Is Current
    Read Only: true
    Maximum Length: 1
    Default Value: y
    Value that indicates if this version is the current version.
  • Title: Last Updated Date
    Read Only: true
    Date when the user most recently updated the concept.
  • Title: Last Updated By
    Read Only: true
    Maximum Length: 64
    User who most recently updated the concept.
  • Title: Status
    Read Only: true
    Maximum Length: 30
    Default Value: DRAFT
    Value that indicates the lifecycle phase of the concept.
  • Links
  • Long description of the concept.
  • Read Only: true
    Value that uniquely identifies the concept master.
  • Title: Name
    Maximum Length: 150
    Name of the concept.
  • Title: Owner
    Read Only: true
    Maximum Length: 80
    Name of the user who owns the concept.
  • Product Proposals
    Title: Product Proposals
    The Product Proposals resource manages the product proposals. A product proposal represents a business plan for a proposed new concept, a new product, a sustaining product, or a product to be phased out. The product proposal contains financial information such as cost and revenue of the product. It also contains milestone and resource data that represents the execution details.
  • Relationships
    Title: Relationships
    The Relationships resource manages the objects related to a concept. The objects reference a concept, an item, or other objects.
  • Team Members
    Title: Team Members
    The Team Members resource manages the team members of the product proposal.
  • Maximum Length: 80
    Type of the product concept.
  • Title: Version
    Read Only: true
    Maximum Length: 10
    Default Value: 1
    Version of the product concept.
Nested Schema : Concept Structure Line Items
Type: array
Title: Concept Structure Line Items
The Concept Structure Line Items resource is used to manage the structure of the product concept.
Show Source
Nested Schema : Product Proposals
Type: array
Title: Product Proposals
The Product Proposals resource manages the product proposals. A product proposal represents a business plan for a proposed new concept, a new product, a sustaining product, or a product to be phased out. The product proposal contains financial information such as cost and revenue of the product. It also contains milestone and resource data that represents the execution details.
Show Source
Nested Schema : Relationships
Type: array
Title: Relationships
The Relationships resource manages the objects related to a concept. The objects reference a concept, an item, or other objects.
Show Source
Nested Schema : Team Members
Type: array
Title: Team Members
The Team Members resource manages the team members of the product proposal.
Show Source
Nested Schema : productConcepts-ConceptStructure-item-response
Type: object
Show Source
  • Title: Actual Power
    Actual power consumption of this concept structure line item.
  • Title: Actual Weight
    Actual weight of this concept structure line item.
  • Title: Alternative
    Maximum Length: 1
    Default Value: n
    Checkbox to identify that the concept structure line item is an alternative.
  • Attachments
    Title: Attachments
    The attachments resource is used to view, create, and update attachments.
  • Title: Compliance
    Maximum Length: 30
    Compliance level of this concept structure line item.
  • Read Only: true
    Value that uniquely identifies the concept structure line item.
  • Read Only: true
    Maximum Length: 64
    User who created the concept structure line item.
  • Read Only: true
    Date when the user created the concept structure line item.
  • Title: Description
    Description of the concept structure line item.
  • Title: Nonrecurring Cost
    Fixed cost of this concept structure line item.
  • Maximum Length: 1
    Default Value: n
    Checkbox to identify that the concept structure line item is assigned to solution alternative 1.
  • Maximum Length: 1
    Default Value: n
    Checkbox to identify that the concept structure line item is assigned to solution alternative 10.
  • Maximum Length: 1
    Default Value: n
    Checkbox to identify that the concept structure line item is assigned to solution alternative 11.
  • Maximum Length: 1
    Default Value: n
    Checkbox to identify that the concept structure line item is assigned to solution alternative 12.
  • Maximum Length: 1
    Default Value: n
    Checkbox to identify that the concept structure line item is assigned to solution alternative 13.
  • Maximum Length: 1
    Default Value: n
    Checkbox to identify that the concept structure line item is assigned to solution alternative 14.
  • Maximum Length: 1
    Default Value: n
    Checkbox to identify that the concept structure line item is assigned to solution alternative 15.
  • Maximum Length: 1
    Default Value: n
    Checkbox to identify that the concept structure line item is assigned to solution alternative 2.
  • Maximum Length: 1
    Default Value: n
    Checkbox to identify that the concept structure line item is assigned to solution alternative 3.
  • Maximum Length: 1
    Default Value: n
    Checkbox to identify that the concept structure line item is assigned to solution alternative 4.
  • Maximum Length: 1
    Default Value: n
    Checkbox to identify that the concept structure line item is assigned to solution alternative 5.
  • Maximum Length: 1
    Default Value: n
    Checkbox to identify that the concept structure line item is assigned to solution alternative 6.
  • Maximum Length: 1
    Default Value: n
    Checkbox to identify that the concept structure line item is assigned to solution alternative 7.
  • Maximum Length: 1
    Default Value: n
    Checkbox to identify that the concept structure line item is assigned to solution alternative 8.
  • Maximum Length: 1
    Default Value: n
    Checkbox to identify that the concept structure line item is assigned to solution alternative 9.
  • Title: Incidents
    Number of incidents for this concept structure line item.
  • Read Only: true
    Date when the user most recently updated the concept structure line item.
  • Read Only: true
    Maximum Length: 64
    User who most recently updated the concept structure line item.
  • Title: Lead Time
    Lead time of this concept structure line item.
  • Maximum Length: 255
    Level of the concept structure line item in the structure.
  • Links
  • Title: Material Cost
    Actual material cost of this concept structure line item.
  • Metrics
    Title: Metrics
    The Metrics resource is used to view the concept structure metrics across different solution alternatives of the product concept.
  • Title: Name
    Maximum Length: 150
    Name of the concept structure line item.
  • Title: Nonmaterial Cost
    Actual nonmaterial cost of this concept structure line item.
  • Title: Manufacturers
    Number of manufacturers for this concept structure line item.
  • Value that uniquely identifies the parent of the concept structure line item.
  • Maximum Length: 255
    Level of the parent line item in the structure.
  • Title: Quantity
    Default Value: 1
    Quantity of the concept structure line item.
  • Relationships
    Title: Relationships
    The Relationships resource manages the objects related to a concept. The objects reference a concept, an item, or other objects.
  • Title: Revision
    Revision of the object associated with the concept structure line item.
  • Title: Risk
    Maximum Length: 30
    Risk of this concept structure line item.
  • Title: Score
    Score of this concept structure line item.
  • Title: Target Cost
    Target cost of this concept structure line item.
  • Title: Target Power
    Target power consumption of this concept structure line item.
  • Title: Target Weight
    Target weight of this concept structure line item.
  • Read Only: true
    Value that uniquely identifies the component or subconcept associated with this concept structure line item.
  • Maximum Length: 400
    Value that uniquely identifies the item associated with this concept structure line item.
  • Title: Type
    Maximum Length: 30
    Type of the object associated with this concept structure line item.
  • Title: Type
    Type of the concept structure line item.
  • Title: Supplier
    Maximum Length: 150
    Supplier of this concept structure line item.
  • Title: Volume
    Expected volume of this concept structure line item.
Nested Schema : Attachments
Type: array
Title: Attachments
The attachments resource is used to view, create, and update attachments.
Show Source
Nested Schema : Metrics
Type: array
Title: Metrics
The Metrics resource is used to view the concept structure metrics across different solution alternatives of the product concept.
Show Source
Nested Schema : Relationships
Type: array
Title: Relationships
The Relationships resource manages the objects related to a concept. The objects reference a concept, an item, or other objects.
Show Source
Nested Schema : productConcepts-ConceptStructure-Attachments-item-response
Type: object
Show Source
Nested Schema : productConcepts-ConceptStructure-Metrics-item-response
Type: object
Show Source
Nested Schema : productConcepts-ConceptStructure-Relationships-item-response
Type: object
Show Source
Nested Schema : productConcepts-Proposal-item-response
Type: object
Show Source
Nested Schema : productConcepts-Relationships-item-response
Type: object
Show Source
Nested Schema : productConcepts-Team-item-response
Type: object
Show Source
Links
ConceptStructure
Parameters:
  • ConceptId: $request.path.ConceptId
The Concept Structure Line Items resource is used to manage the structure of the product concept.
Proposal
Parameters:
  • ConceptId: $request.path.ConceptId
The Product Proposals resource manages the product proposals. A product proposal represents a business plan for a proposed new concept, a new product, a sustaining product, or a product to be phased out. The product proposal contains financial information such as cost and revenue of the product. It also contains milestone and resource data that represents the execution details.
Relationships
Parameters:
  • ConceptId: $request.path.ConceptId
The Relationships resource manages the objects related to a concept. The objects reference a concept, an item, or other objects.
Team
Parameters:
  • ConceptId: $request.path.ConceptId
The Team Members resource manages the team members of the product proposal.
Back to Top

Examples

This example describes how to create a product concept.

Example cURL Command

Use the following cURL command to submit a request on the REST resource.

curl -u username:password -X POST -H "Content-Type:application/vnd.oracle.adf.resourceitem+json" -d 'request payload' 
"https://servername/fscmRestApi/resources/version/productConcepts"

Example Request Body

The following example includes the contents of the request body in JSON format. You replace the request payload in the cURL command with the contents of the Example Request Body. The request payload specifies attribute values that the command will use in the record that it creates. 

{
	"Name": "XYZ",
	"Description": "Test Data",
	"Type": "CONCEPT"
}

Example Response Body

The following example includes the contents of the response body in JSON format:

{
	"ConceptId": 300100255090136,
	"Name": "XYZ",
	"Description": "Test Data",
	"Type": "CONCEPT",
	"LifecyclePhase": "DRAFT",
	"CurrencyCode": "USD",
	"IsCurrent": "y",
	"Version": "1",
	"DueDate": null,
	"CreatedBy": "PRODUCT_MANAGER",
	"CreationDate": "2020-09-15T14:21:04+00:00",
	"LastUpdatedBy": "PRODUCT_MANAGER",
	"LastUpdateDate": "2020-09-15T14:21:04.497+00:00",
	"MasterId": 300100255090136,
	"OwnerDisplayName": "Product Manager",
	"ConceptEO_CONCEPT_DCL_IDEA_Id_c": null,
	"ConceptEO_CONCEPT_DCL_IDEA_c": null,
	"links": [
	{
		"rel": "self",
		"href": "https://servername/fscmRestApi/resources/version/productConcepts/300100255090136",
		"name": "productConcepts",
		"kind": "item",
		"properties": {
			"changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
		}
	},
	{
		"rel": "canonical",
		"href": "https://servername/fscmRestApi/resources/version/productConcepts/300100255090136",
		"name": "productConcepts",
		"kind": "item"
	},
	{
		"rel": "child",
		"href": "https://servername/fscmRestApi/resources/version/productConcepts/300100255090136/child/ConceptStructure",
		"name": "ConceptStructure",
		"kind": "collection"
	},
	{
		"rel": "child",
		"href": "https://servername/fscmRestApi/resources/version/productConcepts/300100255090136/child/Proposal",
		"name": "Proposal",
		"kind": "collection"
	},
	{
		"rel": "enclosure",
		"href": "https://servername/fscmRestApi/resources/version/productConcepts/300100255090136/enclosure/LongDescription",
		"name": "LongDescription",
		"kind": "other"
	}
	]
}
Back to Top