4D Write Pro – Průvodce vytvářením tabulek s daty

V několika posledních verzích programu 4D Write Pro bylo přidáno mnoho funkcí souvisejících s tabulkami. Tabulky můžete snadno vytvářet na základě databázových dat pomocí kontextů, zdrojů dat a vzorců.

Je to tak snadné, že mnozí z nich chtějí nechat své koncové uživatele používat tuto funkci tak, jak je. Chápeme však, že to někdy může být náročné pro uživatele, kteří nejsou dostatečně vyškoleni ve formátování zdrojů dat nebo vzorců pro různé součásti tabulek. Abychom to vyřešili, vyvinuli jsme řešení dodávané se systémem 4D v20 R2: zcela nového průvodce tabulkami.

Průvodce je k dispozici koncovým uživatelům; ti mohou využít šablony přizpůsobené jejich použití a oboru poskytované vývojářem. Konfigurace šablon zahrnuje:

• definovat datové třídy a atributy datových tříd,
• přeložit datové třídy, atributy datových tříd a názvy vzorců,
• připravit vzorce přizpůsobené pro danou činnost,
• navrhnout grafické styly.

Pokračujte ve čtení, abyste se dozvěděli více, a nezapomeňte se podívat na HDI a bonusové video, které vás provede různými možnostmi.

HDI: Průvodce tabulkou

Rozhraní průvodce tabulkou WP

Uživatel může k průvodci přistupovat prostřednictvím nabídky „Vložit tabulku“ na panelu nástrojů nebo na postranním panelu.

Rozhraní je poměrně jednoduché a úžasné. Uživatel vybere šablonu nebo datovou třídu a téma. Poté zaškrtne pole, která se mají zobrazit jako sloupce. Sloupce může také seřadit. Dále může definovat počet řádků záhlaví, souhrnných řádků umístěných nad nebo pod daty a řádků navíc. Dále zvolí vzorce, které se mají zobrazit v souhrnných nebo extra řádcích. Nakonec klikne na tlačítko „Vložit“ a přidá tabulku do dokumentu WP.

Po začlenění tabulky do dokumentu může uživatel upravit nebo přizpůsobit její styl. Formátovací nástroje panelu nástrojů a postranního panelu jsou stále k dispozici.

Zde je video, které demonstruje tyto možnosti:

Můžete si stáhnout HDI a zopakovat si videoukázku.

Jak provést konfiguraci

Průvodce se skládá ze 3 typů konfiguračních souborů.

Soubory šablon

Soubor šablony umožňuje definovat následující položky:

• vzorec, který vrací výběr entit použitý jako zdroj dat tabulky,
• atributy datové třídy, které lze použít jako sloupce tabulky,
• vzorec pro souhrnné řádky,
• vzorce, které lze použít v kontextové nabídce souhrnného řádku,
• vzorce, které lze použít v kontextové nabídce přenosového řádku,
• a vzorce, které lze použít v kontextové nabídce dalšího řádku.

Soubory šablon musí být uloženy ve složce „Resources/4DWP_Wizard/Templates“ v rámci projektu.

Zde je stručný příklad, jak může váš soubor vypadat:

{
   "tableDataSource": "ds.People.all().orderBy(\"toCompany.name asc, continent asc, country asc, city asc\")",
   "columns": [{
            "check": true,
            "header": "Jméno",
            "source": "This.item.firstname"
        }, {
            "check": true,
            "header": "Příjmení",
            "source": "This.item.lastname"
        }, {
            "check": true,
            "header": "Plat",
            "source": "String(This.item.salary;\"###,###.00\")"
        }
    ],
   "breaks": [{
            "label": "Společnost",
            "source": "This.item.toCompany.name"
        }
    ],
   "breakFormulas": [{
            "label": "Společnost",
            "source": "This.item.toCompany.name"
	}, {
            "label": "Součet platů",
            "source": "String(This.breakItems.sum(\"salary\"); \"###,###.00\")"
        }
    ],
   "bcorFormulas": [{
            "label": "Součet platů",
            "source": "String(This.tableData.sum(\"platy\"); \"###,###.00\")"
        }
    ],
   "extraFormulas": [{
            "label": "Součet platů",
            "source": "String(This.tableData.sum(\"platy\"); \"###,###.00\")"
        }
    ]
}

Podívejte se na tuto stránku s podrobnou dokumentací, kde se dozvíte více o formátu JSON a názvech atributů.

Soubory pro překlad

Překladové soubory slouží k překladu názvů šablon, témat, tabulek, polí a vzorců, je-li to nutné. Musíte je přidat do složky „Resources/4DWP_Wizard/Translations“ svého projektu.

Pokud uživatel vybere datovou třídu v rozhraní. Překladový soubor má druhou funkci. Může filtrovat datové třídy a atributy datových tříd navržené uživateli. Například skrýt ID tabulky.

Poznámka: Toto chování je podobné příkazům SET TABLE TITLES a SET FIELD TITLES pro ty, kteří znají klasický jazyk.

Zde je příklad překladového souboru:

{
   "tables": [{
            "originál": "Lidé",
            "překlad": "Personne"
        }
    ],
   "fields": [{
            "original": "příjmení",
            "překlad": "Nom"
        }, {
            "originál": "jméno",
            "překlad": "Prénom"
        }, {
            "originál": "plat",
            "překlad": "Salaire"
        }, {
            "originál": "společnost",
            "překlad": "Société"
        }
    ],
   "formula": [{
            "original": "Součet platů",
            "překlad": "Somme des salaires"
        }
    ]
}

V dokumentaci jsou uvedeny a vysvětleny všechny možné atributy.

Soubory motivu

V komponentě rozhraní 4D Write Pro je ve výchozím nastavení k dispozici seznam motivů. Můžete si však vytvořit vlastní motivy jejich umístěním do složky „Resources/4DWP_Wizard/Themes“ v rámci projektu.

Soubory motivů umožňují definovat následující atributy WP pro záhlaví, data, přenesení, souhrn a další řádky:

• textAlign
• backgroundColor
• borderColor
• borderStyle
• borderWidth
• font
• barva
• fontFamily
• fontSize
• padding

A zde je také příklad souboru motivu:

{
   "výchozí": {
           "backgroundColor": "#F0F0F0",
           "borderColor": "#101010",
           "borderStyle": 1,
           "borderWidth": "0,5pt",
           "font": "Times New Roman",
           "color": "#101010",
           "fontFamily": "Times New Roman",
           "fontSize": "7pt",
           "padding": "2pt"
    },
   "table": {
           "backgroundColor": "#E1EAF3"
    },
   "header1": {
           "textAlign": 2,
           "borderColor": "#41548F",
           "borderWidth": "1,5pt",
           "backgroundColor": "#979BA9",
           "color": "#F4F4FF",
           "font": "Times New Roman Bold"
    },
   "data": {
           "fontSize": "13pt",
           "textAlign": 0
    },
   "break1": {
           "textAlign": 2,
           "fontSize": "15pt"
    }
}

Stejně jako u ostatních souborů je gramatika JSON k dispozici v dokumentaci.

Další…

Průvodce tabulkou WP je součástí komponenty 4D Write Pro Interface. Zdrojové kódy jsou k dispozici na Githubu, pokud chcete provést úpravy.
Neváhejte se podělit o své dojmy nebo zpětnou vazbu na fóru.