21 user manual_webservices_1

REQUIREMENT CONFIRMATION

(UAT: USER ACCEPTANCE TEST)

FORBWM – MOTOR FRANCHISE PROJECT

Module: Web Services

Assignment: Team Assignment

Team Name: SPOCK

Created by Team Members

Reviewed by Team Members

Created Date 24 March 2012

Revised Date 27 April 2012

Revision No. 1.0

Document Name F02-001

** For test and confirm requirements

http://aces-web.aces.shu.ac.uk/students/b1046615/default.aspx




LOGIN TO SYSTEM2

1. Go to website http://aces-web.aces.shu.ac.uk/students/b1046615/default.aspx

2. Login to system

• Fill User Name: [User]• Fill Password: [Password]• Click “Log In”

Comment:

There are three role-based users with different authorizations

1. Customer: no login

2. Staff: user: staff, password: staff

3. Admin: user: admin, password: admin

1

2








LIST OF REQUIREMENTS

3

1) WEB SERVICE FOR EXPOSE

VEHICLE INFO

4

Requirement#1

Develop a Web service which exposes vehicle information for a

selected vehicle at your franchise.

1.1 WEBSERVICES VEHICLE INFO5

This page shows how our web services work as following testing.

1. Login as “admin”

2. Click at Menu “Our Web Services” and “Get Vehicle Info”

3. Enter Register Number

4. Click Get Data

5. Basic Vehicle Info shows in the table (Grid View)

4

2

3

5

1

Login as admin ( User: admin and Password: admin)

1.2 WEBSERVICES VEHICLE INFO

(ALL INFO.)6


2. Click at Menu “Our Web Services” and “Get Vehicle Info (All)”

3. Enter Register Number

4. Click Get Data

5. All selected vehicle information will be shown in the table (Grid View)

4

2

3

5

List of Franchise's web services

http://aces-

web.aces.shu.ac.uk/students/b1046615/

Service.asmx

1


http://aces-web.aces.shu.ac.uk/students/b1046615/Service.asmx




2) MAINTAIN VEHICLE INFO

7

Requirement#2

• Staff at your branch must be able to record the vehicles they

have sold at their own garage in a database.

• Staff should be allowed to read, update and delete these

sales details.

A) OUR SELLING STATUS

CONCEPT8

CHANGE STATUS TO

SOLDDELETE

UPDATE DELETE

SELLING STATUS = SELLREGISTERED AT SALES TABLE AT BWM SITE

SELLING STATUS = NON-SELLREGISTERED AT REGISTER TABLE AT BWM SITE

Explanation

1. Garage staff can record vehicle that they have sold by 2 steps

1. Register “Vehicle for sales” (See slide 11)

2. Use “sell this car” function. (See slide 16)

2. Garage website has three types of selling status (NON-SELL,

SELL, SOLD)

3. There are two types for registration a vehicle

• Register For Sales (Selling Status = SELL)

• Register For A New Vehicle (Selling Status = NON-SELL)

4. Only SELL Vehicle can update to SOLD.

5. Only NON-SELL Vehicle can be updated data because there are

no web services provided for “Vehicle for Sales” ** However, we

provide work around at the last two slides of 36-37

6. Both SELL and NON-SELL Vehicles can be deleted

CHANGE STATUS TO

SELL

Need Price

Need Customer

Information &

selling price

B) CONCEPT OF

MAINTAINING VEHICLE DATA9

REGISTER FOR

SALES

INSERT atGarage Database

(SellingStatus=SELL)

CALL WEB SERVICES (RegisterVehicleForSale

)

REGISTER FOR

NON-SELL (A New Vehicle)

INSERT at Garage Database

(SellingStatus = NON-SELL)

CALL WEB SERVICE (RegisterNewVehicle)

UPDATE VEHICLE FOR NON-SELL(A new vehicle

registered)

UPDATE atGarage Database

CALL WEB SERVICES (UpdateAVehicle )

DELETE VEHICLE

CALL WEB SERVICES (DeleteVehicleFromSalesT

able)

SellingStatus

CALL WEB SERVICES (DeleteVehicleFromRegist

erTable )

SOLD VEHICLE(Vehicle registered for

sales)

UPDATE Garage Database

(SellingStatus = SOLD)

CALL WEB SERVICES (SetVehicleAsSold)

Register Vehicle Update Vehicle Sold Vehicle Delete Vehicle

SELL NON-SELL

2.1 SEARCH VEHICLE10

1. Click at “Search Vehicle”

2. Enter Searching Criteria

3. Click “Find” button

4. Click “Preview Details”

5. Car Details will be shown as below

1

2

3

4

5

Login as admin ( User: staff and Password: staff)

Testing Steps:


2. Fill Searching criteria and Click Find

3. Click “Sell this car”

** See next steps on next page

Comment:

1. Before do function “Sold vehicle”, garage staff have to register for sales first (See slide 16)

2. Only vehicle registered for sales can use this function.

