History: Dynamic items list

            {syntax type="markdown"  editor="wysiwyg"} # Dynamic items list

## Basic documentation


Function: Dynamically updates a selection list based on linked data from another tracker. 
Usage: trackerId,filterFieldIdThere,filterFieldIdHere,listFieldIdThere,statusThere 
Description:

| trackerId | is the ID of the tracker to link with; |
|---|---|
| filterFieldIdThere | is the field you want to link with in that tracker; |
| filterFieldIdHere | is the field you want to link with in the current tracker; |
| listFieldIdThere | is the field ID you wish to pull the selection list from, based on the value selected in fiterFieldIdHere matching field(s) in filterFieldIdThere; |
| statusThere | restricts values appearing in the list to those coming from records in the other tracker that meet specified statuses of ~np~[o|p|c]~/np~ or in combination (op, opc); |

multiple options must appear in the order specified, separated by commas.

to be tested filterFieldHere can be an item link, a user selector, a group selector, a country selector, a dynamic list

## Tutorial


With Tiki's ((trackers)), you can create dynamic forms, in which field options change automatically, depending on other selections.

In this tutorial, you will create a dynamic tracker that users will complete to enter their operating system and version number. Depending on the operating system that they choose (Windows or Solaris), different version options will appear.

You will actually need to build two trackers: an "internal" tracker to hold the dynamic options, and an "external" tracker from which the user will make their selections.

### Step 1: Build the "internal" tracker for the selectable options

1. Create a new tracker. 
    In this example, since the selectable options are for an "operating system", we will name the tracker **Operating System**. 
    Record the ID number for this tracker. We'll refer to this tracker as the ***Option Tracker ID***. 
    In this example, the ID is **{HTML()}<span style="color:red">17</span>{HTML}**. 
    {img src="display2093" link="display2093" width="400" rel="box[g]" imalign="center" desc="Click to expand" align="center" styleimage="border"}
2. Create a field with the name **OS**, of type **drop down**, with the options **Windows,Solaris**. 
    Record the ID number for this field. We'll refer to this field as the ***Option Tracker Choices ID***. In this example, the ID is **{HTML()}<span style="color:purple">17</span>{HTML}**.
3. Create a field with the name **Version** of type **text** for this tracker. 
    Record the ID number for this field. We'll refer to this field as the ***Option Tracker Versions ID***. In this example, the ID is **{HTML()}<span style="color:green">18</span>{HTML}**. 
    {img src="display2092" link="display2092" width="400" rel="box[g]" imalign="center" desc="Click to expand" align="center" styleimage="border"}

### Step 2: Populate the "internal" tracker.

Now that you've built the tracker to hold the options, you need to populate the tracker with the valid choices.

1. From the Trackers listing page, click the **Option Tracker** tracker that you just created.
2. Click **Insert new Item**.
3. Populate the valid OS versions. 
    In the OS field, select **Windows**. 
    In the Version field, type **Vista**. 
    {img src="display2091" link="display2091" width="400" rel="box[g]" imalign="center" desc="Click to expand" align="center" styleimage="border"}
4. Repeat these steps to enter all of the valid combinations that to allow (for example: Windows XP, Solaris 2.9, and so on. 
    {img src="display2090" link="display2090" width="400" rel="box[g]" imalign="center" desc="Click to expand" align="center" styleimage="border"}

### Step 3: Create the "external" user tracker

Now you need to create the actual tracker the will contain the selectable options that you defined.

1. Create a new tracker. 
    In this example, we will name the tracker **User Profile**.
2. Create a field with the name **Operating System**, of type **item link** with the options: ***Option Tracker ID***,***Option Tracker Choices ID***
    You created these IDs in {ALINK(aname=Step_1_Build_the_quot_internal_quot_tracker_for_the_selectable_options)}Step 1{ALINK}. In this example, the options are: {HTML()}<span style="color:red">17</span>{HTML} , {HTML()}<span style="color:purple">17</span>{HTML}. 
    This is the selector from which the users will select their operating system (Windows or Solaris). 
    Record the ID number for this field. We'll refer to this field as the ***User OS Choices ID***. In this example, the ID is **{HTML()}<span style="color:orange">19</span>{HTML}**.
3. Create a field with the name **Version**, of type **dynamic items list**, with the options: ***Option Tracker ID***,***Option Tracker Choices ID***,***User OS Choices ID***,**Option Tracker Versions ID**
    In this example, the options are: {HTML()}<span style="color:red">17</span>{HTML} , {HTML()}<span style="color:purple">17</span>{HTML} , {HTML()}<span style="color:orange">19</span>{HTML} , {HTML()}<span style="color:green">18</span>{HTML} .
4. Create a field with the name **Your name**, of type **text**. 
    This will simply be a field for users to enter their names. 
    {img src="display2089" link="display2089" width="400" rel="box[g]" imalign="center" desc="Click to expand" align="center" styleimage="border"}

### Test the tracker

Now you can test the "user" tracker (named **User Profile** in this example).

1. From the Trackers listing page, click the **User Profile** tracker that you just created.
2. Click **Insert new Item**. 
    Notice that the **Version** field is empty.
3. In the **Operating System** field, select **Windows**. 
    Notice that the **Version** field is now populated with the Windows options (Vista, XP, and 95).
4. Change the **Operating System** field to **Solaris**. 
    Notice that the **Version** field is now populated with the Solaris options (2.9 and 2.10). 
    Refer from: 
    {mediaplayer type="video/mp4" style="native" width="640px" src="display2088"}

## Final notes

- [http://dev.tiki.org/tiki-view_tracker_item.php?itemId=3108&amp;trackerId=5&amp;show=view|Chained use of the dynamic list item type in trackers] does not work at the moment (Tiki5.0Beta1). Vote for the issue if you feel it is important.
- [http://doc.tiki.org/Category+Tracker+Field&amp;structure=Documentation|Categories] might be an alternative for you.

## See also

[PluginJQ#Conditional_display_of_fields|Plugin JQuery]

## Backlinks:

{BACKLINKS()}{BACKLINKS}

Alias names for this page: 
(alias(Dynamic items lists)) | (alias(Dynamic item lists)) | (alias(Dynamic item list)) | (alias(Dynamic_items_list))