Inheritance diagram for ilTestQuestionBrowserTableGUI:

Collaboration diagram for ilTestQuestionBrowserTableGUI:

Public Member Functions
	__construct (ilCtrl $ctrl, ilGlobalTemplateInterface $mainTpl, ilTabsGUI $tabs, ilLanguage $lng, ilTree $tree, ilDBInterface $db, ilPluginAdmin $pluginAdmin, ilObjTest $testOBJ, ilAccessHandler $access)
	ilTestQuestionBrowserTableGUI constructor. More...

	setWriteAccess ($value)

	hasWriteAccess ()

	init ()

	executeCommand ()
	Execute command. More...

	initFilter ()
	Init filter. More...

	fillRow ($data)
	Standard Version of Fill Row. More...

Public Member Functions inherited from ilTable2GUI
	__construct ($a_parent_obj, $a_parent_cmd="", $a_template_context="")
	ilTable2GUI constructor. More...

	setOpenFormTag ($a_val)
	Set open form tag. More...

	getOpenFormTag ()
	Get open form tag. More...

	setCloseFormTag ($a_val)
	Set close form tag. More...

	getCloseFormTag ()
	Get close form tag. More...

	determineLimit ()
	Determine the limit. More...

	getSelectableColumns ()
	Get selectable columns. More...

	determineSelectedColumns ()
	Determine selected columns. More...

	isColumnSelected ($a_col)
	Is given column selected? More...

	getSelectedColumns ()
	Get selected columns. More...

	executeCommand ()
	Execute command. More...

	resetOffset ($a_in_determination=false)
	Reset offset. More...

	initFilter ()
	Init filter. More...

	getParentObject ()
	Get parent object. More...

	getParentCmd ()
	Get parent command. More...

	setTopAnchor ($a_val)
	Set top anchor. More...

	getTopAnchor ()
	Get top anchor. More...

	setNoEntriesText ($a_text)
	Set text for an empty table. More...

	getNoEntriesText ()
	Get text for an empty table. More...

	setIsDataTable ($a_val)
	Set is data table. More...

	getIsDataTable ()
	Get is data table. More...

	setEnableTitle ($a_enabletitle)
	Set Enable Title. More...

	getEnableTitle ()
	Get Enable Title. More...

	setEnableHeader ($a_enableheader)
	Set Enable Header. More...

	getEnableHeader ()
	Get Enable Header. More...

	setEnableNumInfo ($a_val)
	Set enable num info. More...

	getEnableNumInfo ()
	Get enable num info. More...

	setTitle ($a_title, $a_icon=0, $a_icon_alt=0)
	Set title and title icon. More...

	setDescription ($a_val)
	Set description. More...

	getDescription ()
	Get description. More...

	setOrderField ($a_order_field)
	set order column More...

	getOrderField ()

	setData ($a_data)
	set table data @access public More...

	getData ()

	dataExists ()

	setPrefix ($a_prefix)
	set prefix for sort and offset fields (if you have two or more tables on a page that you want to sort separately) @access public More...

	getPrefix ()

	addFilterItem ($a_input_item, $a_optional=false)
	Add filter item. More...

	addFilterItemByMetaType ($id, $type=self::FILTER_TEXT, $a_optional=false, $caption=null)
	Add filter by standard type. More...

	getFilterItems ($a_optionals=false)
	Get filter items. More...

	getFilterItemByPostVar ($a_post_var)

	setFilterCols ($a_val)
	Set filter columns. More...

	getFilterCols ()
	Get filter columns. More...

	setDisableFilterHiding ($a_val=true)
	Set disable filter hiding. More...

	getDisableFilterHiding ()
	Get disable filter hiding. More...

	isFilterSelected ($a_col)
	Is given filter selected? More...

	getSelectedFilters ()
	Get selected filters. More...

	determineSelectedFilters ()
	Determine selected filters. More...

	setCustomPreviousNext ($a_prev_link, $a_next_link)
	Set custom previous/next links. More...

	setFormAction ($a_form_action, $a_multipart=false)
	Set Form action parameter. More...

	getFormAction ()
	Get Form action parameter. More...

	setFormName ($a_formname="")
	Set Form name. More...

	getFormName ()
	Get Form name. More...

	setId ($a_val)
	Set id. More...

	getId ()
	Get element id. More...

	setDisplayAsBlock ($a_val)
	Set display as block. More...

	getDisplayAsBlock ()
	Get display as block. More...

	getSelectAllCheckbox ()
	Get the name of the checkbox that should be toggled with a select all button. More...

	setSelectAllCheckbox ($a_select_all_checkbox, $a_select_all_on_top=false)
	Set the name of the checkbox that should be toggled with a select all button. More...

	setExternalSorting ($a_val)
	Set external sorting. More...

	getExternalSorting ()
	Get external sorting. More...

	setFilterCommand ($a_val, $a_caption=null)
	Set filter command. More...

	getFilterCommand ()
	Get filter command. More...

	setResetCommand ($a_val, $a_caption=null)
	Set reset filter command. More...

	getResetCommand ()
	Get reset filter command. More...

	setExternalSegmentation ($a_val)
	Set external segmentation. More...

	getExternalSegmentation ()
	Get external segmentation. More...

	setRowTemplate ($a_template, $a_template_dir="")
	Set row template. More...

	setDefaultOrderField ($a_defaultorderfield)
	Set Default order field. More...

	getDefaultOrderField ()
	Get Default order field. More...

	setDefaultOrderDirection ($a_defaultorderdirection)
	Set Default order direction. More...

	getDefaultOrderDirection ()
	Get Default order direction. More...

	setDefaultFilterVisiblity ($a_status)
	Set default filter visiblity. More...

	getDefaultFilterVisibility ()
	Get default filter visibility. More...

	clearCommandButtons ()

	addCommandButton ($a_cmd, $a_text, $a_onclick='', $a_id="", $a_class=null)
	Add Command button. More...

	addCommandButtonInstance (ilButtonBase $a_button)
	Add Command button instance. More...

	addSelectionButton ($a_sel_var, $a_options, $a_cmd, $a_text, $a_default_selection='')
	Add Selection List + Command button. More...

	addMultiItemSelectionButton ($a_sel_var, $a_options, $a_cmd, $a_text, $a_default_selection='')
	Add Selection List + Command button for selected items. More...

	setCloseCommand ($a_link)
	Add command for closing table. More...

	addMultiCommand ($a_cmd, $a_text)
	Add Command button. More...

	addHiddenInput ($a_name, $a_value)
	Add Hidden Input field. More...

	addHeaderCommand ($a_href, $a_text, $a_target="", $a_img="")
	Add Header Command (Link) (Image needed for now) More...

	setTopCommands ($a_val)
	Set top commands (display command buttons on top of table, too) More...

	getTopCommands ()
	Get top commands (display command buttons on top of table, too) More...

	addColumn ( $a_text, $a_sort_field="", $a_width="", $a_is_checkbox_action_column=false, $a_class="", $a_tooltip="", $a_tooltip_with_html=false)
	Add a column to the header. More...

	getNavParameter ()

	setOrderLink ($sort_field, $order_dir)

	fillHeader ()

	determineOffsetAndOrder ($a_omit_offset=false)
	Determine offset and order. More...

	storeNavParameter ()

	getHTML ()
	Get HTML. More...

	numericOrdering ($a_field)
	Should this field be sorted numeric? More...

	render ()
	render table @access public More...

	writeFilterToSession ()
	Write filter values to session. More...

	resetFilter ()
	Reset filter. More...

	fillFooter ()
	Fill footer row. More...

	getLinkbar ($a_num)
	Get previous/next linkbar. More...

	fillHiddenRow ()

	fillActionRow ()
	Fill Action Row. More...

	setHeaderHTML ($html)
	set header html More...

	storeProperty ($type, $value)
	Store table property. More...

	loadProperty ($type)
	Load table property. More...

	getCurrentState ()
	get current settings for order, limit, columns and filter More...

	setContext ($id)
	Set context. More...

	getContext ()
	Get context. More...

	setShowRowsSelector ($a_value)
	Toggle rows-per-page selector. More...

	getShowRowsSelector ()
	Get rows-per-page selector state. More...

	setShowTemplates ($a_value)
	Toggle templates. More...

	getShowTemplates ()
	Get template state. More...

	restoreTemplate ($a_name)
	Restore state from template. More...

	saveTemplate ($a_name)
	Save current state as template. More...

	deleteTemplate ($a_name)
	Delete template. More...

	getLimit ()
	Get limit. More...

	getOffset ()
	Get offset. More...

	setExportFormats (array $formats)
	Set available export formats. More...

	setPrintMode ($a_value=false)
	Toogle print mode. More...

	getPrintMode ()
	Get print mode. More...

	getExportMode ()
	Was export activated? More...

	exportData ($format, $send=false)
	Export and optionally send current table data. More...

	setEnableAllCommand ($a_value)
	Enable actions for all entries in current result. More...

	setRowSelectorLabel ($row_selector_label)

	getRowSelectorLabel ()

	setPreventDoubleSubmission ($a_val)
	Set prevent double submission. More...

	getPreventDoubleSubmission ()
	Get prevent double submission. More...

	setLimit ($a_limit=0, $a_default_limit=0)
	set max. More...

