38 bool $a_call_by_reference =
true 41 $this->main_tpl = $DIC->ui()->mainTemplate();
43 $this->log = $DIC[
"ilLog"];
44 $this->db = $DIC->database();
45 $this->
user = $DIC->user();
46 $this->component_repository = $DIC[
"component.repository"];
49 $this->edit_manager = $DIC->surveyQuestionPool()
53 $this->domain = $DIC->surveyQuestionPool()->internal()->domain();
58 $id = parent::create();
68 if (!parent::update()) {
74 public function read(): void
82 $newObj = parent::cloneObject($target_id, $copy_id, $omit_tree);
87 if (!$cp_options->isRootNode($this->getRefId())) {
94 foreach ($questions as $question_id) {
95 $newObj->copyQuestion($question_id, $newObj->getId());
100 $new_md = $md->cloneMD($newObj->getId(), 0, $newObj->getType());
103 $newObj->updateMetaData();
111 string $question_type,
112 int $question_id = -1
114 if ((!$question_type) and ($question_id > 0)) {
118 $question_type_gui = $question_type .
"GUI";
119 $question =
new $question_type_gui();
121 if ($question_id > 0) {
122 $question->object->loadFromDb($question_id);
137 if ($question_gui->object->getObjId() === $questionpool_to) {
142 $newtitle = $question_gui->object->getTitle();
143 if ($question_gui->object->questionTitleExists($question_gui->object->getTitle(), $questionpool_to)) {
145 while ($question_gui->object->questionTitleExists($question_gui->object->getTitle() .
" ($counter)", $questionpool_to)) {
148 $newtitle = $question_gui->object->getTitle() .
" ($counter)";
150 $question_gui->object->copyObject($this->
getId(), $newtitle);
158 $result =
$ilDB->queryF(
159 "SELECT isonline FROM svy_qpl WHERE obj_fi = %s",
161 array($this->
getId())
163 if ($result->numRows() === 1) {
164 $row =
$ilDB->fetchAssoc($result);
165 $this->
setOnline((
bool) $row[
"isonline"]);
175 $result =
$ilDB->queryF(
176 "SELECT * FROM svy_qpl WHERE obj_fi = %s",
178 array($this->
getId())
180 if ($result->numRows() === 1) {
181 $affectedRows =
$ilDB->manipulateF(
182 "UPDATE svy_qpl SET isonline = %s, tstamp = %s WHERE obj_fi = %s",
183 array(
'text',
'integer',
'integer'),
187 $next_id =
$ilDB->nextId(
'svy_qpl');
188 $query =
$ilDB->manipulateF(
189 "INSERT INTO svy_qpl (id_questionpool, isonline, obj_fi, tstamp) VALUES (%s, %s, %s, %s)",
190 array(
'integer',
'text',
'integer',
'integer'),
196 public function delete():
bool 198 $remove = parent::delete();
216 $result =
$ilDB->queryF(
217 "SELECT question_id FROM svy_question WHERE obj_fi = %s AND original_id IS NULL",
219 array($this->
getId())
221 $found_questions = array();
222 while ($row =
$ilDB->fetchAssoc($result)) {
228 $directory = $spl_data_dir .
"/spl_" . $this->
getId();
229 if (is_dir($directory)) {
239 if ($question_id < 1) {
243 $question->delete($question_id);
253 if ($question_id < 1) {
256 $result =
$ilDB->queryF(
257 "SELECT svy_qtype.type_tag FROM svy_question, svy_qtype WHERE svy_question.questiontype_fi = svy_qtype.questiontype_id AND svy_question.question_id = %s",
261 if ($result->numRows() === 1) {
263 return $data[
"type_tag"];
274 public function isInUse(
int $question_id): ?array
278 $result =
$ilDB->queryF(
279 "SELECT answer_id FROM svy_answer WHERE question_fi = %s",
283 $answered = $result->numRows();
286 $result =
$ilDB->queryF(
287 "SELECT svy_svy.* FROM svy_svy, svy_svy_qst WHERE svy_svy_qst.survey_fi = svy_svy.survey_id AND svy_svy_qst.question_fi = %s",
291 $inserted = $result->numRows();
292 if (($inserted + $answered) === 0) {
295 $result_array = array();
296 while ($row =
$ilDB->fetchObject($result)) {
297 $result_array[] = $row;
299 return $result_array;
305 public function paste(
int $question_id): void
315 array $question_array
318 $result_array = array();
319 $result =
$ilDB->query(
"SELECT svy_question.*, svy_qtype.type_tag, svy_qtype.plugin FROM svy_question, svy_qtype WHERE svy_question.questiontype_fi = svy_qtype.questiontype_id AND svy_question.tstamp > 0 AND " .
$ilDB->in(
'svy_question.question_id', $question_array,
false,
'integer'));
320 while ($row =
$ilDB->fetchAssoc($result)) {
321 if ($row[
"plugin"]) {
324 $result_array[] = $row;
327 return $result_array;
341 while ($question->questionTitleExists($question->getTitle() . $suffix, $obj_id)) {
344 $suffix =
" ($counter)";
348 $question->setObjId($obj_id);
351 if (strlen($question->getTitle() . $suffix) > $max_len) {
352 $title = substr($question->getTitle(), 0, $max_len - strlen($suffix)) . $suffix;
354 $title = $question->getTitle() . $suffix;
356 $question->duplicate(
false,
$title, $ilUser->fullname, $ilUser->id);
368 if (count($arrFilter) > 0) {
369 foreach ($arrFilter as
$key => $value) {
370 $arrFilter[
$key] = str_replace(
'%',
'', $value);
372 if (array_key_exists(
'title', $arrFilter) && strlen($arrFilter[
'title'] ??
"")) {
373 $where .=
" AND " .
$ilDB->like(
'svy_question.title',
'text',
"%%" . $arrFilter[
'title'] .
"%%");
375 if (array_key_exists(
'description', $arrFilter) && strlen($arrFilter[
'description'] ??
"")) {
376 $where .=
" AND " .
$ilDB->like(
'svy_question.description',
'text',
"%%" . $arrFilter[
'description'] .
"%%");
378 if (array_key_exists(
'author', $arrFilter) && strlen($arrFilter[
'author'] ??
"")) {
379 $where .=
" AND " .
$ilDB->like(
'svy_question.author',
'text',
"%%" . $arrFilter[
'author'] .
"%%");
381 if (array_key_exists(
'type', $arrFilter) && strlen($arrFilter[
'type'] ??
"")) {
382 $where .=
" AND svy_qtype.type_tag = " .
$ilDB->quote($arrFilter[
'type'],
'text');
385 $query_result =
$ilDB->queryF(
386 "SELECT svy_question.*, svy_qtype.type_tag, svy_qtype.plugin FROM svy_question, svy_qtype WHERE svy_question.original_id IS NULL AND svy_question.tstamp > 0 AND svy_question.questiontype_fi = svy_qtype.questiontype_id AND svy_question.obj_fi = %s" . $where,
388 array($this->
getId())
391 if ($query_result->numRows()) {
392 while ($row =
$ilDB->fetchAssoc($query_result)) {
393 if ($row[
"plugin"]) {
412 if (!is_writable($spl_data_dir)) {
413 throw new ilSurveyException(
"Survey Questionpool Data Directory (" . $spl_data_dir .
") not writeable.");
417 $spl_dir = $spl_data_dir .
"/spl_" . $this->
getId();
419 if (!is_dir($spl_dir)) {
420 throw new ilSurveyException(
"Creation of Survey Questionpool Directory failed.");
423 $export_dir = $spl_dir .
"/export";
425 if (!is_dir($export_dir)) {
426 throw new ilSurveyException(
"Creation of Survey Questionpool Export Directory failed.");
446 !is_writable($dir)) {
457 while ($entry = $dir->read()) {
458 if ($entry !==
"." &&
460 preg_match(
"/^[0-9]{10}__[0-9]+__(spl_)*[0-9]+\.[A-Za-z]{3}$/", $entry)) {
483 if (!is_writable($spl_data_dir)) {
484 throw new ilSurveyException(
"Survey Questionpool Data Directory (" . $spl_data_dir .
") not writeable.");
488 $spl_dir = $spl_data_dir .
"/spl_" . $this->
getId();
490 if (!is_dir($spl_dir)) {
491 throw new ilSurveyException(
"Creation of Survey Questionpool Directory failed.");
495 $import_dir = $spl_dir .
"/import";
497 if (!is_dir($import_dir)) {
498 throw new ilSurveyException(
"Creation of Survey Questionpool Import Directory failed.");
505 "/spl_" . $this->
getId() .
"/import";
512 public function toXML(?array $questions): string
514 if (is_null($questions) || count($questions) === 0) {
519 $a_xml_writer->xmlHeader();
521 "xmlns:xsi" =>
"http://www.w3.org/2001/XMLSchema-instance",
522 "xsi:noNamespaceSchemaLocation" =>
"https://www.ilias.de/download/xsd/ilias_survey_4_2.xsd" 524 $a_xml_writer->xmlStartTag(
"surveyobject", $attrs);
526 "id" =>
"qpl_" . $this->
getId(),
530 $a_xml_writer->xmlStartTag(
"surveyquestions", $attrs);
531 $a_xml_writer->xmlElement(
"dummy", null,
"dummy");
533 $a_xml_writer->xmlStartTag(
"metadata");
534 $a_xml_writer->xmlStartTag(
"metadatafield");
535 $a_xml_writer->xmlElement(
"fieldlabel", null,
"SCORM");
539 $metadata = $writer->xmlDumpMem();
540 $a_xml_writer->xmlElement(
"fieldentry", null, $metadata);
541 $a_xml_writer->xmlEndTag(
"metadatafield");
542 $a_xml_writer->xmlEndTag(
"metadata");
544 $a_xml_writer->xmlEndTag(
"surveyquestions");
545 $a_xml_writer->xmlEndTag(
"surveyobject");
547 $xml = $a_xml_writer->xmlDumpMem(
false);
550 foreach ($questions as
$key => $value) {
553 $question =
new $questiontype();
554 $question->loadFromDb($value);
555 $questionxml .= $question->toXML(
false);
558 $xml = str_replace(
"<dummy>dummy</dummy>", $questionxml, $xml);
565 $questions = array();
566 $result =
$ilDB->queryF(
567 "SELECT question_id FROM svy_question WHERE obj_fi = %s AND svy_question.tstamp > 0 AND original_id IS NULL",
569 array($this->
getId())
571 if ($result->numRows()) {
572 while ($row =
$ilDB->fetchAssoc($result)) {
573 $questions[] = $row[
"question_id"];
586 bool $spl_exists =
false 588 if (is_file($source)) {
589 $isZip = (strcmp(strtolower(substr($source, -3)),
'zip') === 0);
592 $this->domain->resources()->zip()->unzipFile($source);
595 $subdir = basename($source,
".zip");
596 $source = dirname($source) .
"/" . $subdir .
"/" . $subdir .
".xml";
599 $fh = fopen($source,
'rb') or die(
"");
600 $xml = fread($fh, filesize($source));
601 fclose($fh) or die(
"");
603 $subdir = basename($source,
".zip");
604 if (is_dir(dirname($source) .
"/" . $subdir)) {
608 if (strpos($xml,
"questestinterop") > 0) {
614 $import->setXMLContent($xml);
615 $import->startParsing();
621 bool $a_online_status
625 $status = (string) (
int) $a_online_status;
626 $db = $DIC->database();
629 "UPDATE svy_qpl SET isonline = %s WHERE obj_fi = %s",
630 array(
'text',
'integer'),
631 array($status, $a_obj_id)
637 $this->online = $a_online_status;
649 $ilDB = $DIC->database();
651 $result =
$ilDB->queryF(
652 "SELECT isonline FROM svy_qpl WHERE obj_fi = %s",
656 if ($row =
$ilDB->fetchAssoc($result)) {
657 return (
bool) $row[
"isonline"];
671 $rbacsystem = $DIC->rbac()->system();
674 foreach ($refs as $ref) {
690 $ilDB = $DIC->database();
691 $lng = $DIC->language();
695 $query_result =
$ilDB->query(
"SELECT * FROM svy_qtype ORDER BY type_tag");
696 while ($row =
$ilDB->fetchAssoc($query_result)) {
698 if ((
int) $row[
"plugin"] === 0) {
699 $types[
$lng->
txt($row[
"type_tag"])] = $row;
707 $default_sorting = array_flip(array(
708 "SurveySingleChoiceQuestion",
709 "SurveyMultipleChoiceQuestion",
710 "SurveyMatrixQuestion",
711 "SurveyMetricQuestion",
716 $idx = count($default_sorting);
717 foreach ($types as $caption => $item) {
718 $type = $item[
"type_tag"];
719 $item[
"caption"] = $caption;
722 if (array_key_exists(
$type, $default_sorting)) {
723 $sorted[$default_sorting[
$type]] = $item;
727 $sorted[$idx] = $item;
735 foreach ($sorted as $item) {
736 $types[$item[
"caption"]] = $item;
744 $classes = array_map(
745 static function (array
$c):
string {
746 return $c[
"type_tag"];
748 self::_getQuestiontypes()
760 $ilDB = $DIC->database();
761 $lng = $DIC->language();
763 $component_factory = $DIC[
"component.factory"];
766 $result =
$ilDB->query(
"SELECT * FROM svy_qtype");
768 while ($row =
$ilDB->fetchAssoc($result)) {
769 if ((
int) $row[
"plugin"] === 0) {
770 $types[$row[
'type_tag']] =
$lng->
txt($row[
"type_tag"]);
782 bool $use_object_id =
false,
783 bool $could_be_offline =
false,
784 bool $showPath =
false,
785 string $permission =
"read" 789 $ilUser = $DIC->user();
792 $ilDB = $DIC->database();
794 $result_array = array();
798 $result =
$ilDB->query(
"SELECT obj_fi, isonline FROM svy_qpl");
799 while ($row =
$ilDB->fetchAssoc($result)) {
800 $allqpls[$row[
'obj_fi']] = $row[
'isonline'];
804 if ($could_be_offline || ($allqpls[$obj_id] ?? 0) == 1) {
805 if ($use_object_id) {
806 $result_array[$obj_id] = $titles[
$ref_id];
808 $result_array[(
int) $ref_id] = $titles[$ref_id];
812 return $result_array;
826 $query_result =
$ilDB->query(
"SELECT svy_question.*, svy_qtype.type_tag FROM svy_question, svy_qtype " .
827 "WHERE svy_question.questiontype_fi = svy_qtype.questiontype_id " .
828 "AND svy_question.tstamp > 0 AND " .
$ilDB->in(
'svy_question.question_id', $question_ids,
false,
'integer') .
" " .
829 "ORDER BY svy_question.title");
830 if ($query_result->numRows() > 0) {
831 while (
$data =
$ilDB->fetchAssoc($query_result)) {
832 if (in_array(
$data[
"question_id"], $question_ids)) {
833 $found[] = array(
'id' =>
$data[
"question_id"],
834 'title' =>
$data[
"title"],
835 'description' =>
$data[
"description"],
836 'type_tag' =>
$data[
"type_tag"]
852 $result =
$ilDB->queryF(
853 "SELECT question_id FROM svy_question WHERE owner_fi = %s AND tstamp = %s",
854 array(
"integer",
"integer"),
855 array($ilUser->getId(), 0)
869 $this->edit_manager->addQuestionToClipboard($question_id,
"copy");
878 $this->edit_manager->addQuestionToClipboard($question_id,
"move");
888 $qentries = $this->edit_manager->getQuestionsFromClipboard();
889 if (count($qentries) > 0) {
890 foreach ($qentries as $question_object) {
891 if (strcmp($question_object[
"action"],
"move") === 0) {
892 $result =
$ilDB->queryF(
893 "SELECT obj_fi FROM svy_question WHERE question_id = %s",
895 array($question_object[
"question_id"])
897 if ($result->numRows() === 1) {
898 $row =
$ilDB->fetchAssoc($result);
899 $source_questionpool = $row[
"obj_fi"];
900 if ($this->
getId() != $source_questionpool) {
902 $affectedRows =
$ilDB->manipulateF(
903 "UPDATE svy_question SET obj_fi = %s WHERE question_id = %s",
904 array(
'integer',
'integer'),
905 array($this->
getId(), $question_object[
"question_id"])
909 $source_path =
CLIENT_WEB_DIR .
"/survey/" . $source_questionpool .
"/" . $question_object[
"question_id"] .
"/";
910 if (is_dir($source_path)) {
912 if (!is_dir($target_path)) {
918 $this->main_tpl->setOnScreenMessage(
'failure', $this->
lng->txt(
"spl_move_same_pool"),
true);
927 $this->main_tpl->setOnScreenMessage(
'success', $this->
lng->txt(
"spl_paste_success"),
true);
928 $this->edit_manager->clearClipboardQuestions();
935 array $obligatory_questions
939 $status = (
int) (isset($obligatory_questions[
"$question_id"]));
941 $ilDB->manipulate(
"UPDATE svy_question" .
942 " SET obligatory = " .
$ilDB->quote($status,
"integer") .
943 " WHERE question_id = " .
$ilDB->quote($question_id,
"integer"));
removeQuestion(int $question_id)
Removes a question from the question pool.
cloneObject(int $target_id, int $copy_id=0, bool $omit_tree=false)
Readable part of repository interface to ilComponentDataDB.
setOnline(bool $a_online_status)
manipulateF(string $query, array $types, array $values)
txt(string $a_topic, string $a_default_lang_fallback_mod="")
gets the text for a given topic if the topic is not in the list, the topic itself with "-" will be re...
Class ilObjSurveyQuestionPool.
getQuestionInfos(array $question_ids)
Returns title, description and type for an array of question id's.
InternalDomainService $domain
__construct(int $a_id=0, bool $a_call_by_reference=true)
static _getAllReferences(int $id)
get all reference ids for object ID
createImportDirectory()
creates data directory for import files (data_dir/spl_data/spl_<id>/import
getExportDirectory()
get export directory of survey
duplicateQuestion(int $question_id, int $obj_id=0)
Duplicates a question for a question pool.
copyQuestion(int $question_id, int $questionpool_to)
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Le...
static _hasUntrashedReference(int $obj_id)
checks whether an object has at least one reference that is not in trash
static _getAvailableQuestionpools(bool $use_object_id=false, bool $could_be_offline=false, bool $showPath=false, string $permission="read")
Returns the available question pools for the active user.
getQuestiontype(int $question_id)
isInUse(int $question_id)
Checks if a question is in use by a survey.
loadLanguageModule(string $a_module)
Load language module.
static _setOnline(int $a_obj_id, bool $a_online_status)
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Le...
static _getQuestionTypeTranslations()
purgeQuestions()
Remove all questions with tstamp = 0.
ilGlobalTemplateInterface $main_tpl
static makeDirParents(string $a_dir)
Create a new directory and all parent directories.
createQuestion(string $question_type, int $question_id=-1)
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Le...
static _isWriteable(int $object_id)
Returns true, if the question pool is writeable for the current user.
EditManager $edit_manager
moveToClipboard(int $question_id)
Moves a question to the clipboard.
static _prepareCloneSelection(array $ref_ids, string $new_type, bool $show_path=true)
Prepare copy wizard object selection.
static delDir(string $a_dir, bool $a_clean_only=false)
removes a dir and all its content (subdirs and files) recursively
static _lookupObjectId(int $ref_id)
getQuestionsInfo(array $question_array)
static _includeClass(string $question_type, int $gui=0)
Include the php class file for a given question type.
static _lookupOnline(int $a_obj_id)
static _getObjectsByOperations( $a_obj_type, string $a_operation, int $a_usr_id=0, int $limit=0)
Get all objects of a specific type and check access This function is not recursive, instead it parses the serialized rbac_pa entries.
static getDataDir()
get data directory (outside webspace)
importObject(string $source, bool $spl_exists=false)
Imports survey questions into ILIAS.
pasteFromClipboard()
Copies/Moves a question from the clipboard.
paste(int $question_id)
Pastes a duplicate of a question in the question pool.
getQuestionsData(array $arrFilter)
Retrieve the data for the output of the question pool.
Manages editing processes/repos.
getExportFiles(string $dir)
get export files
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Le...
static _getQuestiontypes()
Get all available question types.
$id
plugin.php for ilComponentBuildPluginInfoObjectiveTest::testAddPlugins
setObligatoryStates(array $obligatory_questions)
copyToClipboard(int $question_id)
Copies a question to the clipboard.
static _getQuestionClasses()
static rename(string $a_source, string $a_target)
static _getInstance(int $a_copy_id)
toXML(?array $questions)
export questions to xml
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Le...
static _instanciateQuestion(int $question_id)
Get question object.
Basic class for all survey question types The SurveyQuestionGUI class defines and encapsulates basic ...
createExportDirectory()
creates data directory for export files data_dir/spl_data/spl_<id>/export
ilComponentRepository $component_repository
static makeDir(string $a_dir)
creates a new directory and inherits all filesystem permissions of the parent directory You may pass ...