SAX based XML parser for record import files. More...

Inheritance diagram for ilAdvancedMDRecordParser:

Collaboration diagram for ilAdvancedMDRecordParser:

Public Member Functions
	__construct ($a_file)
	Constructor. More...

	setMode ($a_mode)
	set parsing mode More...

	getMode ()
	get mode More...

	startParsing ()
	stores xml data in array More...

	setHandlers ($a_xml_parser)
	set event handlers More...

	setContext ($a_obj_id, $a_obj_type, $a_sub_type=null)

	getRecordMap ()

Data Fields
const	MODE_UPDATE = 1

const	MODE_INSERT = 2

const	MODE_UPDATE_VALIDATION = 3

const	MODE_INSERT_VALIDATION = 4

Protected Member Functions
	handlerBeginTag ($a_xml_parser, $a_name, $a_attribs)
	Handler for start tags. More...

	handlerEndTag ($a_xml_parser, $a_name)
	Handler for end tags. More...

	handlerCharacterData ($a_xml_parser, $a_data)
	handler for character data More...

Protected Attributes
	$context

	$log

Private Member Functions
	initRecordObject ($a_id)
	Init record object. More...

	initFieldObject ($a_id, $a_type)
	Init field definition object. More...

	getCurrentRecord ()
	get current record More...

	getCurrentField ()
	get current field definition private More...

	extractRecordId ($a_id_string)
	Extract id. More...

	appendErrorMessage ($a_msg)
	private More...

	storeRecords ()
	Store Record. More...

Private Attributes
	$mode

	$fields = array()

	$is_error = false

	$error_msg = array()

Detailed Description

SAX based XML parser for record import files.

Author: Stefan Meyer meyer.nosp@m.@lei.nosp@m.fos.c.nosp@m.om

Version: $Id$

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

Constructor & Destructor Documentation

◆ __construct()

ilAdvancedMDRecordParser::__construct ( $a_file )

Constructor.

public

Parameters

string xml file

Definition at line 65 of file class.ilAdvancedMDRecordParser.php.

References ilLoggerFactory\getLogger().

         {
                 parent::__construct($a_file,true);
                 $this->log = ilLoggerFactory::getLogger('amet');
         }

Here is the call graph for this function:

Member Function Documentation

◆ appendErrorMessage()

ilAdvancedMDRecordParser::appendErrorMessage ( $a_msg )

private

Parameters

Definition at line 350 of file class.ilAdvancedMDRecordParser.php.

Referenced by handlerBeginTag().

         {
                 $this->is_error = true;
                 $this->error_msg[] = $a_msg;
         }

Here is the caller graph for this function:

◆ extractRecordId()

ilAdvancedMDRecordParser::extractRecordId ( $a_id_string )

private

Extract id.

private

Parameters

Definition at line 330 of file class.ilAdvancedMDRecordParser.php.

References ilAdvancedMDRecord\_lookupRecordIdByImportId().

