5-11-2011

Short Description: "Set SCT Aggregation Summary Functions" Persistence. 
Bug Number: n/a
Release notes (y/n): YES. This is done. Ready for review.
For Release Nums: 6.1

Added persistence within the SCT Config file (using Flex/Bison parsing) 
for the "Set SCT Aggregation Summary Functions" assignment operation 
parameters.

  SctConfig field:
    // Summary Function assignment operation parameters
    SctSumFuncAssignSpec _sumFuncAssignSpec;

  SAMPLE SCT Config records:

    --------------------------------------------------
    SCT_SFAS "START"
    SCT_SFAS "Unit_off Flow Slot_on Spill FUNC Max"
    SCT_SFAS "Unit_on Flow Slot_off   FUNC Sum"
    SCT_SFAS "Unit_on Volume Slot_off   FUNC Ave"
    SCT_SFAS "Unit_off NONE Slot_off   FUNC 1st"
    SCT_SFAS "END"
    --------------------------------------------------

  Note: The last data row (before "END") will unconditionally be used
  for the "default" case. Its Unit Type and Slot Name (Part) filters 
  are ignored.

  Note: Internal spaces (e.g. within slot names) are encoded as " " 
  and double-quotes are encoded as """. (i.e. the HTML character 
  entities for those characters).

  Note: The design of the SctSumFuncAssignSpec::Item class and the 
  persistence format does not assume that the Unit Type and Slot Name 
  (Part) filters are mutually exclusive (i.e. within a given row) -- 
  though in the current implementation, they are mutually exclusive
  (enabled in the GUI with radio buttons).

------------------------------
QtSCT/SctSumFuncAssignSpec.hpp
QtSCT/SctSumFuncAssignSpec.cpp
------------------------------

New SctSumFuncAssignSpec methods:
  QString serialize (int indentSpaces) const;
  okstat loadSerialCmd (const QString&);

New SctSumFuncAssignSpec::Item methods:
  QString saveAsString() const;
  okstat loadFromString (const QString&);

-------------------
QtSCT/SctConfig.hpp
QtSCT/SctConfig.cpp
-------------------

New methods:
  void dumpSumFuncAssignSpec (cwostream &os) const;
  okstat sctSumFuncAssignSpec_loadSerialCmd (const QString&);

------------------------
QtSCT/SctFile.l          -- Flex source
QtSCT/SctFile.y          -- Bison source
QtSCT/SctFile.tab.cpp    -- generated
QtSCT/SctFile.tab.hpp    -- generated
QtSCT/lex.sct_file_.cpp  -- generated
------------------------

(See example of new supported records above).

New Bison elements:
  sct_properties_sfas
  sct_sfas_sequence     (the set of rows, see above).
  sct_sfas_record       (a single row, see above).

---