SpoolFactory - Spool Converter Pro

Spool Conversion Software for i5/iSeries/AS400

XML Format

Discover how to generate XML from Spool

The power of XML Format

The distribution of information by electronic means has become something habitual and necessary The evolution has gone from paper to electronic formats like e-mail and publication on the Web

Spool Converter Pro can help to export the content of the reports by mean of spool to XML conversion

Page 2

Spool Converter Pro for XML format

1 2

Software Description Software Architecture

3
4 5
Page 3

Available XML Formats

Sample Conversions References

Software Description

Spool Converter Pro converts *SCS spool files to XML format

- The same procedure is valid for Excel conversion (XML for Excel 2003)

All the conversion is performed in native mode

- No external servers required

Two available modes

- User mode Spool Manager - Command Mode for Software Integration

Advanced features (only for XML, not for Excel)

- Multi record processing - Nesting allowed

Page 4

Software Description

Fast software installation

Save file available for downloading Restore the objects and start to use the software

Easy learning

For non-technical users, Spool Manager is the interface to convert the spool files

The whole conversion process is entirely done in native mode OS400 or i5/OS
Images can be added to the image catalogue in the System i environment with a supplied and easy to use tool

Command mode Command mode allows to call the converter from CL programs After spool conversion, it is possible to call a user program to execute other for developers actions with the generated file

Page 5

Software Arquitecture

Integration with other vendor tools

3rd party tools

Command implementations based on features of Spool Converter Pro

Spool Excel, Spool Chart

The conversion suite developed natively for OS400

Spool Converter Pro

Page 6

Available XML Formats

For information exchange. Include advanced features for multi-record processing

Excel format is based on XML for Excel 2003

Page 7

Spool Converter Pro for XML format

Sample Conversions
Simple XML Conversion

Page 8

Simple XML Conversion

iSeries Spool Content
*...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 Invoice Number: Customer Name: 2009-109932 Peter Wilson Jackson

Date Item Reference Description Amount Price/Unit Total Price ============================================================================= 02/02/09 02/12/09 02/15/09 02/16/09 02/18/09 02/20/09 02/25/09 02/26/09 2112-12234-112 4232-14783-143 1212-33443-253 1442-25463-683 6512-13533-843 1532-14353-167 3712-14353-226 1382-25433-842 Software Software Software Software Software Software Software Software Nbr Nbr Nbr Nbr Nbr Nbr Nbr Nbr 1 2 3 4 5 6 7 8 2 1 3 1 3 1 1 1 1,000.00 500.00 600.00 800.00 500.00 2,500.00 3,000.00 300.00 Total 2,000.00 500.00 1,800.00 800.00 1,500.00 2,500.00 3,000.00 300.00 12,400.00

Payment Instructions: North Tree Mercant Bank - Account 555-AHT-1P25Q

Selected in color the lines (records) we are going to process

Page 9

Simple XML Conversion

Title of the Report (Optional) - Tag <title> rule
SpoolFactory.com Sppafacr09 Rules Group . . . : Rules Number . . . : Spool Manager Rules Groups Maintenance 83 XMLFORMAT 1

Action . . . . . . : Active . . . . . . :
Title

9 Tag <title> Y (Y/N) Order # :

. . . . . . : Sales Report

Only for Excel At Row . . . . . . : At Column . . . . : Empty rows after title . . . : Size of Font . . . . 12 Color of text (F4=Select) Black (Default) Bold . . : N (Y/N) Italic . : N (Y/N) Underline: N (Y/N) Alignment: C (C/L/R) Only for XML First XML level . . . . : (By default: document)

F3=Exit

F10=View SplF QPRINT 007689/SPLFACDEV/QPADEV000B (0006)

F23=Delete

Title identification is optional. If it is specified, then it will appear at the <document title> XML tag

Page 10

Simple XML Conversion

Identify the records to process - Tag <record> rule
SpoolFactory.com Sppafacr10 Rules Group . . . : Rules Number . . . : Spool Manager Rules Groups Maintenance 83 XMLFORMAT 2

Action . . . . . . : 10 Tag <record> Active . . . . . . : Y (Y/N) Order # :

