Typy polí

Přehled všech typů polí, které formulář podporuje, s nastavením a chováním každého z nich.

Společná nastavení polí

Pole vzniká přetažením sloupce seznamu z palety do sekce. Návrhář podle typu sloupce SharePointu sám zvolí typ pole (fieldType) a jeho základní nastavení. Společné volby najdete v inspektoru (klikněte na pole), viz Inspektor pole.

Za běhu mohou viditelnost, povinnost a režim jen pro čtení měnit také pravidla. Hodnotu může nastavit pravidlo, výraz nebo skript.

Chování v režimech Nový, Úprava a Zobrazení

• Nový: pole je prázdné nebo má defaultValue. Povinná pole se při uložení kontrolují. Uloží se jen to, co vyplníte.
• Úprava: pole zobrazí hodnotu položky. Ukládají se jen změněná pole (a pole s hodnotou vynucenou pravidlem), takže se nepřepíše to, co mezitím změnil někdo jiný ve sloupci, který jste nezměnili.
• Zobrazení: všechna pole jsou jen ke čtení. Formulář v tomto režimu nikdy neoznačí neuložené změny a nehlásí je při zavření. Z režimu Zobrazení lze tlačítkem Upravit přepnout do Úpravy.
• Pole označené Jen pro čtení v konfiguraci se do SharePointu neukládá, dokud je neodemkne pravidlo.

Validace

Při uložení se pole kontrolují v tomto pořadí a první chyba se zobrazí pod polem:

1. Maximální délka (fieldProps.maxLength): u textových sloupců SharePointu s omezenou délkou. Pole zároveň nedovolí napsat víc znaků.
2. Formát (validationPattern, validationMessage): regulární výraz pro text, odkaz a víceřádkový text. Kontroluje se jen vyplněná hodnota. Chybná syntaxe výrazu validaci nezablokuje. Chybová hláška zůstane viditelná, dokud je hodnota neplatná (i po opuštění pole, i u nepovinného pole), zmizí po opravě a neplatná hodnota se neuloží.
3. Povinnost: pole je povinné, když je viditelné, povinné a není jen pro čtení. Prázdný text, nevybraná osoba, lookup nebo termín, nulové hodnocení a výběr bez příloh jsou chyba.

V inspektoru textu, odkazu a víceřádkového textu je část Validace formátu (Regex) s rychlými předvolbami E-mail, Telefon (CZ), PSČ, IČO (8 číslic) a URL (https). Předvolba doplní výraz i chybovou hlášku, kterou můžete přepsat. Texty hlášek se překládají, viz Překlady.

Povinnost se označuje hvězdičkou, štítkem Povinné nebo vůbec, podle nastavení requiredIndicator. Pokud jsou chyby, formulář přepne na první záložku s chybou, rozbalí sbalenou sekci a posune se k poli. Dále mohou ukládání zablokovat pravidla s akcí blockSave.

Zobrazení položky

V režimu Zobrazení se standardní pole nevykreslují jako zašedlé vstupy, ale jako čitelná „karta“: malý šedý popisek a pod ním (nebo vedle něj při popisku vlevo) plně kontrastní hodnota. Povinná pole v Zobrazení nemají hvězdičku ani odznak Povinné, protože nic nevyplňujete. Hodnota zůstává ve formuláři beze změny a formulář nehlásí neuložené změny. Text se zalamuje a vychází z jazyka formuláře (čísla a data se formátují podle něj). Čísla se zobrazí bez zaokrouhlení. Víceřádkový text s formátováním (HTML) se zobrazí jako čistý text bez značek.

• Text, číslo, vypočítaný sloupec, hodnocení, umístění: prostý text; číslo s oddělovači tisíců (měna, pokud ji pole nastavuje).
• Víceřádkový text: prostý text se zachovanými zalomeními řádků.
• Datum a čas: datum bez času, pokud pole nemá zapnutý čas.
• Volba (i vícenásobná) a spravovaná metadata: každá hodnota jako štítek.
• Ano/Ne: zelená ikona zaškrtnutí a text „Ano“, jinak šedá ikona křížku v kroužku a text „Ne“. Pomlčka se zobrazí jen u opravdu chybějící hodnoty.
• Uživatel a osoby: osoba s e-mailem (u více osob jedna vedle druhé).
• Vyhledávání: text hodnoty (u vícenásobného čárkou oddělený).
• Hypertextový odkaz: klikací odkaz; nebezpečná adresa (například javascript:) se zobrazí jen jako text.
• Prázdná hodnota a nenačtené pole: šedá pomlčka (čtečka ohlásí „Nevyplněno“).

