Create asset failure instances
post
/fscmRestApi/resources/11.13.18.05/assetFailureEvents/{FailureEventId}/child/failureInstances
Request
Path Parameters
-
FailureEventId(required): integer(int64)
The value of this parameter could be a hash of the key that is used to uniquely identify the resource item. The client should not generate the hash key value. Instead, the client should query on the collection resource with a filter to navigate to a specific resource item. For example: products?q=InventoryItemId=
Header Parameters
-
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.
-
Upsert-Mode: string
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
- application/json
Root Schema : schema
Type:
Show Source
object-
AssetCriticalityName: string
Title:
Asset Criticality NameMaximum Length:255Name that uniquely identifies the criticality of the asset. The name is optional but if defined must be unique. -
CauseCode: string
Title:
Cause CodeAbbreviation that uniquely identifies the cause of failure. The cause code isn't required but if entered must be a valid code. The code must use uppercase letters and be alphanumeric. -
CauseCodeId: integer
(int64)
Title:
Cause Code IDUnique identifier for the cause Code. -
FailedAssetId: integer
(int64)
Title:
Failed Asset IDValue that uniquely identifies the asset that failed. This is generally the asset on the work order. The value is system generated and read-only. This attribute is optional. -
FailedComponentAssetNumber: string
Title:
Failed Asset NumberDescription of the asset-tracked component item that failed. This optional attribute provides a brief user-defined text providing information on the item's use and characteristics. -
FailedComponentItemId: integer
(int64)
Title:
Failed Item IDUnique identifier for the item that failed. This is generally the item on the work order. This attribute is optional. -
FailedComponentItemNumber: string
Title:
Failed Item NumberName that uniquely identifies the component that failed. This attribute is optional. -
FailedComponentSerialNumber: string
Title:
Failed Serial NumberMaximum Length:80Serial number that uniquely identifies the component that failed. This attribute is optional. This attribute is only valid if the FailedItemId is a serial controlled item. -
FailureCode: string
Title:
Failure CodeAbbreviation that uniquely identifies the failure mode. The failure code isn't required but if entered must be a valid code. The code must use uppercase letters and it can be alphanumeric. -
FailureCodeId: integer
(int64)
Title:
Failure Code IDUnique identifier for the failure Code. -
FailureComments: string
Title:
Failure CommentsMaximum Length:2000Notes captured with free-text details about the causes and root cause of failure, or any other relevant data. This value is optional. -
FailureEventId(required): integer
(int64)
Title:
Failure Event IDValue that uniquely identifies the failure event. The value is system generated and read-only. -
FailureSeverityCode: string
Title:
Severity CodeMaximum Length:30Abbreviation that uniquely identifies the severity of failure. The severity code isn't required but if entered must be a valid code. The code must be alphanumeric. -
FailureSeverityName: string
Title:
Severity NameMaximum Length:255Name that uniquely identifies the severity of the failure. The name is optional but if defined must be unique. -
FailureStatusCode: string
Title:
Status CodeMaximum Length:30Abbreviation that uniquely identifies the status of the failure. The status code isn't required but if entered must be a valid code. The code must be alphanumeric. -
FailureStatusName: string
Title:
Status NameMaximum Length:255Name that uniquely identifies the status of the failure. The name is optional but if defined must be unique. -
OperationSequenceNumber: number
Title:
Operation SequenceNumber that identifies the sequence of the operation within a work order. The operation sequence is required attribute for a work order operation. It must be a positive integer and unique within a work order. -
ResolutionCode: string
Title:
Resolution CodeAbbreviation that uniquely identifies the resolution of the failure. The resolution code isn't required but if entered must be a valid code. The code must use uppercase letters and it can be alphanumeric. -
ResolutionCodeId: number
Title:
Resolution Code IDUnique identifier for the resolution of the failure. -
rootCauses: array
Failure Root Causes
Title:
Failure Root CausesThe Failure Root Causes resource manages the failure root causes. A failure root cause defines the underlying, originating causal factors that led to the occurrence of an asset failure event. Root causes represent the core causal factors, such as process, training, environment or design that are determined through a root cause analysis. In contrast, a cause code represents a technician-observed failure mechanism, such as rust, leak, rupture or shearing. More than one failure root cause may underlay a single failure instance. -
WoOperationId: integer
(int64)
Value that uniquely identifies the work order operation associated with the failure instance.
Nested Schema : Failure Root Causes
Type:
arrayTitle:
Failure Root CausesThe Failure Root Causes resource manages the failure root causes. A failure root cause defines the underlying, originating causal factors that led to the occurrence of an asset failure event. Root causes represent the core causal factors, such as process, training, environment or design that are determined through a root cause analysis. In contrast, a cause code represents a technician-observed failure mechanism, such as rust, leak, rupture or shearing. More than one failure root cause may underlay a single failure instance.
Show Source
Nested Schema : schema
Type:
Show Source
object-
CauseCodeId: integer
(int64)
Title:
Cause Code IDValue that uniquely identifies the root cause code. The value is system generated and read-only. -
FailureInstanceId: integer
(int64)
Title:
Failure Instance IDValue that uniquely identifies the failure instance. The value is system generated and read-only. -
RootCauseCode: string
Title:
Cause CodeAbbreviation that uniquely identifies the root cause of failure. The root cause code is required and if entered must be a valid code. The code must use uppercase letters and alphanumeric. -
RootCauseComments: string
Title:
CommentsMaximum Length:2000Notes captured with free-text details about the causes and root cause of failure, or any other relevant data. This value is optional.
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 : assetFailureEvents-failureInstances-item-response
Type:
Show Source
object-
AssetCriticalityCode: string
Title:
Asset Criticality CodeRead Only:trueMaximum Length:30Abbreviation that uniquely identifies the asset criticality. The code isn't required but if entered must be a valid code. The code must use uppercase letters and be alphanumeric. -
AssetCriticalityName: string
Title:
Asset Criticality NameMaximum Length:255Name that uniquely identifies the criticality of the asset. The name is optional but if defined must be unique. -
AssetDescription: string
Title:
Asset DescriptionRead Only:trueMaximum Length:240Description of the asset. This optional attribute provides a brief user-defined text providing information on the asset's use and characteristics. -
AssetDownFlag: boolean
Title:
Asset DownRead Only:trueMaximum Length:1Contains one of the following values: true or false. If true, then the asset is deemed nonfunctional and downtime is accrued for that asset. If false, then the asset is still considered functional and no downtime is accrued for that asset. For example, an asset may have redundant systems that allow it to remain functional despite a failure. The default value is true. The response payload translates Y to true and N to false. -
AssetId: integer
(int64)
Title:
Asset IDRead Only:trueValue that uniquely identifies the asset that failed. This is generally the asset on the work order. The value is system generated and read-only. This attribute is optional. -
AssetNumber: string
Title:
Asset NumberRead Only:trueMaximum Length:80Name that uniquely identifies the asset-tracked component that failed. This attribute is optional. -
AvailableDate: string
(date-time)
Title:
Available DateRead Only:trueDate and time when a failed asset is determined to be available to use again after failure. The available date must occur after the failure date. This attribute is optional. If you don't provide a value, the application uses the work order completion date. -
CauseCategoryCode: string
Title:
Cause Category CodeRead Only:trueMaximum Length:30Abbreviation that uniquely identifies the category of failure cause. The code must use uppercase letters and it can be alphanumeric. -
CauseCategoryName: string
Title:
Cause Category NameRead Only:trueName of the failure cause category. The name is optional but if defined must be unique. -
CauseCode: string
Title:
Cause CodeAbbreviation that uniquely identifies the cause of failure. The cause code isn't required but if entered must be a valid code. The code must use uppercase letters and be alphanumeric. -
CauseCodeId: integer
(int64)
Title:
Cause Code IDUnique identifier for the cause Code. -
CauseDescription: string
Title:
Cause DescriptionRead Only:trueMaximum Length:540Description of the cause code. This optional attribute provides a brief user-defined text providing information on the code's use and characteristics. -
CauseName: string
Title:
Cause NameRead Only:trueMaximum Length:240Name of the cause code. The cause code name is optional but if defined must be unique. -
CompletionDate: string
(date-time)
Title:
WO Completion DateRead Only:trueDate and time when the work order for resolving the failure was completed. The work order completion date must occur after the failure date. This attribute is populated only in cases where failure records are imported from an external system, and in such cases is mandatory. -
CreatedBy: string
Read Only:
trueMaximum Length:64User who created the asset failure event instance. The application automatically sets this value during creation. This attribute is read-only. -
CreationDate: string
(date-time)
Read Only:
trueDate when the asset failure event instance is created. The application automatically sets this value during creation. This attribute is read-only. -
DaysBetweenFailure: number
Title:
TBF DaysRead Only:trueThe number of calendar days between the current failure date and the prior available date. If there was no prior failure, then the number of calendar days between the current failure date and the asset in-service date. This attribute is populated only in cases where failure records are imported from an external system, and in such cases is mandatory. -
FailedAssetId: integer
(int64)
Title:
Failed Asset IDValue that uniquely identifies the asset that failed. This is generally the asset on the work order. The value is system generated and read-only. This attribute is optional. -
FailedComponentAssetDescription: string
Title:
Failed Asset DescriptionRead Only:trueMaximum Length:240Description of the asset-tracked component item that failed. This optional attribute provides a brief user-defined text providing information on the item's use and characteristics. -
FailedComponentAssetNumber: string
Title:
Failed Asset NumberDescription of the asset-tracked component item that failed. This optional attribute provides a brief user-defined text providing information on the item's use and characteristics. -
FailedComponentItemDescription: string
Title:
Failed Item DescriptionRead Only:trueMaximum Length:240Description of the component item that failed. This optional attribute provides a brief user-defined text providing information on the item's use and characteristics. -
FailedComponentItemId: integer
(int64)
Title:
Failed Item IDUnique identifier for the item that failed. This is generally the item on the work order. This attribute is optional. -
FailedComponentItemLongDescription: string
Title:
Failed Item Long DescriptionRead Only:trueMaximum Length:4000Long description of the component item that failed. This optional attribute provides a more detailed user-defined text providing information on the item's use and characteristics. -
FailedComponentItemNumber: string
Title:
Failed Item NumberName that uniquely identifies the component that failed. This attribute is optional. -
FailedComponentSerialNumber: string
Title:
Failed Serial NumberMaximum Length:80Serial number that uniquely identifies the component that failed. This attribute is optional. This attribute is only valid if the FailedItemId is a serial controlled item. -
FailureCategoryCode: string
Title:
Failure Category CodeRead Only:trueMaximum Length:30Abbreviation that uniquely identifies the category of failure. The code must use uppercase letters and it can be alphanumeric. -
FailureCategoryName: string
Title:
Failure Category NameRead Only:trueName of the failure category. The name is optional but if defined must be unique. -
FailureCode: string
Title:
Failure CodeAbbreviation that uniquely identifies the failure mode. The failure code isn't required but if entered must be a valid code. The code must use uppercase letters and it can be alphanumeric. -
FailureCodeId: integer
(int64)
Title:
Failure Code IDUnique identifier for the failure Code. -
FailureComments: string
Title:
Failure CommentsMaximum Length:2000Notes captured with free-text details about the causes and root cause of failure, or any other relevant data. This value is optional. -
FailureDate: string
(date-time)
Title:
Failure DateRead Only:trueDate and time when an asset failed. The failed date must occur before the failure date. This attribute is mandatory. -
FailureDescription: string
Title:
Failure DescriptionRead Only:trueMaximum Length:540Description of the failure code. This optional attribute provides a brief user-defined text providing information on the code's use and characteristics. -
FailureEventId: integer
(int64)
Title:
Failure Event IDValue that uniquely identifies the failure event. The value is system generated and read-only. -
FailureInstanceId: integer
(int64)
Title:
Failure Instance IDRead Only:trueValue that uniquely identifies the failure instance. The value is system generated and read-only. -
FailureName: string
Title:
Failure NameRead Only:trueMaximum Length:240Name of the failure code. The failure code name is optional but if defined must be unique. -
FailureSeverityCode: string
Title:
Severity CodeMaximum Length:30Abbreviation that uniquely identifies the severity of failure. The severity code isn't required but if entered must be a valid code. The code must be alphanumeric. -
FailureSeverityName: string
Title:
Severity NameMaximum Length:255Name that uniquely identifies the severity of the failure. The name is optional but if defined must be unique. -
FailureStatusCode: string
Title:
Status CodeMaximum Length:30Abbreviation that uniquely identifies the status of the failure. The status code isn't required but if entered must be a valid code. The code must be alphanumeric. -
FailureStatusName: string
Title:
Status NameMaximum Length:255Name that uniquely identifies the status of the failure. The name is optional but if defined must be unique. -
InventoryItemId: integer
(int64)
Title:
Item NumberRead Only:trueUnique identifier for the item that failed. This is generally the item on the work order. This attribute is optional. -
ItemCategoryCode: string
Read Only:
trueMaximum Length:255Abbreviation that uniquely identifies the item category to which the failed component is assigned. The code must be alphanumeric and must validate against the catalog assigned to the profile option ORA_CSE_ITEM_CATALOG. -
ItemCategoryId: integer
(int64)
Read Only:
trueValue that uniquely identifies the item category to which the failed component is assigned. The value is system generated and read-only. -
ItemCategoryName: string
Read Only:
trueMaximum Length:255Name of the item category to which the failed component is assigned. The item category name is optional but if defined must be unique. -
ItemDescription: string
Title:
Item DescriptionRead Only:trueMaximum Length:240Description of the item. This optional attribute provides a brief user-defined text providing information on the item's use and characteristics. -
ItemLongDescription: string
Title:
Item Long DescriptionRead Only:trueMaximum Length:4000Long description of the item. This optional attribute provides a more detailed user-defined text providing information on the item's use and characteristics. -
ItemNumber: string
Title:
Item NumberRead Only:trueMaximum Length:300Name that uniquely identifies the item that failed. This is generally the item on the work order. This attribute is optional. -
ItemOrganizationCode: string
Read Only:
trueMaximum Length:18Value that uniquely identifies the item Organization. This is generally the item on the work order. -
ItemOrganizationId: integer
(int64)
Title:
OrganizationRead Only:trueUnique identifier for the item Organization. This is generally the item on the work order. -
LastUpdateDate: string
(date-time)
Read Only:
trueDate when the user most recently updated the asset failure event instance. The application automatically sets this value during creation. This attribute is read-only. -
LastUpdatedBy: string
Read Only:
trueMaximum Length:64User who most recently updated the asset failure event instance. The application assigns a value to this attribute during creation. This attribute is read-only. -
LastUpdateLogin: string
Read Only:
trueMaximum Length:32Login that the user used when updating the asset failure event instance. The application assigns a value to this attribute during creation. This attribute is read-only. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
MeterUnitOfMeasure: string
Title:
TBF Meter Units UOM CodeRead Only:trueMaximum Length:3MeterUnitOfMeasure must be a valid Meter UOM Code lookup. This attribute is populated only in cases where failure records are imported from an external system, an in such cases is optional. -
MeterUnitsBetweenFailure: number
Title:
TBF Meter UnitsRead Only:trueThe number of meter units between the current failure date and the prior available date. If there was no prior failure, then the number of meter units between the current failure date and the asset in-service date. The unit of measure for the meter units is defined by the attribute MeterUnitOfMeasure. This attribute is populated only in cases where failure records are imported from an external system, and in such cases is optional. -
OperationName: string
Title:
NameRead Only:trueMaximum Length:120Name that identifies the operation within a work order. -
OperationSequenceNumber: number
Title:
Operation SequenceNumber that identifies the sequence of the operation within a work order. The operation sequence is required attribute for a work order operation. It must be a positive integer and unique within a work order. -
RepairCost: number
Title:
Repair CostRead Only:trueThe total cost to repair the asset. This attribute is populated only in cases where failure records are imported from an external system, and in such cases is mandatory. -
ResolutionCategoryCode: string
Title:
Resolution Category CodeRead Only:trueMaximum Length:30Abbreviation that uniquely identifies the category of resolution. The code must use uppercase letters and it can be alphanumeric. -
ResolutionCategoryName: string
Title:
Resolution Category NameRead Only:trueName of the resolution category. The name is optional but if defined must be unique. -
ResolutionCode: string
Title:
Resolution CodeAbbreviation that uniquely identifies the resolution of the failure. The resolution code isn't required but if entered must be a valid code. The code must use uppercase letters and it can be alphanumeric. -
ResolutionCodeId: number
Title:
Resolution Code IDUnique identifier for the resolution of the failure. -
ResolutionDescription: string
Title:
Resolution DescriptionRead Only:trueMaximum Length:540Description of the resolution code. This optional attribute provides a brief user-defined text providing information on the code's use and characteristics. -
ResolutionName: string
Title:
Resolution NameRead Only:trueMaximum Length:240Name of the resolution code. The resolution code name is optional but if defined must be unique. -
rootCauses: array
Failure Root Causes
Title:
Failure Root CausesThe Failure Root Causes resource manages the failure root causes. A failure root cause defines the underlying, originating causal factors that led to the occurrence of an asset failure event. Root causes represent the core causal factors, such as process, training, environment or design that are determined through a root cause analysis. In contrast, a cause code represents a technician-observed failure mechanism, such as rust, leak, rupture or shearing. More than one failure root cause may underlay a single failure instance. -
SourceDocumentId: string
Title:
Source Document IDRead Only:trueMaximum Length:36Value that uniquely identifies the source document. The value is system generated and read-only. -
SourceDocumentTypeCode: string
Title:
Source Doc Type CodeRead Only:trueMaximum Length:30Abbreviation that uniquely identifies the source document type. The source document type code is required only for failure records imported from an external system. The code must be alphanumeric and must validate against FND_lookup ORA_CSE_DOCUMENT_TYPE. -
SourceSystemId: integer
(int64)
Title:
Source Application IDRead Only:trueValue that uniquely identifies the source system. The value is system generated and read-only. -
SourceSystemType: string
Title:
Source Application TypeRead Only:trueMaximum Length:30Contains one of the following values: ORA_INTERNAL (failure records generated from the Failure Capture UI) or ORA_EXTERNAL (failure records from another system, often historical failure records). If ORA_INTERNAL, then either work order number or work order ID is mandatory, and values passed for AssetID will be ignored (Asset ID will be queried from the work order ID). If ORA_EXTERNAL, then assetID, sourceSystemType, sourceDocTypeCode, and sourceDocId are mandatory. sourceSystemId must validate against hz_orig_systems_vl.ORIG_SYSTEM_ID. sourceDocTypeCode must validate against fnd_lookup ORA_CSE_DOCUMENT_TYPE. Values passed for trackingObjectCode, work order number, and work order ID will be ignored. The default value is ORA_EXTERNAL. -
WoOperationId: integer
(int64)
Value that uniquely identifies the work order operation associated with the failure instance.
-
WorkOrderDescription: string
Title:
Work Order DescriptionRead Only:trueMaximum Length:240Description of the work order. This optional attribute provides a brief user-defined text providing information on the work order's use and characteristics. -
WorkOrderId: integer
(int64)
Title:
Work Order IDRead Only:trueValue that uniquely identifies the work order. The value is system generated and read-only. -
WorkOrderNumber: string
Title:
Work Order NumberRead Only:trueMaximum Length:120Number the uniquely identifies the work order within an organization.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : Failure Root Causes
Type:
arrayTitle:
Failure Root CausesThe Failure Root Causes resource manages the failure root causes. A failure root cause defines the underlying, originating causal factors that led to the occurrence of an asset failure event. Root causes represent the core causal factors, such as process, training, environment or design that are determined through a root cause analysis. In contrast, a cause code represents a technician-observed failure mechanism, such as rust, leak, rupture or shearing. More than one failure root cause may underlay a single failure 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 : assetFailureEvents-failureInstances-rootCauses-item-response
Type:
Show Source
object-
CauseCodeId: integer
(int64)
Title:
Cause Code IDValue that uniquely identifies the root cause code. The value is system generated and read-only. -
CreatedBy: string
Read Only:
trueMaximum Length:64User who created the failure root cause. The application automatically sets this value during creation. This attribute is read-only. -
CreationDate: string
(date-time)
Read Only:
trueDate when the failure root cause is created. The application automatically sets this value during creation. This attribute is read-only. -
FailureInstanceId: integer
(int64)
Title:
Failure Instance IDValue that uniquely identifies the failure instance. The value is system generated and read-only. -
LastUpdateDate: string
(date-time)
Read Only:
trueDate when the user most recently updated the failure root cause. The application automatically sets this value during creation. This attribute is read-only. -
LastUpdatedBy: string
Read Only:
trueMaximum Length:64User who most recently updated the failure root cause. The application assigns a value to this attribute during creation. This attribute is read-only. -
LastUpdateLogin: string
Read Only:
trueMaximum Length:32Login that the user used when updating the failure root cause. The application assigns a value to this attribute during creation. This attribute is read-only. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
RootCauseCategoryCode: string
Title:
Cause Category CodeRead Only:trueMaximum Length:30Number that identifies the work order. This number is unique in the organization. The user can manually assign the number when creating the work order, or allow the application to create a unique number from the numbering scheme that the following Plant parameters define: Work Order Prefix or Work Order Starting Number. -
RootCauseCategoryName: string
Title:
Cause Category NameRead Only:trueMaximum Length:255Number that identifies the work order. This number is unique in the organization. The user can manually assign the number when creating the work order, or allow the application to create a unique number from the numbering scheme that the following Plant parameters define: Work Order Prefix or Work Order Starting Number. -
RootCauseCode: string
Title:
Cause CodeAbbreviation that uniquely identifies the root cause of failure. The root cause code is required and if entered must be a valid code. The code must use uppercase letters and alphanumeric. -
RootCauseComments: string
Title:
CommentsMaximum Length:2000Notes captured with free-text details about the causes and root cause of failure, or any other relevant data. This value is optional. -
RootCauseDescription: string
Title:
Cause DescriptionRead Only:trueMaximum Length:540Number that identifies the work order. This number is unique in the organization. The user can manually assign the number when creating the work order, or allow the application to create a unique number from the numbering scheme that the following Plant parameters define: Work Order Prefix or Work Order Starting Number. -
RootCauseId: integer
(int64)
Title:
Root Cause IDRead Only:trueValue that uniquely identifies the root cause. The value is system generated and read-only. -
RootCauseName: string
Title:
Cause NameRead Only:trueMaximum Length:240Number that identifies the work order. This number is unique in the organization. The user can manually assign the number when creating the work order, or allow the application to create a unique number from the numbering scheme that the following Plant parameters define: Work Order Prefix or Work Order Starting Number.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Links
- rootCauses
-
Parameters:
- FailureEventId:
$request.path.FailureEventId - FailureInstanceId:
$request.path.FailureInstanceId
The Failure Root Causes resource manages the failure root causes. A failure root cause defines the underlying, originating causal factors that led to the occurrence of an asset failure event. Root causes represent the core causal factors, such as process, training, environment or design that are determined through a root cause analysis. In contrast, a cause code represents a technician-observed failure mechanism, such as rust, leak, rupture or shearing. More than one failure root cause may underlay a single failure instance. - FailureEventId:
Examples
This example describes how to create asset failure instances.
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.action+json" -d 'request payload' "https://servername/fscmRestApi/resources/version/assetFailureEvents/FailureEventId/child/failureInstances"
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.
{
"FailureCode": "FC3",
"CauseCode": "CC3",
"ResolutionCode": "RC3",
"FailureComments": "FailureComments",
"rootCauses": [
{
"RootCauseCode": "CC2",
"RootCauseComments": "Root Cause Comments"
},
{
"RootCauseCode": "CC4",
"RootCauseComments": "Root Cause Comments"
}
]
}Example Response Body
The following example includes the contents of the response body in JSON format:
{
"CreatedBy": "MNT_QA",
"CreationDate": "2021-11-22T12:38:35.257+00:00",
"FailedComponentAssetNumber": null,
"AssetNumber": null,
"FailedComponentItemNumber": null,
"FailedComponentItemId": null,
"FailedComponentSerialNumber": null,
"FailureComments": "FailureComments",
"FailureEventId": 300100555268986,
"FailureInstanceId": 300100555290333,
"LastUpdateDate": "2021-11-22T12:38:35.257+00:00",
"LastUpdateLogin": "D14D59213ED9612CE053A9B1F20A71D6",
"LastUpdatedBy": "MNT_QA",
"FailureSeverityCode": null,
"FailureStatusCode": null,
"AssetId": null,
"FailureName": "Failure Code 3",
"FailureDescription": "Failure Code 3",
"CauseDescription": "Cause Code 3",
"CauseName": "Cause Code 3",
"ResolutionDescription": "RC3",
"ResolutionName": "RC3",
"AssetDescription": null,
"FailureCodeId": 300100555257871,
"FailureCode": "FC3",
"CauseCodeId": 300100555258027,
"CauseCode": "CC3",
"ResolutionCodeId": 300100555258164,
"ResolutionCode": "RC3",
"AssetDownFlag": null,
"AvailableDate": null,
"FailureDate": null,
"RepairCost": null,
"SourceDocumentId": null,
"SourceDocumentTypeCode": null,
"SourceSystemId": null,
"SourceSystemType": null,
"DaysBetweenFailure": null,
"MeterUnitsBetweenFailure": null,
"MeterUnitOfMeasure": null,
"CompletionDate": null,
"FailureCategoryCode": null,
"FailureCategoryName": null,
"CauseCategoryCode": null,
"CauseCategoryName": null,
"ResolutionCategoryCode": null,
"ResolutionCategoryName": null,
"ItemDescription": null,
"ItemNumber": null,
"ItemLongDescription": null,
"FailedComponentItemDescription": null,
"InventoryItemId": null,
"ItemOrganizationId": null,
"FailedComponentItemLongDescription": null,
"WorkOrderId": null,
"WorkOrderNumber": null,
"WorkOrderDescription": null,
"FailedComponentAssetDescription": null,
"FailureSeverityName": null,
"FailureStatusName": null,
"AssetCriticalityName": null,
"AssetCriticalityCode": null,
"ItemOrganizationCode": null,
"rootCauses": [
{
"CauseCodeId": 300100555257966,
"RootCauseComments": "Root Cause Comments",
"CreatedBy": "MNT_QA",
"CreationDate": "2021-11-22T12:38:35.260+00:00",
"FailureInstanceId": 300100555290333,
"LastUpdateDate": "2021-11-22T12:38:35.260+00:00",
"LastUpdateLogin": "D14D59213ED9612CE053A9B1F20A71D6",
"LastUpdatedBy": "MNT_QA",
"RootCauseId": 300100555290334,
"RootCauseCode": "CC2",
"RootCauseName": "Cause Code 2",
"RootCauseDescription": "Cause Code 2",
"RootCauseCategoryCode": null,
"RootCauseCategoryName": null,
"links": [
{
"rel": "self",
"href": "https://servername/fscmRestApi/resources/version/assetFailureEvents/300100555268986/child/failureInstances/300100555290333/child/rootCauses/300100555290334",
"name": "rootCauses",
"kind": "item",
"properties": {
"changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
}
},
{
"rel": "canonical",
"href": "https://servername/fscmRestApi/resources/version/assetFailureEvents/300100555268986/child/failureInstances/300100555290333/child/rootCauses/300100555290334",
"name": "rootCauses",
"kind": "item"
},
{
"rel": "parent",
"href": "https://servername/fscmRestApi/resources/version/assetFailureEvents/300100555268986/child/failureInstances/300100555290333",
"name": "failureInstances",
"kind": "item"
}
]
},
{
"CauseCodeId": 300100555258053,
"RootCauseComments": "Root Cause Comments",
"CreatedBy": "MNT_QA",
"CreationDate": "2021-11-22T12:38:35.261+00:00",
"FailureInstanceId": 300100555290333,
"LastUpdateDate": "2021-11-22T12:38:35.261+00:00",
"LastUpdateLogin": "D14D59213ED9612CE053A9B1F20A71D6",
"LastUpdatedBy": "MNT_QA",
"RootCauseId": 300100555290335,
"RootCauseCode": "CC4",
"RootCauseName": "Cause Code 4",
"RootCauseDescription": "Cause Code 4",
"RootCauseCategoryCode": null,
"RootCauseCategoryName": null,
"links": [
{
"rel": "self",
"href": "https://servername/fscmRestApi/resources/version/assetFailureEvents/300100555268986/child/failureInstances/300100555290333/child/rootCauses/300100555290335",
"name": "rootCauses",
"kind": "item",
"properties": {
"changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
}
},
{
"rel": "canonical",
"href": "https://servername/fscmRestApi/resources/version/assetFailureEvents/300100555268986/child/failureInstances/300100555290333/child/rootCauses/300100555290335",
"name": "rootCauses",
"kind": "item"
},
{
"rel": "parent",
"href": "https://servername/fscmRestApi/resources/version/assetFailureEvents/300100555268986/child/failureInstances/300100555290333",
"name": "failureInstances",
"kind": "item"
}
]
}
],
"links": [
{
"rel": "self",
"href": "https://servername/fscmRestApi/resources/version/assetFailureEvents/300100555268986/child/failureInstances/300100555290333",
"name": "failureInstances",
"kind": "item",
"properties": {
"changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
}
},
{
"rel": "canonical",
"href": "https://servername/fscmRestApi/resources/version/assetFailureEvents/300100555268986/child/failureInstances/300100555290333",
"name": "failureInstances",
"kind": "item"
},
{
"rel": "parent",
"href": "https://servername/fscmRestApi/resources/version/assetFailureEvents/300100555268986",
"name": "assetFailureEvents",
"kind": "item"
},
{
"rel": "child",
"href": "https://servername/fscmRestApi/resources/version/assetFailureEvents/300100555268986/child/failureInstances/300100555290333/child/rootCauses",
"name": "rootCauses",
"kind": "collection"
}
]
}