Index: openacs-4/packages/imsld/www/doc/users_guide/ch01.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/imsld/www/doc/users_guide/ch01.html,v diff -u --- /dev/null 1 Jan 1970 00:00:00 -0000 +++ openacs-4/packages/imsld/www/doc/users_guide/ch01.html 26 Jul 2006 15:15:49 -0000 1.1 @@ -0,0 +1,24 @@ +Chapter�1.�Before starting

Chapter�1.�Before starting

Table of Contents

Introduction
Prerequisites

Introduction

This is a user's guide about the IMS-LD package of the .LRN + platform. It is not a user's manual nor a guide of how to create IMS-LD + courses. If you want to know more about the IMS LD standard, we + encourage you to read our introduction + to IMS LD, or, if you want to know more about it, read the + official IMS LD + specification.

After reading this guide the user will know how to install the + package, how to upload a Unit of Learning (Uol), how to create multiple + runs for the UoL, how to create and assign roles to each run, how to + assign users to each role, and most important, how to "play" the runs, + and how to user the rest of functionalities offered by the + package.

Prerequisites

This is the list of packages and its versions required by the + IMS-LD v.0.1

  • .LRN v.2.2.0a4

  • acs-content-repository v.5.2.2

  • acs-kernel v.5.2.2

  • acs-templating v.5.2.2

  • lorsm v.0.7d

  • dotlrn-lorsm v.0.4d

  • assessment v.0.17

  • dotlrn-assessment v.0.2

This requirements are specified in the imsld.info file of the + package, meaning that the system, when installing the IMS-LD package, + will automatically check for the user if all the requirements are + fullfiled. In case there is/are some requirements missing, a message is + shown and the package will not be installed.

Index: openacs-4/packages/imsld/www/doc/users_guide/ch02.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/imsld/www/doc/users_guide/ch02.html,v diff -u --- /dev/null 1 Jan 1970 00:00:00 -0000 +++ openacs-4/packages/imsld/www/doc/users_guide/ch02.html 26 Jul 2006 15:15:49 -0000 1.1 @@ -0,0 +1,19 @@ +Chapter�2.�Installing the package

Chapter�2.�Installing the package

Table of Contents

Download from CVS
Installing the package
Instantiating the package

Download from CVS

Go to the packages dir and type the following commands (you can + user your CVS account if you have one):

  1. cvs -d:pserver:anonymous@cvs.openacs.org:/cvsroot co + openacs-4/packages/imsld/

  2. cvs -d:pserver:anonymous@cvs.openacs.org:/cvsroot co + openacs-4/packages/imsld-portlet/

  3. cvs -d:pserver:anonymous@cvs.openacs.org:/cvsroot co + openacs-4/packages/dotlrn-imsld/

Installing the package

Go to the acs-admin index page, and in the install from local + services list, choose the "dotLRN IMS LD Applet". This will check for + all the prerequisites listed above.

Wait for the package manager to install the package and then + restart the system (if it is not configured to restart + automatically).

Instantiating the package

After installing the package, it is necessary to instantiate in a + community.

Go to the control panel of the community where you want to install + the package and from there go to the "Manage Applets" page and hoose the + "IMS-LD Applet".

Index: openacs-4/packages/imsld/www/doc/users_guide/ch03.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/imsld/www/doc/users_guide/ch03.html,v diff -u --- /dev/null 1 Jan 1970 00:00:00 -0000 +++ openacs-4/packages/imsld/www/doc/users_guide/ch03.html 26 Jul 2006 15:15:49 -0000 1.1 @@ -0,0 +1,108 @@ +Chapter�3.�Using the package

Chapter�3.�Using the package

Table of Contents

Admnistrator's guide
Uploading a Unit of Learning
Administrating the Units of Learning
Managing Roles
User's guide

There are two main parts of the package, one for the course + administrator and the other for the student, and they can be divided in + theese two sections:

  1. Uploading a UoL

  2. Using the player

Admnistrator's guide

Uploading a Unit of Learning

The first thing the administrator of the course has to do is to + upload a UoL.

This is done from the control panel of the course. There you + will find the administrator's interface of the package. Click on + "Units of Learning Administration" and you will be redirected to the + admin index page.

There you will find a simple interface to upload the UoL. It can + be a zip or tar file.

