Loading
Arvojen määrittäminen Omniscriptissa

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.

Huomautus
Huomautus

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.

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

  1. Napsauta Omniscript Designerista Esikatselu.
  2. Esikatsele Omniscript-koodia ja tarkastele tuloksena olevaa datan JSON-koodia.
  3. Etsi JSON-noodi datan JSON-tiedostosta, jonka haluat uudelleennimetä.
  4. Lisää Määritä arvot -toiminto Omniscript-komponenttiin.
  5. Napsauta Määritä arvot -toiminnosta Lisää elementin arvo.
  6. Syötä uusi JSON-noodin nimi Elementin nimi -kenttään Elementin arvokartta.
  7. 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%
  8. 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.

Huomautus
Huomautus

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

  1. Napsauta Määritä arvot -ominaisuudesta Lisää elementin arvo.
  2. Syötä Elementin arvokartta -kenttään Elementin nimi seuraavan Vaihe-elementin syöttöelementin nimi.
    Huomautus
    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-elementit FirstName ja LastName, Numero-elementti nimeltään Age ja Päivämäärä-elementti nimeltään Date.
  3. 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()
  4. 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.

Huomautus
Huomautus

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.NULL varmistaaksesi, 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%)
Esimerkkejä kaavoista ja funktioista arvojen määrittämisessä

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

 
Ladataan
Salesforce Help | Article