Public Member Functions
	QuestionnaireDataView ($mgr)

	getAggregateData ($question, $answers)

	getSingleSelectQuestionResultData ($question, $answers)

	getRatingsQuestionResultData ($question, $answers)

	getOptionText ($options)

	getMean ($counts)

	getMedian ($optionAnswers)

	getCheckListQuestionResultData ($question, $answers)

	writeScript ()

	buildOptionDataView ()

	getGroupTitle ($question)

	buildTextDataView ()

	drawView ()

	getHeading ()

Static Public Member Functions
static	getCheckListAnswerCounts ($answers)

static	formatQuestion ($question)

static	formatAnswer ($answer)

Public Attributes
	$obj

	$survey

	$questions

	$answers

	$emptyMessage = "There are no results."

	$optionDataView

	$textDataView

	$optionAnswers

	$textAnswers

	$responseCount

Detailed Description

Definition at line 37 of file questionnaire_data_view.inc.

Member Function Documentation

◆ buildOptionDataView()

QuestionnaireDataView::buildOptionDataView ( )

Definition at line 330 of file questionnaire_data_view.inc.

      {
           $dataView = new GroupedDataListView($this->optionAnswers, "OptionDataList");
           $dataView->column("Option", "{option}", false, "width: 90%")
           ->column("Count", "{count}", false, "width: 10%");
           $dataView->groupBy($this->questions, array($this, getGroupTitle));
           $dataView->mode = 'tree';
           $dataView->emptyMessage = "There are no aggregated data results.";
           $dataView->excelFile = "option_surveyData.xls";
           $this->optionDataView = $dataView;
      }

◆ buildTextDataView()

QuestionnaireDataView::buildTextDataView ( )

Definition at line 350 of file questionnaire_data_view.inc.

      {
           $table = new GroupedDataListView($this->textAnswers, "AnswerTextList");
           $table->column("Answer Text", array(QuestionnaireDataView, formatAnswer));
           $table->groupBy($this->questions, array(QuestionnaireDataView, formatQuestion));
           $table->mode = 'tree';
           $table->emptyMessage = "There are no text results.";
           $table->excelFile = "text_surveyData.xls";
  
           $this->textDataView = $table;
      }

◆ drawView()

QuestionnaireDataView::drawView ( )

Definition at line 374 of file questionnaire_data_view.inc.

      {
           echo $this->getHeading();
           $this->optionDataView->drawView();
           echo "<h4>Free Text Responses</h4>";
           $this->textDataView->drawView();
      }

◆ formatAnswer()

static QuestionnaireDataView::formatAnswer ( $answer )

static

Definition at line 368 of file questionnaire_data_view.inc.

      {
           return ($answer->value) ? $answer->value : "Not Answered";
      }

◆ formatQuestion()

static QuestionnaireDataView::formatQuestion ( $question )

static

Definition at line 363 of file questionnaire_data_view.inc.

      {
           return $question->question_number . ". " . $question->question;
      }

◆ getAggregateData()

QuestionnaireDataView::getAggregateData	(	$question,
		$answers
	)

Definition at line 79 of file questionnaire_data_view.inc.

      {
           $qPk = $this->mgr->getQuestionKey();
  
           $questionType = new QuestionType($question->question_type_id);
  
           switch($questionType->class_name)
           {
                case MultipleChoiceView:
                          
                     $this->optionAnswers[$question->$qPk] = $this->getSingleSelectQuestionResultData($question, $answers);
                     break;
                          
                case RatingView:
  
                     $this->optionAnswers[$question->$qPk] = $this->getRatingsQuestionResultData($question, $answers);
                     break;
                          
                case ShortTextView:
  
                     $this->textAnswers[$question->$qPk] = $answers;
                     break;
                          
                case FreeTextView:
  
                     $this->textAnswers[$question->$qPk] = $answers;
                     break;
                          
                case CheckListView:
  
                     $this->optionAnswers[$question->$qPk] = $this->getCheckListQuestionResultData($question, $answers);
                     break;
                          
                case SelectFieldView:
  
                     $this->optionAnswers[$question->$qPk] = $this->getSingleSelectQuestionResultData($question, $answers);
                     break;
  
                case HeadingView:
                     break;
                     
                default:
                          
                     trace("getAggregateData: Unknown question type {$questionType->class_name}", 2);
                     die("QuestionniareDataView getAggregateData: Unknown question type {$questionType->class_name}");
           }
  
      }