2.2 SOLD VEHICLE11

1

2

3


4. Select Option for marking SOLD- Selected: Update SOLD in garage DB and

Delete in BWM web site- Unselected: Update SOLD both in garage

DB and BWM web site without deleting

5. Enter Selling information

6. Click button “Save and update data at BWM”

Option for marking SOLD is captured from below requirements (Assumption)

2.2 SOLD VEHICLE

(CONT.)12

5

4


6

Requirement#4

• Develop an ASP.Net page which consumes

XML Web service(s) provided by BWM

Head Office such that garage staff can

update a listed vehicle and change its status

to sold thereby removing the listing from the

Head Office web site.

Our assumption with regards to Requirement#4

"Our judging by the tables (View Sales) on BWM head office with updated

column of "SoldFor","DateSold" and "SoldBy", this contradicts with the

requirement. We have included both options in our website. If the check box

is not tick, the record remains in BWM headoffice. Should required, ticking the

checkbox would remove it from BWM View Sales table.

2.3 DELETE VEHICLE13


2. Fill Searching Criteria and click Find

3. Click button “Delete this Car”

Comment

1. Vehicle details will be deleted both in franchise's database and BWM website

2. Web services used for deleting are depended on Selling Status

- Selling Status = SELL uses the web service named “DeleteVehicleFromSalesTable”

- Selling Status = NON-SALES uses the web service named “DeleteVehicleFromRegisterTable”

1

2

3


2.4 CONVERT VEHICLE14


2. Enter Searching Criteria and click Find

3. Click “Update Car”

4. Click button “Save and Register for Sales at BWM”

Comment

1. Selling status in the garage database is changed from NON-SELL to SELL

2. Vehicle record in “Vehicle Register table” at BWM is deleted

3. Vehicle record is registered as “vehicle for sales” at BWM web site

Login as admin ( User: staff and Password: staff)From NON-SELL to SELL

1

2

3

4

3) REGISTER VEHICLE FOR

SALES AND NON-SELL

15

Requirement#3

• Develop an ASP.Net page which consumes XML Web

service(s) provided by BWM Head Office such that garage

staff can register a vehicle for sale. A listing for the vehicle will

then appear on the BWM Head Office web site.

3.1 REGISTER VEHICLE FOR SALES16

1. Click menu at “Register Vehicle” > “Register Vehicle for Sales”

2. Fill Basic information

3. Fill Additional Information

4. Select picture files

5. Click “Save and Register to BWM

Comment

• Selling Status • SELL : Register for Sales• NON-SELL: Register to BWM for

other objectives at the “Vehicle Register” table

• Basic Information is transferred to BWM website and saved into the garage database.

• Additional information is be saved into the garage database.

1

4

2

5

3

Login as user ( User: user and Password: user)

3.1 REGISTER VEHICLE FOR SALES

(CONT.)17

6. Web shows message status after vehicle is registered completely.

7. Click “Preview Car” to preview car details registered

8. Car details shows in to “Preview Car Information” page

9. Car information is registered in the “Register For Sales” Table at BWM website

Comment

• Website want .net permission to upload pictures into web servers.

• If the BWM web service for car registration has problem, the system registers data at garage database only. However, staff can re-synchronize car at “Syn. Data” menu

6

7


89

3.2 REGISTER A NEW VEHICLE

FOR NON-SELL AT REGISTER TABLE18

1. Click menu at “Register Vehicle” > “Register a New Vehicle”

2. Fill Basic information

3. Fill Additional Information

4. Select picture files

5. Click “Save and Register to BWM

** Cont. next page

1

4

2

5

3


19

6. Web will show message status

7. Click “Preview Car” to preview car details registered

8. Car information shows in to “Preview Car Information” page

9. Car information is registered in Register For Sales Table at BWM website

67


8

9

3.2 REGISTER A NEW VEHICLE

FOR NON-SELL AT REGISTER TABLE (CONT.)

4) UPDATE VEHICLE AND CHANGE STATUS

TO SOLD

20

Requirement#4

• Develop an ASP.Net page which consumes XML Web

service(s) provided by BWM Head Office such that garage

staff can update a listed vehicle and change its status to sold

thereby removing the listing from the Head Office web site.

4.2 UPDATE VEHICLE21

1. Click menu at “Search Vehicle”

2. Search a vehicle that want to update

3. Click “Update Car”

4. Update car details

5. Click “Save and Update to BWM”

6. Data is updated at BWM

Comment

• Data will be updated both in garage database and at BWM website (for NON-SELL vehicle)

• Updating vehicle at BWM website by using SOAP authentication.

• Website will report updating status to BWM website after click “Save and Update to BWM”


2

1

3

4

5

Please see slides 37 – 37 how to

update vehicle registered in “Vehicle

For Sales” Table at BWM

5) USER AUTHENTICATION

22

Requirement#5

• Your system must authenticate staff at your branch

5. USER AUTHENTICATION23

1. User fill user name and password

2. Click login

