You are here: > Home > Support > ToolBook Knowledge Base

Knowledge Base

Printer Friendly
What happens when window is closed? How to change the behavior?
Article: P758

The information in this article applies to:

Product: ToolBook
Component: DHTML
Product version(s): ToolBook

QUESTION
When running a ToolBook DHTML course (SCORM or AICC) via a Learning Management System, what happens when the learner exits the course using the close button on the caption bar (the 'X' in the upper-left corner of the browser window)?

ToolBook 2004 SP1 and prior

This is treated as discard results. The same as if the learner clicked on an Exit (Discard Results) button from the Scoring and Tracking section of the catalog.

ToolBook 2004 SP2 and newer

This is treated as suspend. The same as if the learner clicked on an Exit (Suspend Lesson) button from the Scoring and Tracking section of the catalog.

How to change the default behavior

In ToolBook 2004 SP2 it is possible to change this exit behavior. It is not possible to change this behavior in ToolBook 2004 SP1 or earlier releases.

There are two ways to control the exit behavior:

  • Through a book property (effects one book)
  • Through an INI entry entry (effects all future books exported).

Changing One book (setting the book property):
ToolBook Instructor only: Create the following book property:

Property: ASYMI_ActionOnClose
Value:    <action>   NOTE: See possible settings below
Examples:
  • ASYMI_ActionOnClose of this book="complete"
  • ASYMI_ActionOnClose of this book="discard"
  • ASYMI_ActionOnClose of this book="suspend"




You can set this property by doing the following:


  1. Open your ToolBook file

  2. Go to Author level

  3. Open your Command Window from the VIEW menu

  4. In the Command Window type:
    ASYMI_ActionOnClose of this book=<action>

  5. Press the ENTER key

  6. Save your Book




Changing All books (creating the ini entry)
Create the following entry in the [WebExport] section of the product INI file. You can locate the product INI file here:




ToolBook 2004
C:\Program Files\SumTotal\Instructor 2004\instructor.ini


ToolBook 9
C:\Documents and Settings\<username>\Local Settings\Application Data\ToolBook\instructor90.ini


If the [WebExport] section does not already exist, add the section at the top of the INI file.


[WebExport]
ActionOnClose=<action>  NOTE: See possible settings below
Examples:


  • ActionOnClose=complete

  • 

    ActionOnClose=discard
    

  • 

    ActionOnClose=suspend


Possible settings (values of <action>)
The action taken when the course is exited (the value of the book property or ini entry), can be one of the following:


  • 

    complete
    It will mark the lesson as complete
      
    

  • 

    discard
    It will discard the test results (default setting prior to ToolBook 2004 SP2)
      
    

  • 

    suspend
    It will suspend the course (default setting as of ToolBook 2004 SP2) 

      

      

        

          OPENSCRIPT NOTICE

            The OpenScript programming examples found in many articles may need modification in order to work in ToolBook 9.0 or higher, particularly if the article was written for an older version of ToolBook. To learn more, click here.		
        

      

      

      

        

          

              Provide 
              Anonymous Feedback About This Article
          

          

            
              
              
              
              
              

                

                  
Are you interested in providing feedback to SumTotal about  this article?

                    

                      
Yes