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

# Attribuuttiryhmät

> Attribuuttien kokoelmia, jotka jäsentävät mukautettujen kenttien näkymistä tietosivujen välilehdillä ja lomakkeilla — yksi ryhmä resurssia kohden.

<Frame caption="Asetukset > Attribuutit ja tunnisteet">
  <img src="https://mintcdn.com/twicecommerce/Ab7tx7ih94KQsi0k/images/settings-attributes-tags.webp?fit=max&auto=format&n=Ab7tx7ih94KQsi0k&q=85&s=c098f9058a9d05a89d8efdcd1464b4f7" alt="Attribuuttiryhmät asetuksissa" width="1920" height="1080" data-path="images/settings-attributes-tags.webp" />
</Frame>

## Määritelmä

**Attribuuttiryhmä** on nimetty kokonaisuus, joka kokoaa yhteen resurssiin (varasto, katalogi, asiakas tai tilaus) liittyvät [attribuutit](/docs/fi/concepts/admin/attributes). Ryhmillä on kaksi tarkoitusta:

1. **Jäsentely** — ne pitävät asetussivun luettavana, kun attribuuttien määrä kasvaa
2. **Käyttöliittymän asettelu** — ne määrittävät, miten Attribuutit-välilehti jaetaan kohteiden tietosivuilla

<Info>
  **Vertaus:** Ajattele attribuuttiryhmää kansiona, jossa on toisiinsa liittyviä kenttiä. Kansio ei lisää uusia kenttiä — se järjestää olemassa olevat niin, että ne näkyvät yhdessä kaikkialla, missä niitä käytetään.
</Info>

## Miten ryhmät vaikuttavat käyttöliittymään

Jokaisella attribuutteja käyttävällä kohteella — varastoartikkeli, SKU, listaus, asiakas, tilaus — on **Attribuutit**-välilehti. Välilehti on jäsennelty ryhmittäin:

* Jokainen ryhmä näkyy välilehdellä nimettynä osiona
* Ryhmän attribuutit näkyvät `sortOrder`-järjestyksessään
* Ryhmittelemättömät attribuutit näkyvät oletusosiossa nimeltä **Details**
* Ryhmät itse näkyvät omassa `sortOrder`-järjestyksessään — voit järjestää ne asetustaulukossa vetämällä

Järjestelmän hallinnoimilla attribuuteilla on omat erityisryhmänsä:

| Järjestelmäryhmä | Resurssi | Käyttötarkoitus                                    |
| :--------------- | :------- | :------------------------------------------------- |
| `system`         | Asiakas  | Sisäänrakennetut asiakaskentät, kuten yhteystiedot |

Järjestelmäryhmiä ei voi poistaa eikä nimetä uudelleen — ne ovat olemassa riippumatta siitä, oletko luonut omia ryhmiä.

## Keskeiset ominaisuudet

Attribuuttiryhmä sisältää:

| Ominaisuus                | Tyyppi        | Kuvaus                                                             |
| :------------------------ | :------------ | :----------------------------------------------------------------- |
| `id`                      | UUID          | Pysyvä tunniste                                                    |
| `name`                    | Merkkijono    | Näyttönimi (esimerkiksi ”Tekniset tiedot”)                         |
| `description`             | Merkkijono    | Vapaaehtoinen lisätieto, joka näkyy asetuksissa                    |
| `resource`                | Enum          | `inventory`, `catalog`, `customers` tai `orders`                   |
| `sortOrder`               | Luku          | Sijainti suhteessa saman resurssin muihin ryhmiin                  |
| `attributeCount`          | Luku          | Laskettu — kuinka monta attribuuttia ryhmään tällä hetkellä kuuluu |
| `createdAt` / `updatedAt` | ISO-aikaleima | Auditoinnin aikaleimat                                             |

Ryhmä kuuluu täsmälleen yhteen resurssiin. Resurssien välistä jakamista ei ole — jos haluat samanlaiset ryhmittelyt sekä varastoartikkeleille että listauksille, luot vastaavat ryhmät kummallekin resurssille.

## Rajaus: yksi resurssi, yksi ryhmä

Toisin kuin joillakin alustoilla, TWICEssä yksi ryhmä ei voi ulottua useaan resurssiin. Perustelu on sama kuin itse [attribuuttien](/docs/fi/concepts/admin/attributes) kohdalla — jokaisella resurssilla on oma skeemansa, ja ryhmien sekoittaminen resurssien välillä loisi kytkentöjä, joita on vaikea hahmottaa.

Käytännössä tämä tarkoittaa:

| Haluat...                                       | Toimit näin...                                                                            |
| :---------------------------------------------- | :---------------------------------------------------------------------------------------- |
| ”Tekniset tiedot” -ryhmän varastoartikkeleille  | Luo ryhmä `inventory`-resurssille                                                         |
| Saman ”Tekniset tiedot” -ajatuksen listauksille | Luo rinnakkainen ryhmä `catalog`-resurssille — itsenäinen kokonaisuus                     |
| Soveltaa ryhmän kerralla moneen kohteeseen      | Käytä listauspohjia (listauksille) tai massamuokkausta (varastoartikkeleille) — et ryhmiä |

