Přehled návrháře

Návrhář je vizuální editor formuláře. Tato stránka popisuje jeho části a základní práci s ním.

Rozvržení obrazovky

Návrhář se otevírá v okně Konfigurace formuláře tlačítkem Nastavení formuláře ve vrchní liště formuláře (viz Rychlý start). Okno má tři pásy.

Záhlaví okna

• Název formuláře a seznamu.
• Aktivace na seznamech: zapne nebo vypne vlastní formulář na libovolném seznamu webu (postup viz Aktivace formuláře na seznamu).
• Licence: zadání licenčního klíče (viz Zadání klíče v návrháři).
• Tlačítko zavření okna.

Horní lišta návrháře

Vlevo jsou karty, vpravo nástroje.

Nástroje vpravo, zleva doprava:

• Zpět a Znovu, viz Zpět a znovu.
• Odznak N upozornění (jen když nějaká jsou), viz Varování konfigurace.
• Tlačítko stylu zobrazení (například Dialog · 960 px): vzhled a chování celého formuláře, viz Nastavení formuláře.
• Tlačítko Zabezpečení (po nastavení hesla Zámek editoru aktivní), viz Zabezpečení konfigurace.
• Nabídka Další možnosti (tři tečky): import, export a obnovení ze zálohy.
• Malý popisek s verzí běžícího balíčku (například v1.14.0.0); při hlášení chyby uveďte tuto verzi.
• Přepínač jazyka návrháře, viz Přepínač jazyka návrháře.

Spodní lišta

Stavový text (Neuložené změny · lze uložit, Konfigurace je uložena a validní nebo Nelze uložit · N validačních chyb) a tlačítka Zavřít a Uložit formulář (Ctrl+S). Při zavření s neuloženými změnami se zobrazí dotaz Zpět do editoru, Zahodit změny nebo Uložit a zavřít. Samotné Uložit formulář návrháře nezavře: zobrazí se hláška Konfigurace byla uložena (po chvíli zmizí) a formulář za oknem se překreslí novou konfigurací. Při chybě se zobrazí chybová hláška a okno zůstane otevřené.

Paleta polí a widgetů

Paleta je panel vlevo na kartě Rozvržení.

• Karta Pole obsahuje sloupce seznamu. Políčka Jen neumístěná a Systémová filtrují nabídku, okno Hledat pole… hledá podle názvu.
• Karta Widgety obsahuje prvky, které nejsou sloupci seznamu: banner, obrázek, související položky a dokumenty, procesní tlačítko, ukazatel procesu, mezeru, text a nadpis, KPI a historii verzí. Widget do formuláře přidáte tlačítkem „+“ nebo ho přetáhnete z palety do sekce na plátně, stejně jako pole. Jejich popis najdete v Přehledu widgetů.
• Kaskádový lookup je bez licence Pro v paletě zamčený (štítek Pro, nejde přidat). Už přidané kaskády zůstávají a jdou upravovat, viz Licencování.
• Prvek přidáte přetažením do sekce, nebo kliknutím na + u prvku. Klik přidá prvek na konec aktivní sekce (paleta ji uvádí v patičce).
• Pole může být ve formuláři jen jednou. Pole, které už je umístěné, je v paletě označené (například v záložce nebo jiná záložka).

Vytvoření sloupce

Nový sloupec seznamu můžete založit přímo z palety, bez návštěvy nastavení seznamu v SharePointu. Tlačítko Vytvořit sloupec je nad vyhledáváním na kartě Pole. Nabízí se jen uživateli s oprávněním Správa seznamů (vlastník nebo správce seznamu); ostatní tlačítko nevidí a nic se jim nevytváří.

