Grupperingar, diagram och underrapporter

Ett detaljband på egen hand kan bara skriva ut en rad per post. Det som förvandlar en lista till ett dokument är tre delar: grupperingarna, som delar upp listan i block med rubrik och summa; diagrammen, som sammanfattar vad listan säger; och underrapporterna, som tar in en helt annan datamängd i dokumentet.

Vi fortsätter i rapporten Oportunidades por conta i appen Kundhantering.

#Grupperingar

En gruppering delar upp listan varje gång värdet i ett fält ändras. Varje nivå ger två egna band: ett sidhuvud, som renderas när värdet ändras, och en sidfot, som renderas när värdet tar slut.

Det är detta som gör dokumentet till ”varje konto, med sina affärsmöjligheter under och summan i slutet”.

#Skapa en gruppering

1. Klicka på + i avsnittet Grupperingar i vänsterkolumnen.
2. Markera bandet Sidhuvud: … som dök upp på designytan.
3. Välj Fält i avsnittet Gruppering i panelen till höger.

Egenskap	Vad den gör
Fält	”Fält i den huvudsakliga datamängden vars värde definierar gruppen. Raderna sorteras efter det.” Godtar sökvägar med punkt för att gå genom relationer: conta.nome.
Ordning	Stigande eller Fallande.
Upprepa sidhuvudet	”När gruppen fortsätter på nästa sida renderas dess sidhuvud igen överst.”
Ny sida per grupp	”Varje grupp börjar på en egen sida.” Det är vad man slår på för att skriva ut en faktura per blad.

Gruppbanden visas på designytan inkapslade runt detaljen, med ett indrag som visar vilken nivå de tillhör. Du kan ha hur många nivåer du vill — per år, sedan per kund, sedan per faktura.

#Summor med Aggregat

Elementet Aggregat är en beräkning som motorn gör: Summa, Medelvärde, Antal, Min eller Max på ett fält i en datamängd.

Var du placerar det avgör vad det räknar:

Var det ligger	Vad det summerar
I en grupps sidfot	Bara raderna i den gruppen — summan för det kontot.
I rapportens sidfot	Alla rader — totalsumman.
I detaljbandet, på en länkad datamängd	Bara raderna för den raden — summan för den fakturan.

Vid Antal kan fältet lämnas tomt: det räknar rader, inte värden.

#Diagram

Ett diagram på papperet använder samma motor och samma alternativ som skärmarnas diagramwidget. I PDF:en ritas det på servern och läggs in som vektor, inte som bild — ett rastrerat diagram skulle bli suddigt vid utskrift eller förstoring.

Dra Diagram från paletten till ett band och konfigurera det:

Egenskap	Anteckningar
Diagramtyp	Staplar, Linje, Yta, Cirkel/Donut, Punkt, Radar, Tratt, Mätare eller Värmekarta.
Datamängd	Varifrån raderna kommer. Tomt använder den huvudsakliga datamängden.
Kategorifält (X-axel/sektorer)	”Fältet som definierar den vågräta axeln (eller sektorerna).”
Värdefält	”Numeriska fält som ska ritas. Utan seriefält blir varje fält en serie.” De läggs till med Lägg till värde.
Seriefält (gruppering)	”Fältet som delar upp serierna. Med det pivoteras det på det första värdefältet.”
Förklaring och Förklaringens position	Överst, Nederkant, Vänster eller Höger.
Värden vid punkterna	Skriver ut talet ovanpå varje stapel eller punkt.

Beroende på typen dyker även Staplat, Mjuka linjer, Horisontell och Donutens innerradie (%) upp.

I exemplet har diagrammet i Rapportens sidfot kategorin fase och värdet valor: en stapel per fas i pipelinen, med summan av affärerna i var och en.

#Underrapporter

En underrapport är en annan rapport designad inuti den här. Den är till för det som grupperingen inte klarar: grupperingen delar upp en datamängd; underrapporten tar in en hel annan.

Det klassiska fallet: i ett kontoutdrag, de öppna fakturorna och betalningarna — två listor från olika tabeller på samma blad. I vårt exempel tar varje kontos sidhuvud in listan över dess contactos, före affärsmöjligheterna.

#Designa barnet

Den inbäddade rapporten är en vanlig rapport, med eget liv — den öppnas, designas och förhandsgranskas som vilken annan som helst. Skillnaden är att den deklarerar parametrar för att ta emot sammanhanget från den som bäddar in den.

I exemplet har Contactos da conta en parameter conta (Tal, obligatorisk) och dess datamängd filtrerar conta_id på den parametern. De band som inte är intressanta i ett inbäddat dokument — sidhuvud, sidfötter — lämnas avstängda.

#Bädda in

1. Dra Underrapport från paletten till ett sidhuvud, en sidfot eller ett gruppband.
2. Välj barnet i Välj rapporten.
3. För var och en av dess parametrar anger du varifrån det kommer: Fält från raden (läser fältet från raden som underrapporten ligger på) eller Fast värde.

Upprepningar med samma parametrar delar på läsningen, så en underrapport i ett gruppsidhuvud kostar en fråga per grupp, inte per rad.

#Streckkoder och bilder

Två element som fullbordar ett affärsdokument:

Streckkod — värdet kan komma från ett fält (det normala i en faktura) eller vara fast:

Fält	Anteckningar
Typ	Code 128 godtar text och siffror. EAN-13 är 12 eller 13 siffror och kontrollerar kontrollsiffran. QR godtar vilken text som helst — det är fakturornas kod.
Fält	”Fältet med värdet som ska kodas. Tomt använder det fasta värdet nedan.”
Fast värde	Används bara när inget fält har valts.
Visa värdet	Skriver ut värdet under strecken (gäller inte QR).

Bild — Källa avgör varifrån den kommer:

Källa	Vad man fyller i
Appens fil	En fil som laddats upp i appen (till exempel icons/logo.svg).
Adress	En URL.
Fält från data	”Fältet med bilden: en URL, en sökväg under assets, eller binären i base64.”

Anpassning avgör vad som händer när bilden inte har samma form som rutan: Rymmas, Fyll eller Sträck.

#Vanliga frågor

Gruppen grupperar ingenting — allt kommer ut i en följd. Grupperingens fält måste tillhöra den huvudsakliga datamängden, och raderna sorteras efter det. Om fältet är tomt i många rader hamnar de alla i samma grupp.

Gruppens summa summerar allt. Aggregatet ligger utanför gruppens band. Lägg det i den gruppens sidfot — det är positionen som avgör beräkningens omfattning.

Diagrammet blir tomt i PDF:en men syns i designen. På designytan visar ett diagram utan data ett exempelurval. I PDF:en finns bara det som data ger: kontrollera Datamängd, Kategorifält och att minst ett Värdefält är valt.

Kan jag lägga en underrapport inuti en annan underrapport? Ja, med samma regel: aldrig i detaljbandet. Men tänk efter två gånger — två inbäddningsnivåer gör dokumentet svårt att förutse, och ofta var det egentligen en grupperingsnivå till man ville ha.