Definice business objektů - záložka Detail
Záložka zobrazí detailní informace o aktuální definici business objektu ze záložky Seznam. Formulář je rozdělen do tří skupin - Struktura business objektu, Technické údaje a Vizuální nastavení business objektu.
Některé záložky mohou být skryté v rámci nastavení vlastností uzlu aktivního menu.
V horní části záložky Detail může být variantně zobrazen některý z Panelů definovatelných údajů detailu pro tuto agendu. Zobrazení panelu definovatelných údajů detailu závisí na aktuálním nastavení v menu Nastavení pro danou agendu a přihlášeného uživatele.
Položky, které nejsou pro zvolený Typ business objektu použitelné, zůstávají na formuláři viditelné, ale jsou neaktivní. Zašedlé jsou také jejich vysvětlující popisky. Dostupnost jednotlivých položek a možnost jejich změny po uložení jsou uvedeny níže.
Skupina Struktura business objektu
| Název | Popis |
|---|---|
| Typ |
Určuje druh definovaného business objektu. Po uložení záznamu již položku nelze změnit. Na výběr jsou:
Podrobný popis jednotlivých typů a příklad z praxe najdete v kapitole Vytvoření definovatelného business objektu. |
| Doklad s doručovací a korespondenční adresou | Zatržítko dostupné pouze při založení definice s Typem Doklad. Pokud je zatrženo, doklad eviduje doručovací a korespondenční adresu včetně firmy a provozovny. Po uložení definice již volbu nelze změnit. |
| Evidence vytvoření a opravy | Zatržítko dostupné pouze pro nový (dosud neuložený) záznam s Typem Prázdný objekt nebo Číselníkový objekt; po prvním uložení už jej nelze změnit. Pokud je zatrženo, business objekt eviduje, kdo a kdy jej vytvořil a naposledy opravil - přibudou mu sloupce/klíče Vytvořeno, Opraveno, Vytvořil a Opravil, dostupné mimo jiné i pro třídění a omezení záznamů. |
| Třída hlavičky |
Položka je dostupná pouze pro Typ Řádek. Lze ji nastavit pouze při založení definice. Určuje business objekt, jehož je definovaný řádek kolekcí - může jít o kteroukoli registrovanou třídu v systému, tedy stejně tak o jinou vlastní definici z této agendy (Doklad i Číselníkový objekt), jako o libovolnou systémovou (výrobcem dodanou) hlavičkovou třídu (např. existující agendu Objednávky přijaté). Postup připojení definovatelné kolekce k již existující (systémové i definovatelné) agendě, včetně kolekce vnořené do jiné kolekce, popisuje kapitola Jak připojit definovatelnou kolekci k existující agendě. |
| Kolekce řádků |
Volba pro Typ Řádek, jehož Třídou hlavičky je definovatelný business objekt typu Doklad. Určuje hlavní kolekci řádků dokladu, zobrazovanou na záložce Detail → Obsah a dostupnou v API pod cestou rows. Jedna hlavička může mít pouze jednu hlavní kolekci; při výběru jiné systém po potvrzení odebere příznak původní kolekci. Pro další samostatnou záložku s řádky ponechte volbu nezatrženou a nastavte Pozici záložky. Postup popisuje Vytvoření řádkového objektu. |
Skupina Technické údaje
| Název | Popis |
|---|---|
| Interní název třídy |
Jedinečný technický název business objektu používaný ve skriptování a dalších definicích. Zadávejte jej anglicky, bez mezer a diakritiky, například ServiceRecord. Systém automaticky doplní prefix DefBO_; úplný název registrované třídy tedy bude DefBO_ServiceRecord. Do editovatelné části pole prefix nezadávejte. Prefix odděluje definovatelné třídy od systémových tříd. Název musí být jedinečný mezi definovatelnými business objekty. Zadání stejného prefixu znovu systém při uložení odmítne. Rozdíl mezi hodnotou uloženou v definici a úplným názvem vysvětluje kapitola Technické názvy a prefixy. Z platného interního názvu se při zadávání předvyplňuje Název tabulky a API endpoint přidáním koncovky s. Předvyplní se pouze dosud prázdné hodnoty. Neplatný neprázdný název se zvýrazní varovnou barvou a odvozené hodnoty se z něj nepředvyplní. Nejde o jazykový převod množného čísla; navržené hodnoty zkontrolujte. Při změně interního názvu upravte také skripty a další místa, která na třídu odkazují jejím názvem. |
| Zobrazovaný název | Název business objektu zobrazovaný uživatelům ve výběrech a dalších částech systému. U vedlejší řádkové kolekce slouží také jako název její samostatné záložky. Zadávejte jej srozumitelně v jazyce uživatelů, například Servisní záznam. Název samostatné agendy se zadává zvlášť v Definicích agend. |
| Název tabulky |
Technický název databázové tabulky s daty objektu. Po zadání Interního názvu třídy se předvyplní přidáním koncovky s, například ServiceRecords. Před prvním uložením jej můžete upravit, po uložení již změna není možná. Systém automaticky doplní prefix ET$, proto jej nezadávejte. Výsledná tabulka v příkladu se jmenuje ET$ServiceRecords. Celý název včetně prefixu může mít nejvýše 31 znaků. |
| API endpoint |
Jedinečný název, pod kterým bude objekt dostupný přes REST API. Předvyplňuje se z Interního názvu třídy malými písmeny a s koncovkou s. Systém automaticky doplní prefix defbo_. Zadáte-li servicerecords, k datům přistupujete přes /<spojení>/defbo_servicerecords. Prefix do definice nezadávejte. U typu Řádek může endpoint zůstat prázdný. Změna endpointu existujícího objektu mění adresu pro přístup k jeho datům a vyžaduje úpravu navázaných integrací. Příklad založení definice i použití výsledného endpointu najdete v návodu Definovatelný business objekt kompletně přes REST API. |
| CLSID | Jedinečný identifikátor (GUID) třídy, který systém předvyplní při založení definice. Doporučujeme ponechat automaticky přidělenou hodnotu. Po uložení již identifikátor nelze změnit. Používá se ve vazbách, skriptování, API a instalačních sadách, například v Definici agend nebo jako Třída hlavičky jiného objektu. |
| Identifikace propojení s přílohami |
Jedinečné číslo vazby mezi business objektem a jeho přílohami. Systém při založení definice předvyplní volné číslo; doporučujeme je ponechat. Hodnotu 0 při uložení nahradí volným číslem automaticky. U objektu typu Řádek se přílohy touto vazbou nezpřístupňují. Čísla od 2008000 jsou vyhrazena servisním pracovníkům pro evidovaná opakovaně nasazovaná řešení. Hodnota musí být jedinečná v rámci jednoho spojení (databáze); pokud ji používá jiný business objekt v tomto spojení, systém uložení odmítne a uvede jeho název. Použití popisuje návod Přílohy definovatelného business objektu přes API a skriptování. |
Skupina Vizuální nastavení business objektu
| Název | Popis |
|---|---|
| Pozice záložky | Určuje pořadí samostatné záložky řádkové kolekce v agendě hlavičkového objektu. Dostupná je pro Typ Řádek s vybranou Třídou hlavičky, pokud není zatržena volba Kolekce řádků. Hodnota 0 samostatnou záložku nezobrazí, kladné hodnoty určují pořadí vzestupně. Pro změnu pořadí více kolekcí použijte funkci Seřadit kolekce. Viz Jak připojit definovatelnou kolekci k existující agendě. |
Funkční tlačítko
| Název | Popis |
|---|---|
| Otevřít def. položky | Otevře agendu Definovatelné položky omezenou na položky tohoto business objektu - zde se doplňují jeho vlastní datová pole. Dostupné až po prvním uložení záznamu (business objekt musí mít přidělené CLSID). |
Zobrazení seznamu v Detailu
V některé části této záložky může být zobrazen seznam (Panel pro zobrazení seznamu na jiných záložkách), tedy záznamy ze záložky Seznam (podrobněji viz Společné prvky v číselnících - záložka Detail).
Zobrazení seznamu závisí na aktuálním nastavení v menu Nastavení pro danou agendu a přihlášeného uživatele.
Funkce k záložce Detail:
Podmnožina funkcí ze záložky Seznam.