AdjustTrackItemInv
Description:
Updates Trackable Item quantities.
Input Properties
trackitemid
Description:
Semicolon-separated list of TrackItemIds.
Required:
Yes
quantity
Description:
Numeric quantity to be updated.
Comments:
Prefix with + to increment, - to decrement. If you specify multiple trackitemids, the quantity can have either of the following:
  • Same number of quantities in a semicolon-separated list, with each quantity corresponding to each of trackitem.
  • One quantity applied to all trackitems.
quantityunit
Description:
Can be either a unit defined in the Units table, or you can leave this blank. If not specified, you must set the quantitytype property to a value of "C".
Required:
No
Comments:
If blank, the original unit is used for calculations. If you specify multiple trackitemids,"this property must have the same number of items as there are trackitemids.
quantitytype
Description:
Can be either C (Containers) or U (Units, which is the default).
Required:
No
Comments:
This value is automatically updated if the quantity is a Number+unit or Number+(container). If you specify multiple trackitemids,"this property must have the same number of items as there are trackitemids.
validatequantity
Description:
Can be either Y or N, defaults to N. If it is specified as Y, if the adjust action causes the volume to go below 0, it fails.
Required:
No
Comments:
This v
auditreason
Description:
Auditing information recorded in the "Reason" column of the TraceLog table.
Required:
No
auditactivity
Description:
Auditing information recorded in the "Activity" column of the TraceLog table.
Required:
No
auditsignedflag
Description:
Auditing information recorded in the "SignedFlag" column of the TraceLog table.
Required:
No
eventnotify
Description:
Determines whether or not (Y/N) the Action posts an EventNotify Action onto the ToDo List when the Action executes.
Deprecated:
As of version 7, Event Notify actions are no longer generated
applylock
Description:
Determines whether data are locked (Y) or unlocked (N) while the Action is processing.
Required:
No
Output Properties
updatequantity
Description:
Updated quantity, in the same units specified by the original Trackable Item.
Required:
No
Comments:
This value may be rounded off to the nearest containers unit.
updatequantityunit
Description:
These are the same units as the Trackable Items' qtyunits.
Required:
No
updatequantitytype
Description:
Can be C or U, depending in whether the output quantity is measured in "(containers)" or a unit.
Required:
No
Additional Information
Additional information concerning this Action:
Examples of Decrementing TrackItem Quantity:
Input TrackItem Quantity Output Comments
2ml 10ml 8ml  
10ml 2ml 0ml If the quantity goes below 0, the value is set as 0.
The value can go below 0 in the current implementation.
2(containers) 5(containers) 3(containers)  
200ml 5 liters 4.8 liters Output in the units of the Trackable Item.
200 apples 5 liters 5 liters Throws a SapphireException
2(containers) container size=100ml 500ml 300ml The assumption is that the containers are full.
220ml 5(containers)containersize=100ml 2(containers) 2.2 containers is rounded to 3 containers before decrementing the quantity

Examples of Incrementing TrackItem Quantity:
Input TrackItem Quantity Output Comments
2ml 10ml 12ml  
2(containers) 5(containers) 7(containers)  
200ml 5 liters 5.2 litres Output in the units of the Trackable Item.
2(containers)container size=100ml 500 ml 700 ml Output in the units of the Trackable Item.
220ml 5(containers) 8(containers) It takes 3 containers to hold 220 ml, and that adds 3 containers to the result.

Copyright © 1999-2025 LabVantage Solutions, Inc.