After clicking on "OK", a confirmation screen with a little bit + of information about the UoL is displayed. You can cancel or + continue.

Finally, the UoL is parsed and the first run is automatically + created. The parser will automatically detect if there is some + integration with LORS, assessment or with the forums package of .LRN + and will do the propper call to each package.

If everything is OK, you will be redirected to the roles + management interface. At this time, a default run has already been + created and its status is WAITING.

Administrating the Units of Learning

From the same page where you upload a new UoL, you can + also:

  1. Create a new UoL: Following the same procedure described + above.

  2. Create a new Run for the UoL: A run is an instance of the + Unit of Learning (as explained in the specification).

  3. Delete a UoL: Actually, marks the UoL as deleted, so you + can make it alive again after deleting it.

  4. Manage the members of a Run: If the roles management of a + certain run has not been finished by the course administrator, + then a link to the roles managment page is displayed here. If + the roles management is finished for a run, then there is no + link to it, since in the specification is stablished that once + the users have been assigned to their roles, there can be no + changes.

  5. Delete a Run: The same that deleting a UoL, it is only + marked as deleted so you can make it live again any time.

Managing Roles

After uploading a UoL you will be automatically redirected to + this page, but you can come back to this page anytime from the admin + index page of the package explained in the previous section. The run + status at this time is WAITING.

From this page you can crate the roles for the run, according to + the definition in the manifest of the UoL.

When creating the run, all the users that at that time are + associated to the community will be automatically associated to the + run, so the course administrator can choose only from those users when + creating the role instances. This also means that if after the cration + of the run new users are assigned to the community, the run members + will not change (as the specification stablishes), and will stay + constant for the rest of the run life.

After creatin the roles instances, the administrator must + confirm that the roles assignation is finished and all the + restrictions of roles specified in the manifest (like the max and min + number of members) are validated, and a warning message is displayed + if one of them is violated. Anyway, the course administrator can + confirm and change the status of the run from WAITING to + STARTED.

This is when the properties (if there are some) are instantiated + for the run. Each time a run is created the properties (and other + specific attributes) are instantiated for each user, role, run, etc, + depending on the type of property.

Finally, all the conditions for that run are evaluated for the + first time.

NOTE: When a run is in the STARTED status, no changes can be + made to it, and currently, the roles are assigned only at the begining + of the run, so no role changes can be made during the life of the + run.

User's guide

A regular user (member in a community or student in a class) can + have acces only to the player, which is the main part of the + package.

The runs where the user has any participation are displayed in the + portlet of the IMS-LD package of .LRN.

From here, the user can select a run and start (or + continue) with the run.

The player has been developed according to the + specification.

Each time an activity is finished the conditions affected by that + property are re-evaluated, and every time a property value is changed, + the conditions affected by that property are also evaluated, until we + reach an stable point again.

As shown in the image above, the scren of the player is divided in + 3 parts:

  1. Activities tree: Is displayed in the box placed in the upper + left corner of the screen. Here you can see the activities tree of + the UoL. The activities that are finished are marked with a + checkbox.

    Nothe that there may be activities that are finished from the + begining of the run (according to the specification), so it is not + necessary to mark an activity as finished for it to be displayed as + finished. Also, when visiting all the resources of an activity, the + player can asume that the activity is finished and mark it as + finished.

    Finally, in this frame only the tree is displayed, meaning + that the actual content of the activities is displayed in the + activities frame (esplained below).

  2. Environments tree: Is displayed in the box placed in the lower + left corner of the screen. Here you can see all the environments + associated to the activity that has been selected from the + activities tree.

    The environments can include associated files, urls, monitor + services, imsld content files (used to display and set properties + values), forums, emails, etc.

    Note that there may be monitor services that requires that you + must first have to select the user (from a list of users) in order + to monitor that specific user. This is done in the activities frame + (explained below). Also, the actual contents of the environments + (services or whatever) is served in that frame. In this frame only + the tree is shown.

  3. Activities frame: Is the big box at the right of the sreen. + Here are displayed the contents of the activity (the resources + directly associated to it) as well as the possible prerequisites, + learning objectives and feedback of the activity.

    When you click on a link in the environments tree, it will + also be displayed in this frame.

    As mentioned in the previous bullet, in this frame are + displayed the monitor services, as well as the email services and + imsld content resources. However, all the information that the user + has to enter is managed in this frame. For instance, in a monitor + service first you must select the user you are going to monitor, so + in the top of the frame a list of users is shown so you must first + select a user and then monitor the selected user. For the email + service you must select the role first and then send the email. All + that information (and more) is managed in the activities + frame.

