0% found this document useful (0 votes)
22 views21 pages

Online Book Club Login Guide

The Online Book Club project is a web-based platform that allows users to create accounts, log in, and rate books from 1-5 stars. It includes features for viewing book details, submitting new books, and managing personal information. The project requires Windows 7 or later, .NET Framework 4.7.2, and Microsoft Access for database management.

Uploaded by

fansam1298
Copyright
© All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
0% found this document useful (0 votes)
22 views21 pages

Online Book Club Login Guide

The Online Book Club project is a web-based platform that allows users to create accounts, log in, and rate books from 1-5 stars. It includes features for viewing book details, submitting new books, and managing personal information. The project requires Windows 7 or later, .NET Framework 4.7.2, and Microsoft Access for database management.

Uploaded by

fansam1298
Copyright
© All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd

ONLINE BOOK CLUB

PROJECT
DOCUMENTATION

MARCH 17, 2020


MIKHAIL GOULDING
Table of Contents
Program Design...................................................................................................................................... 2
Program Description .............................................................................................................................. 3
Operating System .................................................................................................................................. 3
System Requirements ............................................................................................................................ 4
The type and version of programs used................................................................................................. 4
Installation and Setup ............................................................................................................................ 5
Website.................................................................................................................................................. 9
Account Creation ............................................................................................................................. 10
Login ................................................................................................................................................ 11
View Books....................................................................................................................................... 12
Rate Books ....................................................................................................................................... 13
Submit Books ................................................................................................................................... 14
Change Personal Details .................................................................................................................. 14
Change Password ......................................................................................................................... 15
Log File ............................................................................................................................................. 16
Database .......................................................................................................................................... 17
IntelliSense warnings in the Online Book Club Project ........................................................................ 19
Bibliography ......................................................................................................................................... 20

Page | 1
Program Design
My project folder contains 4 folders:

o Online Book Club


▪ The website project folder.
o Book Club Web Service
▪ The web-service project folder.
o Resources backup
▪ Backup files. This folder can be ignored.
o Documentation
▪ The folder containing this document as pdf and docx.

The website uses an access database in order to store the book, user and rating information.
The access database can be found in “…\Online Book Club\Online Book Club\[Link]”

The access database contains 3 tables:

o Books
o Book details stored here.
o Ratings
o User ratings for books stored here.
o Users
o User details stored here.

A backup of the access database can be found in the “Resources backup” folder. Please note that this
is just a backup and will not update when information is changed/added through the website.

A log file, which logs ratings, can be found here: “\Online Book Club\Online Book Club\[Link]”

Please note that all the files in the website section below, are web-forms that each have their own
code-behind file ([Link]).
Below is a list of the main files in each project, and a short description of each:

• Web service (Book Club Web Service)


o [Link]
▪ All web-methods used for interacting with the database are stored here.
o [Link]
▪ This class stores the details of a book, in order to use it as a return object.
• Website (Online Book Club)
o [Link]
▪ The master page, used to load the navigation bar and footer, for all pages in
the website.
o [Link]
▪ The home page, please start here.
o [Link]
▪ The user logs in from this page.

Page | 2
o [Link]
▪ The user creates an account from this page.
o [Link]
▪ Information about the website is shown here.
o [Link]
▪ Contact information is shown here.
o [Link]
▪ Terms and Conditions page.
o [Link]
▪ Privacy Policy page.
o [Link]
▪ Used for entering a username, when user wishes to reset his password.
o [Link]
▪ The user resets his password from this page.
o [Link]
▪ Displays a list of all books in the database. User can select a book.
o [Link]
▪ User can view information about the selected book. User can rate the book
and view the average rating.
o [Link]
▪ User adds a new book to the database from this page.
o [Link].
▪ User can reset or view his personal details from this page.

Program Description
This project is a rating website. It allows users to rate books from 1-5 stars, and post books to be
rated.

The main features of the website are listed below:

o Create an account.
o Log-in / log-out.
o View list of books.
o View selected book’s details.
o Rate selected book and view book’s average rating.
o Write user rating details to log file.
o Submit a new book.
o Change personal details.
o Change password. (Separate from changing personal details.)
o Redirecting to login page if user attempts to view pages that require a successful logon.

