Argumenty sestav

Z BBM Dokumentace iFIS
Verze z 12. 7. 2023, 14:53, kterou vytvořil Jdankova (diskuse | příspěvky) (Založena nová stránka s textem „== Argumenty - dokumentace == {{Tip|V SQL dotazu lze pracovat s proměnnými:<br> ''':idno''' - ID prvotního dokladu v úloze<br> ''':uloha''' - ID úloh…“)
(rozdíl) ← Starší verze | zobrazit aktuální verzi (rozdíl) | Novější verze → (rozdíl)
Skočit na navigaciSkočit na vyhledávání

Argumenty - dokumentace

Tip Tip
V SQL dotazu lze pracovat s proměnnými:

:idno - ID prvotního dokladu v úloze
:uloha - ID úlohy
:formular - implementační jméno formuláře
:obdobi - období dokladu ve tvaru "MM/RR"
:stredisko - ID střediska dokladu


Pozor Pozor
Proměnné musí být velkýma písmeny


INTERNI_UDAJ


Přímé zobrazení jednotlivých položek R_SQL parametru (např. 140_INT_UDAJ)
Interní údaj se na sestavě zobrazuje ve volném bloku mezi údajem o Dodavateli a výpisem důležitých informačních položek v pravé části sestavy.

Příklad Příklad
Soubor:Interniudaj.png



Nastavení probíhá standardně přes formulář „00314 - Správa reportů“, přičemž interní údaj lze libovolně formátovat ve vymezeném prostoru pomocí HTML.

Příklad Příklad
Soubor:SpravaReportu.png



Argument nemá pevně danou strukturu elementů, jedná se o celistvé pole, plnitelné libovolným naformátovaným uživatelským obsahem.


SDETAIL


SDETAIL funguje velmi podobně, jako SDODATEK (jedná se prakticky o identickou kopii stejné funkcionality).
Rozdílné je ovšem umístění SDETAILU v hierarchickém pořadí sestavy, kdy SDETAIL se zobrazuje přímo pod Rekapitulací DPH a SDODATEK na samotném konci sestavy.

Příklad Příklad
Soubor:Sdetail.png



Struktura je velmi podobná (liší se jen názvy jednotlivých součástí):

Poznámka Poznámka
Ukázka plnění SDETAIL XML zdrojem: 
<sdetail>
  <stext><font size="4" color="red"><b>Interní údaje: UKAZKA</b></font><br></stext>
  <polozka Oznaceni="1120512222">
    <p1nadpis Zobrazit="A"> 1</p1nadpis>
    <p2nadpis Zobrazit="N"> 2</p2nadpis>
    <p3nadpis Zobrazit="N"> 3</p3nadpis>
    <p4nadpis Zobrazit="N"> 4</p4nadpis>
    <p5nadpis Zobrazit="N"> 5</p5nadpis>
    <p6nadpis Zobrazit="N"> 6</p6nadpis>
      <radek Cislo="1">
         <p1hodnota> 1</p1hodnota>
         <p2hodnota> 2</p2hodnota>
         <p3hodnota> 3</p3hodnota>
         <p4hodnota> 4</p4hodnota>
         <p5hodnota> 5</p5hodnota>
         <p6hodnota> 6</p6hodnota>
      </radek>
 </polozka>
  <stext2><b>Referent:</b> Karel Vonásek<font face="Consolas"></stext2>
</sdetail>
  </bean>


SDOLOZKA


Přímé zobrazení jednotlivých položek R_SQL parametru (např. 10140_sdolozka – lze změnit uživatelským nastavení ve formuláři „00314 - Správa reportů“).
Opakuje se tolikrát, kolikrát se vyskytuje v R_SQL parametru 10140_sdolozka část „polozka“.

Příklad Příklad
Soubor:Sdolozka.png



SDOLOZKA zobrazuje obsah R_SQL parametru do části „DOTAZ_SDOLOZKA“, který se sestavě přiřazuje ve formuláři „00314 - Správa reportů“ (Parametry sestavy) dle uživatelského požadavku.

Příklad Příklad
Soubor:Sdolozkasprava.png



SDOLOZKA je navržena tak, aby byla modifikovatelná dle uživatelského prostředí.
V záhlaví SDOLOZKY se zobrazuje pole „STEXT“, které lze modifikovat pomocí HTML (změna barvy, zvýraznění, podtržení apod.), v záhlaví pak ekvivalentně pole „STEXT2“ se stejnou funkcionalitou.

Tělo SDOLOZKY tvoří řádkový výpis, který je:
• Formátovatelný pomocí HTML
• Tvořen minimálně 4 sloupci

Levá polovina SDOLOZKY je tvořena Sloupci 1 a 2, pravá Sloupci 2 a 3.
Hodnoty řádkového výpisu odpovídají hodnotě sloupce, v levé polovině se však po celé šířce nachází navíc pole „Text“.

Poznámka Poznámka
Ukázka plnění SDOLOZKA XML zdrojem: 
<sdolozka>
  <stext>SDOLOZKA - STEXT - obsah</stext>
     <polozka>
       <p1nadpis>NADPIS1</p1nadpis>
       <p2nadpis>NADPIS2</p2nadpis>
       <p3nadpis>NADPIS3</p3nadpis>
       <p4nadpis>NADPIS4</p4nadpis>
          <radek Cislo="1">
            <p1hodnota>SLOUPEC1RADEK1</p1hodnota>
            <p2hodnota>SLOUPEC2RADEK1</p2hodnota>
            <p3hodnota>SLOUPEC3RADEK1</p3hodnota>
            <p4hodnota>SLOUPEC4RADEK1</p4hodnota>
            <text>Text1RADEK1SLOUPEC1+2</text>
          </radek>
          <radek Cislo="2">
            <p1hodnota>SLOUPEC1RADEK2</p1hodnota>
            <p2hodnota>SLOUPEC2RADEK2</p2hodnota>
            <p3hodnota>SLOUPEC3RADEK2</p3hodnota>
            <p4hodnota>SLOUPEC4RADEK2</p4hodnota>
           <text>Text1RADEK2SLOUPEC1+2</text>
          </radek>
</polozka>
<stext2>SDOLOZKA-stext2</stext2>
</sdolozka>
  </bean>


SDODATEK


Přímé zobrazení jednotlivých položek R_SQL parametru (např. 10140_sdodatek – lze změnit uživatelským nastavení ve formuláři „00314 - Správa reportů“).
1) TITLE (16px) – stext
2) Detail 1 (12px) – subreport „kontacni_polozka“ (výpis nadpisů SDODATKU)
3) Detail 2 (20px) – stext2

