Create or Update Craft

put

https://server:port/rest/apis/asset/resources/crafts/{externalSystem}/{externalId}

This REST service synchronizes Enterprise Resource Planning (ERP) - Human Capital Management (HCM) Jobs with Work and Asset Management (WAM) Crafts, by creating WAM Craft records or updating existing records.

Request

Path Parameters
Supported Media Types
Request Body - application/xml ()
Root Schema : schema
Type: object
Show Source
Nested Schema : input
Type: object
Show Source
  • Allowed Values: [ "W1NO", "W1YS" ]
    Applies to contracted resources to indicate whether or not the system can automatically accept the work, or service, without someone reviewing or accepting it manually. * `W1NO` - No, * `W1YS` - Yes
    Example: Yes
  • Maximum Length: 60
    Unique code for the craft
    Example: IDC_ELECTRICIAN
  • Allowed Values: [ "W1NO", "W1YS" ]
    Indicates whether or not the item information should be defaulted onto activities when resource requirements reference the craft. If this is set to No, then the stock item can only be added to stock item details as a direct purchase item. * `W1NO` - No, * `W1YS` - Yes
    Example: Yes
  • Maximum Length: 100
    Short description for a type of craft resource. Typically a special skill or contract worker
  • Maximum Length: 60
    A unique identifier to the craft as represented in the external system - Human Capital Management
    Example: 300000047336894
  • Maximum Length: 30
    The Work and Asset Management code that represents the external system.
    Example: HCM
  • Maximum Length: 4000
    Long description for a type of craft resource. Typically a special skill or contract worker
  • Maximum Length: 30
    Premium expense code for the craft
    Example: 120 - Labor - Premium
  • Maximum Length: 30
    Regular expense code for the craft
    Example: 110 - Labor - Regular
  • Allowed Values: [ "W1IN", "W1PR" ]
    Provides a reference to where the craft resource can be located or obtained. Internal or Purchased. * `W1IN` - Internal, * `W1PR` - Purchased
    Example: Internal, Purchased
  • Minimum Value: 0
    Maximum Value: 999
    A numerical value which is used to denote the order in which the principal craft duration is determined when labor requirement assignments are made to a secondary craft. 1 is a high priority and 999 is a low priority. The default is 100. If two crafts have the same secondary craft, they should be set with different priorities.
    Example: 100
  • Maximum Length: 12
    Craft Status
    Example: Active
  • unitPricesList
Nested Schema : output
Type: object
Show Source
  • Maximum Length: 12
    Unique ID sent by Work and Asset Management System on each outbound message
Nested Schema : unitPricesList
Type: array
Show Source
Nested Schema : items
Type: object
Show Source
Request Body - application/json ()
Root Schema : schema
Type: object
Show Source
Nested Schema : schema
Type: object
Show Source
Nested Schema : input
Type: object
Show Source
  • Allowed Values: [ "W1NO", "W1YS" ]
    Applies to contracted resources to indicate whether or not the system can automatically accept the work, or service, without someone reviewing or accepting it manually. * `W1NO` - No, * `W1YS` - Yes
    Example: Yes
  • Maximum Length: 60
    Unique code for the craft
    Example: IDC_ELECTRICIAN
  • Allowed Values: [ "W1NO", "W1YS" ]
    Indicates whether or not the item information should be defaulted onto activities when resource requirements reference the craft. If this is set to No, then the stock item can only be added to stock item details as a direct purchase item. * `W1NO` - No, * `W1YS` - Yes
    Example: Yes
  • Maximum Length: 100
    Short description for a type of craft resource. Typically a special skill or contract worker
  • Maximum Length: 60
    A unique identifier to the craft as represented in the external system - Human Capital Management
    Example: 300000047336894
  • Maximum Length: 30
    The Work and Asset Management code that represents the external system.
    Example: HCM
  • Maximum Length: 4000
    Long description for a type of craft resource. Typically a special skill or contract worker
  • Maximum Length: 30
    Premium expense code for the craft
    Example: 120 - Labor - Premium
  • Maximum Length: 30
    Regular expense code for the craft
    Example: 110 - Labor - Regular
  • Allowed Values: [ "W1IN", "W1PR" ]
    Provides a reference to where the craft resource can be located or obtained. Internal or Purchased. * `W1IN` - Internal, * `W1PR` - Purchased
    Example: Internal, Purchased
  • Minimum Value: 0
    Maximum Value: 999
    A numerical value which is used to denote the order in which the principal craft duration is determined when labor requirement assignments are made to a secondary craft. 1 is a high priority and 999 is a low priority. The default is 100. If two crafts have the same secondary craft, they should be set with different priorities.
    Example: 100
  • Maximum Length: 12
    Craft Status
    Example: Active
  • unitPricesList
Nested Schema : output
Type: object
Show Source
  • Maximum Length: 12
    Unique ID sent by Work and Asset Management System on each outbound message
Nested Schema : unitPricesList
Type: array
Show Source
Nested Schema : items
Type: object
Show Source
Back to Top

Response

Supported Media Types

200 Response

