Lawrence Shepperd Candidate number: 9128 Centre Number: 26202

Transcription

1 Data Structures and variables Data Structure Documentation Table Users Field name Data Type Description Usercode Text Contains the username, which the user will enter in order to log in. FullNames Text Contains the user s full name to allow the staff to easily search through records. Passcode Text The string the user will use to verify they are the appropriate person is using an account. AccountStatus Number (Integer) A number determining the status of a person s account. 1=administrator, 2=staff, and 3=student. Points Number (Integer) The total number of points a student has in their account. For administrators and staff members, this field is left blank. Comment Text The comment of the last staff member to modify the students points total. CommentLeav er Text Contains the name of whoever left the last comment, so students can determine LatestAction Number An integer holding the latest change to the points total of the account. ForcePasswor dchange Yes/No (Boolean) A Boolean indicating whether the user will be forced to change their password next time they login. Table prizes Field name Data Type Description Prize Text This contains the name of the prizes that the students can purchase with their prizes. Points Number (Integer) This contains the points cost of the prizes that the students can purchase. Table admin Field name Data Type Description DateA Text Contains the date of any action involving the student redeeming points for prizes. Username Text Holds the username of the person who redeemed their points for prizes. NameA Text Holds the name of the person who redeemed their points for prizes. Prize Text Holds the prize that the person redeemed their points for. Subroutine documentation (See code annotations for more detail) Subroutine name Enter Name Form btncont_click Back fmrname_shown Login Form Form1_FormClosed Description Adds the users name to the database, then calls the Back subroutine. Returns the user to the appropiate form. Changes the AcceptButton (code executed when the enter button is pressed). Completely closes all open forms of the application.

2 Form1_Load Creates the initial connection to the database. btnloggin_click Checks user-name and password, then directs the user to the appropriate form. Main Administrator Form frmadmin_formclosed Completely closes all open forms of the application. btnmulti_click Shows the Create multiple accounts form. btnsingle_click Shows the create single account form. btndelete_click Shows the delete accounts form. btnloggout_click Restarts the application. btnview_click Shows the ordered prizes form. btnmanedge_click Shows the Manage prizes form. btnchangepassword_ Shows the Password Change Form. Click Delete Accounts form btndel_click Deletes specified account. Returns the user to the Main administrator form. frmdelete_formclosed Completely closes all open forms of the application. frmdelete_shown Calls the UpdateTable Subroutine UpdateTable Loads the data view grid with all of the current accounts, the user-names, names, points totals, and account status'. Manage prizes form btnadd_click Adds a new prize to the database. frmmaedge_formclos Completely closes all open forms of the application. ed btndel_click Deletes a specified prize. Returns the user to the Main administrator form. TabelPopulate Loads the data view grid with all of the current prizes, listing there names and points cost. frmmaedge_shown Calls the TabelPopulate subroutine. Create Multiple Accounts form frmmulti_formclosed Completely closes all open forms of the application. Returns the user to the main administrator form. btncreate_click Creates multiple accounts based on user specified settings. Ordered Prizes Form frmordered_formclos Completely closes all open forms of the application. ed PopulateTabel frmordered_shown Password Change Form btnconfirm_click Back btncancel_click frmpass_formclosed frmpass_shown This loads the table with a list of all orders, their date, the user-name, and name of whoever ordered it, and the prize ordered. Returns the user to the main administrator form. Calls the PopulateTabel Subroutine. Changes the users password and calls the Back subroutine. Returns the user to the appropriate form, based on account status. Calls the Back subroutine. Completely closes all open forms of the application. Changes the AcceptButton (code executed when the

3 enter button is pressed). Prize redemption Form frmprizes_formclosed Completely closes all open forms of the application. populateprizes Fills the list box with a list of all of the prizes from the database. lstprize_selectedindex Changes a label showing a description of the current Changed prize. btnredeem_click This deducts points from the user, according to the prize they ordered, and adds a new record to the admin table, detailing the time, user-name and name or whoever ordered the prize, and what prize they ordered. Returns the user to the student form. frmprizes_shown Changes a personalized label to display the users points total and name, and calls the populateprizes subroutine. Create Single accounts Form Returns the user to the main administrator form. frmsingle_formclosed Completely closes all open forms of the application. btncreate_click Creates a single account according to the parameters the user entered. Staff Form frmstaff_formclosed Completely closes all open forms of the application. PopulateListBox This loads the list box with the names of all of the students from the Users table in the database. btnsearch_click This clears the list box, and then loads only students with names starting with certain specified letters. txtsearch_click Changes the AcceptButton (code executed when the enter button is pressed). txtsearch_textchange Changes the AcceptButton (code executed when the d enter button is pressed). btngo_click Changes the points total of the currently selected student in the list box, and adds the comment in a text box to the database. btnloggout_click Restarts the application. frmstaff_shown Calls the PopilateListBox subroutine, and changes the AcceptButton (code executed when the enter button is pressed). btnchangepassword_ Shows the password change form. Click Student Form frmstudent_formclose Completely closes all open forms of the application. d btnredeem_click Shows the Prize redemption form. btnloggout_click Restarts the application. frmstudent_shown Calls the UpdatePoints subroutine. btnchangepassword_ Shows the change password form. Click Module1 PassForm Returns a value based on weather a logging in user needs to have there password changed. NameForm Returns a value based on weather a logging in user needs to enter their name.

