OS4X plugin os4xplugin manipulate xml - Revision history

Admin: /* Configuration */

2019-09-24T14:33:00Z

Configuration

Admin: /* Scenario 2: change virtual filename based on real filename (multiple files in job) */

2017-07-27T09:59:05Z

Scenario 2: change virtual filename based on real filename (multiple files in job)

Admin: /* Scenario 3: create new XML node based on real filename */

2017-07-27T09:58:47Z

Scenario 3: create new XML node based on real filename

Admin: /* Scenario 2: change virtual filename based on real filename (multiple files in job) */

2017-07-27T09:58:32Z

Scenario 2: change virtual filename based on real filename (multiple files in job)

Admin: /* Scenario 1: change virtual filename based on real filename */

2017-07-27T09:55:24Z

Scenario 1: change virtual filename based on real filename

Admin: /* Scenario 1: change virtual filename based on real filename */

2017-07-27T09:55:06Z

Scenario 1: change virtual filename based on real filename

Admin at 09:54, 27 July 2017

2017-07-27T09:54:41Z

Admin at 09:52, 27 July 2017

2017-07-27T09:52:36Z

Admin at 09:48, 27 July 2017

2017-07-27T09:48:13Z

Admin: New page: Category:Plugins == Purpose == Manipulate job XML nodes via regular expressions, based on the content of the same or other XML nodes of the job XML. == Requirements == *OS4X Enterpris...

2017-07-27T09:43:30Z

New page: Category:Plugins == Purpose == Manipulate job XML nodes via regular expressions, based on the content of the same or other XML nodes of the job XML. == Requirements == *OS4X Enterpris...

New page

[[Category:Plugins]]
== Purpose ==
Manipulate job XML nodes via regular expressions, based on the content of the same or other XML nodes of the job XML.

== Requirements ==
*OS4X Enterprise license

== Configuration ==
*Source XPath: the source XPath expression of a XML node which contains the source text information.
*Modification regular expression: the Perl regular expression (preg) rule which defines the result text, based on the source XML node text.
*Target XPath: the target XPath expression, where the target extrapolated information is stored.
*Create non-existing target XPath: if the last node of the target XPath is not-existant, the plugin will create it.

@@ Line 67: / Line 67: @@
 <pre>
 <job_file>
-      <real_filename>Other_DELIVERY.dat</real_filename>
+   <real_filename>Other_DELIVERY.dat</real_filename>
-      <virtual_filename>DELIVERY</virtual_filename>
+   <virtual_filename>DELIVERY</virtual_filename>
 </job_file>
 <job_file>
-      <real_filename>Yanfeng_DESADV.dat</real_filename>
+   <real_filename>Yanfeng_DESADV.dat</real_filename>
-      <virtual_filename>DESADV</virtual_filename>
+   <virtual_filename>DESADV</virtual_filename>
 </job_file>
 </pre>

@@ Line 95: / Line 95: @@
 Retrying with XPath [/OS4X_job/job_information/job_file]...
 Target XPath expression found with one resultset.
-'''Appending XML node: [my_own_node]'''
+Appending XML node: [my_own_node]
 </pre>

@@ Line 43: / Line 43: @@
   Yanfeng_DESADV.dat
   Other_DELIVERY.dat
 *Source XPath: /OS4X_job/job_information/job_file/real_filename
 *Modification regular expression: .*_(.*)..*
@@ Line 72: / Line 73: @@
        <real_filename>Yanfeng_DESADV.dat</real_filename>
        <virtual_filename>DESADV</virtual_filename>
 </job_file>
 </pre>

@@ Line 39: / Line 39: @@
 </pre>
-=== Scenario 1: change virtual filename based on real filename ===
+=== Scenario 2: change virtual filename based on real filename (multiple files in job) ===
 Filename examples in job:
   Yanfeng_DESADV.dat

@@ Line 68: / Line 68: @@
        <real_filename>Other_DELIVERY.dat</real_filename>
        <virtual_filename>DELIVERY</virtual_filename>
-    </job_file>
+</job_file>
-    <job_file>
+<job_file>
        <real_filename>Yanfeng_DESADV.dat</real_filename>
        <virtual_filename>DESADV</virtual_filename>
-    </job_file>
+</job_file>
 </pre>

@@ Line 11: / Line 11: @@
 *Target XPath: the target XPath expression, where the target extrapolated information is stored.
 *Create non-existing target XPath: if the last node of the target XPath is not-existant, the plugin will create it.
 == Behaviour ==

@@ Line 21: / Line 21: @@
 == Examples ==
 === Scenario 1: change virtual filename based on real filename ===
-Filename example:
+Filename example in job:
   Yanfeng_DESADV.dat
@@ Line 37: / Line 37: @@
 Replacement of regular expression #1: [DESADV]
 Target XPath expression found with one resultset.
 </pre>

← Older revision		Revision as of 09:52, 27 July 2017
Line 12:		Line 12:
	*Create non-existing target XPath: if the last node of the target XPath is not-existant, the plugin will create it.		*Create non-existing target XPath: if the last node of the target XPath is not-existant, the plugin will create it.

		+	== Behaviour ==
		+	*The exact same amount of source XPath results must exist as the amount of target XPath results
		+	**If you modify files in a job, you can only modify target XPaths of the same amount, which is normally a file target XPath.
		+	*The source XPath must be a XML node containing text. Empty text sources lead to a plugin error which aborts the job.
		+	*If the target text is empty, the plugin exits with an error and the job aborts.
		+	*When dealing with multiple XML results for source and target XPath expressions, the calculated target value is always put in the same XML structure where source source is located (but with calculated values of the corresponding node, see examples below).

	== Examples ==		== Examples ==

← Older revision		Revision as of 09:48, 27 July 2017
Line 11:		Line 11:
	*Target XPath: the target XPath expression, where the target extrapolated information is stored.		*Target XPath: the target XPath expression, where the target extrapolated information is stored.
	*Create non-existing target XPath: if the last node of the target XPath is not-existant, the plugin will create it.		*Create non-existing target XPath: if the last node of the target XPath is not-existant, the plugin will create it.
		+
		+
		+	== Examples ==
		+	=== Scenario 1: change virtual filename based on real filename ===
		+	Filename example:
		+	Yanfeng_DESADV.dat
		+
		+	*Source XPath: /OS4X_job/job_information/job_file/real_filename
		+	Modification regular expression: ._(.)..
		+	*Target XPath: /OS4X_job/job_information/job_file/virtual_filename
		+
		+	Plugin output:
		+	<pre>
		+	Source XPath: '/OS4X_job/job_information/job_file/real_filename'.
		+	Modifying regular expression: '._(.)\..*'.
		+	Target XPath: '/OS4X_job/job_information/job_file/virtual_filename'.
		+
		+	Source information #1: [Yanfeng_DESADV.dat]
		+	Replacement of regular expression #1: [DESADV]
		+	Target XPath expression found with one resultset.
		+	</pre>