SDODATEK zobrazuje obsah R_SQL parametru do části „DOTAZ_SDODATEK“, který se sestavě přiřazuje ve formuláři „00314 - Správa reportů“ (Parametry sestavy) dle uživatelského požadavku.
SDODATEK je navržen tak, aby byla plně modifikovatelná dle uživatelského prostředí. V záhlaví SDODATKU se zobrazuje pole „STEXT“, které lze modifikovat pomocí HTML (změna barvy,
zvýraznění, podtržení apod.), v záhlaví pak ekvivalentně pole „STEXT2“ se stejnou funkcionalitou.

Tělo SDODATKU tvoří řádkový výpis, který je:
• Omezeně dynamicky škálovatelný dle uživatelského nastavení příslušného R_SQL dotazu.
• Formátovatelný pomocí HTML
• Tvořen minimálně 1 sloupcem a maximálně 6 sloupci v závislosti na uživatelském nastavení v R_SQL dotazu.

Dynamické škálování šířky sloupců probíhá dle zobrazení/skrytí vybraných sloupců, vždy však dochází k rozšiřování „Sloupce 1“ (tento sloupec jako jediný nelze skrýt). Ve výchozím nastavení (pokud jsou zobrazeny všechny sloupce) mají tyto délku:
• Sloupec 3 a 6 „dvojnásobnou“ šířku oproti standardu = 127px
• Sloupce 1, 2,4 a 5 standardní šířku = 65px
V případě, že dojde ke skrytí kteréhokoli sloupce, dochází současně k rozšíření sloupce 1 na jeho úkor tj. původní délka 65px se rozšíří o dalších 65px resp. 127px . Stejný princip se aplikuje i v případě skrytí většího počtu sloupců, vždy v odpovídajícím poměru.
Skrytí sloupce v R_SQL parametru probíhá velmi jednoduše změnou hodnoty v odpovídajícím sloupci (hodnota „A“ = zobrazit; hodnota „N“ = skrýt)