Public Member Functions inherited from ilTableGUI
	__construct ($a_data=0, $a_global_tpl=true)
	Constructor. More...

	setTemplate ($a_tpl)
	set template @access public More...

&	getTemplateObject ()

	setData ($a_data)
	set table data @access public More...

	getData ()

	setTitle ($a_title, $a_icon=0, $a_icon_alt=0)
	set table title @access public More...

	setHelp ($a_help_page, $a_help_icon, $a_help_icon_alt=0)
	set table help page @access public More...

	setHeaderNames ($a_header_names)
	set table header names @access public More...

	getColumnCount ()
	Returns the column count based on the number of the header row columns @access public. More...

	setHeaderVars ($a_header_vars, $a_header_params=0)
	set table header vars @access public More...

	setColumnWidth ($a_column_width)
	set table column widths @access public More...

	setOneColumnWidth ($a_column_width, $a_column_number)
	set one table column width @access public More...

	setMaxCount ($a_max_count)
	set max. More...

	setLimit ($a_limit=0, $a_default_limit=0)
	set max. More...

	getLimit ()
	Get limit. More...

	setPrefix ($a_prefix)
	set prefix for sort and offset fields (if you have two or more tables on a page that you want to sort separately) @access public More...

	setOffset ($a_offset)
	set dataset offset @access public More...

	getOffset ()
	Get offset. More...

	setOrderColumn ($a_order_column=0, $a_default_column=0)
	set order column @access public More...

	getOrderColumn ()
	Get order column. More...

	setOrderDirection ($a_order_direction)
	set order direction @access public More...

	getOrderDirection ()
	Get order direction. More...

	setFooter ($a_style, $a_previous=0, $a_next=0)
	set order direction @access public More...

	enable ($a_module_name)
	enables particular modules of table More...

	disable ($a_module_name)
	diesables particular modules of table More...

	sortData ()

	render ()
	render table @access public More...

	renderHeader ()

	setOrderLink ($key, $order_dir)

	setStyle ($a_element, $a_style)

	getStyle ($a_element)

	setBase ($a_base)
	Set Base script name (deprecated, only use this for workarounds). More...

	getBase ()
	Get Base script name (deprecated, only use this for workarounds). More...

	getFormName ()

	setFormName ($a_name="cmd")

	getSelectAllCheckbox ()

	setSelectAllCheckbox ($a_select_all_checkbox)

	clearActionButtons ()

	addActionButton ($btn_name, $btn_value)

Data Fields
const	REPOSITORY_ROOT_NODE_ID = 1

const	CONTEXT_PARAMETER = 'question_browse_context'

const	CONTEXT_PAGE_VIEW = 'contextPageView'

const	CONTEXT_LIST_VIEW = 'contextListView'

const	MODE_PARAMETER = 'question_browse_mode'

const	MODE_BROWSE_POOLS = 'modeBrowsePools'

const	MODE_BROWSE_TESTS = 'modeBrowseTests'

const	CMD_BROWSE_QUESTIONS = 'browseQuestions'

const	CMD_APPLY_FILTER = 'applyFilter'

const	CMD_RESET_FILTER = 'resetFilter'

