Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

Anchor
Introduction
Introduction

Introduction

OpenSyllabus offers the possibility to integrate different Sakai tools by providing a minimum interface and a link. The interface allows creating or modifying references to the tool and the link gives access to the tool. We have already done an integration with Assignment tool and we are working on Citations ListOne of the major functionalities in OpenSyllabus is its ability to reference entities of other Sakai tool. The user can contextualize and reference other existing tools entities in Sakai.Two different level of integration are available in OpenSyllabus. We will describe each integration and the tools they apply to.

Integrated tools

1- Citation and Resources: SDATA

Citations and Resources are integrated using Sdata. This integration goes further than a basic integration because not only we are able to reference documents and citations created from resources but we are also able to make some minor modifications to these entities from OpenSyllabus.

For a user who has a lots of citations and documents to reference in his syllabus the switch between each tool is reduced to a minimum.

Anchor
Philosophy
Philosophy

Philosophy

The principles underlying the integration of the Sakai's tool are as followsfollow two guidelines.

  1. Choose bare minimal functionalities necessary to develop the tool on the client side.
    Since each Sakai's tool comes with a complete user-interface, we won't reinvent the wheel. We choose the minimal parameters that will be used to implement the tool on the client side of OpenSyllabus based on the essential needs of a course outline. This way we make sure that we have a better control of the synchronization process, we are not reimplementing the tool and we are using it to our best interest.
  2. OpenSyllabus minimal user-interface we will offer the possibility to:
    1. Create a new reference to the Sakai tool and link it to the course outline
    2. Link an existing reference of the the tool to the course outline
    3. Directly modify one of minimal functionnalities functionalities defined or access th tool to modifiy modify other parameters
    4. Access the tool remove a reference

Anchor
Synchronization
Synchronization

Synchronization

When it comes to integration, synchonization is always a big issue, for openSyllabusOpenSyllabus, in order to insure the integrity of the data, most of the modifications are left to the original tool or automatic. From the OpenSyllabus client-side, we create a new  reference to the tool or modify the minimal parameters defined, for the deletion or the big modifications, we refer the user to the tool user interface. Also, each time we open, close or save a course outline, a process of synchronization is launched. For each reference to a Sakai tool (resources, assignment, citation ...) we check if the reference still exists:

  • If yes, we do nothing
  • If no, we send a warning to the user telling him about the reference. We also point the invalid reference to a static bogus reference in the database so that the course outline won't  raise an exception

...

Limits

...

Sakai's Assignement Tool Integration

Following our integration procedure the minimal fonctionalities appearing in the user-interface in the client side are:

  1. Title
  2. Short description
  3. Open Date
  4. Close Date
  5. Notification
  6. Join files to an assignment that will come later

The creation, deletion, modification and synchronisation follow the same ones as mentioned above.

For the files added to assignment, we will follow the same rules as the actual assignment tool, files will be managed by superusers.

For now the user controls the entities and their references in the syllabus

Anchor
Limits
Limits