Update a requirement version
patch
/fscmRestApi/resources/11.13.18.05/requirementSpecifications/{RequirementId}/child/RequirementVersion/{RequirementVersionId}
Request
Path Parameters
-
RequirementId(required): integer
Value that uniquely identifies the requirement specification.
-
RequirementVersionId(required): integer(int64)
Value that uniquely identifies the requirement version.
Header Parameters
-
Metadata-Context:
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".
-
REST-Framework-Version:
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.
Supported Media Types
- application/json
Root Schema : schema
Type:
Show Source
object
-
Attachments: array
Attachments
Title:
Attachments
The Attachments resource manages the attachments of a requirement. -
Description: string
Title:
Description
Maximum Length:1000
Description of the requirement specification. -
Product: string
Title:
Product
Maximum Length:30
Product associated with the requirement specification. -
RequirementLineItem: array
Requirement Line Items
Title:
Requirement Line Items
The Requirement Line Items resource manages the requirements within a requirement specification. Each requirement line has priority and estimates. The estimates roll up to the top-level requirement. -
Status: string
Title:
Status
Maximum Length:30
Default Value:PENDING
Status of the requirement specification. -
TotalEstimates: number
Title:
Total Estimates
Total estimates required to complete the requirement specification.
Nested Schema : Attachments
Type:
array
Title:
Attachments
The Attachments resource manages the attachments of a requirement.
Show Source
Nested Schema : Requirement Line Items
Type:
array
Title:
Requirement Line Items
The Requirement Line Items resource manages the requirements within a requirement specification. Each requirement line has priority and estimates. The estimates roll up to the top-level requirement.
Show Source
Nested Schema : requirementSpecifications-RequirementVersion-Attachments-item-patch-request
Type:
Show Source
object
-
CategoryName: string
Title:
Category
Maximum Length:30
Category of the attachment. - ContentRepositoryFileShared: boolean
-
DatatypeCode: string
Title:
Type
Maximum Length:30
Default Value:FILE
Abbreviation that identifies the data type of the attachment. -
Description: string
Title:
Description
Maximum Length:255
Description of the attachment. -
DmFolderPath: string
Maximum Length:
1000
Repository folder path of the attachment. -
DownloadInfo: string
Title:
DownloadInfo
JSON object represented as a string containing information used to programmatically retrieve a file attachment. -
ErrorStatusCode: string
Abbreviation that identifies the error code, if any, for the attachment.
-
ErrorStatusMessage: string
Text of the error message, if any, for the attachment.
-
ExpirationDate: string
(date-time)
Date when the attachment is no longer valid.
-
FileContents: string
(byte)
Contents of the file attachment.
-
FileName: string
Title:
File Name
Maximum Length:2048
File name of the attachment. -
FileUrl: string
Title:
File Url
URL (Uniform Resource Locator) of the attached file. -
PostProcessingAction: string
Title:
PostProcessingAction
Name of the action that can be performed after an attachment is uploaded. -
Title: string
Title:
Title
Title of the attachment. -
UploadedFileContentType: string
Content type of the attachment.
-
UploadedFileLength: integer
Title:
File Size
Length of the attached file. -
UploadedFileName: string
Name of the attached file.
-
UploadedText: string
Text of the attachment.
-
Uri: string
Maximum Length:
4000
URI (Uniform Resource Identifier) of the attachment. -
Url: string
Title:
Url
Maximum Length:4000
URL (Uniform Resource Locator) of the attachment.
Nested Schema : schema
Type:
Show Source
object
-
Attachments: array
Attachments
Title:
Attachments
The Attachments resource manages the attachments of a requirement. -
Content: string
(byte)
Title:
Content
Details of the requirement line item. -
Description: string
Title:
Description
Maximum Length:1000
Description of the requirement line item. -
Estimates: number
Title:
Estimates
Estimates needed to complete the requirement line item. -
Fulfilled: string
Title:
Fulfilled
Maximum Length:30
Value that indicates whether the requirement line item has been fulfilled. -
Name: string
Title:
Requirement
Maximum Length:400
Name of the requirement specification. -
ParentLineItemId: integer
(int64)
Value that uniquely identifies parent line item.
-
Priority: string
Title:
Priority
Maximum Length:30
Priority of the requirement line item. -
RequirementId: integer
Value that uniquely identifies the requirement.
-
Scope: string
Title:
In Scope
Maximum Length:30
Scope of the requirement line item. -
SectionNumber: string
Title:
Number
Maximum Length:400
Number that identifies the section of the requirement line item.
Nested Schema : Attachments
Type:
array
Title:
Attachments
The Attachments resource manages the attachments of a requirement.
Show Source
Nested Schema : requirementSpecifications-RequirementVersion-RequirementLineItem-Attachments-item-patch-request
Type:
Show Source
object
-
CategoryName: string
Title:
Category
Maximum Length:30
Category of the attachment. - ContentRepositoryFileShared: boolean
-
DatatypeCode: string
Title:
Type
Maximum Length:30
Default Value:FILE
Abbreviation that identifies the data type of the attachment. -
Description: string
Title:
Description
Maximum Length:255
Description of the attachment. -
DmFolderPath: string
Maximum Length:
1000
Repository folder path of the attachment. -
DownloadInfo: string
Title:
DownloadInfo
JSON object represented as a string containing information used to programmatically retrieve a file attachment. -
ErrorStatusCode: string
Abbreviation that identifies the error code, if any, for the attachment.
-
ErrorStatusMessage: string
Text of the error message, if any, for the attachment.
-
ExpirationDate: string
(date-time)
Date when the attachment is no longer valid.
-
FileContents: string
(byte)
Contents of the file attachment.
-
FileName: string
Title:
File Name
Maximum Length:2048
File name of the attachment. -
FileUrl: string
Title:
File Url
URL (Uniform Resource Locator) of the attached file. -
PostProcessingAction: string
Title:
PostProcessingAction
Name of the action that can be performed after an attachment is uploaded. -
Title: string
Title:
Title
Title of the attachment. -
UploadedFileContentType: string
Content type of the attachment.
-
UploadedFileLength: integer
Title:
File Size
Length of the attached file. -
UploadedFileName: string
Name of the attached file.
-
UploadedText: string
Text of the attachment.
-
Uri: string
Maximum Length:
4000
URI (Uniform Resource Identifier) of the attachment. -
Url: string
Title:
Url
Maximum Length:4000
URL (Uniform Resource Locator) of the attachment.
Response
Supported Media Types
- application/json
Default Response
The following table describes the default response for this task.
Headers
-
Metadata-Context:
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".
-
REST-Framework-Version:
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.
Root Schema : requirementSpecifications-RequirementVersion-item-response
Type:
Show Source
object
-
Attachments: array
Attachments
Title:
Attachments
The Attachments resource manages the attachments of a requirement. -
Description: string
Title:
Description
Maximum Length:1000
Description of the requirement specification. -
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
Product: string
Title:
Product
Maximum Length:30
Product associated with the requirement specification. -
ProductName: string
Read Only:
true
Name of the product. -
RequirementId: integer
(int64)
Value that uniquely identifies the requirement.
-
RequirementLineItem: array
Requirement Line Items
Title:
Requirement Line Items
The Requirement Line Items resource manages the requirements within a requirement specification. Each requirement line has priority and estimates. The estimates roll up to the top-level requirement. -
RequirementName: string
Read Only:
true
Name of the requirement. -
RequirementVersionId: integer
(int64)
Value that uniquely identifies the requirement version.
-
Status: string
Title:
Status
Maximum Length:30
Default Value:PENDING
Status of the requirement specification. -
StatusName: string
Read Only:
true
Name of the status. -
TotalDependsOn: integer
Read Only:
true
Number of dependencies on this requirement specification. -
TotalEstimates: number
Title:
Total Estimates
Total estimates required to complete the requirement specification. -
TotalImpacts: integer
Read Only:
true
Number of objects impacted by this requirement specification. -
VersionNumber: integer
(int32)
Title:
Version
Default Value:1
Version number of the requirement specification.
Nested Schema : Attachments
Type:
array
Title:
Attachments
The Attachments resource manages the attachments of a requirement.
Show Source
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Nested Schema : Requirement Line Items
Type:
array
Title:
Requirement Line Items
The Requirement Line Items resource manages the requirements within a requirement specification. Each requirement line has priority and estimates. The estimates roll up to the top-level requirement.
Show Source
Nested Schema : requirementSpecifications-RequirementVersion-Attachments-item-response
Type:
Show Source
object
-
AttachedDocumentId: integer
(int64)
Value that uniquely identifies the attached document.
-
CategoryName: string
Title:
Category
Maximum Length:30
Category of the attachment. - ContentRepositoryFileShared: boolean
-
CreatedBy: string
Read Only:
true
Maximum Length:255
User who created the attachment. -
CreatedByUserName: string
Title:
Created By User Name
Read Only:true
Login that the user used when creating the attachment for the affected item. -
CreationDate: string
(date-time)
Read Only:
true
Date when the attachment was created. -
DatatypeCode: string
Title:
Type
Maximum Length:30
Default Value:FILE
Abbreviation that identifies the data type of the attachment. -
Description: string
Title:
Description
Maximum Length:255
Description of the attachment. -
DmFolderPath: string
Maximum Length:
1000
Repository folder path of the attachment. -
DownloadInfo: string
Title:
DownloadInfo
JSON object represented as a string containing information used to programmatically retrieve a file attachment. -
ErrorStatusCode: string
Abbreviation that identifies the error code, if any, for the attachment.
-
ErrorStatusMessage: string
Text of the error message, if any, for the attachment.
-
ExpirationDate: string
(date-time)
Date when the attachment is no longer valid.
-
FileContents: string
(byte)
Contents of the file attachment.
-
FileName: string
Title:
File Name
Maximum Length:2048
File name of the attachment. -
FileUrl: string
Title:
File Url
URL (Uniform Resource Locator) of the attached file. -
FileWebImage: string
(byte)
Title:
File Web Image
Read Only:true
The base64 encoded image of the file displayed in .png format if the source is a convertible image. -
LastUpdateDate: string
(date-time)
Title:
Last Update Date
Read Only:true
Date and time when the user most recently updated the attachment. -
LastUpdatedBy: string
Title:
Last Updated By
Read Only:true
Maximum Length:255
User who most recently updated the attachment. -
LastUpdatedByUserName: string
Title:
Last Updated By User
Read Only:true
Login that the user used when updating the attachment for the affected item. -
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
PostProcessingAction: string
Title:
PostProcessingAction
Name of the action that can be performed after an attachment is uploaded. -
Title: string
Title:
Title
Title of the attachment. -
UploadedFileContentType: string
Content type of the attachment.
-
UploadedFileLength: integer
Title:
File Size
Length of the attached file. -
UploadedFileName: string
Name of the attached file.
-
UploadedText: string
Text of the attachment.
-
Uri: string
Maximum Length:
4000
URI (Uniform Resource Identifier) of the attachment. -
Url: string
Title:
Url
Maximum Length:4000
URL (Uniform Resource Locator) of the attachment. -
UserName: string
Read Only:
true
Maximum Length:255
Login that the user used when adding the attachment.
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Nested Schema : link
Type:
Show Source
object
-
href: string
Title:
hyperlink reference
The URI to the related resource. -
kind: string
Title:
kind
Allowed Values:[ "collection", "item", "describe", "other" ]
The kind of the related resource. -
name: string
Title:
name
The name of the link to the related resource. -
properties: object
properties
-
rel: string
Title:
relation
Allowed Values:[ "self", "lov", "parent", "canonical", "child", "enclosure", "action", "custom" ]
The name of the relation to the resource instance. Example: self.
Nested Schema : properties
Type:
Show Source
object
-
changeIndicator: string
Change indicator or the ETag value of the resource instance.
Nested Schema : requirementSpecifications-RequirementVersion-RequirementLineItem-item-response
Type:
Show Source
object
-
Attachments: array
Attachments
Title:
Attachments
The Attachments resource manages the attachments of a requirement. -
Content: string
(byte)
Title:
Content
Details of the requirement line item. -
Description: string
Title:
Description
Maximum Length:1000
Description of the requirement line item. -
Estimates: number
Title:
Estimates
Estimates needed to complete the requirement line item. -
Fulfilled: string
Title:
Fulfilled
Maximum Length:30
Value that indicates whether the requirement line item has been fulfilled. -
FulfilledName: string
Read Only:
true
Name of the fulfilled flag. -
Impacts: integer
Read Only:
true
Number of objects impacted by the requirement line item. -
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
Name: string
Title:
Requirement
Maximum Length:400
Name of the requirement specification. -
ParentLineItemId: integer
(int64)
Value that uniquely identifies parent line item.
-
ParentSectionNumber: string
Number that identifies the section of the parent line item.
-
Priority: string
Title:
Priority
Maximum Length:30
Priority of the requirement line item. -
PriorityName: string
Read Only:
true
Name of the priority. -
RequirementId: integer
Value that uniquely identifies the requirement.
-
RequirementLineItemId: integer
(int64)
Value that uniquely identifies the requirement line item.
-
RequirementName: string
Read Only:
true
Name of the requirement. -
RequirementVersionId: integer
(int64)
Title:
Requirement Version ID
Value that uniquely identifies the requirement version. -
RequirementVersionNumber: integer
Read Only:
true
Number that identifies the version of the requirement. -
Scope: string
Title:
In Scope
Maximum Length:30
Scope of the requirement line item. -
ScopeName: string
Read Only:
true
Name of the scope. -
SectionNumber: string
Title:
Number
Maximum Length:400
Number that identifies the section of the requirement line item.
Nested Schema : Attachments
Type:
array
Title:
Attachments
The Attachments resource manages the attachments of a requirement.
Show Source
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Nested Schema : requirementSpecifications-RequirementVersion-RequirementLineItem-Attachments-item-response
Type:
Show Source
object
-
AttachedDocumentId: integer
(int64)
Value that uniquely identifies the attached document.
-
CategoryName: string
Title:
Category
Maximum Length:30
Category of the attachment. - ContentRepositoryFileShared: boolean
-
CreatedBy: string
Read Only:
true
Maximum Length:255
User who created the attachment. -
CreatedByUserName: string
Title:
Created By User Name
Read Only:true
Login that the user used when creating the attachment for the affected item. -
CreationDate: string
(date-time)
Read Only:
true
Date when the attachment was created. -
DatatypeCode: string
Title:
Type
Maximum Length:30
Default Value:FILE
Abbreviation that identifies the data type of the attachment. -
Description: string
Title:
Description
Maximum Length:255
Description of the attachment. -
DmFolderPath: string
Maximum Length:
1000
Repository folder path of the attachment. -
DownloadInfo: string
Title:
DownloadInfo
JSON object represented as a string containing information used to programmatically retrieve a file attachment. -
ErrorStatusCode: string
Abbreviation that identifies the error code, if any, for the attachment.
-
ErrorStatusMessage: string
Text of the error message, if any, for the attachment.
-
ExpirationDate: string
(date-time)
Date when the attachment is no longer valid.
-
FileContents: string
(byte)
Contents of the file attachment.
-
FileName: string
Title:
File Name
Maximum Length:2048
File name of the attachment. -
FileUrl: string
Title:
File Url
URL (Uniform Resource Locator) of the attached file. -
FileWebImage: string
(byte)
Title:
File Web Image
Read Only:true
The base64 encoded image of the file displayed in .png format if the source is a convertible image. -
LastUpdateDate: string
(date-time)
Title:
Last Update Date
Read Only:true
Date and time when the user most recently updated the attachment. -
LastUpdatedBy: string
Title:
Last Updated By
Read Only:true
Maximum Length:255
User who most recently updated the attachment. -
LastUpdatedByUserName: string
Title:
Last Updated By User
Read Only:true
Login that the user used when updating the attachment for the affected item. -
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
PostProcessingAction: string
Title:
PostProcessingAction
Name of the action that can be performed after an attachment is uploaded. -
Title: string
Title:
Title
Title of the attachment. -
UploadedFileContentType: string
Content type of the attachment.
-
UploadedFileLength: integer
Title:
File Size
Length of the attached file. -
UploadedFileName: string
Name of the attached file.
-
UploadedText: string
Text of the attachment.
-
Uri: string
Maximum Length:
4000
URI (Uniform Resource Identifier) of the attachment. -
Url: string
Title:
Url
Maximum Length:4000
URL (Uniform Resource Locator) of the attachment. -
UserName: string
Read Only:
true
Maximum Length:255
Login that the user used when adding the attachment.
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Links
- Attachments
-
Parameters:
- RequirementId:
$request.path.RequirementId
- RequirementVersionId:
$request.path.RequirementVersionId
The Attachments resource manages the attachments of a requirement. - RequirementId:
- RequirementLineItem
-
Parameters:
- RequirementId:
$request.path.RequirementId
- RequirementVersionId:
$request.path.RequirementVersionId
The Requirement Line Items resource manages the requirements within a requirement specification. Each requirement line has priority and estimates. The estimates roll up to the top-level requirement. - RequirementId:
Examples
This example describes how to update a requirement version.
Example cURL Command
Use the following cURL command to submit a request on the REST resource.
curl -X PATCH -u "username:password" -H "Content-Type: application/vnd.oracle.adf.resourceitem+json" -d 'request payload' "https://servername/fscmRestApi/resources/version/requirementSpecifications/RequirementId/child/RequirementVersion/RequirementVersionId"
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 updates.
{ "Description" : "Technical Requirements" }
Example Response Body
The following example includes the contents of the response body in JSON format:
{ "Status": "PENDING", "StatusName": "Draft", "RequirementVersionId": 300100240957740, "TotalEstimates": 0, "RequirementId": 300100240957736, "Description": "Technical Requirements", "TotalDependsOn": null, "TotalImpacts": null, "VersionNumber": 2, "Product": null, "ProductName": null, "RequirementName": "Flying-Bike-Requirements-New", "links": [ { "rel": "self", "href": "https://servername/fscmRestApi/resources/version/requirementSpecifications/300100240957736/child/RequirementVersion/300100240957740", "name": "RequirementVersion", "kind": "item", "properties": { "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000278" } }, { "rel": "canonical", "href": "https://servername/fscmRestApi/resources/version/requirementSpecifications/300100240957736/child/RequirementVersion/300100240957740", "name": "RequirementVersion", "kind": "item" }, { "rel": "parent", "href": "https://servername/fscmRestApi/resources/version/requirementSpecifications/300100240957736", "name": "requirementSpecifications", "kind": "item" }, { "rel": "child", "href": "https://servername/fscmRestApi/resources/version/requirementSpecifications/300100240957736/child/RequirementVersion/300100240957740/child/Attachments", "name": "Attachments", "kind": "collection" }, { "rel": "child", "href": "https://servername/fscmRestApi/resources/version/requirementSpecifications/300100240957736/child/RequirementVersion/300100240957740/child/RequirementLineItem", "name": "RequirementLineItem", "kind": "collection" } ] }