const	CMD_INSERT_QUESTIONS = 'insertQuestions'

Data Fields inherited from ilTable2GUI
const	FILTER_TEXT = 1

const	FILTER_SELECT = 2

const	FILTER_DATE = 3

const	FILTER_LANGUAGE = 4

const	FILTER_NUMBER_RANGE = 5

const	FILTER_DATE_RANGE = 6

const	FILTER_DURATION_RANGE = 7

const	FILTER_DATETIME_RANGE = 8

const	FILTER_CHECKBOX = 9

const	EXPORT_EXCEL = 1

const	EXPORT_CSV = 2

const	ACTION_ALL_LIMIT = 1000

Data Fields inherited from ilTableGUI
	$title

	$icon

	$icon_alt

	$help_page

	$help_icon

	$help_icon_alt

	$header_names

	$header_vars

	$linkbar_vars

	$data

	$column_count

	$column_width

	$max_count

	$limit

	$max_limit = false

	$offset

	$order_column

	$order_direction

	$footer_style

	$footer_previous

	$footer_next

	$lang_support = true

	$global_tpl

	$form_name

	$select_all_checkbox

	$action_buttons

	$prefix

	$base = ""

	$enabled

	$styles

Protected Member Functions
	getTranslatedLifecycle ($lifecycle)

Protected Member Functions inherited from ilTable2GUI
	prepareOutput ()
	Anything that must be done before HTML is generated. More...

	isFilterVisible ()
	Check if filter is visible: manually shown (session, db) or default value set. More...

	isAdvMDFilter (ilAdvancedMDRecordGUI $a_gui, $a_element)
	Check if filter element is based on adv md. More...

	fillRow ($a_set)
	Standard Version of Fill Row. More...

	getFilterValue (ilFormPropertyGUI $a_item)
	Get current filter value. More...

	SetFilterValue (ilFormPropertyGUI $a_item, $a_value)
	Set current filter value. More...

	fillMetaExcel (ilExcel $a_excel, &$a_row)
	Add meta information to excel export. More...

	fillHeaderExcel (ilExcel $a_excel, &$a_row)
	Excel Version of Fill Header. More...

	fillRowExcel (ilExcel $a_excel, &$a_row, $a_set)
	Excel Version of Fill Row. More...

	fillMetaCSV ($a_csv)
	Add meta information to csv export. More...

	fillHeaderCSV ($a_csv)
	CSV Version of Fill Header. More...

	fillRowCSV ($a_csv, $a_set)
	CSV Version of Fill Row. More...

Protected Attributes
	$writeAccess = false

	$ctrl

	$mainTpl

	$tabs

	$lng

	$tree

	$db

	$pluginAdmin

	$testOBJ

	$access

Protected Attributes inherited from ilTable2GUI
	$ctrl

	$tpl

	$parent_obj

	$parent_cmd

	$close_command = ""

	$top_anchor = "il_table_top"

	$filters = array()

	$optional_filters = array()

	$filter_cmd = 'applyFilter'

	$reset_cmd = 'resetFilter'

	$filter_cols = 5

	$ext_sort = false

	$ext_seg = false

	$context = ""

	$mi_sel_buttons = []

	$disable_filter_hiding = false

	$selected_filter = false

	$top_commands = true

	$selectable_columns = array()

	$selected_column = array()

	$show_templates = false

	$show_rows_selector = true

	$rows_selector_off = false

	$nav_determined = false

	$limit_determined = false

	$filters_determined = false

	$columns_determined = false

	$open_form_tag = true

	$close_form_tag = true

	$export_formats = []

	$export_mode

	$print_mode

	$enable_command_for_all

	$restore_filter

	$restore_filter_values

	$default_filter_visibility = false

	$sortable_fields = array()

	$prevent_double_submission = true

	$row_selector_label

	$select_all_on_top = false

	$sel_buttons = []

Protected Attributes inherited from ilTableGUI
	$tpl

	$lng

Private Member Functions
	browseQuestionsCmd ()

	applyFilterCmd ()

	resetFilterCmd ()

	insertQuestionsCmd ()

	handleParameters ()

	fetchContextParameter ()

	fetchModeParameter ()

	handleTabs ()

	getBackTargetLabel ()

	getBackTargetUrl ()

	getBackTargetCmdClass ()

	getBackTargetCommand ()

	getBrowseQuestionsTabLabel ()

	getBrowseQuestionsTabUrl ()

	getParentObjectLabel ()

	buildTestQuestionSetConfig ()

	getQuestionsData ()

	getQuestionInstanceTypeFilter ()

	getQuestionParentObjIds ($repositoryRootNode)

	getQuestionParentObjectType ()

Additional Inherited Members
Static Public Member Functions inherited from ilTable2GUI
static	getAllCommandLimit ()
	Get maximum number of entries to enable actions for all. More...

Detailed Description

Author: Helmut Schottmüller ilias.nosp@m.@aur.nosp@m.ealis.nosp@m..de

Version: $Id$

@ilCtrl_Calls ilTestQuestionBrowserTableGUI: ilFormPropertyDispatchGUI @ilCtrl_Calls ilTestQuestionBrowserTableGUI: ilTestQuestionBrowserTableGUI

Definition at line 18 of file class.ilTestQuestionBrowserTableGUI.php.

Constructor & Destructor Documentation

◆ __construct()

ilTestQuestionBrowserTableGUI::__construct	(	ilCtrl	$ctrl,
		ilGlobalTemplateInterface	$mainTpl,
		ilTabsGUI	$tabs,
		ilLanguage	$lng,
		ilTree	$tree,
		ilDBInterface	$db,
		ilPluginAdmin	$pluginAdmin,
		ilObjTest	$testOBJ,
		ilAccessHandler	$access
	)

ilTestQuestionBrowserTableGUI constructor.

Parameters

ilCtrl	$ctrl
ilGlobalTemplateInterface	$mainTpl
ilTabsGUI	$tabs
ilLanguage	$lng
ilTree	$tree
ilDBInterface	$db
ilPluginAdmin	$pluginAdmin
ilObjTest	$testOBJ
ilAccessHandler	$access

