Datan hallintaohjelma
Datan hallinta on Product Configuratorin osavaltion hallinta- ja orkestrointikomponentti. Tämä komponentti tallentaa tuotetiedot ja käyttää kulkutapahtumia jakaakseen tiedot muihin kulkuruudun komponentteihin.
Vaaditut versiot
| Käytettävissä: Lightning Experiencessa |
| Käytettävissä: Revenue Managementin (aiemmalta Revenue Cloudilta) Enterprise-, Unlimited- ja Developer Edition -versioissa, joissa on Revenue Cloud Growth -lisenssi tai Revenue Cloud Advanced -lisenssi |
Datan hallinta -ominaisuuden vastuut
- Transaktion kontekstin ja kokoonpanon tilan ylläpito
- Käynnistä Configurator API ja prosessi vastaukset
- Lightning Message Service (LMS) -tapahtumien käsittely käyttöliittymäkomponenteista
- Tarjoa dataa käyttöliittymään ja paljasta reaktiivisia ominaisuuksia alitason komponenteille
- Tuki suosikkikokoonpanojen tallentamiseen ja lataamiseen
Datan hallinta -sivun API-nimi
S01_DataManager
Datan hallinta -sivun input-ominaisuudet
Datan hallinta hyväksyy tietoja käyttäjien määrittämistä ylätason ominaisuuksista tai kulkukomponenttien ominaisuuksista.
| Ominaisuus | Tyyppi | Pakollinen | Kuvaus |
|---|---|---|---|
| transactionLineId | Merkkijono | Kyllä | Juurituotteen tai transaktion rivin tunnus |
| currentTransactionLineId | Merkkijono | Kyllä | Tarkasteltava nykyinen rivi |
| transactionId | Merkkijono | Kyllä | Myyntitapahtuman tunnus (tarjous, tilaus jne.) |
| ylätasonNimi | Merkkijono | Kyllä | Ylätason transaktion nimi tai otsikko, johon kokoonpano liittyy. |
| alkuperä | Merkkijono | Kyllä | Transaktiotietueen ylätason objektin nimi. Esimerkki: 'Mahdollisuus', 'Tarjous', 'Tilaus', 'Omaisuus' jne. Tämä osoittaa, mikä Salesforce-objektityyppi käynnistää kokoonpanon. Käytetään navigointiin, käyttöliittymän otsikkoon jne. |
| addedNodes | Taulukko | Ei | Kulun resurssi, joka sisältää kokoelman Apex ProductConfig__SalesTransactionItem -tietueita, jotka liittyvät ylätason tietueen transaktioon. |
| onNonBlockingEnabled | Totuusarvo | Ei | Ota estotila käyttöön. Kun tämä on käytössä, käyttäjät voivat jatkaa käyttöliittymän käyttämistä, kun API-kutsuja käsitellään taustalla. Muutokset asetetaan jonoon ja käsitellään ei-synkronoidusti estämättä käyttöliittymää. Kun käyttöliittymä ei ole käytössä, se lukitaan API-kutsujen aikana. |
| areMessagesFixed | Totuusarvo | Ei | Onko viestintäkomponentilla kiinteä sijainti. Kun arvo on true, viestikomponentti pysyy pysyvästi ruudun ylälaidassa ja näkyvissä vierityksen aikana (sijainti pysyvästi). Kun arvo on false, viesti-komponentti vierittää sivun sisältöä (suhteellinen sijainti). Hyödyllinen vahvistusvirheiden/varoitusten pitämiseksi aina näkyvissä kokoonpanon aikana |
| contextId | Merkkijono | Ei | Tuotekokoonpanolle määritetyn transaktion kontekstin tunnus |
| ota ARCValidation käyttöön | Totuusarvo | Ei | Osoittaa, suoritetaanko ARC (resurssien uusimiskokoonpano) -vahvistus tuotekokoonpanon aikana |
| transactionLineGroupId | Merkkijono | Ei | Määritettävän transaktion tämänhetkisen rivin sisältävän ryhmän tunnus. Tarjouksille tämä on tarjouksen riviryhmän tunnus. Tilauksille tämä on tilauskohteen ryhmän tunnus. |
| explainabilityEnabled | Totuusarvo | Ei | Kun selittävyys on käytössä, tuotekokoonpano tarjoaa yksityiskohtaisia selityksiä siitä, miksi tuotteet piilotetaan, poistetaan käytöstä tai suositellaan. Näyttää sääntöjen suorituksen lisätiedot ja liiketoimintalogiikan perustelut auttaakseen käyttäjiä ymmärtämään kokoonpanon rajoitukset. |
| userContext | Objekti | Ei | Kulun muuttujan API-nimi, joka sisältää käyttäjän hyväksymistiedot. Tämä muuttuja on tyyppiä ProductConfig__UserContext ja määrittää tuotteen oikeutuksen käyttäjäkohtaisten attribuuttien perusteella. 1. Luo Flow Builderissa muuttujan API-nimi, esimerkiksi userContextData. 2. Käytä Kohdistus- tai Nouda tietueita -elementtiä täyttääksesi muuttujan ja määritä kenttiä, kuten rooli, alue, accountType jne. Esimerkiksi {!userContextData.role} = {!$User.UserRole.Name} 3. Valitse Datan hallinta -sivun Käyttäjäkonteksti-asetukseksi {!userContextData}. Configurator API käyttää näitä tietoja arvioidakseen hyväksymissääntöjä ja suodattaakseen käytettävissä olevia tuotteita. Jos sinulla on esimerkiksi sääntöjä, kuten "Näytä Enterprise-tuotteet vain Enterprise Sales -edustajille", API tarkastaa käyttäjän roolin tästä asiayhteydestä. Valitse käyttäjäkonteksti vain, jos sinulla on tuotevaltuutussääntöjä, jotka riippuvat käyttäjäkohtaisista attribuuteista, kuten roolista, alueesta jne. Jos kaikki tuotteet ovat kaikkien käyttäjien käytettävissä, jätä tämä kenttä tyhjäksi. |
| instantPricing | Totuusarvo | Ei | Totuusarvo, joka osoittaa, onko välitön hinnoittelu oletusarvoisesti käytössä. |
Datan hallinta -sivun output-ominaisuudet
Datan hallinta kirjoittaa tulosominaisuudet, joita asiakkaat voivat lukea. Sisäinen metodi luo dataa ja FlowAttributeChangeEvent lähettää sen asiaankuuluvalle ominaisuudelle, niin kuin tässä esimerkissä on kuvattu.
this.dispatchEvent(
new FlowAttributeChangeEvent(FLOW_REACTIVITY_MESSAGES, messages)
);
Tämä taulukko osoittaa, mitä datan hallinta tarjoaa muille komponenteille. Tietolähde-sarake osoittaa sisäisen prosessin, joka luo tiedot.
| Ominaisuus | Tietotyyppi | Kuvaus | Tietolähde |
|---|---|---|---|
| ylätunniste | Objekti | Tuotteen tämänhetkisen otsikon tiedot | mergeContexts() |
| viestit | Taulukko | Vahvistus-/virheviestit | API-vastaus + säännöt |
| optionGroups | Taulukko | Tuotekomponenttien ryhmät (vaihtoehdot) | mergeContexts() |
| attributeCategories | Taulukko | Tuoteattribuuttien kategoriat | mergeContexts() |
| summary | Objekti | Kokoonpanon yhteenveto (yhdistetty transaktiohakemisto) | mergeContexts() |
| navigationRoute | Taulukko | Nykyinen navigointipolku tai navigointipolut | buildNavigationInfo() |
| searchInfo | Taulukko | Tuotekatalogin hakutiedot | buildSearchInfo() |
| välilehdet | Taulukko | Usean juuripaketin käytettävissä olevat välilehdet | buildTabs() |
| currencyCode (valuutan koodi) | Merkkijono | Hinnoittelun valuuttakoodi | API-vastaus |
| transactionRecord | Objekti | Transaktiotietueen lisätiedot | fillateTransactionRecord() ( |
| headerTitle | Merkkijono | Ylätunnisteen otsikon teksti | generateHeaderTitle() |
| onInstantPricingToggleEnabled | Totuusarvo | Näytetäänkö pikainen hinnoittelukytkin | setToggleStates() |
| onInstantPricingEnabled | Totuusarvo | Tämänhetkinen ajankohtainen hinnoittelutila | Vaihtokytkin/API |
| isProductValidationEnabled | Totuusarvo | Tämänhetkinen vahvistustila | Vaihtokytkin/API |
| showPrices | Totuusarvo | Näytetäänkö hinnat | Osavaltion logiikka |
| showSummaryTotalSection | Totuusarvo | Näytetäänkö yhteenvedon kokonaissumma -osio | Vakuutuksen korvaaminen |
| favoriteData | Merkkijono (JSON) |
Suosikkien määritystiedot | getFavoriteData()-arvo |
| isConfiguratorDisabled | Totuusarvo | Onko konfiguraattori poistettu käytöstä | Käyttöliittymän tila |
| onApiInProgress | Totuusarvo | Onko API-kutsu käynnissä | API:n elinkaari |
| onPriceRampEnabled | Totuusarvo | Ovatko hintaraamput käytössä | Kontekstitarkistus |
| isGroupRampEnabled | Totuusarvo | Ovatko ryhmien rampit käytössä | Ryhmän laskenta |
| salesTransactionItems | Taulukko | Kaikki transaktioiden kohteet | API-vastaus |
| layoutMode | Merkkijono | Asettelutila (vakio tai kompakti) | Vaihtokytkin |
| searchResultOptionId | Merkkijono | Valitun hakutuloksen vaihtoehdon tunnus | Haku-navigointi |
| rootProductId | Merkkijono | Juuritason tuotteen tunnus | Katalogitiedot |
| currentGroupName | Merkkijono | Nykyinen ryhmän nimi | getCurrentGroupName() ( |
| contextMetadata | Objekti | Mukautettavan Myyntitapahtuman kohde -attribuuttien kontekstimetadata. Sisältää kenttien määritelmät (otsikot, datatyypit, valintaluetteloarvot) mukautetuille attribuuteille, jotka voidaan näyttää käyttöliittymässä. | Kontekstien jäsentäminen |
| eligiblePromotions | Taulukko | Sallittujen tarjousten luettelo | Tarjouskampanja-API |
Tapahtumien datan pääkäyttäjä kuuntelee
Datan hallintaohjelma kuuntelee Lightning Message Service (LMS) -tapahtumia ja langallisia sovittimia.
Datan hallinta tilaa viestintäkanavan ja vastaanottaa LMS-tapahtumat, jotka muut komponentit ovat julkaisseet siinä kuunnellakseen LMS-tapahtumia. Tämä taulukko näyttää LMS-tapahtumien toiminnot, niiden käsittelijämetodit ja mitä toiminnot tekevät.
| Tapahtumatoiminto | Handler-metodi | Mitä se tekee |
|---|---|---|
| valueChange | setState() | Päivittää kokoonpanon tilan (valinnat, määrät, attribuutit) |
| navigoi | navigoi() | Selaa pakettien hierarkiaa |
| closePreview | closePreview()- | Sulkee esikatseluikkunan |
| toggleInstantPrising | setInstantPricing()-arvo | Vaihtaa hinnoittelun välittömästi käyttöön/ulos |
| toggleExplainability | setExplainability()- | Vaihtelee selitettävyyden käyttöön/ulos |
| toggleRulesValidation | setProductValidation()-arvo | Vaihtaa vahvistuksen käyttöön/ulos |
| updatePrices | updatePrices()-arvo | Käynnistää hinnoittelun manuaalisesti |
| validateProduct | validateProduct() | Käynnistää vahvistuksen manuaalisesti |
| kloonikohteet | klooneItems() | Kloonaa transaktioiden kohteet |
| vaihtokytkinCompactLayout | setLayoutModeOnToggle() | Vaihtelee asettelutilaa |
| contextDefinitionChanged | setContextDefinition() | Päivitysten kontekstimääritelmä |
| saveFavConfiguration | handleSaveConfiguration() | Tallentaa kokoonpanon suosikiksi |
| loadFavorite | handleLoadFavorite() | Lataa suosikkikokoonpano |
Langalliset sovittimet kuuntelevat datan muutokset automaattisesti Salesforce Platformista ja välittävät datan muutokset Datan hallinta -osioon. Tämä taulukko näyttää kaapeli-sovittimien tapahtumat, joita Datan hallinta kuuntelee.
| Sovitin | Lähde | Mitä se kuuntelee | Handler-metodi | Käyttötarkoitus |
|---|---|---|---|---|
MessageContext |
lightning/messageService | Viestien konteksti LMS:lle | Ei sovellettavissa (tarjoaa asiayhteyden) |
Ottaa käyttöön LMS-viestinnän |
getContextServiceDefinition |
Lightning/industriesContextApi | Kontekstin määritelmän muutokset | gotContextDefinition() |
Kuuntelee asiayhteyden määritystietoja |
getObjectInfos (2nd) |
Lightning/uiObjectInfoApi | Transaktion kohteen objektin tiedot | getObjectInfos() | Kuuntelee transaktion kohteen metadataa |
Tapahtumien datan hallinta -ominaisuuden palot
Datan hallinta käynnistää mukautettuja tapahtumia, toast-tapahtumia ja kulkuattribuuttien muutostapahtumia.
Tämä taulukko näyttää mukautettujen tapahtumien Datan hallinta -tapahtumat, mukaan lukien kuplat ja yhdistetyt tapahtumat.
| Tapahtuman nimi | Kuplat | Yhdistetty | Kun se paloi | Käyttötarkoitus |
|---|---|---|---|---|
| lataaminen | Kyllä | Kyllä | Alkuperäisen latauksen aikana | Ilmoita ylätason lataustilasta |
| jatka | Kyllä | Kyllä | Peruuta juuripolussa TAI sulje ikkuna | Sulje konfiguraattori tallentamatta |
| Tallenna | Kyllä | Kyllä | Tallenna ja poistu navigoinnista | Tallenna kokoonpano ja poistu |
| close_modal | Kyllä | Kyllä | Sulje esikatselu | Sulje esikatseluikkuna |
| showConflictToast | Kyllä | Kyllä | Ei-estävät API-ristiriidat havaittu | Näytä ristiriitojen varoitusanniste |
Tämä taulukko kuvaa Datan hallinta -tapahtuman tulokset.
| Tapahtuman nimi | Milloin se ammuttiin | Käyttötarkoitus |
|---|---|---|
| ShowToastEvent | Kun olet ladannut suosikkisi onnistuneesti | Ilmoita käyttäjälle onnistuneesta suosikkilatauksesta |
Datan hallinta lähettää FlowAttributeChange-tapahtumat kaikille reaktiivisille ominaisuuksille jokaisen käyttöliittymän päivityksen yhteydessä.
