<
From version < 9.1 >
edited by Outhman Moustaghfir
on 2024/08/09 17:37
To version < 5.1 >
edited by Outhman Moustaghfir
on 2024/08/08 12:35
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,5 +3,3 @@
1 -= =
2 -
3 3  = SplitFile Connector Documentation =
4 4  
5 5  == Overview ==
... ... @@ -6,7 +6,7 @@
6 6  
7 7  [[image:1723111201862-594.png]]
8 8  
9 -The splitFile connector is a utility designed to split files based on specific configurations defined in an XML format. The connector supports two modes of operation: **line** and **message **mode. Below is the functional documentation for each mode, including the expected format file, sample input file, and corresponding output files.
7 +The splitFile connector is a utility designed to split files based on specific configurations defined in an XML format. The connector supports two modes of operation: **per_identifier** and **per_bloc **mode. Below is the functional documentation for each mode, including the expected format file, sample input file, and corresponding output files.
10 10  
11 11  == Usage ==
12 12  
... ... @@ -23,7 +23,7 @@
23 23   xmlns:ix="localFunction"
24 24   xmlns:fn="http://www.w3.org/2005/xpath-functions">
25 25  
26 - <SplitBy mode="" headers="" footers="" excluded="" included="" endLine="" position ="" size="" optionChar="" ></SplitBy>
24 + <Split400 mode="" headers="" footers="" ignoreItems="" identifiers="" lineseparator="" position ="" size=""/>
27 27  </ixDOC>
28 28  
29 29  {{/code}}
... ... @@ -34,18 +34,14 @@
34 34  === Key Attributes: ===
35 35  
36 36  * **Headers and Footers:** Specify header and footer lines to be included in each output file.
37 -* **endLine:** Define the character used to separate lines in the file, default value is newLine char.
38 -* (((
39 -**optionChar : **Define the character used to separate lines in output file, default value is newLine char.
40 -)))
41 -* **included :** Include specific lines from the output by defining them in the include attribute.
42 -* **excluded:** Exclude specific lines from the output by defining them in the exclude attribute.
43 -* **Position and Size:** Used to locate and define the include in the input file.
35 +* **Line Separator:** Define the character used to separate lines in the file.
36 +* **Ignored Items:** Exclude specific lines from the output by defining them in the ignoreItems attribute.
37 +* **Position and Size:** Used in **per_identifier** mode to locate and define the identifier in the input file.
44 44  
45 -=== 1. Mode: line ===
39 +=== 1. Mode: per_identifier ===
46 46  
47 47  
48 -=== Input File Example : ===
42 +=== Input File Example : ===
49 49  
50 50  
51 51  {{code language="txt"}}
... ... @@ -277,10 +277,12 @@
277 277  {{/code}}
278 278  
279 279  
280 -==== Example 1: without specifying include attribute ====
274 +==== Example 1: ====
281 281  
282 -when we don't use include attribute. it means for each output file we are going to have headers and footers and also for the include we will defined them by position and size so for each line at a specific position and with a size this is the include .
276 +==== Example 2: without specifiying identifiers ====
283 283  
278 +when we don't use identifiers . it means for each output file we are going to have headers and footers and also for the identifiers we will defined them by position and size so for each line at a specific position and with a size this is the identifier .
279 +
284 284  {{{
285 285   }}}
286 286  
... ... @@ -291,12 +291,12 @@
291 291   xmlns:ix="localFunction"
292 292   xmlns:fn="http://www.w3.org/2005/xpath-functions">
293 293  
294 - <SplitBy mode="line" headers="UNA;UNB" footers="UNZ1;UNZ" excluded="QTY" include ="" endLine="'" position ="25" size="9"></SplitBy>
290 + <Split400 mode="per_identifier" headers="UNA;UNB" footers="UNZ1;UNZ" ignoreItems="QTY" identifiers="" lineseparator="'" position ="25" size="9"/>
295 295  </ixDOC>
296 296  
297 297  {{/code}}
298 298  
299 -== output files : ==
295 +== output files : ==
300 300  
301 301  [[image:1723112876572-265.png]]
302 302  
... ... @@ -317,13 +317,13 @@
317 317  
318 318  {{/code}}
319 319  
320 -== Example 2: with specifiying include attribute ==
316 +== Example 2: with specifiying identifiers ==
321 321  
322 322  we don't need to use position and size.
323 323  
324 -== 2. Mode: message: ==
320 +== 2. Mode: per_bloc: ==
325 325  
326 -In **message** mode, the file is split into sections based on a specified include . Each output file begins with the start of an include and ends when another include is encountered.
322 +In **per_bloc** mode, the file is split into sections based on a specified identifier. Each output file begins with the start of an identifier and ends when another identifier is encountered.
327 327  
328 328  
329 329  ==== Example ====
... ... @@ -336,7 +336,7 @@
336 336   xmlns:ix="localFunction"
337 337   xmlns:fn="http://www.w3.org/2005/xpath-functions">
338 338  
339 - <SplitBy mode="message" headers="UNA;UNB" footers="UNZ1;UNZ" excluded="QTY" include ="UNH" endLine="'"></SplitBy>
335 + <Split400 mode="Per_bloc" headers="UNA;UNB" footers="UNZ1;UNZ" ignoreItems="QTY" identifiers="UNH" lineseparator="'"/>
340 340  </ixDOC>
341 341  
342 342  {{/code}}
... ... @@ -343,7 +343,6 @@
343 343  
344 344  === an example of an output file ===
345 345  
346 -
347 347  {{code language="xml"}}
348 348  UNA +.? '
349 349  UNB+UNOD 3+5907613200009 14+5907808850002 14+240509 1553+11480134402++DESADV'
... ... @@ -386,18 +386,4 @@
386 386  
387 387  {{/code}}
388 388  
389 -==== Other Examples : ====
390 -
391 -
392 -{{code language="xml"}}
393 -<!-- Write a file for each type of segment -->
394 -<SplitBy mode="line" headers="UNA;UNB" footers="UNZ" excluded="UNA;UNB;UNZ" included="" size="3" position="1" endLine="'" optionChar="\r\n" />
395 -
396 -<!-- Write a file for each type of record where the line identifier (Position 1 to 8) is different -->
397 -<SplitBy mode="line" size="8" position="1" /> <!-- The default endLine is the carriage return -->
398 -
399 -<!-- Write a file for each message starting with UNH with repeated envelope for each -->
400 -<SplitBy mode="message" identifier="UNH" headers="UNA;UNB" footers="UNZ" excluded="" included="" size="3" position="1" endLine="'" optionChar="\r\n" />
401 -{{/code}}
402 -
403 -=== ===
384 +=== ===
This wiki is hosted and managed by iXPath
Powered by XWiki 13.3 debian