Definition at line 94 of file class.ilTestQuestionBrowserTableGUI.php.

      {
        $this->ctrl = $ctrl;
        $this->mainTpl = $mainTpl;
        $this->tabs = $tabs;
        $this->lng = $lng;
        $this->tree = $tree;
        $this->db = $db;
        $this->pluginAdmin = $pluginAdmin;
        $this->testOBJ = $testOBJ;
        $this->access = $access;
 
        $this->setId('qpl_brows_tabl_' . $this->testOBJ->getId());
 
        parent::__construct($this, self::CMD_BROWSE_QUESTIONS);
        $this->setFilterCommand(self::CMD_APPLY_FILTER);
        $this->setResetCommand(self::CMD_RESET_FILTER);
    
        $this->setFormName('questionbrowser');
        $this->setStyle('table', 'fullwidth');
        $this->addColumn('', '', '1%', true);
        $this->addColumn($this->lng->txt("tst_question_title"), 'title', '');
        $this->addColumn($this->lng->txt("description"), 'description', '');
        $this->addColumn($this->lng->txt("tst_question_type"), 'ttype', '');
        $this->addColumn($this->lng->txt("author"), 'author', '');
        $this->addColumn($this->lng->txt('qst_lifecycle'), 'lifecycle', '');
        $this->addColumn($this->lng->txt("create_date"), 'created', '');
        $this->addColumn($this->lng->txt("last_update"), 'tstamp', '');  // name of col is proper "updated" but in data array the key is "tstamp"
        $this->addColumn($this->getParentObjectLabel(), 'qpl', '');
        $this->addColumn($this->lng->txt("working_time"), 'working_time', '');
        $this->setSelectAllCheckbox('q_id');
        $this->setRowTemplate("tpl.il_as_tst_question_browser_row.html", "Modules/Test");
 
        $this->setFormAction($this->ctrl->getFormAction($this->getParentObject(), $this->getParentCmd()));
        $this->setDefaultOrderField("title");
        $this->setDefaultOrderDirection("asc");
        
        $this->enable('sort');
        //$this->enable('header');
        $this->enable('select_all');
        $this->initFilter();
        $this->setDisableFilterHiding(true);
    }

References $access, $ctrl, $db, $lng, $mainTpl, $pluginAdmin, $tabs, $testOBJ, $tree, ILIAS\GlobalScreen\Provider\__construct(), ilTable2GUI\addColumn(), ilTableGUI\enable(), getParentObjectLabel(), initFilter(), ilTable2GUI\setDefaultOrderDirection(), ilTable2GUI\setDefaultOrderField(), ilTable2GUI\setDisableFilterHiding(), ilTable2GUI\setFilterCommand(), ilTable2GUI\setFormAction(), ilTable2GUI\setFormName(), ilTable2GUI\setId(), ilTable2GUI\setResetCommand(), ilTable2GUI\setRowTemplate(), ilTable2GUI\setSelectAllCheckbox(), and ilTableGUI\setStyle().

Here is the call graph for this function:

Member Function Documentation

◆ applyFilterCmd()

ilTestQuestionBrowserTableGUI::applyFilterCmd ( )

private

Definition at line 190 of file class.ilTestQuestionBrowserTableGUI.php.

    {
        $this->writeFilterToSession();
        $this->ctrl->redirect($this, self::CMD_BROWSE_QUESTIONS);
    }

References ilTable2GUI\writeFilterToSession().

Here is the call graph for this function:

◆ browseQuestionsCmd()

ilTestQuestionBrowserTableGUI::browseQuestionsCmd ( )

private

Definition at line 183 of file class.ilTestQuestionBrowserTableGUI.php.

    {
        $this->setData($this->getQuestionsData());
        
        $this->mainTpl->setContent($this->ctrl->getHTML($this));
    }

References getQuestionsData(), and ilTable2GUI\setData().

Here is the call graph for this function:

◆ buildTestQuestionSetConfig()

ilTestQuestionBrowserTableGUI::buildTestQuestionSetConfig ( )

private

Returns: ilTestQuestionSetConfig

Definition at line 478 of file class.ilTestQuestionBrowserTableGUI.php.

    {
        require_once 'Modules/Test/classes/class.ilTestQuestionSetConfigFactory.php';
        
        $testQuestionSetConfigFactory = new ilTestQuestionSetConfigFactory(
            $this->tree,
            $this->db,
            $this->pluginAdmin,
            $this->testOBJ
        );
        
        return $testQuestionSetConfigFactory->getQuestionSetConfig();
    }

Referenced by insertQuestionsCmd().

Here is the caller graph for this function:

◆ executeCommand()

ilTestQuestionBrowserTableGUI::executeCommand ( )

Execute command.

Reimplemented from ilTable2GUI.

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

    {
        $this->handleParameters();
        $this->handleTabs();
        
        switch ($this->ctrl->getNextClass($this)) {
            case strtolower(__CLASS__):
            case '':
 
                $cmd = $this->ctrl->getCmd() . 'Cmd';
                return $this->$cmd();
 
            default:
 
                $this->ctrl->setReturn($this, self::CMD_BROWSE_QUESTIONS);
                return parent::executeCommand();
        }
    }

References handleParameters(), and handleTabs().

Here is the call graph for this function:

◆ fetchContextParameter()

ilTestQuestionBrowserTableGUI::fetchContextParameter ( )

private

Definition at line 254 of file class.ilTestQuestionBrowserTableGUI.php.

    {
        if (isset($_POST[self::CONTEXT_PARAMETER])) {
            return $_POST[self::CONTEXT_PARAMETER];
        }
 
        if (isset($_GET[self::CONTEXT_PARAMETER])) {
            return $_GET[self::CONTEXT_PARAMETER];
        }
 
        return null;
    }

References $_GET, $_POST, and CONTEXT_PARAMETER.

Referenced by getBackTargetCmdClass(), and getBackTargetCommand().

Here is the caller graph for this function:

◆ fetchModeParameter()

ilTestQuestionBrowserTableGUI::fetchModeParameter ( )

private

Definition at line 267 of file class.ilTestQuestionBrowserTableGUI.php.

    {
        if (isset($_POST[self::MODE_PARAMETER])) {
            return $_POST[self::MODE_PARAMETER];
        }
 
        if (isset($_GET[self::MODE_PARAMETER])) {
            return $_GET[self::MODE_PARAMETER];
        }
        
        return null;
    }

