Loading
Vakuutus
InsProductService:getRatedProducts

Olet tässä:

  1. Salesforce-ohje
  2. Asiakirja
  3. Digitaalinen vakuutus

InsProductService:getRatedProducts

Käytä tätä palvelua saadaksesi yhden tai useamman tuotteen taulukon, hinnoiteltu käyttämällä kyseisiin tuotteisiin liitettyjä luokitustoimenpiteitä. Tämä palvelu sisältää myös lisäominaisuuksia, kuten verojen ja palkkioiden laskennan, suodattamisen ja suorituskyvyn optimoinnin.

Luokka: InsProductService

Metodi: getRatedProducts

Käytä tätä palvelua välittämällä sille tietoja, joita luokitusprosessi tarvitsee tuotteiden hinnoitteluun. Palvelu palauttaa suodatetun tuotteiden taulukon ja tuloksen JSON-koodin luokitusprosessista.

Miten se toimii?

  1. Palvelu hakee Salesforcesta joukon aktiivisia tuotteita, jotka osuvat voimassa oleviin alkamis- ja päättymispäiviin. Lisätietoja on kohdassa effectiveDate.

    Osana kyselyä palvelut käyttävät suodatinvaihtoehdossa annettuja ehtoja saadakseen tuotteiden alustavan joukon. Salesforcesta kerätty data sisältää tuotteen oikeutussäännöt ja luokitteluprosessit, vakuutettujen tuotteiden määritykset, vakuutettujen osapuolten määritykset, kattavuusmääritykset, arvosanan faktan määritykset ja kaikki sen määritteet.

  2. Arvioi jokaisen alustavan joukon tuotteen sen oikeutussääntöjen perusteella, mikä vähentää tuotejoukkoa entisestään.

  3. Hakee userInputs-avaimen Input JSON -tiedostosta ja noutaa avaimen arvon. userInputs on joukko syötettäviä tietoja, joita luokitusprosessi käyttää tuotteen hinnan saamiseksi. Palvelu arvioi tämän objektin tuotearvosteluiden syöttökartoitusten perusteella luodakseen arvostelumenettelyn vaatiman syöttöjen JSON-koodin.

    Muotoilet userInputs-arvoja eri tavalla tuotteen määritelmän ja arvosanan kokoonpanon mukaan. Suodata tuotteet, jotka käyttävät samaa tyyppistä userInputs-formaattia, välttyäksesi virheiltä.

  4. Luokittelee vaiheessa 2 luodun joukon jokaisen tuotteen. Se kutsuu tuotteeseen liittyvää luokitustoimenpidettä, joka sisältää vaiheesta 3 saadun JSON-tiedoston.

  5. Palauttaa tuoteobjektien taulukon, joka sisältää kunkin tuotteen kokonaishinnan ja vakuutetun summan.

    Jokainen palautettu tuoteobjekti sisältää myös luokitustoimenpiteen tuloksen JSON-koodin CalculatedPriceData-arvona. Palvelu määrittää myös price ja totalSumInsured, jos kaavat on määritetty tuotteelle.

    Pidä mielessäsi, että:

    • Jos yksi attribuutti on määritetty sekä Määritä arvo -attribuutin säännön että Määritä oletusarvo -attribuutin säännön kanssa, getRatedProducts käyttää vain Määritä oletusarvo -attribuutin säännön.

    • Suosittelemme, ettet viittaa attribuuttien arvoihin alitason rakenteissa määrittäessäsi attribuuttien sääntöjen lausekkeita.

Etäasetukset

Arvosteluvaihtoehdot

Vaihtoehto

Kuvaus

aggByKey

PRODUCT.instanceKey

Kun aggByKey on määritetty, sen arvo sisällytetään laskentatoimenpiteen aggregationResult-arvoon, jos aggregationResult ei ole tyhjä. (aggregationResult täytetään tavallisesti, kun laskentatoimenpiteelle on määritetty aggregointivaiheet).

Esimerkiksi autovakuutussopimus, jossa useita kuljettajia on vakuutettu useille autoille, vaatii, että laskentatoimenpiteeseen siirretään aggByKey.

alwaysCreateInstance

Määritä tämä vaihtoehto true tuotteille, joilla on useita alitason määrityksiä tietyllä hierarkiatasolla, ei alitason määrityksiä ja vain yksi luokitusmenettely juuritasolla.

