Update one forecast due date
/fscmRestApi/resources/11.13.18.05/maintenanceForecasts/{ForecastId}
Request
-
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.
-
Metadata-Context: string
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: string
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.
- application/json
object-
forecastLines: array
Forecast Lines
Title:
Forecast LinesThe Maintenance Forecast Line resource manages the work definition details for forecast due dates in a maintenance program. -
ForecastOrganizationId: integer
(int64)
Title:
Forecast Organization IDValue that uniquely identifies the organization for the forecasted due date of an asset. This value is read-only. -
RequestedWoOrganizationId: integer
(int64)
Title:
Requested Organization IdValue 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 DatePlanned Start Date for the work order. If defined, the value will be used instead of the forecast due date. -
SkipDueDateFlag: boolean
Title:
Skip Due DateMaximum Length:1Indicates 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 IDValue that uniquely identifies a maintenance work order. This value is read-only.
arrayForecast Linesobject-
CalendarPatternId: integer
(int64)
Title:
Calendar Pattern IDValue that uniquely identifies the calendar pattern for the forecasted due date. This value is read-only. -
DayIntervalValue: number
Title:
Day IntervalValue 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 IntervalCycle interval in which the forecast is generated. This value is read-only. -
DueAtMeterReading: number
Title:
Due at Meter ReadingValue for the meter on the forecast due date. This value is read-only. -
ForecastDueDate: string
(date)
Title:
Due DateDate on which the forecast is due. This value is read-only. -
MeterDailyRate: number
Title:
Meter Daily RateValue 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 IDValue that uniquely identifies the asset meter for the forecasted due date. This value is read-only. -
NextWorkOrderOnlyFlag: boolean
Title:
Next work order onlyMaximum Length:1Indicates 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 RequirementValue that uniquely identifies a work requirement in a maintenance program. This value is read-only.
Response
- application/json
Default Response
-
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.
object-
AssetDescription: string
Title:
Asset DescriptionRead Only:trueMaximum Length:240Description of the asset. This value is read-only. -
AssetId: integer
(int64)
Title:
Asset IDRead Only:trueValue that uniquely identifies an asset. This value is read-only. -
AssetLocation: string
Title:
Asset LocationRead Only:trueMaximum Length:80Name of the location of an asset. This value is read-only. -
AssetLocationCode: string
Title:
Location Organization CodeRead Only:trueMaximum Length:80Abbreviation that uniquely identifies the location of an asset. This value is read-only. -
AssetNumber: string
Title:
Asset NumberRead Only:trueMaximum Length:80Number that uniquely identifies an asset. This value is read-only. -
AssetOperatingOrgCode: string
Title:
Operating OrganizationRead Only:trueMaximum Length:18Abbreviation that uniquely identifies the operating organization for an asset. This value is read-only. -
AssetOperatingOrgId: integer
(int64)
Title:
Operating Organization IDRead Only:trueValue that uniquely identifies the operating organization for an asset. This value is read-only. -
AssetSerialNumber: string
Title:
Serial NumberRead Only:trueMaximum Length:80Serial number of the asset. This value is read-only. -
CreatedBy: string
Title:
Created ByRead Only:trueMaximum Length:64Login username of the user who created the record. This value is read-only. -
CreationDate: string
(date-time)
Title:
Creation DateRead Only:trueDate when the record was created. This value is read-only. -
ForecastDueDate: string
(date)
Title:
Due DateRead Only:trueDate on which the forecast is due. This value is read-only. -
ForecastId: integer
(int64)
Title:
Forecast IdRead Only:trueValue 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 LinesThe Maintenance Forecast Line resource manages the work definition details for forecast due dates in a maintenance program. -
ForecastOrganizationCode: string
Title:
Forecast OrganizationRead Only:trueMaximum Length:18Abbreviation that uniquely identifies the organization for the forecasted due date of an asset This value is read-only. -
ForecastOrganizationId: integer
(int64)
Title:
Forecast Organization IDValue that uniquely identifies the organization for the forecasted due date of an asset. This value is read-only. -
ForecastStatus: string
Title:
Forecast StatusRead Only:trueMaximum Length:255Meaning of the status of a forecast line. This value is read-only. -
ForecastStatusCode: string
Title:
Forecast Status CodeRead Only:trueMaximum Length:255Abbreviation 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 organizationsRead Only:trueMaximum Length:1Indicates if the program will support assets that operate in other organizations. This value is read-only. -
ItemId: integer
(int64)
Title:
Item IDRead Only:trueValue that uniquely identifies an inventory item for an asset. This value is read-only. -
ItemNumber: string
Title:
Item NumberRead Only:trueMaximum Length:300Number for an inventory item. This value is read-only. -
LastUpdateDate: string
(date-time)
Title:
Last Update DateRead Only:trueDate when the record was updated. This value is read-only. -
LastUpdatedBy: string
Title:
Last Updated ByRead Only:trueMaximum Length:64Login username of the user who updated the record. This value is read-only. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
MultipleForecastLinesFlag: boolean
Title:
Work Requirement NameRead Only:trueMaximum Length:255Indicates if the forecast due date has more than one corresponding forecast line with work definition details. This value is read-only. -
ProgramCode: string
Title:
CodeRead Only:trueMaximum Length:30Abbreviation that uniquely identifies the maintenance program. This value is read-only. -
ProgramId: integer
(int64)
Title:
Program IdRead Only:trueValue that uniquely identifies the maintenance program. This value is read-only. -
ProgramName: string
Title:
Program NameRead Only:trueMaximum Length:120Name of the maintenance program. This value is read-only. -
ProgramOrganizationCode: string
Title:
Program OrganizationRead Only:trueMaximum Length:18Abbreviation 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 IDRead Only:trueValue that uniquely identifies the inventory organization of the maintenance program. This value is read-only. -
ProgramReference: string
Title:
Program ReferenceRead Only:trueMaximum Length:80Reference for a maintenance program. This value is read-only. -
ProgramSubType: string
Title:
Program SubtypeRead Only:trueMaximum Length:80Meaning of a maintenance program subtype. This value is read-only. -
ProgramSubTypeCode: string
Title:
Program Subtype CodeRead Only:trueMaximum Length:30Abbreviation 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 TypeRead Only:trueMaximum Length:80Meaning of a maintenance program type. This value is read-only. -
ProgramTypeCode: string
Title:
Program Type CodeRead Only:trueMaximum Length:30Abbreviation 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 OrganizationRead Only:trueMaximum Length:18Abbreviation 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 IdValue 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 DatePlanned Start Date for the work order. If defined, the value will be used instead of the forecast due date. -
RequirementName: string
Read Only:
trueMaximum Length:255Name that uniquely identifies a work requirement across all maintenance programs. This value is read-only. -
RootAssetId: integer
(int64)
Title:
Root Asset IDRead Only:trueValue that uniquely identifies the top asset in a physical hierarchy of assets. This value is read-only. -
RootAssetNumber: string
Title:
Root Asset NumberRead Only:trueMaximum Length:80Number that uniquely identifies the top asset in a physical hierarchy of assets. This value is read-only. -
SkipDueDateFlag: boolean
Title:
Skip Due DateMaximum Length:1Indicates if the due date will be skipped and a work order will not be created. This value is read-only. -
WarrantyRepairFlag: boolean
Title:
Warranty RepairRead Only:trueMaximum Length:1Value that indicates if the work order is a warranty repair. This value is read-only. -
WorkOrderId: integer
(int64)
Title:
Work Order IDValue that uniquely identifies a maintenance work order. This value is read-only. -
WorkOrderNumber: string
Title:
Work Order NumberRead Only:trueMaximum Length:120Number of a maintenance work order. This value is read-only. -
WorkOrderOrganizationCode: string
Title:
Work Order OrganizationRead Only:trueMaximum Length:18Abbreviation 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 IdRead Only:trueValue that uniquely identifies the inventory organization for the work order. This value is read-only. -
WorkOrderStartDate: string
(date-time)
Title:
Work Order Planned Start DateRead Only:trueDescription of a maintenance work order. This value is read-only. This value is read-only. -
WorkOrderStatus: string
Title:
Work Order StatusRead Only:trueMaximum Length:120Name of the status of a Work Order. This value is read-only. -
WorkOrderStatusCode: string
Title:
Work Order Status CodeRead Only:trueMaximum Length:30Abbreviation for the status of a Work Order. This value is read-only.
arrayForecast LinesarrayLinksobject-
CalendarPattern: string
Title:
Calendar PatternRead Only:trueMaximum Length:120Name of the calendar pattern for the forecasted due date. This value is read-only. -
CalendarPatternId: integer
(int64)
Title:
Calendar Pattern IDValue that uniquely identifies the calendar pattern for the forecasted due date. This value is read-only. -
CreateWoOption: string
Title:
Create Work Orders OptionRead Only:trueMaximum Length:80Meaning 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 CodeRead Only:trueMaximum Length:30Default Value:ORA_AUTOMATICAbbreviation 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 IntervalValue 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 IntervalCycle interval in which the forecast is generated. This value is read-only. -
DueAtMeterReading: number
Title:
Due at Meter ReadingValue for the meter on the forecast due date. This value is read-only. -
ForecastDueDate: string
(date)
Title:
Due DateDate on which the forecast is due. This value is read-only. -
ForecastId: integer
(int64)
Title:
Forecast IdRead Only:trueValue 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 IntervalRead Only:trueMaximum Length:255Describes 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:
trueValue 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 MethodRead Only:trueMaximum Length:255Describes 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 MethodRead Only:trueMaximum Length:255Meaning 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 CodeRead Only:trueMaximum Length:255Abbreviation 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 cycleRead Only:trueMaximum Length:1Indicates if the forecast will be incremented on a cycle of intervals or not. This value is read-only. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
MeterDailyRate: number
Title:
Meter Daily RateValue 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 IDValue that uniquely identifies the asset meter for the forecasted due date. This value is read-only. -
MeterName: string
Title:
Meter NameRead Only:trueMaximum Length:120Name of the asset meter for the forecasted due date. This value is read-only. -
NextWorkOrderOnlyFlag: boolean
Title:
Next work order onlyMaximum Length:1Indicates 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 CycleRead Only:trueNumber of intervals for a forecast that is incremented on a cycle of intervals. This value is read-only. -
RequirementEndDate: string
(date)
Title:
End DateRead Only:trueDate when a work requirement will no longer be considered by the maintenance forecast. This value is read-only. -
RequirementId: integer
(int64)
Title:
Work RequirementValue that uniquely identifies a work requirement in a maintenance program. This value is read-only. -
RequirementName: string
Title:
Work Requirement NameRead Only:trueMaximum Length:120Name that uniquely identifies a work requirement across all maintenance programs. This value is read-only. -
RequirementReference: string
Title:
Requirement ReferenceRead Only:trueMaximum Length:80Reference for a work requirement in a maintenance program. This value is read-only. -
RequirementStartDate: string
(date)
Title:
Start DateRead Only:trueDate when a work requirement will be considered by the maintenance forecast. This value is read-only. -
RequirementType: string
Title:
TypeRead Only:trueMaximum Length:80Meaning of the type of a work requirement. Values are either Item or Asset. This value is read-only. -
RequirementTypeCode: string
Title:
TypeRead Only:trueMaximum Length:30Abbreviation 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:
SuppressRead Only:trueMaximum Length:1Value 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:
CodeRead Only:trueMaximum Length:30Work definition code used in the generated forecast. This value is read-only. -
WorkDefinitionDescription: string
Title:
DescriptionRead Only:trueMaximum Length:240Work definition description used in the generated forecast. This value is read-only. -
WorkDefinitionId: integer
(int64)
Title:
Work DefinitionRead Only:trueWork definition identifier used in the generated forecast. This value is read-only. -
WorkDefinitionName: string
Title:
NameRead Only:trueMaximum Length:120Work definition name used in the generated forecast. This value is read-only. -
WorkDefinitionVersion: string
Title:
VersionRead Only:trueMaximum Length:10Work definition version used in the generated forecast. This value is read-only.
arrayLinksobject-
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.
object-
changeIndicator: string
Change indicator or the ETag value of the resource instance.
- 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
{
"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"
}
]
}