Muistiinpano
Tämän sivun käyttö edellyttää valtuutusta. Voit yrittää kirjautua sisään tai vaihtaa hakemistoa.
Tämän sivun käyttö edellyttää valtuutusta. Voit yrittää vaihtaa hakemistoa.
Koskee seuraavia:
pohjaan perustuvat sovellukset
Pyytää suojatun sarakkeen nimeämätöntä arvoa yksittäiselle Microsoft Dataverse tietueelle.
Kuvaus
Funktio Dataverse.Unmask lukee sarakkeen asynkronisesti ja palauttaa yksittäisen arvon sarakkeen Power Fx -tyypillä. Se ei palauta tietuetta tai taulukkoa, päivitä lähdetietuetta, muuta peittämissääntöä tai korvaa naamioituja arvoja muualla sovelluksessasi.
Dataverse valvoo käyttäjän käyttöoikeuksia. Funktio ei myönnä käyttöoikeuksia tai ohita saraketason suojausta. Jotta käyttäjä voi lukea yhdistämättömän arvon, hänen on käytettävä taulukkoa ja tietuetta, sarakkeen lukuoikeutta ja asianmukaista luettamatonta oikeutta sarakkeen suojausprofiilissa.
Lisää Dataverse-taulukko tietolähteeksi pohjaan perustuvaan sovellukseesi ja ota saraketason suojaus käyttöön sarakkeessa. Voit määrittää peittämisen käyttämällä tuettua peittämissääntöä hallitussa ympäristössä. Suojatulla sarakkeella ei välttämättä ole peittämissääntöä. Lue saraketason suojaus ja Peittämissääntöjen luominen ja hallinta määritystä, käyttöoikeusasetuksia ja tuettuja peittämissääntötyyppejä varten.
Tärkeää
Pyydä järjestelmänvalvojaa valitsemaan skenaarion lukuoikeudet, jotka eivät ole vielä määritetty . Älä myönnä Kaikkia tietueita pelkästään yhden tietueen esimerkin ottamiseksi käyttöön. Testaa käyttöoikeuksien rajoituksia muun kuin järjestelmänvalvojatilin avulla, koska saraketason suojaus ei piilota järjestelmänvalvojilta saatuja tietoja.
Syntaksi
Dataverse.Unmask( Record, Column )
- Record – Pakollinen. Tietue, joka säilyttää Dataverse-tietueidentiteettinsä ja liittyy täsmälleen yhteen Dataverse-tietolähteeseen.
- Column – Pakollinen. Suojatun, tuetun skalaarisarakkeen tunnus kyseisessä tietueessa. Anna saraketunnus, älä tekstilauseketta, joka sisältää sarakkeen nimen.
Voit käyttää sarakkeelle kelvollista näyttönimeä tai loogista nimeä. Käytä heittomerkkejä näyttönimen ympärillä, joka sisältää välilyöntejä, kuten 'Sensitive reference'. Lainausmerkit luovat tekstiliteraalin, eivätkä ne vastaa toisiaan. Power Apps ratkaisee tunnuksen sarakkeen loogiseen nimeen.
Tietue- ja sarakevaatimukset
Valittua valikoimatietuetta, LookUp-funktion palauttamia tietueita tai muuttujaan tai kokoelmaan tallennettua tietuetta voidaan käyttää, jos se säilyttää Dataverse-identiteettinsä ja yhteytensä täsmälleen yhteen Dataverse-lähteeseen. Anonyymin tietueen muodostaminen samoilla kenttien arvoilla ei määritä kyseisiä käyttäjätietoja.
Älä määritä eri Dataverse-taulukoiden tietueita samalle tietuemuuttujalle, jota Dataverse.Unmaskkäyttää . Tällainen muuttuja liittyy useisiin lähteisiin, ja se hylätään, vaikka taulukoilla olisi suojatut sarakkeet, joissa on vastaavat nimet. Käytä erillisiä yhden lähteen muuttujia tai kutsuja.
Kohdesarake on suojattava, ja sillä on oltava tuettu skalaarityyppi. Hakuarvoisia, tietue-, taulukko-, tiedosto-, kuva- ja tyypittömiä sarakkeita ei tueta. Tietueen lukeminen haun kautta eroaa hakuarvoisen sarakkeen paljastamisesta. Katso peittämissäännön dokumentaatiosta tuetut peittämisskenaariot; kaavatyypin hyväksyntä ei määritä, että peittämissääntö voidaan määrittää sarakkeelle.
Palautusarvo ja virheet
Tuloksen Power Fx -tyyppi on sama kuin kohdesarakkeessa. Esimerkiksi tekstisarake palauttaa tekstiä, ei tekstiä sisältävää tietuetta.
Käytä IfError-funktiota epäonnistuneiden lukujen käsittelemiseen. Dataverse määrittää vastauksen, kun käyttöoikeutta rajoitetaan. Älä oleta, että jokainen käyttöoikeuden epääminen aiheuttaa HTTP-virheen.
| Tilanne | Toimintatapa |
|---|---|
| Tietueella ei ole liittyvää Dataverse-lähdettä tai sillä on useita Dataverse-lähteitä. | Power Apps Studio hylkää tietueargumentin. |
| Sarake on tuntematon, suojaamaton tai sen tyyppi on ei-tuettu. | Power Apps Studio hylkää sarakeargumentin. |
| Nonblank-tietueella ei ole kelvollisia käyttäjätietoja suorituksen aikana tai sen Dataverse-lähdettä ei voida ratkaista. | Funktio palauttaa virheellisen tietueen virheen. |
| Dataverse-pyyntö epäonnistuu. | Funktio palauttaa Power Fx -virheen, jonka voit käsitellä IfError-toiminnolla. |
| Onnistunut pyyntö ei palauta riviä, jättää pyydetyn sarakkeen pois tai palauttaa tyhjäarvon. | Tulos on tyhjä. |
Tyhjä tulos ei yksinään tunnista käyttöoikeusongelmaa. Tarkista valittu tietue, sen arvo ja käyttäjän käyttöoikeus ennen kuin käsittelet tyhjää tulosta virheenä.
Esimerkkejä
Näissä esimerkeissä käytetään havainnollistavaa Customers Dataverse-taulukkoa, jossa on suojattu tekstisarake nimeltä 'Sensitive reference'. Lisää taulukko tietolähteeksi, määritä peittämissääntö ja käytä synteettisiä tietueita testikäyttäjällä, jolla on asianmukaiset käyttöoikeudet. Korvaa taulukon ja sarakkeen nimet omillasi.
Lue valittu tietue
Määritä valikoiman Kohteet-ominaisuuden arvoksi .Customers Kun tallennettu tietue on valittuna, tämä kaava pyytää sen viittaamatonta viittausta:
Dataverse.Unmask( Gallery1.Selected, 'Sensitive reference' )
Jos tallennettu arvo on "REF-12345" ja käyttäjällä on oikeus lukea se yhdistämättömänä, odotettu tulos on teksti "REF-12345". Kaava ei muuta rajoitettu arvo, joka luetaan :n kautta Gallery1.Selected.'Sensitive reference'.
Tekstituloksen virheen käsitteleminen
Käytä seuraavaa kaavaa tekstiotsikon Text-ominaisuudessa , jossa aiot näyttää esitämättömän arvon:
IfError(
Dataverse.Unmask( Gallery1.Selected, 'Sensitive reference' ),
"Unable to show this value."
)
Korvaava arvo on teksti, koska 'Sensitive reference' se on tekstisarake. Jos kyseessä on eri tuettu saraketyyppi, käytä yhteensopivaa korvaavaa arvoa tai muunna tulos ennen tekstiviestin palauttamista.
IfError käsittelee virheitä, tyhjät tulokset eivät onnistu.
Täydellinen tietojen paljastamisen ja piilotettamisen vuorovaikutus on kohdassa Naamioidun Dataverse-sarakkeen arvon paljastaminen.
Tietojen käsittely
Toistuvat arvioinnit voivat käyttää välimuistiin tallennettuja tuloksia uudelleen uusien verkkopyyntöjen tekemisen sijaan. Älä luota toiseen arviointiin viimeksi muutettujen käyttöoikeuksien uudelleentarkistamiseksi. Ohjausobjektin piilottaminen ei ole valtuutusraja, eikä se tyhjennä välimuistiin tallennettuja arvoja.
Älä säilytä yhdistämättömiä arvoja SaveData-tiedoissa, kirjoita ne lokeihin tai kopioi ne vähemmän suojattuun tietolähteeseen. Vältä yhdistämättömien tietojen paljastamista näyttökuvissa tai diagnostiikkaliittisissä.