Příklad Příklad
Soubor:SDODATEK.png



Příklad - SDODATEK – 2 sloupce – chybí sloupce 2,3,4 a 5


• 3 sloupce
• Sloupec 6 s šířkou 127px.
• Sloupec 1 rozšířen dynamicky na úkor chybějícího „Sloupce 2“, „Sloupce 3“, „Sloupce 4“ a „Sloupce 5“ – výsledná velikost tedy 65px+65px+127px+65px+65px=387px
• Ostatní sloupce standardní šířka 65px.

Příklad Příklad
Soubor:Sdodatek2sloupce.png



Příklad - SDODATEK – 3 sloupce – chybí sloupce 2,3 a 5


• 3 sloupce
• Sloupec 6 s šířkou 127px.
• Sloupec 1 rozšířen dynamicky na úkor chybějícího „Sloupce 2“, „Sloupce 3“ a „Sloupce 5“ – výsledná velikost tedy 65px+65px+127px+65px=322px
• Ostatní sloupce standardní šířka 65px.

Příklad Příklad
Soubor:Sdodatek3sloupce.png



Příklad - SDODATEK – 4 sloupce – chybí sloupce 3 a 5


• 4 sloupce
• Sloupec 6 s šířkou 127px.
• Sloupec 1 rozšířen dynamicky na úkor chybějícího „Sloupce 3“ a „Sloupce 5“ – výsledná velikost tedy 65px+65px+127px=257px
• Ostatní sloupce standardní šířka 65px.

Příklad Příklad
Soubor:Sdodatek4sloupce.png



Příklad - SDODATEK – 5 sloupců – chybí sloupec 2


• 5 sloupců
• Sloupec 3 a Sloupec 6 s šířkou 127px.
• Sloupec 1 rozšířen dynamicky na úkor chybějícího „Sloupce 2“ – výsledná velikost tedy 65px (původní velikost Sloupce 1)+65px (volné místo po sloupci 2)=130px
• Ostatní sloupce standardní šířka 65px.

Příklad Příklad
Soubor:Sdodatek5sloupcu.png



Příklad - SDODATEK – 6 sloupců


• 6 sloupců
• Sloupec 3 a Sloupec 6 s šířkou 127px.
• Ostatní sloupce standardní šířka 65px.

Příklad Příklad
Soubor:Sdodatek6sloupcu.png




Poznámka Poznámka
Ukázka plnění SDODATEK XML zdrojem: 
<sdodatek>
  <stext>STEXT</stext>
    <polozka Oznaceni="1820002232">
       <p1nadpis Zobrazit="A">NADPIS1</p1nadpis>
       <p2nadpis Zobrazit="N">NADPIS2</p2nadpis>
       <p3nadpis Zobrazit="N">NADPIS3</p3nadpis>
       <p4nadpis Zobrazit="N">NADPIS4</p4nadpis>
       <p5nadpis Zobrazit="N">NADPIS5</p5nadpis>
       <p6nadpis Zobrazit="A">NADPIS6</p6nadpis>
         <radek Cislo="1">
           <p1hodnota>SLOUPEC1RAD.1</p1hodnota>
           <p2hodnota>SLOUPEC2RAD.1</p2hodnota>
           <p3hodnota>SLOUPEC3RAD.1</p3hodnota>
           <p4hodnota>SLOUPEC4RAD.1</p4hodnota>
           <p5hodnota>SLOUPEC5RAD.1</p5hodnota>
           <p6hodnota>SLOUPEC6RAD.1</p6hodnota>
         </radek>
         <radek Cislo="2">
           <p1hodnota>SLOUPEC1RAD.2</p1hodnota>
           <p2hodnota>SLOUPEC2RAD.2</p2hodnota>
           <p3hodnota>SLOUPEC3RAD.2</p3hodnota>
           <p4hodnota>SLOUPEC4RAD.2</p4hodnota>
           <p5hodnota>SLOUPEC5RAD.2</p5hodnota>
           <p6hodnota>SLOUPEC6RAD.2</p6hodnota>
         </radek>
       </polozka>
  <stext2>SDODATEK - stext2</stext2>
</sdodatek>
  </bean>


