Committed Quantities Notification
==============================================================================

This customization notifies and or sets a field on the order header when an 
order is posted with any line having a committed quantity less than the
quantity ordered.

Installation
------------------------------------------------------------------------------

The customization is installed using `Customization Manager`_.  Check out the
instructions for downloading Customization Manager and managing
customizations in the `documentation`_.

.. _Customization Manager: https://customization-manager.readthedocs.io/
.. _documentation: https://customization-manager.readthedocs.io/en/latest/howtos.html

Environment Setup
------------------------------------------------------------------------------

The customization depends on the ``ALLOWBACKORD`` optional field being
configured in Common Services and assigned to the Order Header. It should
Auto-Insert and default to ``No``.

Configuration and Usage
-------------------------------------------------------------------------------

The customization is configured through the script parameters in 
View, Events, WF & Scripts panel:

1. Open :guilabel:`Extender --> Setup --> View Events, Scripts & WF`.
2. Navigate to the ``OE0520`` view.
3. Set the script parameters:
   
    - Parameter 1: Message to display. If empty, no message box is shown 
      to the user.
    - Parameter 2: Order Header field to update. If empty no update is made
      to the order header.
    - Parameter 3: Order Header field value. The value to write to the header
      field when an order has back orders.

.. figure:: https://s3.amazonaws.com/dev.expi/content/poplar_cmtqty/config.png

    The default configuration, which notifies the user and writes to the header
    Reference field.