Update one allocation
patch
/fscmRestApi/resources/11.13.18.05/backlogManagementPlans/{BmRunId}/child/allocations/{allocationsUniqID}
Request
Path Parameters
-
BmRunId(required): integer
Value that uniquely identifies the backlog management plan run.
-
allocationsUniqID(required): string
This is the hash key of the attributes which make up the composite key for the Allocations resource and used to uniquely identify an instance of Allocations. The client should not generate the hash key value. Instead, the client should query on the Allocations collection resource in order to navigate to a specific instance of Allocations to get the hash key.
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
-
AllocationDate: string
(date)
Date of the week when the supply is allocated.
-
AllocUserDef: integer
Quantity of the allocated supply that's manually specified.
-
AttributeId: integer
Value that uniquely identifies the allocation level.
-
AttributeValueId: integer
Value that uniquely identifies the allocation node.
-
BmRunId: integer
Value that uniquely identifies the backlog management plan run.
-
ESSJobId: integer
Value that uniquely identifies the process that updates the allocation data.
-
InventoryItemId: integer
Value that uniquely identifies the item for which the allocation data is requested.
-
InventoryItemName: string
Maximum Length:
255
Name of the item for which allocation data is requested. -
Level1AttributeName: string
Maximum Length:
255
Name of the top hierarchical allocation level in the allocation hierarchy. -
Level1AttributeValName: string
Maximum Length:
255
Name of the top hierarchical allocation level value in the allocation hierarchy. -
Level1AttributeValueId: integer
Value that uniquely identifies the top hierarchical allocation level in the allocation hierarchy.
-
Level2AttributeName: string
Maximum Length:
255
Name of the intermediate hierarchical allocation level in the allocation hierarchy. -
Level2AttributeValName: string
Maximum Length:
255
Name of the intermediate hierarchical allocation level value in the allocation hierarchy. -
Level2AttributeValueId: integer
Value that uniquely identifies the intermediate hierarchical allocation level in the allocation hierarchy.
-
Level3AttributeName: string
Maximum Length:
255
Name of the lowest hierarchical allocation level in the allocation hierarchy. -
Level3AttributeValName: string
Maximum Length:
255
Name of the lowest hierarchical allocation level value in the allocation hierarchy. -
Level3AttributeValueId: integer
Value that uniquely identifies the lowest hierarchical allocation level in the allocation hierarchy.
-
Message: string
Message that indicates the success or failure of the bulk allocation upload.
-
OrganizationCode: string
Maximum Length:
255
Abbreviation that identifies the organization for which the allocation data is requested. -
OrganizationId: integer
Value that uniquely identifies the organization for which the allocation data is requested.
-
OrganizationName: string
Maximum Length:
255
Name of the organization for which the allocation data is requested. -
UpdateAsync: string
(byte)
Encoded allocation data when updating the allocation data using bulk update.
-
UpdateMode: string
Mode that indicates whether the allocation data is updated using the bulk update process or not.
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 : backlogManagementPlans-allocations-item-response
Type:
Show Source
object
-
AllocationDate: string
(date)
Date of the week when the supply is allocated.
-
AllocSteal: number
Read Only:
true
Quantity of the allocation that's consumed by demands at other allocation nodes. -
AllocSup: number
Read Only:
true
Quantity of the allocated supply. -
AllocUserDef: integer
Quantity of the allocated supply that's manually specified.
-
AttributeId: integer
Value that uniquely identifies the allocation level.
-
AttributeValueId: integer
Value that uniquely identifies the allocation node.
-
AvailSteal: number
Read Only:
true
Quantity of allocation that's available for consumption by other allocation nodes. -
AvailSup: number
Read Only:
true
Quantity of allocation available at the allocation node. -
BmRunId: integer
Value that uniquely identifies the backlog management plan run.
-
ConsumHistory: number
Read Only:
true
Quantity of supply consumed at an allocation node by shipped orders. -
ConsumSup: number
Read Only:
true
Quantity of allocation that's consumed at the allocation node. -
CreatedBy: string
Read Only:
true
Maximum Length:64
User who created the allocation entry. -
CreationDate: string
(date-time)
Read Only:
true
Date and time when the user created the allocation entry. -
CumlAvailSup: number
Read Only:
true
Quantity of cumulative allocation at the allocation node. -
ESSJobId: integer
Value that uniquely identifies the process that updates the allocation data.
-
GrossAlloc: number
Read Only:
true
Quantity of allocation at a node and all other nodes within its hierarchy. -
GrossAllocSteal: number
Read Only:
true
Quantity of allocation that was at a node and all other nodes within its hierarchy. -
GrossAvail: number
Read Only:
true
Quantity of allocation available at a node and all other nodes within its hierarchy. -
GrossConsum: number
Read Only:
true
Quantity of allocation consumed at a node and all other nodes within its hierarchy. -
GrossConsumHistory: number
Read Only:
true
Quantity of allocation consumed by shipped orders at a node and all other nodes within its hierarchy. -
GrossCumlAvail: number
Read Only:
true
Quantity of cumulative allocation available at a node and all other nodes within its hierarchy. -
GrossSup: number
Read Only:
true
Quantity that's the sum of the supply in a week across all allocation nodes and the supply consumed by the shipped sales orders across all allocation nodes. -
InventoryItemId: integer
Value that uniquely identifies the item for which the allocation data is requested.
-
InventoryItemName: string
Maximum Length:
255
Name of the item for which allocation data is requested. -
LastUpdateDate: string
(date-time)
Read Only:
true
Date and time when the user most recently updated the allocation record. -
LastUpdatedBy: string
Read Only:
true
Maximum Length:64
User who most recently updated the allocation record. -
LastUpdateLogin: string
Read Only:
true
Maximum Length:32
Login that the user used when updating the allocation record. -
Level1AttributeName: string
Maximum Length:
255
Name of the top hierarchical allocation level in the allocation hierarchy. -
Level1AttributeValName: string
Maximum Length:
255
Name of the top hierarchical allocation level value in the allocation hierarchy. -
Level1AttributeValueId: integer
Value that uniquely identifies the top hierarchical allocation level in the allocation hierarchy.
-
Level2AttributeName: string
Maximum Length:
255
Name of the intermediate hierarchical allocation level in the allocation hierarchy. -
Level2AttributeValName: string
Maximum Length:
255
Name of the intermediate hierarchical allocation level value in the allocation hierarchy. -
Level2AttributeValueId: integer
Value that uniquely identifies the intermediate hierarchical allocation level in the allocation hierarchy.
-
Level3AttributeName: string
Maximum Length:
255
Name of the lowest hierarchical allocation level in the allocation hierarchy. -
Level3AttributeValName: string
Maximum Length:
255
Name of the lowest hierarchical allocation level value in the allocation hierarchy. -
Level3AttributeValueId: integer
Value that uniquely identifies the lowest hierarchical allocation level in the allocation hierarchy.
-
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
Message: string
Message that indicates the success or failure of the bulk allocation upload.
-
NetWeekSup: number
Read Only:
true
Quantity of overall supply for an item and organization in a week. -
OrganizationCode: string
Maximum Length:
255
Abbreviation that identifies the organization for which the allocation data is requested. -
OrganizationId: integer
Value that uniquely identifies the organization for which the allocation data is requested.
-
OrganizationName: string
Maximum Length:
255
Name of the organization for which the allocation data is requested. -
UpdateAsync: string
(byte)
Encoded allocation data when updating the allocation data using bulk update.
-
UpdateMode: string
Mode that indicates whether the allocation data is updated using the bulk update process or not.
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.
Examples
This example describes how to update one allocation detail to the backlog management plan.
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/backlogManagementPlans/BmRunId/child/allocations/allocationsUniqID"
For example:
curl -X PATCH -u "username:password" -H "Content-Type: application/vnd.oracle.adf.resourceitem+json" -d 'request payload' "servername/fscmRestApi/resources/version/backlogManagementPlans/-1/child/allocations/00070000000EACED00057708FFFFFFFFFFFFFFFF0000000EACED00057708000000000193E88D0000000EACED00057708000000000000B2470000000EACED00057708FFFFFFFFFFFFA4630000000EACED00057708000110F09A559A030000000EACED00057708000000000024B8D80000004AACED00057372000D6A6176612E73716C2E4461746514FA46683F3566970200007872000E6A6176612E7574696C2E44617465686A81014B59741903000078707708000001B91DB8600078"
Example Request Body
The following example includes the contents of the request body in JSON format.
{ "AllocUserDef": 200 }
Example Response Body
The following example includes the contents of the response
body in JSON format:
{ "BmRunId": -1, "InventoryItemId": 26470541, "OrganizationId": 45639, "AttributeId": 300100544207363, "AttributeValueId": 2406616, "Level1AttributeValueId": 2406598, "Level2AttributeValueId": 2406622, "Level3AttributeValueId": 2406616, "AllocationDate": "2030-01-14", "AllocSup": 17.5, "ConsumSup": 15, "AvailSup": 2.5, "CumlAvailSup": 2.5, "GrossAlloc": 17.5, "GrossConsum": 15, "GrossAvail": 2.5, "GrossCumlAvail": 2.5, "AllocSteal": 0, "GrossAllocSteal": 0, "AvailSteal": null, "NetWeekSup": 140, "Level1AttributeName": "BLM-All", "Level2AttributeName": "BLM-CustParentGrp", "Level3AttributeName": "BLM-CustGrp", "Level1AttributeValName": "ALL", "Level2AttributeValName": "BLM-South", "Level3AttributeValName": "BLM-SouthWest", "InventoryItemName": "BLM-ALLOC-JI'WithDiffAllocation", "OrganizationName": "Denver Manufacturing_BLM", "OrganizationCode": "BLM:BLM_M1", "LastUpdatedBy": "BLM_ALL", "LastUpdateLogin": "C9C4BF012BA4435CE0534005F00A32BD", "LastUpdateDate": "2021-08-25T10:45:55+00:00", "CreatedBy": "BLM_ALL", "CreationDate": "2021-08-18T12:30:18.886+00:00", "AllocUserDef": 200, "ESSJobId": null, "Message": null, "UpdateMode": null, "links": [ { "rel": "self", "href": "servername/fscmRestApi/resources/version/backlogManagementPlans/-1/child/allocations/00070000000EACED00057708FFFFFFFFFFFFFFFF0000000EACED00057708000000000193E88D0000000EACED00057708000000000000B2470000000EACED00057708FFFFFFFFFFFFA4630000000EACED00057708000110F09A559A030000000EACED00057708000000000024B8D80000004AACED00057372000D6A6176612E73716C2E4461746514FA46683F3566970200007872000E6A6176612E7574696C2E44617465686A81014B59741903000078707708000001B91DB8600078", "name": "allocations", "kind": "item" }, { "rel": "canonical", "href": "servername/fscmRestApi/resources/version/backlogManagementPlans/-1/child/allocations/00070000000EACED00057708FFFFFFFFFFFFFFFF0000000EACED00057708000000000193E88D0000000EACED00057708000000000000B2470000000EACED00057708FFFFFFFFFFFFA4630000000EACED00057708000110F09A559A030000000EACED00057708000000000024B8D80000004AACED00057372000D6A6176612E73716C2E4461746514FA46683F3566970200007872000E6A6176612E7574696C2E44617465686A81014B59741903000078707708000001B91DB8600078", "name": "allocations", "kind": "item" }, { "rel": "parent", "href": "servername/fscmRestApi/resources/version/backlogManagementPlans/-1", "name": "backlogManagementPlans", "kind": "item" }, { "rel": "enclosure", "href": "servername/fscmRestApi/resources/version/backlogManagementPlans/-1/child/allocations/00070000000EACED00057708FFFFFFFFFFFFFFFF0000000EACED00057708000000000193E88D0000000EACED00057708000000000000B2470000000EACED00057708FFFFFFFFFFFFA4630000000EACED00057708000110F09A559A030000000EACED00057708000000000024B8D80000004AACED00057372000D6A6176612E73716C2E4461746514FA46683F3566970200007872000E6A6176612E7574696C2E44617465686A81014B59741903000078707708000001B91DB8600078/enclosure/UpdateAsync", "name": "UpdateAsync", "kind": "other" } ] }