• Zobrazovaný název je titulek sloupce. Podle něj se živě navrhne interní název (například „Hlavička“ dá hlavicka, „Datum schválení“ dá datumschvaleni; podtržítko se zachová, ostatní znaky mimo písmena a číslice se odstraní). Interní název můžete přepsat; jakmile ho upravíte, další psaní zobrazovaného názvu ho už nemění. Po vytvoření ho nelze ve SharePointu změnit.
• Pravidla interního názvu: jen písmena bez diakritiky, číslice a podtržítko, nesmí začínat číslicí, nejvýše 32 znaků. Nesmí kolidovat s existujícím sloupcem seznamu (bez ohledu na velikost písmen) ani s vyhrazeným názvem SharePointu (například ID, Title, Author, Created, ContentType). Chyba se zobrazí u pole a tlačítko zůstane zakázané.
• Typ sloupce: jeden řádek textu, více řádků, číslo, měna, datum a čas, volba, Ano/Ne, osoba a vyhledávání. Více osob se vytvoří u typu Osoba zaškrtnutím Povolit výběr více osob. Podle typu se zobrazí volby (po jedné na řádek), desetinná místa, „jen datum“, povolení skupin nebo cílový seznam a sloupec vyhledávání. U měny vyberete Formát měny (lokalita měny, např. CZK 1029, EUR 1031/1051, USD 1033, GBP 2057, PLN 1045); výchozí je lokalita webu, pokud ji formulář zná, jinak podle jazyka návrháře. Bez ní SharePoint sloupci žádnou měnu nenastaví.
• Volba: každá hodnota na samostatném řádku. Zobrazit jako určí vzhled ve SharePointu i ve formuláři: Rozevírací seznam, Přepínače (jedna hodnota) nebo Zaškrtávací políčka (více hodnot), což založí sloupec s více hodnotami (MultiChoice). Zaškrtávací pole Povolit vlastní hodnotu umožní zadat hodnotu, která není mezi volbami (SharePoint FillInChoice).
• Typy obsahu: pokud seznam spravuje typy obsahu, dialog nabídne jejich výběr (složky se nenabízejí). Předvybraný je typ aktuálního formuláře. Když seznam typy obsahu nespravuje, sekce se nezobrazí a sloupec dostane výchozí typ obsahu seznamu. Dokud se typy obsahu nenačtou, je tlačítko Vytvořit zakázané; když se je nepodaří načíst, dialog ukáže chybu a nic nevytvoří (sloupec se tak nikdy nepřidá do jiného typu obsahu, než jste zvolili). Sloupec se do výchozího zobrazení seznamu nepřidává.
• Po tlačítku Vytvořit a přidat do formuláře se sloupec založí a pole se vloží na konec aktivní sekce a vybere (jeden krok Zpět). Použije se skutečný interní název, který vrátil SharePoint.
• Pokud se sloupec nepodařilo přidat do některého typu obsahu, sloupec existuje a pole je ve formuláři. Dialog vypíše typy, kam se nepřidal, a nabídne Opakovat; selže-li i opakování, chyba se v dialogu zobrazí. Pokud sloupec vznikl, ale nepodařilo se nastavit zobrazovaný název (zůstal interní název), dialog zůstane otevřený a varování ukáže.
• Skončí-li vytvoření chybou, sloupec mohl přesto vzniknout. Dialog proto zkoušený interní název zablokuje (aby opakování nevytvořilo duplicitní sloupec nazev0); zkontrolujte sloupce seznamu.
• Cílový sloupec vyhledávání nabízí jen typy, na které SharePoint umí odkazovat (text, číslo, měna, datum a čas, počítaný sloupec, ID); víceřádkový text, osoby, vyhledávání a vícenásobný výběr se nenabízejí.
• Výchozí hodnota sloupce se v dialogu nenastavuje. Po vytvoření pole jí nastavíte v inspektoru pole (část Výchozí chování).

Inspektor pole

Klikněte na pole, widget, sekci nebo záložku a vpravo se zobrazí jejich vlastnosti. Pro pole a widgety má inspektor tyto části (přesný výčet závisí na typu):

