Use Case Description

 

  1. UC-14 Input Files
    1. Brief Description

    This use case enables the Budget Analyst to perform individual selection, report placement and apply formulas to specific columns found in the selected input files.

     

  2. Flow of Events
    1. Basic Flow - Column Formula Input

Definition: Provides the capability to select which columns from the input files will appear on the output and in which order.

{TBD: is this tied to the number of input files chosen on the main screen, or is selection made again here?}

Usage: Used with Formula Input. This option is input first. Columns from input files are built here.

  1. Budget Analyst selects 18 = column formula input {cf}
  2. (System prompts Budget Analyst for first column’s input file)
  3. Budget Analyst inputs column in format "colx" where x is a valid column in the file.{TO DO: how will error be reported here if column is invalid?}
  4. (System provides a lists of fiscal years / positions for the Budget Analyst to select) {TO DO: will these choices always provide valid year data?}
  5. Budget Analyst selects fiscal year / position in the format "fyYY" where YY is a valid year.
  6. (System prompts for column to select from next input file.)

 

    1. Alternate Flows
      1. Formula Input

Definition: Provides the capability to perform calculations on the input data.

Usage: Used with Column Formula Input. This option is input second. Formulas are supplied for columns built using "column formula input." Performs calculations on columns and places results in particular columns on the report.

  1. Budget Analyst selects 19 = formula input {fi}
  2. (System prompts Budget Analyst for first column’s formula or none)
  3. Budget Analyst inputs column in format "colx = colx + coly; * (multiply), - (subtract), colx = colz" where x,y and z are valid columns in the file.

 

      1. 3.x Percentage Formulas

Definition: Provides the capability if formula input is performed and percentages are calculated (one column divided by another column), to change data precision for those columns (and others that use that column) to tenths.

  1. Budget Analyst selects 35 = percentage formulas {pf}
  2. Budget Analyst enters a formula for each column or "none"

 

      1. 3.x All Update Files

Definition: Provides the capability to select all files which are scheduled for update.

1. Budget Analyst selects 40 = all update files {auf}

{TBD: may only be available to fmadm?}

 

  1. Participating Actors

    2. Budget Analyst - Any interactive user of the ABIDES-FE Report Break. It is assumed that they require reports to analyze the state of the budget.

     

  2. Pre-Conditions

    3. Budget Analyst is creating or updating a F&FP Report Break.

     

  3. Post-Conditions

    4. System produces the report with specified column selection, placement and formulas as applicable.

     

  4. Extension Points

    5. None.

     

  5. Supplemental Requirements

    6. None.

     

  6. Open Issues
    1. Basic Flow

      2. {TO DO: determine how many columns to display on the GUI}

      {TO DO: determine how user indicates no more or inputs - - assumption, first "null" ends requests; can GUI function differently letting a column’s input be skipped?}

      {TO DO: possible to use same file for more than one column?}

      NOTE: formats are "colx", "fyYY",

      {TO DO: "posx"?, "loc"?, "rm"?}

      {TO DO: Is multiplication of columns really possible here or only in 3.x Formula Input?percentages?}

      {TO DO: User inputs column in format "colx" where x is a valid column in the file? Other possible input errors with the input formats}

       

    2. Formula Input

{TO DO: how will error be reported here if column is invalid?}

{TO DO: is division possible, system checks for divide by zero?}

{TO DO: determine how many columns to display on the GUI}

{TO DO: determine how user indicates no more or inputs - - assumption, first "null" ends requests; can GUI function differently letting a column’s input be skipped?}

NOTE: percentages are allowed for multiplication

{TO DO: percentages only for multiplication?}

{TO DO: Format for percentage is number only? .065454}