Přeskočit na hlavní obsah

Systémové/Interní typy

Systémové/Interní typy - Pro vývojáře (17 typů)​

::: warning POUZE PRO VÝVOJÁŘE A SYSTÉMOVÉ ADMINISTRÁTORY Následující typy jsou interní součást EspoCRM frameworku s označením "notCreatable": true.

** Nelze je přidat ručně** přes Entity Manager - jsou používány automaticky systémem nebo pouze pro specifické entity.

** Běžní uživatelé** tyto typy nepotřebují a neměli by se jimi zabývat. ** Vývojáři** mohou tyto typy využívat při tvoření vlastních rozšíření. :::

** Seznam interních typů EspoCRM frameworku:**

Systémové automatické typy (pro framework)​

LinkOne (automaticky generovaný při vztazích 1-ku-1)​

  • Účel: Automaticky generovaný reverse vazba k Link polím
  • Použití: Zobrazení zpětné vazby v 1-ku-N vztazích jako 1-ku-1
  • Systémové: Vytváří se automaticky při definici Link pole
  • UI: Pouze ke čtení, zobrazuje zpětnou vazbu

LinkParent (interní typ pro polymorfní vazby)​

  • Účel: Vazba na různé typy entit současně (polymorfní)
  • Použití: Email může patřit Account nebo Contact současně
  • Systémové: Používá se automaticky pro polymorfní vztahy
  • UI: Dropdown typu entity + výběr záznamu

CurrencyConverted (automaticky při převodech měn)​

  • Účel: Automatické zobrazení přepočítaných měnových hodnot
  • Použití: Zobrazení částek v jiné měně než je zadaná
  • Systémové: Vytváří se automaticky k Currency polím
  • UI: Šedé pole s převedenou hodnotou a kurzem

PersonName (interní složené pole firstName + lastName)​

  • Účel: Kombinované zobrazení celého jména osoby
  • Použití: Automaticky kombinuje salutation + firstName + lastName
  • Systémové: Používá se v Contact a Lead entitách
  • UI: Automaticky generované ze složek jména

Interní pomocné typy (pro pokročilé použití)​

ArrayInt (interní typ pro pole čísel)​

  • Účel: Ukládání seznamu celých čísel v JSON formátu
  • Použití: Interní konfigurace, seznamy ID
  • Systémové: Většinou skryté nebo pouze pro administrátory
  • UI: JSON array editor (často skryté)

{} JSONArray (interní typ pro JSON pole)​

  • Účel: Strukturovaná data ve formátu JSON array
  • Použití: Konfigurace, metadata, složité struktury
  • Systémové: Pro pokročilé nastavení systému
  • UI: JSON tree viewer (pouze admin)

{} JSONObject (interní typ pro JSON objekty)​

  • Účel: Key-value páry v JSON formátu
  • Použití: Systémová nastavení, flexibilní konfigurace
  • Systémové: Interní konfigurační data
  • UI: Key-value editor (pouze admin)

Interní výběrové typy (pro specialisty)​

EnumInt (interní typ s číselnými hodnotami)​

  • Účel: Výběr s číselným kódem místo textového
  • Použití: Priority, stupnice s číselnými hodnotami
  • Systémové: Speciální případy kde je potřeba číselná hodnota
  • UI: Dropdown s texty, ukládá čísla

EnumFloat (interní typ s desetinnými hodnotami)​

  • Účel: Výběr s desetinným číslem
  • Použití: Hodnocení, váhy s přesnými hodnotami
  • Systémové: Pro speciální kalkulace
  • UI: Dropdown s texty, ukládá float hodnoty

Rozsahové typy pro filtrování (interní API)​

↔ RangeInt (rozsahy celých čísel)​

  • Účel: Filtrování podle číselných rozsahů (od-do)
  • Použití: Věkové filtry, počty, intervaly
  • Systémové: Pouze pro pokročilé filtrování
  • UI: Dva integer fieldy [Od] [Do]

↔ RangeFloat (rozsahy desetinných čísel)​

  • Účel: Filtrování podle rozsahů s desetinnými místy
  • Použití: Cenové rozsahy, měření
  • Systémové: Pokročilé search filtry
  • UI: Dva float fieldy pro rozsah

↔ RangeCurrency (rozsahy měnových hodnot)​

  • Účel: Filtrování podle cenových pásem
  • Použití: Rozpočtové filtry, cenové kategorie
  • Systémové: Reporty a analytics
  • UI: Dva currency fieldy s automatickými přepočty

⏱ Časové pomocné typy (framework interní)​

⏰ DateTimeOptional (volitelná data)​

  • Účel: DateTime pole které může být prázdné bez chyb
  • Použití: Nepovinné termíny, volitelné deadliny
  • Systémové: Specializované použití
  • UI: Stejné jako DateTime, ale prázdné je OK

⏱ Duration (doba trvání)​

  • Účel: Čas v hodinách a minutách
  • Použití: Doba schůzek, čas strávený na úkolu
  • Systémové: Speciální formátování času
  • UI: Hodiny:minuty formát

Specializované typy (pouze systémové)​

ColorPicker (interní typ pro výběr barvy)​

  • Účel: Výběr barev s color pickerem
  • Použití: Barevné kategorie, UI témata
  • Systémové: Pokročilé UI prvky
  • UI: Color picker + hex hodnota

Password (speciální bezpečnostní pole)​

  • Účel: Zabezpečené ukládání hesel
  • Použití: Pouze pro User entitu, API tokeny
  • Systémové: Vysoké bezpečnostní požadavky
  • UI: Maskované znaky s validací síly

Base (abstraktní základní typ pro dědičnost)​

  • Účel: Základ pro všechny ostatní typy polí
  • Použití: Framework - není viditelný pro uživatele
  • Systémové: Pouze pro vývoj a dědičnost
  • UI: Nikde viditelný

Kdy potřebujete systémové typy?​

Většinou je nepotřebujete ručně vytvářet! Systém je vytváří automaticky kdy:

  • Vytváříte Currency pole → automaticky se přidá CurrencyConverted
  • Vytváříte Link pole → automaticky se přidá LinkOne na druhou stranu
  • Používáte Contact/Lead → PersonName se vytváří automaticky
  • Potřebujete polymorfní vazby → LinkParent se vytváří systémově

Pro vývojáře a systémové administrátory​

** Kontakt s podporou:**

  • Potřebujete podobnou funkcionalitu? Kontaktujte podporu - často existuje alternativní řešení pomocí standardních typů!
  • Vyvíjíte rozšíření? Tyto typy můžete využívat při programování vlastních modulů
  • Systémová integrace? Některé typy se používají při pokročilé konfiguraci API

** Upozornění:** Manipulace se systémovými typy může ovlivnit stabilitu EspoCRM. Postupujte pouze pokud rozumíte důsledkům!