Jätä tämä vaihtoehto pois tuotteille, jotka eivät täytä kaikkia näitä ehtoja.

Lisätietoja tämäntyyppisen tuotteen userInputs-muodosta on kohdassa Yksi arvostelumenettely per tuote getRatedProductsille.

includeInputKeys

Pilkuilla erotettujen syöttöavaimien merkkijono, joka sisällytetään CalculatedPriceData-objektiin.

Vain laskentatoimenpiteen käyttämillä syöttöavaimilla on arvo tuloksissa.

rateType

Age tai Composite

Käytä tätä vaihtoehtoa pienille ryhmille.

searchText

PartOfAProductinNimi

Jos tämä vaihtoehto on käytössä, palvelu saa vain tuotteet, joiden nimet sisältävät antamasi arvon.

sortBy

productField1, productField2.

Lajittelee palvelun vastaanottamat tuotteet määrittämäsi järjestyksessä.

Voit käyttää DESC-vaihtoehtoa lajitellaksesi tuotteet laskevaan järjestykseen. Voit määrittää ensimmäisen kohteen, josta se lasketaan. Jos et määritä aloitussijaintia, DESC on oletusarvoisesti aakkosjärjestyksessä.

Jos et määritä arvoa tälle vaihtoehdolle, palvelu lajittelee palautetut tuotteet nimen perusteella nousevaan aakkosjärjestykseen.
Suodatinvaihtoehdot

Vaihtoehto

Kuvaus

attributeFilters

attributeCode ja arvojen kartta

Palauttaa vain tuotteet, jotka täyttävät suodattimessa määritetyt attribuutin arvot.

effectiveDate

“YYYY-MM-DD HH:MM:SS” tai %OmniScriptDataElement%

Oletusarvo on tämänhetkinen päivämäärä.

Palvelu noutaa tuotteet, joiden effectiveDate on EffectiveDate__c ja EndDate__c ja IsActive välillä.

Palvelu käyttää myös tätä effectiveDate-arvoa valitakseen tuotteen luokitteluun käytetyn laskentatoimenpiteen oikean version.

filters

Product2FieldName:Value

Product2FieldName:%ElementName%

Käytä API-nimeä, jonka perässä lukee arvo tai muuttuja. Esimerkiksi OmniScriptissa muuttuja voi olla elementin nimi, kuten syötetty valintaluettelo.

Erota useat suodatinparametrit toisistaan pilkuilla:

ProductCode:Value,ProductCode:%ElementName%

Suodattimet voivat sisältää minkä tahansa Product2-objektin kentän.

includeFilterAttrValues

true tai false

Oletusarvo on false.

Tämä lisää tuloksen JSON-tiedostoon tuotteiden taulukon kanssa filterAttrValues-objektin. Tämä objekti sisältää juurituotteiden attribuutit, jotka on merkitty suodatettaviksi, ja mahdollisen arvojen luettelon. Jotkin käyttöliittymän mallit käyttävät tätä luetteloa suodattaakseen suuria tuotteiden joukkoja.

Alitason tuoteattribuutteja ei sisällytetä mukaan.

whereClause

Syötä kelvollinen Salesforce SOQL -lauseke tämän vaihtoehdon arvoksi.

Käytä tätä, kun tarvitset tätä palvelua tarkastellaksesi monivalintaluettelokenttiä, kun haet tuotteita.

Lauseke voi esimerkiksi vlocity_ins_marketsegment_c includes ('Small Group') kuvata tuotteet, joilla on Markkinointisegmentit 'Pieni ryhmä' ja joko enemmän tai ei enää markkinasegmenttejä monivalintaluettelossa.

Tärkeää
Tärkeää

Poista kaikki viitteet whereClause-kenttiin suodatinavaimestasi.

Jos suodattimessa on esimerkiksi vlocity_ins_marketsegment_c:Small Group ja samaan kenttään viittaava whereClause, ne törmäävät toisiinsa ja aiheuttavat odottamattomia tuloksia.
Optimointivaihtoehdot

Vaihtoehto

Kuvaus

includeOptionalCovSelectFlag

true tai false

Oletusarvo on false.

