ILIAS  Release_4_0_x_branch Revision 61816
 All Data Structures Namespaces Files Functions Variables Groups Pages
Public Member Functions | Data Fields | Private Member Functions
ilTestSession Class Reference
Modules/Test

Test session handler. More...

+ Collaboration diagram for ilTestSession:

Public Member Functions

 ilTestSession ($active_id="")
 ilTestSession constructor
 increaseTestPass ()
 saveToDb ()
 loadTestSession ($test_id, $user_id="", $anonymous_id="")
 getActiveId ()
 setUserId ($user_id)
 getUserId ()
 setTestId ($test_id)
 getTestId ()
 setAnonymousId ($anonymous_id)
 getAnonymousId ()
 setLastSequence ($lastsequence)
 getLastSequence ()
 setPass ($pass)
 getPass ()
 increasePass ()
 isSubmitted ()
 setSubmitted ()
 getSubmittedTimestamp ()
 setSubmittedTimestamp ()

Data Fields

 $active_id
 $user_id
 $anonymous_id
 $test_id
 $lastsequence
 $submitted
 $tstamp
 $submittedTimestamp

Private Member Functions

 loadFromDb ($active_id)
 Loads the session data for a given active id.

Detailed Description

Test session handler.

This class manages the test session for a participant

Author
Helmut Schottmüller helmu.nosp@m.t.sc.nosp@m.hottm.nosp@m.uell.nosp@m.er@ma.nosp@m.c.co.nosp@m.m
Version
Id:
class.ilTestSession.php 23080 2010-02-26 20:36:55Z hschottm

Definition at line 33 of file class.ilTestSession.php.

Member Function Documentation

ilTestSession::getActiveId ( )

Definition at line 282 of file class.ilTestSession.php.

References $active_id.

Referenced by increaseTestPass(), and saveToDb().

{
return $this->active_id;
}

+ Here is the caller graph for this function:

ilTestSession::getAnonymousId ( )

Definition at line 312 of file class.ilTestSession.php.

References $anonymous_id.

Referenced by increaseTestPass(), and saveToDb().

{
return $this->anonymous_id;
}

+ Here is the caller graph for this function:

ilTestSession::getLastSequence ( )

Definition at line 322 of file class.ilTestSession.php.

References $lastsequence.

Referenced by increaseTestPass(), and saveToDb().

{
return $this->lastsequence;
}

+ Here is the caller graph for this function:

ilTestSession::getPass ( )

Definition at line 332 of file class.ilTestSession.php.

References $pass.

Referenced by increaseTestPass(), and saveToDb().

{
return $this->pass;
}

+ Here is the caller graph for this function:

ilTestSession::getSubmittedTimestamp ( )

Definition at line 352 of file class.ilTestSession.php.

References $submittedTimestamp.

Referenced by increaseTestPass(), and saveToDb().

{
return $this->submittedTimestamp;
}

+ Here is the caller graph for this function:

ilTestSession::getTestId ( )

Definition at line 302 of file class.ilTestSession.php.

References $test_id.

Referenced by increaseTestPass(), and saveToDb().

{
return $this->test_id;
}

+ Here is the caller graph for this function:

ilTestSession::getUserId ( )

Definition at line 292 of file class.ilTestSession.php.

References $user_id.

Referenced by increaseTestPass(), and saveToDb().

{
return $this->user_id;
}

+ Here is the caller graph for this function:

ilTestSession::ilTestSession (   $active_id = "")

ilTestSession constructor

The constructor takes possible arguments an creates an instance of the ilTestSession object.

public

Definition at line 99 of file class.ilTestSession.php.

References $active_id, and loadFromDb().

{
$this->active_id = 0;
$this->user_id = 0;
$this->anonymous_id = 0;
$this->test_id = 0;
$this->lastsequence = 0;
$this->submitted = FALSE;
$this->submittedTimestamp = "";
$this->pass = 0;
$this->tstamp = 0;
if ($active_id > 0)
{
$this->loadFromDb($active_id);
}
}

+ Here is the call graph for this function:

ilTestSession::increasePass ( )

Definition at line 337 of file class.ilTestSession.php.

Referenced by increaseTestPass().

{
$this->pass += 1;
}

+ Here is the caller graph for this function:

ilTestSession::increaseTestPass ( )

Definition at line 116 of file class.ilTestSession.php.

References $anonymous_id, $ilDB, $ilLog, $submitted, getActiveId(), getAnonymousId(), getLastSequence(), getPass(), getSubmittedTimestamp(), getTestId(), getUserId(), increasePass(), isSubmitted(), and setLastSequence().

