Data Manager Requirements
Introduction This document outlines the requirements for the Data Manager application built on the ACS 5.2 platform.
Vision Statement Most of object implied in the learning process can and should be reused, may be another time or may be in another computer. Data Manager package allows you to move .LRN objects from one class of community to another one. It also provides de possibility of export an object to a file and import it into another .LRN instance. Once a class or community is designed, this is, taks to be resolved and objects that takes part into this tasks, next step is to put all this events into the plattform. Obviously, it must be done by the administrator or the professor, while the student is just an spectator.
Historical Considerations Since the aim of this package is to move and copy objects created by another packages, and to do this from a unique interface, here is a brief list of several objects and the task allowed by them. Faqs: A faq can be disabled and enabled later. When a faq is disabled it does not appear in the community home, but it continue belonging to this community. You can also delete a Faq, but with this you don't delete any data from the database and neither you can recover the erased object. News: You can tag a New as archived, but it does not means that the object has been moved or deleted. Forums: As wells as faqs, a forum can be disabled and enabled. A forum cannot be deleted. Assessment: The assessment package provides de functionality to export and import to an QTI file. User portlet: File Storage Folders: A single file can be moved, copied and deleted. A folder can be deleted. When a item is deleted, it cannot be recovered.
Aplication Overview Datamanager package does not create new tables into data model, because it does not need any persistent data. The main task of the aplication is to provide a unique interface to move and copy objects, which implies that the database values must be modified. That means: this package does not need its own tables in the data model, but it has the functionality of changing the values of tables created for another packages.
Use Cases and Scenarios Involved roles are administrator and profesor, and tipical use cases in which datamanager can be used are: A profesor has done a mistake, so he has created an object into another community. He does not want just to delete this object, he would want to move it to the correct community. An object has been created, but it has been an error. The tipical procedure is to delete this wrong object or to move it to a invisible place. The period of a class has been finished, and the profesor want to reuse the objects in the next period or class. Here, the desired issue is to be able of copying objects, so the ended class can be archived without changes and the new one has all the required contents. Tipically, only the object root is needed. This is, avoiding to copy all the students comments. Despite of this, the two scenarios can take place. The platform will be instaled in a newer computer, or a new release of the platform leads the administrator to a migration of the system. In this case, the administrator can export objects to an xml file and later he will import them into the new instance of the platform. A platform has a really interesting object, so it is desirable to use this objects into another platforms, or just to store it into a file and place this file into a file server. With this, you allow another profesors to improve his own platforms using your interesting contents. In this case, the profesor will export the object to an XML file.
User Interfaces Data Manager package only can be used by professors and administrators, so there are two different interfaces. Both of them are linked form the administration page (/dotlrn/control-panel).
Professor Interface A professor is able to move, copy, delete, export and import objects. Move Provide a list of objects from which the professor has permissions. Provide a way to select objects from this list. Provide a list of communities or classes where the object will be moved. Provide a confirmation page. Copy Provide a list of objects from which the professor has permissions. Provide a way to select objects from this list. Provide a list of communities or classes where the object will be copied. Provide a confirmation page.no Delete Provide a list of objects from which the professor has permissions. Provide a way to select objects from this list. Provide a confirmation page. Export Provide a list of objects from which the professor has permissions. Provide a way to select objects from this list. Allow to choose the filename. Provide a confirmation page. Import Allow to select a XML local file. Provide a list of communities or classes where the object will be imported. Provide a confirmation page.
Administrator Interface All the requirements listed at , and the capability to recover data from the Trash. Recover Provide a list of objects stored in the Trash. Provide a way to select objects from this list. Provide a list of communities or classes where the object will be stored.. Provide a confirmation page.
Desing tips
Essentials User directory: /datamanager/ TCL procedures: /datamanager/tcl/datamanager-procs.tcl This document: /datamangar/www/doc/datamanager_spec.html
Introduccition Data Manager package aims to provide a centralized interface which allow users to move, copy, export and import objects. Main tips related with the aplication desing are exposed here.
API The API will be defined during the development phase.
Acceptance Test Regresion test will be implemented to check all the functionalities.
Future Improvements The first release is designed to work with forums, faqs, assessment, news, folders and user portlets. Next releases will implement the same features for all the objects in the platform.
Authors Please, mail suggestions or bug reports to Luis de la Fuente (lfuente@it.uc3m.es).
Revision History Document revision Action Taken Date(dd/mm/yyyy) Author 0.1 Creation 24/06/2005 Luis de la Fuente