Home

OpenLabyrinth User Guide

1. OpenLabyrinth mvm ed ac uk remote asp e lt QOpenLabyrinthservice gt is the root element e lt remotelP gt is the IP address as seen by OpenLabyrinth e lt QOpenLabyrinthmap gt is the parent element per activity e lt OpenLabyrinthmapid gt is the current activity s map ID integer Page 35 of 52 OpenLabyrinth User Guide v2 5 lt OpenLabyrinthmapname gt is the current activity s title lt OpenLabyrinthmaproot gt is the root mnode ID integer for the current activity As an example lt xml version 1 0 gt lt OpenLabyrinthservice gt lt remoteIP gt 129 215 133 15 lt remoteIP gt lt OpenLabyrinthmap gt lt OpenLabyrinthmapid gt 174 lt OpenLabyrinthmapid gt lt OpenLabyrinthmapname gt ESSQ 1 lt OpenLabyrinthmapname gt lt OpenLabyrinthmaproot gt 2054 lt OpenLabyrinthmaproot gt lt OpenLabyrinthmap gt lt OpenLabyrinthmap gt lt OpenLabyrinthmapid gt 178 lt OpenLabyrinthmapid gt lt OpenLabyrinthmapname gt ESSQ Jaundice 1 lt OpenLabyrinthmapname gt lt OpenLabyrinthmaproot gt 2129 lt OpenLabyrinthmaproot gt lt OpenLabyrinthmap gt lt OpenLabyrinthservice gt 7 4 2 Transaction OpenLabyrinth This is the main transaction type with OpenLabyrinth which processes the activity as it plays out The URL for this is http OpenLabyrinth mvm ed ac uk mnode asp id x amp mode remote amp sessID y The value for sessID can be left blank for the root node transaction but is required thereafter to mainta
2. Page 43 of 52 OpenLabyrinth User Guide v2 5 10 Further Information and Resources OpenLabyrinth is provided as open source code and as such the authors accept that there may be some bugs and problems but make no guarantees and accept no liabilities for the same If bugs are found then either fix them and share the code back to the OpenLabyrinth community or make a request for a fix to the community As for user support there ain t none they are us OpenLabyrinth community members will generally help each other work through problems but only inasmuch as they have the ability and time to do so As with any community it takes all members to work together to make the system stronger and better Suggestions and ideas for new developments should also be circulated to the community OpenLabyrinth is licensed under the Academic Free License AFL v 3 0 see appendix 2 References Begg M Dewhurst D and MacLeod H 2005 Game Informed Learning Applying computer game processes to Higher Education Innovate 1 6 Begg M Ellaway R Dewhurst D and Macleod H 2007 Transforming Professional Healthcare Narratives into Structured Game Informed Learning Activities Innovate 3 6 Ellaway R 2004 Modeling Virtual Patients and Virtual Cases MELD http meld medbiq org primers virtual_patients_cases_ellaway htm Ellaway R 2007 Discipline Based Designs for Learning The Example of Professional and Vocati
3. link in the main editor This launches the file manager window see figure 8 Figure 8 map files editor For each file uploaded into the current labyrinth you have e Awiki style file reference this takes the form of MR xxx where MR indicates that this is a media resource and xxx is the unique file ID assigned to the file on upload By pasting the reference into a node content box the file will be displayed at runtime e A resource preview this just shows what the resource looks like images only e A metadata view and editor this shows basic metadata for the resource allows you to edit the metadata and it allows you to delete the file from the current labyrinth In addition you can upload a new file by choosing it and clicking the upload button see table 2 for list of supported file types Once a file has been uploaded it should be edited for its metadata this will allow for both better control of the resource as well as registration within the Media Resource MVP service see section 5 2 Note that you should always ensure that any material you use both text and images is not covered by any copyright or consent restrictions Liability for inappropriately used materials rests with the author File Type Display Extension Notes JPEG image jpg jpeg JPEGs and GIFs are the only supported image formats in n OpenLabyrinth Acrobat PDF Link pdf PDFs may be created from many applications including Adobe Acrobat Shockw
4. nodes files counters main editor D Figure 5 inline node editing A is the link to turn editing on and off B is the field to change the title C is the field to change the text and D is a series of links to the main editor tools 4 2 Editor Functions When you click edit you are taken to a screen see figure 6 editor for Labyrinth Anna Lena you can access all of this Labyrinth s editing features from this page 2 Ze OpenLabyrinth a global O preview 8 files 9 session reports i O Labyrinth S mer aue porabe nodes O visual editor Q counters users delreory system smx sm e tergrid Collections nodegrid a feedback 224 countergri Ww export Labyrinths am Authoring sc _ o sections westions elements e duplicate ww Q 3 ty y a links Q avatars O clusters delete e title Anna Lena Labyrinth type maze authors rellaway secunty private description Vue upload timing off keywords source Vue Import Anna Lena 38C53E9A 0C72 4CE0 8876 347B004F BFC5 Figure 6 the OpenLabyrinth map editor Page 14 of 52 OpenLabyrinth User Guide v2 5 There are 20 main editing functions for any given labyrinth 1 E OCN n OX GI 17 18 19 20 Global properties this is a duplicate of the form used to create a map manually Nodes you can add nodes or edit any existing nodes from here Nodegrid you can edit all of the node titles and contents within a single Labyrinth at once Sections
5. reset 5th MCP dislocation Open Labyrinth 5 Gout Boxer amp apos s fracture Happiness 50 Gonococcal monoarthropathy Joy 100 Review your pathway Figure 3 a typical labyrinth screen 2 2 Keys In addition to making a Labyrinth more or less secure using Labyrinth security you can also require your users to enter an arbitrary text key to activate a Labyrinth To turn on the use of keys set the labyrinth security type to keys a key is required to access this Labyrinth in the global editor and use the edit link by the security type select to create one or more keys A key can be any kind of text string including variations such as 6t4g45 green for go and 85A94W8BA9445 When a user tries to run a labyrinth they will be challenged to enter a valid key and they won t be able to start until they do so 2 3 User Interface There may be a number of different elements on display see figure 4 including e Title every node has a title which is typically displayed at the top of the page Page 9 of 52 OpenLabyrinth User Guide v2 5 e Message although not mandatory almost all labyrinth nodes will have some kind of textual message for the user Typically that will either describe the consequences of having selected the current node The message can change depending on what rules have been tripped when you entered the current node For instance if your score hit zero you would be asked to restart the
6. As has already been mentioned each labyrinth user session is tracked and is available to its authors as a report A user session is started each time a user goes to a map s root node The tracking involves recording each node selection along with the time and current score and counter values at that point The reports are available in one of two ways e Users can see reports for every OpenLabyrinth they have run this is in the My OpenLabyrinths section linked from the home page e Authors can see reports for every session within a particular map this is in the user session report section linked from the main map editor Each report consists of a list of nodes visited representing the user s path through the map along with the current score and how long they spent at the node in seconds This allows a histogram to be drawn representing the session to be drawn up see figure 12 The value of each counter is also recorded and is available as a plot see figure 13 The data can be downloaded as a CSV file for further analysis 7 00 time on node s 19 47 21 52 47 35 node path node IDs Figure 12 a typical OpenLabyrinth report histogram In this session the user spent 6 seconds on nodes 21 and 52 Node 21 is a must visit node in green and 52 is a must avoid node in red Page 27 of 52 OpenLabyrinth User Guide v2 5 Counters o w ni nm wt r wv m Counter 1 Happiness
7. REMOTE CLIENT x REMOTE CLIENT calis no parameters HEMOTE ASP returns avaiiabie maps 9 3 E 2 uoneoydde ejowe gt 46 first calls passes MNODE ASP mnodelb returns node XML 4 calls passes MNODE ASP mnodelD and sessiD Figure 18 OpenLabyrinth Remote Services Architecture OpenLabyrinth is on the left and the remote application is on the right hand side The steps are 1 2 oa a KR w The remote client calls REMOTE ASP in OpenLabyrinth If the user credentials are correct or the remote client s IP is recognised then REMOTE ASP sends back an XML file listing the available Labyrinth Maps The remote client parses the incoming XML into clickable links to start each Labyrinth Map When the user clicks on a link this sends a call to MNODE ASP passing just the nodelD If the call is authorised then MNODE ASP returns the node XML package The remote client parses the incoming XML so the user can work through the activity Each click cycles through steps 4 6 As this is happening additional communication can run within each application Page 33 of 52 OpenLabyrinth User Guide v2 5 7 2 Setting up OpenLabyrinth Remote Services There are two ways a remote service can be called 1 by passing user credentials in the remote GET string The user needs to be a remote type user i e not a superuser author or learner account To set this up create a remote user or reuse an existin
8. lt mnodetitle gt Start lt mnodetitle gt lt javascripttime gt lt javascripttime gt lt mapname gt ESSQ Jaundice 1 lt mapname gt lt mapid gt 178 lt mapid gt lt mnodeid gt 2129 lt mnodeid gt lt mapscore gt 100 lt mapscore gt lt timestring gt lt timestring gt lt message gt 33Cp33Eyou are ta FY2 in general surgery on call yout tare phoned by a GP who has a 55yo woman in his surgery whot tappears jaundiced what do you do now33A33C32Fp 3E lt message gt lt colourbar gt 3Ctablet tborder 3D 270 327 width 3D 27100 25 27 cellpadding 3D 275 27 3E 3C tr 3E 3Ctd theight lt colourbar gt lt linker gt 3Cp 3E 3DABBCE08B 2D1F75 2D4A0A 2D852B 2D21F0819A19A2 27 3EID 3D 5B27 5D 5D 5D 5D 2D arrangeturgent reviewt thetpatient comes tothospit 3C 2Fa 3E 3C 2Fp 3E lt lin ker gt lt tracestring gt 3Cathref 3D 22 323 22 onclick 3D 22togglet5Fvisibility 28 27track 27 29 3B322 3E 3Cptclass 3D 27style2 27 3E 3Cstrong 3EReviewtyourtpathway 3C lt tracestring gt lt rootnode gt 2129 lt rootnode gt lt infolink gt lt infolink gt lt usermode gt lt usermode gt lt dam gt lt dam gt lt mysession gt ABBCE08B 1F75 4A0A 852B 21F0819A19A2 lt mysession gt lt counterstring gt lt counterstring gt lt OpenLabyrinth gt 7 4 4 Transaction service This is a combined function that connects to three different OpenLabyrinth services e Information http OpenLabyrinth mvm ed ac uk info asp id x amp mode remote amp s
9. Counter 2 Joy Figure 13 a typical counter trace there are two counters here happiness which started at 10 and rose to 50 on the last node and happiness which remained at 100 throughout 5 2 Feedback Report The user can also be given a feedback report To do this first enable the node property of link to end and report from this node for any node from which you want to allow the user to get their report When the user clicks the report link they get the following Metadata such as the user ID the session ID and the labyrinth name The start time and the time taken to complete The total number of nodes visited as well as the number of must visit and must avoid nodes visited General feedback irrespective of what the user has done Feedback in response to specific nodes visited Feedback in response to the number of must visit and must avoid nodes visited Feedback based on the time taken to complete Feedback on the final values of any of the current labyrinth s counters The list of nodes visited The histogram of time spent per node The graph of counter values through the session 5 3 Feedback Options User feedback can be configured as follows 1 2 Set the general feedback to the user for instance That was a hard problem Click on the feedback option in the editor menu Page 28 of 52 OpenLabyrinth User Guide v2 5 3 Add feedback rules a Feedback in
10. Stored Procedure TRACE_SESSION remove dbo USERSESSIONTRACE MScore and dbo USERSESSIONTRACE MScoreNow from Page 49 of 52 OpenLabyrinth User Guide v2 5 Appendix 2 Academic Free License AFL v 3 0 This Academic Free License the License applies to any original work of authorship the Original Work whose owner the Licensor has placed the following licensing notice adjacent to the copyright notice for the Original Work Licensed under the Academic Free License version 3 0 Grant of Copyright License Licensor grants You a worldwide royalty free non exclusive sublicensable license for the duration of the copyright to do the following e to reproduce the Original Work in copies either alone or as part of a collective work e to translate adapt alter transform modify or arrange the Original Work thereby creating derivative works Derivative Works based upon the Original Work e to distribute or communicate copies of the Original Work and Derivative Works to the public under any license of your choice that does not contradict the terms and conditions including Licensor s reserved rights and remedies in this Academic Free License e to perform the Original Work publicly and e to display the Original Work publicly Grant of Patent License Licensor grants You a worldwide royalty free non exclusive sublicensable license under patent claims owned or controlled by the Licensor that ar
11. by or is under common control with you For purposes of this definition control means i the power direct or indirect to cause the direction or management of such entity whether by contract or otherwise or ii ownership of fifty percent 50 or more of the outstanding shares or iii beneficial ownership of such entity Right to Use You may use the Original Work in all ways not otherwise restricted or conditioned by this License or by law and Licensor promises not to interfere with or be responsible for such uses by You Modification of This License This License is Copyright 2005 Lawrence Rosen Permission is granted to copy distribute or communicate this License without modification Nothing in this License permits You to modify this License as applied to the Original Work or to Derivative Works However You may modify the text of this License and copy distribute or communicate your modified version the Modified License and apply it to other original works of authorship subject to the following conditions i You may not indicate in any way that your Modified License is the Academic Free License or AFL and you may not use those names in the name of your Modified License ii You must replace the notice specified in the first paragraph above with the notice Licensed under lt insert your license name here gt or with a notice of your own that is not confusingly similar to the notice in this License and iii You
12. find it drag to the centre and then zoom in saving your work the visual editor needs to be updated to save changes to the database Either click the update button in the top left of the screen or the update buttons in the node or link editors Updating also clears occasional odd behaviours moving node boxes click and drag in the top bar in a node box to move it around the new node screen All links to or from the node box will move at the same time new node text Page 19 of 52 new node new node text new node new node text new node new node text OpenLabyrinth User Guide v2 5 editing text in node boxes click on the title or body text of a node box to start editing it Note that the viewer needs to be updated before any changes are added to the database adding node boxes click on the icon at the bottom of a node box to add a new node linked from the one you clicked Alternatively click the icon at the top left of the editor to create a new node not linked to another node Note that the viewer needs to be updated before any changes are added to the database deleting node boxes click the e icon on the node box to be deleted select the delete button and then click update adding links click on the target icon on the right hand side of a nodebox to create a new link Click and drag the target on to the node to be linked and let go A new link has been created Note that the viewer needs to be updated bef
13. how it renders on screen right 4 17 Data Clusters Integrating elements there are two ways of linking in VPD or MR elements to an activity node as individually embedded elements or as a collection of elements via a data cluster Click clusters on the editor menu this lists all of the current clusters You can edit the contents of a cluster or delete a cluster or you can create a new cluster Within a cluster you can add or remove data elements or media elements such as pictures and change the order in which they re shown to the user 4 18 Session reports This lets you view all of the sessions run on the current labyrinth See separate section on this topic 4 19 Users A map s authors are the only ones who can edit it and if the map s security is set to private they are also the only ones who can see it By default the user who created a map by any of the three creation methods is an author Page 24 of 52 OpenLabyrinth User Guide v2 5 on the new map Additional authors can be added or removed using the map s author editor which is accessed by clocking on the list edit this OpenLabyrinth s authors link in the main editor This provides a grid of all the registered OpenLabyrinth authors with a tick box by each one that can be selected to add the user as an author of the current map or deselected to remove them from the current map Note that you cannot add or remove yourself as an author Learner
14. indicates your clear and irrevocable acceptance of this License and all of its terms and conditions If You distribute or communicate copies of the Original Work or a Derivative Work You must make a reasonable effort under the circumstances to obtain the express assent of recipients to the terms of this License This License conditions your rights to undertake the activities listed in Section 1 including your right to create Derivative Works based upon the Original Work and doing so without honoring these terms and conditions is prohibited by copyright law and international treaty Nothing in this License is intended to affect copyright exceptions and limitations including fair use or fair dealing This License shall terminate immediately and You may no longer exercise any of the rights granted to You by this License upon your failure to honor the conditions in Section 1 c Termination for Patent Action This License shall terminate automatically and You may no longer exercise any of the rights granted to You by this License as of the date You commence an action including a cross claim or counterclaim against Licensor or any licensee alleging that the Original Work infringes a patent This termination provision shall not apply for an action alleging patent infringement by combinations of the Original Work with other software or hardware Page 51 of 52 OpenLabyrinth User Guide v2 5 Jurisdiction Venue and Governing Law Any act
15. license is granted to the trademarks of Licensor even if such marks are included in the Original Work Nothing in this License shall be interpreted to prohibit Licensor from licensing under terms different from this License any Original Work that Licensor otherwise would have a right to license Page 50 of 52 OpenLabyrinth User Guide v2 5 External Deployment The term External Deployment means the use distribution or communication of the Original Work or Derivative Works in any way such that the Original Work or Derivative Works may be used by anyone other than You whether those works are distributed or communicated to those persons or made available as an application intended for use over a network As an express condition for the grants of license hereunder You must treat any External Deployment by You of the Original Work or a Derivative Work as a distribution under section 1 c Attribution Rights You must retain in the Source Code of any Derivative Works that You create all copyright patent or trademark notices from the Source Code of the Original Work as well as any notices of licensing and any descriptive text identified therein as an Attribution Notice You must cause the Source Code for any Derivative Works that You create to carry a prominent Attribution Notice reasonably calculated to inform recipients that You have modified the Original Work Warranty of Provenance and Disclaimer of Warranty Licensor warrants that
16. may not claim that your original works are open source software unless your Modified License has been approved by Open Source Initiative OSI and You comply with its license review and certification process Page 52 of 52
17. properties There are 8 links indicated in figure 1 because there is a link from node 1 to 2 and another separate one from node 2 to 1 Links can be presented to the user in four different ways e Hypertext clickable text link per available choice e Drop down a dropdown list of the available choices e Dropdown with confidence interval as above with a second drop down indicating how confident or unconfident the user was about their choice e Type in text the user types in the first few letters of their proposed answer and if it matches an available option this is auto filled for the user The order of these available options can be set randomized or randomly set to present just the one option 1 7 Rules Rules are functions attached to nodes that change the way a labyrinth is presented to the user One set of rules might set or change one or more counters while another could require a user to have visited other nodes before being able to load the current one In a little more detail these rules include Page 6 of 52 OpenLabyrinth User Guide v2 5 e Counters there can be as many or as few counters in a Labyrinth as you want Each counter has a name description starting value and a number of functions At the entry to any node or on clicking any link the value for each and every counter can be changed using plus minus or equals operators along with an integer value 10 adds ten 4 sets the value to 4 irrespe
18. response to specific nodes visited for instance You chose to get an MRI that was an expensive option given the circumstances Feedback in response to the number of must visit and must avoid nodes visited for instance You made 4 choices that should have been avoided Feedback based on the time taken to complete for instance You completed the task in less than 2 minutes were you really thinking about what you were doing Feedback on the final values of any of the current labyrinth s counters for instance Your morale slipped below the critical point Page 29 of 52 OpenLabyrinth User Guide v2 5 6 Global Functions In addition to the creation and running of OpenLabyrinth maps there are a number of OpenLabyrinth administration services including user management reporting and import export 6 1 Users and Groups All authors need to have a login to OpenLabyrinth OpenLabyrinth super users have the ability to create OpenLabyrinth accounts using the link from the home page Each account requires a username password full name and email address This is where the user interface language is set for a given user A user may also be given super user access Edit user account username password ee o name oe email canto superuser language english francais submit Figure 14 the add user screen Groups are collections of users The tools for creatin
19. the copyright in and to the Original Work and the patent rights granted herein by Licensor are owned by the Licensor or are sublicensed to You under the terms of this License with the permission of the contributor s of those copyrights and patent rights Except as expressly stated in the immediately preceding sentence the Original Work is provided under this License on an AS IS BASIS and WITHOUT WARRANTY either express or implied including without limitation the warranties of non infringement merchantability or fitness for a particular purpose THE ENTIRE RISK AS TO THE QUALITY OF THE ORIGINAL WORK IS WITH YOU This DISCLAIMER OF WARRANTY constitutes an essential part of this License No license to the Original Work is granted by this License except under this disclaimer Limitation of Liability Under no circumstances and under no legal theory whether in tort including negligence contract or otherwise shall the Licensor be liable to anyone for any indirect special incidental or consequential damages of any character arising as a result of this License or the use of the Original Work including without limitation damages for loss of goodwill work stoppage computer failure or malfunction or any and all other commercial damages or losses This limitation of liability shall not apply to the extent applicable law prohibits such limitation Acceptance and Termination If at any time You expressly assented to this License that assent
20. you can create arbitrary sections for grouping nodes together and assign nodes to these sections from here Links you can add links or edit links from here Preview this launches the map in a new window Visual editor inline visual node and link editor Feedback you can create and edit feedback rules from here Questions embed formative questions for tracking and evaluation Avatars add and edit different avatars for the current labyrinth Files you can upload and manage any files you need in your map from here Counters you can add and edit counters from here Countergrid you can see and edit all counter functions for all nodes in a Labyrinth at once Elements you can add and edit data elements from here Clusters you can add and edit data clusters from here Session reports all user sessions for the current Labyrinth see administration section on reporting services Users you can add or remove users both authors and learners for the current Labyrinth from here Export this exports the whole labyrinth either in the MedBiquitous Virtual Patient MVP data format or the Vue XML file format see section 6 Duplicate duplicates the current labyrinth Delete deletes the current labyrinth 4 3 Global properties These are the properties that structure the whole labyrinth including Title author credits keywords and description these are free text entries to set
21. E E ee ee EE ee a 25 4 23 VAUtNORNOES E E E A A ed el 25 4 24 Key Feature Problems and Matching 2 ccccceeeeeneeeeeeeeeeeeeeeeeenaaeeeeeseeaaaeeeececaaeeeeeeeeecaaeeeseseecaeeseseenaeeeeessesnaeeeess 25 5 Feedback and Reporting issin ae n riaa hoiran o ao a ELSA 27 5 AP SESSION Reports rior PANN ale sean eth Lecce nade Se eae as aa Re ete ee et ed en oad 27 5 22 Feedback Report ti os gsualet des Wieden dct aeaa e a A dra 28 5 3 heedback Optlons ait Meche SA Pee ola eee eae 28 6 Global FUNCIONS iii A ase rene ie ieee 30 6 1USsers and Gros A eee BE Le St Ee ee oe 30 6 2 Language Sp Oi e nS den ieee hia a aA MA euch ta SM ees adeeb ta a oe det eee 30 6 3 Presentations ainia er e a dia 31 6 4 Coll Ctions sinoni A ean ee Ad ae ek ce Da el 32 6 5 MedBiquitous Virtual Patient Export ccccccccccccccccccccccceeececeeeeeeeeeeeeeeeeeaaeeeaeeeeeeeeeeeeeeeseeeesseeeeeeeeeeeeeeaeeeeeeeaeeeeeeeeeeeeeeeeneess 32 6 6 V e Exportand SMC eh aide AN ie ei aa eA Nal eed eel as de RA 32 OLIMPO neti A de ie ee ee ee 32 7 OpenLabyrinthiRemote ServiCes isso ais 33 A E AR 33 7 2 Setting up OpenLabyrinth Remote Services oooocccinoccconocccononanononcncnnon non nnn nn nono n cnn n nn n nana r nr nr nn r nn nr n cren rr nnnn ra nnnnnns 34 7 3 Remote Services Components and Messaging ccc ccececeeeeeeeeeeeeeeeeeaeeeeeeeseeaeeeeeeseeeaeeeeeeeeccaeeeeeeeseneeeeeeeseieeeeeeseeas 34 7 4 OpenLabyrinth Remote Services Transacti0N
22. Labyrinth one or more OpenLabyrinth maps associated with that service and a means of presenting the activity to the user in the remote environment This OpenLabyrinth client application would need to be able to consume the XML generated by the service and render it so that the user was given the links and services required to run the labyrinth remotely and interact with the OpenLabyrinth server 1 13 Presentations A presentation is an arbitrary set of labyrinths grouped together for users to access together This may be a set of materials for a particular course an examination paper or a group topic Page 8 of 52 OpenLabyrinth User Guide v2 5 2 Running a Labyrinth This section describes the steps a user takes to start and work through a labyrinth note that this will be different for users of remote OpenLabyrinth services which will depend on the way the OpenLabyrinth client is instantiated and run as to how the interaction works 2 1 Permissions The only labyrinths a user can run without logging in are those whose security has been set to open Labyrinths with a security setting of closed can be viewed by anyone logged into OpenLabyrinth while private maps can only be viewed by their logged in editors To start a labyrinth just click on its title This loads the first node and displays it see figure 3 Differential diagnosis Map Handyman 5 Node 31 What is your differential diagnosis at this point
23. OpenLabyrinth User Guide v2 5 OpenLabyrinth User Guide for OpenLabyrinth version 2 5 November 2009 This work is licensed under a Creative Commons Attribution Noncommercial Share Alike 3 0 license Page 1 of 52 OpenLabyrinth User Guide v2 5 Contents TEMUCO UCM A A Ai 5 Tet What s new in version LD cenit sieves dancin ned aei ewekpacies aa a e i eves AA a aaiae aaraa aidea 5 1 2 What is OpenLabyrinth coc A te ata 5 1 3 Installing OpenLabyrintM aia A di dais 5 1 42 Lo Anla i n AA A E 5 AEST oTe eE A O E ee A eee ee a 6 1 6 LINKS ni a ieee ative a eels did 6 TERESA A eee ie av eae ee id 6 A ies acess eis evn eee A eed 7 1 9 Data Elements and Clusters 2 4 04 40s hanes agit ee A Ae ee a aaa iis 7 tTO AVata S AAA AA ed ee de Bea 8 VATEQUESION SA IA ee 8 1 12 OpenLabyrinth Remote Ge e Sr a aa a a aaa aaa a aaa AA a a a raaa aa Eaa Aaa Ea A TAE a aa Eiaa 8 A ON 8 2 R ning a Labyrinth issis a leet E E A a aa a Na aaa E a 9 27 Permissions a a O a a eee i eed ne ee a Ala a a 9 DLE SA da id 9 23 USer Interaccion ind 9 24 WNat hapPENS Moss at oss cial A A A A a dia 11 25 Tracking and Feedback 0 ii aia iia 11 3 Creating d Labyrinth sitiada ads 12 3 1 Creating a Labyrinth Manually ccccccceccecccccceeeeeeeeeeeeeeeecaaeeeeeeceeaeeeeeceeeaaeeeeeeeeaeeeeeeeeccaeeeesecceeeeeeeeseceeeeeeeseeineeeeseeas 12 3 2 Creating an OpenLabyrinth Map USING VUE oooocccconcococcccconnononcnnonnnoncnnn
24. Reports SQLExpress ReportServer SQLExpress 3 aspnet_client 2 cms 00min 25 Default SMTP Virtual Server C skins C tinymce vue xsl 9 addLink asp E E e lt Figure A1 an IIS instance of OpenLabyrinth showing it running in the default website e edit settings asp file and set the variables OLPath and BasePath to match your local build paths e set folder permissions for export files import and vue for the IUSR using extended permissions and select all except for full control traverse folder change permissions and take ownership Permission Entry for export 7 Ungecr Nave memet Gest Accowet Charge Apply cota This hide subfolders ond Mes v Perea Aka Dery f a FA Cont A Tiavea Folda Eoste Fis List Fokdes Fiead Dato Peal Arribes Fead E dorchas Altres Create fier Wirte Data Crete folders Append Dala Write Attbutes Write Extended Atitesme Daite Sudtokiers and Files Delete Reed Perrermon 3 PRA LAIA fc Apply these perrimone to obocie ardu Gea Ai cortarer vetar the cortina ory mA OK Cores Figure A2 setting the directory permissions You have now put the code part of OpenLabyrinth in place The next step is to set up the database Database Setup You installed SQL Server 2005 Express or ensured you had an ODBC SQL database available as part of the preparation step Note that there are many factors tha
25. S oooonoccccccnnnnococcnccconoccnnncnnnnnnnnnnnonnnnnncnnnnnnnnnnnnnn nan nnnnnnnnnnnnnnnnnrnnnnnnnancnnnnnns 35 7 4 1 Transaction OpenLabyrinthserviCe oooconcocccccnnocccccnnonononcnononnnnncnnonn nono nnnnn nn ran nr anno narran nr cnc nan n rana 35 1 42 Transacti n OpenLab yt iia AA 36 A Av Transacci n SOIVICS Acido ralla ibas r e a a idas cede a poes 37 7 5 Basic OpenLabyrinth Client FUNCtiOns ik issn einne a ara ei ia A SAE EAEN NOE Eaa i aT a aeda ESANTA 37 7 6 OpenLabyrinth Client EnhancementS oococonnccnnoncccnnonncnnnonononn nano nn cnn nan rn nn nn 38 8 Customization Skins and Mashups ccccceceeeseeeeececneceeeeeeeeeeeeeeeeaaeeeeeeeeeeeeeeesesceacnaeeeeeeeeeeessseeeecccnieeeeseeees 39 BE SKINS ee hi eee ct te Sica a ree sas ae uel SANE ALR Yas ALIS e Di E dl a eee Lt dt 39 8 2 COde E O Nate A oe oat eee hese lide het A dea aad a alee 40 8 3 DOCUMENTATION nic a aa 41 9 4 2MashUpsi o ta A E OM cae TE Bo et O dada 41 9 Development MECNniQues ti E 42 Page 3 of 52 OpenLabyrinth User Guide v2 5 OL USING VUE ar bees 42 O72 UsinguNOdes iia ta ed eee did oye ee eet A ieee ec ti Ad a ee 42 9 3 USING LINKS iets tacit ce a eel 43 9 4 Using Counters 200 cei a ied ie acted eae ie en ei ae ee eee 43 9 5 Different Kinds of Labyrinth Designs inane n ea E AASE EESE A EE Eee A E SEE 43 10 Further Information and Resources a a a a a a a e E a ae a a e ea 44 Appendix TA installati n vie eden eaa ea re
26. activity e Linked options the way to traverse a labyrinth is to click on one of the available options These will usually show the title of the node you are inking to although different text or an image icon may be provided instead e Review pathway taken unless disabled in a particular skin a clickable track of the user s pathway through the labyrinth since you started is available Click on a link to go back to that point note that this does nat roll back the track of which nodes have been visited every action is recorded in a session e Media elements because OpenLabyrinth provides every node with containers for HTML code any media element that can be displayed in a regular webpage can also be displayed in OpenLabyrinth This includes images video audio or programmatic objects and animations such as Flash or Java e Services if a service has been instantiated globally or at a particular node an icon will allow you to launch that service typically in a pop up window these can include information notes and DDX services e Counters for each counter with its visibility set to show a note of the item name and its current value is displayed If a counter function is encountered which changes the value for any given counter this is also displayed The counter text is clickable to launch a pop up that gives more information about that counter e Metadata and score although not all skins show these many do This shows the
27. ads details aspx FamilylID 0856eacb 4362 4b0d 8edd aab15c5e04f5 amp displaylang en SQL Express with Advanced Services or equivalent ODBC compliant database see http Awww microsoft com sql editions express default mspx XZip see http xstandard com en downloads product zip Code and Directory Download the OpenLabyrinth package from http sourceforge net projects openlabyrinth and unzip its contents Copy the contents of the code directory from the unzipped OpenLabyrinth package to a new directory in the wwwroot or equivalent directory Depending on the setup of your IIS instance this will either be a subdirectory of the default website or will need to be set up as a new website o If OpenLabyrinth is part of the default website or other existing website then open IIS right click the default or other website select the documents tab and add index asp as a default document if it isn t currently in the list o If OpenLabyrinth is going to be a new website then follow the usual steps see http technet2 microsoft com windowsserver en technologies featured iis default mspx Page 45 of 52 OpenLabyrinth User Guide v2 5 g Internet Information Services File Action View Help ajax 2 i 4 Internet Information Services RACHELELLAWO4D0 local computer 3 documents LQ Web Sites export Default Web Site files 32 ASH C FusionCharts Lg Printers Bal images import CI 5SCORM_objects
28. an activity node or viaa DAM aggregate of VPD and MR elements see figure 2 OpenLabyrinth can both export MedBiquitous Virtual Patient packages a zip file with XML and other files inside from a labyrinth and it can import MedBiquitous Virtual Patient packages to create new labyrinths Page 7 of 52 OpenLabyrinth User Guide v2 5 Figure 2 The relationship between VPS MR DAM and activity elements in OpenLabyrinth The user only works with the activity all elements are therefore surfaced within the activity 1 10 Avatars One way of enhancing a narrative is to identify human characters or agents within its flow OpenLabyrinth supports the use of characters by providing support for simple animated avatars for these characters in the narrative An avatar can be configured to appear differently age skin hair clothing context as well as communicate using speech or thought bubbles The same avatar can be reused with different settings throughout a Labyrinth Or a number of different characters can be used 1 11 Questions Ad hoc text based questions can be added to collect learner thoughts and feedback during a labyrinth activity 1 12 OpenLabyrinth Remote Services In addition to users running a labyrinth within OpenLabyrinth itself there is a web service that allows activities to be run remotely To run a remote OpenLabyrinth service you need to have a remote service including a single client IP address registered within Open
29. ave Flash Runtime media files from Adobe Flash Microsoft Word Standard document formats docx Microsoft Excel Microsoft PowerPoint Rich Text Format QuickTime video Video formats MPEG 4 video Windows Media Real Stream RAM Real Stream RPM Flash video MP3 audio WAV audio AAC mda audio Audio formats Page 22 of 52 OpenLabyrinth User Guide v2 5 Table 2 file formats supported by OpenLabyrinth 4 14 Counters Counters are comprised of a label and a dynamic integer value which can be dynamically changed as a user works through a labyrinth There can be any number of counters and each of these counters can have any number of rules that can be triggered by a counter s value Counters need to be created globally for a map To create a new counter or edit an existing one click the counters link This opens the counters editor which lists each existing counter with links to edit preview or delete it along with a link to create a new counter Adding or editing a counter opens the counter editor window see figure 13 The counter editor allows you to define change e Counter title this is the label shown for the counter e Counter description an optional text description of what the counter is and what its purpose is e Path for a counter icon an optional path for a graphical icon for this counter e The starting value for the counter Once created each counter will be displayed except on some skins to the user
30. ayed to the user o text default each choice is shown as a plain text hyperlink o dropdown each choice is an option in a drop down list o dropdown confidence each choice is an option in a drop down list with a second drop down to let the user select how confident they were at making the selection o type in text user types in what they think the option should be and if after the first 3 letters are entered this matches one of the available choices then that choice is selected Node priority this flags whether the current node must be avoided or must be visited this is used in the session reporting and feedback Root node this sets the current node as the root starting point node for the labyrinth Link to end and report from this node this is off by default If turned on a link is added to end the current session and get feedback see feedback section for more on this Node score function this can be used to change the score You can leave this blank or use one of or or plus an integer For instance 10 adds 10 to the current score while 80 sets it to 80 no matter what it was before Undo this allows users to undo a node they have visited by removing it from the session track In any given node scroll down to enable undo links and select whether this feature should be on or off for this node 4 5 Nodegrid Sometimes you just want to edit the content of all of t
31. byrinth designs in preparation in Vue As well as creating labyrinth designs in a stepwise manner parts of other designs can be copy pasted into new designs For instance a design for an interview or making a diagnosis can be reused across a number of designs Reusing these design patterns can make development faster and more effective 9 2 Using Nodes A node consists of a container for HTML content plus a number of rules and functions A node may need to be duplicated if one or the other differs Furthermore a node may contain a media object that presents an activity in Page 42 of 52 OpenLabyrinth User Guide v2 5 its own right for instance an assessment question an animation or an interactive object such as a puzzle or a mini game 9 3 Using Links The links represent the topology of the labyrinth activity You can use these links creatively to assemble different kinds of labyrinths A randomly selected link can be used to represent a dice throw make six links each for one of the dice values and then set the node to select just the one randomly When the labyrinth is played the dice throws will be randomly selected each time use alternative link text to hide what the value is You can use alternative text and icons to control how options are presented to the user For instance you can allow users to select the image that best suits the question such as interpreting an x ray or a histology image You can use different li
32. ctive of its previous value These values can then trigger rules based on the current value of each counter e Conditionals these control access to a node based on which nodes the user has visited previously For instance a rule that looks like 15 OR 16 would mean that a user couldn t enter node 17 without having visited nodes 15 or 16 first Each rule is made up of node IDs connected with standard Boolean operators e Timers these provide a real time countdown at the end of which the user needs to restart the activity A 300 second timer would mean that the user would need to complete the activity in 5 minutes 1 8 Feedback The user can be given extensive feedback based on their choices in playing a labyrinth This includes a report of which choices were made the counter values and whether nodes were marked as must visit or must avoid There are a number of author configured feedback rules including e Feedback per node visited e Feedback depending on the numbers of must visit and must avoid nodes visited e Feedback on the time taken to complete e Feedback on values of counters at the end of the session 1 9 Data Elements and Clusters OpenLabyrinth has been designed to import to and export from the MedBiquitous virtual patient data standard an emerging specification for the exchange and reuse of virtual patient activities between different authoring and player systems The MVP model is made up of four co
33. current labyrinth and node ID and your current score if used e Reset link this ends your present session and restarts you in a new session within the same labyrinth e A link to OpenLabyrinth home page clicking the OpenLabyrinth icon returns you to the home page e Other graphics links tools and text may also bee displayed depending on the current skin 5th MCP dislocation Gout Boxer amp apos s fracture Happiness 50 Gonococcal monoarthropathy Review your pathway E Figure 4 a typical labyrinth screen s elements A Node title B Node message content C Links options D Counters label plus current value E Link to review nodes viewed in the current session F Open note taker G Current labyrinth and node information H Reset restart current labyrinth I link to OpenLabyrinth home page J Skin specific graphics and text Page 10 of 52 OpenLabyrinth User Guide v2 5 2 4 What happens next What the user experiences depends on the design of the labyrinth they are playing and the choices available within it but typically a user makes decisions as to which path they shall take and these decisions have different consequences depending on the rules set on the nodes they pass through Scores and counters may go up or down paths may be dead ends or choices may end the current activity while other paths will be successful Therefore when you are playing a labyrinth you should think carefully about the options ava
34. e Moreover OpenLabyrinth is provided as open source which means that users are free to reuse and adapt the code to meet their own needs You are strongly encouraged although not required to share any new code with the OpenLabyrinth community Examples of code changes could include e New services such as tracking a differential diagnosis e New data elements such as those for a different professional discipline e Integration with other systems such as VLEs assessment systems or The homepage can also be customized in particular there is a section below the 6 Labyrinths I have playod OpenLabyrinth 5 collections Ope Labyredh is an open source 6 open Labyrinths educational pattway suthonng and Gay system Labyrinths am Authoring closed Labyrinths ono be hey Labyrinth a tremole services 3 presentations OQ create Labyrinth users D O Figure 23 the OpenLabyrinth homepage Page 40 of 52 OpenLabyrinth User Guide v2 5 8 3 Documentation A copy of this user guide is also provided in PDF and Word DOC format This can be amended and reused as set out in the Creative Commons Attribution Noncommercial Share Alike 3 0 license see http creativecommons org licenses by nc sa 3 0 For instance you could add new instructions translate or adapt it for different contexts 8 4 Mashups OpenLabyrinth remote web services can be used to create mashups with other remote applications For instance e alabyrint
35. e University of Edinburgh This latest version includes work from the Northern Ontario School of Medicine and the University of Edinburgh as well as input from partners in Canada the UK Germany Australia and the US This guide is intended to act both as user guide and technical documentation for the system 1 3 Installing OpenLabyrinth OpenLabyrinth is a web application written using Active Server Page ASP code written in VBScript To run it needs to be running in Internet Information Services IIS which is part of Microsoft server technologies as well as Windows XP Vista for single users OpenLabyrinth also requires a database joining the code and the database using an ODBC connector The most suitable database is MS SQL Server the Express edition is available for free See appendix 1 for more details on how to install and configure OpenLabyrinth 1 4 Labyrinths A labyrinth is the principal unit of organisation within OpenLabyrinth Each labyrinth has a series of global properties such as the type game maze algorithm etc its authors timers visual appearance skins security Page 5 of 52 OpenLabyrinth User Guide v2 5 scores and counters etc Within each labyrinth there are a series of linked pages or nodes that define the options available to the user each of which can be enhanced with a number of behaviours and services to further structure the user s experience and gameplay 1 5 Nodes A labyrinth s node
36. e embodied in the Original Work as furnished by the Licensor for the duration of the patents to make use sell offer for sale have made and import the Original Work and Derivative Works Grant of Source Code License The term Source Code means the preferred form of the Original Work for making modifications to it and all available documentation describing how to modify the Original Work Licensor agrees to provide a machine readable copy of the Source Code of the Original Work along with each copy of the Original Work that Licensor distributes Licensor reserves the right to satisfy this obligation by placing a machine readable copy of the Source Code in an information repository reasonably calculated to permit inexpensive and convenient access by You for as long as Licensor continues to distribute the Original Work Exclusions From License Grant Neither the names of Licensor nor the names of any contributors to the Original Work nor any of their trademarks or service marks may be used to endorse or promote products derived from this Original Work without express prior permission of the Licensor Except as expressly stated herein nothing in this License grants any license to Licensor s trademarks copyrights patents trade secrets or any other intellectual property No patent license is granted to make use sell offer for sale have made or import embodiments of any patent claims other than the licensed claims defined in Section 2 No
37. e managing files section Info content additional supporting content can be added in this field If there is any content in the info box for a node then an info button will render at runtime that launches a popup window containing the information This would typically be used to provide supporting factual information commentary or advice from a character such as a tutor or links to other materials and content outside OpenLabyrinth Node counter functions for every counter created this is where they can be dynamically changed You can leave this blank or use one of or or plus an integer For instance 5 adds 5 to the current counter while 6 sets it to 6 no matter what it was before Exit node probability settings this toggles on off whether just one of the linked nodes will be presented at random or all of them presented at once Conditional rule settings this allows you to set conditional rules for the current node These rules specify what nodes need to have been visited before the current one can be accessed When creating a conditional rule a message to the user is specified along with a Boolean statement of which nodes are required For instance 1 AND 2 OR 3 requires the user to have visited node 1 and either nodes 2 or 3 before accessing the current node Editing a conditional rule deletes any previous rule requiring it to be reset Link function style this changes how the linked options are displ
38. eea az 45 Appena B U parade 0 A a e a 48 Appendix 2 Academic Free License AFL v 3 0 ooooooccccnnnoccccccnnnoncnccnnnnnnncncnnnnn cnn c nan nnnnr naar nn nn nn naar nn narran nncarnnnnnnes 50 Page 4 of 52 OpenLabyrinth User Guide v2 5 1 Introduction 1 1 What s new in version 2 5 The last major release of OpenLabyrinth was v2 08 released in early 2009 This new version v2 5 includes a great many new and upgraded features as well as a large refactoring of the codebase The following are the main changes in version 2 5 e Visual labyrinth editor e Vue export and resync e Upgraded MedBiquitous Virtual Patient import and export e Counters on links e Search Embedded questions e Nodegrid and countergrid editors e Collections e Counter visibility Improved data element and cluster handling e Improved file management e User interface improvements 1 2 What is OpenLabyrinth OpenLabyrinth is an open source online activity modelling system that allows users to build interactive game informed educational activities such as virtual patients simulations games mazes and algorithms It has been designed to be adaptable and simple to use while retaining a wealth of game like features OpenLabyrinth is licensed under the Academic Free License AFL v 3 0 see appendix 2 The original Labyrinth application was originally developed by the Learning Technology Section of the College of Medicine and Veterinary Medicine at th
39. essid y e Counters http OpenLabyrinth mvm ed ac uk counter asp id x amp cid y amp mode remote amp sessid z DAM Nodes http OpenLabyrinth mvm ed ac uk counter asp id x amp did y amp mode remote amp sessid z Each of these scripts bundles their response as a single XML element e lt OpenLabyrinth gt the root element e lt service gt a URL encoded HTML text response The following info button call is an example lt xml version 1 0 encoding UTF 8 gt lt OpenLabyrinth gt lt service gt Yourtroletin thistclinictis ttotreviewtpatientst ontbehalftoftyour Senior 2E H et tist presenttin thetclinic 2Ctandtwillt call in totseetift tyoutaretprogressingtwell in the case 2E Thististthe Virtual Hospital Environment 28VHE 29 2C taketadvantageto f the fact theret tistnot timetpressuretand make sure tyoutunderstand thetbasictsciencest youtaretapplying 2E Bettert thantgetting a textbookt toutt int front of the patient 2E lt service gt lt OpenLabyrinth gt 7 5 Basic OpenLabyrinth Client Functions The OpenLabyrinth client is relatively thin in that it only needs to send out appropriate and well formed requests and to parse format and present the returned XML data As any free text information is exchanged as hexadecimal data a converter from hex to plain text is required as is some data cleaning for instance e Changing instances of mnode asp to the local client URL e Changing instances of files to http OpenLabyr
40. folders are required objects for a SCORM package 6 6 Vue Export and Sync You can export the nodes links and text content of a map to a Vue file which can then be edited by a Vue editor The same Vue file can then be resynchronised with the labyrinth map it came from which will update all of the links nodes text content and the X Y and RGB properties 6 5 Import In a similar but reverse way to MVP export OpenLabyrinth can create a new labyrinth by importing and MVP package Follow the create link on the OpenLabyrinth home page and then select MVP import to upload an MVP package You select the zip archive this is uploaded to a new temporary directory unzipped the XML files parsed and the data written into the database files copied to new directories and when all the importing has been done the temporary directory deleted and a link to the new labyrinth presented to the user Page 32 of 52 OpenLabyrinth User Guide v2 5 7 OpenLabyrinth Remote Services 7 1 Description In addition to playing OpenLabyrinth activities within OpenLabyrinth itself you can also run them in a remote system such as a virtual learning environment or e assessment system by using OpenLabyrinth Remote Services These services use XML to send OpenLabyrinth node content to the remote client that then communicates back using simple URLs see figure 18 AEMOTE CLIENT REMOTE CLIENT me I renders ciickable list of avaliable maps v p
41. g groups and managing their membership are below those for users on the same page 6 2 Language support The user interface language is set in the user account creation or editing pages If you change your own user language then you must logout and log back in for the changes to take effect Currently there are just two supported languages English and French Note that the user guide is currently available only in English although a French translation would be most welcome Note that the user interface phrases are stored in the interface xml file sitting in the documents folder at the OpenLabyrinth root At present the French translation is likely to be pretty poor limited as it is to the author s memories of school French and the quality of Google Translate Corrections and improvements are invited Furthermore anyone willing to translate the 370 or so interface elements into a third or fourth language are welcomed and encouraged Simply add a language tag at the top of the XML file eg lt language ID KN name klingon gt and then add an additional element for each phrase eg lt phraseKN gt qapla lt phraseKN gt Return to the author for inclusion in the next release Page 30 of 52 OpenLabyrinth User Guide v2 5 P interface xml Notepad File Edit Format View Help lt xml version 1 0 gt A lt phrases gt 4 lt languages gt lt language ID EN name english gt lt language ID FR name franca
42. g one add the remote user to any maps you want to be available in the remote service call the remote service by adding hashed userlD and password credentials uid xxx amp pwd yyy using the cookieHash function in UTILITIES ASP There is a commented function in REMOTE ASP that allows you to generate the hashed credentials by registering a remote service To set this up click on remote services on the home page and then add a service give the service a name and enter the IP address or range of the remote server Leave box 4 or 3 and 4 blank to indicate a range of IP addresses e g put 123 in box 1 and 45 in box 2 to accept any IP starting with 123 45 once the service has been created then add Labyrinth Maps to the service by clicking add edit Labyrinths and adding them from the dropdown menu 7 3 Remote Services Components and Messaging There are at least three discrete functions required at the client end 1 Client list this queries OpenLabyrinth for the OpenLabyrinth activities assigned to the current remote service and then formats and displays the results of the query Client player this interacts with the MNODE ASP script in OpenLabyrinth to run the activity Client remote services these support additional OpenLabyrinth services like info boxes counters and DAM nodes In addition there may be local services layered on top of the remote OpenLabyrinth application The components and their accompanying mes
43. general metadata properties for this particular map Map type o Maze and Algorithm these only use one message box so that the use of scores is not advised for these labyrinth types counters should be used instead Maze is the default type o Game uses scores to control messages deprecated from v2 08 onward o Key feature problem enables additional assessment functionality Skin selection a labyrinth can be skinned to appear in a range of different visual styles you can select from any of the existing skins Note that some skins have some OpenLabyrinth features disabled See section 9 on customizing OpenLabyrinth for more information on developing and using skins Score properties the starting and threshold value for scores can be set here integers only as can the units label for the score Page 15 of 52 OpenLabyrinth User Guide v2 5 e Timing whether the map uses a real timer and the time delta time available set in seconds integers only e Security can be set see table 1 for an outline of the settings and what they mean Security View run Edit Duplicate type Open Yes Closed Only if logged in Only if logged in as an Only if logged in and Only if logged in and Private editor for the particular registered as an editor for registered as an editor for the labyrinth the particular labyrinth particular labyrinth Requires a text based ney key to run e Section brows
44. h could be used to link with a wiki by pairing its nodes with the wiki pages e a labyrinth could be used to link with other mashup applications such as Flickr YouTube or various Google services See section 7 for more information on using the OpenLabyrinth remote services Page 41 of 52 OpenLabyrinth User Guide v2 5 9 Development Techniques This section pulls together some advice and tips on creating and using OpenLabyrinth activities 9 1 Using Vue Vue is a free topic mapping tool from Tufts University see http vue uit tufts edu for both Windows and Mac You can use it to create designs for labyrinths by creating boxes to represent nodes and the links between them Although Vue supports many other features only the boxes converted to nodes text in the boxes nodes and the links between nodes will be imported but everything else will be ignored Vue allows a whole design to be viewed at once and to be built in whatever way the author s wish see figure 19 for some examples For instance a Vue design could be data projected for a group of authors to comment and build up a map collaboratively gt lt gt ii Sipe lt tLu o _ 2 kin o f A Pa T lt E A eg axe a st WO SS e eS Se _ T i e D fade ER 3 ee SHA AR LM JA o A gt A Kernan are LAA lt a SP p a fans a _ ae n ee A Y aa Figure 24 Some example la
45. he nodes in one go That is when you use nodegrid Basically it provides a basic text box editor for the title and body of every node in a labyrinth for every node ina labyrinth 4 6 Sections Node sections are a way of organising nodes into logical groups They can be used to help authoring particularly where there are a great many nodes or several nodes have the same title They can also be used to create a menu to help users browse through a labyrinth Page 17 of 52 OpenLabyrinth User Guide v2 5 e You can add and edit node sections and assign nodes to node sections from List edit this labyrinth s node sections link on the main editor page e You can add a node section by typing a label into the form at the bottom of the node sections page and clicking submit e You can edit an existing node section by clicking on the edit link next to its name on the node sections page which also lists the nodes assigned to each section This provides a list of the current nodes in the section that allows you to order them and remove them from the current section You can also add any unassigned node to the current section Note that a node can only be assigned to one section ata time e You can control how the node sections are shown to the user The choices are don t show visible navigable clickable In the latter the section label becomes a hyperlink to the first node in the section 4 7 Links The links editor in a map
46. ilable to you keep an eye on any counters or timers in the activity and follow the instructions and hints given you Some skins support multiple user modes where services such as information can be turned off to make the activity more challenging 2 5 Tracking and Feedback Every option selection or click along with the current score timer and counter values is recorded as you work through a labyrinth This tracking supports the pathway review function and any conditional and feedback rules as well as being able to generate a report on how the user did within the activity If the current labyrinth has been set to provide a feedback report then at some point the user will be presented a link that says end session and view report this will end the current session and provide a comprehensive feedback report see section 5 for more information If you are logged in on the OpenLabyrinth home page there is a My OpenLabyrinths link from which you can view a list of every OpenLabyrinth you have started behind which there is a user session report that shows what path was taken how much time elapsed between entering and leaving the node and the varying level of any counters A histogram of this data is also available Page 11 of 52 OpenLabyrinth User Guide v2 5 3 Creating a Labyrinth There are four ways to create a labyrinth within OpenLabyrinth stepwise manually using a tool called Vue importing a MedBiquitous
47. in scores etc As log as the node ID requested is in an activity that is allowed in the current service an XML response is sent back with the following elements lt OpenLabyrinth gt is the root element lt mnodetitle gt is the current node s URL encoded title lt mapname gt is the current activity s URL encoded title lt mapid gt is the current activity s integer lt mnodeid gt is the current node s ID integer lt mapscore gt is the current activity score integer lt message gt is the current node s URL encoded body text lt colourbar gt is the current node s URL encoded text indicating the use of colour bars for zoned scores in game mode only lt linker gt is the current node s URL encoded HTML links lt tracestring gt is the current node s URL encoded HTML for the trace track lt rootnode gt is the node ID for the current activity s root node integer lt infolink gt is the current node s info button URL encoded HTML lt usermode gt is a toggle value between basic and expert lt dam gt is a list of any associated MVP Data Availability Model nodes lt mysession gt is the GUID for this particular user session lt counterstring gt is URL encoded text of links for all the counters in this map lt timestring gt and lt javascripttime gt are deprecated in the current version disregard As an example Page 36 of 52 OpenLabyrinth User Guide v2 5 lt xml version 1 0 gt lt OpenLabyrinth gt
48. indicating its title and current value If the value is changed at a particular node that value change is also displayed Clicking on a counter link will launch a popup window with full details about that counter Changing the value of a counter as a user moves through a map is set in the node editor which has a function box per counter you can leave this blank or use one of or or plus an integer For instance 5 adds 5 to the current counter while 6 sets it to 6 no matter what it was before Counter rules can be added from the editor for a particular counter Each rule consists of the following components e An integer value e An operator equal to not equal to less than or equal to less than greater than or equal to greater than e An action if the condition is met o Goto one of the nodes in the current labyrinth Note that the counter value should be reset at the target node or the program will loop o Show a message in place of the default node message For example if counter 3 is greater than or equal to 50 then show message well done From this versions counter functions can also be set on links This means that the value of a counter can be changed based in the link selected rather than the node entered From this version the visibility of each counter can be controlled by setting it to show or do not show 4 15 Countergrid Countergrid shows a function box for every node and ever
49. ing this controls how the node sections are shown to the user The choices are don t show visible navigable clickable 4 4 Nodes To view the nodes in the current map click the nodes link in the main editor This node edit screen lists all of the nodes in the current map first those allocated to a node section and then all those that are unallocated Clicking on the title of a node will preview it clicking on edit will launch the node editor and clicking on links will launch the link editor There is a link at the top of the node listing page to let you add a new node Whether you add or edit a node this will launch the node editor which has the following features e Toggle html and WYSIWYG editors there are two editing modes The first and default mode is in HTML view where text and HTML code is entered directly into the title content and info fields the alternative is a WYSIWYG what you see is what you get editor that provides an interface somewhat akin to a word processor In OpenLabyrinth this is provided by the TinyMCE component There are links at the top of the page that let you toggle between these two modes Click on the icon in the WYSIWYG editor for information on how to use it see figure 7 hy Ic 3 W Ill i 10 Styles w Paragraph v E 5 29 Ju J HTML 2 H x x Q Es Figure 7 the WYSIWYG tool bar e Node title this is both the title displayed in the
50. instance the same character in different settings and saying or thinking different things or perhaps many different interacting characters Each avatar can be customized as follows Sex age eyes open or closed outfit mouth shape the colour of their outfit for some outfits only their nose type hair type and colour three different layers of accessories such as wounds glasses bandages etc skin tone and colour background colour background scenery background weather and the kind of speech or thought bubble used and what text should go in it Once created each avatar has a reference that looks like AV 123 Copying this tag and pasting it into the contents of a node or info box and allows it to be incorporated and reused anywhere in the current Labyrinth You can duplicate an existing avatar for instance to create a series around a single character and you can edit them and delete them See figure 10 Avatar Editor 4 4 OpenLabyrinth eee sames ay es rere Figure 10 the avatar editing screen Thank you to Stewart Cromar at the University of Edinburgh for developing and sharing the code and media to allow us to include this feature in OpenLabyrinth Page 21 of 52 OpenLabyrinth User Guide v2 5 4 13 Files You may wish to add images sounds videos documents spreadsheets or other discrete files to your OpenLabyrinth map To manage your files click on the list edit this OpenLabyrinth s files images etc
51. inth mvm ed ac uk files in any OpenLabyrinth resource URLs such as images Page 37 of 52 OpenLabyrinth User Guide v2 5 e Changing certain links so that they open in a new window e Changing instances of any HTML escaped characters back to their base format for instance instances of Sapos should be turned back to an apostrophe 7 6 OpenLabyrinth Client Enhancements The previous few sections have outlined the underlying basics of creating a remote OpenLabyrinth client service It is possible however to build additional services on top of this as meet the requirements of the system in which the client service is instantiated These services may be global to all surfaced OpenLabyrinth cases they may be attached to specific activities identified by their unique map ID or to specific nodes identified by their unique node ID Examples from existing clients include e The ability for users to make their own notes either at a particular node or throughout an activity e The ability for users to record particular kinds formats of data for instance when working with a virtual patient it is useful to be able to record several differential diagnoses to rank them and then to progressively whittle them down to a definite diagnosis as the activity unfolds e Cross integration and mashups with other dynamic web applications Page 38 of 52 OpenLabyrinth User Guide v2 5 8 Customization Skins and Mashups 8 1 Skins The skins cont
52. ion or suit relating to this License may be brought only in the courts of a jurisdiction wherein the Licensor resides or in which Licensor conducts its primary business and under the laws of that jurisdiction excluding its conflict of law provisions The application of the United Nations Convention on Contracts for the International Sale of Goods is expressly excluded Any use of the Original Work outside the scope of this License or after its termination shall be subject to the requirements and penalties of copyright or patent law in the appropriate jurisdiction This section shall survive the termination of this License Attorneys Fees In any action to enforce the terms of this License or seeking damages relating thereto the prevailing party shall be entitled to recover its costs and expenses including without limitation reasonable attorneys fees and costs incurred in connection with such action including any appeal of such action This section shall survive the termination of this License Miscellaneous If any provision of this License is held to be unenforceable such provision shall be reformed only to the extent necessary to make it enforceable Definition of You in This License You throughout this License whether in upper or lower case means an individual or a legal entity exercising rights under and complying with all of the terms of this License For legal entities You includes any entity that controls is controlled
53. is gt lt languages gt lt phrase gt lt phraselD gt 1 lt phraselD gt lt phraseen gt this sets whether exit nodes will be chosen at random or whether all options are presented lt phraseeNn gt lt phraseFR gt ceci place si des noeuds de sortie seront choisis au hasard ou si toutes Jes options sont pra amp 233 senta 233 es lt phraseFR gt lt phrase gt lt phrase gt lt phraselD gt 2 lt phraserDb gt lt phraseEN gt add data cluster lt phraseen gt lt phraseFR gt ajoutez faisceau de donn 233 e lt phraseFR gt lt phrase gt lt phrase gt lt phraselD gt 3 lt phraselDb gt lt phraseEN gt add a data element lt phraseEn gt lt phraseFR gt ajouter un amp 233 1 amp 233 ment de donn 233 es lt phraseFR gt lt phrase gt lt phrase gt lt phraselD gt 4 lt phraselD gt lt phraseEN gt add a node lt phraseen gt lt phraseFR gt ajoutez un noeud lt yphraseFRr gt lt fohrase gt Figure 15 the interface xml file that can be found in documents interface xml 6 3 Presentations Groups of Labyrinths can be collected together as presentations for instance as a course page or a bank of assessment items To create a presentation click on the presentations link on the home page add the details for the presentation such as any text to be shown and user options and then submit Edit a presentation to add specific labyrinths to it Note that you must be an author on any labyrinth you wan
54. le or set a path for an image or icon to be used instead of a textual link Add a counter function to a link this will only activate when the link is clicked This is different from the previous OL model of counter functions only being available on the node 4 8 Preview This starts the labyrinth running in a new window 4 9 Using the Visual Editor The visual editor is a Flash based tool that allows you to add edit move and delete nodes links and node content rather like Vue but inline to OpenLabyrinth so that edits are made direct to the Labyrinth and can be previewed at once You launch the visual editor from the editor pane which opens in a new window Page 18 of 52 OpenLabyrinth User Guide v2 5 a OpenLabyrinth A aot You do not need to participate Ti vou cote a rok ome ear e pm Give Tara and ter tamy me Rhinorrhes Yes runny naze Cova Tara oe ee eS as Dysuriz This is more likely to Fever Yes this can be typica a Fene Ya ie on be yaoi d ary here if 1 gt 3 Screening Clinic Figure 8 the visual editor zooming click and drag the zoom control in the top left of the window the zoom amount shows in the slider the default is 100 Multitouch zoom two fingers can also be used if your computer supports it panning moving around click and drag in an open area to drag the workspace around a newly imported labyrinth may need to be dragged into view first zoom out to
55. lists every node in the left hand column and every link from that node in the right Every left hand node entry allows you to edit its particular links or preview it Every linked node entry on the right allows you to go to that particular node s entry in the left hand column or preview it The editor for a specific node s links allows you to e Change the type of linking from the current node there are three kinds of node linking that can be set here o Ordered this allows you to specify the order that links will be shown This ordering is set in the current link editor using numeric dropdowns per link they evaluate low high o Random order this means that the order of the available links from the current node will be randomised every time the node is loaded o Random select this means that just one of the available links will be randomly selected note that this property can also be set in the node editor e Edit current links from the current node this allows you to order links if linking type has been set to ordered delete links or edit them If you are editing a link the form looks very similar to that for adding new links see next section e Add anew link to the current node this allows you to select a node to link to from a dropdown list of every node in the current map not already linked from the current node You can also optionally set alternative text for the link the default is the target node s tit
56. lists of nodes and at the top of the page and the default text of any link to the node although this can be overridden see links section e Node content This is what is shown to the user and is where narrative images and instructions are added Depending on the global setting for map type there are different editor boxes for node content If the map is set to be a Game this uses scores to control display between three content boxes green orange and red Content from the green box is shown if the score is above the threshold set in the global properties and no other rules have overridden it Content from the orange box is shown if the score is at or below the threshold set in the global properties and greater than zero and no other rules TinyMCE is a platform independent web based Javascript HTML WYSIWYG editor control released as Open Source under LGPL by Moxiecode Systems AB Copyright 2003 2006 Moxiecode Systems AB All rights reserved For more information visit the TinyMCE website at http tinymce moxiecode com Page 16 of 52 OpenLabyrinth User Guide v2 5 have overridden it Content from the red box is shown if the score zero or below If the map is set to Maze or Algorithm then there is only one content box Note that to add a media resource such as an image you need first to upload the file and then copy and paste its wiki style reference into the node content box where you want the file to appear se
57. ll four of these methods do the following e Add the ID of the current user as an author of the new labyrinth e Set the new labyrinth security to private this means it is listed in the Labyrinth s am Authoring section on the home page e Set the labyrinth type to maze e Set section browsing to off Page 13 of 52 OpenLabyrinth User Guide v2 5 4 Editing in OpenLabyrinth All aspects of a labyrinth can be edited by anyone who is logged in with edit permissions for that particular labyrinth Simple content editing can be carried out within a node as the labyrinth is being played while more advanced features are available through the labyrinth editor 4 1 Inline Editing The title and content of a node can be edited from within that node if the current user has authoring rights to the current labyrinth Click the link saying turn editing on to switch into inline editor mode You will be able to change the current node s title and content from here or click directly to the more advanced editing tools see figure 5 Start from here Map Abdominal Pain 1 Node 4421 B mergency room It s 00 it s reset A then s something h You are a resident working in a small tovm rural e ide and it s been a quiet evening and th C OpenLabyrinth A OpenLabyrinth is an Styles Format open source 22 239 kb ka J wm educational pathway system n li el rs F 3 4 S tn i Y i Submit links
58. mponents e VPD virtual patient data functioning as the electronic patient record a VPD is a collection of VPD elements Although designed to support clinical data this could just as easily be used to support any reusable data element such as a character name or unit of measure These are therefore called data elements in OpenLabyrinth MR media resources this includes all supporting files including images and documents An MR Set is a collection of MR elements Each MR element has properties of name path mime type and arguments Media resources are handled using the OpenLabyrinth file manager e AM activity model this describes what the user can and cannot do Activities are described as a series of nodes containing narrative and educational content with links between them Both nodes and links have rules associated with them to enhance the options for educational gameplay This maps directly to the node and link aspects of OpenLabyrinth DAM data availability model aggregations of VPD and MR elements DAM contains at least one VPD element or MR element although more typically it contains many such elements In terms of OpenLabyrinth its activities correspond to the OpenLabyrinth activity itself MR equates to the file handling capacity of OpenLabyrinth while VPD and DAM functionality have been added as data elements and data clusters respectively VPD and MR data elements can be linked directly into
59. nk types to create more specific designs For instance Key Feature Problems KFPs can be designed using dropdown menus Fischer et al 2005 9 4 Using Counters You can use counters to track different kinds of values during an activity Costs a maximum financial budget can be set as the starting value and each choice that involves expenditure can have that cost deducted from the budget Time a time budget can be deducted from or arbitrary time added to based on the choices made For instance selecting a blood pressure test may take 3 minutes while a CT scan may take an hour Psychological factors such as morale general health or satisfaction can be tracked based on choices made Clinical specific factors such as blood pressure heart rate or respiratory rate can also be tracked against decisions made Artefacts such as tools drugs equipment or keys can be acquired value increased and used value decreased using counters Remember that you can have any number of counters in any one labyrinth 9 5 Different Kinds of Labyrinth Designs There are lots of different kinds of designs you can build in Labyrinth Standard professional narratives such as history examination investigation diagnosis and treatment Narratives based on single cases or having to deal with multiple cases at once each intruding or interrupting the other Algorithms such as clinical guidelines diagnostic pathways for technical or user documentation
60. nnnnnn nn nn nn enn enn n nn nn nn nn nn nn nn nn nrnnnnnnnnnnrnnnnnnnnnnncninannns 12 3 3 Creating a OpenLabyrinth Map by Importing a MedBiquitous Virtual patient Package ooooonniocccnnninncccccccnnonancccnncnnnnns 13 3 4 Creating a Labyrinth by Duplicating an existing Labyrinth oooonnnnccnnnnconnncccnnonccnnncnnnonanannoro conan cnn narrar 13 3 52 Whe New Labyrinth wanes ee ei lee ee eee 13 4 Editing in OpenbLabyrinth shoei dio osea beeen 14 Gill ma a E 2 lt a face decd ceca eso DA ae AUN Yo obese ECO tarde cation ateasa ats 14 42 Editor FUNCHONS O Dre 14 4 3 GlobalipropertieSy saeco ee A ce Ae ee eee eh RAN A A O OEA 15 AAN Se a e o ele cs Aad ed as kat epee 16 4 52 oTe e O O AER 17 A A E 17 A A A dd de es 18 A O A 18 4 9 Using the Vistial Editor wet iaa na ae 18 A O se 21 AVA QUESTIONS iia A o 21 ALA Vda il o dais 21 Page 2 of 52 OpenLabyrinth User Guide v2 5 AAO FICS EE eset aS bigs LOS es Lt E a ts Me E A eed ad eos sated 22 4 14 Colt Suit davai ke aa ee ai i ete ea 23 4 15 Countergridy wisi puna n a a ai n nash al Abelian A AA aa aaa a added aril Abe Sievert savy aa E 23 416 Data Elm iaa AA A eg ee ee 23 4 Data Clusters ich aise ari areas a Ne A eee EA 24 4 18 SESSION TEPOMS i wiiee desist AA A ean lids 24 4 19 USAS AAA AAA ee nA A ee 24 A 20 d 610 hha ratte E EE EAA el iv cenit delta lee edi eid iil leet 25 4 217 A einer A eed ee sn scent hci eee eee A eee ed Re cece 25 4222 Delete wai haa a ee E
61. onal Education Design for Learning rethinking pedagogy for the digital age Beetham H and Sharpe R Routledge pp153 165 Fischer M Kopp V Holzer M Ruderich F J nger J 2005 A modified electronic key feature examination for undergraduate medical students validation threats and opportunities Medical Teacher Volume 27 Issue 5 2005 Pages 450 4 Page 44 of 52 OpenLabyrinth User Guide v2 5 Appendix 1A Installation OpenLabyrinth is a web application written using Active Server Page ASP code written in VBScript To run it needs to be running in Internet Information Services IIS which is part of Microsoft server platform as well as Windows XP Vista for single users OpenLabyrinth also requires a database joining the code and the database using an ODBC connector The most suitable database is MS SQL Server the Express edition is available for free Note that the setup requires a certain amount of technical experience in using server properties of Windows platform Preparation Provide one or more servers on which you will first need to install MSXML latest version see http Awww microsoft com downloads results aspx productID amp freetext msxml or http www microsoft com downloads details aspx FamilyID 3144b72b b4f2 46da b4b6 c5d7485f2b42 Internet Information Server IIS see http www microsoft com WindowsServer2003 iis default mspx Microsoft NET Framework v2 0 see http www microsoft com downlo
62. ont box shape and on screen location are all ignored on import to OpenLabyrinth but they can be used to help with the design process For instance different sections can have different colours e Links When you create a Vue map for upload to OpenLabyrinth ensure you make your arrows between boxes point in the right direction as these are parsed in the upload process directionless arrows are interpreted as bidirectional from A to B and from B to A Note also this import process is currently only one directional once a Vue map has been uploaded to OpenLabyrinth it cannot as yet be exported and reopened in Vue Arrow type Import result Non directional A link from A to B and a link from B to A One way back A link from B to A One way forward al 3 gt 8 A link from A to B Bidirectional a e gt 8 A link from A to B and a link from B to A e Pictures hyperlinks and other Vue properties and objects are not imported to OpenLabyrinth When you import from Vue the text in each box is taken as both the new node s title and content You can either specify the new labyrinth s name on import or use the default of the globally unique ID assigned to the new Page 12 of 52 OpenLabyrinth User Guide v2 5 labyrinth for example VUE_upload_126162A6 2BEB 4198 8D5B 4B093D60579E Either way you can subsequently change this and set other properties using the global editor You can choose whether
63. ople may wish to resurrect deleted maps they are not permanently deleted but disabled and held offline Contact an OpenLabyrinth administrator to reinstate a deleted map or go to the database and change the mapEnabled flag to y in the MAP table 4 23 Author Notes A simple note taker can be run for the authors of a labyrinth Click on the pencil icon to load the author notes editor This can be viewed and changed by any of the editors of any given labyrinth I 4 24 Key Feature Problems and Matching If the labyrinth type is set to Key Feature Problem then any node within that labyrinth can be set to be a matching question rather than providing links Turn matching on by going to any node in the current KFP typed labyrinth and scroll down to add text matching turn it on and submit the page Go back and re enter the node edit page and there is now an edit button next to the add text matching buttons Click edit to start adding different strings to be matched up to 12 per question as well as the score for a match and whether the match is critical or not You can also set the following e counter controlled this is the counter that is changed as a result of matching and adds the associated score to this counter Page 25 of 52 OpenLabyrinth User Guide v2 5 e strict off on this changes whether a string must be matched strictly or not for instance if the match term is cardiac arrest if the user enter
64. or not to use verbose new node naming With verbose naming turned on e ach node is named with the node number allocated in Vue using square braces to indicate that it hasn t yet been edited for example ID 2 see the patient Although this means that every node needs to be edited this ensures that the content and setup of the node is done properly Alternatively you can turn verbose logging off and up to the first 50 characters of the Vue node text will become the new node s title For more information on using Vue see the authoring guide at http vue uit tufts edu userdoc maps cfm gt POLA AN E ars Horn toa Figure 4 a screen grab of a virtual patient activity created in Vue 3 3 Creating a OpenLabyrinth Map by Importing a MedBiquitous Virtual patient Package OpenLabyrinth can create new labyrinths by importing MedBiquitous Virtual Patient packages The package and the import process are described more fully in section 6 3 4 Creating a Labyrinth by Duplicating an existing Labyrinth Any labyrinth you have edit access to can be duplicated as a template for a new labyrinth by clicking its duplicate link on the editor page A basic copy of the original labyrinth is created called Copy of allowing you to change any aspect while keeping the original untouched Note that duplicating just takes the basic structure and does not import files rules or other additional properties 3 5 The New Labyrinth A
65. ore any changes are added to the database editing links click on the triangle icon in the middle of a link to edit it Select one of two ways backwards only forwards only or no link and then click update Note that setting a link to none deletes that link change a node box background colour click on a colour slice in a node box to change the background to that colour Please also note the following From this version 2 5 Vue map imports include the X Y and RGB properties of every node Previous imports and any other node content will not by default have these properties and will be shown in a grid format Updating the viewer will save any changes It is recommended that this is done regularly particularly when creating new nodes to ensure they are saved and managed properly Page 20 of 52 OpenLabyrinth User Guide v2 5 4 10 Feedback This lets you control how the feedback will be presented to the user at the end of their session See separate section on this topic 4 11 Questions This lets you control how the feedback will be presented to the user at the end of their session See separate section on this topic 4 12 Avatars Avatars are animated simple images of the characters you might want to include in your Labyrinth either as passive representations of the characters in your narrative or taking part via speech or thought bubbles There can be any number of avatars per labyrinth for
66. rol how the labyrinth is presented to the user The skin for a particular labyrinth can be changed in the global editor Standard installed skins include basic PDA and NOSM the latter is presented as a development template for users to develop their own OpenLabyrinth skins Review your pathway E Figure 21 an example OpenLabyrinth skin for St Georges Medical School London UK There are a number of different presentation elements in an OpenLabyrinth skin see figure 21 A title B message C options D counters E review session F notes G metadata H reset session I link to home page J skin specific content Effectively all that different skins do is to change the layout and visual presentation of these elements see figure 22 amp Pocket PC WM 5 0 Differential diageons a dde rimel hag Figure 22 some example OpenLabyrinth skins To create a new skin Page 39 of 52 OpenLabyrinth User Guide v2 5 e Create a new skin folder in the skins folder you could start by duplicating an existing one e Edit the ASP skin script and the accompanying CSS stylesheet to change the HTML layout of the skin elements adding new content as you require e Add the skin reference to the SKINS table in the database this will allow it to be presented as an option in the global editor 8 2 Code OpenLabyrinth has been written in an open and largely modular way to allow for new developments and changes to the code bas
67. s cardiac they will get a match only if strict is turned off e number of options for user this is the number of text boxes and therefore tries the user has to submit candidate matches e next node this is the node that the user is taken to after the matching has been processed In a matching enabled node the user is presented with a series of text boxes and a submit button see figure 11 edit matching add the number of items to match enter up to ten matching variations case insensitive blanks ignored with scoring the counter this will change and whether matching will be strict exact match or not tension pneumothorax hemothorax hypovolemic shock gt counter controlled Question 1 yes Y no Y no Y no M no Y Question 1 An 18 year old male involved in an MVA arrives to the ER by amb 36 mn Decreased breath sounds on the left hemithorax trachea i 82 on room air What are the likely causes of this patient s con Figure 11 the matching editor and the way a matching question is presented to the user in this case with three attempts Page 26 of 52 OpenLabyrinth User Guide v2 5 5 Feedback and Reporting As with any educational program a labyrinth is at its most useful when it can inform a learner how well or how badly they performed It is even more useful when accompanied by suggestions about how they might improve their performance in future 5 1 Session Reports
68. s are the unit of presentation to the user typically webpages around which all the other labyrinth components are organised Although a labyrinth can have just the one node typically they will consist of many interconnected nodes Figure 1 shows a diagrammatic representation of a simple activity consisting of six nodes Every labyrinth node has a unique identifier node ID as well as a number of other properties such as a title textual content a type root or child and a series of rule and function properties The rules and functions determine what is presented to the user at any given node depending both on current node properties and what the user has done previously particularly concerning scores and counters Other node properties include whether it is the root node the labyrinth starting point whether the node must be visited or avoided and whether the user can end the session and see a report of how they did y Figure 1 nodes and links node 1 is linked to nodes 2 3 and 4 node 2 is linked back to node 1 node 3 is linked to node 4 node 4 is linked to nodes 5 and 6 node 5 is linked to node 3 and node 6 isn t linked to anything 1 6 Links Labyrinth nodes are connected by a series of links expressed as pairs of node IDs with some additional properties such as ordering icons and alternative text Because links are one directional from node A to node B a link back requires a second link from node B to node A with independent
69. s can also be added to a map so they can access it but not edit it 4 20 Export There are two kinds of export MedBiquitous SCORM and Vue e You can export a labyrinth to the MedBiquitous Virtual Patient package format see section 6 for more details To create an MVP package click on export MVP from the editor main menu select the appropriate licence to release the package and then create and download the zip file e You can export the nodes links and text content of a map to a Vue file which can then be edited by a Vue editor The same Vue file can then be resynchronised with the labyrinth map it came from which will update all of the links nodes text content and the X Y and RGB properties 4 21 Duplicate Any labyrinth you have edit access to can be duplicated as a template for a new labyrinth by clicking its duplicate link on the editor page A basic copy of the original labyrinth is created called Copy of allowing you to change any aspect while keeping the original untouched Note that duplicating just takes the basic structure and does not import files rules or other additional properties 4 22 Delete You may wish to delete a labyrinth you have started To do so click the delete this map link on the main editor you will be challenged whether you really want to delete this map If you are sure that you do then click the go ahead and remove this labyrinth button Recognising that some pe
70. saging flows are laid out in figure 19 Page 34 of 52 OpenLabyrinth User Guide v2 5 Labyrinth Remote system client list sends Labyrinth maplD remote asp mid x retums list of Labyrinths allowed for this service as title and root node IDs y client list start a Labyrinth mnode asp id x sends roo node ID and mode remote arias een nie client player NULL at this stage local connections and client services notes DDX mnode asp id Xx it a legit call then amp mode remote return a Labyrinth amp sessID y XML packet including session ID transacts info asp id x mnode amp mode remote calls amp sessid y client player counter asp id x amp cid y amp mode remote it Info type then call amp sessid z and return XML packet call a service it counter type then call and retum XML packet dam asp id x amp did y i if dam type then call amp mode remote and retum XML packet amp sessid z client remote services Figure 19 remote components and their interactions with OpenLabyrinth 7 4 OpenLabyrinth Remote Services Transactions There are three transaction types in the remote services OpenLabyrinthservice OpenLabyrinth and service 7 4 1 Transaction OpenLabyrinthservice This transaction is called by the client list function to get a list of the OpenLabyrinth activities available for the current remote service The URL for the call is http
71. t may change the nature of the following tasks you should consult a database administrator for help if you get stuck Page 46 of 52 OpenLabyrinth User Guide v2 5 Once the database is available Add a new database called OpenLabyrinth Run the script ol25master sql to create the tables and views Open the ODBC Control Panel Control Panels Administrative Tools and add OpenLabyrinth as a System Data Source Name DSN Add the local IUSR account to the database as a user Set permissions for IUSR for all stored procedures views and tables this will vary depending on the database setup you use but should allow permissions for CONNECT DELETE EXECUTE SELECT UPDATE Manually add yourself as a superuser directly to the USERS table making sure SuperUser y and userType s Launch a web browser and browse to the OpenLabyrinth site typically if you are running on a local computer and have placed the OpenLabyrinth directory in the website root then the URL will be http localhost openlabyrinth Log in using the account you manually added to the USERS table Once you have completed these steps that should be OpenLabyrinth all ready to go Page 47 of 52 OpenLabyrinth User Guide v2 5 Appendix 1B Upgrade If you are using a previous version of OpenLabyrinth and want to upgrade then you should be clear that a number of essential changes have been made since the last version CAUTION take a full backup of
72. t to include in a presentation see figure 16 presentations edit presentation presentation Labyrinths title second add Labyneth ususulu p Handyman 5 y update header teat cn eR i my presentations fent 1 preview ett footer text second 2 prevew ade Mock KFP Exam 3 preview ect allow multigle attempts on E of update add presentation mew bat ttle Figure 16 the Presentations authoring screens Page 31 of 52 OpenLabyrinth User Guide v2 5 6 4 Collections This allows you to create a collection of different labyrinths For instance there may be a set on a particular topic or that use a particular approach A labyrinth can be allocated to multiple collections 6 5 MedBiquitous Virtual Patient Export OpenLabyrinth currently exports to the MedBiquitous Virtual Patient XML format To create a package click the export MVP link This will run a script that creates a new folder copies the required files into it writes XML files for the various required components and then creates a zipped archive of the folder and its contents the user is then presented with a link to the zip archive The key elements are labelled as follows A The Zipped package B The IMS Manifest XML file that lists the contents of the archive C The metadata XML file in LOM format D Activity Model XML file E Folder containing all of the media objects F Virtual Patient Data XML file G DAM XML file The other files and
73. the code content and database before proceeding Add new tables from the ol25master sql script QUESTION QUESTION_RESPONSE COLLECTION COLLECTION_MAP COLLECTION_USERS PUBLISH CONTRIBUTOR Depending on the version you are using then check other tables are matched between your current build and the ol25master sq script The following outlines the changes to existing tables Table Column Action VPD VPDID int identity pk MapID int VPDType vc50 OldVPDID vc50 VPDELEMENT VPDElementID int identity pk VPDID int MapID int ElementType vc50 ElementValue vc 2000 OldVPDElementID vc50 DAM DAMName varchar 500 DAMID int identity pk MapID int DAMName vc100 OldDAMID vc50 DAMELEMENT DAMElementID int identity pk DAMID int DAMElementType vc20 DAMElementOrder int DAMElementDisplay vc15 DAMElementRef int To update DAM references from OldMRElementID to MRElementID use updateDAMv210 asp run once then delete USERSESSIONTRACE MapScore Delete column MapScoreNow Delete column Add column MDAMs varchar 200 MRELEMENT follow these remove PK Page 48 of 52 OpenLabyrinth User Guide v2 5 instructions in order rename MRID to MapID int rename MRElementID to OldMRElementID new column MRElementID int PK identity change AVATAR add column OldAvatarlD int make all char 1 columns into varchar 2
74. virtual patient package or duplicating an existing labyrinth 3 1 Creating a Labyrinth Manually This is where each node is entered manually one at a time along with the links rules etc The steps for authoring and editing are very similar other than for authoring you need to create a labyrinth first To do this first click the add a new Labyrinth link available to logged in users only and then fill in the form to set the new labyrinth s global properties Once you have created the new labyrinth you can then start building it up by adding nodes links between nodes and counters files rules and other dynamic properties A single root node will have been created as part of the labyrinth but all other nodes links rules etc will need to be added manually see section 4 on editing a labyrinth for more details 3 2 Creating an OpenLabyrinth Map using Vue Vue is a Java based visual concept mapping tool from Tufts University that can be downloaded for free from http vue uit tufts edu for both Windows and Mac You can use it to create designs for labyrinths by creating boxes to represent nodes and the links between them Although Vue supports many other features only the boxes converted to nodes text in the boxes nodes and the links between nodes will be imported everything else will be ignored by the parser There are a number of issues to consider when using Vue to design for OpenLabyrinth e Nodes and text the colour f
75. y counter so that counter functions can be set all in one go 4 16 Data Elements OpenLabyrinth supports the MedBiquitous Virtual Patient MVP data specification a key aspect of which is the use of data elements OpenLabyrinth supports the following MVP element types each of which has a different structure Page 23 of 52 OpenLabyrinth User Guide v2 5 e VPDText e PatientDemographics e AuthorDiagnoses e MedicationInterviewltem e PhysicalExam e DiagnosticTest e DifferentialDiagnosis e Intervention To use OpenLabyrinth data elements 1 Select data elements from the editor menu This will give a list of all the current data elements and a link to create a new element 2 You can edit or delete any of the data elements 3 On the new element page select the type of element you want to create from the drop down menu this will load a form to be completed to create the element Using a data element in a labyrinth involves pasting its tag into the content for any given node The tag has the format of VPD then the element s ID and then Jf i e VPD ER9MOMC see figure 9 You can also use data elements in data clusters Tiia RR RR lt p gt Enid s respiratory rate is 28 p Node lt p gt WPD 2F3A91B79 lt p gt ontent respiratory rate 28 min Enid s respiratory rate is 28 per minute Ask for more specific vital signs G Figure 9 an embedded data element in the node editor left and

OpenLabyrinth User Guide

Contents

Download Pdf Manuals

Related Search

Related Contents