• Obecné: Vlastní popisek (přepíše název jen ve formuláři, ne v SharePointu), Popis a nápověda (text pod polem) a Zástupný text.
• Vzhled: Šířka v sekci ve 12dílné mřížce (viz Sloupce a šířka polí).
• Výchozí chování: přepínače Viditelné, Povinné a Jen pro čtení (jen tam, kde to typ dovoluje).
• Nastavení typu: validace formátu u textu, odkazu a víceřádkového textu, Zobrazit jako u volby (rozevírací seznam, přepínače nebo zaškrtávací políčka podle toho, zda sloupec má jednu či více hodnot; informace, zda sloupec povoluje vlastní hodnotu, a pořadí voleb), kaskáda u lookupu, přepínač na opakující se tabulku u víceřádkového textu, u widgetů jejich vlastní volby.
• Pravidla: seznam pravidel, která se na prvek odkazují, s odkazem do editoru pravidel.
• Patička: Přesunout do jiné sekce a Odebrat z rozvržení.

Význam voleb u jednotlivých typů popisuje Typy polí.

Zpět a znovu (Undo/Redo)

• Tlačítka Zpět a Znovu v horní liště, nebo klávesy Ctrl+Z a Ctrl+Y (též Ctrl+Shift+Z). Zkratky nefungují, když píšete do textového pole.
• Na kartě Rozvržení smaže klávesa Delete označené pole, widget nebo sekci (viz Smazání klávesou Delete).
• Historie pamatuje 50 kroků.
• Slučování úprav: opakované úpravy téže hodnoty do 600 ms se spojí do jednoho kroku, takže psaní popisku se nevrací po písmenech. Strukturální změny (přidání, smazání a přesun polí, sekcí a záložek) jsou vždy samostatný krok.
• Stav „neuložené změny“ se porovnává s naposledy uloženou konfigurací. Vrátíte-li se zpět do uloženého stavu, návrhář už neuložené změny nehlásí.
• Smazání záložky, sekce, pole nebo pravidla se dá vrátit tlačítkem Zpět, dokud návrháře nezavřete.

Varování konfigurace

Žlutý odznak N upozornění v liště otevře seznam problémů, které neblokují uložení, ale stojí za opravu:

• chyba v nastavení kaskádového lookupu (neexistující nadřazené pole, cyklická závislost),
• překročené limity verze Community (více než 2 záložky nebo více než 3 pravidla),
• prázdná sekce,
• mezera s výškou mimo rozsah 1–400 px.

Od varování se liší validační chyby: červené hlášení Konfigurace obsahuje validační chyby a stavový text Nelze uložit. Dokud je neopravíte, tlačítko Uložit formulář je neaktivní a nejde ani exportovat. Typické příčiny: pole se v rozložení opakuje, pravidlo odkazuje na neexistující pole nebo funkci, akce blockSave je v pravidle s jiným spouštěčem než Při uložení.

Pravidla odkazující na odstraněná pole se nemažou: označí se jako nevalidní, runtime je přeskakuje a zůstanou zachována k opravě. Před smazáním záložky, sekce, pole nebo pravidla návrhář zobrazí dialog dopadu se seznamem dotčených pravidel a skriptů.

Náhled a rozdělený náhled

• Karta Náhled vykreslí skutečný formulář (pravidla, výrazy a widgety fungují). Přepínačem Nový / Editace / Zobrazení vyberete režim, přepínačem Dialog / Panel / 100 % šířku (panel je 640 px) a vedle jazyk simulace.
• Na kartě Rozvržení zapněte Živý náhled: plátno se zmenší a vedle něj se průběžně zobrazuje náhled vybraného režimu.
• Náhled nenačítá žádnou položku seznamu: pole jsou prázdná nebo mají výchozí hodnoty. Nezobrazuje tlačítka Uložit a Zrušit a nic neukládá. Pravidla, výrazy a podmínky ale reagují na to, co v náhledu vyplníte.

Import, export a obnovení

Všechny tři příkazy jsou v nabídce Další možnosti (tři tečky) v horní liště.

