Argumenty sestav: Porovnání verzí

Z BBM Dokumentace iFIS
Skočit na navigaciSkočit na vyhledávání
VizuálníWikitext
Jdankova (diskuse | příspěvky)
24 367 editací
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…“
 
Jdankova (diskuse | příspěvky)
24 367 editací
Bez shrnutí editace
 
(Není zobrazeno 33 mezilehlých verzí od stejného uživatele.)
Řádek 1: Řádek 1:
== Argumenty - dokumentace ==
__TOC__
 
==Proč parametrizovat sestavy==
 
Tiskové sestavy jsou různě nastavitelné a jejich konečný vzhled lze přizpůsobit konkrétním požadavkům zákazníka. Jelikož požadavky různých zákazníků na konečný vzhled sestavy se v mnohém liší, bylo nutné přizpůsobit se požadavkům zákazníků a navrhnout sestavy tak, aby bylo možné je různě parametrizovat. Většinou se k tomu se z velké části využívají tzv. R_SQL parametry, které můžou být jak jednoduchého charakteru, tak i o poznání složitější a vyžadují už hlubší znalosti SQL jazyka a sestavování náročnějších dotazů. Zobrazení některých údajů na sestavě se dají změnit či nastavit jen pomocí textu. Sestavy mohou být také různě parametrizovány pomocí textu, který může být i v podobě HTML. Nastavením různých parametrů lze tak vybranou sestavu přizpůsobit přímo na míru individuálním potřebám konkrétního uživatele.
 
 
==Nastavení pro konkrétní formulář a sestavu==
 
Vzhled sestavy lze měnit pomocí parametrů, a to pro konkrétní sestavu a formulář, odkud je sestava volána.
 
Je-li potřeba nastavit stejný vzhled sestavy pro všechny formuláře nebo jen vybrané formuláře, odkud se dá sestavu vyvolat, musí být stejné parametry nastaveny pro každý formulář zvlášť.
 
{{Poznamka|Sestavy lze tisknout jen z určených formulářů. Pokud si zákazník přeje přiřadit sestavu ke konkrétnímu formuláři, kde by se mu sestava hodila zobrazit, je nutné kontaktovat pracovníky BBM přes aplikaci Helpdesk.}}
 
{{Tip|Jsou ale i sestavy, které si mohou zákazníci přiřadit ke konkrétnímu formuláři sami, pokud k tomu mají požadovaná oprávnění. Toto nastavení se týká sestav pomocí kterých se tisknou příkazy k úhradě nebo různé výkazy pro potřeby výkaznictví.<br>
[[Přiřazení sestav k účtům / výkazům|Jak přiřadit sestavu k účtům / výkazům?]].}}
 
{{Priklad|Lze tedy například nastavit jiný vzhled sestavy [[13020 - Objednávka|13020]] - Objednávka volané z formuláře [[Man30335|30335]] - Objednávky - detail a jiný vzhled může mít ta samá sestava volaná z formuláře [[Man09925|09925]] - ''Schvalování dokumentů - Vystavená objednávka''.}}
 
Seznam možných parametrů, které lze pro konkrétní sestavu využít a z nichž si lze nadefinovat její vzhled ušitý na míru zákazníka, lze získat ve formuláři [[Man00314|00314]] - ''Správa parametrů''.
 
Parametry, které zde nejsou uvedené, nelze pro nastavení použít. Jak vyhledat seznam parametrů, které lze u dané sestavy použít, je blíže popsán v následující kapitole.
 
 
==Jak vyhledat seznam parametrů, které lze pro danou sestavu použít==
 
{{Tip|'''Seznam použitelných parametrů pro danou sestavu je dohledatelný následujícím postupem:'''
 
#Otevře se formulář [[Man00314|00314]] - ''Správa parametrů'' z menu '''Správce &rarr; Nastavení systému'''
#Vyhledá se požadovaná sestava
#Klikne na záložku ''Volán z''
#V případě, že je možné sestavu volat z více formulářů, vybere se požadovaný formulář, z jakého se nový vzhled sestavy bude tisknout
#na konci řádku s číslem a názvem formuláře se stiskne koncové tlačítko se třemi tečkami  [[Image:Tlacitko se tremi teckami.png]]
#Vyvolá se okno s parametry sestav
#Zobrazí se seznam veškerých parametrů, kterými lze sestavu pro tento konkrétní formulář nastavit
}}
 
Pak už jen stačí ke konkrétnímu parametru zadat hodnotu a sestava je nastavena.
 
 
Jak jednoduché. Ale jakou hodnotu lze do sloupce ''Hodnota'' vkládat? Odpověď naleznete v následující kapitole.
 
 
==Hodnota parametru==
 
Hodnota parametru může obsahovat:
*libovolný text - využívá se zejména pro záměnu textu na sestavě a lze ho využít tam, kde je zapotřebí změnit název uvedený pro konkrétní pole zobrazené na sestavě (např. pomocí parametru NAZEV_KDO lze na sestavě objednávky změnit text "Odesílatel" na požadovaný, např. "Odběratel", apod.), lze využív např. pro parametr '''NAZEV_KDO''', '''NAZEV_DOKUMENTU''', apod.
*R_SQL parametru - do pole ''Hodnota'' lze uvést '''název''' konkrétního R_SQL parametru přičemž tento název musí odpovídat názvu uvedenému ve formuláři [[Man00316|00316]] - ''Administrace R_SQL parametrů'' ve sloupci ''Parametr'' &rarr; označuje pouze '''název R_SQL parametru''', který je blíže specifikován v položce ''SQL Definice''. Nastavení vzhledu sestav tak skýtá nepřeberné množství podob, což dává možnost umístit na tiskovou sestavu téměř cokoli, jakýkoli obrázek, logo, otisk razítka, libovolné podpisové pole, různé QR kódy pro moderní způsob placení, různou podobu kódů používající se pro evidenci majetku, smluv, objednávek, faktur a umožňující tak i snadnější inventarizaci či rychlejší odbyt či vyskladňování zboží či naceňování pro potřeby e-shopů, apod.
 
{{Priklad|[[Image:Nastaveni pomoci textu.png]]<br>
'''Obr.''' ''Příklad nastavení pomocí textu - co se bude zobrazovat místo textu označujícího odesílatele &rarr; Odběratel a co na místo textu názvu objednávky na sestavě [[13020 - Objednávka|13020]] - Objednávka volané z formuláře [[Man30335|30335]] - Objednávky - detail''.
}}
 
 
==Nastavení pomocí R_SQL parametrů==
 