## Elinkaari

### Luonti

1. Avaa **Asetukset > Attribuutit ja tunnisteet**
2. Valitse resurssivälilehti (varasto, katalogi, asiakas, tilaus)
3. Napsauta attribuuttiryhmien osiossa **Add group**
4. Aseta nimi, vapaaehtoinen kuvaus ja järjestysnumero
5. Liitä ryhmään olemassa olevia attribuutteja tai liitä ne myöhemmin attribuuttitaulukosta

### Päivitys

* Nimeä uudelleen, muokkaa kuvausta ja järjestä vapaasti — vaikuttaa vain näkymään, ei dataan
* Muuta `sortOrder`-arvoa vetämällä ryhmiä taulukossa
* Siirrä attribuutti ryhmään tai pois siitä milloin tahansa muokkaamalla attribuutin `groupId`-arvoa

### Poisto

* Ryhmän poistaminen **ei** poista sen attribuutteja — ne siirtyvät takaisin oletusosioon (”Details”)
* Massapoisto onnistuu taulukon rivivalintatyökaluilla

Järjestelmäryhmiä (`system`) ei voi poistaa.

## Ryhmien käsittely API:ssa

Ryhmiä listataan ja muokataan sisäisen API:n kautta:

Kun luot attribuutin, anna `groupId`, niin attribuutti sijoittuu haluamaasi ryhmään. Jos jätät sen pois, attribuutti jää oletusosioon.

## Suhteet

```mermaid theme={null}
%%{init: {'flowchart': {'nodeSpacing': 20, 'rankSpacing': 30}}}%%
flowchart TB
    subgraph ConceptBox["Tietojen jäsentely"]
        direction TB
        Concept["**Attribuuttiryhmä**"]
        Resource["Resurssi (inventory / catalog / customer / order)"]
        Concept ~~~ Resource
    end

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

    subgraph RelatedBox["Näkyy kohteissa"]
        direction TB
        AttributesTab["Kohteen Attribuutit-välilehti"]
        SettingsPage["Asetussivu"]
        AttributesTab ~~~ SettingsPage
    end

    Concept -->|sisältää| Attr1
    Concept -->|sisältää| Attr2
    Concept -->|sisältää| Attr3
    Concept -.->|määrittää asettelun| 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
```

## Usein kysyttyä

<AccordionGroup>
  <Accordion title="Voiko yksi attribuutti kuulua useaan ryhmään?">
    Ei. Attribuutilla on täsmälleen yksi `groupId` (tai ei yhtään, jolloin se näkyy oletusosiossa ”Details”).
  </Accordion>

  <Accordion title="Mitä tapahtuu, jos poistan ryhmän, jossa on attribuutteja?">
    Ryhmän määritys poistetaan, mutta attribuutit säilyvät. Ne siirtyvät oletusosioon. Jos haluat siivota myös attribuutit, poista tai arkistoi ne erikseen.
  </Accordion>

  <Accordion title="Voiko ryhmiä sisäkkäistää?">
    Ei — attribuuttiryhmät ovat yksitasoisia. Jos tarvitset tarkempaa jaottelua, luo useita ryhmiä ja järjestä ne `sortOrder`-arvolla.
  </Accordion>

  <Accordion title="Mikä ero on ryhmällä ja tunnisteella?">
    Ryhmät jäsentävät attribuuttimäärityksiä asetuksissa ja Attribuutit-välilehdellä. Tunnisteet ovat käyttäjien tietueille (asiakkaille, varastoartikkeleille) lisäämiä merkintöjä, joita käytetään segmentointiin ja suodatukseen. Tunnisteet eivät vaikuta lomakkeen asetteluun.
  </Accordion>

  <Accordion title="Lasketaanko järjestelmäryhmät suunnitelmani rajoihin?">
    Ei. Järjestelmäryhmät (`system`) ovat TWICEn hallinnoimia, eivätkä ne kuluta suunnitelmasi ryhmäkiintiötä.
  </Accordion>
</AccordionGroup>

## Kehittäjän viite

Attribuuttiryhmät näkyvät API:ssa `attributes`-tunnisteen alla.

<Card title="API: Attribute Groups" icon="code" href="https://server.twicecommerce.com/api/internal">
  Avaa päätepiste API-referenssissä.
</Card>

## Aiheeseen liittyvää

<CardGroup cols={2}>
  <Card title="Attribuutit" icon="tag" href="/docs/fi/concepts/admin/attributes">
    Kentät, joita ryhmät sisältävät
  </Card>

  <Card title="Attribuutit ja tunnisteet -asetukset" icon="gear" href="/docs/fi/settings/attributes-tags">
    Missä ryhmiä luodaan ja hallitaan Adminissa
  </Card>

  <Card title="Listauspohjat" icon="copy" href="/docs/fi/settings/listing-templates">
    Ota attribuuttijoukot käyttöön kerralla uusia listauksia luodessasi
  </Card>

  <Card title="Suunnittelumallit" icon="shapes" href="/docs/fi/concepts/repeating-patterns/design-patterns">
    Miten ryhmät sopivat laajempaan välilehtipohjaiseen tietosivun asetteluun
  </Card>
</CardGroup>