XML writer class. More...

Inheritance diagram for ilExerciseXMLWriter:

Collaboration diagram for ilExerciseXMLWriter:

Public Member Functions
	ilExerciseXMLWriter ()
	constructor More...

	setExercise (& $exercise)
	set exercise object More...

	setAttachFileContents ($attachFileContents)
	set attachment content mode More...

	start ()

	getXML ()

	__buildHeader ()

	__buildFooter ()

	setAttachMembers ($value)
	write access to property attchMarkings More...

Public Member Functions inherited from ilXmlWriter
	ilXmlWriter ($version="1.0", $outEnc="utf-8", $inEnc="utf-8")
	constructor More...

	_ilXmlWriter ()
	destructor @access public More...

	xmlSetDtdDef ($dtdDef)
	Sets dtd definition. More...

	xmlSetStSheet ($stSheet)
	Sets stylesheet. More...

	xmlSetGenCmt ($genCmt)
	Sets generated comment. More...

	_xmlEscapeData ($data)
	Escapes reserved characters. More...

	xmlEncodeData ($data)
	Encodes text from input encoding into output encoding. More...

	xmlFormatData ($data)
	Indents text for better reading. More...

	xmlFormatElement ($array)
	Callback function for xmlFormatData; do not invoke directly. More...

	xmlHeader ()
	Writes xml header @access public. More...

	xmlStartTag ($tag, $attrs=NULL, $empty=FALSE, $encode=TRUE, $escape=TRUE)
	Writes a starttag. More...

	xmlEndTag ($tag)
	Writes an endtag. More...

	xmlComment ($comment)
	Writes a comment. More...

	xmlData ($data, $encode=TRUE, $escape=TRUE)
	Writes data. More...

	xmlElement ($tag, $attrs=NULL, $data=Null, $encode=TRUE, $escape=TRUE)
	Writes a basic element (no children, just textual content) More...

	xmlDumpFile ($file, $format=TRUE)
	Dumps xml document from memory into a file. More...

	xmlDumpMem ($format=TRUE)
	Returns xml document from memory. More...

	appendXML ($a_str)
	append xml string to document More...

	xmlClear ()
	clears xmlStr @access public More...

Data Fields
	$attachFileContents

	$attachMembers

	$exercise

Data Fields inherited from ilXmlWriter
	$xmlStr

	$version

	$outEnc

	$inEnc

	$dtdDef = ""

	$stSheet = ""

	$genCmt = "Generated by ILIAS XmlWriter"

Static Public Attributes
static	$CONTENT_ATTACH_NO = 0

static	$CONTENT_ATTACH_ENCODED = 1

static	$CONTENT_ATTACH_ZLIB_ENCODED = 2

static	$CONTENT_ATTACH_GZIP_ENCODED = 3

static	$STATUS_NOT_GRADED = "NOT_GRADED"

static	$STATUS_PASSED = "PASSED"

static	$STATUS_FAILED = "FAILED"

Private Member Functions
	attachMarking ($user_id, $assignment_id)
	attach marking tag to member for given assignment More...

	handleAssignmentFiles ($ex_id, $as_id)

	handleAssignmentMembers ($ex_id, $assignment_id)
	create xml for files per assignment More...

Detailed Description

XML writer class.

Class to simplify manual writing of xml documents. It only supports writing xml sequentially, because the xml document is saved in a string with no additional structure information. The author is responsible for well-formedness and validity of the xml document.

Author: Roland Küstermann Rolan.nosp@m.d@ku.nosp@m.ester.nosp@m.mann.nosp@m..com

Version

Id: class.ilExerciseXMLWriter.php,v 1.3 2005/11/04 12:50:24 smeyer Exp

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

Member Function Documentation

◆ __buildFooter()

ilExerciseXMLWriter::__buildFooter ( )

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

                                 {
        
        }

Referenced by start().

Here is the caller graph for this function:

◆ __buildHeader()

ilExerciseXMLWriter::__buildHeader ( )

Definition at line 139 of file class.ilExerciseXMLWriter.php.

                                 {
                $this->xmlSetDtdDef ( "<!DOCTYPE Exercise PUBLIC \"-//ILIAS//DTD ExerciseAdministration//EN\" \"" . ILIAS_HTTP_PATH . "/xml/ilias_exercise_4_4.dtd\">" );
                $this->xmlSetGenCmt ( "Exercise Object" );
                $this->xmlHeader ();
                
                return true;
        }

References ilXmlWriter\xmlHeader(), ilXmlWriter\xmlSetDtdDef(), and ilXmlWriter\xmlSetGenCmt().

Referenced by start().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ attachMarking()