V současné době stále více vzrůstá obliba parametrizovat si sestavy pomocí různých R_SQL parametrů, které umožní umístit na sestavu "téměř" cokoli. Jejich nastavení je rychlé, snadné a zvládne ho i méně zdařilý odborník se znalostí SQL jazyka. R_SQL parametry mohou být nastaveny jak pomocí jednoduchých dotazů, ale i těch složitějších, které již vyžadují hlubší znalosti náročnějších SQL dotazů.
 
Jednotlivé R_SQL parametry včetně jejich podrobných selectů ve formě SQL dotazů se definují ve formuláři [[Man00316|00316]] - ''Administrace R_SQL parametrů''
 
V současném moderním světě vzrůstá potřeba přizpůsobovat si vzhled tiskových sestav pro stále rychlejší metody plateb např. u faktur kde je platba probíhá ihned po naskenování QR kódů či různých jiných kódů ale i pro rychlejší evidenci v systémech. K tomu lze využít právě R_SQL parametry, které umožňují nepřeberné množství nastavení sestav. R_SQL parametry, které se sestavují pomocí R_SQL dotazů a různých selectů, jimiž lze nastavit konečný vzhled sestavy přímo na míru individuálním potřebám zákazníka.
 
{{Poznamka|Pokud lze údaj na sestavě zobrazit pomocí R_SQL parametru, jeho '''přesný název''' se vyplní do formuláře [[Man00314|00314]] - ''Správa reportů'' na záložku ''Volán z'' pomocí tlačítka se třemi tečkami [[Image:Tlacitko se tremi teckami.png]].}}
 
{{Pozor|Přesný název R_SQL parametru a jeho celý obsah se definuje ve formuláři [[Man00316|00316]] - ''Administrace R_SQL parametrů''.}}
 
==Proměnné použitelné v SQL dotazu==


{{Tip|V SQL dotazu lze pracovat s proměnnými:<br>
{{Tip|V SQL dotazu lze pracovat s proměnnými:<br>
Řádek 7: Řádek 74:
''':obdobi''' - období dokladu ve tvaru "MM/RR"<br>
''':obdobi''' - období dokladu ve tvaru "MM/RR"<br>
''':stredisko''' - ID střediska dokladu}}
''':stredisko''' - ID střediska dokladu}}
{{Pozor|Proměnné musí být velkýma písmeny}}
{{Pozor|Proměnné musí být velkými písmeny}}
 
==Schéma reportu==
<br>V následující tabulce je přehled parametrů a jejich umístění na reportu (sestavě).
{{Priklad|[[Soubor:Schema reportu.png]]}}
 
==Seznam všech parametrů, kterými lze vzhled sestavy měnit==
 
 
===DOTAZ_SCTECKA===
 
*Definuje se pomocí XML
*Nastaví se ve formuláři [[Man00314|00314]] - ''Správa reportů'' na záložce ''Volán z'' pomocí tlačítka se třemi tečkami [[Image:Tlacitko se tremi teckami.png]], kde se k uvedenému parametru sestavy vloží do hodnoty název konkrétního R_SQL parametru
*Název R_SQL parametru a jeho přesný obsah se definuje ve formuláři [[Man00316|00316]] - ''Administrace R_SQL parametrů''
*Formátování se nastavuje pomocí HTML
 
 
===DOTAZ_SDETAIL===
 
*Strukturou se podobá parametru DOTAZ_SDODATEK s tím rozdílem, že DOTAZ_SDETAIL se zobrazuje přímo pod Rekapitulací DPH a SDODATEK na samotném konci sestavy
*Umožňuje vytvořit tabulku a nadefinovat až 6 různých sloupců, stanoví jejich šířku a formát podle možností zobrazení
*Definuje se pomocí XML
*Nastaví se ve formuláři [[Man00314|00314]] - ''Správa reportů'' na záložce ''Volán z'' pomocí tlačítka se třemi tečkami [[Image:Tlacitko se tremi teckami.png]], kde se k uvedenému parametru sestavy vloží do hodnoty název konkrétního R_SQL parametru
*Název R_SQL parametru a jeho přesný obsah se definuje ve formuláři [[Man00316|00316]] - ''Administrace R_SQL parametrů''
*Formátování se nastavuje pomocí HTML
 
 
===DOTAZ_SDODATEK===
 
*Strukturou se podobá parametru DOTAZ_SDETAIL s tím rozdílem, že DOTAZ_SDETAIL se zobrazuje přímo pod Rekapitulací DPH a SDODATEK na samotném konci sestavy
*Umožňuje vytvořit tabulku a nadefinovat až 6 různých sloupců, stanoví jejich šířku a formát podle možností zobrazení
*Definuje se pomocí XML
*Nastaví se ve formuláři [[Man00314|00314]] - ''Správa reportů'' na záložce ''Volán z'' pomocí tlačítka se třemi tečkami [[Image:Tlacitko se tremi teckami.png]], kde se k uvedenému parametru sestavy vloží do hodnoty název konkrétního R_SQL parametru
*Název R_SQL parametru a jeho přesný obsah se definuje ve formuláři [[Man00316|00316]] - ''Administrace R_SQL parametrů''
*Formátování se nastavuje pomocí HTML
 
[[Soubor:Schema SDODATEK.png]]<br>
'''Obr.''' ''Schéma zobrazení jednotlivých sloupců v parametru DOTAZ_SDODATEK''
 
 
===DOTAZ_SDOLOZKA===
 
*Definuje se pomocí XML
*Nastaví se ve formuláři [[Man00314|00314]] - ''Správa reportů'' na záložce ''Volán z'' pomocí tlačítka se třemi tečkami [[Image:Tlacitko se tremi teckami.png]], kde se k uvedenému parametru sestavy vloží do hodnoty název konkrétního R_SQL parametru
*Název R_SQL parametru a jeho přesný obsah se definuje ve formuláři [[Man00316|00316]] - ''Administrace R_SQL parametrů''
*Formátování se nastavuje pomocí HTML
*Umožňuje vytvořit tabulku, která bude obsahovat minimálně 4 sloupce se 4 nadpisy
*Může obsahovat 2 podsloupce a 4 řádky s textem
*Lze opakovat a tím přibydou další a další podsloupce s řádky
 
 
===DOTAZ_INTERNI_UDAJ===
 