Initial Position . : 63 Final Position: Text to Localize . : *NUMERIC Description . . . : Sales Detail Only for XML Multi Record Processing (Optional - Maximum five nesting level) 64

Record Name . . . : It belongs to record:

F3=Exit

F23=Delete

We identify the records to process, by selecting records containing numeric value for decimal part of Price/Unit field.
Other options: decimal point of Price/Unit field, slash of date, other numeric values, or *NUMEDIT function for numeric fields containing symbols and blanks spaces. Important: If we use the Total Price field to identify the record, then we will process the Total record. Note: The Description field will appear as record identification in the XML file, at this case <SalesDetail>
Page 11

Simple XML Conversion

Select the fields to retrieve (Date) - Tag <data> rule
SpoolFactory.com Sppafacr11 Rules Group . . . : Rules Number . . . : Spool Manager Rules Groups Maintenance 83 XMLFORMAT 3

Action . . . . . . : 11 Tag <data> Active . . . . . . : Y (Y/N) Order # :

Apply to Positions : Description 3 (From) Until : 10

Only for XML Multi Record Tag Record Associated

. . . : Date

Only for Excel Width of Column . : Empty columns previous to this field . : Width of empty columns . . . : Format of Header Field Size of Font . . . . 12 Color of text (F4=Select) Black (Default) Bold . : N Y/N Italic : N Y/N Underline: N Y/N Alignment: C C/L/R Force to Alphabetic Y/N Apply Right to Left (Hebrew/Arabic): Y/N F3=Exit F10=View SplF QPRINT 007689/SPLFACDEV/QPADEV000B (0006) F23=Delete

We define the positions from/until where the field is located in the record, at this case positions 3 to 10 for Date
Note: we have defined the name Date for the field, and it matchs with the header description in the record, but we can specify any name we want for this field. It is the name which appears in the XML file. If we define a name with several words, the converter will merge the words by eliminating the spaces.
Page 12

Simple XML Conversion

Select the fields to retrieve (Item Reference) - Tag <data> rule
SpoolFactory.com Sppafacr11 Rules Group . . . : Rules Number . . . : Spool Manager Rules Groups Maintenance 83 XMLFORMAT 4

Action . . . . . . : 11 Tag <data> Active . . . . . . : Y (Y/N) Order # :

Apply to Positions : Description 13 (From) Until : 26

Only for XML Multi Record Tag Record Associated

. . . : Reference

Only for Excel Width of Column . : Empty columns previous to this field . : Width of empty columns . . . : Format of Header Field Size of Font . . . . 12 Color of text (F4=Select) Black (Default) Bold . : N Y/N Italic : N Y/N Underline: N Y/N Alignment: C C/L/R Force to Alphabetic N Y/N Apply Right to Left (Hebrew/Arabic): N Y/N F3=Exit F10=View SplF QPRINT 007689/SPLFACDEV/QPADEV000B (0006) F23=Delete

Definition of Reference field to retrieve

Page 13

Simple XML Conversion

Select the fields to retrieve (Description) - Tag <data> rule
SpoolFactory.com Sppafacr11 Rules Group . . . : Rules Number . . . : Spool Manager Rules Groups Maintenance 83 XMLFORMAT 5

Action . . . . . . : 11 Tag <data> Active . . . . . . : Y (Y/N) Order # :

Apply to Positions : Description 29 (From) Until : 44

Only for XML Multi Record Tag Record Associated

. . . : Description

Only for Excel Width of Column . : Empty columns previous to this field . : Width of empty columns . . . : Format of Header Field Size of Font . . . . 12 Color of text (F4=Select) Black (Default) Bold . : N Y/N Italic : N Y/N Underline: N Y/N Alignment: C C/L/R Force to Alphabetic N Y/N Apply Right to Left (Hebrew/Arabic): N Y/N F3=Exit F10=View SplF QPRINT 007689/SPLFACDEV/QPADEV000B (0006) F23=Delete

Definition of Description field to retrieve

Page 14

Simple XML Conversion

Select the fields to retrieve (Amount) - Tag <data> rule
SpoolFactory.com Sppafacr11 Rules Group . . . : Rules Number . . . : Spool Manager Rules Groups Maintenance 83 XMLFORMAT 6