Použití na projektech

  • AMU,EIS3,FAF,FF,JCU,LFK,MFF,MSA,NTK,PEDF,PRF,SURO,UFM,UJEP,UPA,UTIA,VFU,VSCHT,(VSE),VSPJ,VSTE,VSUP,CVUT1,CVUT2
    • 10140_SDETAIL 1
    • 10721_SDODATEK 1+2+3+4+5+6
  • EIS3,UTIA1,UTIA2
    • 10140_SDODATEK_V2 1+3+6
  • UPA
    • 10140_SDODATEK 1+4+5+6
  • VSE
    • 10140_SDETAIL 1+2+3+4+5
  • NTK
    • 10140_SDODATEK
    • 1+2+3+4+6 - Dle požadavku NTK
      • 1 (77px) + 2 (28px) + 3 (129px) + 4 (123px) + 6 (65px)
    • 1+3+4 - Stejně široké sloupce

DOTAZ_SQL

Dotazování pomocí DOTAZ_SQL
Jen u sestavy RJ_BIANCO%

DOTAZ_KOD

Varování Varování
Už by se nemělo používat!
Nahrazeno DOTAZ_SCTECKA



Skenovací 2D QR kód sestavy se zobrazuje na stejné úrovni, jako nadpis sestavy s odsazením vlevo od tohoto nadpisu.
Tento kód je plněn hodnotou argumentu „DOTAZ_KOD“, který lze nastavit ve formuláři „00314 - Správa reportů“.

Příklad Příklad
Soubor:Kod.png



Obsah kódu se zobrazuje ve svislém zobrazení v těsné návaznosti pod samotným kódem.

Příklad Příklad
Soubor:Kodsprava.png


Poznámka Poznámka
Ukázka plnění elementu kod: 
    <kod>123</kod>


DOTAZ_PODPIS


Podpis se na sestavě zobrazuje jako poslední element - stvrzuje se jím obsah celého reportu.
Podpis je dynamicky nastavitelný a formátovatelný - záleží na požadavcích zákazníka a technologickým možnostem.

Příklad Příklad
Soubor:Podpis.png



Jednotlivé varianty kódu (např. s 1, 2 či více podpisy) lze efektivně přepínat přes formulář „00314 - Správa reportů“ v poli "DOTAZ_PODPIS".

Poznámka Poznámka
Ukázka plnění elementu sql_podpis: 
  <sql_podpis>
    <font face="Times New Roman" size="3"><b>Zpráva pro odběratele:</b></font><br>
    <font face="Times New Roman" size="3">text faktury</font><br><font size="1">&nbsp;</font><br>
    <font face="Times New Roman"><b>Fakturoval:</b><br>Zaměstnanci BBM<br>Tel.: 724-162-687, E-mail: dmatoska@bbm.cz</font>
    <font face="Consolas"><br> &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp</font>
    <font face="Times New Roman" size="1">Sídlo organizace:České vysoké učení technické v Praze, Zikova 4, Praha 6, 166 36</font>
</sql_podpis>


DOTAZ_KONEC


DOTAZ_KONEC umožňuje uživateli navolit si modifikovatelný řetězec, který je na výstupu zobrazován pod blokem Podpisu.
Je plněn uživatelsky volitelným R_SQL parametrem (lze změnit uživatelským nastavení ve formuláři „00314 - Správa reportů“).

Příklad Příklad
Soubor:DotazKonec.jpg



Logo se zobrazuje v záhlaví reportu. DOTAZ_LOGO zobrazuje logo projektu/ekonomické jednotky, které si na projektu sami navolí pomocí příslušného R_SQL parametru.
Doposud se logo staticky přebíralo pro celý projekt ze složky "Images" na Jasper serveru jako obrázek s názvem "logo".
Nyní lze vlastní logo navolit libovolně na kterékoli ekonomické jednotce pomocí R_SQL parametru "DOTAZ_LOGO" - poté stačí jen zavolat příslušný název souboru loga, který je uložen ve složce "Images" na Jasper serveru
DOTAZ_LOGO má absolutní prioritu zobrazení - pokud je tedy "DOTAZ_LOGO" neprázdný, jeho obsah překrývá na šabloně společné logo pro celý projekt

