Update a process
patch
/fscmRestApi/resources/11.13.18.05/frcProcesses/{ProcessId}
Request
Path Parameters
-
ProcessId(required): integer(int64)
The unique identifier of the process.
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-
actionItems: array
Action Items
Title:
Action ItemsThe action items resource is used to view or modify action items to be completed in conjunction with processes. -
additionalInformation: array
Flexfields
Title:
FlexfieldsThe flexfields resource is used to view or modify information added to process definitions in flexfields. -
AssessmentFlag: boolean
Title:
Assessment TestingMaximum Length:1Default Value:falseIdentifies if the process is in scope for an assessment. -
AuditTestingFlag: boolean
Title:
Audit TestingMaximum Length:1Default Value:falseIdentifies if the process is in scope for audit testing. -
comments: array
Comments
Title:
CommentsThe comments resource is used to view or modify comments written about processes. -
DetailedDescription: string
(byte)
Title:
DescriptionThe description of the process. -
Name: string
Title:
NameMaximum Length:150The name of the process. -
perspectives: array
Perspectives
Title:
PerspectivesThe perspectives resource is used to view perspective values assigned to processes or to modify those assignments. - relatedRisks: array Related Risks
-
Status: string
Title:
StatusMaximum Length:30Default Value:ACTIVEThe status of the process: ACTIVE or INACTIVE. -
Type: string
Title:
TypeMaximum Length:30One in a set of user-defined values that may be selected for the process.
Nested Schema : Action Items
Type:
arrayTitle:
Action ItemsThe action items resource is used to view or modify action items to be completed in conjunction with processes.
Show Source
Nested Schema : Flexfields
Type:
arrayTitle:
FlexfieldsThe flexfields resource is used to view or modify information added to process definitions in flexfields.
Show Source
Nested Schema : Comments
Type:
arrayTitle:
CommentsThe comments resource is used to view or modify comments written about processes.
Show Source
Nested Schema : Perspectives
Type:
arrayTitle:
PerspectivesThe perspectives resource is used to view perspective values assigned to processes or to modify those assignments.
Show Source
Nested Schema : frcProcesses-actionItems-item-patch-request
Type:
Show Source
object-
ActionId: integer
(int64)
Title:
Record IDThe unique identifier of the action item. -
CompletedDate: string
(date)
Title:
Completion DateThe date and time the action item was marked as complete. -
DetailedDescription: string
(byte)
Title:
InstructionsThe description of the action item. This is a CLOB attribute. -
DueDate: string
(date-time)
Title:
Due DateThe date when the action item is due. -
EstimatedCompletionDate: string
(date-time)
Title:
Target Completion DateThe target completion date of the action item. -
Name: string
Title:
NameMaximum Length:150The name of the action item. -
PriorityCode: string
Title:
PriorityMaximum Length:30The priority of the action item. -
ProcessId: integer
(int64)
The unique identifier of the process the action item is related to.
-
ProgressCode: string
Title:
ProgressMaximum Length:30A value indicating progress toward completion of the action item: Assigned, Blocked, Delayed, or On Target.
Nested Schema : frcProcesses-additionalInformation-item-patch-request
Type:
Show Source
object-
__FLEX_Context: string
Title:
Context SegmentMaximum Length:150The context of the flexfields associated to the process. -
__FLEX_Context_DisplayValue: string
Title:
Context SegmentThe display value of the context of the flexfields associated to the process. -
ProcessId: integer
(int64)
Title:
Record IDThe unique identifier of the process associated to the flexfield.
Nested Schema : frcProcesses-comments-item-patch-request
Type:
Show Source
object-
Id: integer
The unique identifier of the comment on the process.
-
UserComment: string
Title:
CommentMaximum Length:2000The comment made on the process.
Nested Schema : frcProcesses-perspectives-item-patch-request
Type:
Show Source
object-
PerspItemId: integer
(int64)
The unique identifier of the perspective value assigned to the process.
-
ProcessId: integer
(int64)
The unique identifier of the process.
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 : frcProcesses-item-response
Type:
Show Source
object-
actionItems: array
Action Items
Title:
Action ItemsThe action items resource is used to view or modify action items to be completed in conjunction with processes. -
additionalInformation: array
Flexfields
Title:
FlexfieldsThe flexfields resource is used to view or modify information added to process definitions in flexfields. -
ApprovedBy: string
Title:
Last Approved ByRead Only:trueMaximum Length:64The user who approved the process. -
ApprovedDate: string
(date-time)
Title:
Approved DateRead Only:trueThe date and time the process was approved. -
AssessmentFlag: boolean
Title:
Assessment TestingMaximum Length:1Default Value:falseIdentifies if the process is in scope for an assessment. -
AuditTestingFlag: boolean
Title:
Audit TestingMaximum Length:1Default Value:falseIdentifies if the process is in scope for audit testing. -
comments: array
Comments
Title:
CommentsThe comments resource is used to view or modify comments written about processes. -
CreatedBy: string
Title:
Created ByRead Only:trueMaximum Length:64The user who created the process. -
CreationDate: string
(date-time)
Title:
Creation DateRead Only:trueThe date and time the process was created. -
DetailedDescription: string
(byte)
Title:
DescriptionThe description of the process. -
LastUpdateDate: string
(date-time)
Title:
Last Updated DateRead Only:trueThe date and time the process was most recently updated. -
LastUpdatedBy: string
Title:
Last Updated ByRead Only:trueMaximum Length:64The user who most recently updated the process. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
Name: string
Title:
NameMaximum Length:150The name of the process. -
perspectives: array
Perspectives
Title:
PerspectivesThe perspectives resource is used to view perspective values assigned to processes or to modify those assignments. -
ProcessId: integer
(int64)
Title:
Record IDRead Only:trueThe unique identifier of the process. - relatedRisks: array Related Risks
-
ReviewedBy: string
Title:
Last Reviewed ByRead Only:trueMaximum Length:64The user who reviewed the process. -
ReviewedDate: string
(date-time)
Title:
Reviewed DateRead Only:trueThe date and time the process was reviewed. -
ReviewStartDate: string
(date-time)
Title:
Reviewed DateRead Only:trueThe date and time when the process review was started. -
RevisionDate: string
(date-time)
Title:
Revision DateRead Only:trueThe date when the process was revised. -
RevisionNumber: integer
(int32)
Title:
Revision NumberRead Only:trueDefault Value:1The revision of the process. -
StateCode: string
Title:
StateRead Only:trueMaximum Length:30Default Value:NEWThe state of the process. -
Status: string
Title:
StatusMaximum Length:30Default Value:ACTIVEThe status of the process: ACTIVE or INACTIVE. -
TotalRevisions: integer
(int32)
Read Only:
trueThe total number of revisions for the process. -
Type: string
Title:
TypeMaximum Length:30One in a set of user-defined values that may be selected for the process.
Nested Schema : Action Items
Type:
arrayTitle:
Action ItemsThe action items resource is used to view or modify action items to be completed in conjunction with processes.
Show Source
Nested Schema : Flexfields
Type:
arrayTitle:
FlexfieldsThe flexfields resource is used to view or modify information added to process definitions in flexfields.
Show Source
Nested Schema : Comments
Type:
arrayTitle:
CommentsThe comments resource is used to view or modify comments written about processes.
Show Source
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : Perspectives
Type:
arrayTitle:
PerspectivesThe perspectives resource is used to view perspective values assigned to processes or to modify those assignments.
Show Source
Nested Schema : frcProcesses-actionItems-item-response
Type:
Show Source
object-
ActionId: integer
(int64)
Title:
Record IDThe unique identifier of the action item. -
CompletedDate: string
(date)
Title:
Completion DateThe date and time the action item was marked as complete. -
CreatedBy: string
Title:
Created ByRead Only:trueMaximum Length:64The user who created the action item. -
CreationDate: string
(date-time)
Title:
Creation DateRead Only:trueThe date and time the action item was created. -
DetailedDescription: string
(byte)
Title:
InstructionsThe description of the action item. This is a CLOB attribute. -
DueDate: string
(date-time)
Title:
Due DateThe date when the action item is due. -
EstimatedCompletionDate: string
(date-time)
Title:
Target Completion DateThe target completion date of the action item. -
LastUpdateDate: string
(date-time)
Title:
Last Updated DateRead Only:trueThe date and time the action item was most recently updated. -
LastUpdatedBy: string
Title:
Last Updated ByRead Only:trueMaximum Length:64The user who most recently updated the action item. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
Name: string
Title:
NameMaximum Length:150The name of the action item. -
PriorityCode: string
Title:
PriorityMaximum Length:30The priority of the action item. -
ProcessId: integer
(int64)
The unique identifier of the process the action item is related to.
-
ProgressCode: string
Title:
ProgressMaximum Length:30A value indicating progress toward completion of the action item: Assigned, Blocked, Delayed, or On Target. -
StartDate: string
(date-time)
Title:
Start DateRead Only:trueThe date when the action item started. -
StateCode: string
Title:
StateRead Only:trueMaximum Length:30Default Value:ACTIVEThe state of the action item.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : link
Type:
Show Source
object-
href: string
Title:
hyperlink referenceThe URI to the related resource. -
kind: string
Title:
kindAllowed Values:[ "collection", "item", "describe", "other" ]The kind of the related resource. -
name: string
Title:
nameThe name of the link to the related resource. -
properties: object
properties
-
rel: string
Title:
relationAllowed 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 : frcProcesses-additionalInformation-item-response
Type:
Show Source
object-
__FLEX_Context: string
Title:
Context SegmentMaximum Length:150The context of the flexfields associated to the process. -
__FLEX_Context_DisplayValue: string
Title:
Context SegmentThe display value of the context of the flexfields associated to the process. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
ProcessId: integer
(int64)
Title:
Record IDThe unique identifier of the process associated to the flexfield.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : frcProcesses-comments-item-response
Type:
Show Source
object-
CreatedBy: string
Title:
Created ByRead Only:trueMaximum Length:64The user who created the comment. -
CreationDate: string
(date-time)
Title:
Creation DateRead Only:trueThe date and time the comment was created. -
Id: integer
The unique identifier of the comment on the process.
-
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
UserComment: string
Title:
CommentMaximum Length:2000The comment made on the process.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : frcProcesses-perspectives-item-response
Type:
Show Source
object-
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
Name: string
Read Only:
trueMaximum Length:150The name of the perspective item assigned to the process. -
PerspItemId: integer
(int64)
The unique identifier of the perspective value assigned to the process.
-
ProcessId: integer
(int64)
The unique identifier of the process.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Links
- actionItems
-
Parameters:
- ProcessId:
$request.path.ProcessId
The action items resource is used to view or modify action items to be completed in conjunction with processes. - ProcessId:
- additionalInformation
-
Parameters:
- ProcessId:
$request.path.ProcessId
The flexfields resource is used to view or modify information added to process definitions in flexfields. - ProcessId:
- comments
-
Parameters:
- ProcessId:
$request.path.ProcessId
The comments resource is used to view or modify comments written about processes. - ProcessId:
- perspectives
-
Parameters:
- ProcessId:
$request.path.ProcessId
The perspectives resource is used to view perspective values assigned to processes or to modify those assignments. - ProcessId:
- relatedRisks
-
Parameters:
- ProcessId:
$request.path.ProcessId
The related risks resource is used to view records of risks that may impact processes. - ProcessId:
Examples
The following example shows how to update a process by submitting a PATCH request on the REST resource using cURL.
curl -i -u "<username>:<password>" -H "Content-Type: application/json" -X PATCH -d <payload> https://servername.fa.us2.oraclecloud.com/fscmRestApi/resources/11.13.18.05/frcProcesses/43019
Example Request Body
The following example shows the contents of the request body in JSON format:
{
"Name": "Process Renamed"
}Example Response Body
The following example shows the contents of the response body in JSON format:
{
"ApprovedBy": null,
"ApprovedDate": null,
"AssessmentFlag": false,
"AuditTestingFlag": false,
"CreatedBy": "FRC_WSUSER",
"CreationDate": "2021-01-06T16:44:54+00:00",
"LastUpdateDate": "2021-01-06T17:09:53.007+00:00",
"LastUpdatedBy": "FRC_WSUSER",
"Name": "Process Renamed",
"ProcessId": 43019,
"ReviewStartDate": null,
"ReviewedBy": null,
"ReviewedDate": null,
"RevisionDate": "2021-01-06T16:44:54.460+00:00",
"RevisionNumber": 1,
"StateCode": "NEW",
"Status": "ACTIVE",
"TotalRevisions": 1,
"Type": null,
"links": [
{
"rel": "self",
"href": "https://servername.fa.us2.oraclecloud.com/fscmRestApi/resources/11.13.18.05/frcProcesses/43019",
"name": "frcProcesses",
"kind": "item",
"properties": {
"changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000278"
}
},
{
"rel": "canonical",
"href": "https://servername.fa.us2.oraclecloud.com/fscmRestApi/resources/11.13.18.05/frcProcesses/43019",
"name": "frcProcesses",
"kind": "item"
},
{
"rel": "child",
"href": "https://servername.fa.us2.oraclecloud.com/fscmRestApi/resources/11.13.18.05/frcProcesses/43019/child/actionItems",
"name": "actionItems",
"kind": "collection"
},
{
"rel": "child",
"href": "https://servername.fa.us2.oraclecloud.com/fscmRestApi/resources/11.13.18.05/frcProcesses/43019/child/additionalInformation",
"name": "additionalInformation",
"kind": "collection"
},
{
"rel": "child",
"href": "https://servername.fa.us2.oraclecloud.com/fscmRestApi/resources/11.13.18.05/frcProcesses/43019/child/comments",
"name": "comments",
"kind": "collection"
},
{
"rel": "child",
"href": "https://servername.fa.us2.oraclecloud.com/fscmRestApi/resources/11.13.18.05/frcProcesses/43019/child/perspectives",
"name": "perspectives",
"kind": "collection"
},
{
"rel": "child",
"href": "https://servername.fa.us2.oraclecloud.com/fscmRestApi/resources/11.13.18.05/frcProcesses/43019/child/relatedRisks",
"name": "relatedRisks",
"kind": "collection"
},
{
"rel": "enclosure",
"href": "https://servername.fa.us2.oraclecloud.com/fscmRestApi/resources/11.13.18.05/frcProcesses/43019/enclosure/DetailedDescription",
"name": "DetailedDescription",
"kind": "other"
}
]
}