References $_GET, $_POST, and MODE_PARAMETER.

Referenced by getBrowseQuestionsTabLabel(), getParentObjectLabel(), getQuestionInstanceTypeFilter(), getQuestionParentObjectType(), and getQuestionParentObjIds().

Here is the caller graph for this function:

◆ fillRow()

ilTestQuestionBrowserTableGUI::fillRow ( $a_set )

Standard Version of Fill Row.

Most likely to be overwritten by derived class.

Parameters

array $a_set data array

Reimplemented from ilTable2GUI.

Definition at line 460 of file class.ilTestQuestionBrowserTableGUI.php.

    {
        $this->tpl->setVariable("QUESTION_ID", $data["question_id"]);
        $this->tpl->setVariable("QUESTION_TITLE", $data["title"]);
        $this->tpl->setVariable("QUESTION_COMMENT", $data["description"]);
        include_once "./Modules/TestQuestionPool/classes/class.assQuestion.php";
        $this->tpl->setVariable("QUESTION_TYPE", assQuestion::_getQuestionTypeName($data["type_tag"]));
        $this->tpl->setVariable("QUESTION_AUTHOR", $data["author"]);
        $this->tpl->setVariable("QUESTION_LIFECYCLE", $this->getTranslatedLifecycle($data['lifecycle']));
        $this->tpl->setVariable("QUESTION_CREATED", ilDatePresentation::formatDate(new ilDate($data['created'], IL_CAL_UNIX)));
        $this->tpl->setVariable("QUESTION_UPDATED", ilDatePresentation::formatDate(new ilDate($data["tstamp"], IL_CAL_UNIX)));
        $this->tpl->setVariable("QUESTION_POOL", $data['parent_title']);
        $this->tpl->setVariable("WORKING_TIME", $data['working_time']);
    }

References ilTableGUI\$data, assQuestion\_getQuestionTypeName(), ilDatePresentation\formatDate(), getTranslatedLifecycle(), and IL_CAL_UNIX.

Here is the call graph for this function:

◆ getBackTargetCmdClass()

ilTestQuestionBrowserTableGUI::getBackTargetCmdClass ( )

private

Definition at line 310 of file class.ilTestQuestionBrowserTableGUI.php.

    {
        switch ($this->fetchContextParameter()) {
            case self::CONTEXT_LIST_VIEW:
 
                return 'ilObjTestGUI';
 
            case self::CONTEXT_PAGE_VIEW:
 
                return 'ilTestExpressPageObjectGUI';
        }
        
        return '';
    }

References CONTEXT_LIST_VIEW, CONTEXT_PAGE_VIEW, and fetchContextParameter().

Referenced by getBackTargetUrl(), and insertQuestionsCmd().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getBackTargetCommand()

ilTestQuestionBrowserTableGUI::getBackTargetCommand ( )

private

Definition at line 325 of file class.ilTestQuestionBrowserTableGUI.php.

    {
        switch ($this->fetchContextParameter()) {
            case self::CONTEXT_LIST_VIEW:
 
                return 'questions';
 
            case self::CONTEXT_PAGE_VIEW:
 
                return 'showPage';
        }
 
        return '';
    }

References CONTEXT_LIST_VIEW, CONTEXT_PAGE_VIEW, and fetchContextParameter().

Referenced by getBackTargetUrl(), and insertQuestionsCmd().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getBackTargetLabel()

ilTestQuestionBrowserTableGUI::getBackTargetLabel ( )

private

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

    {
        return $this->lng->txt('backtocallingtest');
    }

Referenced by handleTabs().

Here is the caller graph for this function:

◆ getBackTargetUrl()

ilTestQuestionBrowserTableGUI::getBackTargetUrl ( )

private

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

    {
        return $this->ctrl->getLinkTargetByClass(
            $this->getBackTargetCmdClass(),
            $this->getBackTargetCommand()
        );
    }

References getBackTargetCmdClass(), and getBackTargetCommand().

Referenced by handleTabs().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getBrowseQuestionsTabLabel()

ilTestQuestionBrowserTableGUI::getBrowseQuestionsTabLabel ( )

private

Definition at line 340 of file class.ilTestQuestionBrowserTableGUI.php.

    {
        switch ($this->fetchModeParameter()) {
            case self::MODE_BROWSE_POOLS:
 
                return $this->lng->txt('tst_browse_for_qpl_questions');
 
            case self::MODE_BROWSE_TESTS:
 
                return $this->lng->txt('tst_browse_for_tst_questions');
        }
 
        return '';
    }

References fetchModeParameter(), MODE_BROWSE_POOLS, and MODE_BROWSE_TESTS.

Referenced by handleTabs().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getBrowseQuestionsTabUrl()

ilTestQuestionBrowserTableGUI::getBrowseQuestionsTabUrl ( )

private

Definition at line 355 of file class.ilTestQuestionBrowserTableGUI.php.

    {
        return $this->ctrl->getLinkTarget($this, self::CMD_BROWSE_QUESTIONS);
    }

Referenced by handleTabs().

Here is the caller graph for this function:

◆ getParentObjectLabel()

ilTestQuestionBrowserTableGUI::getParentObjectLabel ( )

private

Definition at line 436 of file class.ilTestQuestionBrowserTableGUI.php.

    {
        switch ($this->fetchModeParameter()) {
            case self::MODE_BROWSE_POOLS:
 
                return $this->lng->txt('qpl');
 
            case self::MODE_BROWSE_TESTS:
 
                return $this->lng->txt('tst');
        }
 
        return '';
    }

References fetchModeParameter(), MODE_BROWSE_POOLS, and MODE_BROWSE_TESTS.

Referenced by __construct(), and initFilter().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getQuestionInstanceTypeFilter()

ilTestQuestionBrowserTableGUI::getQuestionInstanceTypeFilter ( )

private

Definition at line 537 of file class.ilTestQuestionBrowserTableGUI.php.

    {
        if ($this->fetchModeParameter() == self::MODE_BROWSE_TESTS) {
            return ilAssQuestionList::QUESTION_INSTANCE_TYPE_DUPLICATES;
        }
 
        return ilAssQuestionList::QUESTION_INSTANCE_TYPE_ORIGINALS;
    }