Määritä tämä vaihtoehto true, jotta palvelu arvioi valinnaiset kattavuussäännöt ennen arvosanojen syöttämistä laskentatoimenpiteisiin.

Jos tuotteet eivät käytä valinnaisia kattavuuksia, käytä oletusarvoista false-asetusta. Valinnaisten kattavuustietojen noutaminen ja lisääminen arviointiin vaatii lisäkäsittelyä ja saattaa hidastaa tätä palvelua.

includeRawCalculationResult

true tai false

Oletusarvo on false.

Sisältää laskentatoimenpiteen koko tulokset RawPriceData-avaimeen.

isBatchMode

true tai false

Kun arvo on true, palvelu palauttaa yksinkertaistetun JSON-tiedoston, joka ei sisällä attribuuttien kategorioita, mutta sisältää attribuuttien valitsemat arvot ja säännöt.

Kun arvo on false, palvelu palauttaa tuotteen täyden JSON-koodin.

Tämä vaihtoehto on hyödyllinen, kun palvelun tuloksia ei tarvitse käyttää käyttöliittymää. Jos esimerkiksi suoritat integraatiotoimenpiteen erätilassa, joka sisältää tämän palvelun.

mergeList

true tai false

Oletusarvo on false.

Optimoi luokittelupuhelut ryhmittämällä luokitustoimenpiteen kutsut tuotteiden mukaan käyttämällä samaa luokitustoimenpidettä. Se suorittaa yhden arvostelupuhelun, jossa on input-objektien taulukko.

Tämä on hyödyllistä, kun haet paljon tuotteita. Useat arvostelukutsut voivat saavuttaa SQL-rajoituksia. Arviointitoimenpiteiden arkkitehtuuri on optimoitu käsittelemään input-objektien taulukkoa ja minimoimaan SQL-kyselyiden tarvitsemisen.

omitChildren

true tai false

Määritä tämä vaihtoehto arvoksi true vain, jos määrität myös omitRating arvoksi true. Tämä palauttaa tuotteet ilman hinnoittelua.

omitRating

true tai false

Jos arvo on true, palvelu palauttaa tuotteita ilman hinnoittelua.

productClasses

”ProductClassName1,ProductClassName2”

Tuotekategorioiden nimien pilkuilla erotettu luettelo. Rajoittaa tuotteiden luettelon näihin tuotekategorioihin.

rootPricingOnly

true tai false

Oletusarvo on false.

Tämä vaihtoehto parantaa suorituskykyä pienentämällä pinojen kokoa.

Jos käyttämäsi luokitusmenetelmä on määritetty vain juurituotteen tasolla, voit määrittää tämän vaihtoehdon arvoksi true parantaaksesi suorituskykyä.
Sääntöjen vaihtoehdot

Vaihtoehto

Kuvaus

evalOptionalCoverageRelationship

true tai falseJos arvo on true, palvelu suorittaa valinnaisia kattavuussuhteiden sääntöjä.

omitEligibility

true tai false

Oletusarvo on false.

Kun arvo on true, palvelu ei hae hyväksyttyjä tuotteita.

Sen sijaan sinun täytyy syöttää luettelotuotteen tunnus input- tai option-kartan avaimen products-kenttään. Sekä tuotetunnusten luettelo että pilkuilla erotettujen tuotetunnusten merkkijono ovat hyväksyttäviä arvoja products.

ruleAttributeSetValues

true tai false

Kun arvo on false, palvelu ei suorita attribuuttijoukon arvojen sääntöjä.

Kun arvo on true, palvelu suorittaa attribuuttijoukon arvojen säännöt.

validateCoverageSelection

true tai false

Määritä arvoksi true, jos sinulla on vahvistussääntöjä, joita tarvitset palvelun suorittamiseen.
Lisäfunktioiden vaihtoehdot

Vaihtoehto

Kuvaus

calculateTaxesAndFees

Valinnainen

true tai false

Kun arvo on true, laskee kohdetuotteen verot ja maksut.

includeFullProductJson

true tai false

