History: Adding items to a tracker
Preview of version: 4
Step Three in: Four Steps to make Trackers
| Step | Details | Help Page |
| 1. Create the Tracker | Admin names the tracker, and assign overall parameters and permissions | Creating a Tracker |
| 2. Add fields to the Tracker | Admin defines the columns and type of information collected | Adding fields to a tracker |
| 3. Add items to the tracker | Users fill out the forms to create items in the tracker | YOU ARE HERE |
| 4. View or List the results | Use plugins to view a customized tracker output in a page | Viewing Tracker Results |
| 5. Assign Trackers to Groups | optional - trackers can also be used upon registration | Assigning Trackers to groups |
Once you have created the fields in trackers, you have defined what kind of data you want to collect - with items you are now collecting that data.
Creating the tracker and defining the fields are generally part of the configuration of a site, performed by the site admins - items, on the other hand are what you want the users (ok, who may also be the admins) to do. Therefore you may want to revisit how the assign permissions to groups settings are established, to ensure that the permissions create tracker items is given to the groups you intend to have using the tracker.
Once designed, the tracker can now be inserted into any wiki page (or article or blog?) using the PluginTracker. By default each tracker can be viewed at its own unique url, from the list trackers page. But if you want users to find it, better use the plugin.
Items can be inserted into a tracker either directly from the visualization of the tracker (tiki-view_tracker.php?trackerId=N), being N the identification number of the tracker (trackerId)
(image)
or from a Wiki page where PluginTracker has been included with appropriate syntax
(image)
Keep in mind that fields with an asterisk on their right hand side are compulsory.
(image)
This means that, if they are not filled, or they don't contain the proper data type (depending on how the tracker has been configured), when you want to insert the item in the tracker a message will appear showing which fields are missing to be properly completed, in order to submit your item to the tracker successfully.