ilExerciseXMLWriter::attachMarking	(	$user_id,
		$assignment_id
	)

private

attach marking tag to member for given assignment

Parameters

int	$user_id
int	$assignment_id

Definition at line 166 of file class.ilExerciseXMLWriter.php.

                                                                 {
 
                $ass = new ilExAssignment($assignment_id);
 
                $amark = $ass->getMemberStatus($user_id)->getMark();
                $astatus = $ass->getMemberStatus($user_id)->getStatus();
                $acomment = $ass->getMemberStatus($user_id)->getComment();
                $anotice = $ass->getMemberStatus($user_id)->getNotice();
                
                
                if ($astatus == "notgraded") {
                        $status = ilExerciseXMLWriter::$STATUS_NOT_GRADED;
                } elseif ($astatus == "failed") {
                        $status = ilExerciseXMLWriter::$STATUS_FAILED;
                } else {
                        $status = ilExerciseXMLWriter::$STATUS_PASSED;
                }
                
                $this->xmlStartTag ( "Marking", array ("status" => $status ) );
                $this->xmlElement ( "Mark", null, $amark);
                $this->xmlElement ( "Notice", null, $anotice );
                $this->xmlElement ( "Comment", null, $acomment );
                $this->xmlEndTag ( "Marking" );
        }

References $STATUS_FAILED, $STATUS_NOT_GRADED, $STATUS_PASSED, ilXmlWriter\xmlElement(), ilXmlWriter\xmlEndTag(), and ilXmlWriter\xmlStartTag().

Referenced by handleAssignmentMembers().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getXML()

ilExerciseXMLWriter::getXML ( )

Definition at line 135 of file class.ilExerciseXMLWriter.php.

                          {
                return $this->xmlDumpMem ( FALSE );
        }

References ilXmlWriter\xmlDumpMem().

Here is the call graph for this function:

◆ handleAssignmentFiles()

ilExerciseXMLWriter::handleAssignmentFiles	(	$ex_id,
		$as_id
	)

private

Definition at line 191 of file class.ilExerciseXMLWriter.php.

                                                               {
                $this->xmlStartTag ( "Files" );
                include_once ("./Modules/Exercise/classes/class.ilFSStorageExercise.php");
                $storage = new ilFSStorageExercise ( $ex_id, $as_id );
                $files = $storage->getFiles ();
                
                if (count ( $files )) {
                        foreach ( $files as $file ) {
                                $this->xmlStartTag ( "File", array ("size" => $file ["size"] ) );
                                $this->xmlElement ( "Filename", null, $file ["name"] );
                                if ($this->attachFileContents) {
                                        $filename = $file ["fullpath"];
                                        if (@is_file ( $filename )) {
                                                $content = @file_get_contents ( $filename );
                                                $attribs = array ("mode" => "PLAIN" );
                                                if ($this->attachFileContents == ilExerciseXMLWriter::$CONTENT_ATTACH_ZLIB_ENCODED) {
                                                        $attribs = array ("mode" => "ZLIB" );
                                                        $content = gzcompress ( $content, 9 );
                                                } elseif ($this->attachFileContents == ilExerciseXMLWriter::$CONTENT_ATTACH_GZIP_ENCODED) {
                                                        $attribs = array ("mode" => "GZIP" );
                                                        $content = gzencode ( $content, 9 );
                                                }
                                                $content = base64_encode ( $content );
                                                $this->xmlElement ( "Content", $attribs, $content );
                                        }
                                }
                                $this->xmlEndTag ( "File" );
                        }
                }
                $this->xmlEndTag ( "Files" );
        }

References $CONTENT_ATTACH_GZIP_ENCODED, $CONTENT_ATTACH_ZLIB_ENCODED, $file, $filename, ilXmlWriter\xmlElement(), ilXmlWriter\xmlEndTag(), and ilXmlWriter\xmlStartTag().

Referenced by start().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ handleAssignmentMembers()

ilExerciseXMLWriter::handleAssignmentMembers	(	$ex_id,
		$assignment_id
	)

private

create xml for files per assignment

Parameters

integer	$ex_id	exercise id
array	$assignments	assignment id

Definition at line 229 of file class.ilExerciseXMLWriter.php.

                                                                         {
                $this->xmlStartTag ( "Members" );
                include_once ("./Modules/Exercise/classes/class.ilExerciseMembers.php");
                $members = ilExerciseMembers::_getMembers($ex_id);
                if (count ( $members )) {
                        foreach ( $members as $member_id ) {
                                $this->xmlStartTag ( "Member", array ("usr_id" => "il_" . IL_INST_ID . "_usr_" . $member_id  ) );
                                $this->attachMarking ( $member_id, $assignment_id);
                                $this->xmlEndTag ( "Member" );
                        }
                }
                $this->xmlEndTag ( "Members" );
        }