◆ getCheckListAnswerCounts()

static QuestionnaireDataView::getCheckListAnswerCounts ( $answers )

static

Definition at line 295 of file questionnaire_data_view.inc.

      {
           if(count($answers) == 0)
                return;
  
           $count = array();
                
           foreach($answers as $answer)
           {
                $values = $answer->value;
  
                // include 0 value, first checkbox
                if(strlen($values)==1 AND is_numeric($values))
                     $values = array($values);
                elseif(strlen($values)==0)
                     $values = "";
                else
                     $values = explode(",", $values);
                     
                foreach($values as $value => $idx)
                {
                     $count[$idx] += 1;
                }
           }
           return $count;
      }

◆ getCheckListQuestionResultData()

QuestionnaireDataView::getCheckListQuestionResultData	(	$question,
		$answers
	)

Definition at line 271 of file questionnaire_data_view.inc.

      {
           $qPk = $this->mgr->getQuestionKey();
           $options = explode("\n", $question->options);
           $idx = 1;
  
           // Explode and record the count of each value answer
           $answerCounts = $this->getCheckListAnswerCounts($answers);
           if(count($options) > 0)
           {
                $optionAnswers = array();
                     
                foreach($options as $option)
                {
                     $count = $answerCounts[$idx];
                     if (!isset($count)) $count = 0;
                     $optionAnswer = new OptionAnswer($question->$qPk, $idx, $option, $count);
                     array_push($optionAnswers, $optionAnswer);
                     $idx++;
                }
           }
           return $optionAnswers;
      }

◆ getGroupTitle()

QuestionnaireDataView::getGroupTitle ( $question )

Definition at line 343 of file questionnaire_data_view.inc.

      {
           $questionTypes = QuestionType::getQuestionTypeList();
           return  "{$question->question_number}. {$question->question} " . $questionTypes[$question->question_type];
      }

◆ getHeading()

QuestionnaireDataView::getHeading ( )

Definition at line 390 of file questionnaire_data_view.inc.

      {
           $fn = array($this->mgr, formatResultsHeading);
           if (is_callable($fn))
           {
                return call_user_func($fn);
           }              
  
           $recipientCount = $this->mgr->getRecipientCount();
  
           $countText = ($this->responseCount) ? $this->responseCount : "0";
           $text = "<h3>Aggregated Survey Answers based on $countText ";
           $text .= ($recipientCount) ? "out of $recipientCount " : "";
           $text .= "Respondents</h3>\n";
  
           return $text;
      }

◆ getMean()

QuestionnaireDataView::getMean ( $counts )

Definition at line 210 of file questionnaire_data_view.inc.

      {
           $total = 0;
           $num = 0;
  
           foreach($counts as $value => $count)
           {
                $total += $value * $count;
                $num += $count;
           }
  
           $mean = ($num > 0) ? round($total / $num, 2) : 0;
           return $mean;
      }

◆ getMedian()

QuestionnaireDataView::getMedian ( $optionAnswers )

Definition at line 229 of file questionnaire_data_view.inc.

      {
           $median = 0.0;
           $index_1 = 0;
           $index_2 = 0;
  
           // determine if odd or even
           $no_elements = count($optionAnswers);
           //echo "no elements is $no_elements<br/>";
           $odd = $no_elements % 2;
  
           //odd take the middle number
           if ($odd == 1)
           {
                //determine the middle
                $the_index_1 = $no_elements / 2;
  
                //cast to integer
                settype($the_index_1, "integer");
  
                //calculate the median
                $median = $optionAnswers[$the_index_1]->option;
           }
           else
           {
                //determine the two middle numbers
                $the_index_1 = $no_elements / 2;
                $the_index_2 = $the_index_1 - 1;
  
                //calculate the median
                $median = ($optionAnswers[$the_index_1] + $optionAnswers[$the_index_2]) / 2;
           }
  
           return $median;
      }

