Collaboration diagram for ilAdvancedMDRecord:

Public Member Functions
	__construct ($a_record_id=0)
	Singleton constructor To create an array of new records (without saving them) call the constructor directly. More...

	delete ()
	Delete. More...

	save ()
	save More...

	update ()
	update More...

	validate ()
	Validate settings. More...

	getRecordId ()
	Get record id. More...

	setActive ($a_active)
	Set active. More...

	isActive ()
	Check if record is active. More...

	setTitle ($a_title)
	Set title. More...

	getTitle ()
	get title More...

	setDescription ($a_description)
	set description More...

	getDescription ()
	get description More...

	setImportId ($a_id_string)
	set import id More...

	getImportId ()
	get import id More...

	setAssignedObjectTypes ($a_obj_types)
	Set assigned object types. More...

	appendAssignedObjectType ($a_obj_type, $a_sub_type, $a_optional=false)
	append assigned object types More...

	getAssignedObjectTypes ()
	Get assigned object types. More...

	isAssignedObjectType ($a_obj_type, $a_sub_type)
	Is assigned object type? More...

	setParentObject ($a_obj_id)

	getParentObject ()

	toXML (ilXmlWriter $writer)
	To Xml. More...

	__destruct ()
	Destructor. More...

	_clone (array &$a_fields_map, $a_parent_obj_id=null)
	Clone record. More...

Static Public Member Functions
static	_getInstanceByRecordId ($a_record_id)
	Get instance by record id. More...

static	_getActiveSearchableRecords ()
	Get active searchable records. More...

static	_lookupTitle ($a_record_id)
	Lookup title. More...

static	_lookupRecordIdByImportId ($a_ilias_id)
	Lookup record Id by import id. More...

static	_getAssignableObjectTypes ($a_include_text=false)
	Get assignable object type. More...

static	_getActivatedObjTypes ()
	get activated obj types More...

static	_getRecords ()
	Get records. More...

static	_getAllRecordsByObjectType ()
	Get records by obj_type Note: this returns only records with no sub types! public. More...

static	_getActivatedRecordsByObjectType ($a_obj_type, $a_sub_type="", $a_only_optional=false)
	Get activated records by object type. More...

static	_getSelectedRecordsByObject ($a_obj_type, $a_obj_id, $a_sub_type="")
	Get selected records by object. More...

static	_delete ($a_record_id)
	Delete record and all related data. More...

static	saveObjRecSelection ($a_obj_id, $a_sub_type="", array $a_records=null, $a_delete_before=true)
	Save repository object record selection. More...

static	getObjRecSelection ($a_obj_id, $a_sub_type="")
	Get repository object record selection. More...

static	getSharedRecords ($a_obj1_id, $a_obj2_id, $a_sub_type="-")
	Get shared records. More...

Protected Member Functions
	generateImportId ()
	generate unique record id More...

Protected Attributes
	$record_id

	$import_id

	$active

	$title

	$description

	$obj_types = array()

	$db = null

	$parent_obj

Private Member Functions
	read ()
	read record and assiged object types More...

Static Private Attributes
static	$instances = array()

Detailed Description

Definition at line 15 of file class.ilAdvancedMDRecord.php.

Constructor & Destructor Documentation

◆ __construct()

ilAdvancedMDRecord::__construct ( $a_record_id = 0 )

Singleton constructor To create an array of new records (without saving them) call the constructor directly.

Otherwise call getInstance...

public

Parameters

int record id

Definition at line 37 of file class.ilAdvancedMDRecord.php.

References $ilDB, getRecordId(), and read().

         {
                 global $ilDB;
                 
                 $this->record_id = $a_record_id;
                 $this->db = $ilDB;
                 
                 if($this->getRecordId())
                 {
                         $this->read();
                 }
         }

Here is the call graph for this function:

◆ __destruct()

ilAdvancedMDRecord::__destruct ( )

Destructor.

public

Definition at line 779 of file class.ilAdvancedMDRecord.php.

References getRecordId().

         {
                 unset(self::$instances[$this->getRecordId()]);
         }

Here is the call graph for this function:

Member Function Documentation

◆ _clone()

ilAdvancedMDRecord::_clone	(	array &	$a_fields_map,
			$a_parent_obj_id = `null`
	)

Clone record.

Parameters

array	&$a_fields_map
type	$a_parent_obj_id

Returns: self

Definition at line 857 of file class.ilAdvancedMDRecord.php.

References getAssignedObjectTypes(), getDescription(), ilAdvancedMDFieldDefinition\getInstancesByRecordId(), getParentObject(), getRecordId(), getTitle(), and isActive().

         {               
                 $new_obj = new self();
                 $new_obj->setActive($this->isActive());
                 $new_obj->setTitle($this->getTitle());
                 $new_obj->setDescription($this->getDescription());                              
                 $new_obj->setParentObject($a_parent_obj_id
                         ? $a_parent_obj_id
                         : $this->getParentObject());
                 $new_obj->setAssignedObjectTypes($this->getAssignedObjectTypes());
                 $new_obj->save();
                 
                 include_once('Services/AdvancedMetaData/classes/class.ilAdvancedMDFieldDefinition.php');
                 foreach(ilAdvancedMDFieldDefinition::getInstancesByRecordId($this->getRecordId()) as $definition)
                 {
                         $new_def = $definition->_clone($new_obj->getRecordId());                        
                         $a_fields_map[$definition->getFieldId()] = $new_def->getFieldId();
                 }               
 
                 return $new_obj;
         }