Zamčená pole v Úpravách a Novém

Pole zamčené pravidlem (setReadOnly) a pole, která se nepodařilo načíst, mají v Úpravách a Novém plně čitelný text. Jednořádkový a víceřádkový text a číslo jsou vstupy jen pro čtení s běžnou barvou textu. Výběr, datum, Ano/Ne, osoba, vyhledávání, taxonomie, hodnocení, umístění a vypočítané pole ukážou formátovanou hodnotu v zamčeném rámečku. Hodnotu lze označit a zkopírovat, rámeček je dosažitelný klávesnicí (Tab) a čtečka obrazovky pole ohlásí jako jen pro čtení. U zamčeného pole se nevalidují maximální délka a vzor, takže nepřesná hodnota ze SharePointu uložení neblokuje. Pole zůstává ve formuláři, jeho hodnota se uloží beze změny a samo zamčení formulář neoznačí za změněný.

Přílohy, opakovaná tabulka, obrázek SharePointu a widgety (KPI, stepper, související položky a další) mají v Zobrazení vlastní vzhled a tato změna se jich netýká.

Typy polí

Widgety (prvky, které nejsou sloupci seznamu) mají vlastní stránky, viz Přehled widgetů. Opakující se tabulku popisuje její stránka.

Jeden řádek textu text

Sloupec SharePointu Jeden řádek textu (Text). Je to také záložní typ pro sloupce, které formulář nezná, viz Nepodporované typy.

• Nastavení: společné volby a Validace formátu (Regex). Maximální délku bere formulář ze sloupce (nejvýše 255 znaků u sloupce SharePointu).
• Nový a Úprava: jednořádkový vstup se zástupným textem. Zobrazení: zamčený vstup s hodnotou.
• Omezení: hláška o překročení délky je pevně česky.

{
  "internalName": "Telefon",
  "customLabel": "Telefon",
  "fieldType": "text",
  "colSpan": 6,
  "defaultRequired": true,
  "placeholder": "+420 123 456 789",
  "validationPattern": "^(\\+420)? ?[1-9][0-9]{2} ?[0-9]{3} ?[0-9]{3}$",
  "validationMessage": "Zadejte telefonní číslo ve formátu +420 123 456 789."
}

Číslo number

Sloupce Číslo a Měna (Number, Currency).

• Číselný vstup. Prázdné pole se uloží jako prázdná hodnota (null), neplatné číslo také.
• Minimum, maximum, počet desetinných míst ani měnu formulář nenastavuje a nevynucuje, řídí je jen sloupec v SharePointu při uložení. Vlastní omezení vytvořte pravidlem blockSave.
• Číselné pole lze použít ve výrazech, jako zdroj KPI nebo v sloupci opakující se tabulky.

{
  "internalName": "Cena",
  "customLabel": "Cena bez DPH",
  "fieldType": "number",
  "colSpan": 4,
  "defaultRequired": true
}

Volba (Choice) choice

Sloupec Volba s jednou hodnotou (Choice) nebo Více voleb (MultiChoice). Ve výchozím stavu se zobrazí jako rozbalovací seznam; u MultiChoice lze vybrat více hodnot. Zobrazení a vlastní hodnotu přebírá formulář ze SharePointu (viz níže).