*Umisťuje blok různého formátu (pole) mezi údaj o dodavateli a výpisem důležitých informačních položek v pravé části sestavy
*Představuje libovolné pole, které lze různě formátovat podle potřeb pomocí HTML
*Nastaví se ve formuláři [[Man00314|00314]] - ''Správa reportů'' na záložce ''Volán z'' pomocí tlačítka se třemi tečkami [[Image:Tlacitko se tremi teckami.png]], kde se k uvedenému parametru sestavy vloží do hodnoty název konkrétního R_SQL parametru
*Název R_SQL parametru a jeho přesný obsah se definuje ve formuláři [[Man00316|00316]] - ''Administrace R_SQL parametrů''
*Je na uživateli, jakým způsobem naplní
 
 
===DOTAZ_KOD===
 
{{Pozor|Do budoucna se už používat nebude a od jeho používání se již v současné době upouští.}}
 
{{Tip|Místo parametru DOTAZ_KOD se v současné době využívá parametr DOTAZ_SCTECKA, který lze lépe parametrizovat a přizpůsobit požadavkům zákazníků.}}
 
*Umístil na sestavu skenovací 2D QR kód ve stejné úrovní jako je nadpis sestavy a zároveň ho odsadí od levého okraje
*Ve svislém zobrazení pod ním je umístěn obsah kódu
*Zákazníci ho již moc nevyužívají a místo něj raději již nyní volí nastavení parametru DOTAZ_SCTECKA, který ho dokáže plnohodnotně a lépe nahradit
*Nastavoval se ve formuláři [[Man00314|00314]] - ''Správa reportů'' na záložce ''Volán z'' pomocí tlačítka se třemi tečkami [[Image:Tlacitko se tremi teckami.png]], kde se k uvedenému parametru sestavy vložil do hodnoty název konkrétního R_SQL parametru
*Název R_SQL parametru a jeho přesný obsah se definoval ve formuláři [[Man00316|00316]] - ''Administrace R_SQL parametrů''
 
[[Image:2DQRKod.png]]<br>
'''Obr.''' ''2D QR kód tvořený parametrem DOTAZ_KOD''
 
 
===DOTAZ_KONEC===
 
*Umisťuje se pod podpisové pole
*Může být zobrazeno jako libovolný řetězec či text
*Formátování se nastavuje prostřednictvím HTML
*Nastaví se ve formuláři [[Man00314|00314]] - ''Správa reportů'' na záložce ''Volán z'' pomocí tlačítka se třemi tečkami [[Image:Tlacitko se tremi teckami.png]], kde se k uvedenému parametru sestavy vloží do hodnoty název konkrétního R_SQL parametru
*Název R_SQL parametru a jeho přesný obsah se definuje ve formuláři [[Man00316|00316]] - ''Administrace R_SQL parametrů''
*Pokud je to nastavitelné, lze přizpůsobit požadavkům zákazníků
 
 
===DOTAZ_LOGO===
 
*Definuje název obrázku loga
*Umístí obrázek loga kamkoli na sestavu dle potřeb zákazníka
*Lze libovolně zvětšovat či zmenšovat
*Nastaví se ve formuláři [[Man00314|00314]] - ''Správa reportů'' na záložce ''Volán z'' pomocí tlačítka se třemi tečkami [[Image:Tlacitko se tremi teckami.png]], kde se k uvedenému parametru sestavy vloží do hodnoty název konkrétního R_SQL parametru
*Název R_SQL parametru a jeho přesný obsah se definuje ve formuláři [[Man00316|00316]] - ''Administrace R_SQL parametrů''
 


=== INTERNI_UDAJ ===
===DOTAZ_OBJ_INFO===


<br>Přímé zobrazení jednotlivých položek R_SQL parametru (např. [[140_INT_UDAJ]])
*Nastaví se ve formuláři [[Man00314|00314]] - ''Správa reportů'' na záložce ''Volán z'' pomocí tlačítka se třemi tečkami [[Image:Tlacitko se tremi teckami.png]], kde se k uvedenému parametru sestavy vloží do hodnoty název konkrétního R_SQL parametru
<br>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.
*Název R_SQL parametru a jeho přesný obsah se definuje ve formuláři [[Man00316|00316]] - ''Administrace R_SQL parametrů''
{{Priklad|[[Soubor:Interniudaj.png]]}}
<br>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.
{{Priklad|[[Soubor:SpravaReportu.png]]}}
<br>Argument nemá pevně danou strukturu elementů, jedná se o celistvé pole, plnitelné libovolným naformátovaným uživatelským obsahem.




=== SDETAIL ===
===DOTAZ_PODPIS===


<br> SDETAIL funguje velmi podobně, jako SDODATEK (jedná se prakticky o identickou kopii stejné funkcionality).
*Umístí na konec sestavy podpisové pole v libovolném zobrazení
<br>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.
*Formátování se nastavuje prostřednictvím HTML
{{Priklad|[[Soubor:sdetail.png]]}}
*Umožňuje na sestavu umístit libovolný počet podpisů, který je potřeba tam mít spolu s dalšími údaji
<br>Struktura je velmi podobná (liší se jen názvy jednotlivých součástí):
*Lze nastavit zákazníkovi přímo na míru a přizpůsobit jeho potřebám
<br>
*Pokud je to nastavitelné, lze podpisové pole s údaji přizpůsobit požadavkům zákazníků
{{Poznamka|'''Ukázka plnění SDETAIL XML zdrojem:'''
*Nastaví se ve formuláři [[Man00314|00314]] - ''Správa reportů'' na záložce ''Volán z'' pomocí tlačítka se třemi tečkami [[Image:Tlacitko se tremi teckami.png]], kde se k uvedenému parametru sestavy vloží do hodnoty název konkrétního R_SQL parametru
<source lang="html5">
*Název R_SQL parametru a jeho přesný obsah se definuje ve formuláři [[Man00316|00316]] - ''Administrace R_SQL parametrů''
<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>
</source>}}


=== SDOLOZKA ===


<br>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ů“).
===DOTAZ_QR===
<br>Opakuje se tolikrát, kolikrát se vyskytuje v R_SQL parametru 10140_sdolozka část „polozka“.
{{Priklad|[[Soubor:sdolozka.png]]}}
<br>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.
{{Priklad|[[Soubor:sdolozkasprava.png]]}}
<br>SDOLOZKA je navržena tak, aby byla modifikovatelná dle uživatelského prostředí.
<br>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.
<br>
<br>Tělo SDOLOZKY tvoří řádkový výpis, který je:
<br>• Formátovatelný pomocí HTML
<br>• Tvořen minimálně 4 sloupci
<br>
<br>Levá polovina SDOLOZKY je tvořena Sloupci 1 a 2, pravá Sloupci 2 a 3.
<br>Hodnoty řádkového výpisu odpovídají hodnotě sloupce, v levé polovině se však po celé šířce nachází navíc pole „Text“.
<br>
{{Poznamka|'''Ukázka plnění SDOLOZKA XML zdrojem:'''
<source lang="html5">
<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>
</source>}}


