API questions

[David Goodenough]

On Friday 10 June 2016 06:59:38 John Ralls wrote:
> > On Jun 10, 2016, at 2:05 AM, David Goodenough
> > <david.goodenough at linkchoose.co.uk> wrote:
> > 
> > I notice when looking at the API pages that a method is defined as
> > starting
> > at a given line, and then the code below always starts on the next line,
> > i.e. missing out the prototype.  For example:-
> > 
> > Definition at line 116 of file print-session.c.
> > 
> >  117 {
> >  118     return print_settings;
> >  119 }
> > 
> > Would it not be possible to show line 116 as well?  This seems to be a
> > consistent problem throughout the docs.
> 
> The prototype is in very large print above the description. Repeating it in
> the listing would be redundant.
OK, missed that.  It just looked odd at first glance that the line number 
immedately before the code was not in the code that was shown.
> > The reason I was looking was to generate customer reports via the API.
> > I would like to be able to generate a report for each customer who either
> > has a non-zero balance or where some transaction (invoice or receipt of
> > payment) happened last month (or since rather since I last ran the
> > program). I then want to export the report as a PDF.  I have looked my
> > way through the API docs but could not see how to generate reports, or to
> > check for the balance or the presence of transactions since a date.
> > 
> > I found docs on how to create invoices, but also need to be able to
> > export them as PDFs and could not locate the API for that either.  I
> > notice
> > in the gnucash XML files that the last direcorty to which invoices ( and I
> > guess customer reports ) were exported is stored, is this available from
> > the API.
I think having read a bit further that this is in the customer dictionary?
> > 
> > What I want to be able to write is a program that will generate reports
> > for all relevant customers, and then send an email to each customer who
> > has either an invoice and/or a report containing both.
> > 
> > Any pointers gratefully received.
> 
> PDF generation is provided by (IIRC) libgtk as part of printing support. You
> won't find the code for that in GnuCash itself.
OK, but I still need to tell it to generate the customer report, and to check
whether I need to do so?

David
> 
> Regards,
> John Ralls