• Nabízené hodnoty jsou v options. Návrhář je převezme ze sloupce při přidání pole do rozvržení. V inspektoru je blok Pořadí voleb: hodnoty nelze přidávat ani přepisovat (pocházejí ze sloupce SharePointu), tlačítky nahoru a dolů se mění jen pořadí zobrazení.
• Hodnota se uloží jako text. Vymazaná volba se uloží jako prázdná.
• Zobrazit jako (fieldProps.choiceFormat): dropdown (rozevírací seznam), radio (přepínače, jen jedna hodnota) nebo checkboxes (zaškrtávací políčka, více hodnot; hodnota zůstává pole textů). Při přidání sloupce do formuláře se formát převezme ze SharePointu (sloupec Volba podle Zobrazit volby pomocí, MultiChoice jako zaškrtávací políčka). V inspektoru pole ho lze změnit: jedna hodnota nabízí rozevírací seznam a přepínače, více hodnot rozevírací seznam a zaškrtávací políčka. Bez nastavení se vykreslí rozevírací seznam (u více hodnot s více výběry), takže starší formuláře vypadají stejně. Neplatná kombinace (přepínače u sloupce s více hodnotami) se vykreslí jako zaškrtávací políčka a při načtení formuláře se opraví.
• Vlastní hodnota (fieldProps.fillIn): pokud sloupec ve SharePointu povoluje vlastní hodnotu (Povolit vyplňování, FillInChoice), nabídne se jako poslední položka Vlastní hodnota: s textovým polem. U jedné hodnoty se uloží napsaný text, u více hodnot se napsaný text přidá do pole. Uložená hodnota, která není mezi volbami, se zobrazí jako vlastní hodnota (u více hodnot jako další zaškrtnutá položka) a uloží se beze změny jako obyčejný text. Povolení se nastavuje jen ve sloupci SharePointu; v inspektoru je jen informace a při načtení formuláře se fillIn synchronizuje. Povinné pole vyžaduje neprázdnou hodnotu ve všech třech zobrazeních, v režimu Zobrazení zůstávají štítky.
• Více voleb (MultiChoice): pole má fieldProps.allowMultiple: true, vybrané hodnoty jsou vidět jako text oddělený čárkami (také v režimu zobrazení a u zamčeného pole). Hodnota se uloží jako pole textů, prázdný výběr jako prázdné pole. U povinného pole musí být vybrána alespoň jedna hodnota. Starší konfigurace, kde bylo toto pole nepodporované (jen pro čtení), se při načtení formuláře opraví automaticky.
• Barvy hodnot v režimu zobrazení (choiceColors): v inspektoru pole, blok Barvy hodnot v režimu zobrazení, lze každé volbě přiřadit barvu štítku (klíč presetu blue, green, amber, red, purple, teal, slate nebo vlastní HEX). Mapa { "Hotovo": "green", "Blokováno": "red" } se použije jen v čtecím zobrazení; u vícenásobné volby má každá hodnota vlastní štítek. Hodnota bez barvy má výchozí šedomodrý štítek. Tlačítko Výchozí barvu odebere.
• Synchronizace voleb: při každém načtení formuláře se options sjednotí s aktuálními volbami sloupce. Nová volba ze SharePointu se doplní na konec (v pořadí ze SharePointu), volba, která ve sloupci už není, se z nabídky odebere. Pořadí zachovaných voleb v konfiguraci zůstává. Pokud položka obsahuje hodnotu odebrané volby, zobrazí se dál (v Úpravách i Zobrazení) a při uložení se neztratí; jen ji nelze znovu vybrat po odznačení. Volby jsou čistý text bez vlastních popisků nebo překladů.

{
  "internalName": "Status",
  "customLabel": "Stav",
  "fieldType": "choice",
  "options": ["Nový", "Ke schválení", "Schváleno", "Zamítnuto"],
  "fieldProps": { "choiceFormat": "radio", "fillIn": true },
  "colSpan": 6
}

Ano/Ne boolean

Sloupec Ano/Ne (Boolean). Zobrazí se jako zaškrtávací pole, jehož štítkem je popisek.

• Nový formulář začíná nezaškrtnutý (hodnota „ne“), pokud není nastavena defaultValue.
• Nastavení Povinné nevynutí zaškrtnutí, viz Validace.
• V podmínkách pravidel porovnávejte hodnotu true a false.

{
  "internalName": "Urgentni",
  "customLabel": "Urgentní požadavek",
  "fieldType": "boolean",
  "defaultValue": false
}

Víceřádkový text multiline

Sloupec Více řádků textu (Note).

• Textové pole o 4 řádcích (3 v kompaktní hustotě), které uživatel může svisle zvětšit. Je to prostý text, formátování ani vložené obrázky editor nenabízí.
• Má Validaci formátu (Regex) jako text. Maximální délku formulář vynucuje jen u sloupců Text.
• V inspektoru je navíc přepínač Režim zobrazení pole: Víceřádkový text nebo Tabulka (JSON). Druhá volba změní pole na opakující se tabulku, která data ukládá jako JSON do téhož sloupce.