=== SDODATEK ===
*Umístí kamkoli na sestavu QR kód
*Může jich být i více
*Bývá umístěn zejména na fakturách
*Umožňuje moderní způsob placení
*Definuje se pomocí XML
*Nastaví se ve formuláři [[Man00314|00314]] - ''Správa reportů'' na záložce ''Volán z'' pomocí tlačítka se třemi tečkami [[Image:Tlacitko se tremi teckami.png]], kde se k uvedenému parametru sestavy vloží do hodnoty název konkrétního R_SQL parametru
*Název R_SQL parametru a jeho přesný obsah se definuje ve formuláři [[Man00316|00316]] - ''Administrace R_SQL parametrů''
*Formátování se nastavuje pomocí HTML


<br>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ů“).
[[Image:DOTAZ KOD QR.png]]<br>
<br>1) TITLE (16px) – stext
'''Obr.''' ''Příklad zobrazení QR kódů pomocí parametru DOTAZ_QR''
<br>2) Detail 1 (12px) – subreport „kontacni_polozka“ (výpis nadpisů '''SDODATKU''')
<br>3) Detail 2 (20px) – stext2
<br>
<br>'''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.
<br>
'''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,
<br>zvýraznění, podtržení apod.), v záhlaví pak ekvivalentně pole „''STEXT2“'' se stejnou funkcionalitou.
<br>
<br>Tělo '''SDODATKU''' tvoří řádkový výpis, který je:
<br>• Omezeně dynamicky škálovatelný dle uživatelského nastavení příslušného R_SQL dotazu.
<br>• Formátovatelný pomocí HTML
<br>• Tvořen minimálně 1 sloupcem a maximálně 6 sloupci v závislosti na uživatelském nastavení v R_SQL dotazu.
<br>
<br>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:
<br>•  Sloupec 3 a 6 „dvojnásobnou“ šířku oproti standardu = '''127px'''
<br>•  Sloupce 1, 2,4 a 5 standardní šířku = '''65px'''
<br>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.
<br>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)
{{Priklad|[[Soubor:SDODATEK.png]]}}
<br>
==== Příklad - SDODATEK – 2 sloupce – chybí sloupce 2,3,4 a 5 ====
<br>• 3 sloupce
<br>• Sloupec 6 s šířkou 127px.
<br>• 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
<br>• Ostatní sloupce standardní šířka 65px.
{{Priklad|[[Soubor:Sdodatek2sloupce.png]]}}


<br>
==== Příklad - SDODATEK – 3 sloupce – chybí sloupce 2,3 a 5 ====
<br>• 3 sloupce
<br>• Sloupec 6 s šířkou 127px.
<br>• 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
<br>• Ostatní sloupce standardní šířka 65px.
{{Priklad|[[Soubor:Sdodatek3sloupce.png]]}}


<br>
===DOTAZ_VZOR===
==== Příklad - SDODATEK – 4 sloupce – chybí sloupce 3 a 5 ====
<br>• 4 sloupce
<br>• Sloupec 6 s šířkou 127px.
<br>• Sloupec 1 rozšířen dynamicky na úkor chybějícího „Sloupce 3“ a „Sloupce 5“ – výsledná velikost tedy 65px+65px+127px=257px
<br>• Ostatní sloupce standardní šířka 65px.
{{Priklad|[[Soubor:Sdodatek4sloupce.png]]}}


<br>
*Tento parametr obsahuje název R_SQL parametru, kterým lze určit a nastavit definici libovolného obrázku pro zobrazení např. kulatého razítka s podpisovými údaji
==== Příklad - SDODATEK – 5 sloupců – chybí sloupec 2 ====
*Nastaví se ve formuláři [[Man00314|00314]] - ''Správa reportů'' na záložce ''Volán z'' pomocí tlačítka se třemi tečkami [[Image:Tlacitko se tremi teckami.png]], kde se k uvedenému parametru sestavy vloží do hodnoty název konkrétního R_SQL parametru
<br>• 5 sloupců
*Název R_SQL parametru a jeho přesný obsah se definuje ve formuláři [[Man00316|00316]] - ''Administrace R_SQL parametrů''
<br>• Sloupec 3 a Sloupec 6 s šířkou 127px.
*Parametr se stále používá a lze ho využít především pro zobrazení otisku kulatého razítka nebo lze pomocí něj zobrazit na sestavě různá loga např. poskytovatelů dotace, fondů, apod.
<br>• 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
*Dá se zobrazit pouze na konci sestavy s umístěním pod podpisem
<br>• Ostatní sloupce standardní šířka 65px.
{{Priklad|[[Soubor:Sdodatek5sloupcu.png]]}}


<br>
==== Příklad - SDODATEK – 6 sloupců ====
<br>• 6 sloupců
<br>• Sloupec 3 a Sloupec 6 s šířkou 127px.
<br>• Ostatní sloupce standardní šířka 65px.
{{Priklad|[[Soubor:Sdodatek6sloupcu.png]]}}


<br>
===NAZEV_DOKUMENTU===


*Definuje se pomocí textu, který může být formátu HTML
*Definuje se pomocí něho text, který nahrazuje název dokumentu


{{Poznamka|'''Ukázka plnění SDODATEK XML zdrojem:'''
<source lang="html5">
<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>
</source>}}


==== Použití na projektech ====
===NAZEV_KDO===


*AMU,EIS3,FAF,FF,JCU,LFK,MFF,MSA,NTK,PEDF,PRF,SURO,UFM,UJEP,UPA,UTIA,VFU,VSCHT,(VSE),VSPJ,VSTE,VSUP,[[Media:SDODATEK_CVUT1.pdf|CVUT1]],[[Media:SDODATEK_CVUT2.pdf|CVUT2]]
*Definuje se pomocí textu, který může být formátu HTML
** 10140_SDETAIL {{Cervene|1}}
*Definuje se pomocí něho text, který nahrazuje označení odesílatele
** 10721_SDODATEK {{Cervene|1+2+3+4+5+6}}
*EIS3,[[Media:SDODATEK_UTIA1.pdf|UTIA1]],[[Media:SDODATEK_UTIA2.pdf|UTIA2]]
** 10140_SDODATEK_V2 {{Cervene|1+3+6}}
* [[Media:SDODATEK_UPA.pdf|UPA]]
** 10140_SDODATEK {{Cervene|1+4+5+6}}
* [[Media:SDODATEK_VSE.pdf|VSE]]
** 10140_SDETAIL {{Cervene|1+2+3+4+5}}
* [[Media:SDODATEK_NTK.pdf|NTK]]
** 10140_SDODATEK
** {{Cervene|1+2+3+4+6}} - Dle požadavku NTK
***1 (77px) + 2 (28px) + 3 (129px) + 4 (123px) + 6 (65px)
**  {{Cervene|1+3+4}} - Stejně široké sloupce