Tämä vaihtoehto hallitsee ylimääräisten alitason noodien läsnäoloa API:n perusteella syötetyn JSON-tiedoston perusteella. Kun arvo on true, tuloksen JSON-tiedostoon tehdään kaksi muutosta:

  • Jos lapsenlapsen tyyppi on Vakuutettu osapuoli, ylätason JSON-noodi sisältää kaksi ylimääräistä alitason noodia; ensisijainen osapuoli ja muut osapuolet. Nämä kaksi uutta noodia täytetään sen perusteella, onko isPrimary merkintä määritetty alitason noodille.

  • Jos lapsenlapsen tyyppi on Vakuutettu kohde, nämä kaksi noodia (ensisijainen osapuoli ja muut osapuolet) eivät ole läsnä API:ssa. Input JSON -tiedostoon sisältyvät lapsenlapset linkitetään API:n output JSON -tiedoston oikeaan päänoodiin.

Edellinen yhteensopivuus on oletusarvoisesti false.

jurisdictionIds

Tyyppi: Tunnusten merkkijonoitettu luettelo

Käytetään yhdessä calculateTaxesAndFees-vaihtoehdon kanssa.

Laskee vain annettuihin lainkäyttöalueisiin liittyvät verot ja maksut.

taxAndFeeEffectiveDate

Voimaanastumispäivä, jota tämä palvelu käyttää verojen ja palkkioiden laskemiseen. Tämä vaihtoehto on erillään tuotteen hintaan käytetystä effectiveDate-vaihtoehdosta.

Jos arvo on annettu, palvelu käyttää sitä.

Jos arvoa ei ole annettu eikä tuotteen JSON ole käytäntö, palvelun oletusarvo on tämänhetkinen päivämäärä.
withTaxFeeRounding

Valinnainen

Jos arvo on true, lasketut verojen ja maksujen summat pyöristetään kahteen desimaaliin käyttämällä puolitason pyöristämisen menetelmää. withTaxFeeRounding on voimassa vain, jos myös calculateTaxesAndFees on tosi. Jos arvo on false, pyöristäminen ei ole käytössä.

Oletusarvo on false.
Käyttöliittymän vaihtoehdot

Vaihtoehto

Kuvaus

lastRecordId

Määrittää viimeisen tuotetunnuksen, jonka palvelu nouti käyttöliittymään.

Käytä tätä vaihtoehtoa pageSize-vaihtoehdon kanssa.

pageSize

Määritä, montako tuotetta palvelu palauttaa käyttöliittymään yhdessä puhelussa.

Syötetty JSON

InsProductService: getRatedProducts etsii userInputs-avaimen syötetystä JSON-tiedostosta. Käytä sopivaa userInputs-formaattia, riippuen tuotteen määritelmästä ja arvostelukokoonpanosta. Palvelu hyväksyy vain yhden userInputs-muodon kerralla.

Tulos-JSON

Palvelu palauttaa yhden tai useamman tuoteobjektin taulukon. Lisätietoja tästä objektista on Tuotteen JSON-rakenteen mallissa.

Kaikki syötetystä JSON-tiedostosta kartoitetut userInputs lisätään tuoteobjektiin sen attribuutin yksittäisen esiintymän userValues-avaimena, johon se kartoitettiin.

Jokaiselle tuotteelle arviointiprosessin laskennan tuloksen JSON lisätään tuotteeseen CalculatedPriceData-avaimella. Jos tuotteelle on määritetty hinnoittelukaava, sen laskettuun arvoon asetetaan Price-arvo. Jos tuotteelle on määritetty vakuutetun kokonaissumman kaava, TotalInsured-arvoksi asetetaan sen laskettu arvo.

Tässä esimerkissä tuotteelle määritetään hinnoittelukaava, mutta vakuutettujen kokonaiskaava ei. Arviointiprosessin tuloksiin lisätään CalculatedPriceData ja sitten hinta lasketaan kaavan perusteella. Vakuutetun kokonaiskaavaa ei näytetä datassa eikä se ole TotalInsured.