References fetchModeParameter(), ilAssQuestionList\QUESTION_INSTANCE_TYPE_DUPLICATES, and ilAssQuestionList\QUESTION_INSTANCE_TYPE_ORIGINALS.

Referenced by getQuestionsData().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getQuestionParentObjectType()

ilTestQuestionBrowserTableGUI::getQuestionParentObjectType ( )

private

Definition at line 582 of file class.ilTestQuestionBrowserTableGUI.php.

    {
        if ($this->fetchModeParameter() == self::MODE_BROWSE_TESTS) {
            return 'tst';
        }
 
        return 'qpl';
    }

References fetchModeParameter().

Here is the call graph for this function:

◆ getQuestionParentObjIds()

ilTestQuestionBrowserTableGUI::getQuestionParentObjIds ( $repositoryRootNode )

private

Definition at line 546 of file class.ilTestQuestionBrowserTableGUI.php.

    {
        $parents = $this->tree->getSubTree(
            $this->tree->getNodeData($repositoryRootNode),
            true,
            $this->getQuestionParentObjectType()
        );
 
        $parentIds = array();
 
        foreach ($parents as $nodeData) {
            if ($nodeData['obj_id'] == $this->testOBJ->getId()) {
                continue;
            }
            
            $parentIds[ $nodeData['obj_id'] ] = $nodeData['obj_id'];
        }
 
        $parentIds = array_map('intval', array_values($parentIds));
 
        if ($this->fetchModeParameter() == self::MODE_BROWSE_POOLS) {
            $available_pools = array_map('intval', array_keys(ilObjQuestionPool::_getAvailableQuestionpools(true)));
            return array_intersect($parentIds, $available_pools);
        } elseif ($this->fetchModeParameter() == self::MODE_BROWSE_TESTS) {
            // TODO bheyser: Move this to another place ...
            return array_filter($parentIds, function ($obj_id) {
                $refIds = ilObject::_getAllReferences($obj_id);
                $refId = current($refIds);
                return $this->access->checkAccess('write', '', $refId);
            });
        }
 
        // Return no parent ids if the user wants to hack...
        return array();
    }

References $refId, ilObject\_getAllReferences(), ilObjQuestionPool\_getAvailableQuestionpools(), and fetchModeParameter().

Referenced by getQuestionsData().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getQuestionsData()

ilTestQuestionBrowserTableGUI::getQuestionsData ( )

private

Returns: array

Definition at line 495 of file class.ilTestQuestionBrowserTableGUI.php.

    {
        $questionList = new ilAssQuestionList($this->db, $this->lng, $this->pluginAdmin);
 
        $questionList->setQuestionInstanceTypeFilter($this->getQuestionInstanceTypeFilter());
        $questionList->setExcludeQuestionIdsFilter($this->testOBJ->getExistingQuestions());
 
        $repositoryRootNode = self::REPOSITORY_ROOT_NODE_ID;
        
        foreach ($this->getFilterItems() as $item) {
            if ($item->getValue() !== false) {
                switch ($item->getPostVar()) {
                    case 'title':
                    case 'description':
                    case 'author':
                    case 'lifecycle':
                    case 'type':
                    case 'parent_title':
                        
                        $questionList->addFieldFilter($item->getPostVar(), $item->getValue());
                        break;
                    
                    case 'repository_root_node':
                        
                        $repositoryRootNode = $item->getValue();
                }
            }
        }
        
        $parentObjectIds = $this->getQuestionParentObjIds($repositoryRootNode);
        
        if (!count($parentObjectIds)) {
            return array();
        }
        
        $questionList->setParentObjIdsFilter($parentObjectIds);
 
        $questionList->load();
        
        return $questionList->getQuestionDataArray();
    }

References ilTable2GUI\getFilterItems(), getQuestionInstanceTypeFilter(), getQuestionParentObjIds(), and REPOSITORY_ROOT_NODE_ID.

Referenced by browseQuestionsCmd().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getTranslatedLifecycle()

ilTestQuestionBrowserTableGUI::getTranslatedLifecycle ( $lifecycle )

protected

Definition at line 451 of file class.ilTestQuestionBrowserTableGUI.php.

    {
        try {
            return ilAssQuestionLifecycle::getInstance($lifecycle)->getTranslation($this->lng);
        } catch (ilTestQuestionPoolInvalidArgumentException $e) {
            return '';
        }
    }

References Vendor\Package\$e, and ilAssQuestionLifecycle\getInstance().

Referenced by fillRow().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ handleParameters()

ilTestQuestionBrowserTableGUI::handleParameters ( )

private

Definition at line 237 of file class.ilTestQuestionBrowserTableGUI.php.

    {
        $this->ctrl->saveParameter($this, self::CONTEXT_PARAMETER);
        if (isset($_GET[self::CONTEXT_PARAMETER])) {
            $this->addHiddenInput(self::CONTEXT_PARAMETER, $_GET[self::CONTEXT_PARAMETER]);
        } elseif (isset($_POST[self::CONTEXT_PARAMETER])) {
            $this->addHiddenInput(self::CONTEXT_PARAMETER, $_POST[self::CONTEXT_PARAMETER]);
        }
        
        $this->ctrl->saveParameter($this, self::MODE_PARAMETER);
        if (isset($_GET[self::MODE_PARAMETER])) {
            $this->addHiddenInput(self::MODE_PARAMETER, $_GET[self::MODE_PARAMETER]);
        } elseif (isset($_POST[self::MODE_PARAMETER])) {
            $this->addHiddenInput(self::MODE_PARAMETER, $_POST[self::MODE_PARAMETER]);
        }
    }

References $_GET, $_POST, and ilTable2GUI\addHiddenInput().

Referenced by executeCommand().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ handleTabs()

ilTestQuestionBrowserTableGUI::handleTabs ( )

private

Definition at line 280 of file class.ilTestQuestionBrowserTableGUI.php.

    {
        $this->tabs->clearTargets();
        $this->tabs->clearSubTabs();
        
        $this->tabs->setBackTarget(
            $this->getBackTargetLabel(),
            $this->getBackTargetUrl()
        );
        
        $this->tabs->addTab(
            'browseQuestions',
            $this->getBrowseQuestionsTabLabel(),
            $this->getBrowseQuestionsTabUrl()
        );
    }

