
Asetukset > Attribuutit ja Tagit
Määritelmä
Attribuutit ovat konfiguroitava sarakejärjestelmä, joka on TWICE Commercen jokaisen taulukon ja yksityiskohtanäkymän taustalla. Attribuutteina ilmaiset kaiken sen, mitä liiketoimintasi tarvitsee seurata mutta mikä ei sisälly ydintietomalliin: kuntoluokan, sarjanumeron, takuun alkamispäivän tai mukautetut toimitusohjeet.Missä attribuutteja käytetään
Jokainen attribuutti kuuluu täsmälleen yhteen resurssiin:sku— attribuutti määritellään SKU-tasolla, ja jokainen kyseisen SKU:n alla oleva varastoartikkeli perii senarticle— attribuutti määritellään vain varastoartikkelitasolla (varastoartikkeleita kutsutaan sisäisesti myös artikkeleiksi)
Attribuuttien tietomuodot
TWICE Commerce tukee yhdeksää attribuuttimuotoa:text, number, boolean, date, datetime ja select. Kolme muuta, multiselect, formula ja smart_field, eivät piirrä kassalla mitään syötettä, eikä niitä tarjota kummassakaan valitsimessa.
Erillistä currency-, percent-, email-, url-, phone-, file-, relation- tai external-muotoa ei ole — käytä number-muotoa valuutta- ja prosenttiarvoille, text-muotoa sähköposteille ja URL-osoitteille sekä dokumentteja tiedostoliitteille. text-attribuutti voi rajata hyväksymäänsä sisältöä syötemaskeilla, jotka kuvaavat kiinteän muodon, kuten kortti- tai lisenssinumeron. Maskit eivät ilmaise avoimia muotoja kuten sähköpostiosoitteita.
Select- ja multiselect-vaihtoehdot
Jokainen select- tai multiselect-attribuutin vaihtoehto on{ key, label } -pari:
key on muuttumaton tunniste, joka tallennetaan tietueille. label on käyttäjille näkyvä teksti, jota voi muokata vapaasti rikkomatta historiatietoja. Molempien enimmäispituus on 255 merkkiä.
Kaava-attribuutit
Kaava-attribuutit laskevat arvonsa saman resurssin muista kentistä. Kukin resurssi tarjoaa kaavoille eri joukon järjestelmäkenttiä:item_income - item_costs tuottaa kertyneen tuoton. Kaava lasketaan uudelleen aina, kun sen syötteet muuttuvat.
Lue lisää: Kaavat
Älykenttä-attribuutit
Älykenttä lasketaan kuin kaava, mutta kauempaa. Se lukee yhden arvon, joka on jo tietueella, tai kutsuu omaa API:asi liittimen kautta ja tallentaa vastauksena tulevan arvon. Aseta sen Tulostyyppi: Teksti, Numero, Kyllä / Ei tai Päivämäärä. Kenttä tallennetaan, suodatetaan, lajitellaan ja ryhmitellään tämän tyypin mukaan, ja tyyppi lukittuu heti kun jollakin tietueella on kentälle arvo. Muotoa ei voi myöskään vaihtaa Älykenttään eikä siitä pois, joten kumpikin muutos vaatii uuden attribuutin. Lue lisää: ÄlykentätSyötemaskit
text-attribuutilla voi olla syötemaskeja — mallimerkkijonoja, jotka kuvaavat tarkan muodon, jonka arvo saa ottaa, esimerkiksi 123456 #### ######[#] jäsenkortin numerolle. Arvo, joka ei vastaa mitään attribuutin maskia, hylätään.
Jokainen maski ohjaa kolmea asiaa yhtä aikaa: palvelimen soveltamaa tarkistussääntöä, asiakkaalle näkyvää paikkamerkkiä ja muotoilua, jonka kenttä tekee kirjoitettaessa. Ne johdetaan samasta maskista, joten ne eivät voi olla ristiriidassa keskenään.
Maskit koskevat vain text-muotoa. Niitä muokataan attribuuttipaneelissa kohdassa Asetukset → Attribuutit ja Tagit, jossa osion nimi on Hyväksytyt formaatit ja Lue, miten formaatit toimivat avaa syntaksiohjeen. Jokainen rivi näyttää täytetyn esimerkin ja hyväksytyn arvon pituuden, joten yhden merkin virhe valinnaisessa lohkossa näkyy ennen tallennusta.