{
  "internalName": "Poznamka",
  "customLabel": "Poznámka",
  "fieldType": "multiline",
  "description": "Uveďte důvod požadavku.",
  "colSpan": 12
}

Datum a čas date

Sloupec Datum a čas (DateTime) ve formátu jen datum, nebo datum a čas.

• Vstup s výběrem data z kalendáře (po kliknutí do pole). Má-li sloupec formát s časem, nabídne se i čas (fieldProps.includeTime). Formát si formulář při každém načtení srovná se sloupcem.
• Hodnota se ukládá jako časový údaj SharePointu a převádí se na místní čas prohlížeče.
• Ve čtecím zobrazení a ve widgetech Související položky / dokumenty se datum zobrazí podle jazyka formuláře: jen datum, nebo datum a čas (hh:mm) podle formátu sloupce. Hodnota „jen datum“ se nikdy neposune o den vlivem časového pásma.
• defaultValue: "@today" vloží dnešní datum. Hodí se pro pole bez času.

{
  "internalName": "Termin",
  "customLabel": "Termín dodání",
  "fieldType": "date",
  "defaultValue": "@today",
  "fieldProps": { "includeTime": false }
}

Uživatel user

Sloupec Osoba nebo skupina (User, UserMulti). Používá stejný výběr jako people, popis najdete tam.

• Jedna nebo více osob podle sloupce (peopleConfig.allowMultiple).
• defaultValue: "@Me" předvyplní přihlášeného uživatele.

{
  "internalName": "Zadavatel",
  "customLabel": "Zadavatel",
  "fieldType": "user",
  "defaultValue": "@Me",
  "peopleConfig": { "allowMultiple": false }
}

Výběr osob a skupin (People picker) people

Výběr osob a skupin s hledáním v adresáři. Stejnou komponentu používá i user.

• Hledání: uživatel píše jméno, e-mail nebo název skupiny. Výsledky se načtou už od prvního znaku a zobrazí se se jménem, e-mailem nebo funkcí. Skupiny jsou označené štítkem Skupina.
• Více osob: peopleConfig.allowMultiple (u sloupců SharePointu podle sloupce). Vybraná osoba se odebere křížkem u jejího jména.
• Typy: peopleConfig.principalType omezí hledání na User, SharePointGroup a SecurityGroup. V inspektoru pole uživatele zvolíte „Jen uživatelé“ (["User"]) nebo „Uživatelé i skupiny“ (výchozí, bez omezení); jemnější výběr typů skupin nastavíte v JSON.
• Zobrazení: osoby jsou jen ke čtení. Povinné pole vyžaduje alespoň jednu osobu.
• Do SharePointu se zapisuje ID uživatele.

{
  "internalName": "Schvalovatele",
  "customLabel": "Schvalovatelé",
  "fieldType": "people",
  "peopleConfig": {
    "allowMultiple": true,
    "principalType": ["User", "SecurityGroup"]
  }
}

Vyhledávání (Lookup) lookup

Sloupec Vyhledávání (Lookup, LookupMulti), který odkazuje na položky jiného seznamu.

Nastavení

Kaskáda (závislý číselník)

Kaskádové lookupy vyžadují licenci Pro: bez ní je kaskádový lookup v paletě zamčený, v inspektoru lookupu nejde kaskáda zapnout (volba je zakázaná se štítkem Pro) a návrhář u existujících kaskád zobrazí varování. Formulář je za běhu přesto vyhodnotí, správci formuláře uvidí upozornění (Licencování).

V inspektoru lookupu zvolte Kaskáda · Závisí na poli (nadřazené pole může být výběr, lookup, text nebo číslo) a Vazební sloupec v cílovém seznamu. Příklad: pole Město závisí na poli Země a v seznamu měst se filtruje sloupcem Zeme.

• Dokud není nadřazené pole vyplněné, nabídka je prázdná a zobrazí Nejprve vyberte hodnotu v poli „Země“.
• Změní-li uživatel nadřazenou hodnotu, vybraná hodnota závislého pole se vymaže.
• Existující kaskádu lze v Community dál upravit i zrušit.
• Špatně nastavená kaskáda (neexistující nadřazené pole, cyklus) se za běhu ignoruje a pole nabídne všechny možnosti. Správci formuláře se zobrazí upozornění a návrhář ukáže varování v liště, viz Varování konfigurace.

