> ## 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.

# Skupiny atributů

> Kolekce atributů, které organizují, jak se vlastní pole zobrazují v kartách a formulářích na detailní stránce: jedna skupina na zdroj.

![Skupiny atributů v nastavení](https://mintcdn.com/twicecommerce/l95t8ynxivCPRo_n/images/settings-attributes-tags.webp?fit=max\&auto=format\&n=l95t8ynxivCPRo_n\&q=85\&s=33fb2cbff530716f0c3f061fc92963b7)

Nastavení > Atributy & Tagy

## Definice

**Skupina atributů** je pojmenovaný kontejner, který drží příbuzné [atributy](https://www.twicecommerce.com/docs/cs/concepts/admin/attributes.md) pro jeden zdroj (Zásoby, Katalog, Zákazník nebo Objednávka). Skupiny slouží dvěma účelům:

1. **Organizace** – udržují tvou stránku nastavení přehlednou, jak roste počet atributů
2. **Rozvržení UI** – řídí, jak se karta Atributy dělí na detailních stránkách entit

> [!NOTE]
>
> **Analogie:** Představ si skupinu atributů jako složku příbuzných polí. Složka nepřidává nová pole: organizuje ta, která už máš, takže se zobrazují společně všude tam, kde se používají.

## Jak skupiny ovlivňují UI

Každá entita s atributy – skladová položka, SKU, inzerát, zákazník, objednávka – má kartu **Atributy**. Tato karta je organizovaná podle skupiny:

* Každá skupina se vykreslí jako pojmenovaná sekce na kartě
* Atributy uvnitř skupiny se vykreslí ve svém `sortOrder`
* Neseskupené atributy spadají pod výchozí sekci označenou **Podrobnosti**
* Samotné skupiny se vykreslí ve svém vlastním `sortOrder`: v tabulce nastavení je můžeš přetažením přeřadit

Systémově spravované atributy mají vlastní speciální skupiny:

| Systémová skupina | Zdroj | Použití |
| :- | :- | :- |
| `system` | Zákazník | Vestavěná zákaznická pole jako kontaktní údaje |

Systémové skupiny nelze smazat ani přejmenovat: existují bez ohledu na to, jestli sis vytvořil(a) vlastní skupiny.

## Klíčové vlastnosti

Skupina atributů nese:

| Vlastnost | Typ | Popis |
| :- | :- | :- |
| `id` | UUID | Stabilní identifikátor |
| `name` | Řetězec | Zobrazovaný název (např. „Technické specifikace“) |
| `description` | Řetězec | Volitelný kontext zobrazený v nastavení |
| `resource` | Enum | `inventory`, `catalog`, `customers` nebo `orders` |
| `sortOrder` | Číslo | Pozice vzhledem k ostatním skupinám na stejném zdroji |
| `attributeCount` | Číslo | Vypočtené: kolik atributů aktuálně do skupiny patří |
| `createdAt` / `updatedAt` | Datum a čas ISO | Auditní časová razítka |

Skupina patří přesně jednomu zdroji. Sdílení napříč zdroji neexistuje: pokud chceš podobné seskupení na skladových položkách i inzerátech, vytvoříš odpovídající skupiny na každém zdroji.

## Rozsah: jeden zdroj, jedna skupina

Na rozdíl od některých platforem TWICE nedovolí, aby jedna skupina přesahovala více zdrojů. Důvod je stejný jako u [atributů](https://www.twicecommerce.com/docs/cs/concepts/admin/attributes.md) samotných: každý zdroj má vlastní schéma a míchání skupin napříč zdroji by vytvořilo provázanost, která se špatně sleduje.

V praxi to znamená:

| Chceš... | Uděláš... |
| :- | :- |
| Skupinu „Specifikace“ na skladových položkách | Vytvoříš skupinu na zdroji `inventory` |
| Stejnou myšlenku „Specifikace“ na inzerátech | Vytvoříš paralelní skupinu na zdroji `catalog`: nezávislou identitu |
| Hromadně aplikovat skupinu na mnoho entit | Použiješ šablony inzerátu (pro inzeráty) nebo hromadnou úpravu (pro skladové položky), ne skupiny |

## Životní cyklus

### Vytváření

1. Otevři **Nastavení → Atributy & tagy**
2. Vyber kartu zdroje (Zásoby, Katalog, Zákazník, Objednávka)
3. V sekci Skupiny atributů klikni na **Přidat skupinu**
4. Nastav název, volitelný popis a pořadí řazení
5. Přiřaď existující atributy do skupiny, nebo je přiřaď později z tabulky atributů

### Aktualizace

* Přejmenování, úprava popisu a přeřazení volně: jen zobrazení, bez dopadu na data
* Skupiny přeřadíš přetažením v tabulce, čímž změníš jejich `sortOrder`
* Atribut můžeš kdykoli přesunout do skupiny nebo z ní úpravou `groupId` atributu

### Mazání

* Smazání skupiny **nesmaže** její atributy: přesunou se zpět do výchozí sekce („Podrobnosti“)
* Hromadné mazání je podporované z nástrojů pro výběr řádků v tabulce

Systémové skupiny (`system`) nelze smazat.

## Práce se skupinami přes API

Skupiny se vypisují a upravují přes interní API:

Když vytváříš atribut, dodej `groupId`, aby se umístil do konkrétní skupiny, nebo ho vynech, a atribut zůstane ve výchozí sekci.

## Vztahy

```mermaid theme={null}
%%{init: {'flowchart': {'nodeSpacing': 20, 'rankSpacing': 30}}}%%
flowchart TB
    subgraph ConceptBox["Organizace dat"]
        direction TB
        Concept["**Skupina atributů**"]
        Resource["Zdroj (zásoby / katalog / zákazník / objednávka)"]
        Concept ~~~ Resource
    end

    Attr1["Atribut 1"]
    Attr2["Atribut 2"]
    Attr3["Atribut 3"]

    subgraph RelatedBox["Zobrazuje se v"]
        direction TB
        AttributesTab["Karta Atributy entity"]
        SettingsPage["Stránka nastavení"]
        AttributesTab ~~~ SettingsPage
    end

    Concept -->|obsahuje| Attr1
    Concept -->|obsahuje| Attr2
    Concept -->|obsahuje| Attr3
    Concept -.->|řídí rozvržení| RelatedBox

    style ConceptBox fill:#0000000d,stroke:#888,stroke-width:2px
    style Concept fill:#3b82f633,stroke:#3b82f6,stroke-width:3px,font-weight:bold
    style Resource fill:#0000000a,stroke:#999,stroke-width:1px
    style Attr1 fill:#10b98133,stroke:#10b981,stroke-width:2px
    style Attr2 fill:#10b98133,stroke:#10b981,stroke-width:2px
    style Attr3 fill:#10b98133,stroke:#10b981,stroke-width:2px
    style RelatedBox fill:#f59e0b1a,stroke:#f59e0b,stroke-width:2px
    style AttributesTab fill:#f59e0b1a,stroke:#f59e0b,stroke-width:1px
    style SettingsPage fill:#f59e0b1a,stroke:#f59e0b,stroke-width:1px
```

## Časté dotazy

> **Může jeden atribut patřit do více skupin?**
>
> Ne. Atribut má přesně jeden `groupId` (nebo žádný, v tom případě se objeví pod výchozí sekcí „Podrobnosti“).

> **Co se stane, když smažu skupinu s atributy v ní?**
>
> Definice skupiny se odstraní, ale atributy zůstanou zachované. Přesunou se do výchozí sekce. Pokud chceš uklidit i atributy, smaž nebo archivuj je zvlášť.

> **Můžou být skupiny vnořené?**
>
> Ne: skupiny atributů jsou jednoúrovňové. Pokud potřebuješ jemnější dělení, vytvoř více skupin a seřaď je pomocí `sortOrder`.

> **Jaký je rozdíl mezi skupinou a tagem?**
>
> Skupiny organizují definice atributů v Nastavení a na kartě Atributy. Tagy jsou uživatelem přiřazené popisky na záznamech (zákazníci, skladové položky) používané pro segmentaci a filtrování. Tagy neovlivňují rozvržení formuláře.

> **Počítají se systémové skupiny do limitů mého plánu?**
>
> Ne. Systémové skupiny (`system`) spravuje TWICE a nepočítají se do žádné kvóty skupin na tvém plánu.

## Reference pro vývojáře

Skupiny atributů jsou v API vystavené pod tagem `attributes`.

> **[API: Attributes](https://www.twicecommerce.com/docs/api-reference/attributes)**
>
> Otevřít koncový bod v referenci API.

## Související články

> **[Atributy](https://www.twicecommerce.com/docs/cs/concepts/admin/attributes.md)**
>
> Pole, která skupiny obsahují

> **[Nastavení atributů a tagů](https://www.twicecommerce.com/docs/cs/settings/attributes-tags.md)**
>
> Kde v administraci vytváříš a spravuješ skupiny

> **[Šablony nabídek](https://www.twicecommerce.com/docs/cs/settings/listing-templates.md)**
>
> Hromadně aplikuj sady atributů při vytváření nových inzerátů

> **[Návrhové vzorce](https://www.twicecommerce.com/docs/cs/concepts/repeating-patterns/design-patterns.md)**
>
> Jak skupiny zapadají do širšího rozvržení detailní stránky založeného na kartách


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