References ilExerciseMembers\_getMembers(), attachMarking(), ilXmlWriter\xmlEndTag(), and ilXmlWriter\xmlStartTag().

Referenced by start().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ilExerciseXMLWriter()

ilExerciseXMLWriter::ilExerciseXMLWriter ( )

constructor

Parameters

string	xml version
string	output encoding
string	input encoding @access public

Definition at line 59 of file class.ilExerciseXMLWriter.php.

                                       {
                // @todo: needs to be revised for multiple assignments per exercise
                //die ("Needs revision for ILIAS 4.1");
                parent::ilXmlWriter ();
                $this->attachFileContents = ilExerciseXMLWriter::$CONTENT_ATTACH_NO;
        }

References $CONTENT_ATTACH_NO.

◆ setAttachFileContents()

ilExerciseXMLWriter::setAttachFileContents ( $attachFileContents )

set attachment content mode

Parameters

int $attachFileContents

Exceptions

ilExerciseException if mode is not supported

Definition at line 82 of file class.ilExerciseXMLWriter.php.

                                                            {
                if ($attachFileContents == ilExerciseXMLWriter::$CONTENT_ATTACH_GZIP_ENCODED && ! function_exists ( "gzencode" )) {
                        throw new ilExerciseException ( "Inflating with gzip is not supported", ilExerciseException::$ID_DEFLATE_METHOD_MISMATCH );
                }
                if ($attachFileContents == ilExerciseXMLWriter::$CONTENT_ATTACH_ZLIB_ENCODED && ! function_exists ( "gzcompress" )) {
                        throw new ilExerciseException ( "Inflating with zlib (compress/uncompress) is not supported", ilExerciseException::$ID_DEFLATE_METHOD_MISMATCH );
                }
                
                $this->attachFileContents = $attachFileContents;
        }

References $attachFileContents, $CONTENT_ATTACH_GZIP_ENCODED, $CONTENT_ATTACH_ZLIB_ENCODED, and ilExerciseException\$ID_DEFLATE_METHOD_MISMATCH.

◆ setAttachMembers()

ilExerciseXMLWriter::setAttachMembers ( $value )

write access to property attchMarkings

Parameters

boolean $value

Definition at line 156 of file class.ilExerciseXMLWriter.php.

                                                 {
                $this->attachMembers = $value ? true : false;
        }

◆ setExercise()

ilExerciseXMLWriter::setExercise ( & $exercise )

set exercise object

Parameters

ilObjExercise $exercise

Definition at line 72 of file class.ilExerciseXMLWriter.php.

                                           {
                $this->exercise = & $exercise;
        }

References $exercise.

◆ start()

ilExerciseXMLWriter::start ( )

Definition at line 93 of file class.ilExerciseXMLWriter.php.

                         {
                $this->__buildHeader ();
                
                $attribs = array ("obj_id" => "il_" . IL_INST_ID . "_exc_" . $this->exercise->getId () );
                
                if ($this->exercise->getOwner ())
                        $attribs ["owner"] = "il_" . IL_INST_ID . "_usr_" . $this->exercise->getOwner ();
                
                $this->xmlStartTag ( "Exercise", $attribs );
                
                //todo: create new dtd for new assignment structure
                $this->xmlElement("Title", null,$this->exercise->getTitle());
                $this->xmlElement("Description",  null,$this->exercise->getDescription());
                //$this->xmlElement("Instruction",  null,$this->exercise->getInstruction());
                //$this->xmlElement("DueDate",  null,$this->exercise->getTimestamp());
                
 
                //todo: as a workaround use first assignment for compatibility with old exercise dtd
                $assignments = ilExAssignment::getAssignmentDataOfExercise ( $this->exercise->getId () );
                
                if (count ( $assignments ) > 0) {
                        foreach ( $assignments as $assignment ) {
                                $this->xmlStartTag ("Assignment");
                                $this->xmlElement ( "Instruction", null, $assignment ["instruction"] );
                                $this->xmlElement ( "DueDate", null, $assignment ["deadline"] );
                                
                                $this->handleAssignmentFiles ( $this->exercise->getId (), $assignment ["id"] );
                                if ($this->attachMembers)
                                {
                                        $this->handleAssignmentMembers ($this->exercise->getId (), $assignment ["id"]);
                                }
                                $this->xmlEndTag ( "Assignment" );
                        }
                }
                
 
                $this->xmlEndTag ( "Exercise" );
                $this->__buildFooter ();
                
                return true;
        }