Olet tässä:
Arvojen määrittäminen Omniscriptissa
Käytä Määritä arvot -toimintoa määrittääksesi elementin arvoja myöhemmissä vaiheissa, nimetäksesi JSON-noodit uudelleen, luodaksesi dynaamisia arvoja ja yhdistääksesi dataa. Määritä arvot -toiminnot käyttävät yhdistämiskenttiä käyttääkseen muiden Omniscript-elementtien JSON-dataa.
Toimintaelementit renderöidään painikkeina vaiheen aikana tai etäsuoritetaan vaiheen välillä. Määritä arvot -toiminnot tapahtuvat tavallisesti vaiheiden välillä.
Käytä Määritä arvot -toimintoa:
- Käytä ja nimeä JSON-dataa muissa Omniscript-elementeissä käyttämällä yhdistämiskenttiä
- Täytä seuraavat elementit arvoilla
- Yhdistä arvot yhteen
- Määritä vastauksesta tai parametristä JSON-dataan lähetetyt arvot
- Käytä Omniscript-funktioita ja kaavojen operaattoreita määrittääksesi arvoja
Älä käytä Määritä arvot -toimintoa:
- Muunna dataa
- Merkitse saapuva JSON-data uudelleen
Käytä sen sijaan integrointitoimenpiteitä ja Omnistudio-datakartoituksia.
Määritä arvot -kaavassa olevien kahden prosenttimerkin (%) välistä tekstiä käsitellään yhdistämiskenttänä. Jos haluat esittää literaaliprosenttimerkkejä (%), käytä $Vlocity.Percent ympäristön muuttujaa.
Määritä arvot -toiminto ei tue mukautettuja otsikoita.
- Data JSON -noodien nimeäminen uudelleen
Yksinkertaista ja nimeä JSON-noodien nimet uudelleen käyttämällä Omniscript-datan JSON-tiedoston arvoja. Käytä Omniscript-datan JSON-tiedostoon parametristä, toiminnon vastaustiedoista tai elementistä lähetettyä dataa käyttämällä yhdistämiskenttiä. - Syöttöelementtien täyttäminen Määritä arvot -toiminnolla
Täytä myöhemmät syöttöelementit arvoilla datan JSON-tiedostosta, kaavojen operaattoreista, funktioista, ketjutuksista ja staattisista arvoista. Esitä elementti suoraan Omnistudio-datan kartoittimesta tai toimintovastauksesta aina, kun se on mahdollista. Kun edellinen elementti kohdistaa arvon seuraavan syöttöelementin Nimi-kenttään, seuraava syöttöelementti täytetään kohdistetulla arvolla. - Arvojen yhdistäminen arvojen määrittämiseen
Luo dynaamisia arvoja ketjuttamalla JSON-noodien arvoja. - Kaavat ja funktiot määritä arvoja
Luo dynaamisia arvoja arvioimalla dataa kaavoilla ja funktioilla palauttaaksesi tietyt arvot. - Sisäkkäisen datan määrittäminen ja käyttäminen
Määritä ja käytä sisäkkäistä dataa muokkaamalla Määritä arvot -JSON-tiedostoa suoraan ja käyttämällä tiettyä syntaksia.
Katso myös:
Data JSON -noodien nimeäminen uudelleen
Yksinkertaista ja nimeä JSON-noodien nimet uudelleen käyttämällä Omniscript-datan JSON-tiedoston arvoja. Käytä Omniscript-datan JSON-tiedostoon parametristä, toiminnon vastaustiedoista tai elementistä lähetettyä dataa käyttämällä yhdistämiskenttiä.
- Napsauta Omniscript Designerista Esikatselu.
- Esikatsele Omniscript-koodia ja tarkastele tuloksena olevaa datan JSON-koodia.
- Etsi JSON-noodi datan JSON-tiedostosta, jonka haluat uudelleennimetä.
- Lisää Määritä arvot -toiminto Omniscript-komponenttiin.
- Napsauta Määritä arvot -toiminnosta Lisää elementin arvo.
- Syötä uusi JSON-noodin nimi Elementin nimi -kenttään Elementin arvokartta.
-
Syötä Elementin arvokartta -kenttään Arvo sen JSON-noodin nimi, jonka haluat nimetä uudelleen käyttämällä yhdistämiskenttien syntaksia kartoittaaksesi sen uuteen JSON-noodiin.
Alla on esimerkki Määritä arvot -toiminnon elementin arvokartasta, joka uudelleennimeää vastauksia ja parametrejä:
Elementin nimi Arvo FirstName %FirstNameHTTPResponse% LastName %LastNameHTTPResponse% Ikä %AgeParameter% - Esikatsele Omniscriptia uudelleen ja tarkastele uutta JSON-noodin nimeä.
Syöttöelementtien täyttäminen Määritä arvot -toiminnolla
Täytä myöhemmät syöttöelementit arvoilla datan JSON-tiedostosta, kaavojen operaattoreista, funktioista, ketjutuksista ja staattisista arvoista. Esitä elementti suoraan Omnistudio-datan kartoittimesta tai toimintovastauksesta aina, kun se on mahdollista. Kun edellinen elementti kohdistaa arvon seuraavan syöttöelementin Nimi-kenttään, seuraava syöttöelementti täytetään kohdistetulla arvolla.
Oletetaan esimerkiksi, että Määritä arvot -toiminnolla on elementin arvokartta, joka kohdistaa FirstName elementin nimen ja John arvon. Seuraava Teksti-elementti, jonka nimi on FirstName, täytetään arvolla John.
Kun elementti täytetään Määritä arvot -toiminnolla, datatyyppien täytyy vastata toisiaan. Et voi esimerkiksi määrittää Teksti-elementtiä, jolla on arvo Numero-elementistä.
- Napsauta Määritä arvot -ominaisuudesta Lisää elementin arvo.
-
Syötä Elementin arvokartta -kenttään Elementin nimi seuraavan Vaihe-elementin syöttöelementin nimi.
Huomautus
Kun Elementin nimi -kenttä kartoitetaan olemassa olevaan Omniscript-elementtiin, elementin tyyppi näytetään Elementin nimi- ja Arvo-kenttien välillä.
Esimerkiksi seuraava Vaihe-elementti sisältää Teksti-elementitFirstNamejaLastName, Numero-elementti nimeltäänAgeja Päivämäärä-elementti nimeltäänDate. -
Syötä Elementin arvokartta -kenttään literaaliarvo, kaava tai toisen JSON-noodin nimi käyttämällä yhdistämissyntaksia.
Esimerkkejä:
Elementin nimi Arvo FirstName "John" LastName %LastNameHTTPResponse% Ikä %AgeParameter% Päivämäärä =TODAY() - Esikatsele Omniscript-koodia varmistaaksesi, että kentät täytetään oikein.
Arvojen yhdistäminen arvojen määrittämiseen
Luo dynaamisia arvoja ketjuttamalla JSON-noodien arvoja.
Kun olet lisännyt elementin arvon arvojen määritystoimintoon, sinun täytyy kartoittaa JSON-noodi tai elementin nimi arvoon. Yhdistä noodit, elementit tai literaaliarvot +-operaattorilla ja lisää välilyönnit tarvittaessa käyttämällä arvoa " " .
| Elementin nimi | Arvo |
|---|---|
| Syötä JSON-noodin tai elementin nimi. | Napsauta fx ja syötä useita yhdistämiskenttiä tai yhdistämiskenttien ja literaaliarvojen yhdistelmää. Esimerkki kahdesta yhdistetystä kentästä: =%FirstName% + " " +%LastName% Esimerkki yhdistetystä kentästä ja literaaliarvosta: =%FirstName% + " " + "Smith" |
Kaavat ja funktiot määritä arvoja
Luo dynaamisia arvoja arvioimalla dataa kaavoilla ja funktioilla palauttaaksesi tietyt arvot.
Kun olet lisännyt elementin arvon arvojen määritystoimintoon, määritä JSON-noodin tai elementin nimen arvo kaavalla tai funktiolla käyttämällä Käytä lauseketta arvoksi. Lisää staattisia arvoja tai dynaamisia arvoja käyttämällä yhdistämiskenttiä ja lisää operaattori.
Operaattoreilla täytyy olla välilyönti molemmilla puolilla, jotta toiminto voidaan suorittaa oikein.
Käytä $Vlocity.NULL-funktiota kohdistaaksesi null-arvon JSON-tiedostossa tai tarkastaaksesi datakentän null-arvot. Käytä $Vlocity.NULL näissä tilanteissa:
- Kumoa kentän arvon määrittäminen
- Jos haluat poistaa kentän arvon, määritä sen arvoksi null. Käytä
$Vlocity.NULLvarmistaaksesi, että järjestelmä tunnistaa arvon suoraan null-arvona. - Tarkasta ehdollisesti null
- Käytä kaavoissa
$Vlocity.NULL-arvoa havaitaksesi, milloin kenttä on null. Sen jälkeen voit käynnistää tiettyjä toimintoja. Esimerkki:IF(%Step1:Multi-select1% == null, "$Vlocity.NULL", %Step1:Multi-select1%)
Esimerkkityyppi |
Esimerkki arvon kaavan syntaksi |
|---|---|
| Yhdistä arvot | = %GrossIncome% - %NetIncome% |
| Yhdistä- ja literaaliarvot | = %GrossIncome% - 5000 |
| Literaaliarvot | = 2 - 2 |
Sisäkkäisen datan määrittäminen ja käyttäminen
Määritä ja käytä sisäkkäistä dataa muokkaamalla Määritä arvot -JSON-tiedostoa suoraan ja käyttämällä tiettyä syntaksia.
Kun olet lisännyt elementin arvon arvojen määritystoimintoon, käytä Muokkaa ominaisuuksia JSON-tiedostona kartoittaaksesi kelvollisen JSON-rakenteen Elementin nimi -kentässä luotuun noodin nimeen.
Esimerkiksi Elementin nimi -kentässä oleva ParentArray kartoitetaan NumberMap-taulukkoon, jossa on kolme arvoa:
"elementValueMap": {
"ParentArray": {
"NumberMap": [
1000,
2000,
3000
]
}
},
Voit myös käyttää sisäkkäistä dataa ja määrittää sen elementin nimeksi tai JSON-noodiksi.
Tässä tapauksessa arvojen määritystoiminnon elementti on uusi JSON-noodin nimi tai elementin nimi.
Käytä elementin arvon yhdistämiskenttien syntaksia käyttääksesi haluamaasi arvoa. Lisätietoja on kohdassa Omniscript-datan JSON:n käyttäminen yhdistämiskentillä.