{
  "totalSize": 2,
  "records": [{
      "displaySequence": -1,
      "CalculatedPriceData": {
        "ID": "1",
        "basePremium": 719,
        "premGenlLiab": "356"
      },
      "Id": "01t6A000000FshIQAS",
      "Name": "Economy Business",
      "Family": "Commercial Lines",
      "ProductCode": "bop-ECON",
      "LineOfBusiness__c": "Property & Casualty",
      "Type__c": "BusinessOwners",
      "IsRecommended__c": false,
      "RecordTypeName__c": "Product",
      "IsConfigurable__c": true,
      "PricingFormula__c": "basePremium + premGenlLiab",
      "Term__c": "Annual",
      "productId": "01t6A000000FshIQAS",
      "Price": 1075,
      "childProducts": {
        ...
      },
      "attributeCategories": {
        ...
      }
    },
    {
      ...
    }
  }

filterAttrValues-avain

includeFilterAttrValues-vaihtoehto asettaa tuotetaulukon ratedProducts-noodiin ja lisää siihen filterAttrValues-tuloksen.

{
  "result": {
    "filterAttrValues": {
      "covType": {
        "listOfValues": [
          "Superior",
          "Economy"
        ],
        "valueDataType": "Text",
        "attributeName": "Type",
        "categoryName": "Policy Terms"
      },
      "covDeductible": {
        "listOfValues": [
          "1000",
          "250"
        ],
        "valueDataType": "Currency",
        "attributeName": "Deductible",
        "categoryName": "Policy Terms"
      }
    },
    "ratedProducts": {
      "totalSize": 2,
      "records": [{
          "displaySequence": -1,
          "CalculatedPriceData": {
            "ID": "1",
            "basePremium": 719,
            "premGenlLiab": "356"
          },
          "Id": "01t6A000000FshIQAS",
          "Name": "Economy Business",
          "Family": "Commercial Lines",
          "ProductCode": "bop-ECON",
          ...,
          "Price": 1075,
          "childProducts": {
            ...
          },
          "attributeCategories": {
            ...
          }
        },
        {
          ...
        }
      }
    }
  }

Jokainen suodatettava attribuutti lisätään objektiin, jonka avain on määritetty attribuutin koodiin. Jokaisen filter-attribuutin arvo on objekti, joka sisältää seuraavat tiedot:

Avain

Arvo

attributeName

Attribuutin nimi.

categoryName

Luokan nimi.

listOfValues

Mahdollisten arvojen luettelo taulukossa olevasta tuotteesta.

valueDataType

Attribuutin datatyyppi, kuten Teksti tai Valuutta.

Verot ja maksut

Jos verot ja maksut käyttävät palvelua, lasketut verot ja maksut näytetään JSON-tietueessa kolmella eri tavalla:

  1. Jos tietueella on laskettuja veroja ja maksuja, ne tallennetaan luettelona taxesAndFees-kenttään.

    {
  "taxesAndFees": [{
    "Id": 1,
    "calculatedAmount": 10,
    "Type__c": "Tax"
  }, {
    "Id": 2,
    "calculatedAmount": 15,
    "Type__c": "Fee"
  }]
}

  2. Jos tietue on laskenut itselleen tai sen alitason veroja, sen laskettujen verojen summa tallennetaan taxAmount-kenttään.

    {  "taxAmount”: 25 // 10 from self, 15 from children}

  3. Jos tietueella on laskettuja maksuja itselleen tai sen alitasolle, sen ja sen alitason laskettujen maksujen summa tallennetaan feeAmount-kenttään.

    {  "feeAmount”: 30 // 15 from self, 15 from children}

Esimerkki JSON-tuloksesta, joka sisältää alitason tietueiden verot ja maksut sekä juuritason, näyttää tältä:

{
  "Id": 1,
  "productName": "Product",
  "taxesAndFees": [{
    "Id": 1,
    "calculatedAmount": 10,
    "Type__c": "Tax"
  }, {
    "Id": 2,
    "calculatedAmount": 15,
    "Type__c": "Fee"
  }],
  "taxAmount": 25
  "feeAmount": 30
  "childProducts": {
    "records": [{
      "Id": 2,
      "productName": "Insured Item",
      "taxesAndFees": [{
        "Id": 3,
        "calculatedAmount": 15,
        "Type__c": "Tax"
      }],
      "taxAmount": 15
    }, {
      "Id": 3,
      "productName": "Coverage",
      "taxesAndFees": [{
        "Id": 4,
        "calculatedAmount": 15,
        "Type__c": "Fee"
      }],
      "feeAmount": 15
    }]
  }
}

Tähden luokitus

Voit käyttää attributeFilters-arvoa suodattaaksesi tuotteita tuotemallintajan määrittämien arvosanojen perusteella.

 
Ladataan
Salesforce Help | Article