SISfm Custom Folder

SISfm accesses the following files that require on-site customisation. These are accessed under a folder defined by the CustomFolder configuration setting. A set of these files is supplied in the default folder. A copy of this folder should be made named according to your organisation, CustomFolder set to point to it, and these files modified to suit your organisation.

If any expected file is absent from the custom folder, it is instead accessed in the default folder. Therefore, the custom folder only needs to contain files that need to differ from those in the default folder.

The custom folder also contains subfolders for modules containing their custom files, described separately for each module.

home\default.aspx   The SISfm home page. This should include links to each required SISfm module.
home\header.aspx
home\footer.aspx
Web pages defining the content to appear at the top and bottom of each SISfm page.
home\loginBar.gifThe SISfm login bar background image. Optional.
favicon.ico
favicon.png
favicon.gif
The SISfm page icon image. If more than one is present, the first of ico, png, gif is used. Optional. Older browsers may not support png or gif.
login.aspx
logout.aspx
The login and logout pages. logout.aspx is optional, if absent the Log Out link does not appear in the login bar. These pages are custom designed to suit your environment, but should conform to the functionality of the supplied examples in the default folder. These include a number of alternative scenarios, including Single Sign-On They should set the following session variables:
loggedIn True or False to indicate whether a user is logged in.
adsName The username entered when logging in.
adsPassword The password entered when logging in. Required if the DbConnectionLDAP setting specifies the .NET connection method.
accessSecurityUsername The name to be used for access security (if the DbAccessSecurity setting is TRUE). If not set then adsName is used. (This variable can be used to implement an access security model with different user names, a smaller number more akin to roles for example.)
accessSecurityGroups A comma separated list of group names to be used for access security for this user (if the DbAccessSecurity setting is TRUE). If set then adsName and accessSecurityUsername are ignored. (This variable can be used to implement an access security model with groups obtained externally, from an LDAP environment for example, and tables sisfm_users and sisfm_groupsforroles are ignored.)
userType If set to Staff, this user will have mobile phone numbers (em.cellular_number) included in Space Manager occupant details. If not set to Staff, this user is assumed to be a student, and Room Bookings constraints for students apply (table rm fields book_max_hrs_student, book_min_booking_hrs_student, book_max_bookings_student, book_max_hrs_total_student and the BookMaxHrsTotalStudent setting).
displayName The name to display on the login bar, and elsewhere.
firstName
lastName
The first and last parts of the user name, currently not used.
ext The telephone extension of the user, used by:
  • Asset Bookings and Room Bookings - Make Booking (inserted in book_index.phone)
phone The phone number of the user, used by:
  • Database Manager - for sisfm_fld.dflt_val values 'USERPHONE'
userID The user ID (either em.em_id or work_person_rep.user_name, used by:
  • Database Manager - for sisfm_fld.dflt_val values 'USERID'
email The email address of the user, used by:
  • The AppAdmin configuration setting.
  • Map Enquiry - Feedback
  • Space Manager - Edit Occupants
  • Asset Bookings and Room Bookings - Booking List (matched with book_user.identifier to select the site tabs to display)
  • Asset Bookings and Room Bookings - Make Booking process (inserted in book_index.email)
  • Asset Bookings and Room Bookings - Make Booking process (the addressee for booking confirmation emails)
  • Move Manager - MoveAdmin configuration setting.
  • Move Manager - as the contact email.
  • People Manager - for the "changed to Hot - Occupants removed" email.
  • Maintenance module - in many places.
  • Database Manager - for sisfm_fld.dflt_val values 'USEREMAIL', 'USERDV', 'USERDP'
  • Workstation Bookings - for sending emails.
config The configuration setting prefix name, equivalent to launching SISfm with the querystring parameter "config" and the same name (optional).