Action . . . . . . : 11 Tag <data> Active . . . . . . : Y (Y/N) Order # :

Apply to Positions : Description 46 (From) Until : 50

Only for XML Multi Record Tag Record Associated

. . . : Amount

Only for Excel Width of Column . : Empty columns previous to this field . : Width of empty columns . . . : Format of Header Field Size of Font . . . . 12 Color of text (F4=Select) Black (Default) Bold . : N Y/N Italic : N Y/N Underline: N Y/N Alignment: C C/L/R Force to Alphabetic N Y/N Apply Right to Left (Hebrew/Arabic): N Y/N F3=Exit F10=View SplF QPRINT 007689/SPLFACDEV/QPADEV000B (0006) F23=Delete

Definition of Amount field to retrieve

Page 15

Simple XML Conversion

Select the fields to retrieve (Unit Price) - Tag <data> rule
SpoolFactory.com Sppafacr11 Rules Group . . . : Rules Number . . . : Spool Manager Rules Groups Maintenance 83 XMLFORMAT 7

Action . . . . . . : 11 Tag <data> Active . . . . . . : Y (Y/N) Order # :

Apply to Positions : Description 54 (From) Until : 64

Only for XML Multi Record Tag Record Associated

. . . : Unit Price

Only for Excel Width of Column . : Empty columns previous to this field . : Width of empty columns . . . : Format of Header Field Size of Font . . . . 12 Color of text (F4=Select) Black (Default) Bold . : N Y/N Italic : N Y/N Underline: N Y/N Alignment: C C/L/R Force to Alphabetic N Y/N Apply Right to Left (Hebrew/Arabic): N Y/N F3=Exit F10=View SplF QPRINT 007689/SPLFACDEV/QPADEV000B (0006) F23=Delete

Definition of Unit Price field to retrieve

Page 16

Simple XML Conversion

Select the fields to retrieve (Total Price) - Tag <data> rule
SpoolFactory.com Sppafacr11 Rules Group . . . : Rules Number . . . : Spool Manager Rules Groups Maintenance 83 XMLFORMAT 8

Action . . . . . . : 11 Tag <data> Active . . . . . . : Y (Y/N) Order # :

Apply to Positions : Description 68 (From) Until : 79

Only for XML Multi Record Tag Record Associated

. . . : Total Price

Only for Excel Width of Column . : Empty columns previous to this field . : Width of empty columns . . . : Format of Header Field Size of Font . . . . 12 Color of text (F4=Select) Black (Default) Bold . : N Y/N Italic : N Y/N Underline: N Y/N Alignment: C C/L/R Force to Alphabetic N Y/N Apply Right to Left (Hebrew/Arabic): N Y/N F3=Exit F10=View SplF QPRINT 007689/SPLFACDEV/QPADEV000B (0006) F23=Delete

Definition of Total Price field to retrieve

Page 17

Simple XML Conversion

XLM Final Result
<?xml version="1.0" encoding="ISO-8859-1"?> <document title="Sales Report"> <SalesDetail> <Date>02/02/09</Date> <Reference>2112-12234-112</Reference> <Description>Software Nbr 1 </Description> <Amount> 2</Amount> <UnitPrice> 1,000.00</UnitPrice> <TotalPrice> 2,000.00</TotalPrice> </SalesDetail> <SalesDetail> <Date>02/12/09</Date> <Reference>4232-14783-143</Reference> <Description>Software Nbr 2 </Description> <Amount> 1</Amount> <UnitPrice> 500.00</UnitPrice> <TotalPrice> 500.00</TotalPrice> </SalesDetail> . . . . </document>

Result obtained when the converter applies the previously defined rules

Page 18

Simple XML Conversion

Final Result in Firefox

Final Result in Internet Explorer

Page 19

Spool Converter Pro for XML format

Sample Conversions
XML with Multi Record Processing

Page 20

Simple XML Conversion

iSeries Spool Content
*...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 Invoice Number: Customer Name: 2009-109932 Peter Wilson Jackson

