XML Parser and DOM Tree Library/en - Versionsgeschichte

Cg: /* XML Inspector */

2026-03-07T16:23:10Z

XML Inspector

← Nächstältere Version		Version vom 7. März 2026, 16:23 Uhr
Zeile 52:		Zeile 52:

	* [[ XMLDocument Inspect DOM \| '''XMLDocument [ Inspect DOM ]''' ]]<br/> Opens a graphical inspector on a DOM tree		* [[ XMLDocument Inspect DOM \| '''XMLDocument [ Inspect DOM ]''' ]]<br/> Opens a graphical inspector on a DOM tree
	* [[ XMLDocument Inspect XML String \| '''XMLDocument [ Inspect ~~CML~~ String ]''' ]]<br/> Opens a graphical inspector on a parsed XML string		* [[ XMLDocument Inspect XML String \| '''XMLDocument [ Inspect XML String ]''' ]]<br/> Opens a graphical inspector on a parsed XML string

	=== Examples ===		=== Examples ===

Cg: /* Step 4: Automating the ZIP Archive Processing */

2026-03-06T20:31:28Z

Step 4: Automating the ZIP Archive Processing

← Nächstältere Version		Version vom 6. März 2026, 20:31 Uhr
Zeile 95:		Zeile 95:
	[[Bild:XML_Example_01a.png\|thumb\|250px\|Schema of Extract Action (to begin with)]]		[[Bild:XML_Example_01a.png\|thumb\|250px\|Schema of Extract Action (to begin with)]]

	First, you have to get the filenames from the archive. Use the ''"[ZIP File] List Contents"'' action from the standard library. This action has two output pins: one where all file names appear as one (possibly big) collection, another where each filename appears in sequence (i.e. this second pin delivers multiple values, one for each file component). This second pin is perfect for streaming: you can use this to feed a processing action, which deals with every file.		First, you have to get the filenames from the archive. Use the ''"[ZIP File] List Contents"'' action from the standard library, or the corresponding action from the new 7-zip library. This action has two output pins: one where all file names appear as one (possibly big) collection, another where each filename appears in sequence (i.e. this second pin delivers multiple values, one for each file component). This second pin is perfect for streaming: you can use this to feed a processing action, which deals with every file.
	For now, we assume that you will first have to use a filter on the names, to process only a subset of the files.		For now, we assume that you will first have to use a filter on the names, to process only a subset of the files.

Cg: /* Step2 (optional): Inspect the Files in the expecco FileBrowser */

2026-03-06T20:30:01Z

Step2 (optional): Inspect the Files in the expecco FileBrowser

← Nächstältere Version		Version vom 6. März 2026, 20:30 Uhr
Zeile 83:		Zeile 83:

	Add an archiver tab to the Filebrowser ("''File''" → "''Add Archiver Page''"), and select the file.<br>The zip-archive's contents should now be listed at the bottom. Double click on an entry to see its contents.		Add an archiver tab to the Filebrowser ("''File''" → "''Add Archiver Page''"), and select the file.<br>The zip-archive's contents should now be listed at the bottom. Double click on an entry to see its contents.
	Alternatively, you can unzip the archive via one of the standard unzip tools (for example: 7zip).		Alternatively, you can unzip the archive via one of the standard unzip tools (for example: 7zip).<br>You must use 7zip or winzip if the archive was compressed with one of the higher compression levels (the builtin zip only handles uncompressed and deflated entries).

	====== Step 3 (optional): Inspect the XML Contents of an Extracted File. ======		====== Step 3 (optional): Inspect the XML Contents of an Extracted File. ======

Cg: /* Step 1: Look at the File (how to manually detect ZIP file type) */

2026-03-06T20:27:17Z

Step 1: Look at the File (how to manually detect ZIP file type)

← Nächstältere Version		Version vom 6. März 2026, 20:27 Uhr
Zeile 76:		Zeile 76:
	* right click (in the file name list) and select the "''Properties''") menu item		* right click (in the file name list) and select the "''Properties''") menu item
	* if it is a ZIP file, there will be a line like: "MIME: ... contents:application/zip"		* if it is a ZIP file, there will be a line like: "MIME: ... contents:application/zip"
	: as an alternative, look at the file's contents shown in a text editor; if it starts with "PK", it is also likely to be a zip file. The FileBrowser can be forced to display the contents via its "''Browser''" → "''Add Texteditor Page''" menu function.		: as an alternative, look at the file's contents shown in a text editor; if it starts with "PK", it is also likely to be a zip file.<br>The FileBrowser can be forced to display the contents via its "''Browser''" → "''Add Texteditor Page''" menu function.

	====== Step2 (optional): Inspect the Files in the expecco FileBrowser ======		====== Step2 (optional): Inspect the Files in the expecco FileBrowser ======

