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

# Älykentät

> Attribuutit, joiden arvon TWICE Commerce selvittää puolestasi: luettuna datasta, joka on jo tietueella, tai haettuna omasta API:stasi liittimen kautta.

Älykenttä on [attribuutti](/docs/fi/concepts/admin/attributes), jonka muoto on `smart_field`. Kukaan ei kirjoita sen arvoa: TWICE Commerce lukee sen datasta, joka on jo tietueella, tai hakee sen omasta API:stasi liittimen kautta.

Käytä älykenttää, kun arvo on jo jossakin ja sen kopioiminen käsin menee väärin. Siteen säätöarvo mittauspalvelusta, jäsentaso omasta CRM:stäsi tai monon pohjan pituus siirrettynä monojen mukana myydyille suksille.

## Miten se toimii

### Mistä arvo tulee

Jokainen älykenttä on jompaakumpaa kahta lajia, ja editorin ensimmäinen vaihe kysyy kumpaa.

| Lähde           | Mitä se tekee                                                                                                         | Mitä se vaatii                                                                   |
| :-------------- | :-------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------- |
| **Lue datasta** | Lukee yhden arvon, joka on jo tilauksella, asiakkaalla tai yhdessä myydyillä yksiköillä. Ei ulospäin lähtevää kutsua. | Yhden paikkamerkin                                                               |
| **Kutsu APIa**  | Lähettää datasi liittimelle ja tallentaa vastauksena tulevan arvon.                                                   | Liittimen, metodin ja päätepisteen polun, pyynnön sekä polun arvoon vastauksessa |

### Tulostyyppi

**Tulostyyppi** on muoto, jossa arvo tallennetaan, suodatetaan, lajitellaan ja ryhmitellään. Valitse **Teksti**, **Numero**, **Kyllä / Ei** tai **Päivämäärä**. Älykenttä käyttäytyy kaikkialla kuin tavallinen kyseisen tulostyypin attribuutti, joten numero lajittuu numerona ja päivämäärä suodattuu päivämääränä.

<Warning>
  Tulostyyppiä ei voi vaihtaa sen jälkeen, kun jollakin tietueella on kentälle arvo, eikä attribuutin muotoa voi vaihtaa **Älykenttään** tai siitä pois lainkaan. Kumpikin muutos vaatii uuden attribuutin. Päätä tyyppi siis ennen kuin liität kentän tietueisiin.
</Warning>

### Paikkamerkit

Pyyntö on tekstiä, jossa on **paikkamerkkejä** kaksinkertaisissa aaltosulkeissa. Yhdellä arvolla on yksi osoite:

| Paikkamerkki                        | Lukee                                                                |
| :---------------------------------- | :------------------------------------------------------------------- |
| `{{attribute.sole_length}}`         | Tietueen oman varastoattribuutin                                     |
| `{{fulfillment.boot_sole_length}}`  | Tietueen oman keräilyn kentän                                        |
| `{{order.reference}}`               | Tietolähteen sisäänrakennetun kentän                                 |
| `{{customer.billingAddress.city}}`  | Polun objektin sisältävään sisäänrakennettuun kenttään               |
| `{{customer.attribute.level}}`      | Asiakasattribuutin                                                   |
| `{{customer.field.weight}}`         | Tavallisen kassavastauksen, joka on yhteinen asiakkaan rivikohteille |
| `{{customerItems.fulfillment.din}}` | Saman asiakkaan muut yksiköt tilauksella                             |
| `{{customer}}`                      | Koko tietolähteen, lähetettynä JSONina                               |

Rakenna ne **Lisää data** -toiminnolla sen sijaan, että kirjoittaisit ne. Valitsin tarjoaa vain sen, mihin kenttä ulottuu, ja nimeää paikkamerkin, jota se ei voi ratkaista, ennen tallennusta.

**Lue datasta** -kenttä ottaa täsmälleen yhden paikkamerkin, joka on sen koko määritys. **Kutsu APIa** -kenttä voi käyttää niitä niin monta kuin pyyntö vaatii.

### Mitä dataa malli voi lukea

Se, mihin malli voi viitata, riippuu tietueesta, jolla arvo lasketaan, eikä siitä, missä attribuutti määriteltiin. Tilauksen data on saatavilla vain, kun laskenta tehdään tilauksella.

| Lasketaan                             | Voi lukea                                                                                         |
| :------------------------------------ | :------------------------------------------------------------------------------------------------ |
| SKU:lla                               | SKU:n                                                                                             |
| Varastoartikkelilla                   | SKU:n ja varastoartikkelin                                                                        |
| Varastoartikkelilla tilauksen sisällä | SKU:n, varastoartikkelin, rivikohteen, listauksen, tilauksen, asiakkaan ja asiakkaan muut yksiköt |
| Asiakkaalla                           | Asiakkaan                                                                                         |
| Listauksella                          | Listauksen                                                                                        |

Kenttä, jonka pyyntö nimeää tilauksen, rivikohteen tai asiakkaan dataa, näyttää laskentatoimintonsa harmaana SKU- ja varastoartikkelisivuilla ja kertoo, mikä data siellä puuttuu.

### Milloin arvo lasketaan