Referenced by initRecordObject().

         {
                 // first lookup import id
                 if($record_id = ilAdvancedMDRecord::_lookupRecordIdByImportId($a_id_string))
                 {
                         $this->record_exists = true;
                         return $record_id;
                 }
                 return 0;               
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getCurrentField()

ilAdvancedMDRecordParser::getCurrentField ( )

private

get current field definition private

Definition at line 318 of file class.ilAdvancedMDRecordParser.php.

Referenced by handlerBeginTag(), and handlerEndTag().

         {
                 return $this->current_field;
         }

Here is the caller graph for this function:

◆ getCurrentRecord()

ilAdvancedMDRecordParser::getCurrentRecord ( )

private

get current record

private

Definition at line 308 of file class.ilAdvancedMDRecordParser.php.

Referenced by handlerBeginTag(), handlerEndTag(), and storeRecords().

         {
                 return $this->current_record;
         }

Here is the caller graph for this function:

◆ getMode()

ilAdvancedMDRecordParser::getMode ( )

get mode

public

Definition at line 89 of file class.ilAdvancedMDRecordParser.php.

References $mode.

Referenced by initFieldObject(), initRecordObject(), and storeRecords().

         {
                 return $this->mode;
         }

Here is the caller graph for this function:

◆ getRecordMap()

ilAdvancedMDRecordParser::getRecordMap ( )

Definition at line 418 of file class.ilAdvancedMDRecordParser.php.

         {
                 return $this->rec_map;
         }       

◆ handlerBeginTag()

ilAdvancedMDRecordParser::handlerBeginTag	(	$a_xml_parser,
		$a_name,
		$a_attribs
	)

protected

Handler for start tags.

protected

Definition at line 130 of file class.ilAdvancedMDRecordParser.php.

References appendErrorMessage(), fields, getCurrentField(), getCurrentRecord(), initFieldObject(), and initRecordObject().

         {
                 switch($a_name)
                 {
                         case 'AdvancedMetaDataRecords':
                                 $this->is_error = false;
                                 $this->error_msg = array();
                                 // Nothing to do
                                 break;
                         
                         case 'Record':
                                 $this->fields = array();
                                 $this->current_field = null;
                                 $this->current_record = null;
                                 if(!strlen($a_attribs['id']) or !isset($a_attribs['active']))
                                 {
                                         $this->appendErrorMessage('Missing XML attribute for element "Record".');
                                 }
                                 if(!$this->initRecordObject($a_attribs['id']))
                                 {
                                         $this->appendErrorMessage('Invalid attribute Id given for element "Record".');
                                 }
                                 $this->getCurrentRecord()->setActive($a_attribs['active']);
                                 $this->getCurrentRecord()->setImportId($a_attribs['id']);
                                 $this->getCurrentRecord()->setAssignedObjectTypes(array());
                                 break;
                                 
                         case 'Title':
                                 break;
 
                         case 'Field':
                                 if(!strlen($a_attribs['id']) or !isset($a_attribs['searchable']) or !isset($a_attribs['fieldType']))
                                 {
                                         $this->appendErrorMessage('Missing XML attribute for element "Field".');
                                 }
                                 if(!$this->initFieldObject($a_attribs['id'], $a_attribs['fieldType']))
                                 {
                                         $this->appendErrorMessage('Invalid attribute Id given for element "Record".');
                                 }                               
                                 $this->getCurrentField()->setImportId($a_attribs['id']);                                
                                 $this->getCurrentField()->setSearchable($a_attribs['searchable'] == 'Yes' ? true : false);
                                 break;
                                 
                         case 'FieldTitle':
                         case 'FieldDescription':
                         case 'FieldPosition':
                         case 'FieldValue':
                                 $this->field_value_id = $a_attribs['id'];
                                 break;
                 }
         }

Here is the call graph for this function:

◆ handlerCharacterData()

ilAdvancedMDRecordParser::handlerCharacterData	(	$a_xml_parser,
		$a_data
	)

protected

handler for character data

Parameters

resource	$a_xml_parser	xml parser
string	$a_data	character data

Definition at line 241 of file class.ilAdvancedMDRecordParser.php.

         {
                 if($a_data != "\n")
                 {
                         // Replace multiple tabs with one space
                         $a_data = preg_replace("/\t+/"," ",$a_data);
 
                         $this->cdata .= $a_data;
                 }
         }

◆ handlerEndTag()

ilAdvancedMDRecordParser::handlerEndTag	(	$a_xml_parser,
		$a_name
	)

protected

Handler for end tags.

protected

Definition at line 187 of file class.ilAdvancedMDRecordParser.php.

References getCurrentField(), getCurrentRecord(), and storeRecords().

         {
                 switch($a_name)
                 {
                         case 'AdvancedMetaDataRecords':
                                 break;
                                 
                         case 'Record':
                                 $this->storeRecords();
                                 break;
                                 
                         case 'Title':
                                 $this->getCurrentRecord()->setTitle(trim($this->cdata));
                                 break;
                                 
                         case 'Description':
                                 $this->getCurrentRecord()->setDescription(trim($this->cdata));
                                 break;
                                 
                         case 'ObjectType':
                                 // #12980
                                 $parts = explode(":", trim($this->cdata));
                                 $this->getCurrentRecord()->appendAssignedObjectType($parts[0], $parts[1]);                              
                                 break;
                                 
                         case 'Field':
                                 break;
                         
                                 
                         case 'FieldTitle':
                                 $this->getCurrentField()->setTitle(trim($this->cdata));
                                 break;
                         
                         case 'FieldDescription':
                                 $this->getCurrentField()->setDescription(trim($this->cdata));
                                 break;
                                 
                         case 'FieldPosition':
                                 $this->getCurrentField()->setPosition((int) trim($this->cdata));
                                 break;
                                 
                         case 'FieldValue':
                                 $this->getCurrentField()->importXMLProperty($this->field_value_id, trim($this->cdata));
                                 break;
                 }
                 $this->cdata = '';
         }

Here is the call graph for this function:

◆ initFieldObject()

ilAdvancedMDRecordParser::initFieldObject	(	$a_id,
		$a_type
	)

private

Init field definition object.

private

Parameters

string import id

Definition at line 282 of file class.ilAdvancedMDRecordParser.php.

References fields, ilAdvancedMDFieldDefinition\getInstanceByTypeString(), and getMode().

Referenced by handlerBeginTag().

         {
                 switch($this->getMode())
                 {
                         case self::MODE_INSERT:
                         case self::MODE_INSERT_VALIDATION:
                                 $this->current_field = ilAdvancedMDFieldDefinition::getInstanceByTypeString($a_type);
                                 $this->fields[] = $this->current_field;
                                 return true;
                         
                         default:
                                 // ??? nonsense
                                 $this->current_field = ilAdvancedMDRecord::_getInstanceByFieldId($this->extractFieldId($a_id));
                                 return true;
                                 break;
                 }
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ initRecordObject()

ilAdvancedMDRecordParser::initRecordObject ( $a_id )

private

Init record object.

Parameters

string import id private

Definition at line 259 of file class.ilAdvancedMDRecordParser.php.

References ilAdvancedMDRecord\_getInstanceByRecordId(), extractRecordId(), and getMode().

Referenced by handlerBeginTag().

         {
                 switch($this->getMode())
                 {
                         case self::MODE_INSERT:
                         case self::MODE_INSERT_VALIDATION:
                                 $this->current_record = new ilAdvancedMDRecord(0);
                                 return true;
                         
                         default:
                                 $this->current_record = ilAdvancedMDRecord::_getInstanceByRecordId($this->extractRecordId($a_id));
                                 return true;
                                 break;
                 }
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setContext()

ilAdvancedMDRecordParser::setContext	(	$a_obj_id,
		$a_obj_type,
		$a_sub_type = `null`
	)

Definition at line 404 of file class.ilAdvancedMDRecordParser.php.

Referenced by ilAdvancedMDSettingsGUI\importRecord().

         {
                 if(!$a_sub_type)
                 {
                         $a_sub_type = "-";
                 }
                 
                 $this->context = array(
                         "obj_id" => $a_obj_id,
                         "obj_type" => $a_obj_type,
                         "sub_type" => $a_sub_type
                 );              
         }

Here is the caller graph for this function:

◆ setHandlers()

ilAdvancedMDRecordParser::setHandlers ( $a_xml_parser )

set event handlers

Parameters

resource reference to the xml parser private

Definition at line 118 of file class.ilAdvancedMDRecordParser.php.

         {
                 xml_set_object($a_xml_parser,$this);
                 xml_set_element_handler($a_xml_parser,'handlerBeginTag','handlerEndTag');
                 xml_set_character_data_handler($a_xml_parser,'handlerCharacterData');
         }

◆ setMode()

ilAdvancedMDRecordParser::setMode ( $a_mode )

set parsing mode

public

Parameters

int	MODE_VALIDATION, MODE_UPDATE or MODE_INSERT

Definition at line 78 of file class.ilAdvancedMDRecordParser.php.

         {
                 $this->mode = $a_mode;
         }

◆ startParsing()

ilAdvancedMDRecordParser::startParsing ( )

stores xml data in array

Returns: bool success status private

Exceptions

ilSaxParserException

Definition at line 102 of file class.ilAdvancedMDRecordParser.php.

         {
                 parent::startParsing();
                 if($this->is_error)
                 {
                         include_once('./Services/Xml/exceptions/class.ilSaxParserException.php');
                         throw new ilSaxParserException(implode('<br/>',$this->error_msg));
                 }
         }       

◆ storeRecords()

ilAdvancedMDRecordParser::storeRecords ( )

private

Store Record.

private

Parameters

Definition at line 363 of file class.ilAdvancedMDRecordParser.php.

References fields, getCurrentRecord(), and getMode().

Referenced by handlerEndTag().

         {
                 switch($this->getMode())
                 {
                         case self::MODE_INSERT_VALIDATION:
                         case self::MODE_UPDATE_VALIDATION:
                                 return true;    
                         
                         case self::MODE_INSERT:
                                 // set local context
                                 if(is_array($this->context))
                                 {
                                         $this->getCurrentRecord()->setParentObject($this->context["obj_id"]);
                                         $this->getCurrentRecord()->setAssignedObjectTypes(array(
                                                 array(
                                                         "obj_type" => $this->context["obj_type"],
                                                         "sub_type" => $this->context["sub_type"],
                                                         "optional" => false                                                     
                                         )));
                                 }
                                 
                                 $this->getCurrentRecord()->save();
                                 break;
                 }       
                 foreach($this->fields as $field)
                 {
                         $field->setRecordId($this->getCurrentRecord()->getRecordId());
                         switch($this->getMode())
                         {
                                 case self::MODE_INSERT:
                                         $field->save();
                                         
                                         // see getRecordMap()
                                         $this->log->debug("add to record map, rec id: ".$this->getCurrentRecord()->getRecordId().
                                                 ", import id: ".$field->getImportId().", field id:".$field->getFieldId());
                                         $this->rec_map[$this->getCurrentRecord()->getRecordId()][$field->getImportId()] = $field->getFieldId();
                                         break;
                         }                       
                 }               
         }