Success response
Body ()
Root Schema : EXTERNALUPDATEADDCRAFT_response
Type: object
Show Source
Nested Schema : W1UpdAdCraft
Type: object
Show Source
Nested Schema : input
Type: object
Show Source
  • Allowed Values: [ "W1NO", "W1YS" ]
    Applies to contracted resources to indicate whether or not the system can automatically accept the work, or service, without someone reviewing or accepting it manually. * `W1NO` - No, * `W1YS` - Yes
    Example: Yes
  • Maximum Length: 60
    Unique code for the craft
    Example: IDC_ELECTRICIAN
  • Allowed Values: [ "W1NO", "W1YS" ]
    Indicates whether or not the item information should be defaulted onto activities when resource requirements reference the craft. If this is set to No, then the stock item can only be added to stock item details as a direct purchase item. * `W1NO` - No, * `W1YS` - Yes
    Example: Yes
  • Maximum Length: 100
    Short description for a type of craft resource. Typically a special skill or contract worker
  • Maximum Length: 60
    A unique identifier to the craft as represented in the external system - Human Capital Management
    Example: 300000047336894
  • Maximum Length: 30
    The Work and Asset Management code that represents the external system.
    Example: HCM
  • Maximum Length: 4000
    Long description for a type of craft resource. Typically a special skill or contract worker
  • Maximum Length: 30
    Premium expense code for the craft
    Example: 120 - Labor - Premium
  • Maximum Length: 30
    Regular expense code for the craft
    Example: 110 - Labor - Regular
  • Allowed Values: [ "W1IN", "W1PR" ]
    Provides a reference to where the craft resource can be located or obtained. Internal or Purchased. * `W1IN` - Internal, * `W1PR` - Purchased
    Example: Internal, Purchased
  • Minimum Value: 0
    Maximum Value: 999
    A numerical value which is used to denote the order in which the principal craft duration is determined when labor requirement assignments are made to a secondary craft. 1 is a high priority and 999 is a low priority. The default is 100. If two crafts have the same secondary craft, they should be set with different priorities.
    Example: 100
  • Maximum Length: 12
    Craft Status
    Example: Active
  • unitPricesList
Nested Schema : output
Type: object
Show Source
  • Maximum Length: 12
    Unique ID sent by Work and Asset Management System on each outbound message
Nested Schema : unitPricesList
Type: array
Show Source
Nested Schema : items
Type: object
Show Source

400 Response

Bad Request
Body ()
Root Schema : EXTERNALUPDATEADDCRAFT_error
Type: object
Show Source
Nested Schema : problemDetailDocument
Type: object
Show Source
  • Maximum Length: 60
    The long message description from the Oracle Utilities Application Framework in CDATA format.
  • Minimum Value: 0
    Maximum Value: 9999
    The HTTP Status code for the error.
  • Maximum Length: 60
    Fully qualified URL consisting of the Base URI Timestamp of error in ISO format, the User used for the transaction, the Message Category within Oracle Utilities Application Framework, the Message Number within Oracle Utilities Application Framework, the Request URL and the HTTP method used for the transaction.
  • Maximum Length: 60
    URL of the format 'A/message/X/Y' where A is the base URI, X is the Message Category and Y is the Message Number within Oracle Utilities Application Framework.
  • serverMessage
  • Maximum Length: 60
    The stack trace shows where the error occurs during the execution of a program.
  • Maximum Length: 60
    Fully qualified error message from Oracle Utilities Application Framework in CDATA format.
Nested Schema : serverMessage
Type: object
Show Source
  • Maximum Length: 60
    Delimited sequence of programs called.
  • Maximum Length: 60
    The long message description from the Oracle Utilities Application Framework in CDATA format.
  • Minimum Value: 0
    Maximum Value: 0
    Message Category within Oracle Utilities Application Framework.
  • Minimum Value: -99999
    Maximum Value: 99999
    Message Number within Oracle Utilities Application Framework.
  • Maximum Length: 60
    Fully qualified error message from Oracle Utilities Application Framework in CDATA format.
  • Maximum Length: 60
    Name of the program that encountered the error.

500 Response

Internal Server Error
Body ()
Root Schema : EXTERNALUPDATEADDCRAFT_error
Type: object
Show Source
Nested Schema : problemDetailDocument
Type: object
Show Source
  • Maximum Length: 60
    The long message description from the Oracle Utilities Application Framework in CDATA format.
  • Minimum Value: 0
    Maximum Value: 9999
    The HTTP Status code for the error.
  • Maximum Length: 60
    Fully qualified URL consisting of the Base URI Timestamp of error in ISO format, the User used for the transaction, the Message Category within Oracle Utilities Application Framework, the Message Number within Oracle Utilities Application Framework, the Request URL and the HTTP method used for the transaction.
  • Maximum Length: 60
    URL of the format 'A/message/X/Y' where A is the base URI, X is the Message Category and Y is the Message Number within Oracle Utilities Application Framework.
  • serverMessage
  • Maximum Length: 60
    The stack trace shows where the error occurs during the execution of a program.
  • Maximum Length: 60
    Fully qualified error message from Oracle Utilities Application Framework in CDATA format.
Nested Schema : serverMessage
Type: object
Show Source
  • Maximum Length: 60
    Delimited sequence of programs called.
  • Maximum Length: 60
    The long message description from the Oracle Utilities Application Framework in CDATA format.
  • Minimum Value: 0
    Maximum Value: 0
    Message Category within Oracle Utilities Application Framework.
  • Minimum Value: -99999
    Maximum Value: 99999
    Message Number within Oracle Utilities Application Framework.
  • Maximum Length: 60
    Fully qualified error message from Oracle Utilities Application Framework in CDATA format.
  • Maximum Length: 60
    Name of the program that encountered the error.
Back to Top