Here is the call graph for this function:

◆ _delete()

static ilAdvancedMDRecord::_delete ( $a_record_id )

static

Delete record and all related data.

public

Parameters

int record id

Definition at line 388 of file class.ilAdvancedMDRecord.php.

References $ilDB, $query, $res, and ilAdvancedMDFieldDefinition\getInstancesByRecordId().

Referenced by delete().

         {
                 global $ilDB;
                 
                 // Delete fields
                 foreach(ilAdvancedMDFieldDefinition::getInstancesByRecordId($a_record_id) as $field)
                 {
                         $field->delete();
                 }
                 
                 $query = "DELETE FROM adv_md_record ".
                         "WHERE record_id = ".$ilDB->quote($a_record_id ,'integer')." ";
                 $res = $ilDB->manipulate($query);
                 
                 $query = "DELETE FROM adv_md_record_objs ".
                         "WHERE record_id = ".$ilDB->quote($a_record_id ,'integer')." ";
                 $res = $ilDB->manipulate($query);
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _getActivatedObjTypes()

static ilAdvancedMDRecord::_getActivatedObjTypes ( )

static

get activated obj types

public

Parameters

string obj types

Definition at line 184 of file class.ilAdvancedMDRecord.php.

References $ilDB, $obj_types, $query, $res, $row, array, and ilDBConstants\FETCHMODE_OBJECT.

Referenced by ilAdvancedSearchGUI\__setSearchOptions(), ilAdvancedSearchGUI\initAdvancedMetaDataForm(), and ilAdvancedMDSettingsGUI\updateSubstitutions().

         {
                 global $ilDB;
                 
                 $query = "SELECT DISTINCT(obj_type) FROM adv_md_record_objs amo ".
                         "JOIN adv_md_record amr ON amo.record_id = amr.record_id ".
                         "WHERE active = 1 ";
                 $res = $ilDB->query($query);
                 while($row = $res->fetchRow(ilDBConstants::FETCHMODE_OBJECT))
                 {
                         $obj_types[] = $row->obj_type; 
                 }
                 return $obj_types ? $obj_types : array(); 
         }

Here is the caller graph for this function:

◆ _getActivatedRecordsByObjectType()

static ilAdvancedMDRecord::_getActivatedRecordsByObjectType	(	$a_obj_type,
		$a_sub_type = `""`,
		$a_only_optional = `false`
	)

static

Get activated records by object type.

public

Parameters

string obj_type

Definition at line 251 of file class.ilAdvancedMDRecord.php.

References $ilDB, $query, $records, $res, $row, array, and ilDBConstants\FETCHMODE_OBJECT.

Referenced by ilSoapInstallationInfoXMLWriter\__buildClient(), ilWikiExporter\getActiveAdvMDRecords(), ilStudyProgrammeType\getAvailableAdvancedMDRecords(), ilOrgUnitType\getAvailableAdvancedMDRecords(), ilSoapAdministration\getNIC(), and ilAdvancedMDRecordGUI\parseRecordSelection().

         {
                 global $ilDB;           
 
                 $records = array();
                 
                 if ($a_sub_type == "")
                 {
                         $a_sub_type = "-";
                 }
                 
                 $query = "SELECT amro.record_id record_id FROM adv_md_record_objs amro ".
                         "JOIN adv_md_record amr ON amr.record_id = amro.record_id ".
                         "WHERE active = 1 ".
                         "AND obj_type = ".$ilDB->quote($a_obj_type ,'text')." ".
                         "AND sub_type = ".$ilDB->quote($a_sub_type ,'text');
                 
                 if($a_only_optional)
                 {
                         $query .= " AND optional =".$ilDB->quote(1, 'integer');
                 }
                 
                 // #16428
                 $query .= "ORDER by parent_obj DESC, record_id";
 
                 $res = $ilDB->query($query);
                 while($row = $res->fetchRow(ilDBConstants::FETCHMODE_OBJECT))
                 {
                         $records[] = self::_getInstanceByRecordId($row->record_id);
                 }
 
                 return $records;
         }

Here is the caller graph for this function:

◆ _getActiveSearchableRecords()

static ilAdvancedMDRecord::_getActiveSearchableRecords ( )

static

Get active searchable records.

public

Definition at line 74 of file class.ilAdvancedMDRecord.php.

References $ilDB, $query, $records, $res, $row, array, and ilDBConstants\FETCHMODE_OBJECT.

         {
                 global $ilDB;
                 
                 $query = "SELECT DISTINCT(amr.record_id) FROM adv_md_record amr ".
                         "JOIN adv_mdf_definition amfd ON amr.record_id = amfd.record_id ".
                         "WHERE searchable = 1 AND active = 1 ";
                         
                 $res = $ilDB->query($query);
                 while($row = $res->fetchRow(ilDBConstants::FETCHMODE_OBJECT))
                 {
                         $records[] = self::_getInstanceByRecordId($row->record_id);
                 }
                 return $records ? $records : array();
         }

◆ _getAllRecordsByObjectType()

static ilAdvancedMDRecord::_getAllRecordsByObjectType ( )

static

Get records by obj_type Note: this returns only records with no sub types! public.

Parameters

Definition at line 228 of file class.ilAdvancedMDRecord.php.

References $ilDB, $query, $records, $res, $row, array, and ilDBConstants\FETCHMODE_OBJECT.

Referenced by ilAdvancedMDSettingsGUI\initFormSubstitutions(), and ilAdvancedMDSettingsGUI\setSubTabs().

         {
                 global $ilDB;
                 
                 $records = array();
                 
                 $query = "SELECT * FROM adv_md_record_objs WHERE sub_type=".$ilDB->quote("-", "text");
                 $res = $ilDB->query($query);
                 while($row = $res->fetchRow(ilDBConstants::FETCHMODE_OBJECT))
                 {
                         $records[$row->obj_type][] = self::_getInstanceByRecordId($row->record_id);
                 }
                 return $records;
         }

Here is the caller graph for this function:

◆ _getAssignableObjectTypes()

static ilAdvancedMDRecord::_getAssignableObjectTypes ( $a_include_text = false )

static

Get assignable object type.

public

Definition at line 145 of file class.ilAdvancedMDRecord.php.

References $lng, $text, and array.

Referenced by ilSoapInstallationInfoXMLWriter\__buildClient(), ilAdvancedMDRecordTableGUI\fillRow(), ilSoapAdministration\getNIC(), ilAdvancedMDSettingsGUI\initForm(), and ilObjectMetaDataGUI\isAdvMDAvailable().

         {
                 global $objDefinition, $lng;
                 
                 $types = array();
                 $amet_types = $objDefinition->getAdvancedMetaDataTypes();
 
                 foreach ($amet_types as $at)
                 {
                         if ($a_include_text)
                         {
                                 $text = $lng->txt("obj_".$at["obj_type"]);
                                 if ($at["sub_type"] != "")
                                 {
                                         $lng->loadLanguageModule($at["obj_type"]);
                                         $text.= ": ".$lng->txt($at["obj_type"]."_".$at["sub_type"]);
                                 }
                                 else
                                 {
                                         $at["sub_type"] = "-";
                                 }
                                 $at["text"] = $text;
                         }
                         
                         $types[] = $at;
                 }
 
                 sort($types);
                 return $types;
         }

Here is the caller graph for this function:

◆ _getInstanceByRecordId()

static ilAdvancedMDRecord::_getInstanceByRecordId ( $a_record_id )

static

Get instance by record id.

public

Parameters

int record id

Definition at line 58 of file class.ilAdvancedMDRecord.php.

Referenced by _getRecords(), ilAdvancedMDSettingsGUI\confirmDeleteRecords(), ilAdvancedMDSettingsGUI\deleteRecords(), ilAdvancedMDSettingsGUI\exportRecords(), ilAdvancedMDRecordParser\initRecordObject(), ilAdvancedMDSettingsGUI\initRecordObject(), and ilAdvancedMDSettingsGUI\updateRecords().

         {
                 if(isset(self::$instances[$a_record_id]))
                 {
                         return self::$instances[$a_record_id];
                 }
                 return self::$instances[$a_record_id] = new ilAdvancedMDRecord($a_record_id);
         }

Here is the caller graph for this function:

◆ _getRecords()

static ilAdvancedMDRecord::_getRecords ( )

static

Get records.

public

Parameters

array array of record objects

Definition at line 207 of file class.ilAdvancedMDRecord.php.

References $ilDB, $query, $records, $res, $row, _getInstanceByRecordId(), array, and ilDBConstants\FETCHMODE_OBJECT.

Referenced by ilAdvancedMDValues\_cloneValues(), ilLuceneAdvancedSearchFields\getFields(), and ilAdvancedMDSettingsGUI\getParsedRecordObjects().

         {
                 global $ilDB;
                 
                 $query = "SELECT record_id FROM adv_md_record ";
                 $res = $ilDB->query($query);
                 while($row = $res->fetchRow(ilDBConstants::FETCHMODE_OBJECT))
                 {
                         $records[] = ilAdvancedMDRecord::_getInstanceByRecordId($row->record_id);
                 }
                 return $records ? $records : array();
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _getSelectedRecordsByObject()

static ilAdvancedMDRecord::_getSelectedRecordsByObject	(	$a_obj_type,
		$a_obj_id,
		$a_sub_type = `""`
	)

static

Get selected records by object.

Parameters

string	$a_obj_type	object type
string	$a_obj_id	object id
string	$a_sub_type	sub type

Definition at line 292 of file class.ilAdvancedMDRecord.php.

References $record_id, $records, ilContainer\_lookupContainerSetting(), array, and ilObjectServiceSettingsGUI\CUSTOM_METADATA.

Referenced by ilGlossaryTerm\_copyTerm(), ilWikiFunctionsBlockGUI\fillDataSection(), ilPCAMDPageList\findPages(), ilGlossaryExporter\getActiveAdvMDRecords(), ilAdvancedMDRecordGUI\getActiveRecords(), ilObjBookingPool\getAdvancedMDFields(), ilGlossaryAdvMetaDataAdapter\getAllFields(), ilObjectMetaDataGUI\getBlockHTML(), ilAdvancedMDValues\getInstancesForObjectId(), ilObjectMetaDataGUI\getKeyValueList(), ilObjectMetaDataGUI\hasActiveRecords(), ilObjWikiGUI\initSettingsForm(), ilAdvancedMDValues\preloadedRead(), and ilAdvancedMDValues\queryForRecords().

         {               
                 $records = array();
                 
                 if ($a_sub_type == "")
                 {
                         $a_sub_type = "-";
                 }
                 
                 // object-wide metadata configuration setting           
                 include_once 'Services/Container/classes/class.ilContainer.php';
                 include_once 'Services/Object/classes/class.ilObjectServiceSettingsGUI.php';                    
                 $config_setting = ilContainer::_lookupContainerSetting(
                         $a_obj_id,
                         ilObjectServiceSettingsGUI::CUSTOM_METADATA,
                         false);         
                 
                 $optional = array();
                 foreach(self::_getActivatedRecordsByObjectType($a_obj_type, $a_sub_type) as $record)
                 {
                         foreach($record->getAssignedObjectTypes() as $item)
                         {                               
                                 if($record->getParentObject())
                                 {
                                         // only matching local records
                                         if($record->getParentObject() != $a_obj_id)
                                         {
                                                 continue;
                                         }
                                         // if object-wide setting is off, ignore local records
                                         else if(!$config_setting)
                                         {
                                                 continue;
                                         }
                                 }
                                 
                                 if($item['obj_type'] == $a_obj_type &&
                                         $item['sub_type'] == $a_sub_type)
                                 {
                                         if($item['optional'])
                                         {
                                                 $optional[] = $record->getRecordId();
                                         }
                                         $records[$record->getRecordId()] = $record;
                                 }
                         }
                 }
                 
                 if($optional)
                 {
                         if(!$config_setting && !in_array($a_sub_type, array("orgu_type", "prg_type"))) //#16925 + #17777
                         {
                                 $selected = array();
                         }
                         else
                         {
                                 $selected = self::getObjRecSelection($a_obj_id, $a_sub_type);
                         }
                         foreach($optional as $record_id)
                         {
                                 if(!in_array($record_id, $selected))
                                 {
                                         unset($records[$record_id]);
                                 }
                         }
                 }
                 
                 /* v1 obsolete          
                 $query = "SELECT amro.record_id record_id FROM adv_md_record_objs amro ".
                         "JOIN adv_md_record amr ON (amr.record_id = amro.record_id) ".
                         "JOIN adv_md_obj_rec_select os ON (amr.record_id = os.rec_id AND amro.sub_type = os.sub_type) ".
                         "WHERE active = 1 ".
                         "AND amro.obj_type = ".$ilDB->quote($a_obj_type ,'text')." ".
                         "AND amro.sub_type = ".$ilDB->quote($a_sub_type ,'text')." ".
                         "AND os.obj_id = ".$ilDB->quote($a_obj_id ,'integer')
                         ;
 
                 $res = $ilDB->query($query);
                 while($row = $res->fetchRow(ilDBConstants::FETCHMODE_OBJECT))
                 {
                         $records[] = self::_getInstanceByRecordId($row->record_id);
                 }
                 */
                 
                 return $records;
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _lookupRecordIdByImportId()

static ilAdvancedMDRecord::_lookupRecordIdByImportId ( $a_ilias_id )

static

Lookup record Id by import id.

public

Parameters

string ilias id

Definition at line 125 of file class.ilAdvancedMDRecord.php.

References $ilDB, $query, $res, $row, and ilDBConstants\FETCHMODE_OBJECT.

Referenced by ilAdvancedMDRecordParser\extractRecordId().

         {
                 global $ilDB;
                 
                 $query = "SELECT record_id FROM adv_md_record ".
                         "WHERE import_id = ".$ilDB->quote($a_ilias_id ,'text')." ";
                 $res = $ilDB->query($query);
                 while($row = $res->fetchRow(ilDBConstants::FETCHMODE_OBJECT))
                 {
                         return $row->record_id;
                 }
                 return 0;
         }

Here is the caller graph for this function:

◆ _lookupTitle()

static ilAdvancedMDRecord::_lookupTitle ( $a_record_id )

static

Lookup title.

public

Parameters

int record_id

Definition at line 98 of file class.ilAdvancedMDRecord.php.

References $ilDB, $query, $res, $row, array, and ilDBConstants\FETCHMODE_OBJECT.

Referenced by ilAdvancedMDSettingsGUI\initFormSubstitutions(), ilAdvancedMDRecordGUI\parseInfoPage(), ilECSSettingsGUI\prepareFieldSelection(), and ilLuceneAdvancedSearchFields\readSections().

         {
                 static $title_cache = array();
                 
                 if(isset($title_cache[$a_record_id]))
                 {
                         return $title_cache[$a_record_id];
                 }
                 
                 global $ilDB;
                 
                 $query = "SELECT title FROM adv_md_record ".
                         "WHERE record_id = ".$ilDB->quote($a_record_id ,'integer')." ";
                 $res = $ilDB->query($query);
                 $row = $res->fetchRow(ilDBConstants::FETCHMODE_OBJECT);
                 
                 return $title_cache[$a_record_id] = $row->title;
         }

Here is the caller graph for this function:

◆ appendAssignedObjectType()

ilAdvancedMDRecord::appendAssignedObjectType	(	$a_obj_type,
		$a_sub_type,
		$a_optional = `false`
	)

append assigned object types

public

Parameters

string ilias object type

Definition at line 641 of file class.ilAdvancedMDRecord.php.

References array.

         {
                 $this->obj_types[] = array(
                         "obj_type"=>$a_obj_type, 
                         "sub_type"=>$a_sub_type,
                         "optional"=>(bool)$a_optional
                 );
         }

◆ delete()

ilAdvancedMDRecord::delete ( )

Delete.

public

Definition at line 414 of file class.ilAdvancedMDRecord.php.

References _delete(), and getRecordId().

         {
                 ilAdvancedMDRecord::_delete($this->getRecordId());
         }

Here is the call graph for this function:

◆ generateImportId()

ilAdvancedMDRecord::generateImportId ( )

protected

generate unique record id

protected

Returns

Definition at line 768 of file class.ilAdvancedMDRecord.php.

References getRecordId().

Referenced by save(), and toXML().

         {
                 return 'il_'.IL_INST_ID.'_adv_md_record_'.$this->getRecordId();
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getAssignedObjectTypes()

ilAdvancedMDRecord::getAssignedObjectTypes ( )

Get assigned object types.

public

Definition at line 656 of file class.ilAdvancedMDRecord.php.

References array.

Referenced by _clone(), isAssignedObjectType(), save(), toXML(), and update().

         {
                 return $this->obj_types ? $this->obj_types : array();
         }

Here is the caller graph for this function:

◆ getDescription()

ilAdvancedMDRecord::getDescription ( )

get description

public

Definition at line 594 of file class.ilAdvancedMDRecord.php.

References $description.

Referenced by _clone(), save(), toXML(), and update().

         {
                 return $this->description;
         }

Here is the caller graph for this function:

◆ getImportId()

ilAdvancedMDRecord::getImportId ( )

get import id

public

Definition at line 617 of file class.ilAdvancedMDRecord.php.

References $import_id.

Referenced by save().

         {
                 return $this->import_id;        
         }

Here is the caller graph for this function:

◆ getObjRecSelection()

static ilAdvancedMDRecord::getObjRecSelection	(	$a_obj_id,
		$a_sub_type = `""`
	)

static

Get repository object record selection.

Parameters

integer	$a_obj_id	object id if repository object
array	$a_records	array of record ids that are selected (in use) by the object

Definition at line 829 of file class.ilAdvancedMDRecord.php.

References $ilDB, $r, and array.

Referenced by ilAdvancedMDValues\_cloneValues(), ilWikiExporter\getActiveAdvMDRecords(), ilAdvancedMDSettingsGUI\getParsedRecordObjects(), getSharedRecords(), and ilAdvancedMDRecordGUI\parseRecordSelection().

         {
                 global $ilDB;
                 
                 if ($a_sub_type == "")
                 {
                         $a_sub_type = "-";
                 }
                 
                 $recs = array();
                 $set = $ilDB->query($r = "SELECT * FROM adv_md_obj_rec_select ".
                         " WHERE obj_id = ".$ilDB->quote($a_obj_id, "integer").
                         " AND sub_type = ".$ilDB->quote($a_sub_type, "text")
                         );
                 while ($rec  = $ilDB->fetchAssoc($set))
                 {
                         $recs[] = $rec["rec_id"];
                 }
                 return $recs;
         }

Here is the caller graph for this function:

◆ getParentObject()

ilAdvancedMDRecord::getParentObject ( )

Definition at line 685 of file class.ilAdvancedMDRecord.php.

References $parent_obj.

Referenced by _clone(), and save().

         {               
                 return $this->parent_obj;
         }

Here is the caller graph for this function:

◆ getRecordId()

ilAdvancedMDRecord::getRecordId ( )

Get record id.

public

Definition at line 525 of file class.ilAdvancedMDRecord.php.

References $record_id.

Referenced by __construct(), __destruct(), _clone(), delete(), generateImportId(), read(), save(), toXML(), and update().

         {
                 return $this->record_id;
         }

Here is the caller graph for this function:

◆ getSharedRecords()

static ilAdvancedMDRecord::getSharedRecords	(	$a_obj1_id,
		$a_obj2_id,
		$a_sub_type = `"-"`
	)

static

Get shared records.

Parameters

int	$a_obj1_id
int	$a_obj2_id
string	$a_sub_type

Returns: array

Definition at line 887 of file class.ilAdvancedMDRecord.php.

References $res, ilObject\_lookupType(), array, and getObjRecSelection().

         {
                 $obj_type = ilObject::_lookupType($a_obj1_id);
                 $sel = array_intersect(
                         ilAdvancedMDRecord::getObjRecSelection($a_obj1_id, $a_sub_type),
                         ilAdvancedMDRecord::getObjRecSelection($a_obj2_id, $a_sub_type)
                 );
                 
                 $res = array();
                 
                 foreach(self::_getRecords() as $record)
                 {       
                         // local records cannot be shared
                         if($record->getParentObject())
                         {
                                 continue;
                         }
                         
                         // :TODO: inactive records can be ignored?
                         if(!$record->isActive())
                         {
                                 continue;
                         }
                         
                         // parse assigned types
                         foreach($record->getAssignedObjectTypes() as $item)
                         {
                                 if($item["obj_type"] == $obj_type &&
                                         $item["sub_type"] == $a_sub_type)
                                 {                               
                                         // mandatory
                                         if(!$item["optional"])
                                         {
                                                 $res[] = $record->getRecordId();
                                         }
                                         // optional
                                         else if(in_array($record->getRecordId(), $sel))
                                         {
                                                 $res[] = $record->getRecordId();
                                         }
                                 }
                         }                                       
                 }
                 
                 return $res;
         }

Here is the call graph for this function:

◆ getTitle()

ilAdvancedMDRecord::getTitle ( )

get title

public

Definition at line 571 of file class.ilAdvancedMDRecord.php.

References $title.

Referenced by _clone(), save(), toXML(), update(), and validate().

         {
                 return $this->title;
         }

Here is the caller graph for this function:

◆ isActive()

ilAdvancedMDRecord::isActive ( )

Check if record is active.

public

Definition at line 548 of file class.ilAdvancedMDRecord.php.

References $active.

Referenced by _clone(), save(), toXML(), and update().

         {
                 return (bool) $this->active;
         }

Here is the caller graph for this function:

◆ isAssignedObjectType()

ilAdvancedMDRecord::isAssignedObjectType	(	$a_obj_type,
		$a_sub_type
	)

Is assigned object type?

Parameters

Definition at line 667 of file class.ilAdvancedMDRecord.php.

References $t, and getAssignedObjectTypes().

         {
                 foreach ($this->getAssignedObjectTypes() as $t)
                 {
                         if ($t["obj_type"] == $a_obj_type &&
                                 $t["sub_type"] == $a_sub_type)
                         {
                                 return true;
                         }
                 }
                 return false;
         }

Here is the call graph for this function:

◆ read()

ilAdvancedMDRecord::read ( )

private

read record and assiged object types

private

Parameters

Definition at line 734 of file class.ilAdvancedMDRecord.php.

References $ilDB, $query, $res, $row, array, ilDBConstants\FETCHMODE_OBJECT, getRecordId(), setActive(), setDescription(), setImportId(), setParentObject(), and setTitle().

Referenced by __construct().

         {
                 global $ilDB;
                 
                 $query = "SELECT * FROM adv_md_record ".
                         "WHERE record_id = ".$this->db->quote($this->getRecordId() ,'integer')." ";
                 $res = $this->db->query($query);
                 while($row = $res->fetchRow(ilDBConstants::FETCHMODE_OBJECT))
                 {
                         $this->setImportId($row->import_id);
                         $this->setActive($row->active);
                         $this->setTitle($row->title);
                         $this->setDescription($row->description);
                         $this->setParentObject($row->parent_obj);
                 }
                 $query = "SELECT * FROM adv_md_record_objs ".
                         "WHERE record_id = ".$this->db->quote($this->getRecordId() ,'integer')." ";
                 $res = $this->db->query($query);
                 while($row = $res->fetchRow(ilDBConstants::FETCHMODE_OBJECT))
                 {
                         $this->obj_types[] = array(
                                 "obj_type" => $row->obj_type,
                                 "sub_type" => $row->sub_type,
                                 "optional" => (bool)$row->optional
                         );
                 }
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ save()

ilAdvancedMDRecord::save ( )

save

public

Definition at line 425 of file class.ilAdvancedMDRecord.php.

References $ilDB, $query, $res, generateImportId(), getAssignedObjectTypes(), getDescription(), getImportId(), getParentObject(), getRecordId(), getTitle(), and isActive().

         {
                 global $ilDB;
                 
                 // Save import id if given
                 $next_id = $ilDB->nextId('adv_md_record');
                 
                 $query = "INSERT INTO adv_md_record (record_id,import_id,active,title,description,parent_obj) ".
                         "VALUES(".
                         $ilDB->quote($next_id,'integer').", ".
                         $this->db->quote($this->getImportId(),'text').", ".
                         $this->db->quote($this->isActive() ,'integer').", ".
                         $this->db->quote($this->getTitle() ,'text').", ".
                         $this->db->quote($this->getDescription() ,'text').", ".
                         $this->db->quote($this->getParentObject() ,'integer')." ".
                         ")";
                 $res = $ilDB->manipulate($query);
                 $this->record_id = $next_id;
 
                 if(!strlen($this->getImportId()))
                 {
                         // set import id to default value
                         $query = "UPDATE adv_md_record ".
                                 "SET import_id = ".$this->db->quote($this->generateImportId() ,'text')." ".
                                 "WHERE record_id = ".$this->db->quote($this->record_id ,'integer')." ";
                         $res = $ilDB->manipulate($query);
                 }
 
                 foreach($this->getAssignedObjectTypes() as $type)
                 {
                         global $ilDB;
 
                         $query = "INSERT INTO adv_md_record_objs (record_id,obj_type,sub_type,optional) ".
                                 "VALUES( ".
                                 $this->db->quote($this->getRecordId() ,'integer').", ".
                                 $this->db->quote($type["obj_type"] ,'text').", ".
                                 $this->db->quote($type["sub_type"] ,'text').", ".
                                 $this->db->quote($type["optional"] ,'integer')." ".
                                 ")";
                         $res = $ilDB->manipulate($query);
                 }
         }

Here is the call graph for this function:

◆ saveObjRecSelection()

static ilAdvancedMDRecord::saveObjRecSelection	(		$a_obj_id,
			$a_sub_type = `""`,
		array	$a_records = `null`,
			$a_delete_before = `true`
	)

static

Save repository object record selection.

Parameters

integer	$a_obj_id	object id if repository object
array	$a_records	array of record ids that are selected (in use) by the object

Definition at line 790 of file class.ilAdvancedMDRecord.php.

References $ilDB, and $r.

Referenced by ilAdvancedMDValues\_cloneValues(), ilStudyProgrammeType\getAvailableAdvancedMDRecords(), ilOrgUnitType\getAvailableAdvancedMDRecords(), ilAdvancedMetaDataImporter\importXmlRepresentation(), ilAdvancedMDRecordGUI\saveSelection(), ilObjOrgUnit\update(), ilObjStudyProgramme\update(), and ilAdvancedMDSettingsGUI\updateRecords().

         {
                 global $ilDB;
                 
                 if ($a_sub_type == "")
                 {
                         $a_sub_type = "-";
                 }
 
                 if((bool)$a_delete_before)
                 {
                         $ilDB->manipulate("DELETE FROM adv_md_obj_rec_select WHERE ".
                                 " obj_id = ".$ilDB->quote($a_obj_id, "integer").
                                 " AND sub_type = ".$ilDB->quote($a_sub_type, "text"));
                 }
                 
                 if (is_array($a_records))
                 {
                         foreach ($a_records as $r)
                         {
                                 if ($r > 0)
                                 {
                                         $ilDB->manipulate("INSERT INTO adv_md_obj_rec_select ".
                                                 "(obj_id, rec_id, sub_type) VALUES (".
                                                 $ilDB->quote($a_obj_id, "integer").",".
                                                 $ilDB->quote($r, "integer").",".
                                                 $ilDB->quote($a_sub_type, "text").
                                                 ")");
                                 }
                         }
                 }
         }

Here is the caller graph for this function:

◆ setActive()

ilAdvancedMDRecord::setActive ( $a_active )

Set active.

public

Parameters

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

Referenced by read().

         {
                 $this->active = $a_active;
         }

Here is the caller graph for this function:

◆ setAssignedObjectTypes()

ilAdvancedMDRecord::setAssignedObjectTypes ( $a_obj_types )

Set assigned object types.

public

Parameters

array array(string) array of object types. E.g array('crs','crsl')

Definition at line 629 of file class.ilAdvancedMDRecord.php.

         {
                 $this->obj_types = $a_obj_types;
         }

◆ setDescription()

ilAdvancedMDRecord::setDescription ( $a_description )

set description

public

Parameters

string description

Definition at line 583 of file class.ilAdvancedMDRecord.php.

Referenced by read().

         {
                 $this->description = $a_description;
         }

Here is the caller graph for this function:

◆ setImportId()

ilAdvancedMDRecord::setImportId ( $a_id_string )

set import id

public

Parameters

string import id

Definition at line 606 of file class.ilAdvancedMDRecord.php.

Referenced by read().

         {
                 $this->import_id = $a_id_string;
         }

Here is the caller graph for this function:

◆ setParentObject()

ilAdvancedMDRecord::setParentObject ( $a_obj_id )

Definition at line 680 of file class.ilAdvancedMDRecord.php.

Referenced by read().

         {               
                 $this->parent_obj = $a_obj_id;
         }

Here is the caller graph for this function:

◆ setTitle()

ilAdvancedMDRecord::setTitle ( $a_title )

Set title.

public

Parameters

string title

Definition at line 560 of file class.ilAdvancedMDRecord.php.

Referenced by read().

         {
                 $this->title = $a_title;
         }

Here is the caller graph for this function:

◆ toXML()

ilAdvancedMDRecord::toXML ( ilXmlWriter $writer )

To Xml.

This method writes only the subset Record (including all fields) Use class.ilAdvancedMDRecordXMLWriter to generate a complete xml presentation.

public

Parameters

object ilXmlWriter

Definition at line 699 of file class.ilAdvancedMDRecord.php.

References array, generateImportId(), getAssignedObjectTypes(), getDescription(), ilAdvancedMDFieldDefinition\getInstancesByRecordId(), getRecordId(), getTitle(), isActive(), ilXmlWriter\xmlElement(), ilXmlWriter\xmlEndTag(), and ilXmlWriter\xmlStartTag().

         {
                 $writer->xmlStartTag('Record',array('active' => $this->isActive() ? 1 : 0,
                         'id' => $this->generateImportId()));
                 $writer->xmlElement('Title',null,$this->getTitle());
                 $writer->xmlElement('Description',null,$this->getDescription());
                 
                 foreach($this->getAssignedObjectTypes() as $obj_type)
                 {
                         $optional = array("optional"=>$obj_type["optional"]);
                         if ($obj_type["sub_type"] == "")
                         {
                                 $writer->xmlElement('ObjectType',$optional,$obj_type["obj_type"]);
                         }
                         else
                         {
                                 $writer->xmlElement('ObjectType',$optional,$obj_type["obj_type"].":".$obj_type["sub_type"]);
                         }
                 }
                 
                 include_once('Services/AdvancedMetaData/classes/class.ilAdvancedMDFieldDefinition.php');
                 foreach(ilAdvancedMDFieldDefinition::getInstancesByRecordId($this->getRecordId()) as $definition)
                 {
                         $definition->toXML($writer);
                 }
                 $writer->xmlEndTag('Record');
         }

Here is the call graph for this function:

◆ update()

ilAdvancedMDRecord::update ( )

update

public

Definition at line 474 of file class.ilAdvancedMDRecord.php.

References $ilDB, $query, $res, getAssignedObjectTypes(), getDescription(), getRecordId(), getTitle(), and isActive().

         {
                 global $ilDB;
                 
                 $query = "UPDATE adv_md_record ".
                         "SET active = ".$this->db->quote($this->isActive() ,'integer').", ".
                         "title = ".$this->db->quote($this->getTitle() ,'text').", ".
                         "description = ".$this->db->quote($this->getDescription() ,'text')." ".
                         "WHERE record_id = ".$this->db->quote($this->getRecordId() ,'integer')." ";
                 $res = $ilDB->manipulate($query);
                                 
                 // Delete assignments
                 $query = "DELETE FROM adv_md_record_objs ".
                         "WHERE record_id = ".$this->db->quote($this->getRecordId() ,'integer')." ";
                 $res = $ilDB->manipulate($query);
                         
                 // Insert assignments
                 foreach($this->getAssignedObjectTypes() as $type)
                 {
                         $query = "INSERT INTO adv_md_record_objs (record_id,obj_type,sub_type,optional) ".
                                 "VALUES ( ".
                                 $this->db->quote($this->getRecordId() ,'integer').", ".
                                 $this->db->quote($type["obj_type"] ,'text').", ".
                                 $this->db->quote($type["sub_type"] ,'text').", ".
                                 $this->db->quote($type["optional"] ,'integer')." ".
                                 ")";
                         $res = $ilDB->manipulate($query);
                 }
         }

Here is the call graph for this function:

◆ validate()

ilAdvancedMDRecord::validate ( )

Validate settings.

public

Definition at line 510 of file class.ilAdvancedMDRecord.php.

References getTitle().

         {               
                 if(!strlen($this->getTitle()))
                 {                       
                         return false;
                 }
                 return true;
         }

Here is the call graph for this function:

Field Documentation

◆ $active

ilAdvancedMDRecord::$active

protected

Definition at line 21 of file class.ilAdvancedMDRecord.php.

Referenced by isActive().

◆ $db

ilAdvancedMDRecord::$db = null

protected

Definition at line 25 of file class.ilAdvancedMDRecord.php.

◆ $description

ilAdvancedMDRecord::$description

protected

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

Referenced by getDescription().

◆ $import_id

ilAdvancedMDRecord::$import_id

protected

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

Referenced by getImportId().

◆ $instances

ilAdvancedMDRecord::$instances = array()

staticprivate

Definition at line 17 of file class.ilAdvancedMDRecord.php.

◆ $obj_types

ilAdvancedMDRecord::$obj_types = array()

protected

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

Referenced by _getActivatedObjTypes().

◆ $parent_obj

ilAdvancedMDRecord::$parent_obj

protected

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

Referenced by getParentObject().

◆ $record_id

ilAdvancedMDRecord::$record_id

protected

Definition at line 19 of file class.ilAdvancedMDRecord.php.

Referenced by _getSelectedRecordsByObject(), and getRecordId().

◆ $title

ilAdvancedMDRecord::$title

protected

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

Referenced by getTitle().

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

Services/AdvancedMetaData/classes/class.ilAdvancedMDRecord.php

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Private Member Functions

Static Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

◆ __destruct()

Member Function Documentation

◆ _clone()

◆ _delete()

◆ _getActivatedObjTypes()

◆ _getActivatedRecordsByObjectType()

◆ _getActiveSearchableRecords()

◆ _getAllRecordsByObjectType()

◆ _getAssignableObjectTypes()

◆ _getInstanceByRecordId()

◆ _getRecords()

◆ _getSelectedRecordsByObject()

◆ _lookupRecordIdByImportId()

◆ _lookupTitle()

◆ appendAssignedObjectType()

◆ delete()

◆ generateImportId()

◆ getAssignedObjectTypes()

◆ getDescription()

◆ getImportId()

◆ getObjRecSelection()

◆ getParentObject()

◆ getRecordId()

◆ getSharedRecords()

◆ getTitle()

◆ isActive()

◆ isAssignedObjectType()

◆ read()

◆ save()

◆ saveObjRecSelection()

◆ setActive()

◆ setAssignedObjectTypes()

◆ setDescription()

◆ setImportId()

◆ setParentObject()

◆ setTitle()

◆ toXML()

◆ update()

◆ validate()

Field Documentation

◆ $active

◆ $db

◆ $description

◆ $import_id

◆ $instances

◆ $obj_types

◆ $parent_obj

◆ $record_id

◆ $title