Update one forecast due date
patch
/fscmRestApi/resources/11.13.18.05/maintenanceForecasts/{ForecastId}
Request
Path Parameters
-
ForecastId(required): integer(int64)
Value that uniquely identifies the forecast due date for a work requirement and asset in a maintenance program. This value is read-only.
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
-
forecastLines: array
Forecast Lines
Title:
Forecast Lines
The Maintenance Forecast Line resource manages the work definition details for forecast due dates in a maintenance program. -
ForecastOrganizationId: integer
(int64)
Title:
Forecast Organization ID
Value that uniquely identifies the organization for the forecasted due date of an asset. This value is read-only. -
RequestedWoOrganizationId: integer
(int64)
Title:
Requested Organization Id
Value that uniquely defines the Organization for the work order. If defined, the value will be used instead of the forecast Organization. -
RequestedWoStartDate: string
(date-time)
Title:
Requested Start Date
Planned Start Date for the work order. If defined, the value will be used instead of the forecast due date. -
SkipDueDateFlag: boolean
Title:
Skip Due Date
Maximum Length:1
Indicates if the due date will be skipped and a work order will not be created. This value is read-only. -
WorkOrderId: integer
(int64)
Title:
Work Order ID
Value that uniquely identifies a maintenance work order. This value is read-only.
Nested Schema : Forecast Lines
Type:
array
Title:
Forecast Lines
The Maintenance Forecast Line resource manages the work definition details for forecast due dates in a maintenance program.
Show Source
Nested Schema : maintenanceForecasts-forecastLines-item-patch-request
Type:
Show Source
object
-
CalendarPatternId: integer
(int64)
Title:
Calendar Pattern ID
Value that uniquely identifies the calendar pattern for the forecasted due date. This value is read-only. -
DayIntervalValue: number
Title:
Day Interval
Value for the number of days that will be incremented to calculate the forecast due dates into the future. This value is read-only. -
DueAtCycleInterval: number
Title:
Due at Cycle Interval
Cycle interval in which the forecast is generated. This value is read-only. -
DueAtMeterReading: number
Title:
Due at Meter Reading
Value for the meter on the forecast due date. This value is read-only. -
ForecastDueDate: string
(date)
Title:
Due Date
Date on which the forecast is due. This value is read-only. -
MeterDailyRate: number
Title:
Meter Daily Rate
Value for the daily utilization rate that will be incremented to calculate the forecast due dates into the future. This value is read-only. -
MeterId: integer
(int64)
Title:
Meter ID
Value that uniquely identifies the asset meter for the forecasted due date. This value is read-only. -
NextWorkOrderOnlyFlag: boolean
Title:
Next work order only
Maximum Length:1
Indicates if the next work orders are created or not. If the value is equal to Y, then the next work order is only created after the completion of the last due work order in the forecast. This value is read-only. -
RequirementId: integer
(int64)
Title:
Work Requirement
Value that uniquely identifies a work requirement in a maintenance program. This value is read-only.
Response
Supported Media Types
- application/json
Default Response
The following table describes the default response for this task.
Headers
-
Metadata-Context(required):
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(required):
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 : maintenanceForecasts-item-response
Type:
Show Source
object
-
AssetDescription: string
Title:
Asset Description
Read Only:true
Maximum Length:240
Description of the asset. This value is read-only. -
AssetId: integer
(int64)
Title:
Asset ID
Read Only:true
Value that uniquely identifies an asset. This value is read-only. -
AssetLocation: string
Title:
Asset Location
Read Only:true
Maximum Length:80
Name of the location of an asset. This value is read-only. -
AssetLocationCode: string
Title:
Location Organization Code
Read Only:true
Maximum Length:80
Abbreviation that uniquely identifies the location of an asset. This value is read-only. -
AssetNumber: string
Title:
Asset Number
Read Only:true
Maximum Length:80
Number that uniquely identifies an asset. This value is read-only. -
AssetOperatingOrgCode: string
Title:
Operating Organization
Read Only:true
Maximum Length:18
Abbreviation that uniquely identifies the operating organization for an asset. This value is read-only. -
AssetOperatingOrgId: integer
(int64)
Title:
Operating Organization ID
Read Only:true
Value that uniquely identifies the operating organization for an asset. This value is read-only. -
AssetSerialNumber: string
Title:
Serial Number
Read Only:true
Maximum Length:80
Serial number of the asset. This value is read-only. -
CreatedBy: string
Title:
Created By
Read Only:true
Maximum Length:64
Login username of the user who created the record. This value is read-only. -
CreationDate: string
(date-time)
Title:
Creation Date
Read Only:true
Date when the record was created. This value is read-only. -
ForecastDueDate: string
(date)
Title:
Due Date
Read Only:true
Date on which the forecast is due. This value is read-only. -
ForecastId: integer
(int64)
Title:
Forecast Id
Read Only:true
Value that uniquely identifies the forecast due date for a work requirement and asset in a maintenance program. This value is read-only. -
forecastLines: array
Forecast Lines
Title:
Forecast Lines
The Maintenance Forecast Line resource manages the work definition details for forecast due dates in a maintenance program. -
ForecastOrganizationCode: string
Title:
Forecast Organization
Read Only:true
Maximum Length:18
Abbreviation that uniquely identifies the organization for the forecasted due date of an asset This value is read-only. -
ForecastOrganizationId: integer
(int64)
Title:
Forecast Organization ID
Value that uniquely identifies the organization for the forecasted due date of an asset. This value is read-only. -
ForecastStatus: string
Title:
Forecast Status
Read Only:true
Maximum Length:255
Meaning of the status of a forecast line. This value is read-only. -
ForecastStatusCode: string
Title:
Forecast Status Code
Read Only:true
Maximum Length:255
Abbreviation that uniquely describes the status of a forecast line. The values are ORA_PLANNED, ORA_UNPLANNED, ORA_SKIPPED or ORA_SCHEDULED as defined in the lookup ORA_MNT_FORECAST_STATUS. This value is read-only. -
GlobalAssetsFlag: boolean
Title:
Allow assets from other organizations
Read Only:true
Maximum Length:1
Indicates if the program will support assets that operate in other organizations. This value is read-only. -
ItemId: integer
(int64)
Title:
Item ID
Read Only:true
Value that uniquely identifies an inventory item for an asset. This value is read-only. -
ItemNumber: string
Title:
Item Number
Read Only:true
Maximum Length:300
Number for an inventory item. This value is read-only. -
LastUpdateDate: string
(date-time)
Title:
Last Update Date
Read Only:true
Date when the record was updated. This value is read-only. -
LastUpdatedBy: string
Title:
Last Updated By
Read Only:true
Maximum Length:64
Login username of the user who updated the record. This value is read-only. -
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
MultipleForecastLinesFlag: boolean
Title:
Work Requirement Name
Read Only:true
Maximum Length:255
Indicates if the forecast due date has more than one corresponding forecast line with work definition details. This value is read-only. -
ProgramCode: string
Title:
Code
Read Only:true
Maximum Length:30
Abbreviation that uniquely identifies the maintenance program. This value is read-only. -
ProgramId: integer
(int64)
Title:
Program Id
Read Only:true
Value that uniquely identifies the maintenance program. This value is read-only. -
ProgramName: string
Title:
Program Name
Read Only:true
Maximum Length:120
Name of the maintenance program. This value is read-only. -
ProgramOrganizationCode: string
Title:
Program Organization
Read Only:true
Maximum Length:18
Abbreviation that uniquely identifies the inventory organization of the maintenance program. Either Organization ID or Code is required. This value is read-only. -
ProgramOrganizationId: integer
(int64)
Title:
Program Organization ID
Read Only:true
Value that uniquely identifies the inventory organization of the maintenance program. This value is read-only. -
ProgramReference: string
Title:
Program Reference
Read Only:true
Maximum Length:80
Reference for a maintenance program. This value is read-only. -
ProgramSubType: string
Title:
Program Subtype
Read Only:true
Maximum Length:80
Meaning of a maintenance program subtype. This value is read-only. -
ProgramSubTypeCode: string
Title:
Program Subtype Code
Read Only:true
Maximum Length:30
Abbreviation that uniquely identifies the subtype of maintenance program. Values are user defined using the extensible lookup ORA_MNT_MX_PROGRAM_SUB_TYPE. This value is read-only. -
ProgramType: string
Title:
Program Type
Read Only:true
Maximum Length:80
Meaning of a maintenance program type. This value is read-only. -
ProgramTypeCode: string
Title:
Program Type Code
Read Only:true
Maximum Length:30
Abbreviation that uniquely identifies the type of maintenance program. Values are ORA_MAINTENANCE and ORA_SUBSCRIPTION as defined in the lookup ORA_MNT_MX_PROGRAM_TYPE. This value is read-only. -
RequestedWoOrganizationCode: string
Title:
Requested Organization
Read Only:true
Maximum Length:18
Abbreviation that uniquely defines the Organization for the work order. If defined, the value will be used instead of the forecast Organization. -
RequestedWoOrganizationId: integer
(int64)
Title:
Requested Organization Id
Value that uniquely defines the Organization for the work order. If defined, the value will be used instead of the forecast Organization. -
RequestedWoStartDate: string
(date-time)
Title:
Requested Start Date
Planned Start Date for the work order. If defined, the value will be used instead of the forecast due date. -
RequirementName: string
Read Only:
true
Maximum Length:255
Name that uniquely identifies a work requirement across all maintenance programs. This value is read-only. -
RootAssetId: integer
(int64)
Title:
Root Asset ID
Read Only:true
Value that uniquely identifies the top asset in a physical hierarchy of assets. This value is read-only. -
RootAssetNumber: string
Title:
Root Asset Number
Read Only:true
Maximum Length:80
Number that uniquely identifies the top asset in a physical hierarchy of assets. This value is read-only. -
SkipDueDateFlag: boolean
Title:
Skip Due Date
Maximum Length:1
Indicates if the due date will be skipped and a work order will not be created. This value is read-only. -
WarrantyRepairFlag: boolean
Title:
Warranty Repair
Read Only:true
Maximum Length:1
Value that indicates if the work order is a warranty repair. This value is read-only. -
WorkOrderId: integer
(int64)
Title:
Work Order ID
Value that uniquely identifies a maintenance work order. This value is read-only. -
WorkOrderNumber: string
Title:
Work Order Number
Read Only:true
Maximum Length:120
Number of a maintenance work order. This value is read-only. -
WorkOrderOrganizationCode: string
Title:
Work Order Organization
Read Only:true
Maximum Length:18
Abbreviation that uniquely identifies the organization for the work order. Either Organization ID or Code is required. This value is read-only. -
WorkOrderOrganizationId: integer
(int64)
Title:
Work Order Organization Id
Read Only:true
Value that uniquely identifies the inventory organization for the work order. This value is read-only. -
WorkOrderStartDate: string
(date-time)
Title:
Work Order Planned Start Date
Read Only:true
Description of a maintenance work order. This value is read-only. This value is read-only. -
WorkOrderStatus: string
Title:
Work Order Status
Read Only:true
Maximum Length:120
Name of the status of a Work Order. This value is read-only. -
WorkOrderStatusCode: string
Title:
Work Order Status Code
Read Only:true
Maximum Length:30
Abbreviation for the status of a Work Order. This value is read-only.
Nested Schema : Forecast Lines
Type:
array
Title:
Forecast Lines
The Maintenance Forecast Line resource manages the work definition details for forecast due dates in a maintenance program.
Show Source
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Nested Schema : maintenanceForecasts-forecastLines-item-response
Type:
Show Source
object
-
CalendarPattern: string
Title:
Calendar Pattern
Read Only:true
Maximum Length:120
Name of the calendar pattern for the forecasted due date. This value is read-only. -
CalendarPatternId: integer
(int64)
Title:
Calendar Pattern ID
Value that uniquely identifies the calendar pattern for the forecasted due date. This value is read-only. -
CreateWoOption: string
Title:
Create Work Orders Option
Read Only:true
Maximum Length:80
Meaning of the create work order option of a work requirement. Values are either Item or Asset. This value is read-only. -
CreateWorkOrderOptionCode: string
Title:
Create Work Orders Option Code
Read Only:true
Maximum Length:30
Default Value:ORA_AUTOMATIC
Abbreviation that uniquely identifies if work orders will be created based on the forecast or not. Values are either ORA_AUTOMATIC or ORA_MANUALLY as defined in the lookup ORA_MNT_MX_PROGRAM_WO_CREATE. This value is read-only. -
DayIntervalValue: number
Title:
Day Interval
Value for the number of days that will be incremented to calculate the forecast due dates into the future. This value is read-only. -
DueAtCycleInterval: number
Title:
Due at Cycle Interval
Cycle interval in which the forecast is generated. This value is read-only. -
DueAtMeterReading: number
Title:
Due at Meter Reading
Value for the meter on the forecast due date. This value is read-only. -
ForecastDueDate: string
(date)
Title:
Due Date
Date on which the forecast is due. This value is read-only. -
ForecastId: integer
(int64)
Title:
Forecast Id
Read Only:true
Value that uniquely identifies the forecast due date for a work requirement and asset in a maintenance program. This value is read-only. -
ForecastInterval: string
Title:
Forecast Interval
Read Only:true
Maximum Length:255
Describes how each due date in the forecast is incremented. For a Calendar Pattern the pattern name is displayed. For a Day Interval the number of days of unit of measure is displayed. For a Meter the meter interval and unit of measure is displayed. For a Condition Event a null value is displayed. This value is read-only. -
ForecastLineId: integer
(int64)
Read Only:
true
Value that uniquely identifies the forecast line for a work requirement and asset in a maintenance program. This value is read-only. -
ForecastMethod: string
Title:
Forecast Method
Read Only:true
Maximum Length:255
Describes how a maintenance forecast is generated. A forecast can be generated by one these methods: Calendar Pattern, Day Interval value, Meter Template name or Condition Event code. This value is read-only. -
ForecastNextDueBy: string
Title:
Next Due Date Method
Read Only:true
Maximum Length:255
Meaning of how the next due date in the forecast will be calculated. For a Calendar Pattern it will display as Last Completion. For a Day Interval it will display as Last Completion or Base Interval . For a Meter it will display as Last Completion or Base Interval. For a Condition Event nothing is displayed. This value is read-only. -
ForecastNextDueByCode: string
Title:
Next Due Date Code
Read Only:true
Maximum Length:255
Abbreviation that indicates how the next due date in the forecast will be calculated. The values are ORA_BASE_INTERVAL or ORA_READING_HISTORY as defined in the lookup ORA_MNT_METER_NEXT_DUE. This value is read-only. -
ForecastUsingCycleFlag: boolean
Title:
Forecast using a cycle
Read Only:true
Maximum Length:1
Indicates if the forecast will be incremented on a cycle of intervals or not. This value is read-only. -
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
MeterDailyRate: number
Title:
Meter Daily Rate
Value for the daily utilization rate that will be incremented to calculate the forecast due dates into the future. This value is read-only. -
MeterId: integer
(int64)
Title:
Meter ID
Value that uniquely identifies the asset meter for the forecasted due date. This value is read-only. -
MeterName: string
Title:
Meter Name
Read Only:true
Maximum Length:120
Name of the asset meter for the forecasted due date. This value is read-only. -
NextWorkOrderOnlyFlag: boolean
Title:
Next work order only
Maximum Length:1
Indicates if the next work orders are created or not. If the value is equal to Y, then the next work order is only created after the completion of the last due work order in the forecast. This value is read-only. -
NumberOfIntervals: number
Title:
Number of Intervals per Cycle
Read Only:true
Number of intervals for a forecast that is incremented on a cycle of intervals. This value is read-only. -
RequirementEndDate: string
(date)
Title:
End Date
Read Only:true
Date when a work requirement will no longer be considered by the maintenance forecast. This value is read-only. -
RequirementId: integer
(int64)
Title:
Work Requirement
Value that uniquely identifies a work requirement in a maintenance program. This value is read-only. -
RequirementName: string
Title:
Work Requirement Name
Read Only:true
Maximum Length:120
Name that uniquely identifies a work requirement across all maintenance programs. This value is read-only. -
RequirementReference: string
Title:
Requirement Reference
Read Only:true
Maximum Length:80
Reference for a work requirement in a maintenance program. This value is read-only. -
RequirementStartDate: string
(date)
Title:
Start Date
Read Only:true
Date when a work requirement will be considered by the maintenance forecast. This value is read-only. -
RequirementType: string
Title:
Type
Read Only:true
Maximum Length:80
Meaning of the type of a work requirement. Values are either Item or Asset. This value is read-only. -
RequirementTypeCode: string
Title:
Type
Read Only:true
Maximum Length:30
Abbreviation that uniquely identifies the type of a work requirement. Values are either ORA_ITEM or ORA_ASSET. This value is read-only. -
SuppressFlag: boolean
Title:
Suppress
Read Only:true
Maximum Length:1
Value that indicates whether the work definition requirement is suppressed for the asset in the creation of the forecast. This value is read-only. -
WorkDefinitionCode: string
Title:
Code
Read Only:true
Maximum Length:30
Work definition code used in the generated forecast. This value is read-only. -
WorkDefinitionDescription: string
Title:
Description
Read Only:true
Maximum Length:240
Work definition description used in the generated forecast. This value is read-only. -
WorkDefinitionId: integer
(int64)
Title:
Work Definition
Read Only:true
Work definition identifier used in the generated forecast. This value is read-only. -
WorkDefinitionName: string
Title:
Name
Read Only:true
Maximum Length:120
Work definition name used in the generated forecast. This value is read-only. -
WorkDefinitionVersion: string
Title:
Version
Read Only:true
Maximum Length:10
Work definition version used in the generated forecast. This value is read-only.
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.
Links
- forecastLines
-
Parameters:
- ForecastId:
$request.path.ForecastId
The Maintenance Forecast Line resource manages the work definition details for forecast due dates in a maintenance program. - ForecastId:
Examples
This example describes how to update the requested work order start date and organization for a maintenance forecast due date. The requested organization can only be defined if the maintenance program is enabled for assets across organizations.
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/maintenanceForecasts/ForecastId"
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.
{ "RequestedWoStartDate": "2023-08-10", "RequestedWoOrganizationCode": "OPS_ORG_B" }
Example Response Body
The following example includes the contents of the response body in JSON format:
{ "ForecastId": 20354, "ForecastStatusCode": "ORA_PLANNED", "ForecastStatus": "Planned", "ProgramOrganizationId": 300100113363336, "ProgramOrganizationCode": "OPS_ORG_A", "ProgramId": 300100583272981, "ProgramCode": "MAINTENANCE_PROGRAM", "ProgramName": "MAINTENANCE_PROGRAM", "ProgramTypeCode": "ORA_MAINTENANCE", "ProgramType": "Maintenance", "ProgramSubTypeCode": "Subtype 1", "ProgramSubType": "Subtype 1 M", "ProgramReference": "PREF123", "GlobalAssetsFlag": true, "RequirementName": "ACO_WR_1", "ItemId": 300100581367310, "ItemNumber": "ALM-MX-ITEM-001", "AssetId": 300100581367872, "AssetNumber": "ALM_ASSET_002", "AssetDescription": "ALM-MX-ITEM-001-DESC", "AssetSerialNumber": "ALM_ASSET_002", "AssetOperatingOrgId": 300100113363336, "AssetOperatingOrgCode": "OPS_ORG_A", "AssetLocationCode": "ORA_UNKNOWN", "AssetLocation": "Unknown", "RootAssetId": 300100581367872, "RootAssetNumber": "ALM_ASSET_002", "ForecastDueDate": "2023-08-08", "SkipDueDateFlag": false, "ForecastOrganizationId": 300100113363336, "ForecastOrganizationCode": "OPS_ORG_A", "RequestedWoStartDate": "2023-08-08", "RequestedWoOrganizationId": 300100113363336, "RequestedWoOrganizationCode": "OPS_ORG_B", "WorkOrderId": null, "WorkOrderNumber": null, "WorkOrderOrganizationId": null, "WorkOrderOrganizationCode": null, "WorkOrderStartDate": null, "WorkOrderStatusCode": null, "WorkOrderStatus": null, "WarrantyRepairFlag": false, "CreatedBy": "MNT_QA", "CreationDate": "2023-08-01T20:46:40+00:00", "LastUpdatedBy": "MNT_QA", "LastUpdateDate": "2023-08-01T20:46:40+00:00", "links": [ { "rel": "self", "href": "https://servername/fscmRestApi/resources/version/maintenanceForecasts/20354", "name": "maintenanceForecasts", "kind": "item", "properties": { "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178" } }, { "rel": "canonical", "href": "https://servername/fscmRestApi/resources/version/maintenanceForecasts/20354", "name": "maintenanceForecasts", "kind": "item" }, { "rel": "child", "href": "https://servername/fscmRestApi/resources/version/maintenanceForecasts/20354/child/forecastLines", "name": "forecastLines", "kind": "collection" } ] }