Asetukset > Attribuutit ja Tagit — Hyväksytyt formaatit -editori
Maskin syntaksi
Kaikki maskissa on kiinteää tekstiä, ellei se ole jokin näistä symboleista:123456 #### tarkoittaa kuutta kiinteää numeroa, välilyöntiä ja sitten neljää numeropaikkaa — alun numeroita ei koskaan tulkita täytettäviksi paikoiksi.
Editori valvoo lisäksi muutamaa sääntöä:
{…}luettelee jäsenensä kirjaimellisesti. Välejä ei ole:{1-3}hyväksyy merkin1,-tai3, ei väliä1–3. Kirjainkoko on tarkka, joten{AB}hylkää merkina.- Maskissa voi olla enintään yksi valinnainen lohko, ja sen on oltava lopussa.
- Maskissa on oltava vähintään yksi syöttöpaikka —
#,@,*tai{…}. - Merkkijoukko ei voi olla tyhjä, sisäkkäinen tai sisältää samaa merkkiä kahdesti.

Lue, miten formaatit toimivat — sovelluksen sisäinen syntaksiohje
Useita hyväksyttyjä muotoja
Attribuutti voi hyväksyä useita muotoja. Lisää yksi maski muotoa kohti, enintään 10 maskia, kukin enintään 100 merkkiä. Listan maskien on oltava erotettavissa toisistaan kiinteiden alkujensa perusteella, kun erottimet on poistettu. TWICE hylkää listan, jossa yhden maskin kiinteä alku on toisen alun etuliite:123456 #### ja 998877 #### käyvät, @@@-### ja @@@### eivät, koska kummallakaan ei ole erottavaa kiinteää alkua. Virheilmoitus nimeää kaksi ristiriitaista maskia.
Kentän toiminta riippuu siitä, montako maskia attribuutilla on:
Missä maskeja valvotaan
- Verkkokaupan kassa — attribuuttiin sidotut kentät Yhteystiedot-vaiheessa ja Lisätiedot-vaiheessa muotoilevat arvon asiakkaan kirjoittaessa, täyttävät kiinteän alun ja normalisoivat ilman erottimia liitetyn arvon. Virheellinen arvo estää vaiheen.
- Hallintapaneeli — sama maskattu syöttö on käytössä kaikkialla, missä henkilökunta syöttää attribuuttiarvoja, mukaan lukien asiakaspaneeli ja uuden tilauksen kassakentät.
- API ja palvelin — jokainen
text-attribuutin arvon kirjoitus tarkistetaan. Vastaus on400, joka nimeää attribuutin ja täytetyn esimerkin jokaisesta hyväksytystä maskista:Member card: must match the format 123456 1234 567890. Kassan vahvistuksessa palvelin tarkistaa yhteystietoattribuutit uudelleen ja raportoi virheelliset arvot erillään puuttuvista pakollisista.
"123456 1140 411905", ei "1234561140411905" — verkkokaupan syöttökenttä normalisoi liitetyt arvot, API ei.