Velké číselníky: hledání nad 500 položek

Má-li cílový seznam více než 500 položek, formulář nenačítá celý seznam. Pole se přepne na hledání při psaní:

• Nabídka je zpočátku prázdná s textem Začněte psát pro vyhledání….
• Hledá se od 2 znaků, po krátké pauze (300 ms). Zobrazí se nejvýše 50 nejlepších shod. Pomalejší starší odpověď nepřepíše novější.
• V textových sloupcích se hledá podle začátku hodnoty, v číselných podle přesné shody. Bez výsledku se zobrazí Nic nenalezeno.
• Vybrané hodnoty zůstávají vždy zobrazené. Kaskáda funguje i v tomto režimu: hledá se jen mezi položkami odpovídajícími nadřazené hodnotě.

{
  "internalName": "Mesto",
  "customLabel": "Město",
  "fieldType": "lookup",
  "lookupConfig": {
    "lookupListId": "00000000-0000-0000-0000-000000000000",
    "lookupField": "Title",
    "dependsOnField": "Zeme",
    "filterByField": "Zeme"
  }
}

Spravovaná metadata (Taxonomy) taxonomy

Sloupec Spravovaná metadata (TaxonomyFieldType, TaxonomyFieldTypeMulti).

• Nastavení: taxonomyConfig.termSetId (sada termínů), volitelně anchorId (kořenový termín, od kterého se strom nabízí) a allowMultiple. Hodnoty se přebírají ze sloupce.
• Výběr: rozbalovací strom termínů z Term Store s filtrem Filtrovat termíny…. U více hodnot jsou vybrané termíny vidět v seznamu a odebírají se křížkem.
• Uložení: termíny se zapisují přes skryté pole poznámky sloupce ve stejném požadavku jako ostatní pole, i při vytvoření nové položky. Uložení je tedy jednorázové: buď se uloží všechno, nebo nic.
• Chyby: když se termíny nepodaří načíst, pole nabídne Zkusit znovu.

{
  "internalName": "Oddeleni",
  "customLabel": "Oddělení",
  "fieldType": "taxonomy",
  "taxonomyConfig": {
    "termSetId": "00000000-0000-0000-0000-000000000000",
    "allowMultiple": false
  }
}

Přílohy attachments

Přílohy položky seznamu. Pole nemá sloupec, je to systémová funkce seznamu.

• Přidání: přetáhněte soubory do oblasti Přetáhněte sem soubory nebo klikněte pro výběr, nebo klikněte na Přidat přílohu. Nové soubory jsou označené K nahrání a nahrají se až při uložení formuláře.
• Odebrání: křížek u existující přílohy ji označí Označeno ke smazání při uložení. Do uložení lze volbou Vrátit zpět odebrání zrušit.
• Kontroly: prázdný soubor (0 B), název s nepovolenými znaky SharePointu a název, který už u položky existuje, formulář odmítne s hláškou.
• Povinné: musí zbýt alespoň jedna příloha (existující, která není označená ke smazání, nebo nová). Hláška je pevně česky.
• Zobrazení: seznam příloh s odkazy na otevření, bez možnosti měnit.
• Při ukládání se přílohy nahrávají po uložení položky. Při souběžné úpravě se používá aktuální verze položky, takže nahrání příloh nevyvolá falešný konflikt.

{
  "internalName": "Attachments",
  "customLabel": "Přílohy",
  "fieldType": "attachments",
  "colSpan": 12
}

Hypertextový odkaz url

Sloupec Hypertextový odkaz (URL) ve formátu odkaz (formát obrázek se mapuje na spImage).