• Exportovat konfiguraci (.json) zkopíruje konfiguraci do schránky a stáhne soubor form-config-<seznam>-<rrrrmmdd>.json. Konfigurace s validačními chybami se exportovat nedá.
• Importovat konfiguraci (.json) načte soubor, ověří ho proti schématu a nahradí jím rozpracovanou konfiguraci. Pokud odkazuje na pole, která na seznamu neexistují, zobrazí se okno Upozornění při importu konfigurace. Volbou Pokračovat a vyčistit neexistující pole se pole odstraní z rozvržení i z pravidel, Zrušit import import zahodí. Import se projeví až po uložení formuláře.
• Obnovit ze zálohy nahradí rozpracovanou konfiguraci poslední automatickou zálohou, kterou SharePoint drží při každém uložení (předchozí uložená verze). Neuložené změny se přepíšou, příkaz proto vyžaduje potvrzení. Příkaz je neaktivní, pokud záloha neexistuje.
• U vlastního rozložení režimu je v nabídce navíc položka NOVÝ/EDITACE/ZOBRAZENÍ → Společné, která vlastní rozložení zahodí (viz Rozložení podle režimu).

Přepínač jazyka návrháře

Zcela vpravo v horní liště jsou kódy jazyků (například CS, EN). Přepínač nabízí výchozí jazyk formuláře a povolené jazyky. Mění dvě věci:

• jazyk samotného návrháře a popisků na plátně,
• cíl úprav textů: v jiném než výchozím jazyce se úpravy názvu záložky, nadpisu a popisu sekce, popisku, zástupného textu, nápovědy a chybové hlášky pole zapisují do překladů (i18nConfig.translations) a výchozí texty zůstanou beze změny. Nad plátnem se zobrazí pruh s upozorněním a odkazem Přepnout na výchozí.

Podrobnosti viz Úpravy v návrháři v jiném jazyce.

Konflikt souběžné úpravy konfigurace

Každé uložení konfigurace dostane novou revizi. Pokud mezitím formulář uložil jiný správce, návrhář uložení nepřijme a zobrazí dialog Zjištěn konflikt verzí konfigurace s jménem a časem poslední změny. Volby:

• Uložit moji verzi do historie (doporučeno): vaše verze se uloží do historie záloh, živá konfigurace zůstane beze změny a návrhář zůstane otevřený.
• Načíst novou verzi (zahodit změny): nahradí vaše úpravy aktuální konfigurací.
• Přepsat jejich verzi (vynutit): uloží vaši verzi přes cizí změny.
• Zpět: zavře dialog a ponechá úpravy.

Licence v návrháři

V záhlaví návrháře se zobrazuje zákazník z licenčního klíče. Po vypršení práva na aktualizace (upd) pracuje návrhář v režimu Community s výzvou k obnovení údržby, hotové formuláře fungují dál bez vodoznaku. Podrobnosti, revokace a zadání klíče: Licencování. Skripty povoluje tenantová politika skriptů.

Surový JSON

Karta JSON zobrazí celou konfiguraci jako text, který můžete přímo upravit. Tlačítko Formátovat JSON text zarovná, Použít JSON změny uplatní (jen když je konfigurace platná) a Vrátit změny je zahodí. Chyby syntaxe i schématu se zobrazí v seznamu Chyby v JSON.

Návrhář také porovnává datové typy polí se sloupci seznamu. Pole bez fieldType (například měna vložená ručně) se při použití JSON, při importu i u návrhu od AI automaticky doplní podle typu sloupce a návrhář oznámí, kolik typů doplnil. Typ, který se sloupcem nejde dohromady (například Ano/Ne u číselného sloupce), se vypíše jako upozornění pod editorem i v upozorněních v horní liště; jde jen o varování, JSON se použít dá. Chybějící typ se také v paměti doplní při načtení formuláře, takže funkce vázané na číselná pole (součet opakující se tabulky, KPI) fungují i se starší konfigurací.

Struktura konfigurace je popsána v části pro vývojáře: Schéma konfigurace.