Comment

There are three role-based in our website

1. Customer: No login

2. Staff: User: staff, Password: staff

3. Admin: User: admin, Password: admin

1

2

User Main Functions

Public User/ Customer

Search BWM info, search vehicle info

Garage StaffMaintain Vehicle, mark sold to

vehicle, re-syn data

AdminRegister User, Test garage web

services

http://aces-web.aces.shu.ac.uk/students/b1046615/10_USER/02_Login.aspx




ADVANCED FUNCTIONALITY

24

6) USE SECURED XML TO SEARCH, REGISTER,

AND UPDATE VEHICLE AT BWM SITE

25

Requirement#6

• Develop an ASP.Net page which consumes a secured XML

Web service(s) provided by BWM Head Office such that

garage staff can search a register of vehicles, entering a new

vehicle or updating details of an existing vehicle as required.

6. CONSUME TUTOR’S WEB SERVICES

( T H I S S L I D E S U M M A R I S E S B O T H S E C U R E D A N D N O N - S E C U R E D )

26

REGISTER VEHICLE UPDATE VEHICLE

MARK SOLD (NON-SECURED) DELETE VEHICLE

TUTOR’S WEB SERVICES

Garage website consumes all web services.

1. Register vehicle: depends on Selling Status (SELL OR NON-SELL) (Secured and non-secured)

2. Update vehicle: both garage and tutor’s database (Secured web service)

3. Mark sold: Change status at garage database and tutor database (Non-secured web service)

4. Delete vehicle: Delete both tutor and garage database (Both secured and non-secured)

6.2 SECURED XML

( SOURCE CODE EXAMPLES)

27

REGISTER UPDATE DELETE

7) WEB SERVICES FOR MONITOR ORDER OVER A

SPECIFIED TIME PERIOD

28

Requirement#7

• You should expose a web services to help head office

monitor orders fulfilled by value at your franchise over a

specified time period.

EXAMPLE OF

US ING OUR WEBSERVICES TO MONITOR SALES29

This page shows how our web services work as following test.


2. Click at Menu “Our Web Services” and “Get Order Info (Sold Vehicle)”

3. Enter “From date” and “To Date” format mm/dd/yyyy (not validate data)

4. Click Button “Get Data”

5. Sold Vehicle Info will be shown in the table (Grid View)

1

2

3 4

5


List of Franchise's web services

http://aces-

web.aces.shu.ac.uk/students/b1046615/Service.a

smx





8) BWM INFORMATION

30

Requirement#8

Your system must also act as online presence for the benefit of

consumers. Users must be able at a minimum to access information

about BWM, BWM’s various products and services, etc. You may think

about a number of value added services inline with electronic business

thinking and culture.

1) BWM INFORMATION31

Source taken from www.bmw.co.uk

1. Go to http://aces-web.aces.shu.ac.uk/students/b1046615/default.aspx

2. Click Menu BWM Info

** No need to login






2) BWM CAR INFORMATION32


2. Click Menu BWM Car

Source taken from www.bmw.co.uk

LINK TO BWM PRODUCT DETAILS

LINK TO BWM PRODUCT DETAILS






3) SPOCK INFORMATION33

CONTACT AND MAP ABOUT SPOCK ABOUT US (DEV. TEAM)

4) SEARCH CAR INFORMATION BY CUSTOMERS OR PUBLIC USERS

34


2. Click menu “Customer Search”

3. Fill searching criteria

4. Click search

5. Click “Preview Details” to see vehicle details

6. Click E-mail to send e-mail to garage by MS Outlook

Comment:

• User can use Quick Search to fill key words, system then select data from various columns in the table

2

4

5

3

1

6

5

6






ADDITIONAL FEATURES

35

WORK ALLOW TO UPDATE VEHICLE

REGISTERED IN SALES TABLE AT BWM

(SELL & SOLD VEHICLE IN SALES TABLE)

36

Update in Garage DB

Delete Vehicle at BWM (DeleteVehicleFromSalesTable)

Register Vehicle for Sales with old reg_no

(RegisterVehicleForSale )

Selling Status

Mark Sold(SetVehicleAsSold)

Finish

SOLD SELL

REASON:

There are no BWM webservices

for updating vehicle in Sales Table

Work Allow

1. Delete vehicle at BWM

2. Register vehicle for sales with

new data updated by staff

• Use old Reg_no

3. Mark sold with same data

Benefit

1. Garage staff can update data

in garage database

2. Increase data consistency

UPDATE VEHICLE (SELL & SOLD IN SALES TABLE AT BWM)

PROCEDURES

37

STEPS

1. Search vehicle (Selling Status = SELL

or SOLD) and click “Update Car”

2. Enter Updated data

3. Click Update

4. Click Save and Update BWM

Comment

1. This feature supports vehicles

registered in Sales table.

1

2

3

UPDATE VEHICLE (SELL & SOLD IN SALES TABLE AT BWM)

Technology

21 user manual_webservices_1