{
global $ilDB, $ilLog;
$this->increasePass();
$this->setLastSequence(0);
$submitted = ($this->isSubmitted()) ? 1 : 0;
// there has to be at least 10 seconds between new test passes (to ensure that noone double clicks the finish button and increases the test pass by more than 1)
if (time() > $this->tstamp + 10)
{
$this->tstamp = time();
if ($this->active_id > 0)
{
$affectedRows = $ilDB->manipulateF("UPDATE tst_active SET lastindex = %s, tries = %s, submitted = %s, submittimestamp = %s, tstamp = %s WHERE active_id = %s",
array('integer', 'integer', 'integer', 'timestamp', 'integer', 'integer'),
array(
$this->getLastSequence(),
$this->getPass(),
$submitted,
(strlen($this->getSubmittedTimestamp())) ? $this->getSubmittedTimestamp() : NULL,
time(),
$this->getActiveId()
)
);
}
else
{
$anonymous_id = ($this->getAnonymousId()) ? $this->getAnonymousId() : NULL;
$next_id = $ilDB->nextId('tst_active');
$affectedRows = $ilDB->manipulateF("INSERT INTO tst_active (active_id, user_fi, anonymous_id, test_fi, lastindex, tries, submitted, submittimestamp, tstamp) VALUES (%s, %s, %s, %s, %s, %s, %s, %s, %s)",
array('integer', 'integer', 'text', 'integer', 'integer', 'integer', 'integer', 'timestamp', 'integer'),
array(
$next_id,
$this->getUserId(),
$anonymous_id,
$this->getTestId(),
$this->getLastSequence(),
$this->getPass(),
$submitted,
(strlen($this->getSubmittedTimestamp())) ? $this->getSubmittedTimestamp() : NULL,
time()
)
);
$this->active_id = $next_id;
}
}
}

+ Here is the call graph for this function:

ilTestSession::isSubmitted ( )

Definition at line 342 of file class.ilTestSession.php.

References $submitted.

Referenced by increaseTestPass(), and saveToDb().

{
return $this->submitted;
}

+ Here is the caller graph for this function:

ilTestSession::loadFromDb (   $active_id)
private

Loads the session data for a given active id.

Parameters
integer$active_idThe database id of the test session private

Definition at line 260 of file class.ilTestSession.php.

References $active_id, $ilDB, $result, and $row.

Referenced by ilTestSession().

{
global $ilDB;
$result = $ilDB->queryF("SELECT * FROM tst_active WHERE active_id = %s",
array('integer'),
array($active_id)
);
if ($result->numRows())
{
$row = $ilDB->fetchAssoc($result);
$this->active_id = $row["active_id"];
$this->user_id = $row["user_fi"];
$this->anonymous_id = $row["anonymous_id"];
$this->test_id = $row["test_fi"];
$this->lastsequence = $row["lastindex"];
$this->pass = $row["tries"];
$this->submitted = ($row["submitted"]) ? TRUE : FALSE;
$this->submittedTimestamp = $row["submittimestamp"];
$this->tstamp = $row["tstamp"];
}
}

+ Here is the caller graph for this function:

ilTestSession::loadTestSession (   $test_id,
  $user_id = "",
  $anonymous_id = "" 
)

Definition at line 205 of file class.ilTestSession.php.

References $_SESSION, $anonymous_id, $ilDB, $result, $row, $test_id, and $user_id.

{
global $ilDB;
global $ilUser;
if (!$user_id)
{
$user_id = $ilUser->getId();
}
if (($_SESSION["AccountId"] == ANONYMOUS_USER_ID) && (strlen($_SESSION["tst_access_code"][$test_id])))
{
$result = $ilDB->queryF("SELECT * FROM tst_active WHERE user_fi = %s AND test_fi = %s AND anonymous_id = %s",
array('integer','integer','text'),
array($user_id, $test_id, $_SESSION["tst_access_code"][$test_id])
);
}
else if (strlen($anonymous_id))
{
$result = $ilDB->queryF("SELECT * FROM tst_active WHERE user_fi = %s AND test_fi = %s AND anonymous_id = %s",
array('integer','integer','text'),
array($user_id, $test_id, $anonymous_id)
);
}
else
{
if ($_SESSION["AccountId"] == ANONYMOUS_USER_ID)
{
return NULL;
}
$result = $ilDB->queryF("SELECT * FROM tst_active WHERE user_fi = %s AND test_fi = %s",
array('integer','integer'),
array($user_id, $test_id)
);
}
if ($result->numRows())
{
$row = $ilDB->fetchAssoc($result);
$this->active_id = $row["active_id"];
$this->user_id = $row["user_fi"];
$this->anonymous_id = $row["anonymous_id"];
$this->test_id = $row["test_fi"];
$this->lastsequence = $row["lastindex"];
$this->pass = $row["tries"];
$this->submitted = ($row["submitted"]) ? TRUE : FALSE;
$this->submittedTimestamp = $row["submittimestamp"];
$this->tstamp = $row["tstamp"];
}
}
ilTestSession::saveToDb ( )