Date Item Reference Description Amount Price/Unit Total Price ============================================================================= 02/02/09 02/12/09 02/15/09 02/16/09 02/18/09 02/20/09 02/25/09 02/26/09 2112-12234-112 4232-14783-143 1212-33443-253 1442-25463-683 6512-13533-843 1532-14353-167 3712-14353-226 1382-25433-842 Software Software Software Software Software Software Software Software Nbr Nbr Nbr Nbr Nbr Nbr Nbr Nbr 1 2 3 4 5 6 7 8 2 1 3 1 3 1 1 1 1,000.00 500.00 600.00 800.00 500.00 2,500.00 3,000.00 300.00 Total 2,000.00 500.00 1,800.00 800.00 1,500.00 2,500.00 3,000.00 300.00 12,400.00

Payment Instructions: North Tree Mercant Bank - Account 555-AHT-1P25Q

Multi record processing allows to retrieve additional information than the retrieved with the main pattern. In red color is marked the data to retrieve in addition to the information retrieved using the previous example.

Page 21

XML with Multi Record Processing

Identify the records to process
SpoolFactory.com Sppafacr10 Rules Group . . . : Rules Number . . . : Spool Manager Rules Groups Maintenance 83 XMLFORMAT 2

Action . . . . . . : 10 Tag <record> Active . . . . . . : Y (Y/N) Order # :

Initial Position . : 63 Final Position: Text to Localize . : *NUMERIC Description . . . : Sales Detail Only for XML Multi Record Processing (Optional - Maximum five nesting level) 64

Record Name . . . : SALESREC It belongs to record:

F3=Exit

F23=Delete

As we are going to have several records, we have to associate a name to each record. In our case, we give the name SALESREC to the previously created record.

Page 22

XML with Multi Record Processing

Select the fields to retrieve (Date)
SpoolFactory.com Sppafacr11 Rules Group . . . : Rules Number . . . : Spool Manager Rules Groups Maintenance 83 XMLFORMAT 3

Action . . . . . . : 11 Tag <data> Active . . . . . . : Y (Y/N) Order # :

Apply to Positions : Description 3 (From) Until : 10

Only for XML Multi Record Tag Record Associated SALESREC

. . . : Date

Only for Excel Width of Column . : Empty columns previous to this field . : Width of empty columns . . . : Format of Header Field Size of Font . . . . 12 Color of text (F4=Select) Black (Default) Bold . : N Y/N Italic : N Y/N Underline: N Y/N Alignment: C C/L/R Force to Alphabetic N Y/N Apply Right to Left (Hebrew/Arabic): N Y/N F3=Exit F10=View SplF QPRINT 007689/SPLFACDEV/QPADEV000B (0006) F23=Delete

And next step is to associate SALESREC record to all the previously created fields to retrieve. In this example, we perform this action to the field Date but we have to do the same for the rest of fields.

Page 23

XML with Multi Record Processing

New identificaton of records to process
SpoolFactory.com Sppafacr10 Rules Group . . . : Rules Number . . . : Spool Manager Rules Groups Maintenance 83 XMLFORMAT 9

Action . . . . . . : 10 Tag <record> Active . . . . . . : Y (Y/N) Order # :

Initial Position . : 3 Final Position: Text to Localize . : Customer Name Description . . . : Customer Only for XML Multi Record Processing (Optional - Maximum five nesting level) 15

Record Name . . . : CUSTOMREC It belongs to record:

F3=Exit

F23=Delete

Now we are going to define a new record for Customer and we give the name CUSTOMREC This is the part of the spool we want to process:
*...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 Customer Name: Peter Wilson Jackson

Page 24

XML with Multi Record Processing

New field to retrieve
SpoolFactory.com Sppafacr11 Rules Group . . . : Rules Number . . . : Spool Manager Rules Groups Maintenance 83 XMLFORMAT 10

Action . . . . . . : 11 Tag <data> Active . . . . . . : Y (Y/N) Order # :

Apply to Positions : Description 20 (From) Until : 50

Only for XML Multi Record Tag Record Associated CUSTOMREC

. . . : Name