Operating System
It is recommended that you use Windows 7 or later.
This program was only tested on Windows 7 and 10.

Page | 3
System Requirements
Windows 7 or later with .Net Framework version 4.7.2 and Visual Studios 2019 installed.

Dual Core Processor (2.4GHz+ recommended)

8GB RAM (required to run web-service and website)

At least 200 MB of available hard disk space available.

The type and version of programs used


Visual Studios 2019 with .NET Framework version 4.7.2 is used and required.
The program will NOT run without .NET Framework 4.7.2 installed.

Microsoft Access (part of Office 365) is required in order to read the access database.

Page | 4
Installation and Setup
Copy the project folder inside the CD/DVD drive. Do not attempt to run the project directly from the
CD/DVD, it will not function properly.

Paste the copied project to your desktop.

Page | 5
The project should now be on your desktop.

Inside the folder, the Book Club Web Service and Online Book Club need to be run. This will be
explained on the next page.

Page | 6
Inside the Book Club Web Service folder, open Book Club Web [Link]

Open [Link] in the solution explorer and press F5; or click the IIS Express
button.

Page | 7
The web service has now started; leave it open in the background. The website will not work if this is
not running.

Back inside the project folder, go to the Online Book Club folder and open Online Book [Link]

Page | 8
Open [Link] (the home page) in the solution explorer and press F5; or click the IIS Express
button.

Website
The website has now started. Make sure the web service is running, and then create an account.

Page | 9
Account Creation
This is the account creation page.

Example account creation:

Page | 10
Login
Once an account is created, you are redirected to the login page. (You can reset your password here,
or on the home page, once logged in.)

User login example:

Page | 11
View Books
Once logged in, you are redirected to the home page. (Same home page as before, just looks a bit
different when logged in.)
Click on the Books link in the navigation bar, or on the Start Rating books! link.

This is the books page. You can select a book or submit a new one.

Page | 12
Rate Books
Book selection:

Book selection after being rated:

Page | 13
Submit Books
Book submission page:

Change Personal Details


Back on the home page, while logged in, you can change your personal information or password by
clicking on the appropriate link.

Page | 14
On the profile page (found by clicking on change account details on home page), you can change or
view your personal details.

Change Password
On the reset page (found by clicking on change password on home page), you can change your
password. This can also be done by clicking on Forgot your password?, while attempting to log in.

Page | 15
Log File
Click on the open file icon inside the Online Book Club project in order to view the log file:

Open [Link] :

Page | 16
This log files logs information about user ratings. This is just a simple log file; the rating information is
properly stored inside the access database.

Database
In order to view the database, open [Link] inside the solution explorer of the Online Book
Club project.

Page | 17
The database has 3 tables, as explained here. It is safe to read the information, but do not attempt to
modify it. All information should be added through the website only. Preferably, do not have the
database open while running the website, you might run into an exception: “The table 'table-name'
is already opened exclusively by another user.”

Page | 18
IntelliSense warnings in the Online Book Club Project
This project has no build errors/warnings, but it does have a few IntelliSense warnings.

These warnings are false positives and should be ignored. IntelliSense does not fully support all
features of HTML5, meaning it will give a warning if you use a feature of HTML5 that it does not
know of. This does not in any way impact the program.

To hide these warnings, set your Error List in Visual Studio to Build Only.

Page | 19
Bibliography
Advanced C# Programming; MLAC185-01; Compiled by: Kyle Brunette, Angelique Kolle,
Lance Whyte, Cedric Maenetja, Daniel Sansom and Tatenda Tagutanazvo; Updated by:
Suhayl H Asmal, Bruce McLachlan and Sheunesu Makura; Edited by: Lia Marus; Version 1.2.1;
© October 2018 CTI Education Group.
[Link]
[Link]
[Link]
[Link]
[Link]

Page | 20

Common questions

Powered by AI

The system maintains data integrity and consistency through a controlled access approach, where all data modifications occur exclusively through the website interface. Users can add information such as book ratings or personal details via the site, ensuring changes are synchronized with the database in a structured manner. The system also advises against having the database open while running the site, as simultaneous access might cause an exception due to exclusive locks by another user. By restricting direct database access and using web services to handle updates, the system reduces the risk of conflicting modifications or data corruption .

