App Online-modul til at downloade alle Exact Online-salgsfakturalinjer

Invantive SQL understøtter Exact Online med over 1.100 tabeller. Derudover findes der produkter som Get My Report, hvor foruddefinerede rapporter stiller data til rådighed som download på tværs af flere administrationer på én gang.

Nogle gange er det dog ønskeligt at have sit eget rapporteringsværktøj, hvor rapporterne kan hentes i et fast, eget format af virksomhedens brugere. Med Invantive Cloud er dette muligt, også uden brug af Power BI eller Qlik.

Dette emne viser, hvordan du kan vælge og downloade alle salgsfakturalinjer med supplerende oplysninger på én gang via din egen Invantive Cloud-app. Excel-downloadformatet er et meget brugt format for salgschefer og sælgere, der ønsker at analysere deres Exact Online-handelsaktiviteter via egne pivottabeller. Exact Online SQL-forespørgslen er Salgsfakturalinjer-modulet på Get My Report for Exact Online.

Salgstallene kan stamme fra én finansiel administration eller flere på én gang, som konfigureret på Exact Online-databasen i Invantive Cloud. Vær dog opmærksom på, at finansielle data fra salgsbogen fra forskellige administrationer kan have et andet grundlag, f.eks. i euro og i amerikanske dollar.

Hvis en app kræver mere end 3 minutter eller skal kaldes automatiseret, kan dette gøres via Invantive App Online, lillesøsteren til Invantive Bridge Online for Power BI. Se også Wat is Invantive App Online?.

Forberedelser

Følgende forberedelser er nødvendige:

  • En adgangskode til Invantive Cloud.
  • En adgangskode til Exact Online med en eller flere administrationer.

Definer Exact Online-database

Det første trin er at definere en Exact Online-database. Det kan gøres meget enkelt ved at følge denne trinvise vejledning:

Denne Exact Online-database kan du bruge til Power BI, Power Query eller Azure Data Factory, men lige så nemt til f.eks. Access OData eller — som her — som kilde til en Invantive Cloud-applikation.

Definer Cloud-applikation

Næste trin er at definere en app i Invantive Cloud, der henter salgstallene fra Exact Online. Følg disse trin:

Opret Excel-fil og udfyld den med Exact Online-salgstal

Dette modul vil indeholde koden til at angive indstillingerne og derefter oprette Excel-filen med salgstallene fra Exact Online.

Den fulde kode findes i slutningen af denne artikel.

Vil du komme hurtigt i gang?

  • Indsæt da koden i modulet i feltet “Kildekode”.
  • Vælg “My First App” i brødkrummestien øverst.
  • Vælg “Kør”.
  • Vælg Exact Online-databasen (hvis der er flere databaser).
  • Vælg “Kør”:
  • Vælg modulet:
  • Udfyld start- og slutdato:
  • Excel-filen downloades.

Flere eksempler på apps

Flere eksempler på egne apps findes her:

Kildekode til salgsrapportering

Følgende kildekode er rapporteringsværktøjet til at downloade Exact Online-salgsoplysninger som en Excel-arbejdsbog. Så længe variablen p_run ikke er true, vises indtastningsskærmen til start- og slutdato. Excel-arbejdsbogen downloades, når variablen p_run sættes til true via indtastningsskærmen.

declare
  p_run                         boolean  := false;
  p_cfn_factuur_datum_vanaf     date     := null;
  p_cfn_factuur_datum_tot       date     := null;
  --
  l_workbook                    excel_workbook;
  l_worksheet                   excel_worksheet;
  l_binary                      blob;