4 modulus Loggout UpdatePoints Returns Returns number entered positively, regardless of sign. Changes a label on the Student form, displaying the current points total of the logged in student. Local Variable Documentation Variable name Data Type Description MessageReturn Integer This holds a number determining what the user selected when presented with a choice in a message box. dbprovider String Used, in addition to other variables, to create the initial database connection. dbsource String Used, in addition to other variables, to create the initial database connection. startuppath String Used, in addition to other variables, to create the initial database connection. ds DataSet This is the dataset used to hold all of the records from one database table. da OleDb.OleDb DataAdapter This is the adapter between the dataset and the database. sql String This is used to interface between the dataset and the database. cb CommandBuil der This is the command builder used to update the dataset. ds1 DataSet This is the dataset used to hold all of the records from one database table. It is used when more than one dataset is required in a subroutine. da1 OleDb.OleDb DataAdapter This is the adapter between the dataset and the database. It is used when more than one data adapter is required in a subroutine. sql1 String This is used to interface between the dataset and the database. It is used when more than one sql statement is required in a subroutine. cb1 CommandBuil der This is the command builder used to update the dataset. It is used when more than one command builder is required in a subroutine. ds2 DataSet This is the dataset used to hold all of the records from one database table. It is used when more than two datasets are required in a subroutine. da2 OleDb.OleDb DataAdapter This is the adapter between the dataset and the database. It is used when more than two data adapters are required in a subroutine. sql2 String This is used to interface between the dataset and the database. It is used when more than two sql statements are required in a subroutine. a Integer This is used in loops, as the variable which changes on each loop. b Integer This is used in loops, as the variable which changes on each loop. This is used when stacked loops are required (loops inside loops). c Integer Used to count how many times code in a loop is performed.

5 Username String Used to hold the user name during the login phase of the program, to allow for validation and processing. Password String Used to hold the password during the login phase of the program, to allow for validation and processing. loggin Integer Used to determine the account status of the user logging in. ActiveData String Used to store the data currently being searched for in the database. Generally used in if statements inside loops. Count Integer Used to store the number of rows in a table of the database. Loops are often executed until a = count. Delname String Used in the delete account subroutine to store the account currently being deleted, allowing for validation and processing. Prizename(array) String One dimensional array used as temporary storage when re-sorting the prizes database. Prizecost(array) Integer One dimensional array used as temporary storage when re-sorting the prizes database. NoOfAccounts Integer Integer used for storing the number of accounts to be created in the creating multiple accounts process. UserId Integer Used to hold the position in the database of the currently logged in user, allowing for simple modification of that row. NewRow DataRow Used to add a row to the database. A new row must be created before it is added. PointsChange Integer Used to hold the number of points to be added or subtracted from a student when a staff member is changing their points total. person String Used to hold the name of the currently selected name in the list box. This name is then found in the database. LoggedIn String Holds the user-name of the currently logged in user. FormFrom Integer Keeps a record of which form the user came from, so they can return to the correct form after visiting shared forms, like the password change form. Global Variable Documentation Variable name Data Type Description LoggedIn String Holds the user-name of the currently logged in user. This allows the program to search for the user in the database and then edit details pertaining to the user. FormFrom Integer Keeps a record of which form the user came from, so they can return to the correct form after visiting shared forms, like the password change form. Con OleDb.OleDb Used, in addition to other variables, to create the

6 Connection initial database connection. Object Documentation Object Name Type Description Enter name Form lblname Label Contains the text Please enter your name. txtname Text Box Allows the user to enter their name. btncont Button Causes the name entered to be transferred to the database, and the user to be transferred to the appropriate next form. pctlogo Picture box Contains the Greenparks school logo. Login Form lbluser Label Contains the text Username indicating which text box is for the user-name. lblpass Label Contains the text Password indicating which text box is for the password. txtuser Text Box Allows the user to enter their user-name. txtpass Text Box Allows the user to enter their password. btnloggin Button Causes the login process, directing the user to the appropriate next form. lblwelcom Label Contains the text Greenparks reward scheme!, indicating what program the user is useing. Main administrator Form lblgreet Label Contains the text Greetings Administrator btnmulti Button Shows the create multiple accounts form. btnsingle Button Shows the create single accounts form. btnchangepas Button Shows the change password form. sword btndelete Button Shows the delete accounts form. btnmanedge Button Shows the manage prizes form. btnview Button Shows the Ordered prizes form. btnloggout Button Restarts the application. Delete accounts Form lbldescription Label Contains a description of the delete accounts form. rad1 Radio Button Allows the user to delete an exact match to their entered string. raad2 Radio Button Allows the user to delete all accounts starting with their entered string. txtname Text Box Allows the user to enter in a string to delete btndelete Button Causes accounts to be deleted according to the entered data. lblcomplete Label Describes the data grid below it. tbl1 Data Grid View Contains a complete list of all users in the database, their user-names, points total, name, and account status. Manage prizes Form