Using a master page like Site.Master in the Online Book Club website design provides significant merits such as consistent layout and styling across all web pages, simplifying maintenance and updates since changes to the navigation bar or footer require only a single edit. This promotes a uniform user experience and reduces redundancy. However, potential drawbacks include limited flexibility for individual pages, which might require exceptions or modifications to deviate from the standard setup. Additionally, over-reliance on a master page can complicate responsive design adjustments tailored to specific pages or interactive elements that deviate from the primary design .

The Access database in the Online Book Club system functions as the central repository for storing critical data, including user details, book information, and ratings. It is structured into three main tables: Books, Ratings, and Users. The Books table stores details about each book, allowing users to view and select titles for more information or rating. The Ratings table contains user-generated ratings for books, supporting features such as average rating calculations and rating histories. The Users table holds personal data for individual members, supporting features like account creation and personalization .

IntelliSense warnings in the Visual Studio environment for this project are considered false positives and do not produce any build errors or functional issues. These warnings arise because IntelliSense does not fully support all HTML5 features, resulting in warnings for unfamiliar elements. While such warnings can initially clutter the error list and distract developers, they are clearly labeled, allowing developers to confidently ignore them. This approach emphasizes focusing on actual build errors instead of unsupported IntelliSense features, facilitating smoother development progress .

The Online Book Club system facilitates the addition of new books through the Add-Book.aspx page, where users can input details about new books they wish to add to the database. The process is robust through web service validation, ensuring that data conforms to expected formats and duplicate records are avoided by verifying against existing entries. This method also integrates directly with the database, adding books only through the designated web-form, preventing unauthorized modifications and maintaining database consistency .

The log file in the Online Book Club project serves as a strategic tool for monitoring and recording user interactions, specifically their ratings for books. Stored in ratinglog.txt, it provides a plain text record of user ratings, facilitating audits and user behavior tracking. While the log file captures these interactions, it is distinct from database storage in that it does not serve as the primary data repository; the access database maintains the full structured and queryable records of user ratings, which are required for dynamic website operations such as viewing average ratings or historical data management .

The key system requirements for running the Online Book Club and its web service include a Windows 7 or later operating system with .NET Framework version 4.7.2 and Visual Studio 2019 installed. A dual-core processor of at least 2.4GHz, 8GB RAM, and 200MB of available hard disk space are also necessary. These specifications are significant as they ensure sufficient processing power and memory for running both the web service and the website smoothly. The .NET Framework and Visual Studio 2019 are crucial for compatibility and execution of the project's code, which is developed within this environment, ensuring all .NET features are utilized effectively .

The Online Book Club's account creation and login pages are designed to interact securely with the backend by leveraging web-forms that communicate with the database through the defined web services. During account creation, user details are submitted via Create-Account.aspx, where they are validated and stored in the Users table after ensuring unique identification. On login at Login.aspx, user credentials are verified against database records to authenticate access. Secure handling of passwords, possibly with hashing, ensures data accuracy and prevents unauthorized access while maintaining overall system security .

To start both the Book Club Web Service and the Online Book Club application locally, first copy the project folder from the CD/DVD to the desktop, as running directly from the CD/DVD may cause issues. Navigate to the Book Club Web Service folder, open the solution file (Book Club Web Service.sln), then open BookClubWebService.asmx in Solution Explorer and press F5 or click the IIS Express button to start the service. Leave it running in the background. Next, go to the Online Book Club folder, open the Online Book Club solution file (Online Book Club.sln), open Default.aspx in Solution Explorer, and press F5 or click the IIS Express button to start the website .

The project documentation supports effective management and troubleshooting by providing a clear and detailed account of the system's architecture, including program design, system requirements, and installation procedures. Comprehensive documentation of web forms, database structures, and operational guidelines helps developers and IT personnel understand the system's workings, making it easier to identify and resolve issues. The presence of bibliographical references and troubleshooting guidance for IntelliSense warnings further enhances problem-solving efficiency by directing developers to additional resources and common pitfalls .

You might also like