Only for Excel Width of Column . : Empty columns previous to this field . : Width of empty columns . . . : Format of Header Field Size of Font . . . . 12 Color of text (F4=Select) Black (Default) Bold . : N Y/N Italic : N Y/N Underline: N Y/N Alignment: C C/L/R Force to Alphabetic N Y/N Apply Right to Left (Hebrew/Arabic): N Y/N F3=Exit F10=View SplF QPRINT 007689/SPLFACDEV/QPADEV000B (0006) F23=Delete

And next step is to define the field (Name) to retrieve, associating this field to the new record CUSTOMREC

Page 25

XML with Multi Record Processing

XLM Final Result
<?xml version="1.0" encoding="ISO-8859-1"?> <document title="Sales Report"> <Customer> <Name>Peter Wilson Jackson </Name> </Customer> <SalesDetail> <Date>02/02/09</Date> <Reference>2112-12234-112</Reference> <Description>Software Nbr 1 </Description> <Amount> 2</Amount> <UnitPrice> 1,000.00</UnitPrice> <TotalPrice> 2,000.00</TotalPrice> </SalesDetail> <SalesDetail> <Date>02/12/09</Date> <Reference>4232-14783-143</Reference> <Description>Software Nbr 2 </Description> <Amount> 1</Amount> <UnitPrice> 500.00</UnitPrice> <TotalPrice> 500.00</TotalPrice> </SalesDetail> . . . . </document>

And this is the result obtained with the new rules

Page 26

Spool Converter Pro for XML format

Sample Conversions
XML with Nested Levels

Page 27

XML with Nested Levels

New identificaton of records to process
SpoolFactory.com Sppafacr10 Rules Group . . . : Rules Number . . . : Spool Manager Rules Groups Maintenance 85 XMLFORMAT3 11

Action . . . . . . : 10 Tag <record> Active . . . . . . : Y (Y/N) Order # :

Initial Position . : 63 Final Position: Text to Localize . : *NUMERIC Description . . . : Date

25 64

Record Name . . . : DATEREC Only for XML Multi Record Processing It belongs to record: SALESREC (Optional - Maximum five nesting level)

Is the content of DATEREC F3=Exit

in the same line that SALESREC

? Y F23=Delete

The obtained XML result could not solve our requirements at the case we need to organize the information in levels. When there are nested levels, for each lower level (record) we have to specify to which level (record) belongs. And we are requested to indicate if the data to retrieve are in the same line that the record to which belongs. At this case we are going to create the record Date to group the fields Day, Month and Year.
Page 28

XML with Nested Levels

New field to retrieve
SpoolFactory.com Sppafacr11 Rules Group . . . : Rules Number . . . : Spool Manager Rules Groups Maintenance 85 XMLFORMAT 12

Action . . . . . . : 11 Tag <data> Active . . . . . . : Y (Y/N) Order # :

Apply to Positions : Description 3 (From) Until : 4

Only for XML Multi Record Tag Record Associated DATEREC

. . . : Day

Only for Excel Width of Column . : Empty columns previous to this field . : Width of empty columns . . . : Format of Header Field Size of Font . . . . 12 Color of text (F4=Select) Black (Default) Bold . : N Y/N Italic : N Y/N Underline: N Y/N Alignment: C C/L/R Force to Alphabetic N Y/N Apply Right to Left (Hebrew/Arabic): N Y/N F3=Exit F10=View SplF QPRINT 007689/SPLFACDEV/QPADEV000B (0006) F23=Delete

This field is to define the field Day inside of DATEREC record.

Page 29

XML with Nested Levels

New field to retrieve
SpoolFactory.com Sppafacr11 Rules Group . . . : Rules Number . . . : Spool Manager Rules Groups Maintenance 85 XMLFORMAT 13

Action . . . . . . : 11 Tag <data> Active . . . . . . : Y (Y/N) Order # :

Apply to Positions : Description 6 (From) Until : 7

Only for XML Multi Record Tag Record Associated DATEREC

. . . : Month

Only for Excel Width of Column . : Empty columns previous to this field . : Width of empty columns . . . : Format of Header Field Size of Font . . . . 12 Color of text (F4=Select) Black (Default) Bold . : N Y/N Italic : N Y/N Underline: N Y/N Alignment: C C/L/R Force to Alphabetic N Y/N Apply Right to Left (Hebrew/Arabic): N Y/N F3=Exit F10=View SplF QPRINT 007689/SPLFACDEV/QPADEV000B (0006) F23=Delete

