GETENUMVALUEBYNAME ER-funktio
GETENUMVALUEBYNAME-funktio etsii määritetystä luettelointitietolähteestä tiettyä Enum-arvoa käyttämällä merkkijono-arvona määritettyä luetteloinnin nimeä. Jos Enum-arvo löytyy, funktio palauttaa sen. Muussa tapauksessa funktio palauttaa Null-luettelointiarvon.
Syntaksi
GETENUMVALUEBYNAME (enumeration data source path, enumeration value text)
Argumentit
enumeration data source path: Luettelointi
Tieto lähteen kelvollinen polku, joka on jokin seuraavista luettelointityypeistä:
- Sähköisen raportointimallin (ER) numerointi
- ER-muodon numerointi
- Microsoft Dynamics 365 Financen numerointi
enumeration value text : Merkkijono
Merkkijonoarvo, joka edustaa yksittäisen luettelointiarvon nimeä.
Palautusarvot
Tyhjäarvot salliva Enum
Tulokseksi saatava luettelointiarvo.
Käyttöhuomautukset
Poikkeusta ei heitetä, jos Enum-arvoa ei löydy merkkijono-arvona määritetyn luettelointiarvon nimen avulla.
Esimerkki 1
Seuraavassa kuvassa on tietomallin ReportDirection-luettelointi. Huomaa, että luettelointiarvoille on määritetty otsikot.
Seuraavassa kuvassa on nämä tiedot:
- $Direction-tietolähde määritetään ER-raportissa. Tämä tietolähde määritetään ReportDirection-mallin luetteloinnin perusteella.
$IsArrivals-lauseke on suunniteltu käyttämään mallin luettelointiin perustuvaa $Direction-tietolähdettä tämän toiminnon parametrina.- Tämän vertailulausekkeen arvo on TOSI.
Esimerkki 2
Funktioiden GETENUMVALUEBYNAME ja LISTOFFIELDS avulla voit tuettujen luettelointien arvoja ja otsikoita tekstiarvoina. (Tuettuja luettelointeja ovat sovellusluetteloinnit, tietomalliluetteloinnit ja muotoluetteloinnit.)
Seuraavassa kuvassa TransType-tietolähde lisätään mallin yhdistämismääritykseen. Tämä tietolähde viittaa LedgerTransType-sovellusluettelointiin.
Seuraavassa kuvassa on TransTypeList-tietolähde, joka määritetään mallin yhdistämismäärityksessä. Tämä tietolähde määritetään TransType-sovellusluetteloinnin perusteella. LISTOFFIELDS-funktion avulla palautetaan kaikki luettelointiarvot kenttiä sisältävien tietueiden luettelona. Näin jokaisen luettelointiarvon tiedot tulevat näkyviin.
Muistiinpano
EnumValue-kenttä määritetään TransTypeList-tietolähdettä varten käyttämällä lauseketta GETENUMVALUEBYNAME(TransType, TransTypeList.Name). Tämä kenttä palauttaa luettelointiarvon jokaiselle tämän luettelon tietueelle.
Seuraavassa kuvassa on VendTrans-tietolähde, joka määritetään mallin yhdistämismäärityksessä. Tämä tietolähde palauttaa toimittajan tapahtumatietueita VendTrans-sovellustaulukosta. Kunkin tapahtuman kirjanpitotyyppi määräytyy TransType-kentän arvon mukaan.
Muistiinpano
TransTypeTitle-kenttä määritetään VendTrans-tietolähdettä varten käyttämällä lauseketta FIRSTORNULL(WHERE(TransTypeList, TransTypeList.EnumValue = @.TransType)).Label. Tämä kenttä palauttaa nykyisen tapahtuman luettelointiarvon otsikon tekstinä, jos tämä luettelointiarvo on käytettävissä. Muussa tapauksessa se palauttaa tyhjän merkkijonoarvon.
TransTypeTitle-kenttä on sidottu sellaisen tietomallin LedgerType-kenttään, joka mahdollistaa näiden tietojen käytön kaikissa ER-muodoissa, joissa tätä tietomallia käytetään tietolähteenä.
Seuraavassa kuvassa näkyy, miten voit käyttää tietolähteen virheenkorjausta määritetyn mallin yhdistämismäärityksen testaamiseen.
Tietomallin LedgerTypenäyttää tapahtumatyyppien otsikkoja odotetulla tavalla.
Jos aiot käyttää tätä menetelmää suureen määrään tapahtumatietoja, sinun on otettava huomioon suorituksen suorituskyky. Lisätietoja: Sähköisen raportoinnin muotojen suorittamisen seuraaminen suorituskykyyn liittyvien ongelmien ratkaisemiseksi.