Note:

If you want to create a new page for developers, you should create it on the Moodle Developer Resource site.

Repository Administration Specification: Difference between revisions

From MoodleDocs
 
(30 intermediate revisions by the same user not shown)
Line 6: Line 6:


'''Status:'''  
'''Status:'''  
:not implemented
:not implemented ([http://tracker.moodle.org/browse/MDL-15402 Tracker Issue])


'''Related Documents:'''
'''Related Documents:'''
*[Development:Repository API]
*[[Repository API| Repository API]]
 
*[[Repository_Plugins| Repository Plugins]]
 
*[[Repository_Interface_for_Moodle/Course/User| Repository Interface for Moodle/Course/User]]
*[[QA:Use Case Number Attribution| Use Case Number Attribution]]
<br />
==Introduction==
==Introduction==
This document is about functional specification for Repository Administration
This document is about functional specification for Repository Administration<br />
Note: parts of this document about "settings a repository" (UC001-3) are generic to all plugins. Please see the [[Repository_Plugins| Repository Plugins]] wiki page for specific plugin specification.


==Requirements==
==Requirements==
* be able to enable/disable a repository
* be able to enable/disable a repository
* be able to order a repository (it will change the way repositories are displayed in the file picker)
* be able to setup a repository
* be able to setup a repository


=== Enable a repository ===
==User Interface==
We want something similar to Admin > Modules > Filters > Manage Filters (Admin > Modules > Repositories > Manage Repositories). Below an example:


=== Setting up a repository ===
[[Image:Admin repository.jpg]]


==User Interface==
*The list is automatically generated. The list displays all repository plugin located in the moodle/repository/plugins folder
We want something similar to Admin > Modules > Filters > Manage Filters
*Enable/Disable operation is available for all plugin
*Order operation is available for all plugin
*Settings operation is not mandatory. This operation is available when the plugin package come with a settings.php file. All these plugin settings page should also be available from some Administration menu entries: Admin > Modules > Repositories > "Repository Name"


=== Settings operation ===
When user selects Settings operation for a repository, the system display a new page with a new form.<br />
Settings options can be different for each module:
* allow the user to "Remember password"
* URL to the repository
* Rename the repository (affect only the name displayed in Moodle)


==Use Cases==
==Use Cases==
===UCXXX-1 Enable a repository===
===UC001-1 Enable/Disable a repository===
====Base scenario====
====Base scenario====
#User goes to the Repository Administration page
#User goes to the Repository Administration page
#User select Enable repository operation
#User select Enable/Disable repository operation
#System displays the repository as Enable
#System displays the repository as Enable/Disable


====Pre conditions====
====Pre conditions====
:- the user has Admin permission in Moodle
:- the user has Admin permission in Moodle
:- the repository is disable
:- the repository is Disable/Enable


====Post conditions====
====Post conditions====
:- the repository is available
:- the repository is available/not available


===UCXXX-2 Disable a repository===
===UC001-2 Order a repository===
===UCXXX-3 Setup a repository===
====Base scenario====
#User goes to the Repository Administration page
#User select Move operation for a repository
#System displays the new ordered repository list
 
====Pre conditions====
:- the user has Admin permission in Moodle
:- their is at least two repository in the list
 
====Post conditions====
:- the repository has been moved one step up or down in the file picker repository list.
 
===UC001-3 Setup a repository===
====Base scenario====
#User goes to the Repository Administration page
#User selects Settings operation for a repository
#System displays Settings page
#User fills the settings form
#User selects save operation
#System displays a save successfull message
 
====Pre conditions====
:- the user has Admin permission in Moodle
:- the repository has been installed and has settings available

Latest revision as of 09:09, 27 June 2008

Functional Specification Revisions:

0.1 - 26/06/2008 - Jerome Mouneyrac - Draft Version

Audience:

Moodle Administrator/Developer/QA tester

Status:

not implemented (Tracker Issue)

Related Documents:


Introduction

This document is about functional specification for Repository Administration
Note: parts of this document about "settings a repository" (UC001-3) are generic to all plugins. Please see the Repository Plugins wiki page for specific plugin specification.

Requirements

  • be able to enable/disable a repository
  • be able to order a repository (it will change the way repositories are displayed in the file picker)
  • be able to setup a repository

User Interface

We want something similar to Admin > Modules > Filters > Manage Filters (Admin > Modules > Repositories > Manage Repositories). Below an example:

Admin repository.jpg

  • The list is automatically generated. The list displays all repository plugin located in the moodle/repository/plugins folder
  • Enable/Disable operation is available for all plugin
  • Order operation is available for all plugin
  • Settings operation is not mandatory. This operation is available when the plugin package come with a settings.php file. All these plugin settings page should also be available from some Administration menu entries: Admin > Modules > Repositories > "Repository Name"

Settings operation

When user selects Settings operation for a repository, the system display a new page with a new form.
Settings options can be different for each module:

  • allow the user to "Remember password"
  • URL to the repository
  • Rename the repository (affect only the name displayed in Moodle)

Use Cases

UC001-1 Enable/Disable a repository

Base scenario

  1. User goes to the Repository Administration page
  2. User select Enable/Disable repository operation
  3. System displays the repository as Enable/Disable

Pre conditions

- the user has Admin permission in Moodle
- the repository is Disable/Enable

Post conditions

- the repository is available/not available

UC001-2 Order a repository

Base scenario

  1. User goes to the Repository Administration page
  2. User select Move operation for a repository
  3. System displays the new ordered repository list

Pre conditions

- the user has Admin permission in Moodle
- their is at least two repository in the list

Post conditions

- the repository has been moved one step up or down in the file picker repository list.

UC001-3 Setup a repository

Base scenario

  1. User goes to the Repository Administration page
  2. User selects Settings operation for a repository
  3. System displays Settings page
  4. User fills the settings form
  5. User selects save operation
  6. System displays a save successfull message

Pre conditions

- the user has Admin permission in Moodle
- the repository has been installed and has settings available