**Laske automaattisesti** on oletuksena päällä. Silloin tilaus hakee arvon ensimmäisen kerran heti, kun jokainen sen käyttämä syöte on täytetty, ja uudelleen aina kun jokin niistä syötteistä tai kentän oma määritys muuttuu. Pois päältä arvo odottaa, että joku painaa **Laske arvo**.

Tilaus päivittää arvojaan, kun sen status on **Avoin** tai **Käynnissä**. **Valmis**-tilauksella säilyy se, minkä kanssa se luovutettiin, eikä luonnoksella ole vielä mitään valmisteltavaa.

Jokainen laskenta tallentaa, mitä sen syötteet olivat. Myöhempi luku vertaa niitä uudelleen, ja niin arvo, joka ei enää vastaa tilausta, kertoo siitä sen sijaan että näyttäisi ajantasaiselta. Vanhentunut arvo nimeää muuttuneen syötteen sekä sen vanhan ja uuden arvon.

Arvoa, jonka joku on kirjoittanut, SKU:lta tai varastoartikkelilta perittyä arvoa, epäonnistunutta ensimmäistä hakua ja arvoa, jonka syöte on vielä tyhjä, ei haeta itsestään.

### Arvo tilauksen yksiköllä

Yksikön keräilyn kentällä voi olla arvoja useasta paikasta yhtä aikaa. Tilaus näyttää ensimmäisen, jolla on arvo:

1. Se, mitä henkilöstö kirjoitti tilaukselle
2. Laskettu tulos
3. Tilauksen datasta luettu arvo
4. Varastoartikkelin arvo
5. SKU:n arvo

Automaattisen arvon päälle kirjoittaminen ei hävitä sitä. Tilaus merkitsee syötteen ohitukseksi, näyttää alla olevan arvon, kun viet kursorin sen päälle, ja palauttaa sen, kun syöte tyhjennetään.

### Kun laskenta epäonnistuu

Epäonnistunut laskenta säilyttää edellisen arvon ja tallentaa virheen kentälle. Paina varoitusta lukeaksesi koko viestin, joka nimeää viimeisen yrityksen ja yleisimmät syyt: väärä päätepisteen polku, puuttuva tai vanhentunut avain tai ulkoinen palvelu, jota ei tavoiteta.

Liittimen poistaminen jättää jokaisen sitä käyttävän kentän paikalleen. Jokainen seuraava laskenta epäonnistuu tuolla viestillä, ja tallennettu arvo pysyy paikallaan, kunnes kentälle annetaan liitin uudelleen.

## Käyttö

### Älykentän luominen

Yhdistä API ensin kohdassa **Asetukset → Integraatiot ja API** ja määritä sitten kenttä kohdassa **Asetukset → Attribuutit ja Tagit**.

1. Avaa resurssi, johon kenttä kuuluu, ja lisää attribuutti
2. Valitse tyypiksi **Älykenttä**
3. Valitse **Lue datasta** tai **Kutsu APIa**
4. **Kutsu APIa** -lähteelle nimeä liitin, metodi ja päätepisteen polku, pyyntö sekä vastauspolku
5. **Lue datasta** -lähteelle valitse se yksi arvo, jonka kenttä lukee
6. Aseta tulostyyppi ja päätä, lasketaanko arvo automaattisesti

### Missä älykenttä voi olla

| Attribuutit kohteessa      | Älykenttä käytettävissä                                                          |
| :------------------------- | :------------------------------------------------------------------------------- |
| Varastoartikkelit ja SKU:t | Kyllä, laskettuna SKU:lla tai varastoartikkelilla                                |
| Keräilyn kentät            | Kyllä, laskettuna SKU:lla, varastoartikkelilla tai tilauksen varastoartikkelilla |
| Asiakkaat                  | Kyllä, laskettuna asiakkaalla                                                    |
| Listaukset                 | Kyllä, laskettuna listauksella                                                   |
| Tilaukset                  | Ei                                                                               |

<Note>
  Älykenttä ei voi olla yleinen attribuutti. Yleinen kenttä tekisi ulospäin lähtevän kutsun jokaiselta tilin tietueelta, joten liitä se niihin tietueisiin, jotka sitä tarvitsevat.
</Note>

Älykentät käyttäytyvät tulostyyppinsä tavallisina sarakkeina varaston, SKU:iden, katalogin ja asiakkaiden taulukoissa, suodatus, lajittelu ja ryhmittely mukaan lukien. Keräilyn kenttä, joka on älykenttä, täytetään tilauksella kuten muutkin, niiden vieressä, jotka henkilöstö kirjoittaa.

## Aiheeseen liittyvät artikkelit

<CardGroup cols={2} className="doc-rows-condensed">
  <Card title="Attribuutit" href="/docs/fi/concepts/admin/attributes">
    Muodot, syötemaskit, avaimet, periytyminen ja API-käyttö.
  </Card>

  <Card title="Integraatiot ja API -asetukset" href="/docs/fi/settings/integrations">
    Liittimet, API-avaimet ja webhookit.
  </Card>

  <Card title="Attribuutit ja Tagit -asetukset" href="/docs/fi/settings/attributes-tags">
    Missä attribuutteja, keräilyn kenttiä, ryhmiä ja tageja hallinnoidaan.
  </Card>

  <Card title="Kaavat" href="/docs/fi/admin/formulas">
    Toinen laskettu muoto, joka lasketaan saman tietueen kentistä.
  </Card>
</CardGroup>
