#!/usr/bin/perl
#
# Source File: likert.pl
#
# Get config
require 'sitecfg.pl';
require 'testlib.pl';
require 'tstatlib.pl';
require 'questionslib.pl';
require 'LikertData.pl';
my $last_index, $HBI_Debug ;
$HBI_Debug = 0 ; # Controls output of Debugging Data.
$FORM{'frm'}="";
if ($HBI_Debug) {warn "Likert.pl running" ;}
&app_initialize;
if ($FORM{'cbexport'} eq 'xport') {
print "Content-Disposition: attachment;filename=report.txt\n\n";
$bDisplay = 0;
} else {
print "Content-Type: text/html\n\n";
$bDisplay = 1;
}
# LIKERT Scale Test Reports by Candidate
if ($HBI_Debug) {warn "Likert.pl running" ;}
if (&get_session($FORM{'tid'})) {
&LanguageSupportInit();
if ($HBI_Debug) {warn "Likert.pl running" ;}
$REPORT{'rptid'}="";
@rptdefs = &get_data("reports.$SESSION{'clid'}");
@lbls = split(/&/, $rptdefs[0]);
foreach $rptdef (@rptdefs) {
chomp ($rptdef);
@flds = split(/&/, $rptdef);
if ($flds[0] eq $FORM{'rptno'}) {
for $i (0 .. $#lbls) {
$REPORT{$lbls[$i]} = $flds[$i];
$i++;
}
}
}
if ($FORM{'frm'} == '1') {
if ($HBI_Debug) {warn "Likert.pl running" ;}
&show_index_candidates;
} else {
if ($FORM{'frm'} == '2') {
if ($HBI_Debug) {warn "Likert.pl running" ;}
&show_index_tests;
} else {
if ($HBI_Debug) {warn "Likert.pl running" ;}
if ($FORM{'frm'} == '3') {
if ($HBI_Debug) {warn "Likert.pl running" ;}
&show_detail;
} else {
if ($HBI_Debug) {warn "Likert.pl running" ;}
if ($FORM{'frm'} == '4') {
if ($HBI_Debug) {warn "Likert.pl running" ;}
&show_filter_options;
} else {
if ($HBI_Debug) {warn "Likert.pl running" ;}
print "\n";
print "
\n";
print "
\n";
print "\n";
}
}
}
}
}
sub show_index_candidates {
&log_entry($SESSION{'clid'}, $SESSION{'uid'}, "2", "Exec Report $FORM{'rptno'}");
&get_client_profile($SESSION{'clid'});
print "
$REPORT{'rptid'} - $REPORT{'rptdesc'}
";
}
sub show_index_tests {
&log_entry($SESSION{'clid'}, $SESSION{'uid'}, "2", "Exec Report $FORM{'rptno'}");
&get_client_profile($SESSION{'clid'});
&get_candidate_profile( $SESSION{'clid'}, $FORM{'cndid'});
my $style = "SELECT {\"width: 200px;height: 200px;font-size: 8pt;\"}";
print "
$REPORT{'rptid'} - $REPORT{'rptdesc'}
";
&log_entry($SESSION{'clid'}, $SESSION{'uid'}, "3", "Exec Report $FORM{'rptno'} completed");
}
sub show_filter_options {
my $cndid;
my $cndname;
my @testdates;
my $iopt;
my $optval;
my $optdesc;
my $lstdates;
my $qcor;
my $qinc;
my $tscore;
my $trash;
my $j;
my $i;
my @tests;
my @tmpdates;
my $jscript;
my $colspan;
&log_entry($SESSION{'clid'}, $SESSION{'uid'}, "2", "Report Options $FORM{'rptno'}");
&get_client_profile($SESSION{'clid'});
&get_candidate_profile( $SESSION{'clid'}, $FORM{'cndid'});
@tests = split(/\,/,$FORM{'tstid'});
$cndname = join('', $CANDIDATE{'nml'}, ", ", $CANDIDATE{'nmf'}, " ", $CANDIDATE{'nmm'});
$cndid = $CANDIDATE{'uid'};
$lstdates = "\n");
$styles = "SELECT {\"font-size: 8pt;\"}\n";
$styles = join('',$styles,"INPUT {\"font-size: 8pt;height: 20px;\"}\n");
print "
$REPORT{'rptid'} - $REPORT{'rptdesc'}
";
}
sub show_detail {
my @tentries;
my @tcols;
my $i;
my $j;
my $k;
my $loidx;
my $hiidx;
my $loscore;
my $hiscore;
my $avgscore;
my $avgcount;
my @testdates;
my @found;
my $sgrepfor;
my $bDisplay;
my $timetaken;
my $testtitle;
my $tstdate;
my $testid;
my @tmparray;
my @tmpdates;
print "
$REPORT{'rptid'} - Likert Report - $REPORT{'rptdesc'}
" ;
&log_entry($SESSION{'clid'}, $SESSION{'uid'}, "2", "Exec Report $FORM{'rptno'}");
&get_client_profile($SESSION{'clid'});
# populates the Assoc. array %CLIENT with data for the client id.
&get_candidate_profile( $SESSION{'clid'}, $FORM{'cndid'});
# populates the Assoc. array %CANDIDATE with data for the candidate/user/student who took the test/survey.
# HBI - Go find the format of the test results.
if ($FORM{'multiple'} ne '1') {
&get_test_profile($CLIENT{'clid'}, $FORM{'tstid'});
# populates the Assoc. array %TEST with the characteristics of the test (but not the questions or answers).
$foo = get_test_sequence_for_reports($CLIENT{'clid'},$FORM{'cndid'}, $FORM{'tstid'});
# populates the Assoc. arrays %TEST_SESSION, %SUBTEST_QUESTIONS, %SUBTEST_ANSWERS, %SUBTEST_RESPONSES,
# and %SUBTEST_SUMMARY.
my $QUESTIONS_AH = get_question_definitions ($CLIENT{'clid'}, $FORM{'tstid'});
# Populates an array of hashs that contains all of the questions and the answers.
# $QUESTIONS_AH is a reference to the arrays of hashs.
if ($HBI_Debug) {
print "\ \n" ;
print "\ \ CLIENT HASH ARRAY\ \n" ;
foreach $key (sort keys (%CLIENT)) {
print "KEY $key VAL $CLIENT{$key}\ \n" ;
}
print "\ \ SESSION HASH ARRAY\ \n" ;
foreach $key (sort keys (%SESSION)) {
print "KEY $key VAL $SESSION{$key}\ \n" ;
}
print "\ \ FORM HASH ARRAY\ \n" ;
foreach $key (sort keys (%FORM)) {
print "KEY $key VAL $FORM{$key}\ \n" ;
}
print "\ \ CANDIDATE HASH ARRAY\ \n" ;
foreach $key (sort keys (%CANDIDATE)) {
print "KEY $key VAL $CANDIDATE{$key}\ \n" ;
}
print "\ \ TEST HASH ARRAY\ \n" ;
foreach $key (sort keys (%TEST)) {
print "KEY $key VAL $TEST{$key}\ \n" ;
}
print "\ \ TEST_SESSION HASH ARRAY\ \n" ;
foreach $key (sort keys (%TEST_SESSION)) {
print "KEY $key VAL $TEST_SESSION{$key}\ \n" ;
}
print "\ \ SUBTEST_QUESTIONS HASH ARRAY\ \n" ;
foreach $key (sort keys (%SUBTEST_QUESTIONS)) {
print "KEY $key VAL $SUBTEST_QUESTIONS{$key}\ \n" ;
}
print "\ \ SUBTEST_ANSWERS HASH ARRAY\ \n" ;
foreach $key (sort keys (%SUBTEST_ANSWERS)) {
print "KEY $key VAL $SUBTEST_ANSWERS{$key}\ \n" ;
}
print "\ \ SUBTEST_RESPONSES HASH ARRAY\ \n" ;
foreach $key (sort keys (%SUBTEST_RESPONSES)) {
print "KEY $key VAL $SUBTEST_RESPONSES{$key}\ \n" ;
}
print "\ \ SUBTEST_SUMMARY HASH ARRAY\ \n" ;
foreach $key (sort keys (%SUBTEST_SUMMARY)) {
print "KEY $key VAL $SUBTEST_SUMMARY{$key}\ \n" ;
}
} # end of if $HBI_Debug
$last_index = $#{$QUESTIONS_AH} ; # Last index of the Array of Hashs of the Q&A.
if ($HBI_Debug) {
if ($last_index == -1) {
print "\ \n" ;
print "\ \ QUESTIONS_AH HASH ARRAY is empty.\ \n" ;
print "\ \n" ;
} else {
foreach $index (0 .. $last_index) {
print "\ \n" ; # HBI
print "\ \ QUESTIONS_AH HASH ARRAY Element $index \ \n" ;
foreach $key (sort keys (%{${$QUESTIONS_AH}[$index]})) {
print "KEY $key VAL " ;
print "${$QUESTIONS_AH}[$index]->{$key}" ;
print "\ \n" ;
} # end foreach $key
} # end foreach $index
} # end of if $last_index
} # end of if $HBI_Debug
my %supercat_total = () ; # Total points available for a category.
my %supercat_earned = () ; # Points earned for a category.
# The following values have a similar name, and are logically connected.
my $SUPERCAT_TOTAL = 0 ; # Total points available in all categories.
my $SUPERCAT_EARNED = 0 ; # Total points earned in all categories.
$last_index = $#{$QUESTIONS_AH} ; # Last index of the Array of Hashs of the Q&A.
my $points, $weight, @scores, @correct_ans, @incorrect_ans, @all_ans ;
my $ques_type, $supercat, $scores, @responses, $responses ;
my @individ, $individ, @img_labels, @img_data ;
$responses = $SUBTEST_RESPONSES{2} ;
@responses = split (/\&/, $responses) ;
shift @responses ; # Drop the empty element in front of the list.
if ($last_index == -1) {
print "\ \n" ;
print "\ \ No Questions in the test.\ \n" ;
print "\ \n" ;
} else {
foreach $index1 (0 .. $last_index) {
# Get the data for a single question.
$points = ${$QUESTIONS_AH}[$index1]->{'pts'} ;
$weight = ${$QUESTIONS_AH}[$index1]->{'wght'} ;
$ques_type = ${$QUESTIONS_AH}[$index1]->{'qtp'} ;
$scores = ${$QUESTIONS_AH}[$index1]->{'scores'} ;
@scores = split (/\,/ , $scores) ;
$supercat = ${$QUESTIONS_AH}[$index1]->{'supercat'} ;
if ($ques_type eq "lik") {
$supercat_total{$supercat} += $points ;
$SUPERCAT_TOTAL += $points ;
$responses = $responses[$index1] ;
@individ = split(/\?/, $responses) ;
shift @individ ;
foreach $index2 (0 .. $#scores) {
print "\ index2 $index2 individ elem $individ[$index2] scores elem $scores[$index2]\n" if $HBI_Debug ;
if ($individ[$index2] ne "xxx" and $individ[$index2] ne "" and $individ[$index2] == $index2) {
$supercat_earned{$supercat} += $scores[$index2] ;
$SUPERCAT_EARNED += $scores[$index2] ;
print "\ supercat $supercat responses $responses index1 $index1 index2 $index2 \ \n" if $HBI_Debug ;
}
}
} # end of if $ques_type
} # end foreach $index
print "\ \n" ;
print "Candidate: $CANDIDATE{'nmf'} " ;
if ($CANDIDATE{'nmm'}) {print "$CANDIDATE{'nmm'} " ;}
print "$CANDIDATE{'nml'} \ \n" ;
my $percent ;
@img_labels = () ;
@img_data = () ;
my $category_count = keys %supercat_total ; # The number of elements of %supercat_total
if ($category_count) {
foreach $rep (sort keys %supercat_total) {
$percent = int ((100.0 * $supercat_earned{$rep} / $supercat_total{$rep}) +0.5) ;
print "$rep Score: $percent\%\ \n" ;
push @img_labels, $rep ;
push @img_data, $percent ;
} # end of foreach $rep
push @img_labels, "Total" ;
$percent = int ((100.0 * $SUPERCAT_EARNED / $SUPERCAT_TOTAL) +0.5) ;
push @img_data, $percent ;
print "Total Score: $percent\%\ \n" ;
} else {
# $category_count is zero. No categories.
print "\ \n" ;
print "\ \ No Likert Scale Questions in the test.\ \n" ;
print "\ \n" ;
}
# The list parameters are: labels, values, and values2.
my @values2, $xdim, $ydim, $hbar, $title, $xlabel, $ylabel, $ymax, $ymin, $yticknum ;
# The scalar parameters are: xdim, ydim, hbar, title, xlabel, ylabel, ymax, ymin, yticknum
@values2 = () ;
($xdim, $ydim, $hbar, $title, $xlabel, $ylabel, $ymax, $ymin, $yticknum, $colorscheme) =
(800, 300, 1, "$CLIENT{'clnmc'}", "Category", "Percent for Category", 100, 0, 10, 1) ;
($t_margin, $b_margin, $l_margin, $r_margin) = (0, 0, 0, 30) ;
if ($category_count) {
print
BuildBarGraph(\@img_labels, \@img_data, \@values2, $xdim, $ydim, $hbar, $title, $xlabel, $ylabel, $ymax, $ymin, $yticknum, $colorscheme, $t_margin, $b_margin, $l_margin, $r_margin) ;
}
print "\ \n" ;
} # end of if $last_index
$testtitle="$FORM{'tstid'} - $TEST{'desc'}";
} else {
$sgrepfor = $FORM{'testdates'};
$sgrepfor =~ tr/_/ /;
@testdates = split(/\,/,$sgrepfor);
&get_test_profile($CLIENT{'clid'}, $testdates[1]);
$testtitle="$xlatphrase[720]";
}
print "\n" ;
&log_entry($SESSION{'clid'}, $SESSION{'uid'}, "3", "Exec Report $FORM{'rptno'} completed");
}
################################################################################
#
# Subroutine Name
# GetTestHeader
#
# Description
# This subroutine returns the header of the test file
#
# Inputs
# $clientId -- The id of the client to search through
#
# Outputs
# None
#
# Returns
# @testFields -- An array of fields in the header
#
#adt080401###############################################################################
sub GetTestHeader
{
my $clientId = $_[0];
my @testList = &get_data("tests.$clientId");
my $testHdr = $testList[0];
my $testFields;
chop( $testHdr );
@testFields = split( /&/, $testHdr );
return @testFields;
}
#adt080401###############################################################################
#
# Subroutine Name
# GetTestsByOwner
#
# Description
# This subroutine searches through the test definition file of the given
# client for all the tests that are owned by the given user id or are public
#
# Inputs
# $clientId -- The id of the client to search through
# $ownedBy -- The name of the owner of the test to search for
#
# Outputs
# None
#
# Returns
# @tests -- An array of tests owned by the given user id
#
################################################################################
sub GetTestsByOwner
{
my $clientId = $_[0];
my $ownedBy = $_[1];
my %currHash;
my @testList = &get_data("tests.$clientId");
my @currField;
my @tests;
my $testHdr = $testList[0];
my $testFields;
my $testCntr;
@testFields = &GetTestHeader( $clientId );
for( $testCntr = 1; $testCntr < $#testList; $testCntr++ )
{
#print "$testList[$testCntr] \n";
chop( $testList[$testCntr] );
@currField = split( '&', $testList[$testCntr] );
for( 0 .. $#testFields )
{
$currHash{$testFields[$_]} = $currField[$_];
}
#print "$currHash{'ownedby'} - $ownedBy
";
if( ( $currHash{'ownedby'} eq $ownedBy ) || ( $currHash{'ownedby'} eq "" ) )
{
push( @tests, $testList[$testCntr] );
#print "$testList[$testCntr] \n";
}
}
return @tests;
}
#
# Return: Count of test result files in $dir matching regex with $clid
# and $testid, OR -1 if there was an error.
#
sub CountTestFilesByCnd {
my ($dir, $clid, $testid, $cndid) = @_;
if ( ! defined($dir) ) {
&logger::logerr("Undefined directory for client ID '$clid', testid '$testid'");
return -1;
}
if ( ! defined($clid) ) {
&logger::logerr("Undefined client ID for directory '$dir', testid '$testid'");
return -1;
}
if ( ! defined($testid) ) {
&logger::logerr("Undefined test ID for directory '$dir', client ID '$clid'");
return -1;
}
my $tstcount = scalar(get_matching_files($dir, "^$clid".'\.'."$cndid".'\.'."$testid\$"));
return $tstcount;
}
#
# Return: Count of test result files in $dir matching regex with $clid
# and $testid, OR -1 if there was an error.
#
sub CountHistoricTests {
my ($dir, $clid, $testid, $cndid) = @_;
if ( ! defined($dir) ) {
&logger::logerr("Undefined directory for client ID '$clid', testid '$testid'");
return -1;
}
if ( ! defined($clid) ) {
&logger::logerr("Undefined client ID for directory '$dir', testid '$testid'");
return -1;
}
if ( ! defined($testid) ) {
&logger::logerr("Undefined test ID for directory '$dir', client ID '$clid'");
return -1;
}
my $historyfile = join($pathsep,$dir,"$clid.$testid.history");
open (HISTFILE,"<$historyfile") or return 0;
my @histentries = ;
close HISTFILE;
my $sgrepfor=join('&',"\<\<\>\>$clid","$cndid","$testid","");
my @cndidentries = grep( /$sgrepfor/,@histentries);
my $tstcount = $#cndidentries + 1;
return $tstcount;
}
#
# Return: Count of cnd result files in $dir matching regex with $clid
# and $cndid, OR -1 if there was an error.
#
sub CountCndFiles {
my ($dir, $clid, $cndid) = @_;
if ( ! defined($dir) ) {
&logger::logerr("Undefined directory for client ID '$clid', cndid '$cndid'");
return -1;
}
if ( ! defined($clid) ) {
&logger::logerr("Undefined client ID for directory '$dir', cndid '$cndid'");
return -1;
}
if ( ! defined($cndid) ) {
&logger::logerr("Undefined cnd ID for directory '$dir', client ID '$clid'");
return -1;
}
return scalar(get_matching_files($dir, "^$clid".'\.'."$cndid".'\.\S+$'));
}
#
# Return: Sum of times taken during a test in seconds.
#
sub computeTestTime {
my ($dir, $clid, $testid, $cndid, $tstkey) = @_;
if ( ! defined($dir) ) {
&logger::logerr("Undefined directory for client ID '$clid', testid '$testid'");
return -1;
}
if ( ! defined($clid) ) {
&logger::logerr("Undefined client ID for directory '$dir', testid '$testid'");
return -1;
}
if ( ! defined($testid) ) {
&logger::logerr("Undefined test ID for directory '$dir', client ID '$clid'");
return -1;
}
my $timefile = join($pathsep,$dir,"$clid.$cndid.$testid.tim");
open (TLOGFILE,"<$timefile") or return 0;
my @tlogentries = ;
close TLOGFILE;
my $sgrepfor="^$tstkey\&(1)\.(2)\.(.*)\&$clid\&$cndid\&$testid\&(.*)";
my @cndidentries = grep( /$sgrepfor/,@tlogentries);
@tlogentries = ();
my $iidx;
my @tentrycols;
my $tottime;
$tottime = 0;
for $iidx (0 .. $#cndidentries) {
@tentrycols = split(/&/,$cndidentries[$iidx]);
$tottime += $tentrycols[7];
}
@tentrycols = ();
return $tottime;
}
sub formatTimeFromSeconds {
my ($t, $fmt) = @_;
my $h;
my $m;
my $s;
my $r;
my $j;
$m = int($t/60);
$s = $t - ($m * 60);
$h = int($m/60);
$m = $m - ($h * 60);
if ($fmt =~ m/h/i) {
$r = "00000$h";
$j=length($r)-2;
$r = substr($r,$j,2);
$fmt =~ s/h/$r/g;
}
if ($fmt =~ m/m/i) {
$r = "00000$m";
$j=length($r)-2;
$r = substr($r,$j,2);
$fmt =~ s/m/$r/g;
}
if ($fmt =~ m/s/i) {
$r = "00000$s";
$j=length($r)-2;
$r = substr($r,$j,2);
$fmt =~ s/s/$r/g;
}
return $fmt;
}
############################################################################
#
# Function: munge( $string )
# Description: Do the normal munging to replace non-normal chars with %XX.
# Returns: a modified string with %XX patterns inserted
# Author: HBI, 2008/09/30
#
# The process is performed on strings that are sent as literal text,
# as part of an URL to be re-analyzed by a WEB server. The higher
# level application must do this once, and only once. This function
# assumes that the character string contains only 7 or 8 bit characters.
# This function cannot deal with multi-byte UTF-8 characters.
#
############################################################################
sub munge( $ ) {
my ($string) = @_;
$string =~ s/([^a-zA-Z0-9])/join('', '%', uc(unpack("H*",$1)))/eg;
return $string;
}
############################################################################
#
# Function: unmunge( $string )
# Description: Inverse operation of munge(), replace %XX with the real ascii.
# Returns: a modified string with %XX patterns replaced
# Author: efl, 11/2001
#
############################################################################
sub unmunge( $ ) {
my ($string) = @_;
$string =~ s/%([a-fA-F0-9][a-fA-F0-9])/pack("C",hex($1))/eg;
return $string;
}