version 1.4, 2002/07/24 14:52:32
|
version 1.24, 2002/08/28 22:42:15
|
Line 35 loncoursedata
|
Line 35 loncoursedata
|
|
|
=head1 SYNOPSIS |
=head1 SYNOPSIS |
|
|
Set of functions that download and process student information. |
Set of functions that download and process student and course information. |
|
|
=head1 PACKAGES USED |
=head1 PACKAGES USED |
|
|
Apache::Constants qw(:common :http) |
Apache::Constants qw(:common :http) |
Apache::lonnet() |
Apache::lonnet() |
|
Apache::lonhtmlcommon |
HTML::TokeParser |
HTML::TokeParser |
GDBM_File |
GDBM_File |
|
|
Line 51 package Apache::loncoursedata;
|
Line 52 package Apache::loncoursedata;
|
use strict; |
use strict; |
use Apache::Constants qw(:common :http); |
use Apache::Constants qw(:common :http); |
use Apache::lonnet(); |
use Apache::lonnet(); |
|
use Apache::lonhtmlcommon; |
use HTML::TokeParser; |
use HTML::TokeParser; |
use GDBM_File; |
use GDBM_File; |
|
|
Line 58 use GDBM_File;
|
Line 60 use GDBM_File;
|
|
|
=head1 DOWNLOAD INFORMATION |
=head1 DOWNLOAD INFORMATION |
|
|
This section contains all the files that get data from other servers |
This section contains all the functions that get data from other servers |
and/or itself. There is one function that has a call to get remote |
and/or itself. |
information but isn't included here which is ProcessTopLevelMap. The |
|
usage was small enough to be ignored, but that portion may be moved |
|
here in the future. |
|
|
|
=cut |
=cut |
|
|
Line 73 here in the future.
|
Line 72 here in the future.
|
=item &DownloadClasslist() |
=item &DownloadClasslist() |
|
|
Collects lastname, generation, middlename, firstname, PID, and section for each |
Collects lastname, generation, middlename, firstname, PID, and section for each |
student from their environment database. The list of students is built from |
student from their environment database. The section data is also download, though |
collecting a classlist for the course that is to be displayed. |
it is in a rough format, and is processed later. The list of students is built from |
|
collecting a classlist for the course that is to be displayed. Once the classlist |
|
has been downloaded, its date stamp is recorded. Unless the datestamp for the |
|
class database is reset or is modified, this data will not be downloaded again. |
|
Also, there was talk about putting the fullname and section |
|
and perhaps other pieces of data into the classlist file. This would |
|
reduce the number of different file accesses and reduce the amount of |
|
processing on this side. |
|
|
=over 4 |
=over 4 |
|
|
Input: $courseID, $c |
Input: $courseID, $lastDownloadTime, $c |
|
|
$courseID: The id of the course |
$courseID: The id of the course |
|
|
|
$lastDownloadTime: This is the date stamp for when this information was |
|
last gathered. If it is set to Not downloaded, it will gather the data |
|
again, though it currently does not remove the old data. |
|
|
$c: The connection class that can determine if the browser has aborted. It |
$c: The connection class that can determine if the browser has aborted. It |
is used to short circuit this function so that it doesn't continue to |
is used to short circuit this function so that it does not continue to |
get information when there is no need. |
get information when there is no need. |
|
|
Output: \%classlist |
Output: \%classlist |
Line 93 Output: \%classlist
|
Line 103 Output: \%classlist
|
-A list of student name:domain (as keys) (known below as $name) |
-A list of student name:domain (as keys) (known below as $name) |
|
|
-A hash pointer for each student containing lastname, generation, firstname, |
-A hash pointer for each student containing lastname, generation, firstname, |
middlename, and PID : Key is $name.'studentInformation' |
middlename, and PID : Key is $name.studentInformation |
|
|
-A hash pointer to each students section data : Key is $name.section |
-A hash pointer to each students section data : Key is $name.section |
|
|
|
-If there was an error in dump, it will be returned in the hash. See |
|
the error codes for dump in lonnet. Also, an error key will be |
|
generated if an abort occurs. |
|
|
=back |
=back |
|
|
=cut |
=cut |
Line 106 sub DownloadClasslist {
|
Line 120 sub DownloadClasslist {
|
my ($courseDomain,$courseNumber)=split(/\_/,$courseID); |
my ($courseDomain,$courseNumber)=split(/\_/,$courseID); |
my %classlist; |
my %classlist; |
|
|
my $modifiedTime = &GetFileTimestamp($courseDomain, $courseNumber, |
my $modifiedTime = &Apache::lonnet::GetFileTimestamp($courseDomain, $courseNumber, |
'classlist.db', |
'classlist.db', |
$Apache::lonnet::perlvar{'lonUsersDir'}); |
$Apache::lonnet::perlvar{'lonUsersDir'}); |
|
|
|
# Always download the information if lastDownloadTime is set to |
|
# Not downloaded, otherwise it is only downloaded if the file |
|
# has been updated and has a more recent date stamp |
if($lastDownloadTime ne 'Not downloaded' && |
if($lastDownloadTime ne 'Not downloaded' && |
$lastDownloadTime >= $modifiedTime && $modifiedTime >= 0) { |
$lastDownloadTime >= $modifiedTime && $modifiedTime >= 0) { |
|
# Data is not gathered so return UpToDate as true. This |
|
# will be interpreted in ProcessClasslist |
$classlist{'lastDownloadTime'}=time; |
$classlist{'lastDownloadTime'}=time; |
$classlist{'UpToDate'} = 'true'; |
$classlist{'UpToDate'} = 'true'; |
return \%classlist; |
return \%classlist; |
} |
} |
|
|
%classlist=&Apache::lonnet::dump('classlist',$courseDomain, $courseNumber); |
%classlist=&Apache::lonnet::dump('classlist',$courseDomain, $courseNumber); |
my ($checkForError)=keys (%classlist); |
foreach(keys (%classlist)) { |
if($checkForError =~ /^(con_lost|error|no_such_host)/i) { |
if(/^(con_lost|error|no_such_host)/i) { |
return \%classlist; |
return \%classlist; |
|
} |
} |
} |
|
|
foreach my $name (keys(%classlist)) { |
foreach my $name (keys(%classlist)) { |
if($c->aborted()) { |
if(defined($c) && ($c->aborted())) { |
$classlist{'error'}='aborted'; |
$classlist{'error'}='aborted'; |
return \%classlist; |
return \%classlist; |
} |
} |
Line 159 sub DownloadClasslist {
|
Line 179 sub DownloadClasslist {
|
|
|
=item &DownloadCourseInformation() |
=item &DownloadCourseInformation() |
|
|
Dump of all the course information for a single student. There is no |
Dump of all the course information for a single student. The data can be |
pruning of data, it is all stored in a hash and returned. It also |
pruned by making use of dumps regular expression arguement. This function |
|
also takes a regular expression which it passes straight through to dump. |
|
The data is no escaped, because it is done elsewhere. It also |
checks the timestamp of the students course database file and only downloads |
checks the timestamp of the students course database file and only downloads |
if it has been modified since the last download. |
if it has been modified since the last download. |
|
|
=over 4 |
=over 4 |
|
|
Input: $name, $courseID |
Input: $namedata, $courseID, $lastDownloadTime, $WhatIWant |
|
|
$name: student name:domain |
$namedata: student name:domain |
|
|
$courseID: The id of the course |
$courseID: The id of the course |
|
|
|
$lastDownloadTime: This is the date stamp for when this information was |
|
last gathered. If it is set to Not downloaded, it will gather the data |
|
again, though it currently does not remove the old data. |
|
|
|
$WhatIWant: Regular expression used to get selected data with dump |
|
|
Output: \%courseData |
Output: \%courseData |
|
|
\%courseData: A hash pointer to the raw data from the student's course |
\%courseData: A hash pointer to the raw data from the students course |
database. |
database. |
|
|
=back |
=back |
Line 182 database.
|
Line 210 database.
|
=cut |
=cut |
|
|
sub DownloadCourseInformation { |
sub DownloadCourseInformation { |
my ($namedata,$courseID,$lastDownloadTime)=@_; |
my ($namedata,$courseID,$lastDownloadTime,$WhatIWant)=@_; |
my %courseData; |
my %courseData; |
my ($name,$domain) = split(/\:/,$namedata); |
my ($name,$domain) = split(/\:/,$namedata); |
|
|
my $modifiedTime = &GetFileTimestamp($domain, $name, |
my $modifiedTime = &Apache::lonnet::GetFileTimestamp($domain, $name, |
$courseID.'.db', |
$courseID.'.db', |
$Apache::lonnet::perlvar{'lonUsersDir'}); |
$Apache::lonnet::perlvar{'lonUsersDir'}); |
if($lastDownloadTime >= $modifiedTime) { |
|
$courseData{'lastDownloadTime'}=time; |
if($lastDownloadTime >= $modifiedTime && $modifiedTime >= 0) { |
$courseData{'UpToDate'} = 'true'; |
# Data is not gathered so return UpToDate as true. This |
|
# will be interpreted in ProcessClasslist |
|
$courseData{$namedata.':lastDownloadTime'}=time; |
|
$courseData{$namedata.':UpToDate'} = 'true'; |
return \%courseData; |
return \%courseData; |
} |
} |
|
|
# Download course data |
# Download course data |
%courseData=&Apache::lonnet::dump($courseID, $domain, $name); |
if(!defined($WhatIWant)) { |
|
# set the regular expression to everything by setting it to period |
|
$WhatIWant = '.'; |
|
} |
|
%courseData=&Apache::lonnet::dump($courseID, $domain, $name, $WhatIWant); |
$courseData{'UpToDate'} = 'false'; |
$courseData{'UpToDate'} = 'false'; |
$courseData{'lastDownloadTime'}=time; |
$courseData{'lastDownloadTime'}=time; |
return \%courseData; |
|
|
my %newData; |
|
foreach (keys(%courseData)) { |
|
# need to have the keys to be prepended with the name:domain of the |
|
# student to reduce data collision later. |
|
$newData{$namedata.':'.$_} = $courseData{$_}; |
|
} |
|
|
|
return \%newData; |
} |
} |
|
|
# ----- END DOWNLOAD INFORMATION --------------------------------------- |
# ----- END DOWNLOAD INFORMATION --------------------------------------- |
Line 209 sub DownloadCourseInformation {
|
Line 252 sub DownloadCourseInformation {
|
=head1 PROCESSING FUNCTIONS |
=head1 PROCESSING FUNCTIONS |
|
|
These functions process all the data for all the students. Also, they |
These functions process all the data for all the students. Also, they |
are the only functions that access the cache database for writing. Thus |
are the functions that access the cache database for writing the majority of |
they are the only functions that cache data. The downloading and caching |
the time. The downloading and caching were separated to reduce problems |
were separated to reduce problems with stopping downloading then can't |
with stopping downloading then can not tie hash to database later. |
tie hash to database later. |
|
|
|
=cut |
=cut |
|
|
Line 254 sub ProcessTopResourceMap {
|
Line 296 sub ProcessTopResourceMap {
|
if($c->aborted()) { |
if($c->aborted()) { |
return; |
return; |
} |
} |
if(tie(%hash,'GDBM_File',"$fn.db",&GDBM_READER,0640)) { |
if(tie(%hash,'GDBM_File',"$fn.db",&GDBM_READER(),0640)) { |
last; |
last; |
} |
} |
$tieTries++; |
$tieTries++; |
Line 277 sub ProcessTopResourceMap {
|
Line 319 sub ProcessTopResourceMap {
|
$currentSequence=-1; |
$currentSequence=-1; |
my $topLevelSequenceNumber = $currentSequence; |
my $topLevelSequenceNumber = $currentSequence; |
|
|
|
my %sequenceRecord; |
while(1) { |
while(1) { |
if($c->aborted()) { |
if($c->aborted()) { |
last; |
last; |
} |
} |
# HANDLE NEW SEQUENCE! |
# HANDLE NEW SEQUENCE! |
#if page || sequence |
#if page || sequence |
if(defined($hash{'map_pc_'.$hash{'src_'.$currentResourceID}})) { |
if(defined($hash{'map_pc_'.$hash{'src_'.$currentResourceID}}) && |
|
!defined($sequenceRecord{$currentResourceID})) { |
|
$sequenceRecord{$currentResourceID}++; |
push(@sequences, $currentSequence); |
push(@sequences, $currentSequence); |
push(@currentResource, $currentResourceID); |
push(@currentResource, $currentResourceID); |
push(@finishResource, $lastResourceID); |
push(@finishResource, $lastResourceID); |
Line 313 sub ProcessTopResourceMap {
|
Line 358 sub ProcessTopResourceMap {
|
last; |
last; |
} |
} |
} |
} |
|
next; |
} |
} |
|
|
# Handle gradable resources: exams, problems, etc |
# Handle gradable resources: exams, problems, etc |
Line 321 sub ProcessTopResourceMap {
|
Line 367 sub ProcessTopResourceMap {
|
my $partB=$2; |
my $partB=$2; |
if($hash{'src_'.$currentResourceID}=~ |
if($hash{'src_'.$currentResourceID}=~ |
/\.(problem|exam|quiz|assess|survey|form)$/ && |
/\.(problem|exam|quiz|assess|survey|form)$/ && |
$partA eq $currentSequence) { |
$partA eq $currentSequence && |
|
!defined($sequenceRecord{$currentSequence.':'. |
|
$currentResourceID})) { |
|
$sequenceRecord{$currentSequence.':'.$currentResourceID}++; |
my $Problem = &Apache::lonnet::symbclean( |
my $Problem = &Apache::lonnet::symbclean( |
&Apache::lonnet::declutter($hash{'map_id_'.$partA}). |
&Apache::lonnet::declutter($hash{'map_id_'.$partA}). |
'___'.$partB.'___'. |
'___'.$partB.'___'. |
Line 341 sub ProcessTopResourceMap {
|
Line 390 sub ProcessTopResourceMap {
|
# &Apache::lonnet::metdata($meta,'title'); |
# &Apache::lonnet::metdata($meta,'title'); |
$cache->{$currentResourceID.':title'}= |
$cache->{$currentResourceID.':title'}= |
$hash{'title_'.$currentResourceID}; |
$hash{'title_'.$currentResourceID}; |
|
$cache->{$currentResourceID.':source'}= |
|
$hash{'src_'.$currentResourceID}; |
|
|
# Get Parts for problem |
# Get Parts for problem |
foreach (split(/\,/,&Apache::lonnet::metadata($meta,'keys'))) { |
my %beenHere; |
if($_=~/^stores\_(\d+)\_tries$/) { |
foreach (split(/\,/,&Apache::lonnet::metadata($meta,'packages'))) { |
my $Part=&Apache::lonnet::metadata($meta,$_.'.part'); |
if(/^\w+response_\d+.*/) { |
if(!defined($cache->{$currentSequence.':'. |
my (undef, $partId, $responseId) = split(/_/,$_); |
$currentResourceID.':parts'})) { |
if($beenHere{'p:'.$partId} == 0) { |
$cache->{$currentSequence.':'.$currentResourceID. |
$beenHere{'p:'.$partId}++; |
':parts'}=$Part; |
if(!defined($cache->{$currentSequence.':'. |
} else { |
$currentResourceID.':parts'})) { |
$cache->{$currentSequence.':'.$currentResourceID. |
$cache->{$currentSequence.':'.$currentResourceID. |
':parts'}.=':'.$Part; |
':parts'}=$partId; |
|
} else { |
|
$cache->{$currentSequence.':'.$currentResourceID. |
|
':parts'}.=':'.$partId; |
|
} |
} |
} |
foreach (split(/\,/, |
if($beenHere{'r:'.$partId.':'.$responseId} == 0) { |
&Apache::lonnet::metadata($meta,'packages'))) { |
$beenHere{'r:'.$partId.':'.$responseId}++; |
if($_=~/^optionresponse\_($Part)\_(\w+)$/) { |
if(!defined($cache->{$currentSequence.':'. |
if(defined($cache->{'OptionResponses'})) { |
$currentResourceID.':'.$partId. |
$cache->{'OptionResponses'}.= ':::'. |
':responseIDs'})) { |
$hash{'src_'.$currentResourceID}.'::'. |
$cache->{$currentSequence.':'.$currentResourceID. |
$hash{'title_'.$currentResourceID}.'::'. |
':'.$partId.':responseIDs'}=$responseId; |
$Part.'::'.$Problem; |
} else { |
} else { |
$cache->{$currentSequence.':'.$currentResourceID. |
$cache->{'OptionResponses'}= |
':'.$partId.':responseIDs'}.=':'. |
$hash{'src_'.$currentResourceID}.'::'. |
$responseId; |
$hash{'title_'.$currentResourceID}.'::'. |
} |
$Part.'::'.$Problem; |
} |
} |
if(/^optionresponse/ && |
|
$beenHere{'o:'.$partId.':'.$currentResourceID} == 0) { |
|
$beenHere{'o:'.$partId.$currentResourceID}++; |
|
if(defined($cache->{'OptionResponses'})) { |
|
$cache->{'OptionResponses'}.= ':::'. |
|
$currentSequence.':'.$currentResourceID.':'. |
|
$partId.':'.$responseId; |
|
} else { |
|
$cache->{'OptionResponses'}= $currentSequence.':'. |
|
$currentResourceID.':'. |
|
$partId.':'.$responseId; |
} |
} |
} |
} |
} |
} |
} |
} |
} |
} |
|
|
# if resource == finish resource, then it is the end of a sequence/page |
# if resource == finish resource, then it is the end of a sequence/page |
if($currentResourceID eq $lastResourceID) { |
if($currentResourceID eq $lastResourceID) { |
Line 421 sub ProcessTopResourceMap {
|
Line 486 sub ProcessTopResourceMap {
|
if($currentSequence eq $topLevelSequenceNumber) { |
if($currentSequence eq $topLevelSequenceNumber) { |
last; |
last; |
} |
} |
} |
} |
|
|
# MOVE!!! |
# MOVE!!! |
# move to next resource |
# move to next resource |
unless(defined($hash{'to_'.$currentResourceID})) { |
unless(defined($hash{'to_'.$currentResourceID})) { |
# big problem, need to handle. Next is probably wrong |
# big problem, need to handle. Next is probably wrong |
|
my $errorMessage = 'Big problem in '; |
|
$errorMessage .= 'loncoursedata::ProcessTopLevelMap.'; |
|
$errorMessage .= ' bighash to_$currentResourceID not defined!'; |
|
&Apache::lonnet::logthis($errorMessage); |
last; |
last; |
} |
} |
my @nextResources=(); |
my @nextResources=(); |
foreach (split(/\,/,$hash{'to_'.$currentResourceID})) { |
foreach (split(/\,/,$hash{'to_'.$currentResourceID})) { |
push(@nextResources, $hash{'goesto_'.$_}); |
if(!defined($sequenceRecord{$currentSequence.':'. |
|
$hash{'goesto_'.$_}})) { |
|
push(@nextResources, $hash{'goesto_'.$_}); |
|
} |
} |
} |
push(@currentResource, @nextResources); |
push(@currentResource, @nextResources); |
# Set the next resource to be processed |
# Set the next resource to be processed |
Line 460 Takes data downloaded for a student and
|
Line 532 Takes data downloaded for a student and
|
stored in cache data. The username, domain, class related date, PID, |
stored in cache data. The username, domain, class related date, PID, |
full name, and section are all processed here. |
full name, and section are all processed here. |
|
|
|
|
=over 4 |
=over 4 |
|
|
Input: $cache, $classlist, $courseID, $ChartDB, $c |
Input: $cache, $classlist, $courseID, $ChartDB, $c |
Line 469 $cache: A hash pointer to store the data
|
Line 540 $cache: A hash pointer to store the data
|
|
|
$classlist: The hash of data collected about a student from |
$classlist: The hash of data collected about a student from |
&DownloadClasslist(). The hash contains a list of students, a pointer |
&DownloadClasslist(). The hash contains a list of students, a pointer |
to a hash of student information for each student, and each student's section |
to a hash of student information for each student, and each students section |
number. |
number. |
|
|
$courseID: The course ID |
$courseID: The course ID |
Line 505 sub ProcessClasslist {
|
Line 576 sub ProcessClasslist {
|
if($c->aborted()) { |
if($c->aborted()) { |
return (); |
return (); |
} |
} |
push(@names,$name); |
|
my $studentInformation = $classlist->{$name.':studentInformation'}, |
my $studentInformation = $classlist->{$name.':studentInformation'}, |
my $sectionData = $classlist->{$name.':sections'}, |
my $sectionData = $classlist->{$name.':sections'}, |
my $date = $classlist->{$name}, |
my $date = $classlist->{$name}, |
Line 513 sub ProcessClasslist {
|
Line 583 sub ProcessClasslist {
|
|
|
$cache->{$name.':username'}=$studentName; |
$cache->{$name.':username'}=$studentName; |
$cache->{$name.':domain'}=$studentDomain; |
$cache->{$name.':domain'}=$studentDomain; |
|
# Initialize timestamp for student |
if(!defined($cache->{$name.':lastDownloadTime'})) { |
if(!defined($cache->{$name.':lastDownloadTime'})) { |
$cache->{$name.':lastDownloadTime'}='Not downloaded'; |
$cache->{$name.':lastDownloadTime'}='Not downloaded'; |
|
$cache->{$name.':updateTime'}=' Not updated'; |
} |
} |
|
|
my ($checkForError)=keys(%$studentInformation); |
my $error = 0; |
if($checkForError =~ /^(con_lost|error|no_such_host)/i) { |
foreach(keys(%$studentInformation)) { |
$cache->{$name.':error'}= |
if(/^(con_lost|error|no_such_host)/i) { |
'Could not download student environment data.'; |
$cache->{$name.':error'}= |
$cache->{$name.':fullname'}=''; |
'Could not download student environment data.'; |
$cache->{$name.':id'}=''; |
$cache->{$name.':fullname'}=''; |
} else { |
$cache->{$name.':id'}=''; |
$cache->{$name.':fullname'}=&ProcessFullName( |
$error = 1; |
|
} |
|
} |
|
next if($error); |
|
push(@names,$name); |
|
$cache->{$name.':fullname'}=&ProcessFullName( |
$studentInformation->{'lastname'}, |
$studentInformation->{'lastname'}, |
$studentInformation->{'generation'}, |
$studentInformation->{'generation'}, |
$studentInformation->{'firstname'}, |
$studentInformation->{'firstname'}, |
$studentInformation->{'middlename'}); |
$studentInformation->{'middlename'}); |
$cache->{$name.':id'}=$studentInformation->{'id'}; |
$cache->{$name.':id'}=$studentInformation->{'id'}; |
} |
|
|
|
my ($end, $start)=split(':',$date); |
my ($end, $start)=split(':',$date); |
$courseID=~s/\_/\//g; |
$courseID=~s/\_/\//g; |
Line 558 sub ProcessClasslist {
|
Line 634 sub ProcessClasslist {
|
} |
} |
$cache->{$name.':Status'}=$status; |
$cache->{$name.':Status'}=$status; |
$cache->{$name.':section'}=$sec; |
$cache->{$name.':section'}=$sec; |
|
|
|
if($sec eq '' || !defined($sec) || $sec eq ' ') { |
|
$sec = 'none'; |
|
} |
|
if(defined($cache->{'sectionList'})) { |
|
if($cache->{'sectionList'} !~ /(^$sec:|^$sec$|:$sec$|:$sec:)/) { |
|
$cache->{'sectionList'} .= ':'.$sec; |
|
} |
|
} else { |
|
$cache->{'sectionList'} = $sec; |
|
} |
} |
} |
|
|
$cache->{'ClasslistTimestamp'}=time; |
$cache->{'ClasslistTimestamp'}=time; |
Line 574 Takes the course data downloaded for a s
|
Line 661 Takes the course data downloaded for a s
|
&DownloadCourseInformation() and breaks it up into key value pairs |
&DownloadCourseInformation() and breaks it up into key value pairs |
to be stored in the cached data. The keys are comprised of the |
to be stored in the cached data. The keys are comprised of the |
$username:$domain:$keyFromCourseDatabase. The student username:domain is |
$username:$domain:$keyFromCourseDatabase. The student username:domain is |
stored away signifying that the student's information has been downloaded and |
stored away signifying that the students information has been downloaded and |
can be reused from cached data. |
can be reused from cached data. |
|
|
=over 4 |
=over 4 |
Line 602 will only exist if an error occured. Th
|
Line 689 will only exist if an error occured. Th
|
sub ProcessStudentData { |
sub ProcessStudentData { |
my ($cache,$courseData,$name)=@_; |
my ($cache,$courseData,$name)=@_; |
|
|
if($courseData->{'UpToDate'} eq 'true') { |
if(!&CheckDateStampError($courseData, $cache, $name)) { |
$cache->{$name.':lastDownloadTime'}=$courseData->{'lastDownloadTime'}; |
|
return; |
return; |
} |
} |
|
|
my @courseKeys = keys(%$courseData); |
# user name:domain was prepended earlier in DownloadCourseInformation |
|
foreach (keys %$courseData) { |
|
$cache->{$_}=$courseData->{$_}; |
|
} |
|
|
foreach (@courseKeys) { |
return; |
if(/^(con_lost|error|no_such_host)/i) { |
} |
$cache->{$name.':error'}='Could not download course data.'; |
|
return; |
=pod |
} |
|
|
=item &ExtractStudentData() |
|
|
|
HISTORY: This function originally existed in every statistics module, |
|
and performed different tasks, the had some overlap. Due to the need |
|
for the data from the different modules, they were combined into |
|
a single function. |
|
|
|
This function now extracts all the necessary course data for a student |
|
from what was downloaded from their homeserver. There is some extra |
|
time overhead compared to the ProcessStudentInformation function, but |
|
it would have had to occurred at some point anyways. This is now |
|
typically called while downloading the data it will process. It is |
|
the brother function to ProcessStudentInformation. |
|
|
|
=over 4 |
|
|
|
Input: $input, $output, $data, $name |
|
|
|
$input: A hash that contains the input data to be processed |
|
|
|
$output: A hash to contain the processed data |
|
|
|
$data: A hash containing the information on what is to be |
|
processed and how (basically). |
|
|
|
$name: username:domain |
|
|
|
The input is slightly different here, but is quite simple. |
|
It is currently used where the $input, $output, and $data |
|
can and are often the same hashes, but they do not need |
|
to be. |
|
|
|
Output: None |
|
|
|
*NOTE: There is no output, but an error message is stored away in the cache |
|
data. This is checked in &FormatStudentData(). The key username:domain:error |
|
will only exist if an error occured. The error is an error from |
|
&DownloadCourseInformation(). |
|
|
|
=back |
|
|
|
=cut |
|
|
|
sub ExtractStudentData { |
|
my ($input, $output, $data, $name)=@_; |
|
|
|
if(!&CheckDateStampError($input, $data, $name)) { |
|
return; |
} |
} |
|
|
$cache->{$name.':lastDownloadTime'}=$courseData->{'lastDownloadTime'}; |
my ($username,$domain)=split(':',$name); |
foreach (@courseKeys) { |
|
$cache->{$name.':'.$_}=$courseData->{$_}; |
my $Version; |
|
my $problemsCorrect = 0; |
|
my $totalProblems = 0; |
|
my $problemsSolved = 0; |
|
my $numberOfParts = 0; |
|
my $totalAwarded = 0; |
|
foreach my $sequence (split(':', $data->{'orderedSequences'})) { |
|
foreach my $problemID (split(':', $data->{$sequence.':problems'})) { |
|
my $problem = $data->{$problemID.':problem'}; |
|
my $LatestVersion = $input->{$name.':version:'.$problem}; |
|
|
|
# Output dashes for all the parts of this problem if there |
|
# is no version information about the current problem. |
|
if(!$LatestVersion) { |
|
foreach my $part (split(/\:/,$data->{$sequence.':'. |
|
$problemID. |
|
':parts'})) { |
|
$output->{$name.':'.$problemID.':'.$part.':tries'} = 0; |
|
$output->{$name.':'.$problemID.':'.$part.':awarded'} = 0; |
|
$output->{$name.':'.$problemID.':'.$part.':code'} = ' '; |
|
$totalProblems++; |
|
} |
|
$output->{$name.':'.$problemID.':NoVersion'} = 'true'; |
|
next; |
|
} |
|
|
|
my %partData=undef; |
|
# Initialize part data, display skips correctly |
|
# Skip refers to when a student made no submissions on that |
|
# part/problem. |
|
foreach my $part (split(/\:/,$data->{$sequence.':'. |
|
$problemID. |
|
':parts'})) { |
|
$partData{$part.':tries'}=0; |
|
$partData{$part.':code'}=' '; |
|
$partData{$part.':awarded'}=0; |
|
$partData{$part.':timestamp'}=0; |
|
foreach my $response (split(':', $data->{$sequence.':'. |
|
$problemID.':'. |
|
$part.':responseIDs'})) { |
|
$partData{$part.':'.$response.':submission'}=''; |
|
} |
|
} |
|
|
|
# Looping through all the versions of each part, starting with the |
|
# oldest version. Basically, it gets the most recent |
|
# set of grade data for each part. |
|
my @submissions = (); |
|
for(my $Version=1; $Version<=$LatestVersion; $Version++) { |
|
foreach my $part (split(/\:/,$data->{$sequence.':'. |
|
$problemID. |
|
':parts'})) { |
|
|
|
if(!defined($input->{"$name:$Version:$problem". |
|
":resource.$part.solved"})) { |
|
# No grade for this submission, so skip |
|
next; |
|
} |
|
|
|
my $tries=0; |
|
my $code=' '; |
|
my $awarded=0; |
|
|
|
$tries = $input->{$name.':'.$Version.':'.$problem. |
|
':resource.'.$part.'.tries'}; |
|
$awarded = $input->{$name.':'.$Version.':'.$problem. |
|
':resource.'.$part.'.awarded'}; |
|
|
|
$partData{$part.':awarded'}=($awarded) ? $awarded : 0; |
|
$partData{$part.':tries'}=($tries) ? $tries : 0; |
|
|
|
$partData{$part.':timestamp'}=$input->{$name.':'.$Version.':'. |
|
$problem. |
|
':timestamp'}; |
|
if(!$input->{$name.':'.$Version.':'.$problem.':resource.'.$part. |
|
'.previous'}) { |
|
foreach my $response (split(':', |
|
$data->{$sequence.':'. |
|
$problemID.':'. |
|
$part.':responseIDs'})) { |
|
@submissions=($input->{$name.':'.$Version.':'. |
|
$problem. |
|
':resource.'.$part.'.'. |
|
$response.'.submission'}, |
|
@submissions); |
|
} |
|
} |
|
|
|
my $val = $input->{$name.':'.$Version.':'.$problem. |
|
':resource.'.$part.'.solved'}; |
|
if ($val eq 'correct_by_student') {$code = '*';} |
|
elsif ($val eq 'correct_by_override') {$code = '+';} |
|
elsif ($val eq 'incorrect_attempted') {$code = '.';} |
|
elsif ($val eq 'incorrect_by_override'){$code = '-';} |
|
elsif ($val eq 'excused') {$code = 'x';} |
|
elsif ($val eq 'ungraded_attempted') {$code = '#';} |
|
else {$code = ' ';} |
|
$partData{$part.':code'}=$code; |
|
} |
|
} |
|
|
|
foreach my $part (split(/\:/,$data->{$sequence.':'.$problemID. |
|
':parts'})) { |
|
$output->{$name.':'.$problemID.':'.$part.':wrong'} = |
|
$partData{$part.':tries'}; |
|
|
|
if($partData{$part.':code'} eq '*') { |
|
$output->{$name.':'.$problemID.':'.$part.':wrong'}--; |
|
$problemsCorrect++; |
|
} elsif($partData{$part.':code'} eq '+') { |
|
$output->{$name.':'.$problemID.':'.$part.':wrong'}--; |
|
$problemsCorrect++; |
|
} |
|
|
|
$output->{$name.':'.$problemID.':'.$part.':tries'} = |
|
$partData{$part.':tries'}; |
|
$output->{$name.':'.$problemID.':'.$part.':code'} = |
|
$partData{$part.':code'}; |
|
$output->{$name.':'.$problemID.':'.$part.':awarded'} = |
|
$partData{$part.':awarded'}; |
|
$totalAwarded += $partData{$part.':awarded'}; |
|
$output->{$name.':'.$problemID.':'.$part.':timestamp'} = |
|
$partData{$part.':timestamp'}; |
|
foreach my $response (split(':', $data->{$sequence.':'. |
|
$problemID.':'. |
|
$part.':responseIDs'})) { |
|
$output->{$name.':'.$problemID.':'.$part.':'.$response. |
|
':submission'}=join(':::',@submissions); |
|
} |
|
|
|
if($partData{$part.':code'} ne 'x') { |
|
$totalProblems++; |
|
} |
|
} |
|
} |
|
|
|
$output->{$name.':'.$sequence.':problemsCorrect'} = $problemsCorrect; |
|
$problemsSolved += $problemsCorrect; |
|
$problemsCorrect=0; |
} |
} |
|
|
|
$output->{$name.':problemsSolved'} = $problemsSolved; |
|
$output->{$name.':totalProblems'} = $totalProblems; |
|
$output->{$name.':totalAwarded'} = $totalAwarded; |
|
|
return; |
return; |
} |
} |
|
|
sub LoadDiscussion { |
sub LoadDiscussion { |
# my $symb=shift; |
my ($courseID)=@_; |
# $r->print('<br>$cid ... '.$symb); |
my %Discuss=(); |
# my %contrib=&Apache::lonnet::dump('msu_2964385f9033c63msul1','msu','2964385f9033c63msul1'); |
my %contrib=&Apache::lonnet::dump( |
my ($name, $courseID, $Discuss)=@_; |
$courseID, |
my %contrib=&DownloadCourseInformation($name, $courseID, 0); |
$ENV{'course.'.$courseID.'.domain'}, |
|
$ENV{'course.'.$courseID.'.num'}); |
|
|
|
#my %contrib=&DownloadCourseInformation($name, $courseID, 0); |
|
|
foreach my $temp(keys %contrib) { |
foreach my $temp(keys %contrib) { |
if ($temp=~/^version/) { |
if ($temp=~/^version/) { |
my $ver=$contrib{$temp}; |
my $ver=$contrib{$temp}; |
my ($dummy,$prb)=split(':',$temp); |
my ($dummy,$prb)=split(':',$temp); |
for (my $idx=1; $idx<=$ver; $idx++ ) { |
for (my $idx=1; $idx<=$ver; $idx++ ) { |
my $name=$contrib{"$idx:$prb:sendername"}; |
my $name=$contrib{"$idx:$prb:sendername"}; |
$Discuss->{"$name:$prb"}=$idx; |
$Discuss{"$name:$prb"}=$idx; |
} |
} |
} |
} |
} |
} |
# $r->print('<br>cid='.$cid); |
|
# my %contrib=&Apache::lonnet::restore($symb,$cid, |
return \%Discuss; |
# $ENV{$cid.'.domain'}, |
|
# $ENV{'course.'.$cid.'.num'}); |
|
|
|
# $Apache::lonxml::debug=1; |
|
# &Apache::lonhomework::showhash(%Discuss); |
|
# $Apache::lonxml::debug=0; |
|
} |
} |
|
|
# ----- END PROCESSING FUNCTIONS --------------------------------------- |
# ----- END PROCESSING FUNCTIONS --------------------------------------- |
Line 658 sub LoadDiscussion {
|
Line 934 sub LoadDiscussion {
|
=head1 HELPER FUNCTIONS |
=head1 HELPER FUNCTIONS |
|
|
These are just a couple of functions do various odd and end |
These are just a couple of functions do various odd and end |
jobs. |
jobs. There was also a couple of bulk functions added. These are |
|
&DownloadStudentCourseData(), &DownloadStudentCourseDataSeparate(), and |
|
&CheckForResidualDownload(). These functions now act as the interface |
|
for downloading student course data. The statistical modules should |
|
no longer make the calls to dump and download and process etc. They |
|
make calls to these bulk functions to get their data. |
|
|
=cut |
=cut |
|
|
# ----- HELPER FUNCTIONS ----------------------------------------------- |
# ----- HELPER FUNCTIONS ----------------------------------------------- |
|
|
|
sub CheckDateStampError { |
|
my ($courseData, $cache, $name)=@_; |
|
if($courseData->{$name.':UpToDate'} eq 'true') { |
|
$cache->{$name.':lastDownloadTime'} = |
|
$courseData->{$name.':lastDownloadTime'}; |
|
if($courseData->{$name.':lastDownloadTime'} eq 'Not downloaded') { |
|
$cache->{$name.':updateTime'} = ' Not updated'; |
|
} else { |
|
$cache->{$name.':updateTime'}= |
|
localtime($courseData->{$name.':lastDownloadTime'}); |
|
} |
|
return 0; |
|
} |
|
|
|
$cache->{$name.':lastDownloadTime'}=$courseData->{$name.':lastDownloadTime'}; |
|
if($courseData->{$name.':lastDownloadTime'} eq 'Not downloaded') { |
|
$cache->{$name.':updateTime'} = ' Not updated'; |
|
} else { |
|
$cache->{$name.':updateTime'}= |
|
localtime($courseData->{$name.':lastDownloadTime'}); |
|
} |
|
|
|
if(defined($courseData->{$name.':error'})) { |
|
$cache->{$name.':error'}=$courseData->{$name.':error'}; |
|
return 0; |
|
} |
|
|
|
return 1; |
|
} |
|
|
=pod |
=pod |
|
|
=item &ProcessFullName() |
=item &ProcessFullName() |
Line 732 $ChartDB: The name of the cache database
|
Line 1043 $ChartDB: The name of the cache database
|
|
|
Output: -1, 0, 1 |
Output: -1, 0, 1 |
|
|
-1: Couldn't tie database |
-1: Could not tie database |
0: Use cached data |
0: Use cached data |
1: New cache database created, use that. |
1: New cache database created, use that. |
|
|
Line 759 sub TestCacheData {
|
Line 1070 sub TestCacheData {
|
while($tieTries < $totalDelay) { |
while($tieTries < $totalDelay) { |
my $result=0; |
my $result=0; |
if($isCached) { |
if($isCached) { |
$result=tie(%testData,'GDBM_File',$ChartDB,&GDBM_READER,0640); |
$result=tie(%testData,'GDBM_File',$ChartDB,&GDBM_READER(),0640); |
} else { |
} else { |
$result=tie(%testData,'GDBM_File',$ChartDB,&GDBM_NEWDB,0640); |
$result=tie(%testData,'GDBM_File',$ChartDB,&GDBM_NEWDB(),0640); |
} |
} |
if($result) { |
if($result) { |
last; |
last; |
Line 778 sub TestCacheData {
|
Line 1089 sub TestCacheData {
|
return $isCached; |
return $isCached; |
} |
} |
|
|
sub GetFileTimestamp { |
sub DownloadStudentCourseData { |
my ($studentDomain,$studentName,$filename,$root)=@_; |
my ($students,$checkDate,$cacheDB,$extract,$status,$courseID,$r,$c)=@_; |
$studentDomain=~s/\W//g; |
|
$studentName=~s/\W//g; |
my $title = 'LON-CAPA Statistics'; |
my $subdir=$studentName.'__'; |
my $heading = 'Download and Process Course Data'; |
$subdir =~ s/(.)(.)(.).*/$1\/$2\/$3/; |
my $studentCount = scalar(@$students); |
my $proname="$studentDomain/$subdir/$studentName"; |
|
$proname .= '/'.$filename; |
my $WhatIWant; |
my @dir = &Apache::lonnet::dirlist($proname, $studentDomain, $studentName, |
$WhatIWant = '(^version:|'; |
$root); |
$WhatIWant .= '^\d+:.+?:(resource\.\d+\.'; |
my $fileStat = $dir[0]; |
$WhatIWant .= '(solved|tries|previous|awarded|(\d+\.submission))\s*$'; |
my @stats = split('&', $fileStat); |
$WhatIWant .= '|timestamp)'; |
if(@stats) { |
$WhatIWant .= ')'; |
return $stats[9]; |
# $WhatIWant = '.'; |
} else { |
|
return -1; |
if($status eq 'true') { |
|
&Apache::lonhtmlcommon::Create_PrgWin($r, $title, $heading); |
|
} |
|
|
|
my $displayString; |
|
my $count=0; |
|
foreach (@$students) { |
|
my %cache; |
|
|
|
if($c->aborted()) { return 'Aborted'; } |
|
|
|
if($status eq 'true') { |
|
$count++; |
|
my $displayString = $count.'/'.$studentCount.': '.$_; |
|
&Apache::lonhtmlcommon::Update_PrgWin($displayString, $r); |
|
} |
|
|
|
my $downloadTime='Not downloaded'; |
|
if($checkDate eq 'true' && |
|
tie(%cache,'GDBM_File',$cacheDB,&GDBM_READER(),0640)) { |
|
$downloadTime = $cache{$_.':lastDownloadTime'}; |
|
untie(%cache); |
|
} |
|
|
|
if($c->aborted()) { return 'Aborted'; } |
|
|
|
if($downloadTime ne 'Not downloaded') { |
|
next; |
|
} |
|
my $courseData = |
|
&DownloadCourseInformation($_, $courseID, $downloadTime, |
|
$WhatIWant); |
|
if(tie(%cache,'GDBM_File',$cacheDB,&GDBM_WRCREAT(),0640)) { |
|
foreach my $key (keys(%$courseData)) { |
|
if($key =~ /^(con_lost|error|no_such_host)/i) { |
|
$courseData->{$_.':error'} = 'No course data for '.$_; |
|
last; |
|
} |
|
} |
|
if($extract eq 'true') { |
|
&ExtractStudentData($courseData, \%cache, \%cache, $_); |
|
} else { |
|
&ProcessStudentData(\%cache, $courseData, $_); |
|
} |
|
untie(%cache); |
|
} else { |
|
next; |
|
} |
|
} |
|
if($status eq 'true') { &Apache::lonhtmlcommon::Close_PrgWin($r); } |
|
|
|
return 'OK'; |
|
} |
|
|
|
sub DownloadStudentCourseDataSeparate { |
|
my ($students,$checkDate,$cacheDB,$extract,$status,$courseID,$r,$c)=@_; |
|
my $residualFile = '/home/httpd/perl/tmp/'.$courseID.'DownloadFile.db'; |
|
my $title = 'LON-CAPA Statistics'; |
|
my $heading = 'Download Course Data'; |
|
|
|
my $WhatIWant; |
|
$WhatIWant = '(^version:|'; |
|
$WhatIWant .= '^\d+:.+?:(resource\.\d+\.'; |
|
$WhatIWant .= '(solved|tries|previous|awarded|(\d+\.submission))\s*$'; |
|
$WhatIWant .= '|timestamp)'; |
|
$WhatIWant .= ')'; |
|
|
|
&CheckForResidualDownload($courseID, $cacheDB, $students, $c); |
|
|
|
my $studentCount = scalar(@$students); |
|
if($status eq 'true') { |
|
&Apache::lonhtmlcommon::Create_PrgWin($r, $title, $heading); |
} |
} |
|
my $count=0; |
|
my $displayString=''; |
|
foreach (@$students) { |
|
if($c->aborted()) { |
|
return 'Aborted'; |
|
} |
|
|
|
if($status eq 'true') { |
|
$count++; |
|
$displayString = $count.'/'.$studentCount.': '.$_; |
|
&Apache::lonhtmlcommon::Update_PrgWin($displayString, $r); |
|
} |
|
|
|
my %cache; |
|
my $downloadTime='Not downloaded'; |
|
if($checkDate eq 'true' && |
|
tie(%cache,'GDBM_File',$cacheDB,&GDBM_READER(),0640)) { |
|
$downloadTime = $cache{$_.':lastDownloadTime'}; |
|
untie(%cache); |
|
} |
|
|
|
if($c->aborted()) { |
|
return 'Aborted'; |
|
} |
|
|
|
if($downloadTime eq 'Not downloaded') { |
|
my $error = 0; |
|
my $courseData = |
|
&DownloadCourseInformation($_, $courseID, $downloadTime, |
|
$WhatIWant); |
|
my %downloadData; |
|
unless(tie(%downloadData,'GDBM_File',$residualFile, |
|
&GDBM_WRCREAT(),0640)) { |
|
return 'Failed to tie temporary download hash.'; |
|
} |
|
foreach my $key (keys(%$courseData)) { |
|
$downloadData{$key} = $courseData->{$key}; |
|
if($key =~ /^(con_lost|error|no_such_host)/i) { |
|
$error = 1; |
|
last; |
|
} |
|
} |
|
if($error) { |
|
foreach my $deleteKey (keys(%$courseData)) { |
|
delete $downloadData{$deleteKey}; |
|
} |
|
$downloadData{$_.':error'} = 'No course data for '.$_; |
|
} |
|
untie(%downloadData); |
|
} |
|
} |
|
if($status eq 'true') { &Apache::lonhtmlcommon::Close_PrgWin($r); } |
|
|
|
return &CheckForResidualDownload($cacheDB, 'true', 'true', |
|
$courseID, $r, $c); |
|
} |
|
|
|
sub CheckForResidualDownload { |
|
my ($cacheDB,$extract,$status,$courseID,$r,$c)=@_; |
|
|
|
my $residualFile = '/home/httpd/perl/tmp/'.$courseID.'DownloadFile.db'; |
|
if(!-e $residualFile) { |
|
return 'OK'; |
|
} |
|
|
|
my %downloadData; |
|
my %cache; |
|
unless(tie(%downloadData,'GDBM_File',$residualFile,&GDBM_READER(),0640)) { |
|
return 'Can not tie database for check for residual download: tempDB'; |
|
} |
|
unless(tie(%cache,'GDBM_File',$cacheDB,&GDBM_WRCREAT(),0640)) { |
|
untie(%downloadData); |
|
return 'Can not tie database for check for residual download: cacheDB'; |
|
} |
|
|
|
my @students=(); |
|
my %checkStudent; |
|
my $key; |
|
while(($key, undef) = each %downloadData) { |
|
my @temp = split(':', $key); |
|
my $student = $temp[0].':'.$temp[1]; |
|
if(!defined($checkStudent{$student})) { |
|
$checkStudent{$student}++; |
|
push(@students, $student); |
|
} |
|
} |
|
|
|
my $heading = 'Process Course Data'; |
|
my $title = 'LON-CAPA Statistics'; |
|
my $studentCount = scalar(@students); |
|
if($status eq 'true') { |
|
&Apache::lonhtmlcommon::Create_PrgWin($r, $title, $heading); |
|
} |
|
|
|
my $count=1; |
|
foreach my $name (@students) { |
|
last if($c->aborted()); |
|
|
|
if($status eq 'true') { |
|
my $displayString = $count.'/'.$studentCount.': '.$name; |
|
&Apache::lonhtmlcommon::Update_PrgWin($displayString, $r); |
|
} |
|
|
|
if($extract eq 'true') { |
|
&ExtractStudentData(\%downloadData, \%cache, \%cache, $name); |
|
} else { |
|
&ProcessStudentData(\%cache, \%downloadData, $name); |
|
} |
|
$count++; |
|
} |
|
|
|
if($status eq 'true') { &Apache::lonhtmlcommon::Close_PrgWin($r); } |
|
|
|
untie(%cache); |
|
untie(%downloadData); |
|
|
|
if(!$c->aborted()) { |
|
my @files = ($residualFile); |
|
unlink(@files); |
|
} |
|
|
|
return 'OK'; |
} |
} |
|
|
# ----- END HELPER FUNCTIONS -------------------------------------------- |
# ----- END HELPER FUNCTIONS -------------------------------------------- |