Add module report_xml.

[yajo]

In order to fix OCA/l10n-spain#174 I need to generate XML files, so here is the reporting engine for that.

It allows developers to generate XML reports using QWeb, and print them using the standard Odoo tools. See README for instructions.

[pedrobaeza]

Put module name here

[pedrobaeza]

Can you provide a report_xml_sample module as an example for this?

[yajo]

Are you sure you want a sample module? Is it not better to add demo data to this one? After all, reports are data files...

[pedrobaeza]

Well, it can be a solution, but I think people would prefer to test it and study independently from having the option of demo data checked.

[mylbco]

@pedrobaeza yes, I can agree on that

[yajo]

Creating a dummy module does not seem very pleasing to me. This module is going to be extensively used in the upcoming l10n_es_training module, so I took that one as the sample module and referenced it in the README.

BTW I also added a couple of missing pieces to this module: a base template and a base XSD report checker.

[pedrobaeza]

Then it's going to be very difficult to review this PR unless we have any sample

[yajo]

Is the sample OK?

[pedrobaeza]

Thanks for the sample! Maybe I miss an option to select the fields of the XML, but as a first version is very appreciated.

👍

[yajo]

What do you mean?

[pedrobaeza]

I don't see in the sample a way to define only some fields of the record to export in the XML, or may I miss something?

[yajo]

It's a QWeb report in all means. In the sample I only export id and name because it is an example and it should be simple by definition, but you can export any field you want.

See a real world sample here to see how versatile it is (it's a WIP).

[pedrobaeza]

Ah, OK, I didn't get the real usage then (that's why I insist then on the sample and/or documentation), and you can see that still the sample maybe it's not enough, but I'm not going to insist more for now on this.

[yajo]

The READMEs are short, but just follow exactly what they say and you should have your XML report in no time, and the real docs are those of QWeb, that are linked in them. Currently QWeb reports are HTML, which is itself an XML, so the only thing this module does is to make it download it as XML instead of rendering it in the browser.

XSD are XML schemas that validate XML documents, very often used to make sure the XML you send is going to be accepted by the other party. There are other validation methods (DTD, RelaxNG...), but I did not include any of them since I don't need them right now and XSD seems to be the most used.

The sample is small on purpose and IMHO it's better that way. It includes also an XSD and the method to check it. I encourage you to install it and see how it works and read carefuly the READMEs, you'll see it's very easy. 😉

[yajo]

Please don't merge this still, I've got another PR coming that I consider more important.

[yajo]

Closing this until #18 gets fixed.