Prehľad

Každá organizácia začína s vstavaným dátovým modelom: produkty, objednávky, kontakty a zvyšok. Vlastné entity vám umožňujú pridať do neho vlastné tabuľky a vlastné polia pridávajú vlastné stĺpce do akejkoľvek tabuľky, vstavanej alebo vlastnej. Vlastná entita sa správa ako vstavaná: má mriežku, editor, filtre, históriu, sady zmien a API a asistent AI ju dokáže čítať.

Oba spravujú administrátori organizácie v časti Nastavenia → Prispôsobenie:

[navigate:/customEntities|Vlastné entity|database] [navigate:/customFields|Vlastné polia|columns]

Zmeny sa aplikujú do databázy ihneď po uložení definície. Neexistuje žiadny krok nasadenia.

Vlastné entity

Vlastná entita je nová tabuľka. Vytvorte ju s:

• Názov – zobrazený v ponukách a tituloch, preložiteľný. Množné číslo názvu sa používa pre mriežku, jednotné číslo názvu pre editor.
• Kľúč – technický názov používaný vo filtroch, API a importoch. Odvodzuje sa od názvu počas písania a vždy začína x_ (napríklad x_cars). Kľúč nemožno zmeniť, akonáhle entita existuje.
• Ikona a kategória – kde sa entita zobrazuje v ľavom menu. Entity bez kategórie sú uvedené pod Prispôsobenie.
• Primárne polia – polia zobrazené predvolene v mriežke a používané ako názov záznamu.
• Predvolené poradie – stĺpce, podľa ktorých je mriežka zoradená, kým si používateľ nevyberie poradie; kliknutím na šípku na stĺpci prepínate medzi vzostupným a zostupným poradím.
• Popis – krátka poznámka pre používateľov a pre asistenta AI.

Editor entity uvádza jej polia. Pridajte tam pole a entita sa vám vyplní; primárne polia a výbery predvoleného poradia ponúkajú polia, akonáhle bola entita uložená.

Každá vlastná entita automaticky dostane ID, časové pečiatky vytvorené a aktualizované, históriu zmien a podporu pre sady zmien a zámky. Tieto nemusíte definovať.

Po uložení sa entita zobrazí v ľavom menu. Otvorte ju a pridajte záznamy ako v akejkoľvek inej mriežke, alebo ich importujte prostredníctvom importovacieho mechanizmu pomocou kľúča entity.

Vlastné polia

Vlastné pole je nový stĺpec v tabuľke. Najprv vyberte entitu (vstavanú, ako napríklad Produkty, alebo jednu z vašich vlastných entít), potom:

• Názov – štítok stĺpca, preložiteľný.
• Kľúč – odvodený od názvu, vždy s predponou x_ (napríklad x_colour). Fixný, akonáhle pole existuje.
• Typ – text, dlhý text, HTML, číslo, mena, celé číslo, áno/nie, dátum, dátum a čas, výpočet, vzťah, URL, e-mail, telefón, farba, obrázok alebo JSON.
• Preložiteľné – textové polia môžu obsahovať hodnotu pre každý jazyk, podobne ako vstavaný názov produktu.

Editor zobrazuje iba možnosti, ktoré majú zmysel pre zvolený typ:

Polia môžu byť zoskupené v editore pomocou Skupina, usporiadané pomocou Poradie a indexované pomocou Vytvoriť index, ak na nich často filtrujete.

Vzťahy medzi vlastnými entitami

Pole vzťahu ukladá odkaz na jeden záznam inej entity (napríklad Auto patrí k Značke). Druhá strana automaticky získa zoznam prepojených záznamov (značka zobrazuje svoje autá). Označte pole ako vlastnené, ak záznamy patria k ich rodičovi a mali by sa zobrazovať inline v jeho editore, podobne ako riadky objednávky.

Vzťah typu mnoho-k-mnohým (Auto môže mať mnoho Vlastností a Vlastnosť sa vzťahuje na mnoho Áut) je modelovaný malou vlastnou entitou uprostred, ktorá obsahuje dve polia vzťahu, jedno označené ako zdroj a druhé ako cieľ vzťahu.

Povolenie skrytého vstavaného poľa

Vstavaný model obsahuje viac polí, než zobrazuje vaša edícia. Napríklad polia, ktoré existujú iba v pripojenom účtovnom systéme, sú skryté pre bežnú organizáciu e-shopu. Ak takéto pole potrebujete, nemusíte vytvárať vlastné: vytvorte vlastné pole s Typ = Natívne a zadajte kľúč vstavaného poľa. Stĺpec sa vytvorí vo vašej databáze a pole sa zobrazí v mriežkach, editoroch a filtroch so svojím štandardným názvom, prekladmi a správaním.

Uprednostnite natívne pole pred vlastným, kedykoľvek existuje vstavané pole na rovnaký účel. Udržuje to vaše dáta kompatibilné s integráciami a s inými organizáciami.

Odstránenie a trvalé vymazanie

Definície sa nikdy neodstraňujú priamo, pretože by sa stratili dáta v stĺpci alebo tabuľke. Namiesto toho:

1. Nastavte stav entity alebo poľa na Na odstránenie. Zmizne z ponúk, mriežok a editorov, ale dáta zostanú v databáze.
2. Zmeňte stav späť na Aktívne, ak to bola chyba. Nič sa nestratilo.
3. Administrátor môže neskôr trvalo vymazať definíciu, čím sa stĺpec alebo tabuľka natrvalo odstráni.

Doplnky

Doplnky z trhoviska môžu dodávať vlastné entity a polia. Sú nainštalované do vašej organizácie, keď aktivujete doplnok, a označené Na odstránenie, keď ho deaktivujete. Takéto definície sú spravované doplnkom a nemožno ich upravovať.

Limity a osvedčené postupy

• Približne do 100 vlastných entít na organizáciu a 200 polí na entitu.
• Kľúče sú trvalé. Vyberajte ich opatrne; názvy a štítky je možné kedykoľvek zmeniť.
• Používajte vstavané entity a natívne polia tam, kde sa hodia. Vlastné entity sú určené pre dáta, pre ktoré platforma nemá miesto.
• Vlastné dáta sú zahrnuté v exportoch, filtroch, dashboardoch a API ako akékoľvek iné dáta. V API pre dopyty sa na ne odvolávajte pomocou ich kľúča, napríklad x_cars { x_name, x_brand { name } }.

[navigate:/help/en/api/query|API pre dopyty|code]