References getBackTargetLabel(), getBackTargetUrl(), getBrowseQuestionsTabLabel(), and getBrowseQuestionsTabUrl().

Referenced by executeCommand().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ hasWriteAccess()

ilTestQuestionBrowserTableGUI::hasWriteAccess ( )

Definition at line 152 of file class.ilTestQuestionBrowserTableGUI.php.

    {
        return $this->writeAccess;
    }

References $writeAccess.

Referenced by init().

Here is the caller graph for this function:

◆ init()

ilTestQuestionBrowserTableGUI::init ( )

Definition at line 157 of file class.ilTestQuestionBrowserTableGUI.php.

    {
        if ($this->hasWriteAccess()) {
            $this->addMultiCommand(self::CMD_INSERT_QUESTIONS, $this->lng->txt('insert'));
        }
    }

References ilTable2GUI\addMultiCommand(), and hasWriteAccess().

Here is the call graph for this function:

◆ initFilter()

ilTestQuestionBrowserTableGUI::initFilter ( )

Init filter.

Overwrite this to initialize all filter input property objects.

Reimplemented from ilTable2GUI.

Definition at line 360 of file class.ilTestQuestionBrowserTableGUI.php.

    {
        // title
        include_once("./Services/Form/classes/class.ilTextInputGUI.php");
        $ti = new ilTextInputGUI($this->lng->txt("tst_qbt_filter_question_title"), "title");
        $ti->setMaxLength(64);
        $ti->setSize(20);
        $ti->setValidationRegexp('/(^[^%]+$)|(^$)/is');
        $this->addFilterItem($ti);
        $ti->readFromSession();
        $this->filter["title"] = $ti->getValue();
        
        // description
        $ti = new ilTextInputGUI($this->lng->txt("description"), "description");
        $ti->setMaxLength(64);
        $ti->setSize(20);
        $ti->setValidationRegexp('/(^[^%]+$)|(^$)/is');
        $this->addFilterItem($ti);
        $ti->readFromSession();
        $this->filter["description"] = $ti->getValue();
        
        // author
        $ti = new ilTextInputGUI($this->lng->txt("author"), "author");
        $ti->setMaxLength(64);
        $ti->setSize(20);
        $this->addFilterItem($ti);
        $ti->setValidationRegexp('/(^[^%]+$)|(^$)/is');
        $ti->readFromSession();
        $this->filter["author"] = $ti->getValue();
        
        // lifecycle
        $lifecycleOptions = array_merge(
            array('' => $this->lng->txt('qst_lifecycle_filter_all')),
            ilAssQuestionLifecycle::getDraftInstance()->getSelectOptions($this->lng)
        );
        $lifecycleInp = new ilSelectInputGUI($this->lng->txt('qst_lifecycle'), 'lifecycle');
        $lifecycleInp->setOptions($lifecycleOptions);
        $this->addFilterItem($lifecycleInp);
        $lifecycleInp->readFromSession();
        $this->filter['lifecycle'] = $lifecycleInp->getValue();
        
        // questiontype
        include_once("./Services/Form/classes/class.ilSelectInputGUI.php");
        include_once("./Modules/TestQuestionPool/classes/class.ilObjQuestionPool.php");
        $types = ilObjQuestionPool::_getQuestionTypes();
        $options = array();
        $options[""] = $this->lng->txt('filter_all_question_types');
        foreach ($types as $translation => $row) {
            $options[$row['type_tag']] = $translation;
        }
 
        $si = new ilSelectInputGUI($this->lng->txt("question_type"), "type");
        $si->setOptions($options);
        $this->addFilterItem($si);
        $si->readFromSession();
        $this->filter["type"] = $si->getValue();
        
        // question pool
        $ti = new ilTextInputGUI($this->getParentObjectLabel(), 'parent_title');
        $ti->setMaxLength(64);
        $ti->setSize(20);
        $ti->setValidationRegexp('/(^[^%]+$)|(^$)/is');
        $this->addFilterItem($ti);
        $ti->readFromSession();
        $this->filter['parent_title'] = $ti->getValue();
    
        // repo root node
        require_once 'Services/Form/classes/class.ilRepositorySelectorInputGUI.php';
        $ri = new ilRepositorySelectorInputGUI($this->lng->txt('repository'), 'repository_root_node');
        $ri->setHeaderMessage($this->lng->txt('question_browse_area_info'));
        $ri->setClickableTypes(array('qpl'));
        $this->addFilterItem($ri);
        $ri->readFromSession();
        $this->filter['repository_root_node'] = $ri->getValue();
    }

References $si, ilObjQuestionPool\_getQuestionTypes(), ilTable2GUI\addFilterItem(), ilAssQuestionLifecycle\getDraftInstance(), and getParentObjectLabel().

Referenced by __construct().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ insertQuestionsCmd()

ilTestQuestionBrowserTableGUI::insertQuestionsCmd ( )

private

Definition at line 202 of file class.ilTestQuestionBrowserTableGUI.php.

    {
        $selected_array = (is_array($_POST['q_id'])) ? $_POST['q_id'] : array();
        if (!count($selected_array)) {
            ilUtil::sendInfo($this->lng->txt("tst_insert_missing_question"), true);
            $this->ctrl->redirect($this, self::CMD_BROWSE_QUESTIONS);
        }
        
        include_once "./Modules/TestQuestionPool/classes/class.assQuestion.php";
 
        $testQuestionSetConfig = $this->buildTestQuestionSetConfig();
        
        $manscoring = false;
        
        foreach ($selected_array as $key => $value) {
            $last_question_id = $this->testOBJ->insertQuestion($testQuestionSetConfig, $value);
            
            if (!$manscoring) {
                $manscoring = $manscoring | assQuestion::_needsManualScoring($value);
            }
        }
        
        $this->testOBJ->saveCompleteStatus($testQuestionSetConfig);
        
        if ($manscoring) {
            ilUtil::sendInfo($this->lng->txt("manscoring_hint"), true);
        } else {
            ilUtil::sendSuccess($this->lng->txt("tst_questions_inserted"), true);
        }
 
        //$this->ctrl->setParameter($this, 'q_id', $last_question_id); // for page view ?
        
        $this->ctrl->redirectByClass($this->getBackTargetCmdClass(), $this->getBackTargetCommand());
    }