begin
  --
  -- Hent parametre.
  --
  p_run               := cast(cloud_http.get_request_query_parameter_value('p_run') as boolean);
  --
  p_cfn_factuur_datum_vanaf := to_date(cloud_http.get_request_query_parameter_value('p_cfn_factuur_datum_vanaf'), 'YYYY-MM-DD');
  p_cfn_factuur_datum_tot   := to_date(cloud_http.get_request_query_parameter_value('p_cfn_factuur_datum_tot'), 'YYYY-MM-DD');
  --
  if coalesce(p_run, false) = false
  then
    cloud_http.set_use_template(true);
    cloud_http.set_template_step_name(translate_resources('{res:itgen_parameters}'));
    cloud_http.append_line_to_response_body_text('<form>');
    cloud_http.append_line_to_response_body_text('<input type="hidden" id="p_run" name="p_run" value="true"/>');
    cloud_http.append_line_to_response_body_text('<ul>');
    cloud_http.append_line_to_response_body_text('<li><label for="p_cfn_factuur_datum_vanaf">' || translate_resources('{res:itgen_invoice_date_from}') || '</label></li><li><input id="p_cfn_factuur_datum_vanaf" name="p_cfn_factuur_datum_vanaf" type="date" value="' || to_char(add_months(trunc(sysdateutc, -1), -1), 'YYYY-MM-DD') || '"/></li>');
    cloud_http.append_line_to_response_body_text('<li><label for="p_cfn_factuur_datum_tot">' || translate_resources('{res:itgen_invoice_date_to}') || '</label></li><li><input id="p_cfn_factuur_datum_tot" name="p_cfn_factuur_datum_tot" type="date" value="' || to_char(add_months(trunc(sysdateutc, -1), +1), 'YYYY-MM-DD') || '"/></li>');
    cloud_http.append_line_to_response_body_text('<li><input type="submit" value="Start"/></li>');
    cloud_http.append_line_to_response_body_text('</ul>');
    cloud_http.append_line_to_response_body_text('</form>');
  else
    --
    -- Kontroller parametre.
    --
    -- Ingen kontroller.
    --
    -- Opret en Excel-arbejdsbog.
    --
    l_workbook := excel.new();
    --
    -- Tilføj et arbejdsark til Exact Online-salgsfakturalinjer.
    --
    l_worksheet := excel.add_worksheet
    ( l_workbook
    , 'SALES SOURCE DATA'
    );
    --
    -- Opret en liste over salgsfakturalinjer.
    --
    create or replace table rpt@inmemorystorage
    as
    select /*+ result_set_name("SalesInvoiceLines") */
           sie.invoicenumber
           label 'Invoice Number'
    ,      sle.LineNumber
           label 'Line Number'
    ,      sie.invoicedate
           label 'Invoice Date'
    ,      sie.ordernumber
           label 'Order Number'
    ,      sie.orderdate
           label 'Order Date'
    ,      sie.SalespersonFullName
           label 'Sales Person Full Name'
    ,      actord.code
           label 'Ordered by Code'
    ,      actord.name
           label 'Ordered by Name'
    ,      cttord.fullname
           label 'Ordered by Contact'
    ,      amrord.FullName AccountManagerFullName
           label 'Ordered by Account Manager'
    ,      actord.Email
           label 'Ordered by Email'
    ,      actdlr.code
           label 'Deliver to Company Code'
    ,      actdlr.name
           label 'Deliver to Company Name'
    ,      sie.delivertocontactpersonfullname
           label 'Deliver to Contact'
    ,      adsdlr.addressline1
           label 'Deliver to Address Line 1'
    ,      adsdlr.postcode
           label 'Deliver to Postcode'
    ,      adsdlr.city
           label 'Deliver to City'
    ,      adsdlr.country
           label 'Deliver to Country'
    ,      actdlr.email
           label 'Deliver to Email'
    ,      amrive.FullName AccountManagerFullName
           label 'Invoice Account Manager'
    ,      active.name
           label 'Invoice Company Name'
    ,      active.Email
           label 'Invoice Email'
    ,      active.AddressLine1
           label 'Invoice Address Line 1'
    ,      active.Postcode
           label 'Invoice Postcode'
    ,      active.City
           label 'Invoice City'
    ,      active.Country
           label 'Invoice Country'
    ,      sie.duedate
           label 'Due Date'
    ,      gat.Code GLAccountCode
           label 'General Ledger Account'
    ,      igp.code itemgroupcode
           label 'Item Group'
    ,      sle.itemcode
           label 'Item Code'
    ,      sle.itemdescription
           label 'Item Description'
    ,      sle.description
           label 'Description'
    ,      sim.SupplierCode
           label 'Main Supplier Code'
    ,      sim.SupplierDescription
           label 'Main Supplier Name'
    ,      sle.StartTime
           label 'Start'
    ,      sle.EndTime
           label 'End'
    ,      sle.quantity
           label 'Quantity'
    ,      sle.UnitDescription
           label 'Unit Description'
    ,      sle.NetPrice
           label 'Net Price'
    ,      sle.unitprice
           label 'Unit Price'
    ,      sle.discount * 100
           label 'Discount'
    ,      sle.unitprice * ( 1 - sle.discount )
           label 'Net Price per Unit'
    ,      sle.netamountdc
           label 'Net Price Total'
    ,      sle.unitprice * sle.discount * sle.quantity
           label 'Amount Discount'
    ,      sle.VATAmountDC
           label 'VAT Amount (EUR)'
    ,      itm.costpricecurrency
           label 'Cost Price Currency'
    ,      itm.costpricestandard
           label 'Cost Price Standard'
    ,      itm.costpricestandard * sle.quantity
           label 'Standard Cost Price Total'
    ,      itm.NetWeight
           label 'Net Weight'
    ,      itm.GrossWeight
           label 'Gross Weight'
    from   exactonlinerest..salesinvoicesbulk@eol sie
    join   exactonlinerest..salesinvoicelinesBulk@eol sle
    on     sle.division  = sie.division
    and    sle.invoiceid = sie.invoiceid
    join   ItemsIncremental@eol itm
    on     itm.division = sle.division
    and    itm.id       = sle.item
    join   ItemGroups@eol igp
    on     igp.division = itm.division
    and    igp.id       = itm.ItemGroup
    join   GLAccountsIncremental@eol gat
    on     gat.Id = sle.GLAccount
    join   AccountsIncremental@eol actord
    on     actord.division = sie.division
    and    actord.id       = sie.orderedby
    left
    outer
    join   exactonlinerest..users@eol amrord
    on     amrord.userId  = actord.AccountManager
    left
    outer
    join   ContactsIncremental@eol cttord
    on     cttord.id       = sie.orderedbycontactperson
    join   AccountsIncremental@eol actdlr
    on     actdlr.id       = sie.deliverto
    left
    outer
    join   AddressesIncremental@eol adsdlr
    on     adsdlr.id       = sie.delivertoaddress
    join   AccountsIncremental@eol active
    on     active.id       = sie.invoiceto
    left
    outer
    join   exactonlinerest..users@eol amrive
    on     amrive.userId  = actord.AccountManager
    left
    outer
    join   SupplierItems@eol sim
    on     sim.division     = sle.division
    and    sim.ItemCode     = sle.itemcode
    and    sim.MainSupplier = true
    where  sie.status = 50
    and    sie.invoicedate between coalesce(p_cfn_factuur_datum_vanaf, sie.invoicedate) and coalesce(p_cfn_factuur_datum_tot, sie.invoicedate) 
    order
    by     sie.invoicenumber
    ,      sie.ordernumber
    ,      sle.linenumber
    ;
    --
    -- Placer posterne i Excel-arbejdsarket.
    --
    excel.fill_using_query(l_worksheet, 'select * except rowid$ from rpt@inmemorystorage');
    --
    -- Tilføj et arbejdsark med en titel.
    --
    l_worksheet := excel.add_worksheet
    ( l_workbook
    , 'FILTER'
    );
    excel.set_cell_contents(l_worksheet, 'A1', 'Sales Invoices');
    excel.set_cell_contents(l_worksheet, 'A3', translate_resources('{res:itgen_user}'));
    excel.set_cell_contents(l_worksheet, 'B3', sys_context('USERENV', 'USER_FULL_NAME', 'eol'));
    --
    excel.set_cell_contents(l_worksheet, 'A4', translate_resources('{res:itgen_generated}'));
    excel.set_cell_contents(l_worksheet, 'B4', to_char(sysdateutc, 'DD-MM-YYYY HH24:MI:SS'));
    --
    excel.set_cell_contents(l_worksheet, 'A6', translate_resources('{res:itgen_invoice_date_from}'));
    excel.set_cell_contents(l_worksheet, 'B6', p_cfn_factuur_datum_vanaf);
    --
    excel.set_cell_contents(l_worksheet, 'A7', translate_resources('{res:itgen_invoice_date_to}'));
    excel.set_cell_contents(l_worksheet, 'B7', p_cfn_factuur_datum_tot);
    --
    -- Hent den resulterende XLSX-fil.
    --
    l_binary := excel.export_to_xlsx(l_workbook);
    --
    -- Returner XLSX-filen til brugeren.
    --
    cloud_http.set_response_body_binary(l_binary);
    cloud_http.set_response_content_type('application/vnd.openxmlformats-officedocument.spreadsheetml.sheet');
    cloud_http.set_response_header_value
    ( 'Content-Disposition'
    , 'attachment; filename="Sales Invoices Fixed Format.xlsx'
    );
  end if;
end;