Technical manual Human Resources Diploma Toolbox, version 1.1 BSB50801 Diploma of Business (Human Resources) Technical manual...................................................................................... 1 Client technical requirements .................................................................. 2 Accessibility ............................................................................................ 3 File structure ........................................................................................... 5 Software for customisable assets............................................................ 7 Installation on a web server .................................................................... 7 Making a student CD .............................................................................. 7 Index of learning packs ........................................................................... 7 Known issues.......................................................................................... 8 Release notes for version 1.1 ................................................................. 9 Acknowledgements This Technical Manual was developed by Grant Focas and Alison Woodage. July 2003. Technical Manual, Human Resources Diploma Toolbox (v1.1) Australian National Training Authority (ANTA) 2003 Page 1 of 9 Client technical requirements Browser compatibility Netscape 4.7, 6.2, 7 IE 5 + Mozilla 1.1 + The HR Toolbox works best with JavaScript turned on in the browser. Platform compatibility PC and Macintosh. The Toolbox JavaScript navigation does not work on IE5.0 on a Mac so we use JavaScript to sniff out this configuration and replace a text-only version. This does have a slight risk if the users of IE 5.0 on a Mac have JavaScript disabled, but the number of these users will be very small. Screen resolution Minimum 800x 600 pixels Plug-ins Flash Player 6 (to support Flash MX files) build 29 + Adobe Acrobat Reader 4 + Problem playing sound files? The sound player in the Toolbox is built in Flash MX. If you can see the play bar but it does not move when pressing the play button, you may have an early build of the Flash 6 player. If this happens, delete the flash.ocx file from your computer(use the search facility on your C drive to find and delete this file). Before deleting, all browsers must be closed. After deleting, the file flash will automatically install when you open the unit home pages via the Internet. Click 'Yes' when asked if you want to install Macromedia Flash Player. If you can’t see the play bar at all or if it is just a grey bar, you will need to install Flash player. Download times A pre-loader is included in the Flash movies to facilitate handling of larger Flash files. Other than Flash and audio assets, the maximum page size is 50 kb. The audio files are SWF files containing compressed MP3 files. The largest of these is 323kb. Technical Manual, Human Resources Diploma Toolbox (v1.1) Australian National Training Authority (ANTA) 2003 Page 2 of 9 Accessibility The site is compliant with W3C Content Accessibility Priority 1 guidelines. Navigation The drill-down navigation uses JavaScript so we have used a text only link inside <noscript></noscript> tags as an alternative for those who have JavaScript disabled. There is a text only version also available for those who have javascript enabled but would still prefer a text version. This is intended for those screen readers who have problems with javascript but who would not see the version inside the <noscript></noscript> tags because they have javascript enabled. The link to the text only version is invisible (rendered the same colour as the background), so it doesn’t distract from the visual design, but it is the first link in the navigation page a screen reader would read. Text equivalents Alt tags are included on all images. Longdesc tags are also included where necessary. Text alternatives to flash movies are also provided. Table headers (where tables are not for formatting purposes) and summaries are included. TabIndex keys TabIndex keys have not been used for this site with the exception of the sound pages (any page with an underscore followed by 'sd' in its filename). These contain flash (SWF) files with embedded MP3 audio. A bug in Flash means that once the flash object has focus, it won't let it go. Our solution has been to use TabIndex= -1. This allows tabbing to bypass the Flash object. As a result, if a user's only method of navigation is the keyboard, they will have to follow the link to read the text alternative rather than hear the audio. Access keys The navigation utilises access keys for each Task page. Task 1 uses Access key 1, Task 2 uses Access key 2 and so on. Keyboard-only users are encouraged to use the latest version of Internet Explorer, as the up and down arrow keys and PageUp and PageDown keys are not fully supported in Netscape or Mozilla (not inside <div> tags at any rate). Links 1. Many links have title attributes which describe the link in greater detail, unless the text of the link already fully describes the target (such as the headline of an article). 2. Links are written to make sense out of context. Technical Manual, Human Resources Diploma Toolbox (v1.1) Australian National Training Authority (ANTA) 2003 Page 3 of 9 Images 1. All content images used in this site include descriptive ALT attributes. Purely decorative graphics include null ALT attributes. 2. Complex images include LONGDESC attributes or inline descriptions to explain the significance of each image to non-visual readers. Visual design 1. This Toolbox uses cascading style sheets for visual layout. 2. This Toolbox uses only relative font sizes, compatible with the userspecified "text size" option in visual browsers. 3. If your browser or browsing device does not support stylesheets at all, the content of each page is still readable. Technical Manual, Human Resources Diploma Toolbox (v1.1) Australian National Training Authority (ANTA) 2003 Page 4 of 9 File structure The file structure of the Toolbox is set up so that individual Units in the Toolbox may be loaded onto a web server or a CD-ROM. root folder shared folder unit folder See the next page for information about these folders. Technical Manual, Human Resources Diploma Toolbox (v1.1) Australian National Training Authority (ANTA) 2003 Page 5 of 9 The root folder has the following folders: shared which includes all scripts, styles etc that are used in more than one unit – it must be on every CD or server copy of the Toolbox, even if there is only one Unit on the CD or server lo (Learning Objects) which contains all 'Learning Packs' as they are called in the Toolbox; each is self-contained within their own folders source which contains the Flash files, which are the source of all the SWF files used in the course units which contains all the unit case studies used in the course At the root level you will find the following files: index.htm readme.txt update_flash.htm, which checks to see if the required version of flash player is installed the technical guide the teacher guide the autorun files necessary for automatic play from CD. The shared, LO and source folders can be copied along with whichever unit folder is needed. Each unit has a folder inside the units folder. The units folder can be copied as a whole by first deleting whichever units are not wanted, preserving the file structure. The navigation for each unit sits in a nav folder and can be easily disaggregated so that the unit/s may be placed in a LMS such as WebCT, Janison, etc. All references to frames use _parent rather than _top so that if needed a frameset may be constructed around the entire site. Technical Manual, Human Resources Diploma Toolbox (v1.1) Australian National Training Authority (ANTA) 2003 Page 6 of 9 Software for customisable assets A source code folder is provided for customising Flash files and other assets. If editing HTM files in Macromedia Dreamweaver, you may experience a known bug with that software. If you open the page in Show Design View and cannot see any content, switch to Show Code View and make any change (for example, add a space then take it away again). When you switch back to Show Design View you will see the content. Installation on a web server Copy the entire contents (except for autorun.inf and autorun.exe) of the CD to the appropriate place on your web server (either in wwwroot or elsewhere using a virtual directory). If you are only copying selected Units to your server or CD, you must: make sure the entire shared folder is also copied make sure that the learning objects (learning packs) required for those Units are also copied Network administrators should ensure that the plug-ins and browsers list above are available to users. There are no server side technologies utilized in this toolbox, so no configuration is necessary. Making a student CD If providing a CD for students to use, you may first like to delete the teacher guide and technical guide from the CD, although this is not essential. You can use CD burning software, but instead of copying the whole CD, use the Data CD option to drag and drop all files, then delete the teacher guide and technical guide from the destination (usually d: drive). Index of learning packs An index of learning packs is provided for the whole Toolbox and for each Unit. Each index is accessed from the Toolbox and the nine Unit home screens. Each index contains: the titles of the learning packs used in that part of the Toolbox their file names, these begins with a serial number from 2001_329_001 through to 2002_329_053 (note: there is intentionally no learning pack for number 2001_329_047) a list of the Units and Tasks each learning pack is linked from. Technical Manual, Human Resources Diploma Toolbox (v1.1) Australian National Training Authority (ANTA) 2003 Page 7 of 9 Known issues The following are known technical issues that users may experience when using the HR Diploma Toolbox. The sound player in the Toolbox is built in Flash MX. If you can see the play bar but it does not move when pressing the play button, you may have an early build of the Flash 6 player. If this happens, delete the flash.ocx file from your computer(use the search facility on your C drive to find and delete this file). Before deleting, all browsers must be closed. After deleting, the file flash will automatically install when you open the unit home pages via the Internet. Click 'Yes' when asked if you want to install Macromedia Flash Player. If you can’t see the play bar at all or if it is just a grey bar, you will need to install or update the Flash player. Note: the STAR logo on the Unit home screens should animate with a fade in and out. If it appears but doesn't animate, that means you have an early build of Flash 6, and you should update it. Star Intranet window is a popunder instead of popup in Netscape 7 on a Mac. This means it sits under the main window rather than on top. When printing pages from Internet Explorer 5 or 5.5 sometimes the page won’t print beyond what’s visible on the screen. We recommend updating to a more recent browser. When opening a Word document in some Netscape browsers, a blank browser window also opens. If an audio page does not play in Netscape 7, refresh the page. You may have to do this twice. Windows computers have settings which allow Microsoft Word documents to be either opened in the browser rather than in Microsoft Word or another word processor. If your computer does this you can change the settings by opening Windows Explorer (not Internet Explorer), click Tools, select Folder Options, then the File Types tab. Scroll down to Microsoft Word Document. Highlight it and see the details for ‘DOC’ extension panel at the bottom. It should say opens with Microsoft Word for Windows (or your preferred text editor). If it doesn’t click the Change button and choose the application you want it to open in. In Netscape 4.7 the Feedback button in the review quizzes will not tell the user whether their answer was correct or incorrect, it will show the user both the correct and incorrect feedback. We recommend updating to a more recent browser. In Netscape 4.7 the STAR Intranet sometimes has no vertical scrollbar. If you are using a PC, maximize the browser window, if Technical Manual, Human Resources Diploma Toolbox (v1.1) Australian National Training Authority (ANTA) 2003 Page 8 of 9 using a Mac resize the window. We recommend updating to a more recent browser. Double vertical scrollbars appear in Netscape 6.2 and 7. This browser configuration also makes the up and down keyboard arrows unusable for scrolling, although the mouse still works. After opening the text version of a Match-it or Make-it activity on Internet Explorer on a Mac, and then returning to the activity the vertical scroll bar disappears. Refresh the page and it will reappear. Release notes for version 1.1 Version 1.1 was released in July 2004 with the following issues addressed: Links from task screens in all units (bsbhr501a_task1.htm etc) to certain learning packs annotated to contain specific information for the learner on how that learning pack is relevant to the task. Mainly affects learning packs that deal with broad underpinning knowledge: Apply legislation to HR processes; Develop and document HR processes; Evaluate and improve HR processes and tools; Implement the project; Link HR planning to organisational goals; Outsource HR services; Plan the project; Train and support staff who implement HR processes. Errors fixed in textNav.htm for BSBHR502A, BSBHR504A, BSBHR505A, BSBHR507A, BSBHR508A Error fixed in link text to learning pack in bsbhr503a_task7.htm. Link to Ready Set Go website updated in Teacher Guide and in all Getting ready screens (bsbhr501a_ready.htm etc). Links to various websites updated in bsbhr505a_ready.htm; bsbhr505a_t4_pop11.htm; bsbhr506a_ready.htm; 2002_329_002_03.htm. Broken links due to case sensitivity of some servers fixed. Broken links to Thiagi website in Teacher Guide fixed. Bug fixed that caused the browser to crash if the user followed a certain pathway to enter the Documents or Message Centre sections on the STAR Intranet. Information in credits.htm updated. Links to Word versions of Teacher and Technical guides corrected in teachg_screen.htm and technicalman_screen.htm. Technical Manual, Human Resources Diploma Toolbox (v1.1) Australian National Training Authority (ANTA) 2003 Page 9 of 9