Loading
CRM Analyticsin
computeRelative-parametrit

computeRelative-parametrit

Kun määrität computeRelative-transformaation, määrität toiminnon attribuutiksi computeRelative. Määrität myös input-lähteen parametrit, osiointiin käytettävän kentän, lajittelukentän ja johdettujen kenttien määritelmät.

Parametrit

Voit määrittää parametrit computeRelative-noodin seuraavissa osioissa:

Seuraava taulukko kuvaa parameters-osion parametrit.

Parametri Pakollinen? Arvo
source Kyllä Datakulun määritystiedostossa oleva noodi, joka tunnistaa tämän transformaation input-lähteen.
partitionBy Kyllä API-nimi kentälle, jota käytetään datajoukon tietueiden osiointiin. Määritä vain yksi osiointiin käytettävä kenttä.
orderBy Kyllä

Kenttä, jota käytetään tietueiden lajittelemiseen kussakin osiossa ja lajittelujärjestyksessä: nouseva (asc) tai laskeva (desc). Määritä vain yksi lajittelukenttä.

Esimerkki:

"orderBy": [
    {                
        "name":"CreatedDate", 
        "direction":"asc"
     }
]
computedFields Kyllä

Määritelmien luettelo johdetuille kentille. Johdetut kentät voivat perustua lähdekenttään tai SAQL-lausekkeeseen.

Esimerkki johdetuista kentistä, jotka perustuvat lähdekenttään ja SAQL-lausekkeeseen:

"computedFields": [
                {
          "name": "PreviousAmount",
          "label": "Previous Amount",
          "description": "Previous amount of opportunity",
          "expression": {
            "sourceField": "Amount",
            "offset": "previous()",
            "default": "null"
          }
        },
        {
          "name": "AmountChange",
          "label": "Amount % Change",
          "description": "Percentage change from previous amount",
          "expression": {
            "saqlExpression": "(current(Amount)-previous(Amount))/previous(Amount)*100",
            "type": "Numeric",
            "scale": 2,
            "default": "null"
          }
        }
      ]

computedFields

Seuraava taulukko kuvaa computedFields-osion attribuutit.

Parametri Pakollinen? Arvo
name Kyllä Datajoukkoon lisättävän johdetun kentän API-nimi. Nimen täytyy olla yksilöllinen datajoukossa. Jos nimi ei ole yksilöllinen, datakulun suoritus epäonnistuu.
label Ei CRM Analytics -käyttöliittymässä näytettävän johdetun kentän näyttönimi. Voi olla enintään 255 merkkiä pitkä. Oletusarvoisesti API-nimi, jos ei määritetty.
description Ei Johdetun kentän kuvaus, vain lisätiedoksi.
expression Kyllä

Lausekeattribuutit, jolla johdetun kentän arvo lasketaan. Lauseke voi perustua input-kenttiin tai muihin transformaation johdettuihin kenttiin.

Esimerkki:

"expression": {
    "sourceField": "CloseDate",
    "offset": "previous()",
    "default": "01-01-1970"

expression

Seuraava taulukko kuvaa expression-osion attribuutit, kun luot lähdekenttään perustuvaa johdettua kenttää.

Parametri Pakollinen? Arvo
sourceField Kyllä API-nimi lähdenoodin input-kentälle, jota käytetään lausekkeessa.
offset Kyllä

Lausekkeessa käytetty funktio. Voit käyttää seuraavia funktioita:

current()
Hakee arvon tämänhetkisestä tietueesta.
Esimerkki:
"offset": "current()"
first()
Hakee arvon osion ensimmäisestä tietueesta, kuten mahdollisuuden ensimmäinen CreateDate.
Esimerkki:
"offset": "first()"
next()

Hakee arvon seuraavasta tietueesta.

Esimerkki:
"offset": "next()"
previous()
Hakee arvon edellisestä tietueesta.
Esimerkki:
"offset": "previous()"

Johdetut kentät lasketaan järjestyksessä, jossa ne määritetään. Johdetun kentän laskenta voi perustua toisen johdetun kentän arvoon, kunhan se on valmiiksi määritetty. Esimerkiksi next() ei voi käyttää seuraavan rivin johdetun kentän arvoa.

computeRelative-transformaatio vaatii, että lajittelet tietueet saadaksesi oikeat tulokset käyttämällä previous()- ja next()-funktioita.

default Kyllä (vain numerokentille)

Oletusarvo, jos arvoa ei voida laskea. Voit esimerkiksi määrittää oletusarvon tilanteisiin, kun edellistä tai seuraavaa arvoa ei ole. Voit lisätä vakiomuotoisen arvon tai current() oletusarvona.

Esimerkkejä:

"default": "3000-01-01T00:00:00.000Z" 
"default": "current()"

Seuraava taulukko kuvaa expression-osion attribuutit, kun luot SAQL-lausekkeeseen perustuvaa johdettua kenttää.

Parametri Pakollinen? Arvo
saqlExpression Kyllä

SAQL-lauseke, jolla johdetun kentän arvo lasketaan. Lauseke voi perustua input-kenttiin tai muihin transformaation johdettuihin kenttiin. Voit käyttää offset-funktioita current(),first(),next() ja previous() lausekkeessa.

Esimerkki, jossa lasketaan edellisen summan prosentuaalinen muutos verrattuna tämänhetkiseen summaan:

"saqlExpression": "(current(Amount)-previous(Amount))/previous(Amount)*100"

Voit käyttää lausekkeessa myös SAQL:n case-operaattoria.

Esimerkki, jossa tulostetaan Ylös-, Alas- tai Ei muutosta -arvo perustuen edellisen summan muutokseen verrattuna tämänhetkiseen summaan:

 "saqlExpression": "case when current(Amount)>previous(Amount) then \"Up\" when
      current(Amount)<previous(Amount) then \"Down\" else \"No Change\" end"
type Kyllä

Kenttään liittyvä CRM Analytics -kenttätyyppi. Kelvolliset tyypit ovat Päivämäärä, Numeerinen ja Teksti.

Esimerkki:

"type": "Text"
scale Ei

Numeroarvon desimaalierottimen oikealla puolella olevien lukujen määrä.

Esimerkki:

"scale": 2
default Kyllä (vain numerokentille)

Oletusarvo, jos arvoa ei voida laskea.

Esimerkki:

"default": "null"
 
Ladataan
Salesforce Help | Article