This page uses sub-sections which are editable for users with editing permissions.
It will be easier to maintain this page if you use the edit links on the page below, rather than editing the page as a whole.

{composition-setup:home^composition}cloak.toggle.exclusive=true{composition-setup}

Gates


{sub-section:intro}{fontsize:18px}*Gates* allow teachers to create _Stop Points_ during a sequence. \\ These Stop points halt the progress of learners through a sequence, until certain outcomes have been achieved.{fontsize}

There are several types of gates:
* *Permission Gates* require a monitoring teacher to manually open the gate before Learners can pass through.
* *Synchronise Gates* require all learners actively participating in the sequence to reach the gate before it opens.
* *Schedule Gates* open at a specified date and time. Since LAMS 2.1, Schedule Gates can be opened ahead of schedule. [Click here to see how (Animation).|Open a Schedule Gate]
* (*y) *NEW Condition Gates* allow a gate to open based on the outputs of a previous activity. Currently, [these activities|http://wiki.lamsfoundation.org/label/lamsdocs/outputs] provide output conditions.
{sub-section}


Click the Headings Below to view instructions for using Gates in sequences.

{toggle-cloak:id=creating}

Creating Gates in the Authoring Environment (Click to expand this section.)

{cloak:id=creating}

{sub-section:1}{quote}h3. Creating Gates

You can create Gates in one of two ways:
* Add a Gate to a *Transition Line*
** Create a transition line between two activities.
** Double-click the transition line to bring up a prompt where you can select a type of Gate.
* From the *Flow* Menu
** Click the *Flow* Menu, then select *Gate.*
** Click on the Authoring Space to place the Gate in the sequence.
** Create transition lines to and from the Gate.

Gates do *{_}not{_}* have Properties pages, as all options can be changed by using the [Properties Inspector|authoring#propinspector].
{quote}{sub-section}

{cloak}

Authoring and Monitoring Gates

{toggle-cloak:id=permission}

Permission Gates

{cloak:id=permission}

{sub-section:2}{quote}
h4. Authoring Permission Gates

Permission gates have no additional features in the authoring environment. \\ All configuration is performed through the Monitoring environment while the sequence is running.

h4. Monitoring Permission Gates

Whenever a sequence contains a Monitoring gate, a user with Monitoring permissions for that sequence must log in to LAMS and allow learners to pass through the gate.
Any permission gates in a sequence are listed on the Lesson Monitoring tab under Required tasks.

{section}{column:width=22}
!lagat11monitoring^gatePermission.PNG|thumbnail! \\ *_'Go' buttons on the 'Lesson' tab._*
{column}{column}
The lesson monitoring tab displays the status of any permission gates in the sequence.  This allows monitors to quickly open a gate for learners, without having to locate the stop point on the sequence view.

If a sequence contains one or more *Permission Gates*, a _'Go'_ button appears for each gate on the [_Lesson tab_|monitoringlesson] tab, under the heading _Required Tasks._ See the figure opposite.
{column}{section}

{section}{column:width=22}
!lagat11monitoring^gateSeqPer.PNG|thumbnail! \\ *{_}Annotated view of a Permission gate Summary screen._*
{column}{column}
If a *Permission Gate* is double-clicked on the [_Sequence tab_|monitoringsequence], a Summary sheet appears, displaying the number of Learners who are currently waiting at the gate position (ie: have reached the position of the gate in the sequence), as well as a _'Open Gate'_ command button. This has the same function as the _'Go'_ button on the [_Lesson tab_|monitoringlesson].

Monitors can choose to open the gate for *All* learners in the class, or select individual learners who are allowed to pass the gate.

{column}{section}
{quote}
{sub-section}

{cloak}

{toggle-cloak:id=sync}

Synchronise Gates

{cloak:id=sync}

{sub-section:3}{quote}
h4. Authoring Sync Gates
Permission gates have no additional features in the authoring environment.
All configuration is performed through the Monitoring environment while the sequence is running.
h4. Monitoring Sync Gates
When a *Sync Gate* is double-clicked on the [_Sequence tab_|monitoringsequence], a summary sheet opens displaying the number of Learners waiting for the gate to open (ie: have reached the position of the gate in the sequence) alongside a graphic showing the current state of the gate, either open or closed.
{tip}Sync gates can now be manually opened from the Sequence Monitoring tab, by double-clicking the gate icon and clicking *Open.*  This will apply even if all learners have not yet reached the gate. {tip}

From LAMS version 2.1 and onwards, the behaviour for Sync Gates has now changed ([LDEV-1773@bugs])
* The Schedule gate will now distinguish between learners who are *assigned* to the lesson, and learners who are *active* in the lesson.  This means that if there are learners who have not yet started the sequence, the gate will open for the active learners, rather than waiting for the late learners to join.
* Also, a Sync gate now requires *at least two learners* to be waiting before it opens. This means a Sync gate in a lesson available to only 1 learner will need a monitor to manually open the gate for them; but then again, a sync gate in a lesson for 1 doesn't make sense.
{quote}{sub-section}

{cloak}

{toggle-cloak:id=sched}

Schedule Gates

{cloak:id=sched}

{sub-section:4}{quote}
h4. Authoring Schedule Gates
Schedule gates require the author to specify an amount of time that the gate will remain closed for, after the sequence is started. \\ Gate opening times are specified in the [Properties Inspector].
For example, if the gate is to open 3 hours after the sequence starts, the author should select 3 hours as the opening time.


h4. Monitoring Schedule Gates
When a Schedule Gate is double-clicked on the Sequence tab, a summary screen identical to the ones described above is shown, with the addition of the timestamp for when the gate will open.
Remember that Schedule gates open based on the time elapsed since the sequence was started, either directly or through the monitoring environment.

Monitors can manually open Schedule gates ahead of time, by double-clicking the stop icon on the Sequence Monitoring tab, and clicking *Open*.
{quote}{sub-section}

{cloak}

{toggle-cloak:id=condition}

Condition Gates

{cloak:id=condition}

{sub-section:5}{quote}
h4. Authoring Condition Gates
Condition gates are special in that they require another tool to provide outputs for the gate to open.  This means that gates can open or close based on the number of questions a learner correctly answered in a [Multiple choice activity|lamc11] or how many contributions they made to a [Forum|lafrum11].

When a condition gate is placed, authors must first select which activity will provide the outputs (LAMS automatically populates the input list with available tools), choose the conditions set to use for the gate, and then map the conditions to whether or not the gate is open or closed.

(For more information on the conditions created by each activity, view that activity's help page by clicking the (?) icon in LAMS.)








h4. Monitoring Condition Gates
Monitoring condition gates is completely automatic, but monitors can choose to open the gate summary page by double-clicking the gate icon on the Sequence Monitoring tab.  \\ This will allow them to view the learners who are waiting for the gate to open as well as learners who have not met the conditions for the gate to open.  \\ Monitors can manually open the gate for the entire class, or allow specific learners through the gate, bypassing the conditions check.

{quote}{sub-section}

{cloak}