> ## Documentation Index
> Fetch the complete documentation index at: https://www.twicecommerce.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Chytrá pole

> Atributy, jejichž hodnotu za vás TWICE Commerce vypočítá: načtenou z dat, která záznam již nese, nebo získanou z vašeho vlastního API prostřednictvím konektoru.

Chytré pole je [atribut](https://www.twicecommerce.com/docs/cs/concepts/admin/attributes.md) s formátem `smart_field`. Jeho hodnotu nikdo nezadává ručně: TWICE Commerce ji načte z dat, která záznam již nese, nebo ji získá z vašeho vlastního API prostřednictvím konektoru.

Sáhněte po něm tam, kde hodnota už někde existuje a její ruční přepisování vede k chybám. Nastavení vázání z fittingové služby, úroveň členství z vašeho CRM, délka podrážky boty přenesená na lyže prodávané s botami.

## Jak to funguje

### Odkud hodnota pochází

Každé chytré pole je jednoho ze dvou druhů a první krok editoru se ptá, kterého.

| Zdroj | Co dělá | Co potřebuje |
| :- | :- | :- |
| **Číst z dat** | Načte jednu hodnotu, která je již na objednávce, u zákazníka nebo na jednotkách prodávaných společně. Žádné odchozí volání. | Jeden zástupný symbol |
| **Volat API** | Odešle vaše data konektoru a uloží hodnotu, která přijde zpět. | Konektor, metodu a cestu koncového bodu, požadavek a cestu k hodnotě v odpovědi |

### Typ výstupu

**Typ výstupu** je formát, ve kterém se hodnota ukládá, filtruje, řadí a seskupuje. Vyberte jeden z formátů **Text**, **Číslo**, **Ano / Ne** nebo **Datum**. Chytré pole se všude chová jako běžný atribut svého typu výstupu, takže číslo se řadí jako číslo a datum se filtruje jako datum.

> [!WARNING]
>
> Typ výstupu nelze změnit, jakmile jakýkoli záznam obsahuje hodnotu tohoto pole, a formát atributu nelze vůbec změnit na **Chytré pole** ani z něj. Obojí místo toho vyžaduje nový atribut. Rozhodněte o typu dříve, než pole připojíte k záznamům.

### Zástupné symboly

Požadavek je text se **zástupnými symboly** ve dvojitých složených závorkách. Každá hodnota má jednu adresu:

| Zástupný symbol | Načítá |
| :- | :- |
| `{{attribute.sole_length}}` | Atribut inventáře samotného záznamu |
| `{{fulfillment.boot_sole_length}}` | Pole plnění samotného záznamu |
| `{{order.reference}}` | Vestavěné pole zdroje dat |
| `{{customer.billingAddress.city}}` | Cestu do vestavěného pole, které obsahuje objekt |
| `{{customer.attribute.level}}` | Atribut zákazníka |
| `{{customer.field.weight}}` | Obyčejnou odpověď z pokladny, sloučenou napříč položkami zákazníka |
| `{{customerItems.fulfillment.din}}` | Ostatní jednotky téhož zákazníka na objednávce |
| `{{customer}}` | Celý zdroj dat, odeslaný jako JSON |

Sestavujte je pomocí **Vložit data**, ne ručním psaním. Výběr nabízí pouze to, na co pole dosáhne, a před uložením pojmenuje zástupný symbol, který nelze vyřešit.

Pole **Číst z dat** používá přesně jeden zástupný symbol, který je celou jeho definicí. Pole **Volat API** může použít tolik zástupných symbolů, kolik požadavek potřebuje.

### Jaká data může šablona číst

To, jaká data smí šablona adresovat, závisí na záznamu, na kterém se hodnota počítá, ne na tom, kde byl atribut definován. Data objednávky jsou k dispozici pouze tehdy, když výpočet běží z objednávky.

| Počítáno na | Může číst |
| :- | :- |
| SKU | SKU |
| Skladová položka | SKU a skladovou položku |
| Skladová položka na objednávce | SKU, skladovou položku, řádkovou položku, inzerát, objednávku, zákazníka a zákazníkovy ostatní jednotky |
| Zákazník | Zákazníka |
| Inzerát | Inzerát |

Pole, jehož požadavek pojmenovává data objednávky, řádkové položky nebo zákazníka, zobrazuje na stránkách SKU a skladové položky svou akci výpočtu jako zakázanou a uvádí, jaká data tam chybí.

### Kdy se hodnota počítá

**Počítat automaticky** je ve výchozím nastavení zapnuto. Když je zapnuto, objednávka získá hodnotu poprvé, jakmile jsou vyplněny všechny vstupy, které používá, a znovu pokaždé, když se některý z těchto vstupů nebo vlastní nastavení pole změní. Vypněte to a hodnota počká, až někdo stiskne **Vypočítat hodnotu**.

Objednávka obnovuje své hodnoty, dokud je její stav **Otevřeno** nebo **Probíhá**. **Dokončená** objednávka si ponechá to, s čím byla předána, a koncept zatím nemá co připravovat.

Každý výpočet uloží, jakou hodnotu měly jeho vstupy. Pozdější čtení je znovu porovná, a tak hodnota, která už neodpovídá objednávce, na to upozorní, místo aby vypadala jako aktuální. Zastaralá hodnota pojmenuje vstup, který se změnil, spolu s jeho starou a novou hodnotou.

Hodnota, kterou někdo zadal ručně, hodnota zděděná ze SKU nebo skladové položky, první získání, které selhalo, a hodnota se vstupem, jenž je stále prázdný, se samy od sebe znovu nenačítají.

### Hodnota na jednotce objednávky

Pole plnění na jednotce může najednou nést hodnoty z několika míst. Objednávka zobrazí první z nich, která má hodnotu:

1. Co personál zadal na objednávce
2. Vypočítaný výsledek
3. Hodnotu načtenou z dat objednávky
4. Hodnotu skladové položky
5. Hodnotu SKU

Přepsání automatické hodnoty ji nezničí. Objednávka označí zápis jako přepis, po najetí myší zobrazí hodnotu pod ním a při vymazání zápisu ji obnoví.

### Když výpočet selže

Neúspěšný výpočet zachová předchozí hodnotu a zaznamená chybu u pole. Stiskněte upozornění a přečtěte si celou zprávu, která uvádí poslední pokus a nejčastější příčiny: chybnou cestu koncového bodu, chybějící nebo vypršelý klíč, nebo externí službu, ke které se nelze dostat.

Smazání konektoru ponechá všechna pole, která jej používají, na místě. Každý další výpočet selže s touto zprávou a uložená hodnota zůstává, dokud pole znovu nedostane konektor.

## Použití

### Vytvoření chytrého pole

Nejprve připojte API v části **Nastavení → Integrace & API**, poté definujte pole v části **Nastavení → Atributy a tagy**.

1. Otevřete zdroj, kterému pole náleží, a přidejte atribut
2. Zvolte jako typ **Chytré pole**
3. Vyberte **Číst z dat** nebo **Volat API**
4. Pro **Volat API** zadejte konektor, metodu a cestu koncového bodu, požadavek a cestu odpovědi
5. Pro **Číst z dat** vyberte jedinou hodnotu, kterou pole čte
6. Nastavte typ výstupu a rozhodněte, zda se počítá automaticky

### Kde může chytré pole existovat

| Atributy na | Chytré pole dostupné |
| :- | :- |
| Skladových položkách a SKU | Ano, počítáno na SKU nebo skladové položce |
| Polích plnění | Ano, počítáno na SKU, skladové položce nebo skladové položce na objednávce |
| Zákaznících | Ano, počítáno na zákazníkovi |
| Inzerátech | Ano, počítáno na inzerátu |
| Objednávkách | Ne |

> [!NOTE]
>
> Chytré pole nemůže být globální atribut. Globální atribut by vyvolal odchozí volání u každého záznamu v účtu, proto jej připojujete jen k záznamům, které jej potřebují.

Chytrá pole se v tabulkách inventáře, SKU, katalogu a zákazníků chovají jako běžné sloupce svého typu výstupu, včetně filtrování, řazení a seskupování. Pole plnění, které je chytrým polem, se na objednávce vyplňuje stejně jako ostatní, vedle těch, která zadává personál.

## Související články

> **[Atributy](https://www.twicecommerce.com/docs/cs/concepts/admin/attributes.md)**
>
> Formáty, vstupní masky, klíče, dědičnost a přístup přes API.

> **[Nastavení integrací a API](https://www.twicecommerce.com/docs/cs/settings/integrations.md)**
>
> Konektory, klíče API a webhooky.

> **[Nastavení atributů a tagů](https://www.twicecommerce.com/docs/cs/settings/attributes-tags.md)**
>
> Kde se spravují atributy, pole plnění, skupiny a tagy.

> **[Vzorce](https://www.twicecommerce.com/docs/cs/admin/formulas.md)**
>
> Druhý vypočítaný formát, odvozený z polí na stejném záznamu.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.