source: WAeUP_Doc/OldDocumentation/InstructionsPart4.txt @ 4468

Instructions Part 4 
+++++++++++++++++++

Testing the SRP Application and Accommodation Modules 
+++++++++++++++++++++++++++++++++++++++++++++++++++++

1. Open your Firefox browser (IE is not recommended but does also work) and login as manager. You can do that either through the unben-local.waeup.org portal or through the uniben.waeup.org portal. The latter is recommended when opening the website from outside the btedu LAN on campus.

2. Click the 'Hostels' navigation tab.

3. Click 'Add Hall'.

4. Fill all fields. Fields marked with a red star are required. Hold CTRL and click to select multiple beds. Do not click bed letters which are not available. The bed letters must correspond with the number of 'Beds per Room'.

5. Click 'Create' and a new Hall object will be created. 

6. To create a new university-wide bed list or to update an existing one, go to the Accommodation Section (Up one level) and click 'Update Bed List'. Within one second the bed list for the entire accommodation section is created/updated and a bed statistics shows up. In the first part of the statistics you'll see how many new beds have been created. In the second part you can see the total number of beds and the number of booked beds in all halls. If you want to see the bed statistics of a particular hall, click the respective link and you'll get the same information only for this hall. Moreover, you'll see the list of students staying in this hall. Clicking on the student's Id will directly bring you to the respective student's record.

 **Important:** Existing beds in the bed list will never be changed! If you modify the hall specifications, beds will only be added **not** deleted or rededicated. To delete beds (e.g. you want to reduce the number of beds per room) you have to delete the entire hall. Then all beds will be removed and the booking information is lost. 

7. Click the 'PINs' navigation tab.

8. Click 'Add Scratch Card Batch' and select 'Hostel Application' from the prefix pull-down menu, then click create. A csv file with prefix HOS will be automatically generated and copied to the WebDAV srp-import folder at https://dav.waeup.org. Please look at the time of creation which is part of the file name. Probably several testers also created test batches already.

9. Go to the PIN Batches again and click the respective 'Pin Batch HOS BatchNo #' link of the batch which you just added. Then you can see a list of unused PINs and a list of used PIN's together with the Id or JAMB registration numbers of the students who used the PINs. The links will bring you directly to the students' records. The list of unused PINs is only available during the testing period. 

10. Print this list or write down some PINs. Print also the already existing APP PIN list which you need in step 12 to apply for PUME.

11. Log out (and close all browser windows if you have opened more than one).

12. Apply for PUME following steps 10-15 of the Instructions Part 3. 

 **New features:**  (a) Your passport picture will be automatically resized on the server by Python imaging software. At the moment, passport resizing does not work from the Uniben server because the necessary software is not yet installed. (b) The registration status box provides links to the respective registration stages. (c) The 'My Study' tab in the navigation bar shows a list of registration objects. Please look at this list before you apply. You'll see an [edit] link which brings you back to the passport upload form. 

13. Click 'My Accommodation' tab in the student's navigation bar, enter a Hostal Application PIN (HOS PIN) from the list printed before and click 'Book'.

14. Your bed has been booked, your 'Accommodation Record' is shown and you are requested to enter the Maintenance Fee PIN. 

15. Click on 'Accommodation Slip'. The combined 'Hostel Allocation Slip (and Maintenance Receipt)' will show up in an external window. It shows the application data together with your passport picture and the hostel application data record. The Maintenance Fee entries are still empty.

16. Enter the the Maintenance Fee PIN. The PIN prefix depends on the hall where a bed has been booked for you. The instructions on the current page show the code (prefix) and price of the respective Maintenance Fee scratch card. After pressing the 'Save' button your Accommodation object will be closed and your entire Accommodation Record schows up.

17. Click on 'Accommodation Slip' again. The Accommodation Slip now gives also evidence that you have paid the Maintenance Fee. 

18. Log out, close all windows and log in as manager again. Click 'Staff Login' and enter your manager user name and password. 

19. Click on 'Hostels' and then on the name of the hostel where you just booked the room. Your student should be listed at the end of the table. 

20. Finished