This field is to define the field Month inside of DATEREC record.

Page 30

XML with Nested Levels

New field to retrieve
SpoolFactory.com Sppafacr11 Rules Group . . . : Rules Number . . . : Spool Manager Rules Groups Maintenance 85 XMLFORMAT 14

Action . . . . . . : 11 Tag <data> Active . . . . . . : Y (Y/N) Order # :

Apply to Positions : Description 9 (From) Until : 10

Only for XML Multi Record Tag Record Associated DATEREC

. . . : Year

Only for Excel Width of Column . : Empty columns previous to this field . : Width of empty columns . . . : Format of Header Field Size of Font . . . . 12 Color of text (F4=Select) Black (Default) Bold . : N Y/N Italic : N Y/N Underline: N Y/N Alignment: C C/L/R Force to Alphabetic N Y/N Apply Right to Left (Hebrew/Arabic): N Y/N F3=Exit F10=View SplF QPRINT 007689/SPLFACDEV/QPADEV000B (0006) F23=Delete

This field is to define the field Year inside of DATEREC record.

Page 31

XML with Nested Levels

New identificaton of records to process
SpoolFactory.com Sppafacr10 Rules Group . . . : Rules Number . . . : Spool Manager Rules Groups Maintenance 85 XMLFORMAT 11

Action . . . . . . : 10 Tag <record> Active . . . . . . : Y (Y/N) Order # :

Initial Position . : 63 Final Position: Text to Localize . : *NUMERIC Description . . . : Rest Of Data 64

Record Name . . . : RESTREC Only for XML Multi Record Processing It belongs to record: SALESREC (Optional - Maximum five nesting level)

Is the content of DATEREC F3=Exit

in the same line that SALESREC

? Y F23=Delete

We create the new record RESTREC, belonging to SALESREC, to group the rest of the fields.

Page 32

XML with Nested Levels

Rest of fields to retrive Assign to the new record type
SpoolFactory.com Sppafacr11 Rules Group . . . : Rules Number . . . : Spool Manager Rules Groups Maintenance 85 XMLFORMAT 4

Action . . . . . . : 11 Tag <data> Active . . . . . . : Y (Y/N) Order # :

Apply to Positions : Description 13 (From) Until : 26

Only for XML Multi Record Tag Record Associated RESTREC

. . . : Reference

Only for Excel Width of Column . : Empty columns previous to this field . : Width of empty columns . . . : Format of Header Field Size of Font . . . . 12 Color of text (F4=Select) Black (Default) Bold . : N Y/N Italic : N Y/N Underline: N Y/N Alignment: C C/L/R Force to Alphabetic N Y/N Apply Right to Left (Hebrew/Arabic): N Y/N F3=Exit F10=View SplF QPRINT 007689/SPLFACDEV/QPADEV000B (0006) F23=Delete

Now we associate the rest of the fields to the new record RESTREC. In this screen as example we associate the field Reference, and we have to do the same with the rest of fields.

Page 33

XML with Nested Levels

XLM Final Result
<?xml version="1.0" encoding="ISO-8859-1"?> <document title="Sales Report"> <Customer> <Name>Peter Wilson Jackson </Name> </Customer> <SalesDetail> <Date> <Day>02</Day> <Month>02</Month> <Year>09</Year> </Date> <RestOfData> <Reference>2112-12234-112</Reference> <Description>Software Nbr 1 </Description> <Amount> 2</Amount> <UnitPrice> 1,000.00</UnitPrice> <TotalPrice> 2,000.00</TotalPrice> </RestOfData> </SalesDetail> . . . . </document>

And this is the XML result organized with nested levels

Page 34

References
Company
JVC USA Acum Instec Software Solutions Inc. Grupo Andreani Kuhn Holding Factory 2-U Conte of Florence Golden West Globalsoft Jan Dupont

Country
United States Israel Canada Argentina The Netherlands United States Italy United Kingdom Turkey Belgium

Page 35

General Info [email protected]

www.spoolfactory.com

Page 36