Šablony, na kterých je implementováno DOTAZ_LOGO:

  • RJ_EKODFA
  • RJ_EKODFAE
  • RJ_EKODFAD
  • RJ_EKOSG
  • RJ_EKPEF
  • RJ_ZSOBJED
  • RJ_ZSOBJEDE
  • RJ_ZSOBJEDD
  • RJ_EKPOKL
  • RJ_EKAVIZO
  • RJ_EKODDO
  • RJ_EKODDOE
  • RJ_EKODDOD
Příklad Příklad
Soubor:LOGO EJ.png


DOTAZ_VZOR (Obrázek)


DOTAZ_VZOR zobrazuje uživatelsky zvolený obrázek.
Je plněn uživatelsky volitelným R_SQL parametrem, který obsahuje název obrázku (lze změnit uživatelským nastavení ve formuláři „00314 - Správa reportů“).
Defaultní zarovnání obrázku na střed ve skutečné velikosti.

Příklad Příklad
Soubor:DotazVzor.jpg



Příklad Příklad
Soubor:DotazVzor ukazka.jpg


DOTAZ_QR


DOTAZ_QR zobrazuje uživatelsky volitelné QR kódy v zápatí reportu.
Dotaz je plněn R_SQL parametrem, který obsahuje uživatelsky volitelný řetězec pro nastavení QR kódů (lze změnit uživatelským nastavení ve formuláři „00314 - Správa reportů“).
Lze navolit až 2 QR kódy, umístěné v zápatí reportu.

  • Oba QR kódy jsou naformátovány identicky ve velikosti 60x60px (vel. 10). QR kódy jsou plněny daty z elementu data.
  • Nad a pod QR kódy se zároveň vypisují informační popisky elementů nadpis (nad kódem), resp. popis (pod kódem).
  • R_SQL parametr musí respektovat požadovanou strukturu XML, která je nutnou podmínkou pro validní plnění QR kódů a příslušných informačních popisků.


Vyžadována je následující struktura (ukázka pro výpis 2 QR kódů):

Příklad Příklad
Soubor:KODY.jpg




Oba kódy (kódy s pořadím 1 a 2) musejí být umístěny v hierarchii pod elementem qr_kody a celý blok pod elementem kody.
V případě požadavku na jeden QR kód je možné kód s pořadím 2 vynechat.
Vizualizace vzorového QR kódu je demonstrována pro přehlednost na níže uvedeném obrázku.

Příklad Příklad
Soubor:POPISQR.jpg



Příklad Příklad
Soubor:DotazQR.jpg



Příklad Příklad
Soubor:DotazQR ukazka.jpg


DOTAZ_SCTECKA


Pomocí argumentu SCTECKA jsou plněny čárové/QR kódy na pozadí reportu. Aktuální plán využití u faktur, objednávek, likvidačních listů.
Argument DOTAZ_SCTECKA je plněn R_SQL řetězcem ve vazbě na formulář.
Pomocí tohoto argumentu jsou na sestavě zobrazeny čárové/QR kódy v předem určených pozicích.
Struktura plnění každého jednoho kódu v DOTAZU je následující:

<kod typ="typ_kodu" pozice="pozice" opakovat="opakovat" text="Skenovací kód">

kde:
•"typ_kodu" je plněn hodnotami pro výběr typu čárového/QR kódu (CODE128c nebo CODE39 nebo QR)
•"pozice" hodnotami pro umístění kódu rozložení (HL - levý horní roh, HS - střed záhlaví, HP - pravý horní roh, LH - horní levý okraj, LS - střed levého okraje, LD - levý dolní okraj, PH - pravý horní okraj, PS - střed pravého okraje, PD - pravý dolní okraj, ZL - levý spodní roh, ZS - střed zápatí, ZP - pravý dolní roh)
•"opakovat" hodnotami (A - opakovat na každé straně, N - pouze na 1. straně)

Ukázka XML viz:

Příklad Příklad
Soubor:DOTAZ SCTECKA XML.png



Ukázka výstupu viz:

Příklad Příklad
Soubor:DOTAZ SCTECKA UKAZKA.png




Schéma reportu


Schéma navaznosti jednotlivých částí (argumentů) reportu na šabloně

Příklad Příklad
Soubor:SchemaSestav2.jpeg


Schéma SDOLOZKA

Možnosti zobrazení jednotlivých sloupců v SDOLOZKA.
Soubor:RozmisteniSloupcu.png

Citováno z „https://wiki.bbm.cz/index.php?title=Argumenty_sestav&oldid=103010“