Definition at line 164 of file class.ilTestSession.php.

References $anonymous_id, $ilDB, $ilLog, $submitted, getActiveId(), getAnonymousId(), getLastSequence(), getPass(), getSubmittedTimestamp(), getTestId(), getUserId(), and isSubmitted().

{
global $ilDB, $ilLog;
$submitted = ($this->isSubmitted()) ? 1 : 0;
if ($this->active_id > 0)
{
$affectedRows = $ilDB->manipulateF("UPDATE tst_active SET lastindex = %s, tries = %s, submitted = %s, submittimestamp = %s, tstamp = %s WHERE active_id = %s",
array('integer', 'integer', 'integer', 'timestamp', 'integer', 'integer'),
array(
$this->getLastSequence(),
$this->getPass(),
$submitted,
(strlen($this->getSubmittedTimestamp())) ? $this->getSubmittedTimestamp() : NULL,
time()-10,
$this->getActiveId()
)
);
}
else
{
$anonymous_id = ($this->getAnonymousId()) ? $this->getAnonymousId() : NULL;
$next_id = $ilDB->nextId('tst_active');
$affectedRows = $ilDB->manipulateF("INSERT INTO tst_active (active_id, user_fi, anonymous_id, test_fi, lastindex, tries, submitted, submittimestamp, tstamp) VALUES (%s, %s, %s, %s, %s, %s, %s, %s, %s)",
array('integer', 'integer', 'text', 'integer', 'integer', 'integer', 'integer', 'timestamp', 'integer'),
array(
$next_id,
$this->getUserId(),
$anonymous_id,
$this->getTestId(),
$this->getLastSequence(),
$this->getPass(),
$submitted,
(strlen($this->getSubmittedTimestamp())) ? $this->getSubmittedTimestamp() : NULL,
time()-10
)
);
$this->active_id = $next_id;
}
}

+ Here is the call graph for this function:

ilTestSession::setAnonymousId (   $anonymous_id)

Definition at line 307 of file class.ilTestSession.php.

References $anonymous_id.

{
$this->anonymous_id = $anonymous_id;
}
ilTestSession::setLastSequence (   $lastsequence)

Definition at line 317 of file class.ilTestSession.php.

References $lastsequence.

Referenced by increaseTestPass().

{
$this->lastsequence = $lastsequence;
}

+ Here is the caller graph for this function:

ilTestSession::setPass (   $pass)

Definition at line 327 of file class.ilTestSession.php.

References $pass.

{
$this->pass = $pass;
}
ilTestSession::setSubmitted ( )

Definition at line 347 of file class.ilTestSession.php.

{
$this->submitted = TRUE;
}
ilTestSession::setSubmittedTimestamp ( )

Definition at line 357 of file class.ilTestSession.php.

{
$this->submittedTimestamp = strftime("%Y-%m-%d %H:%M:%S");
}
ilTestSession::setTestId (   $test_id)

Definition at line 297 of file class.ilTestSession.php.

References $test_id.

{
$this->test_id = $test_id;
}
ilTestSession::setUserId (   $user_id)

Definition at line 287 of file class.ilTestSession.php.

References $user_id.

{
$this->user_id = $user_id;
}

Field Documentation

ilTestSession::$active_id

Definition at line 40 of file class.ilTestSession.php.

Referenced by getActiveId(), ilTestSession(), and loadFromDb().

ilTestSession::$anonymous_id

Definition at line 54 of file class.ilTestSession.php.

Referenced by getAnonymousId(), increaseTestPass(), loadTestSession(), saveToDb(), and setAnonymousId().

ilTestSession::$lastsequence

Definition at line 68 of file class.ilTestSession.php.

Referenced by getLastSequence(), and setLastSequence().

ilTestSession::$submitted

Definition at line 75 of file class.ilTestSession.php.

Referenced by increaseTestPass(), isSubmitted(), and saveToDb().

ilTestSession::$submittedTimestamp

Definition at line 89 of file class.ilTestSession.php.

Referenced by getSubmittedTimestamp().

ilTestSession::$test_id

Definition at line 61 of file class.ilTestSession.php.

Referenced by getTestId(), loadTestSession(), and setTestId().

ilTestSession::$tstamp

Definition at line 82 of file class.ilTestSession.php.

ilTestSession::$user_id

Definition at line 47 of file class.ilTestSession.php.

Referenced by getUserId(), loadTestSession(), and setUserId().

The documentation for this class was generated from the following file: