Note: This documentation is for Moodle 2.7. For up-to-date documentation see Dataform setup.

Dataform setup: Difference between revisions

From MoodleDocs
No edit summary
 
(50 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Dataform}}
{{Dataform}}
==Adding a dataform==
==Settings==
[[Image:Database_1.gif|thumb|Give your database a name and a description]]
* [[Dataform activity settings|Activity settings]]
To add a dataform activity:
# Click the "Turn editing on" button at the top right of the course homepage.
# Select Dataform from the "Add an activity" dropdown menu.
# On the Adding a new dataform page give your new dataform a name and optionally a description.
# Select the general options (see below) and the common module settings.
# Click the "Save and display" button at the bottom of the page.
# Apply a package ([[Dataform packages|packages]]) or add fields ([[Dataform fields|fields]]) and views ([[Database views|views]]).
# Add entries.


==General options==
==Presets==
Image
[[Image:preset.png|frame|500px|right|The Dataform preset tab]]<br clear="left" />
===Available from===
Dataform presets are predefined Dataform instances that can be use to create new Dataform instances with the same structure and data (if included) in the same course, in other courses in the site, or in other sites. Dataform presets are created from within a Dataform instance and applied to a new instance from within the new instance.  
The time from which participants may enter the activity.


===Due===
===Make a preset===
The due date (and time) participants are expected to complete the requirements of the activity.
Once you have your Dataform activity set up with or without user content, you can make a preset of it. The preset can be created in one of the following ways:
*'''Without user data''' - Only the Dataform structure - fields, views, filters, etc. - are included in the preset.
*'''With user data''' - Dataforom structure and all entries and their content are included with user information.
*'''With user data anonymized''' - Similar to 'With user data' but user information is anonymized.
The newly created/uploaded preset will be displayed in the list of course presets on the page.


With this setting, the dataform remains accessible after the specified time, but the entry 'time modified' will be highlighted if later than the specified time.
===Upload preset from file===
You can upload a single preset (.mbz file) or a zip archive of more than one preset from your desktop. The presets will be added to the course presets list from which they can be applied or shared.


===Presets list===
The presets list is divided to course and site presets. Presets are added to the course list from which they can be shared to the site list. Course  presets are visible only within the course to the course managers. Site presets are available to users with capability viewallpresets.


===Apply a preset===
You can apply any presets in the list to the current Dataform instance. To apply a preset to a new instance simply create the new instance, go to its Presets tab and click on the apply button of the desired presets in the list. 


===Download presets===
Presets can be downloaded as mbz (moodle backup zip) archives. You can also download several presets in one go by ticking the checkboxes of the desired presets and clicking the download button in the list header. The mbz archives of the selected presets will be archived and downloaded in one zip file.


===Required entries===
===Share presets===
The number of entries each student is required to enter before the database activity can be considered complete. The student will see a reminder message if s/he has not submitted the required number of entries.
You can click the share button of a preset to make it available throughout the site. Use the checkboxes and share button in the list header to share more than one preset in one go.


===Entries required before viewing===
===Delete presets===
The number of entries the student needs to submit before s/he can see entries by other students. If the student has not submitted the required number of entries, s/he will only see the entry page and not the list or single view pages.
You can click the delete button of a preset to delete the preset. Use the checkboxes and delete button in the list header to delete more than one preset in one go.


''Note'': If entries are required before viewing, the database auto-linking filter should be disabled. This is because the database auto-linking filter can't determine whether a user has submitted the required number of entries.
==Fields==
Each entry in a dataform activity consists of a set of information elements of one or more types depending on the nature of the activity. These information elements are called fields and they are the means for adding and viewing content in the activity.


===Maximum entries===
[[Dataform fields]]
The maximum number of entries the student can submit before s/he is blocked. This prevents people from spamming the system, either in the hope that one entry is good enough or, on a public site, as a way of advertising.


===Comments===
[[Dataform: Field tags]]
Enables commenting on entries. The comments field appears on the single view template when this is enabled.


===Require approval?===
Allows you to require each entry to be approved by someone with the appropriate role before other users can view it.


===RSS articles===
==Views==
Enables you to publish an RSS feed of entries in the dataform. The option here sets the number of entries available in the feed.
[[Image:dataformviews.png|frame|right|Dataform views]]<br clear="left" />
Dataform views allow you to control the way information is presented in the Dataform activity. In order for a Dataform activity to be active, a default view must be defined. By default, there is no limit to the number of views you can apply to a single Dataform activity (although your administrator can limit the max number of views).  


''Note'': RSS feeds need to be enabled by your system administrator.


===Allow posts to be rated?===
Lets you allow posts to be rated, which will enter a score in the gradebook for the student’s submissions in the database. The grade is set using the dropdown menu below this option.


==Common module settings==
See [[Common module settings]] for more information.  Essentially you can set how different [[Groups]] in the course see or interact with each other and set an ID for grading purposes in this area.


==Site administration settings==
===Add a view===
'''Editon'''<br />
'''Extended Matrix'''<br/>
'''Import'''<br/>
'''Interval'''<br/>
'''Matrix'''<br/>
'''Tabular'''<br/>


The dataform has additional settings which may be changed by an administrator in ''Settings > Site administration > Plugins > Activity modules > Dataform''.
===View settings===


===Enabling RSS feeds===
Visible <br/>
D <br/>
E <br/>
M <br/>
Filter <br/>
Edit <br/>
Duplicate <br/>
Reset <br/>


RSS feeds must first be enabled in ''Settings > Site administration > Server > [[RSS]]''.
==Filters==


==See also ==
==Import==
 
==Export==
 
==RSS==
 
==Javascript==
 
==CSS==
 
==Backup/restore==
 
==Notifications==
 
==Permissions==
* [[Dataform permissions]]
* [[Dataform permissions]]

Latest revision as of 22:31, 30 September 2012

Settings

Presets

The Dataform preset tab


Dataform presets are predefined Dataform instances that can be use to create new Dataform instances with the same structure and data (if included) in the same course, in other courses in the site, or in other sites. Dataform presets are created from within a Dataform instance and applied to a new instance from within the new instance.

Make a preset

Once you have your Dataform activity set up with or without user content, you can make a preset of it. The preset can be created in one of the following ways:

  • Without user data - Only the Dataform structure - fields, views, filters, etc. - are included in the preset.
  • With user data - Dataforom structure and all entries and their content are included with user information.
  • With user data anonymized - Similar to 'With user data' but user information is anonymized.

The newly created/uploaded preset will be displayed in the list of course presets on the page.

Upload preset from file

You can upload a single preset (.mbz file) or a zip archive of more than one preset from your desktop. The presets will be added to the course presets list from which they can be applied or shared.

Presets list

The presets list is divided to course and site presets. Presets are added to the course list from which they can be shared to the site list. Course presets are visible only within the course to the course managers. Site presets are available to users with capability viewallpresets.

Apply a preset

You can apply any presets in the list to the current Dataform instance. To apply a preset to a new instance simply create the new instance, go to its Presets tab and click on the apply button of the desired presets in the list.

Download presets

Presets can be downloaded as mbz (moodle backup zip) archives. You can also download several presets in one go by ticking the checkboxes of the desired presets and clicking the download button in the list header. The mbz archives of the selected presets will be archived and downloaded in one zip file.

Share presets

You can click the share button of a preset to make it available throughout the site. Use the checkboxes and share button in the list header to share more than one preset in one go.

Delete presets

You can click the delete button of a preset to delete the preset. Use the checkboxes and delete button in the list header to delete more than one preset in one go.

Fields

Each entry in a dataform activity consists of a set of information elements of one or more types depending on the nature of the activity. These information elements are called fields and they are the means for adding and viewing content in the activity.

Dataform fields

Dataform: Field tags


Views

Dataform views


Dataform views allow you to control the way information is presented in the Dataform activity. In order for a Dataform activity to be active, a default view must be defined. By default, there is no limit to the number of views you can apply to a single Dataform activity (although your administrator can limit the max number of views).



Add a view

Editon
Extended Matrix
Import
Interval
Matrix
Tabular

View settings

Visible
D
E
M
Filter
Edit
Duplicate
Reset

Filters

Import

Export

RSS

Javascript

CSS

Backup/restore

Notifications

Permissions