ConvertQuantityFromTo

ConvertQuantityFromTo

Minor Business Rule

Object Name: N3201700

Parent DLL: CMFG

Location: Client/Server

Language: NER

1.Functional Description

1.1Purpose
The Business Function will be used  to convert quantity (using from UOM) to specified UOM, also will convert quantity to  Weight and Volume UOM(s). 


1.2Setup Notes and Prerequisites
None.


1.3Special Logic

None


2.Technical Specifications


2.1Parameters:

Data Item Data Structure DescriptionI/ORequiredNotes UOMszFromUnitOfMeasureIR UOMszToUnitOfMeasureIOIf not passed weight UOM will be 

assigned ITMmnIdentifierShortItemIR MCUszBranchPlantIR QNTYmnQuantityIR WTUMszWeightUnitOfMeasureI/OOIf not passed it will be retrieved 

internally VLUMszVolumeUnitOfMeasureI/OOIf not passed it will be retrieved internally UOMszStandardUOMConversionI/OOIf not passed it will be 

retrieved internally if Weight or Volume is 

BLANK QNTYmnQuantityConvertedFromtoToOR GRWTmnQuantityConvertedToWeightOR ITVLmnQuantityConvertedToVolumeOR SUPPScSuppressErrorMessageIO DTAIszErrorMessageIDOO


2.2Related Tables 

Table Table Description F4101 F4103


2.3Related Business Functions

Source NameFunction Name


2.4Processing

If (szWeightUOM is BLANK OR szVolumeUOM is BLANK)

Call GetItemMasterDescUOM (B4001040)
End If 
If (szToUnitOfMeasure  is BLANK)

szToUnitOfMeasure = szWeightUOM
End If

Call GetItemUoMConversionFactor (B4000520)

Load Output parameters


3.2 Where Used: APPs/UBEs/NERs/BSFNs


Application/Business FunctionApplication/BF Name P32942 B3200460 N3200560


Data Structure

D3201700 - ConvertQuantityFromTo

Parameter NameData ItemData TypeReq/OptI/O/Both
szFromUnitOfMeasureUOMcharOPTNONE

A user defined code (00/UM) that indicates the quantity in which to express an inventory item, for example, CS (case) or BX (box).

szToUnitOfMeasureUOMcharOPTNONE

A user defined code (00/UM) that indicates the quantity in which to express an inventory item, for example, CS (case) or BX (box).

mnIdentifierShortItemITMMATH_NUMERICOPTNONE

An inventory item number. The system provides three separate item numbers plus an extensive cross-reference capability to other item 
numbers (see data item XRT) to accommodate substitute item numbers, replacements, bar codes, customer numbers, supplier numbers, and 
so forth. The item numbers are as follows:   o Item Number (short) - An eight-digit, computer-assigned item number     o 2nd Item Number - The 
25-digit, free-form, user defined alphanumeric item number     o 3rd Item Number - Another 25-digit, free-form, user defined alphanumeric item 
number

szBranchPlantMCUcharOPTNONE

An alphanumeric code that identifies a separate entity within a business for which you want to track costs. For example, a business unit 
might be a warehouse location, job, project, work center, branch, or plant. You can assign a business unit to a document, entity, or person for 
purposes of responsibility reporting. For example, the system provides reports of open accounts payable and accounts receivable by 
business unit to track equipment by responsible department. Business unit security might prevent you from viewing information about business units 
for which you have no authority.

mnQuantityQNTYMATH_NUMERICOPTNONE

The number of units that the system applies to the transaction.

szWeightUnitOfMeasureWTUMcharOPTNONE

The unit of measure that indicates the weight of an individual item. Typical weight units of measure are:    GM Gram    OZ Ounce    LB Pound    
KG Kilogram    CW Hundredweight    TN Ton 

szVolumeUnitOfMeasureVLUMcharOPTNONE

The unit of measure for the cubic space occupied by an inventory item. Typical volume unit of measures are:    ML Milliliter    OZ Fluid Ounce   
 PT Pint    LT Liter    CF Cubic Foot    CM Cubic Meter    CY Cubic Yard 

szStandardUOMConversionUOMcharOPTNONE

A user defined code (00/UM) that indicates the quantity in which to express an inventory item, for example, CS (case) or BX (box).

mnQuantityConvertedFromtoToQNTYMATH_NUMERICOPTNONE

The number of units that the system applies to the transaction.

mnQuantityConvertedToWeightGRWTMATH_NUMERICOPTNONE

Essentially a memo field at present, this value is intended to reflect the fact that many inventory items are always packaged in the same 
way for shipment to the customer.  This packaging in turn effectively adds to the shipment weight for the item.  Since much of the mainstream 
freight calculations depend upon a weight basis for their accuracy, the ability to store a gross weight which reflects the estimated additional 
weight of standard packaging was deemed to be a worthwhile enhancement. (Future Use)

mnQuantityConvertedToVolumeITVLMATH_NUMERICOPTNONE

The cubic units occupied by one inventory item. The definition of the unit itself (cubic feet, yards, meters, and so on) is defined in the volume 
unit of measure.

cSuppressErrorMessageSUPPScharOPTNONE

A flag indicating whether or not runtime error messaging will occur when an error message is issued from a business function.        0 = allow 
runtime error message handling.        1 = suppress runtime error message handling.

szErrorMessageIDDTAIcharOPTNONE

A code that identifies and defines a unit of information. It is an alphanumeric code up to 8 characters long that does not allow blanks or 
special characters such as %, &, or +. You create new data items using system codes 55-59. You cannot change the alias.

mnJobNumberJOBSMATH_NUMERICOPTNONE

The job number (work station ID) which executed the particular job.

cUseCacheEV01charOPTNONE

An option that specifies the type of processing for an event.

Related Functions

None

Related Tables

None