Maskattu attribuuttikenttä kassalla kesken syötön
Maskien muuttaminen
- Maskit kuuluvat
text-muotoon. Attribuutin muodon vaihtaminen joksikin muuksi tyhjentää ne. - Maskin lisääminen tai muokkaaminen tarkistaa siitä eteenpäin kirjoitettavat arvot. Jo tallennettuja arvoja ei kosketa eikä tarkisteta uudelleen.
- Kaikkien maskien poistaminen jättää kentän jälleen rajoittamattomaksi.
Keskeiset ominaisuudet
Attribuuttimääritys sisältää:system asiakkaille — jotka sisältävät TWICE Commercen puolestasi hallinnoimat attribuutit.
Miten avain tallennetaan
Tallennettukey sisältää pieniä kirjaimia, numeroita sekä merkit _ ja -, ei mitään muuta. TWICE Commerce korjaa kirjoittamasi arvon sen sijaan, että hylkäisi sen: attribuutin lisäys- ja muokkauspaneelin Attribuutin avain -kenttä muuntaa syötteen sitä mukaa kun kirjoitat, joten kentässä näkyy aina se arvo, joka tallennetaan.
Kentän ohjeteksti sanoo saman: ”Pienet kirjaimet, numerot, - ja _. Kaikki muu muunnetaan automaattisesti.”
Muunnos etenee tässä järjestyksessä:
- Isot kirjaimet muutetaan pieniksi.
- Välilyönnit muuttuvat alaviivoiksi
_. - Kaikki muut merkit kuin
a-z,0-9,_ja-poistetaan. - Alusta poistetaan
attributes_.
name-kentästä samoilla säännöillä. Jos johdettu avain on jo varattu, sen perään lisätään numero — condition, sitten condition_1, condition_2.
Itse kirjoittamaasi avainta ei muuteta automaattisesti toiseksi. Jos se törmää jo olemassa olevaan attribuuttiin, tallennus epäonnistuu virheeseen Attribute key "condition" is already in use. ja valitset toisen avaimen.
Avaimen myöhempi uudelleennimeäminen käy läpi saman muunnoksen. Jos uudesta nimestä ei jää mitään käyttökelpoista, sitä käsitellään kuin uudelleennimeämistä ei olisi pyydetty: tallennettu avain säilyy ennallaan eikä sitä tyhjennetä.
key-kentäksi minkä tahansa merkkijonon ja korjaa sen tallennettaessa, joten takaisin luettava arvo voi poiketa lähettämästäsi — kun lähetät POST-pyynnössä avaimen list-CutStyle, attribuutti luodaan avaimella list-cutstyle. Lue tallennettu avain vastauksesta äläkä oleta sen olevan sama kuin lähettämäsi.Periytyminen: SKU > varastoartikkeli
Erityisesti varastoattribuuteille pätee:- Attribuutti, jonka alkuperä on
origin: sku, määritellään SKU:lle, ja se luetaan jokaiselta kyseiseen SKU:hun kuuluvalta varastoartikkelilta - Attribuutti, jonka alkuperä on
origin: article, määritellään suoraan varastoartikkelille eikä sitä jaeta muiden kanssa - SKU-alkuperäistä attribuuttia ei voi muokata yksittäisellä varastoartikkelilla — muokkaat sitä SKU:lla, ja muutos leviää kaikille artikkeleille
Tilausattribuutit
orders-resurssiin kuuluvat attribuutit liittävät mukautettua tietoa yksittäisiin tilauksiin varasto-, katalogi- tai asiakastietueiden sijaan. Yleisiä esimerkkejä: kustannuspaikka, lahjaviesti, ostotilausnumero tai erityiset toimitusohjeet.
Kerääminen kassalla
Lisää attribuuttikenttä kassan yhteystietolomakkeeseen ja sido se attribuuttiin. Kassalla järjestelmä ohjaa kerätyn arvon attribuutin resurssin mukaan:orders— tallennetaan tilauksen attribuuttiarvoihincustomers— tallennetaan asiakasprofiiliin
Vahvistussähköposti
Kerätyt tilausattribuuttien arvot näkyvät automaattisesti tilausvahvistussähköpostissa:- Globaalit tilausattribuutit näkyvät aina — viivalla (—) merkittynä, jos arvoa ei kerätty
- Ei-globaalit tilausattribuutit näkyvät vain, kun arvo on olemassa
Hallintapaneeli
Tilausattribuuttien arvot näkyvät tilauksen tietosivulla omalla attribuuttikortillaan. Voit lisätä, muokata ja poistaa arvoja suoraan. Tilausattribuutit näkyvät myös suodatettavina ja lajiteltavina sarakkeina tilaustaulukossa.Suodatus ja haku
Kun attribuutti on olemassa, se ilmestyy automaattisesti resurssinsa taulukkoon:API-käyttö
Attribuutit sisältyvät jokaiseen API-vastaukseen sillä resurssilla, jota ne koskevat. Ne on avainnettuid-kentällä ja esitetään tyypitettynä arvotietueena.
Tyypillinen varastovastaus sisältää:
key, eivät käyttäjälle näkyvä label.
Elinkaari
Luominen
- Avaa Asetukset → Attribuutit ja Tagit
- Valitse resurssi, jota attribuutti koskee (varasto, katalogi, asiakas, tilaus)
- Määritä nimi, kuvaus ja muoto
select- /multiselect-muodoille määritä vaihtoehtolistaformula-muodolle kirjoita lauseke ja valitse tuloksen muotosmart_field-muodolle valitse lähde, määritä pyyntö ja aseta tulostyyppi- Halutessasi liitä ryhmään ja määritä lajittelujärjestys
Päivittäminen
- Nimeä, kuvausta, lajittelujärjestystä ja ryhmää voi muuttaa vapaasti
- Vaihtoehtojen lisääminen select-/multiselect-listaan on turvallista
- Vaihtoehtojen
label-tekstien uudelleennimeäminen on turvallista — tallennettuna säilyykey - Vaihtoehdon poistaminen rikkoo kaikki siihen viitanneet tietueet — TWICE Commerce varoittaa ennen poistoa
- Muodon vaihtaminen on rajoitettua, koska muunnos voi hävittää tietoa; turvallisempi tapa on luoda uusi attribuutti ja siirtää arvot
- Muotoa ei voi vaihtaa
smart_field-muotoon eikä siitä pois lainkaan, ja älykentän tulostyyppi lukittuu heti kun jollakin tietueella on sille arvo
Arkistointi ja poistaminen
- Arkistointi piilottaa attribuutin uusilta syötöiltä mutta säilyttää historiatiedot
- Poistaminen poistaa attribuuttimäärityksen ja kaikki sen tallennetut arvot jokaisesta tietueesta; tätä ei voi perua
- Käytä arkistointia lähes aina; poistaminen on tarkoitettu vain vahingossa luotujen attribuuttien siivoamiseen
Suhteet
Usein kysytyt kysymykset
Voinko käyttää samaa attribuuttia varastoartikkeleilla ja listauksilla?
Voinko käyttää samaa attribuuttia varastoartikkeleilla ja listauksilla?
Mikä ero on SKU-alkuperäisillä ja varastoartikkeli-alkuperäisillä attribuuteilla?
Mikä ero on SKU-alkuperäisillä ja varastoartikkeli-alkuperäisillä attribuuteilla?
Voinko muuttaa select-attribuutin vaihtoehtoja käyttöönoton jälkeen?
Voinko muuttaa select-attribuutin vaihtoehtoja käyttöönoton jälkeen?
label-tekstin uudelleennimeäminen on turvallista — taustalla oleva key säilyy. Vaihtoehdon poistaminen rikkoo kaikki siihen viitanneet tietueet, joten TWICE Commerce varoittaa ennen poistoa.Miten kaava-attribuutit päivittyvät?
Miten kaava-attribuutit päivittyvät?
Mitä eroa on kaavalla ja älykentällä?
Mitä eroa on kaavalla ja älykentällä?
Näkyvätkö attribuutit asiakkaille?
Näkyvätkö attribuutit asiakkaille?
Voinko muokata attribuutteja massana?
Voinko muokata attribuutteja massana?
Kehittäjän viite
Attribuutit esitetään API:ssa nimelläattributes.