Cg: /* Step 1: Look at the File (how to manually detect ZIP file type) */

2026-03-06T20:26:50Z

Step 1: Look at the File (how to manually detect ZIP file type)

← Nächstältere Version		Version vom 6. März 2026, 20:26 Uhr
Zeile 76:		Zeile 76:
	* right click (in the file name list) and select the "''Properties''") menu item		* right click (in the file name list) and select the "''Properties''") menu item
	* if it is a ZIP file, there will be a line like: "MIME: ... contents:application/zip"		* if it is a ZIP file, there will be a line like: "MIME: ... contents:application/zip"
	: as an alternative, look at the file's contents at ~~the~~ ~~bottom~~; if it starts with "PK", it is also likely to be a zip file.		: as an alternative, look at the file's contents shown in a text editor; if it starts with "PK", it is also likely to be a zip file. The FileBrowser can be forced to display the contents via its "''Browser''" → "''Add Texteditor Page''" menu function.

	====== Step2 (optional): Inspect the Files in the expecco FileBrowser ======		====== Step2 (optional): Inspect the Files in the expecco FileBrowser ======

Cg: /* Useful tools: */

2026-02-27T07:07:24Z

Useful tools:

← Nächstältere Version		Version vom 27. Februar 2026, 07:07 Uhr
Zeile 136:		Zeile 136:

	====== Useful tools: ======		====== Useful tools: ======
	Once you have the XML document or an element from it at hand (i.e. a DOM element), use the expecco inspector (click on a pin value after a run). The inspector will show an additional tab named "DOM", in which you can try xpathes to see which elements match. Xpath is quite powerful, and you may want to read the xpath cheat sheet to make best use of it.		Once you have the XML document or an element from it at hand (i.e. a DOM element), use the expecco inspector (click on a pin value after a run). The inspector will show an additional tab named "DOM", in which you can try xpathes to see which elements match. Xpath is quite powerful, and you may want to read the xpath cheat sheet (external link: [https://devhints.io/xpath]) to make best use of it.

	Happy extracting.		Happy extracting.

Cg: /* Steps In Between: Add Little Tests */

2026-02-27T07:05:52Z

Steps In Between: Add Little Tests

← Nächstältere Version		Version vom 27. Februar 2026, 07:05 Uhr
Zeile 127:		Zeile 127:

	====== Steps In Between: Add Little Tests ======		====== Steps In Between: Add Little Tests ======
	Please always make use of the "Test/Demo" pages, to immediately verify that ~~you~~ diagram works as expected.		Please always make use of the "Test/Demo" pages, to immediately verify that your diagram works as expected.
	So here is the test/demo of ''"Process XML File"'' and a run (by purpose with a bug initially - do you see what's wrong?).		So here is the test/demo of ''"Process XML File"'' and a run (by purpose with a bug initially - do you see what's wrong?).
	[[Bild:XML_Example_01x7.png\|thumb\|250px\|Test/Demo (with Bug)]]		[[Bild:XML_Example_01x7.png\|thumb\|250px\|Test/Demo (with Bug)]]

Cg: /* Step 6: Processing the files (each individually) */

2026-02-27T07:03:04Z

Step 6: Processing the files (each individually)

← Nächstältere Version		Version vom 27. Februar 2026, 07:03 Uhr
Zeile 107:		Zeile 107:
	====== Step 6: Processing the files (each individually) ======		====== Step 6: Processing the files (each individually) ======
	[[Bild:XML_Example_01c.png\|thumb\|250px\|Implementation of Extract Action (with output pin)]]		[[Bild:XML_Example_01c.png\|thumb\|250px\|Implementation of Extract Action (with output pin)]]
	This is best done in a separate new action. Both for easier testability and better reusability. So the filter and processing actions can later be individually reused. Thus, the filtered output is passed to a new output pin and the extract action is renamed to ''"Extract Matching from Zip Archive"''.		This is best done in a separate new action. Both for easier testability and better reusability. So the filter and processing actions can later be individually reused or enhanced. For example, the filter could be enhanced by adding a minimum-size or maximumum size check.<br>Thus, the filtered output is passed to a new output pin and the extract action is renamed to ''"Extract Matching from Zip Archive"''.

	For the processing, we use the ''"XMLDocument [from File]"'' action, which is found in the [[XML Parser and DOM Tree Library\|XML Library]]. This needs to be imported first, as those actions are not in the standard library.		For the processing, we use the ''"XMLDocument [from File]"'' action, which is found in the [[XML Parser and DOM Tree Library\|XML Library]]. This library needs to be imported first, as those actions are not in the standard library.
	<br>Make a new compound, with an input pin of type "FilenameOrString", and place & connect the ''"XMLDocument [from File]"'' inside, connecting corresponding pins. This provides the DOM tree: a hierarchical object tree as represented by the XML.		<br>Make a new compound, with an input pin of type "''FilenameOrString''", and place & connect the ''"XMLDocument [from File]"'' inside, connecting corresponding pins. This provides the DOM tree: a hierarchical object tree as represented by the XML.

	Hint: To add the XML action, press "CTRL-n" in the diagram editor, type "xml" or even "xml;file" into the filter, then the action is shown near the top of the list. Select it and press OK, or double click on it in the list.		Hint: To add the XML action, press "<KBD>CTRL-n</KBD>" in the diagram editor, type "xml" or even "xml;file" into the filter, then the action is shown near the top of the list. Select it and press OK, or double click on it in the list.

	====== Step 7: Extracting individiual values from the XML Document ======		====== Step 7: Extracting individiual values from the XML Document ======

Cg: /* Step 5: Filter */

2025-01-29T13:57:05Z

Step 5: Filter

← Nächstältere Version		Version vom 29. Januar 2025, 13:57 Uhr
Zeile 101:		Zeile 101:


	Feed the output into a ''"Filter [ Matching ]"'' action. Its input gets each file name in the archive file, its output only provides matching names. The pattern is a GLOB pattern (i.e. what you would also use as a command line argument to a shell or batch command.<br>For example, a pattern like "/foo/.xml" would give you all files which are contained in a subfolder named "foo", which have a suffix ".xml".		Feed the output into a ''"Filter [ Matching ]"'' action. Its input gets each file name in the archive file, its output only provides matching names. The pattern is a GLOB pattern (i.e. what you would also use as a command line argument to a shell or batch command).<br>For example, a pattern like "/foo/.xml" would give you all files which are contained in a subfolder named "foo", which have a suffix ".xml".

	Then finally, feed the filter's output (which are the archive names) to a ''"Zip File [Extract File]"'' step. Its output will then be the real filenames are extracted onto your temp folder (that is what "$(TmpDirectory)" stands for). Notice that the Temp folder is removed after your expecco session. If you need to preserve those files, extract them to another folder (into your home directory or the "Documents" folder, maybe)		Then finally, feed the filter's output (which are the archive names) to a ''"Zip File [Extract File]"'' step. Its output will then be the real filenames are extracted onto your temp folder (that is what "$(TmpDirectory)" stands for). Notice that the Temp folder is removed after your expecco session. If you need to preserve those files, extract them to another folder (into your home directory or the "Documents" folder, maybe)

Cg: /* Step 4: Automating the ZIP Archive Processing */

2025-01-29T13:56:34Z

Step 4: Automating the ZIP Archive Processing

← Nächstältere Version		Version vom 29. Januar 2025, 13:56 Uhr
Zeile 95:		Zeile 95:
	[[Bild:XML_Example_01a.png\|thumb\|250px\|Schema of Extract Action (to begin with)]]		[[Bild:XML_Example_01a.png\|thumb\|250px\|Schema of Extract Action (to begin with)]]

	First, you have to get the filenames from the archive. Use the ''"[ZIP File] List Contents"'' action from the standard library. This action has two output pins: one where all file names appear as one (possibly big) collection, another where each filename appears in sequence (i.e. this second pin delivers multiple values, one for each file component. This second pin is perfect for streaming: you can use this to feed a processing action, which deals with every file.		First, you have to get the filenames from the archive. Use the ''"[ZIP File] List Contents"'' action from the standard library. This action has two output pins: one where all file names appear as one (possibly big) collection, another where each filename appears in sequence (i.e. this second pin delivers multiple values, one for each file component). This second pin is perfect for streaming: you can use this to feed a processing action, which deals with every file.
	For now, we assume that you will first have to use a filter on the names, to process only a subset of the files.		For now, we assume that you will first have to use a filter on the names, to process only a subset of the files.