SetQuantityToOneAction

This document was generated using Claude.ai

Overview

Sets default quantity values to 1 for document lines that have zero or empty quantities. Also initializes measurement dimensions (length, width, height) to 1 for items that require measurements, ensuring all lines have valid quantity data for processing.

When This Action Runs

Manual execution on supply chain documents when default quantities need to be assigned, typically used for initializing new documents, fixing empty quantity issues, or preparing documents where single unit quantities are standard.

How It Works

1. Scans document lines - Iterates through all lines in the supply chain document
2. Validates item references - Skips lines without valid item assignments
3. Initializes null fields - Calls updateNulls() to ensure proper field initialization
4. Sets primary quantity defaults:
   • Sets unit of measure from item's base unit if missing
   • Sets quantity value to 1 if zero or empty
5. Handles measurement items - For items with hasMeasures = true:
   • Creates measures object if missing
   • Sets measure quantity to 1 if empty
   • Sets length to 1 if empty
   • Sets width to 1 for 2D/3D items if empty
   • Sets height to 1 for 3D items if empty
6. Returns success - Always completes successfully

Parameters

This action does not require any parameters.

Database Tables Affected

• BasicSCDocumentLine - Updates quantity and measurement values in document lines
• UserQuantity - Modifies quantity data including primary quantity and measures
• Measures - Updates or creates measurement dimensions (length, width, height)

Module: supplychain

Full Class Name: com.namasoft.modules.supplychain.domain.utils.SetQuantityToOneAction

Document Type: All Supply Chain Documents

Related Actions:

• Quantity initialization utilities
• Measurement management entity flows
• Document line default value actions