◆ getOptionText()

QuestionnaireDataView::getOptionText ( $options )

Definition at line 191 of file questionnaire_data_view.inc.

      {
           $optionText = array();
  
           list($from, $to, $steps) = explode("\n", $options);
           if (!$from) $from = "Lowest";
           if (!$to) $to = "Highest";
           if (!$steps) $steps = 5;
  
           for($idx = 1; $idx <= $steps; ++$idx)
           {
                if($idx > 1 AND $idx < $steps)
                     $optionText[$idx] = $idx;
                else
                     $optionText[$idx] = ($idx == 1) ? $from : $to;
           }
           return $optionText;
      }

◆ getRatingsQuestionResultData()

QuestionnaireDataView::getRatingsQuestionResultData	(	$question,
		$answers
	)

Definition at line 163 of file questionnaire_data_view.inc.

      {
           $qPk = $this->mgr->getQuestionKey();
           if(count($answers) > 0)
                $answerValues = regroupList($answers, "value");
                
           $optionAnswers = array();
           $count = array();
           $optionText = $this->getOptionText($question->options);
           $steps = count($optionText);
  
           for($idx = 1; $idx <= $steps; ++$idx)
           {
                //echo "idx is $idx<br/>";
                // store for calculating mean and median
                $counts[$idx] = count($answerValues[$idx]);
                $optionAnswer = new OptionAnswer($question->$qPk, $idx, $optionText[$idx], $counts[$idx]);
                array_push($optionAnswers, $optionAnswer);
           }
  
           $mean = new OptionAnswer($question->$qPk, ++$idx, "Mean", $this->getMean($counts));
           //$median = new OptionAnswer($question->$qPk, ++$idx, "Median", $this->getMedian($optionAnswers));
           array_push($optionAnswers, $mean);
           //array_push($optionAnswers, $median);
  
           return $optionAnswers;
      }

◆ getSingleSelectQuestionResultData()

QuestionnaireDataView::getSingleSelectQuestionResultData	(	$question,
		$answers
	)

Definition at line 132 of file questionnaire_data_view.inc.

      {
           $qPk = $this->mgr->getQuestionKey();
           $options = explode("\n", $question->options);
           $idx = 1;
  
           if(count($options) > 0)
           {
                if(count($answers) > 0)
                $answerValues = regroupList($answers, "value");
                else
                $answerValues = array();
                $optionAnswers = array();
  
                foreach($options as $option)
                {
                     $count = count($answerValues[$idx]);
                     $optionAnswer = new OptionAnswer($question->$qPk, $idx, $option, $count);
                     array_push($optionAnswers, $optionAnswer);
                     $idx++;
                          
                }
                return $optionAnswers;
           }
      }

◆ QuestionnaireDataView()

QuestionnaireDataView::QuestionnaireDataView ( $mgr )

Definition at line 50 of file questionnaire_data_view.inc.

      {
           $this->mgr = $mgr;
           $this->survey = $this->mgr->item;
           $qPk = $this->mgr->getQuestionKey();
  
           $this->questionTypes = QuestionType::getQuestionTypeList();
  
           $this->questions = $this->mgr->getQuestions();
  
           if(count($this->questions) > 0)
                $answers = $this->mgr->getAnswers();
  
           if(count($answers) > 0)
           {
                $this->responseCount = $this->mgr->getResponseCount();
                $this->answers = regroupList($answers, $qPk);
  
                foreach($this->questions as $question)
                {
                     $answers = $this->answers[$question->$qPk];
                     $this->getAggregateData($question, $answers);
                }
           }
  
           $this->buildOptionDataView();
           $this->buildTextDataView();
      }

◆ writeScript()

QuestionnaireDataView::writeScript ( )

Definition at line 322 of file questionnaire_data_view.inc.

      {
           $script = $this->optionDataView->writeScript();
           $script .= $this->textDataView->writeScript();
           return $script;
      }