Přehled

Každá organizace začíná s vestavěným datovým modelem: produkty, objednávky, kontakty a zbytek. Vlastní entity vám umožňují přidat do něj vlastní tabulky a vlastní pole přidávají vlastní sloupce do jakékoli tabulky, vestavěné nebo vlastní. Vlastní entita se chová jako vestavěná: má mřížku, editor, filtry, historii, sady změn a API a asistent AI ji dokáže číst.

Oba jsou spravovány administrátory organizace v Nastavení → Přizpůsobení:

[navigate:/customEntities|Vlastní entity|database] [navigate:/customFields|Vlastní pole|columns]

Změny se projeví v databázi ihned po uložení definice. Neexistuje žádný krok nasazení.

Vlastní entity

Vlastní entita je nová tabulka. Vytvořte ji pomocí:

• Název – zobrazen v menu a titulcích, přeložitelný. Množné číslo názvu se používá pro mřížku, jednotné číslo názvu pro editor.
• Klíč – technický název používaný ve filtrech, API a importech. Je odvozen od názvu během psaní a vždy začíná x_ (například x_cars). Klíč nelze změnit, jakmile entita existuje.
• Ikona a kategorie – kde se entita zobrazuje v levém menu. Entity bez kategorie jsou uvedeny pod Přizpůsobení.
• Primární pole – pole zobrazená ve výchozím nastavení v mřížce a použitá jako název záznamu.
• Výchozí pořadí – sloupce, podle kterých je mřížka seřazena, dokud uživatel nezvolí jiné pořadí; kliknutím na šipku u sloupce přepínáte mezi vzestupným a sestupným řazením.
• Popis – krátká poznámka pro uživatele a pro asistenta AI.

Editor entity uvádí její pole. Přidejte tam pole a entita se vám vyplní; primární pole a voliče výchozího pořadí nabízejí pole, jakmile je entita uložena.

Každá vlastní entita automaticky získá ID, časová razítka vytvoření a aktualizace, historii změn a podporu pro sady změn a zámky. Tyto nemusíte definovat.

Po uložení se entita objeví v levém menu. Otevřete ji pro přidání záznamů jako v jakékékoli jiné mřížce, nebo je importujte pomocí importního enginu s použitím klíče entity.

Vlastní pole

Vlastní pole je nový sloupec v tabulce. Nejprve vyberte entitu (vestavěnou, jako jsou Produkty, nebo jednu z vašich vlastních entit), poté:

• Název – popisek sloupce, přeložitelný.
• Klíč – odvozený od názvu, vždy s předponou x_ (například x_colour). Po vytvoření pole je pevný.
• Typ – text, dlouhý text, HTML, číslo, peníze, celé číslo, ano/ne, datum, datum a čas, výčet, relace, URL, e-mail, telefon, barva, obrázek nebo JSON.
• Přeložitelné – textová pole mohou obsahovat hodnotu pro každý jazyk, podobně jako vestavěný název produktu.

Editor zobrazuje pouze možnosti, které dávají smysl pro vybraný typ:

Pole lze v editoru seskupit pomocí Skupiny, seřadit pomocí Pořadí a indexovat pomocí Vytvořit index, pokud na ně často filtrujete.

Relace mezi vlastními entitami

Pole relace ukládá odkaz na jeden záznam jiné entity (například Auto patří ke Značce). Druhá strana automaticky získá seznam propojených záznamů (značka zobrazuje svá auta). Označte pole jako vlastněné, pokud záznamy patří svému rodiči a měly by být zobrazeny inline v jeho editoru, podobně jako řádky objednávky.

Relace mnoho k mnoha (jedno Auto může mít mnoho Funkcí a jedna Funkce se vztahuje na mnoho Aut) je modelována malou vlastní entitou uprostřed, která obsahuje dvě pole relace, jedno označené jako zdroj a druhé jako cíl relace.

Povolení skrytého vestavěného pole

Vestavěný model obsahuje více polí, než zobrazuje vaše edice. Například pole, která existují pouze v připojeném účetním systému, jsou skryta pro běžnou e-shopovou organizaci. Pokud takové pole potřebujete, nemusíte vytvářet vlastní: vytvořte vlastní pole s Typem = Nativní a zadejte klíč vestavěného pole. Sloupec je vytvořen ve vaší databázi a pole se objeví v mřížkách, editorech a filtrech se svým standardním názvem, překlady a chováním.

Upřednostněte nativní pole před vlastním, kdykoli existuje vestavěné pole pro stejný účel. Udržuje to vaše data kompatibilní s integracemi a s jinými organizacemi.

Odstranění a vymazání

Definice se nikdy neodstraňují přímo, protože by se ztratila data ve sloupci nebo tabulce. Místo toho:

1. Nastavte status entity nebo pole na To delete. Zmizí z nabídek, mřížek a editorů, ale data zůstanou v databázi.
2. Změňte status zpět na Active, pokud to byla chyba. Nic se neztratilo.
3. Administrátor může později definici purge, čímž sloupec nebo tabulku trvale odstraní.

Doplňky

Doplňky z tržiště mohou dodávat vlastní entity a pole. Jsou nainstalovány do vaší organizace, když doplněk aktivujete, a označeny jako To delete, když jej deaktivujete. Takové definice jsou spravovány doplňkem a nelze je upravovat.

Limity a osvědčené postupy

• Až přibližně 100 vlastních entit na organizaci a 200 polí na entitu.
• Klíče jsou trvalé. Vybírejte je pečlivě; názvy a popisky lze kdykoli změnit.
• Používejte vestavěné entity a nativní pole tam, kde se hodí. Vlastní entity jsou pro data, pro která platforma nemá místo.
• Vlastní data jsou zahrnuta v exportech, filtrech, řídicích panelech a API jako jakákoli jiná data. V Query API je oslovujte pomocí jejich klíče, například x_cars { x_name, x_brand { name } }.

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