=== DOTAZ_SQL ===


Dotazování pomocí '''DOTAZ_SQL'''<br>
===NAZEV_OBRAZKU===
Jen u sestavy {{Cervene|RJ_BIANCO%}}


=== DOTAZ_KOD ===
*Definuje se pomocí textu, který může být formátu HTML
*Definuje se pomocí něho název obrázku v Jasper


{{Varovani|Už by se nemělo používat!<br>Nahrazeno {{Cervene|DOTAZ_SCTECKA}}}}
<br>Skenovací 2D QR kód sestavy se zobrazuje na stejné úrovni, jako nadpis sestavy s odsazením vlevo od tohoto nadpisu.
<br>Tento kód je plněn hodnotou argumentu „DOTAZ_KOD“, který lze nastavit ve formuláři „00314 - Správa reportů“.
{{Priklad|[[Soubor:kod.png]]}}
<br>Obsah kódu se zobrazuje ve svislém zobrazení v těsné návaznosti pod samotným kódem.
{{Priklad|[[Soubor:kodsprava.png]]}}


{{Poznamka|'''Ukázka plnění elementu kod:'''
===RADKY===
<source lang="html5">
    <kod>123</kod>
</source>}}


=== DOTAZ_PODPIS ===
*Může obsahovat hodnoty + / -
*V případě, že je argument nastaven na hodnotu "+", budou na tiskové sestavě objednávky zobrazeny všechny řádky objednávky bez ohledu na hodnotu příznaku v řádkovém sloupci „Typ“ (N = netisknout řádek, AA = tisknout s cenou, AN = tisknout bez ceny).


<br>Podpis se na sestavě zobrazuje jako poslední element - stvrzuje se jím obsah celého reportu.
<br>Podpis je dynamicky nastavitelný a formátovatelný - záleží na požadavcích zákazníka a technologickým možnostem.
{{Priklad|[[Soubor:podpis.png]]}}
<br>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".


{{Poznamka|'''Ukázka plnění elementu sql_podpis:'''
===VELKY_OBRAZEK===
<source lang="html5">
  <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>
</source>}}


=== DOTAZ_KONEC ===
*Může obsahovat hodnoty + / -
<br>DOTAZ_KONEC umožňuje uživateli navolit si modifikovatelný řetězec, který je na výstupu zobrazován pod blokem Podpisu.
*Pokud je zadaná hodnota "+" u argumentu VELKY_OBRAZEK, nezobrazuje se poté kontace ani schvalovací doložka
<br>Je plněn uživatelsky volitelným R_SQL parametrem (lze změnit uživatelským nastavení ve formuláři „00314 - Správa reportů“).
{{Priklad|[[Soubor:DotazKonec.jpg]]}}