There may be points in the life of the run where a user can see + the message "waiting for other users". This means that there are some + users associated to other role instances in the same run that have to + finish a specific activity before the player can continue with the next + activity (according to the specification, the acts can be user as + sinchronization points). You will be able to continue with the run when + the other users finish the required activities.

Finally, when the run is finished by all the users in the run, it + is set to the COMPLETED status. When a run is in this status, it can not + be "re-runed", it will stay as it is for the rest of the course life. If + you want to run the UoL again, you must go to the administration page + and create a new run.

Index: openacs-4/packages/imsld/www/doc/users_guide/html.css =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/imsld/www/doc/users_guide/html.css,v diff -u --- /dev/null 1 Jan 1970 00:00:00 -0000 +++ openacs-4/packages/imsld/www/doc/users_guide/html.css 26 Jul 2006 15:15:49 -0000 1.1 @@ -0,0 +1,362 @@ + +th{ + font-family: Verdana, Arial, Helvetica, sans-serif; + font-size: 12px; + font-style: normal; + height:50px; +} + +h1{ + font-family: Verdana, Arial, Helvetica, sans-serif; + font-size: 14px; + font-weight: bold; + font-style: normal; + color: #000000; +} + h2, h3, h4, h5 { + font-family: Verdana, Arial, Helvetica, sans-serif; + font-size: 14px; + font-weight: bold; + font-style: normal; + color: #000000; +} + +span.term { + font-weight: bold; +} + +div.sidebar { + background: #F0F0F0; + border: 1px solid gray; + padding: 5px; + margin: 20px; +} + +pre.programlisting { + background: #F0F0F0; + border: 1px solid gray; + padding: 2px; + font-size: 10pt; + white-space: pre; +} + + +.Pretitulo { + + font-family: Arial, Helvetica, sans-serif; + font-size: 8pt; + color: #CC0033; + text-align: justify; + font-weight: bold; +} +.Titulo { + font-family: Verdana, Arial, Helvetica, sans-serif; + font-size: 18px; + font-weight: bold; + color: #000066; + text-align: center; +} +.Subtitulo { + font-family: Arial, Helvetica, sans-serif; + font-size: 10pt; + font-weight: bold; + text-align: center; + color: #000000; +} +.TitDate { + font-family: Arial, Helvetica, sans-serif; + font-size: 10px; + font-weight: bold; + color: #000066; + text-align: right; +} +.copyRight { + font-family: Verdana, Arial, Helvetica, sans-serif; + font-size: 9px; + color: #999999; + text-decoration: none; + text-align: center; + font-weight: normal; +} +.pieFoto { + + font-family: Verdana, Arial, Helvetica, sans-serif; + font-size: 7pt; + color: #000000; + font-weight: normal; + text-align: left; +} +.textosNotaF { + + font-family: Arial, Helvetica, sans-serif; + font-size: 10pt; + color: #000066; + text-align: justify; +} +.textosLlamados { + font-family: Arial, Helvetica, sans-serif; + font-size: 11px; + color: #000066; + text-align: left; +} + +a:link { + font-family: Verdana, Arial, Helvetica, sans-serif; + color: #001F48; + text-decoration: none; + +} +a:visited { + font-family: Verdana, Arial, Helvetica, sans-serif; + color: #001F48; + text-decoration: none; +} +a:hover { + font-family: Verdana, Arial, Helvetica, sans-serif; + color: #007ECC; + text-decoration: none; +} +a:active { + font-family: Verdana, Arial, Helvetica, sans-serif; + color: #001F48; + text-decoration: none; +} + +.claro { + font-family: Arial, Helvetica, sans-serif; + font-size: 9px; + color: #001F48; + background-color: #DCF2FF; + text-align: center; +} +.oscuro { + font-family: Arial, Helvetica, sans-serif; + font-size: 9px; + color: #001F48; + background-color: #D3E5FD; + text-align: center; +} +select { + font-family: Arial, Helvetica, sans-serif; + font-size: 9pt; + color: #FFFFFF; + background-color: #037ECC; + padding: 0px; + margin: 0px; + BORDER: 0px none #037ECC; + scrollbar-face-color: #DEE3E7; + scrollbar-highlight-color: #FFFFFF; + scrollbar-shadow-color: #DEE3E7; + scrollbar-3dlight-color: #D1D7DC; + scrollbar-arrow-color: #006699; + scrollbar-track-color: #EFEFEF; + scrollbar-darkshadow-color: #98AAB1; + TEXT-DECORATION: none +} + + + +.titularPrinci { + font-family: Verdana, Arial, Helvetica, sans-serif; + font-size: 10px; + font-weight: bold; + color: #000066; + background-color: #EDEDED; +} + +.GenTable { + border-top: 1px #000066; + border-right: 2px solid #000066; + border-bottom: 2px solid #000066; + border-left: 1px #000066; + +} +.bgLeft { + background-color: #001F48; + border-bottom-width: 1px; + border-bottom-style: solid; + border-bottom-color: #FFFFFF; + font-family: Arial, Helvetica, sans-serif; + font-size: 12px; + color: #FFFFFF; +} +.bgRight01 { + font-family: Verdana, Arial, Helvetica, sans-serif; + font-size: 12px; + color: #003333; + background-color: #E4E7EB; +} +.bgRight02 { + + font-family: Verdana, Arial, Helvetica, sans-serif; + font-size: 12px; + color: #003333; + background-color: #F0F2F5; +} +.GenTableRed { + border-top: 1px #000066; + border-right: 2px solid #E30A17; + border-bottom: 2px solid #E30A17; + border-left: 1px #000066; +} +body { + background-color: #FFFFFF; + scrollbar-face-color: #DEE3E7; + scrollbar-highlight-color: #FFFFFF; + scrollbar-shadow-color: #DEE3E7; + scrollbar-3dlight-color: #D1D7DC; + scrollbar-arrow-color: #006699; + scrollbar-track-color: #EFEFEF; + scrollbar-darkshadow-color: #98AAB1; + font-family: Verdana, Arial, Helvetica, sans-serif; + font-size: 12px; + color: #000066; +} + +.TitPrincipal { + font-family: Arial, Helvetica, sans-serif; + font-size: 12px; + color: #FFFFFF; + font-weight: bold; + clip: rect(auto auto auto auto); +} + +.subTitu { + font-family: Verdana, Arial, Helvetica, sans-serif; + font-size: 14px; + font-weight: bold; + font-style: normal; + color: #000000; +} +.CelCeleste { + font-family: Arial, Helvetica, sans-serif; + font-size: 10px; + font-weight: bold; + background-color: #DEE3E7; + border-top-width: thin; + border-right-width: thin; + border-bottom-width: thin; + border-left-width: thin; + border-top-style: solid; + border-right-style: solid; + border-bottom-style: solid; + border-left-style: solid; + border-top-color: #FFFFFF; + border-right-color: #001F48; + border-bottom-color: #001F48; + border-left-color: #FFFFFF; + color: #000066; +} + + +.copyRight { + font-family: Verdana, Arial, Helvetica, sans-serif; + font-size: 9px; + color: #BACAD3; + text-decoration: none; + text-align: center; + font-weight: normal; +} +.TitSecundario2 { + font-family: Verdana, Arial, Helvetica, sans-serif; + font-size: 10px; + color: #000066; + font-weight: bold; + background-color: #DBF1FF; +} +.menu { + font-family: Verdana, Arial, Helvetica, sans-serif; + font-size: 7pt; + color: #001F48; + text-decoration: none; + text-align: left; + font-weight: 400; + background-image: url(../images/bUp.gif); +} + +.CelCeleste { + font-family: Arial, Helvetica, sans-serif; + font-size: 10px; + font-weight: bold; + background-color: #C5E9FF; + border-top-width: thin; + border-right-width: thin; + border-bottom-width: thin; + border-left-width: thin; + border-top-style: solid; + border-right-style: solid; + border-bottom-style: solid; + border-left-style: solid; + border-top-color: #FFFFFF; + border-right-color: #001F48; + border-bottom-color: #001F48; + border-left-color: #FFFFFF; + color: #000066; +} +.inputRight { + BORDER-RIGHT: thin solid #CCCCCC; + BORDER-TOP: thin solid #000000; + SCROLLBAR-FACE-COLOR: #ffffff; + FONT-SIZE: 12px; + SCROLLBAR-HIGHLIGHT-COLOR: #ffffff; + BORDER-LEFT: thin solid #000000; + SCROLLBAR-SHADOW-COLOR: #ffffff; + COLOR: #001F48; + SCROLLBAR-3DLIGHT-COLOR: #cccccc; + SCROLLBAR-ARROW-COLOR: #758cb3; + SCROLLBAR-TRACK-COLOR: #eeeeee; + BORDER-BOTTOM: thin solid #CCCCCC; + FONT-FAMILY: arial, helvetica, verdana, sans-serif; + SCROLLBAR-DARKSHADOW-COLOR: #ffffff; + TEXT-DECORATION: none; + background-color: #FFFFFF; + left: 0px; + top: 0px; +} +.CelWhite { + font-family: Arial, Helvetica, sans-serif; + font-size: 10px; + font-weight: bold; + border-top-width: thin; + border-right-width: thin; + border-bottom-width: thin; + border-left-width: thin; + border-top-style: solid; + border-right-style: solid; + border-bottom-style: solid; + border-left-style: solid; + border-top-color: #FFFFFF; + border-right-color: #001F48; + border-bottom-color: #001F48; + border-left-color: #FFFFFF; + color: #000066; + background-color: #ebebeb; + +} + +.CelCelesteBold { + font-family: Arial, Helvetica, sans-serif; + font-size: 11px; + font-weight: bold; + background-color: #C5E9FF; + border-top-width: thin; + border-right-width: thin; + border-bottom-width: thin; + border-left-width: thin; + border-top-style: solid; + border-right-style: solid; + border-bottom-style: solid; + border-left-style: solid; + border-top-color: #FFFFFF; + border-right-color: #001F48; + border-bottom-color: #001F48; + border-left-color: #FFFFFF; + color: #000066; +} +table{ + background-color: #FFFFFF; + border-color: #FFFFFF; + font-size: 12px; + font-family: Verdana, Arial, Helvetica, sans-serif; +} + Index: openacs-4/packages/imsld/www/doc/users_guide/index.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/imsld/www/doc/users_guide/index.html,v diff -u --- /dev/null 1 Jan 1970 00:00:00 -0000 +++ openacs-4/packages/imsld/www/doc/users_guide/index.html 26 Jul 2006 15:15:49 -0000 1.1 @@ -0,0 +1,8 @@ +.LRN IMS-LD Guide

.LRN IMS-LD Guide


Table of Contents

1. Before starting
Introduction
Prerequisites
2. Installing the package
Download from CVS
Installing the package
Instantiating the package
3. Using the package
Admnistrator's guide
Uploading a Unit of Learning
Administrating the Units of Learning
Managing Roles
User's guide
Index: openacs-4/packages/imsld/www/doc/users_guide/images/admin.png =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/imsld/www/doc/users_guide/images/admin.png,v diff -u Binary files differ Index: openacs-4/packages/imsld/www/doc/users_guide/images/confirm.png =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/imsld/www/doc/users_guide/images/confirm.png,v diff -u Binary files differ Index: openacs-4/packages/imsld/www/doc/users_guide/images/player.png =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/imsld/www/doc/users_guide/images/player.png,v diff -u Binary files differ Index: openacs-4/packages/imsld/www/doc/users_guide/images/portlet.png =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/imsld/www/doc/users_guide/images/portlet.png,v diff -u Binary files differ Index: openacs-4/packages/imsld/www/doc/users_guide/images/roles_admin.png =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/imsld/www/doc/users_guide/images/roles_admin.png,v diff -u Binary files differ Index: openacs-4/packages/imsld/www/doc/users_guide/images/sections.png =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/imsld/www/doc/users_guide/images/sections.png,v diff -u Binary files differ Index: openacs-4/packages/imsld/www/doc/users_guide/images/upload.png =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/imsld/www/doc/users_guide/images/upload.png,v diff -u Binary files differ