Detailed Design Document
CPSC 451 Supplier Group #1

Department of Computer Science
University of Calgary
27 February 1997

Page maintainer: Terrence Asgar-Deen
terrence@cpsc.ucalgary.ca

  • Terrence Asgar-Deen
  • Patrick Chan
  • Thomas Hui
  • Carsten Jaeger
  • Matthew Johnson
  • Brian Low
  • Hoang Nguyen
  • Kevin Pattison
  • Csaba Suveges
  • Jeremy Tang
  • Leena Thakkar
  • Al-Amin Vira
  • Lin Zhang

  • Modify Product

     

    Modifying a product is described in the above diagram. The user passes the product information to the system. The product corresponding to this information is retrieved from the Product datastore and modified to reflect the user's inputted information. The instance is then written back into the datastore.

    The returned status corresponds to the success of the operation. If the product is successfully modified and updated in the datastore, the status returns Successful. If the product can't be updated, the corresponding error message is returned.


    P-Spec

    Process ID 1.B.3
    Process Name Modify Product
    Inputs product info
    Outputs product info
    Permissible User Administrator
    Assumptions All information entered is syntactically correct.
    Error Conditions The product specified by the product number and motif number does not exist.

    Data Elements (Data Dictionary)

    Name product
    Kind Data movement in DFD
    Type Instance of an Entity
    Description This data element corresponds to a complete instance of the Entity Product.

    Name product info
    Kind Data movement in DFD
    Type Multiple Field User Input
    Description These fields are input values from the User. They correspond to the fields in the Entity Product. Not all fields in the Product data table are necessarily present in an instance of the product information.

    Name status
    Kind Data movement in DFD
    Type Return Message
    Description This data element corresponds to an error message being returned from an operation. An error message may be both successful and unsuccessful. Unsuccessful error messages are further subcategorized into different errors based on the possible errors that can occur in an operation.

    User Interface (Modify Product)

    The Modify Products area can be accessed by selecting Modify from the Items menu, or clicking on the Modify toolbar button when in the Products, or View Products areas. When this area is opened, the user is presented with a screen containing the product's current information. From here, the user can modify the information.

    There are several buttons at the lower left edge of the area. While the Modify Products area only displays one product at a time, these buttons allow the user to move to other products. The left and right buttons move to the previous and next products. The outer two buttons move to the first and last products.

    Since Modify Products is in the work area, all menus, toolbars, and buttons are accessible. The Add menu item on the Items menu opens the Add a New Product dialog. The Delete, and View Details menu items delete and view the current product.

    Any changes a user makes to a product will be saved when the user moves to a different product, or leaves the Modify Products area. The system will verify the information, and if valid, update the product. If the information is not valid, a dialog explaining the error will be displayed asking the user to either change the incorrect information, or discard the changes.

    If two or more users attempt to modify the same product, the system will display a dialog explaining the situation and give the choice of overwriting the other user's changes, or discarding the user's own changes.

    Salespeople are not allowed access to this area.