=== DOTAZ_LOGO ===
<br>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.
<br>Doposud se logo staticky přebíralo pro celý projekt ze složky "Images" na Jasper serveru jako obrázek s názvem "logo".
<br>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
<br>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
<br>
<br>Š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'''
{{Priklad|[[Soubor:LOGO_EJ.png]]}}


=== DOTAZ_VZOR (Obrázek) ===
===ZOB_KONTACE===
<br>DOTAZ_VZOR zobrazuje uživatelsky zvolený obrázek.
<br>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ů“).
<br>Defaultní zarovnání obrázku na střed ve skutečné velikosti.
<br>
{{Priklad|[[Soubor:DotazVzor.jpg]]}}
<br>
{{Priklad|[[Soubor:DotazVzor_ukazka.jpg]]}}


=== DOTAZ_QR ===
*Nastaví se ve formuláři [[Man00314|00314]] - ''Správa reportů'' na záložce ''Volán z'' pomocí tlačítka se třemi tečkami [[Image:Tlacitko se tremi teckami.png]], kde se k uvedenému parametru sestavy vloží do hodnoty název konkrétního R_SQL parametru
<br>DOTAZ_QR zobrazuje uživatelsky volitelné QR kódy v zápatí reportu.
*Název R_SQL parametru a jeho přesný obsah se definuje ve formuláři [[Man00316|00316]] - ''Administrace R_SQL parametrů''
<br>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ů“).
<br>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ů.
<br>Vyžadována je následující struktura (ukázka pro výpis 2 QR kódů):
<br>
{{Priklad|[[Soubor:KODY.jpg]]}}
<br>
<br>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''.
<br>V případě požadavku na jeden QR kód je možné kód s pořadím 2 vynechat.
<br>Vizualizace vzorového QR kódu je demonstrována pro přehlednost na níže uvedeném obrázku.
{{Priklad|[[Soubor:POPISQR.jpg]]}}
<br>
{{Priklad|[[Soubor:DotazQR.jpg]]}}
<br>
{{Priklad|[[Soubor:DotazQR_ukazka.jpg]]}}


=== DOTAZ_SCTECKA ===
<br>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ů.
<br>Argument DOTAZ_SCTECKA je plněn R_SQL řetězcem ve vazbě na formulář.
<br>Pomocí tohoto argumentu jsou na sestavě zobrazeny čárové/QR kódy v předem určených pozicích.
<br>Struktura plnění každého jednoho kódu v DOTAZU je následující:
<br>
<br><kod typ="typ_kodu" pozice="pozice" opakovat="opakovat" text="Skenovací kód">
<br>
<br>kde:
<br>  •"typ_kodu" je plněn hodnotami pro výběr typu čárového/QR kódu (CODE128c nebo CODE39 nebo QR)
<br>  •"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)
<br>  •"opakovat" hodnotami (A - opakovat na každé straně, N - pouze na 1. straně)
<br>
<br>Ukázka XML viz: {{Priklad|[[Soubor:DOTAZ SCTECKA XML.png]]}}
<br>Ukázka výstupu viz: {{Priklad|[[Soubor:DOTAZ SCTECKA UKAZKA.png]]}}


===ZOB_PRAZDNOU_SESTAVU===


Pomocí argumentu lze nastavit, aby se vytiskla sestava, i když je prázdná a neobsahuje žádná data. Argument:
*může obsahovat hodnoty '''+/-'''
*nastavuje ve formuláři [[Man00314|00314]] - ''Správa reportů'' na záložce ''Volán z''
*umožňuje zobrazit prázdnou sestavu místo dialogu informujícím, že žádná data nejsou k dispozici
*lze využít zejména u saldo sestav tištěných z formuláře [[Man03474|03474]] - ''Tisk účetního salda'', kde je potřeba vytisknout sestavu například za určité období, i když v tomto období nejsou žádná data, sestava se tak tiskne, ale je prázdná a neobsahuje žádná data
*lze tak vytisknout potvrzení o tom, že k určitému datu u nás určitá firma nemá žádné závazky/pohledávky


{{Poznamka|Více informací k argumentu '''ZOB_PRAZDNOU_SESTAVU''' naleznete [[Man03474#ZobPrazdnouSestavu|zde]].}}


=== Schéma reportu ===
<br><br>'''Odkazy:'''
<br>Schéma navaznosti jednotlivých částí (argumentů) reportu na šabloně
*[[Přiřazení sestav k účtům / výkazům]]
{{Priklad|[[Soubor:SchemaSestav2.jpeg]]}}


=== Schéma SDOLOZKA ===
[[Kategorie:Tiskové sestavy]]
Možnosti zobrazení jednotlivých sloupců v SDOLOZKA.<BR>
[[Soubor:RozmisteniSloupcu.png]]

Aktuální verze z 16. 5. 2025, 12:11

Proč parametrizovat sestavy

Tiskové sestavy jsou různě nastavitelné a jejich konečný vzhled lze přizpůsobit konkrétním požadavkům zákazníka. Jelikož požadavky různých zákazníků na konečný vzhled sestavy se v mnohém liší, bylo nutné přizpůsobit se požadavkům zákazníků a navrhnout sestavy tak, aby bylo možné je různě parametrizovat. Většinou se k tomu se z velké části využívají tzv. R_SQL parametry, které můžou být jak jednoduchého charakteru, tak i o poznání složitější a vyžadují už hlubší znalosti SQL jazyka a sestavování náročnějších dotazů. Zobrazení některých údajů na sestavě se dají změnit či nastavit jen pomocí textu. Sestavy mohou být také různě parametrizovány pomocí textu, který může být i v podobě HTML. Nastavením různých parametrů lze tak vybranou sestavu přizpůsobit přímo na míru individuálním potřebám konkrétního uživatele.


Nastavení pro konkrétní formulář a sestavu

Vzhled sestavy lze měnit pomocí parametrů, a to pro konkrétní sestavu a formulář, odkud je sestava volána.

Je-li potřeba nastavit stejný vzhled sestavy pro všechny formuláře nebo jen vybrané formuláře, odkud se dá sestavu vyvolat, musí být stejné parametry nastaveny pro každý formulář zvlášť.

Poznámka Poznámka
Sestavy lze tisknout jen z určených formulářů. Pokud si zákazník přeje přiřadit sestavu ke konkrétnímu formuláři, kde by se mu sestava hodila zobrazit, je nutné kontaktovat pracovníky BBM přes aplikaci Helpdesk.


Tip Tip
Jsou ale i sestavy, které si mohou zákazníci přiřadit ke konkrétnímu formuláři sami, pokud k tomu mají požadovaná oprávnění. Toto nastavení se týká sestav pomocí kterých se tisknou příkazy k úhradě nebo různé výkazy pro potřeby výkaznictví.

Jak přiřadit sestavu k účtům / výkazům?.


Příklad Příklad
Lze tedy například nastavit jiný vzhled sestavy 13020 - Objednávka volané z formuláře 30335 - Objednávky - detail a jiný vzhled může mít ta samá sestava volaná z formuláře 09925 - Schvalování dokumentů - Vystavená objednávka.


Seznam možných parametrů, které lze pro konkrétní sestavu využít a z nichž si lze nadefinovat její vzhled ušitý na míru zákazníka, lze získat ve formuláři 00314 - Správa parametrů.

Parametry, které zde nejsou uvedené, nelze pro nastavení použít. Jak vyhledat seznam parametrů, které lze u dané sestavy použít, je blíže popsán v následující kapitole.


Jak vyhledat seznam parametrů, které lze pro danou sestavu použít

Tip Tip
Seznam použitelných parametrů pro danou sestavu je dohledatelný následujícím postupem:
  1. Otevře se formulář 00314 - Správa parametrů z menu Správce → Nastavení systému
  2. Vyhledá se požadovaná sestava
  3. Klikne na záložku Volán z
  4. V případě, že je možné sestavu volat z více formulářů, vybere se požadovaný formulář, z jakého se nový vzhled sestavy bude tisknout
  5. na konci řádku s číslem a názvem formuláře se stiskne koncové tlačítko se třemi tečkami
  6. Vyvolá se okno s parametry sestav
  7. Zobrazí se seznam veškerých parametrů, kterými lze sestavu pro tento konkrétní formulář nastavit


Pak už jen stačí ke konkrétnímu parametru zadat hodnotu a sestava je nastavena.


Jak jednoduché. Ale jakou hodnotu lze do sloupce Hodnota vkládat? Odpověď naleznete v následující kapitole.


Hodnota parametru

Hodnota parametru může obsahovat:

  • libovolný text - využívá se zejména pro záměnu textu na sestavě a lze ho využít tam, kde je zapotřebí změnit název uvedený pro konkrétní pole zobrazené na sestavě (např. pomocí parametru NAZEV_KDO lze na sestavě objednávky změnit text "Odesílatel" na požadovaný, např. "Odběratel", apod.), lze využív např. pro parametr NAZEV_KDO, NAZEV_DOKUMENTU, apod.
  • R_SQL parametru - do pole Hodnota lze uvést název konkrétního R_SQL parametru přičemž tento název musí odpovídat názvu uvedenému ve formuláři 00316 - Administrace R_SQL parametrů ve sloupci Parametr → označuje pouze název R_SQL parametru, který je blíže specifikován v položce SQL Definice. Nastavení vzhledu sestav tak skýtá nepřeberné množství podob, což dává možnost umístit na tiskovou sestavu téměř cokoli, jakýkoli obrázek, logo, otisk razítka, libovolné podpisové pole, různé QR kódy pro moderní způsob placení, různou podobu kódů používající se pro evidenci majetku, smluv, objednávek, faktur a umožňující tak i snadnější inventarizaci či rychlejší odbyt či vyskladňování zboží či naceňování pro potřeby e-shopů, apod.
Příklad Příklad

Obr. Příklad nastavení pomocí textu - co se bude zobrazovat místo textu označujícího odesílatele → Odběratel a co na místo textu názvu objednávky na sestavě 13020 - Objednávka volané z formuláře 30335 - Objednávky - detail.



Nastavení pomocí R_SQL parametrů

V současné době stále více vzrůstá obliba parametrizovat si sestavy pomocí různých R_SQL parametrů, které umožní umístit na sestavu "téměř" cokoli. Jejich nastavení je rychlé, snadné a zvládne ho i méně zdařilý odborník se znalostí SQL jazyka. R_SQL parametry mohou být nastaveny jak pomocí jednoduchých dotazů, ale i těch složitějších, které již vyžadují hlubší znalosti náročnějších SQL dotazů.

Jednotlivé R_SQL parametry včetně jejich podrobných selectů ve formě SQL dotazů se definují ve formuláři 00316 - Administrace R_SQL parametrů

V současném moderním světě vzrůstá potřeba přizpůsobovat si vzhled tiskových sestav pro stále rychlejší metody plateb např. u faktur kde je platba probíhá ihned po naskenování QR kódů či různých jiných kódů ale i pro rychlejší evidenci v systémech. K tomu lze využít právě R_SQL parametry, které umožňují nepřeberné množství nastavení sestav. R_SQL parametry, které se sestavují pomocí R_SQL dotazů a různých selectů, jimiž lze nastavit konečný vzhled sestavy přímo na míru individuálním potřebám zákazníka.

Poznámka Poznámka
Pokud lze údaj na sestavě zobrazit pomocí R_SQL parametru, jeho přesný název se vyplní do formuláře 00314 - Správa reportů na záložku Volán z pomocí tlačítka se třemi tečkami .


Pozor Pozor
Přesný název R_SQL parametru a jeho celý obsah se definuje ve formuláři 00316 - Administrace R_SQL parametrů.


Proměnné použitelné v SQL dotazu

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ými písmeny


Schéma reportu


V následující tabulce je přehled parametrů a jejich umístění na reportu (sestavě).

Příklad Příklad


Seznam všech parametrů, kterými lze vzhled sestavy měnit

DOTAZ_SCTECKA

  • Definuje se pomocí XML
  • Nastaví se ve formuláři 00314 - Správa reportů na záložce Volán z pomocí tlačítka se třemi tečkami , kde se k uvedenému parametru sestavy vloží do hodnoty název konkrétního R_SQL parametru
  • Název R_SQL parametru a jeho přesný obsah se definuje ve formuláři 00316 - Administrace R_SQL parametrů
  • Formátování se nastavuje pomocí HTML


DOTAZ_SDETAIL

  • Strukturou se podobá parametru DOTAZ_SDODATEK s tím rozdílem, že DOTAZ_SDETAIL se zobrazuje přímo pod Rekapitulací DPH a SDODATEK na samotném konci sestavy
  • Umožňuje vytvořit tabulku a nadefinovat až 6 různých sloupců, stanoví jejich šířku a formát podle možností zobrazení
  • Definuje se pomocí XML
  • Nastaví se ve formuláři 00314 - Správa reportů na záložce Volán z pomocí tlačítka se třemi tečkami , kde se k uvedenému parametru sestavy vloží do hodnoty název konkrétního R_SQL parametru
  • Název R_SQL parametru a jeho přesný obsah se definuje ve formuláři 00316 - Administrace R_SQL parametrů
  • Formátování se nastavuje pomocí HTML


DOTAZ_SDODATEK

  • Strukturou se podobá parametru DOTAZ_SDETAIL s tím rozdílem, že DOTAZ_SDETAIL se zobrazuje přímo pod Rekapitulací DPH a SDODATEK na samotném konci sestavy
  • Umožňuje vytvořit tabulku a nadefinovat až 6 různých sloupců, stanoví jejich šířku a formát podle možností zobrazení
  • Definuje se pomocí XML
  • Nastaví se ve formuláři 00314 - Správa reportů na záložce Volán z pomocí tlačítka se třemi tečkami , kde se k uvedenému parametru sestavy vloží do hodnoty název konkrétního R_SQL parametru
  • Název R_SQL parametru a jeho přesný obsah se definuje ve formuláři 00316 - Administrace R_SQL parametrů
  • Formátování se nastavuje pomocí HTML


Obr. Schéma zobrazení jednotlivých sloupců v parametru DOTAZ_SDODATEK


DOTAZ_SDOLOZKA

  • Definuje se pomocí XML
  • Nastaví se ve formuláři 00314 - Správa reportů na záložce Volán z pomocí tlačítka se třemi tečkami , kde se k uvedenému parametru sestavy vloží do hodnoty název konkrétního R_SQL parametru
  • Název R_SQL parametru a jeho přesný obsah se definuje ve formuláři 00316 - Administrace R_SQL parametrů
  • Formátování se nastavuje pomocí HTML
  • Umožňuje vytvořit tabulku, která bude obsahovat minimálně 4 sloupce se 4 nadpisy
  • Může obsahovat 2 podsloupce a 4 řádky s textem
  • Lze opakovat a tím přibydou další a další podsloupce s řádky


DOTAZ_INTERNI_UDAJ

  • Umisťuje blok různého formátu (pole) mezi údaj o dodavateli a výpisem důležitých informačních položek v pravé části sestavy
  • Představuje libovolné pole, které lze různě formátovat podle potřeb pomocí HTML
  • Nastaví se ve formuláři 00314 - Správa reportů na záložce Volán z pomocí tlačítka se třemi tečkami , kde se k uvedenému parametru sestavy vloží do hodnoty název konkrétního R_SQL parametru
  • Název R_SQL parametru a jeho přesný obsah se definuje ve formuláři 00316 - Administrace R_SQL parametrů
  • Je na uživateli, jakým způsobem naplní


DOTAZ_KOD

Pozor Pozor
Do budoucna se už používat nebude a od jeho používání se již v současné době upouští.


Tip Tip
Místo parametru DOTAZ_KOD se v současné době využívá parametr DOTAZ_SCTECKA, který lze lépe parametrizovat a přizpůsobit požadavkům zákazníků.


  • Umístil na sestavu skenovací 2D QR kód ve stejné úrovní jako je nadpis sestavy a zároveň ho odsadí od levého okraje
  • Ve svislém zobrazení pod ním je umístěn obsah kódu
  • Zákazníci ho již moc nevyužívají a místo něj raději již nyní volí nastavení parametru DOTAZ_SCTECKA, který ho dokáže plnohodnotně a lépe nahradit
  • Nastavoval se ve formuláři 00314 - Správa reportů na záložce Volán z pomocí tlačítka se třemi tečkami , kde se k uvedenému parametru sestavy vložil do hodnoty název konkrétního R_SQL parametru
  • Název R_SQL parametru a jeho přesný obsah se definoval ve formuláři 00316 - Administrace R_SQL parametrů


Obr. 2D QR kód tvořený parametrem DOTAZ_KOD


DOTAZ_KONEC

  • Umisťuje se pod podpisové pole
  • Může být zobrazeno jako libovolný řetězec či text
  • Formátování se nastavuje prostřednictvím HTML
  • Nastaví se ve formuláři 00314 - Správa reportů na záložce Volán z pomocí tlačítka se třemi tečkami , kde se k uvedenému parametru sestavy vloží do hodnoty název konkrétního R_SQL parametru
  • Název R_SQL parametru a jeho přesný obsah se definuje ve formuláři 00316 - Administrace R_SQL parametrů
  • Pokud je to nastavitelné, lze přizpůsobit požadavkům zákazníků


  • Definuje název obrázku loga
  • Umístí obrázek loga kamkoli na sestavu dle potřeb zákazníka
  • Lze libovolně zvětšovat či zmenšovat
  • Nastaví se ve formuláři 00314 - Správa reportů na záložce Volán z pomocí tlačítka se třemi tečkami , kde se k uvedenému parametru sestavy vloží do hodnoty název konkrétního R_SQL parametru
  • Název R_SQL parametru a jeho přesný obsah se definuje ve formuláři 00316 - Administrace R_SQL parametrů


DOTAZ_OBJ_INFO

  • Nastaví se ve formuláři 00314 - Správa reportů na záložce Volán z pomocí tlačítka se třemi tečkami , kde se k uvedenému parametru sestavy vloží do hodnoty název konkrétního R_SQL parametru
  • Název R_SQL parametru a jeho přesný obsah se definuje ve formuláři 00316 - Administrace R_SQL parametrů


DOTAZ_PODPIS

  • Umístí na konec sestavy podpisové pole v libovolném zobrazení
  • Formátování se nastavuje prostřednictvím HTML
  • Umožňuje na sestavu umístit libovolný počet podpisů, který je potřeba tam mít spolu s dalšími údaji
  • Lze nastavit zákazníkovi přímo na míru a přizpůsobit jeho potřebám
  • Pokud je to nastavitelné, lze podpisové pole s údaji přizpůsobit požadavkům zákazníků
  • Nastaví se ve formuláři 00314 - Správa reportů na záložce Volán z pomocí tlačítka se třemi tečkami , kde se k uvedenému parametru sestavy vloží do hodnoty název konkrétního R_SQL parametru
  • Název R_SQL parametru a jeho přesný obsah se definuje ve formuláři 00316 - Administrace R_SQL parametrů


DOTAZ_QR

  • Umístí kamkoli na sestavu QR kód
  • Může jich být i více
  • Bývá umístěn zejména na fakturách
  • Umožňuje moderní způsob placení
  • Definuje se pomocí XML
  • Nastaví se ve formuláři 00314 - Správa reportů na záložce Volán z pomocí tlačítka se třemi tečkami , kde se k uvedenému parametru sestavy vloží do hodnoty název konkrétního R_SQL parametru
  • Název R_SQL parametru a jeho přesný obsah se definuje ve formuláři 00316 - Administrace R_SQL parametrů
  • Formátování se nastavuje pomocí HTML


Obr. Příklad zobrazení QR kódů pomocí parametru DOTAZ_QR


DOTAZ_VZOR

  • Tento parametr obsahuje název R_SQL parametru, kterým lze určit a nastavit definici libovolného obrázku pro zobrazení např. kulatého razítka s podpisovými údaji
  • Nastaví se ve formuláři 00314 - Správa reportů na záložce Volán z pomocí tlačítka se třemi tečkami , kde se k uvedenému parametru sestavy vloží do hodnoty název konkrétního R_SQL parametru
  • Název R_SQL parametru a jeho přesný obsah se definuje ve formuláři 00316 - Administrace R_SQL parametrů
  • Parametr se stále používá a lze ho využít především pro zobrazení otisku kulatého razítka nebo lze pomocí něj zobrazit na sestavě různá loga např. poskytovatelů dotace, fondů, apod.
  • Dá se zobrazit pouze na konci sestavy s umístěním pod podpisem


NAZEV_DOKUMENTU

  • Definuje se pomocí textu, který může být formátu HTML
  • Definuje se pomocí něho text, který nahrazuje název dokumentu


NAZEV_KDO

  • Definuje se pomocí textu, který může být formátu HTML
  • Definuje se pomocí něho text, který nahrazuje označení odesílatele


NAZEV_OBRAZKU

  • Definuje se pomocí textu, který může být formátu HTML
  • Definuje se pomocí něho název obrázku v Jasper


RADKY

  • Může obsahovat hodnoty + / -
  • V případě, že je argument nastaven na hodnotu "+", budou na tiskové sestavě objednávky zobrazeny všechny řádky objednávky bez ohledu na hodnotu příznaku v řádkovém sloupci „Typ“ (N = netisknout řádek, AA = tisknout s cenou, AN = tisknout bez ceny).


VELKY_OBRAZEK

  • Může obsahovat hodnoty + / -
  • Pokud je zadaná hodnota "+" u argumentu VELKY_OBRAZEK, nezobrazuje se poté kontace ani schvalovací doložka


ZOB_KONTACE

  • Nastaví se ve formuláři 00314 - Správa reportů na záložce Volán z pomocí tlačítka se třemi tečkami , kde se k uvedenému parametru sestavy vloží do hodnoty název konkrétního R_SQL parametru
  • Název R_SQL parametru a jeho přesný obsah se definuje ve formuláři 00316 - Administrace R_SQL parametrů


ZOB_PRAZDNOU_SESTAVU

Pomocí argumentu lze nastavit, aby se vytiskla sestava, i když je prázdná a neobsahuje žádná data. Argument:

  • může obsahovat hodnoty +/-
  • nastavuje ve formuláři 00314 - Správa reportů na záložce Volán z
  • umožňuje zobrazit prázdnou sestavu místo dialogu informujícím, že žádná data nejsou k dispozici
  • lze využít zejména u saldo sestav tištěných z formuláře 03474 - Tisk účetního salda, kde je potřeba vytisknout sestavu například za určité období, i když v tomto období nejsou žádná data, sestava se tak tiskne, ale je prázdná a neobsahuje žádná data
  • lze tak vytisknout potvrzení o tom, že k určitému datu u nás určitá firma nemá žádné závazky/pohledávky
Poznámka Poznámka
Více informací k argumentu ZOB_PRAZDNOU_SESTAVU naleznete zde.




Odkazy:

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