Historie verzí

Historie verzí položky přímo ve formuláři.

Popis widgetu versionHistory

Widget zobrazí přímo ve formuláři časovou osu verzí položky (kdo, kdy a které sloupce změnil, ze které hodnoty na jakou) a komentáře k položce. Uživatel tak nemusí otevírat historii verzí v SharePointu. Můžete omezit, které sloupce se v historii sledují, a povolit přidávání komentářů. Je to virtuální widget, neukládá se do položky. Data čte ze SharePointu.

Přidání do formuláře

Na kartě Widgety vyberte Historie verzí a komentáře (podtitul „Widget · časová osa změn položky“) a přetáhněte ho do sekce, nebo klikněte na „+“. Nový widget je přes celou šířku, ukazuje verze i komentáře a načítá 15 verzí.

Nastavení v inspektoru

Stejné volby najdete i ve velkém konfiguračním okně (tlačítko Otevřít podrobné nastavení v okně nebo ikona Konfigurovat na kartě widgetu). Okno má záložky Zobrazení a Sledované sloupce, náhled historie ve skutečném seznamu (na vyžádání tlačítkem Zobrazit náhled, po úpravách Obnovit náhled) a změny zapíše až tlačítkem Uložit (jeden krok Zpět).

Když vypnete jednu ze záložek, zobrazí se jen druhá a přepínač záložek zmizí. Vypnete-li obě, widget zůstane prázdný.

Sledované sloupce

Bez omezení se v historii ukazují změny všech sloupců, včetně technických. Volba Vybrané atributy to zúží na pole, která vás zajímají (například Stav a Schvalovatel):

• Nabídka obsahuje sloupce seznamu a pole formuláře (bez widgetů). Můžete hledat, zvolit Vybrat vše nebo Zrušit výběr. Počet vybraných se zobrazuje.
• V historii se u každé verze ukáží jen změny vybraných polí. Verze, ve kterých se žádné z nich nezměnilo, se skryjí, pokud je zapnuto Skrýt verze bez změn sledovaných polí.
• V záhlaví widgetu je u vybraných atributů vidět jejich počet. Když nezbude žádná verze, widget napíše „Žádné zaznamenané změny ve sledovaných polích (…)“.
• Pole typu vyhledávání nebo osoba, která SharePoint ukládá pod názvem s příponou Id, se rozpoznají i podle názvu bez ní.

Chování za běhu

• Datum a čas verzí i komentářů se formátuje podle jazyka formuláře (například 10. 11. 2026 14:05 v češtině, 11/10/2026, 2:05 PM v angličtině).
• Nový: položka ještě nemá historii, widget ukáže „Historie verzí a komentáře budou dostupné po uložení záznamu“.
• Úprava a Zobrazení: widget načte verze položky (až maxItems, od nejnovější) a komentáře. Každá verze ukazuje číslo (například v2.0), autora, čas a změněné sloupce ve tvaru název: stará hodnota → nová hodnota. První verze ukáže vyplněné hodnoty.
• Název sloupce v historii je popisek pole z formuláře. Nemá-li pole ve formuláři vlastní popisek, použije se název sloupce ze seznamu SharePointu, a teprve když ho nejde přečíst, interní název (například Status_x0020_Code).
• Logické hodnoty (Ano/Ne) se zobrazují v jazyce formuláře (cs Ano/Ne, en Yes/No, de Ja/Nein, sk Áno/Nie).
• Komentáře: v záložce Komentáře je pole „Přidat komentář“ (potvrzení klávesou Enter nebo tlačítkem) a pod ním komentáře od nejnovějšího s autorem a časem. Komentář se uloží do SharePointu okamžitě, nečeká na uložení formuláře. Používá standardní komentáře položky SharePointu.
• Komentáře v režimu Zobrazení: komentář jde přidat i v režimu Zobrazení, bez přepnutí do úprav. Je to záměr a odpovídá to nativnímu SharePointu: komentář se zapisuje do komentářů položky, ne do jejích sloupců, takže se položka nemění a nevzniká nová verze. Kdo komentáře přidávat nemá, vypněte volbu Povolit přidávání nového komentáře (allowAddComment); komentáře se pak jen zobrazují.
• Widget formulář nikdy neoznačí za změněný. Chyby načtení se zobrazí jako prázdný seznam.
• V náhledu v návrháři může widget zobrazit ukázková data, aby bylo vidět rozložení.

Překlady textů

Přeložit lze titulek widgetu (customLabel). Pevné texty (záložky, nápovědy, tlačítko) se přepínají podle jazyka formuláře samy. Viz Překlady a vícejazyčnost.

Pravidla a skripty

• setVisible: zobrazí nebo skryje widget, například historii jen pro schvalovatele (podmínka na skupinu uživatele).
• Akce setReadOnly na widget nepůsobí a v inspektoru se pro něj nenabízí. Přidávání komentářů vypnete volbou Povolit přidávání nového komentáře.

Příklad konfigurace (JSON)

{
  "internalName": "widget_history",
  "customLabel": "Historie schvalování",
  "fieldType": "versionHistory",
  "colSpan": 12,
  "defaultVisible": true,
  "versionHistoryConfig": {
    "showVersions": true,
    "showComments": true,
    "allowAddComment": true,
    "maxItems": 20,
    "trackedFields": ["Stav", "Schvalovatel", "CelkovyRozpocet"],
    "hideUnchangedVersions": true
  }
}

Omezení a tipy

• Historii vidí každý, kdo má přístup k položce. Hodnoty sledovaných sloupců jsou čitelné pro všechny, nezapisujte do nich citlivá data, pokud je nemá vidět každý čtenář.
• Verze se čtou ze SharePointu, takže uvidíte jen ty, které SharePoint uchoval. Limit počtu verzí v nastavení seznamu proto omezuje, jak daleko do minulosti dohlédnete.
• Výběr sledovaných polí se aplikuje až na načtených maxItems verzí (nejvýše 100). U dlouho žijících položek a malého výběru polí proto zvyšte maxItems, jinak může zbýt málo verzí.
• Komentář nelze v tomto widgetu upravit ani smazat.
• Kdo smí komentář přidat, určují oprávnění SharePointu ke komentářům položky, ne režim formuláře. Viz Komentáře v režimu Zobrazení.