# Production Order Flow Progress Visualization ## Overview Production Order and Material Progress Visualization enhances the existing Production Order dashboard UI Page with a progress indicator, providing real-time visibility into Production Order execution and Material Flow across process Steps and Process Activities, enabling comprehensive monitoring of shop floor execution throughout the manufacturing process. ### Business Context In today's manufacturing environment, monitoring production progress is essential for operational control and production planning, ensuring alignment with the planned schedule and enabling proactive decisions to address deviations and meet delivery commitments. The standard MES Production Order dashboard list includes progress information in terms of quantity (required, in progress, completed and delivered). However, in cases of final assembly and single Material orders, the quantity will all turn to In Process when the Material starts, and will all become complete once the Material completes. It can take some time for the quantity to pass from In Progress to Completed, and during that period there's no true visibility on the actual progress of the Production Order. ### Concept Production Order and Material Visualization extends the core Production Order progress indicator by providing a more granular view of execution progress. This feature introduces a progress indicator at Material level based on Steps and Process Activities, reflecting the actual advancement of each Material through its production Flow. This capability is particularly relevant when a Production Order represents a single unit of a Material, as is often the case for large or complex equipment, enabling a clear view of work completed versus remaining work. The progress indicator is presented in simple and intuitive formats, such as Steps or Process Activities completed out of the total, or percentage of production Flow completion. When a Production Order contains multiple Materials, progress is aggregated as an average of Material-level progress, ensuring a consistent view of overall execution status for production planning. Progress is calculated based on the main production Flow of the Material, excluding temporary processes such as rework or Off-Flow operations, in order to reflect true production progress. The progress data is stored as a property of both Material and Production Order entities, enabling reuse across reporting, dashboards, and future production control capabilities. On Production Orders with multiple Materials, the Production Order progress is the average of the progress of each of its Materials. The progress calculation supports multiple configurable modes, enabling production teams to select and apply the most appropriate method based on their specific production process and operational needs. The supported calculation modes are as follows: * **Steps of the Flow (ProgressByNumSteps)** - Number of Steps completed / Total number of Steps in the Flow * Example: If a Flow has 10 Steps, when tracking out or moving to the next Step on the 2nd Step, the Material progress value is calculated as (2/10) \* 100 = 20, representing 20% of the Steps in the Flow completed. !!! note The logic will consider the progress of current flow of the Material in the calculation. Rework Flow and Off-Flow operations are excluded from tracking, but if the Material changes to a different Flow (e.g. via _Change Flow and Step_) the progress will be reset. The last Step to consider is the first Step with the `Marks Product Completion` flag. If no `Marks Product Completion` Step is defined, the last Step of the Flow will be taken for the calculation. The `Marks Product Completion` Step must not be optional or skippable in the Flow. * **Process Activities Completed (ProgressByNumPAs)** - Number of Process Activities completed / Total number of Material Process Activities * Example: If a Material has 4 Process Activities. Upon completion of the 3rd Process Activity, the Material progress value is calculated as (3/4) \* 100 = 75, representing 75% of Process Activities completed. !!! note Process Activities with state Completed, Skipped, Cancelled will be considered as completed. Conditional Planned Process Activities are either included or ignored into the total number of Process Activities depending on the _ConditionalPlannedPAVisibility_ configuration setting. * **Hybrid (ProgressByNumStepsAndPAs)** - Number of Steps completed + Number of Process Activities completed / Total number of Steps in Flow + Total number of Material Process Activities * Example: Assuming we have a Flow with 4 Steps and 3 Process Activities, the Material is at the 3rd Step, and has 1 Process Activity completed. * Upon Track-Out within the 3rd Step: (3 Steps are completed + 1 Process Activity is completed) / (4 Steps + 3 Process Activities) = 57.14% * Upon Completion of the last Step: (4 Steps are completed + 1 Process Activity is completed) / (4 Steps + 3 Process Activities) = 71.43% * Upon completion of another Process Activity: (4 Steps are completed + 2 Process Activities completed) / (4 Steps + 3 Process Activities) = 85.71% The progress is updated whenever a Material completes or moves to a step, or when a Process Activity is closed. ## How to Use To use the new Production Order progress indicator, it can be accessed through: `Planning And Logistics` > `Order Management section` > `Production Orders`. ![IndEq_ProductionOrder_Page_Production_Orders is the custom Page to show the production order details and progress](features.images/productionordermaterialvisualization/dashboardmenu.gif) A new column `Flow Progress` is now available in the Production Order dashboard, showing the completion status of the Production Orders' Materials across Flow Steps and Process Activities. ![Flow Progress column to show the Production Order progress](features.images/productionordermaterialvisualization/dashboard.png) ## Administration ### Configuration Entries The following table describes all configuration entries related to the Material/Production Order progress tracking. | Name | Path | Type | Initial Value | Description | | :------------------------------ | :------------------------------ | :------ | :------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------- | | Enabled | /IndEq/POProgressVisualization/ | Boolean | `TRUE` | Indicate if Material/Production Order progress tracking is enabled | | MaterialProgressCalculationMode | /IndEq/POProgressVisualization/ | String | `ProgressByNumSteps` | Calculation mode for MaterialProgressCalculationMode. Supports the options: `ProgressByNumSteps` / `ProgressByNumPAs` / `ProgressByNumStepsAndPAs` | ## Assumptions and Restrictions - Progress is not tracked if the Material has not associated Production Order and Production Order state must not in 'Closed', 'Completed' and 'Canceled'. - Material associated with the production order required 'Account To New ProductionOrder Quantity' set to true and has Active relation. - Progress is not tracked if the Material's Product does not match the Production Order's Product. - The Production Order progress is the direct average of the progress of each of its Materials, it is not weighted by the quantity of each Material. - When a Flow is updated, the associated Materials' progress will not reflect the change until the next action (e.g., Track-Out or Move Next) is executed. - When a Production Order is updated, the associated Materials' progress will not reflect the change until the next action (e.g., Track-Out or Move Next) is executed. - Rework and Temporary Off-Flow Materials are excluded from the progress calculation. - The progress of production order will be recalculated when the material is reassigned to new production order.