• Dva vstupy vedle sebe: adresa (https://… nebo /sites/…) a zobrazovaný text (Zobrazený text odkazu, nepovinný). Při uložení se prázdný text nahradí adresou.
• Má Validaci formátu (Regex), která se aplikuje na adresu. Předvolba URL (https) vyžaduje adresu začínající http:// nebo https://. Bez validace formulář formát adresy nekontroluje.
• Zobrazení: klikací odkaz, který se otevře v novém okně. Adresy s nebezpečným schématem (například javascript:) se zobrazí jen jako text a odkazem nejsou.

{
  "internalName": "Web",
  "customLabel": "Webová stránka",
  "fieldType": "url",
  "validationPattern": "^https?://.+",
  "validationMessage": "Zadejte adresu začínající http:// nebo https://."
}

Obrázek (SharePoint) spImage

Sloupec typu Obrázek (Thumbnail) a odkaz zobrazený jako obrázek.

• V Novém formuláři a Úpravě je vstup pro adresu obrázku (URL adresa obrázku) a pod ním náhled (nejvýše 180 px na výšku).
• V Zobrazení je jen náhled, bez obrázku text Žádný obrázek. Formulář umí přečíst hodnotu sloupce ve formátu JSON i prostou adresu.
• Do SharePointu se zapisuje adresa. Zápis do sloupce typu Obrázek si ověřte na testovacím seznamu, nebo pole nastavte jen pro čtení.
• Pro obrázek bez vazby na sloupec (například fotografie podle ID) použijte widget Obrázek.

{
  "internalName": "Foto",
  "customLabel": "Fotografie",
  "fieldType": "spImage",
  "defaultReadOnly": true
}

Hodnocení rating

Sloupce hodnocení (Rating, AverageRating, RatingCount).

• Pět hvězdiček, vedle nich text „3 / 5“ nebo Nehodnoceno. Kliknutí na hvězdičku nastaví hodnocení, kliknutí na už vybranou hvězdičku hodnocení zruší.
• Hodnocení 0 se uloží jako prázdná hodnota. Povinné pole vyžaduje hodnotu 1 až 5.
• Sloupce, které SharePoint počítá sám (průměrné hodnocení, počet hodnocení), jsou obvykle ve formuláři jen ke čtení.

{
  "internalName": "Spokojenost",
  "customLabel": "Spokojenost zákazníka",
  "fieldType": "rating"
}

Vypočítaný sloupec calculated

Sloupec Vypočítaný (Calculated). Hodnotu počítá SharePoint.

• Vždy jen ke čtení, šedé pozadí a tučné písmo. Nikdy se neukládá.
• Z hodnoty se odstraní interní předpona SharePointu (například float;#). V Novém formuláři a u pole bez hodnoty se zobrazí pomlčka.
• Hodnota se po změně ostatních polí nepřepočítává, vidíte hodnotu uloženou v položce. Pro živý výpočet ve formuláři použijte pravidlo s akcí setExpression.

{
  "internalName": "CelkemSDph",
  "customLabel": "Celkem s DPH",
  "fieldType": "calculated"
}

Umístění location

Sloupec Umístění (Location).

• Vstup pro název místa, pod ním ulice a město. Země a souřadnice se zobrazí, pokud je položka obsahuje, a při úpravě se zachovají.
• Je-li co zobrazit, vedle adresy je odkaz Zobrazit na mapě, který otevře Mapy Google v novém okně (podle souřadnic, jinak podle adresy).
• Ukládá se jako JSON se jménem, adresou a souřadnicemi. Prázdné umístění se uloží jako prázdná hodnota.
• Povinné pole vyžaduje název, ulici nebo město. V Zobrazení jsou pole ulice a město skryté a vidíte název a odkaz na mapu.

{
  "internalName": "Pobocka",
  "customLabel": "Pobočka",
  "fieldType": "location",
  "placeholder": "Název pobočky"
}

Nepodporované typy a pole jen pro čtení

Sloupce, které formulář nezná (například Guid, Counter, Computed), se do palety dostanou jako pole typu text označené fieldProps.unsupported a zámkem Jen pro čtení. Formulář je zobrazí jako text a nikdy je neuloží, takže nepřepíšou hodnotu v SharePointu.

• Sloupce, které SharePoint označuje jako jen pro čtení (například Vytvořeno, Změnil, ID), se v automaticky vytvořeném výchozím rozvržení nenabízejí. Do rozvržení je můžete přidat ručně z palety (filtr Systémová), zobrazí se jen ke čtení.
• Hodnoty sloupců, které se při načtení položky nepodařilo přečíst, jsou také jen ke čtení a nepovinné, viz Nenačtená pole.
• Potřebujete-li upravovat sloupec s nepodporovaným typem, upravte ho v SharePointu, nebo ho nahraďte podporovaným typem.