References $_POST, assQuestion\_needsManualScoring(), buildTestQuestionSetConfig(), getBackTargetCmdClass(), getBackTargetCommand(), and ilUtil\sendInfo().

Here is the call graph for this function:

◆ resetFilterCmd()

ilTestQuestionBrowserTableGUI::resetFilterCmd ( )

private

Definition at line 196 of file class.ilTestQuestionBrowserTableGUI.php.

    {
        $this->resetFilter();
        $this->ctrl->redirect($this, self::CMD_BROWSE_QUESTIONS);
    }

References ilTable2GUI\resetFilter().

Here is the call graph for this function:

◆ setWriteAccess()

ilTestQuestionBrowserTableGUI::setWriteAccess ( $value )

Definition at line 147 of file class.ilTestQuestionBrowserTableGUI.php.

    {
        $this->writeAccess = $value;
    }

Referenced by hasWriteAccess().

◆ CMD_APPLY_FILTER

const ilTestQuestionBrowserTableGUI::CMD_APPLY_FILTER = 'applyFilter'

Definition at line 31 of file class.ilTestQuestionBrowserTableGUI.php.

◆ CMD_BROWSE_QUESTIONS

const ilTestQuestionBrowserTableGUI::CMD_BROWSE_QUESTIONS = 'browseQuestions'

Definition at line 30 of file class.ilTestQuestionBrowserTableGUI.php.

Referenced by ilObjTestGUI\populateQuestionBrowserToolbarButtons().

◆ CMD_INSERT_QUESTIONS

const ilTestQuestionBrowserTableGUI::CMD_INSERT_QUESTIONS = 'insertQuestions'

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

◆ CMD_RESET_FILTER

const ilTestQuestionBrowserTableGUI::CMD_RESET_FILTER = 'resetFilter'

Definition at line 32 of file class.ilTestQuestionBrowserTableGUI.php.

◆ CONTEXT_LIST_VIEW

const ilTestQuestionBrowserTableGUI::CONTEXT_LIST_VIEW = 'contextListView'

Definition at line 24 of file class.ilTestQuestionBrowserTableGUI.php.

Referenced by getBackTargetCmdClass(), getBackTargetCommand(), and ilObjTestGUI\questionsObject().

◆ CONTEXT_PAGE_VIEW

const ilTestQuestionBrowserTableGUI::CONTEXT_PAGE_VIEW = 'contextPageView'

Definition at line 23 of file class.ilTestQuestionBrowserTableGUI.php.

Referenced by ilObjTestGUI\buildPageViewToolbar(), getBackTargetCmdClass(), and getBackTargetCommand().

◆ CONTEXT_PARAMETER

const ilTestQuestionBrowserTableGUI::CONTEXT_PARAMETER = 'question_browse_context'

Definition at line 22 of file class.ilTestQuestionBrowserTableGUI.php.

Referenced by fetchContextParameter(), and ilObjTestGUI\populateQuestionBrowserToolbarButtons().

◆ MODE_BROWSE_POOLS

const ilTestQuestionBrowserTableGUI::MODE_BROWSE_POOLS = 'modeBrowsePools'

Definition at line 27 of file class.ilTestQuestionBrowserTableGUI.php.

Referenced by getBrowseQuestionsTabLabel(), getParentObjectLabel(), and ilObjTestGUI\populateQuestionBrowserToolbarButtons().

◆ MODE_BROWSE_TESTS

const ilTestQuestionBrowserTableGUI::MODE_BROWSE_TESTS = 'modeBrowseTests'

Definition at line 28 of file class.ilTestQuestionBrowserTableGUI.php.

Referenced by getBrowseQuestionsTabLabel(), getParentObjectLabel(), and ilObjTestGUI\populateQuestionBrowserToolbarButtons().

◆ MODE_PARAMETER

const ilTestQuestionBrowserTableGUI::MODE_PARAMETER = 'question_browse_mode'

Definition at line 26 of file class.ilTestQuestionBrowserTableGUI.php.

Referenced by fetchModeParameter(), and ilObjTestGUI\populateQuestionBrowserToolbarButtons().

◆ REPOSITORY_ROOT_NODE_ID

const ilTestQuestionBrowserTableGUI::REPOSITORY_ROOT_NODE_ID = 1

Definition at line 20 of file class.ilTestQuestionBrowserTableGUI.php.

Referenced by getQuestionsData().

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

Modules/Test/classes/tables/class.ilTestQuestionBrowserTableGUI.php

Public Member Functions

Data Fields

Protected Member Functions

Protected Attributes

Private Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ applyFilterCmd()

◆ browseQuestionsCmd()

◆ buildTestQuestionSetConfig()

◆ executeCommand()

◆ fetchContextParameter()

◆ fetchModeParameter()

◆ fillRow()

◆ getBackTargetCmdClass()

◆ getBackTargetCommand()

◆ getBackTargetLabel()

◆ getBackTargetUrl()

◆ getBrowseQuestionsTabLabel()

◆ getBrowseQuestionsTabUrl()

◆ getParentObjectLabel()

◆ getQuestionInstanceTypeFilter()

◆ getQuestionParentObjectType()

◆ getQuestionParentObjIds()

◆ getQuestionsData()

◆ getTranslatedLifecycle()

◆ handleParameters()

◆ handleTabs()

◆ hasWriteAccess()

◆ init()

◆ initFilter()

◆ insertQuestionsCmd()

◆ resetFilterCmd()

◆ setWriteAccess()

Field Documentation

◆ $access

◆ $ctrl

◆ $db

◆ $lng

◆ $mainTpl

◆ $pluginAdmin

◆ $tabs

◆ $testOBJ

◆ $tree

◆ $writeAccess

◆ CMD_APPLY_FILTER

◆ CMD_BROWSE_QUESTIONS

◆ CMD_INSERT_QUESTIONS

◆ CMD_RESET_FILTER

◆ CONTEXT_LIST_VIEW

◆ CONTEXT_PAGE_VIEW

◆ CONTEXT_PARAMETER

◆ MODE_BROWSE_POOLS

◆ MODE_BROWSE_TESTS

◆ MODE_PARAMETER

◆ REPOSITORY_ROOT_NODE_ID