7 lbladd Label Contains the text Add or delete a prize, describing the function of the form. lblcurrent Label Contains the text Current Prizes describing the data grid below it. lblname Label Contains the text Prize name indicating the text to go in the nearby text box. txtname Text Box Allows the user to enter the prize name to delete of create. btndel Button Causes the entered prize to be deleted. btnadd Button Causes the entered prize to be created. tbl1 Data Grid View Contains a complete list of prizes, and their points cost. Create multiple accounts Form lbluser Label Contains the text User Prefix informing the user where to enter the user prefix. lblpassword Label Contains the text Password informing the user where to enter the password. lblconpass Label Contains the text Confirm Password informing the user where to confirm the password. lblno Label Contains the text Number of Accounts informing the user where to enter the number of Contains the text Account Status informing the user what the adjacent radio buttons are for. lblaccountstat Label us lblchange Label Contains the text Force Password Change informing the user what the adjacent radio buttons are for. btncreate Button Creates the accounts the user entered the details for. txtpre Text Box Allows the user to enter the user prefix. txtcpassword Text Box Allows the user to enter the password for the new txtconpass Text Box Allows the user to confirm the password entered. txtno Text Box Allows the user to enter the number of accounts they wish to create. radstudent Radio Button Allows the user to choose to create student radstaff Radon Button Allows the user to choose to create staff radadministrat or Radio Button Allows the user to choose to create administrator Panel1 Panel Groups one set of radio buttons, so one radio button from each set can be selected. radyes Radio Button Allows the user to choose to force a password change on next login for the new radno Radio Button Allows the user to choose not to force a password change for the new Ordered Prizes Form tbl1 Data Grid View Contains a list of 5 records of ordered prizes, containing the date ordered, user-name and name

8 of whoever ordered the prize, and what prize was ordered. lblrecent Label Contains the text Ordered Prizes, describing the Data Grid View below it. Password change form lblold Label Contains the text Old Password, indicating the user must enter their old password in the adjacent text box. lblpass Label Contains the text New Password, indicating the user must enter their old password in the adjacent text box. lblconfirm Label Contains the text Confirm New Password, indicating the user must enter their new password again in the adjacent text box. txtold Text Box Allows the user to enter their old password. txtnew Text Box Allows the user to enter their new password. txtcon Text Box Allows the user the confirm their new password. btnconfirm Button Change the users password, and returns them to the appropriate form. btncancel Button Returns the user to the appropriate form. Prize Redemption Form lblwelcome Label Contains a personalized welcome message. lbldec Label Contains a description of the currently selected prize in the list box. btnredeem Button Deducts the cost of the prize of the users accounts, and creates a new order in the administrator table of the database. btnback Button Return the user to the main student form. lstprize List box Allows the user to select whatever prize they want. Create single account Form lbluser Label Contains the text Username informing the user where to enter the user-name. lblpassword Label Contains the text Password informing the user where to enter the password. lblconpass Label Contains the text Confirm Password informing the user where to confirm the password. lblaccountstat us Label Contains the text Account Status informing the user what the adjacent radio buttons are for. txtusername Text Box Allows the user to enter the user-name. txtpassword Text Box Allows the user to enter the password for the new txtconpass Text Box Allows the user to confirm the password entered. radstudent Radio Button Allows the user to choose to create student radstaff Radio Button Allows the user to choose to create staff radadministrat or Radio Button Allows the user to choose to create administrator btncreate Button Creates the account the user entered the details

9 for. Staff Form radadd Radio Button Allows the user to select to add points to a student account. radsub Radio Button Allows the user to select to subtract points from a student account. lblpoints Label Contains the text Points to add/subtract indicating the purpose of the adjacent text box. txtpoints Text Box Allows the user to enter the number of points to add or subtract. lblcomment Label Contains the text Optional Comment indicating the purpose of the adjacent text box. txtcomment Text Box Allows the user to enter an optional comment. lststu List Box Contains a list of all student names, allowing the staff member to add or subtract points from student account. txtsearch Text Box Allows the user to enter a string to search through the students names. btnsearch Button Searches through the students names for the entered string. btnchangepas Button Shows the change password form. sword btnloggout Button Restarts the application. btngo Button Executes the desire operation (adding/subtracting points from a student), and updates the database. lblwelcome Label Contains the text Greetings staff user!, welcoming the staff member. lblstudentsear ch Label Contains the text Search for a student to indicate where text must be entered to search for a student. Student Form lblwelcome Label Contains a personalized welcome message including the users points total. lblpast Label This shows the latest change to the points total by a staff member, including a comment. btnhelp Button Displays a message box which contains an explanation of how the points system works. btnloggout Button Restarts the application. btnredeem Button Shows the redeem prizes form. btnchangepas sword Button Shows the change password form.