Dataverse.Unmask funkcija

Taikoma: drobės programoms

Prašo vieno Microsoft Dataverse įrašo apsaugoto stulpelio ne šablonas reikšmės.

Aprašas

Funkcija Dataverse.Unmask asinchroniškai perskaito stulpelį ir pateikia vieną reikšmę su stulpelio "Power Fx" tipu. Ji nepateikia įrašo arba lentelės, atnaujina šaltinio įrašą, keičia maskavimo taisyklę arba pakeičia užmaskuotas reikšmes kitoje programos vietoje.

"Dataverse" įgalina vartotojo teises. Funkcija nesuteikia prieigos arba apeis stulpelio lygio saugos. Kad galėtų skaityti nemaskuotą reikšmę, vartotojui reikia prieigos prie lentelės ir įrašo, stulpelio skaitymo teisių ir atitinkamų stulpelio saugos profilio skaitymo ne šablonas teisių.

Įtraukite lentelę "Dataverse" kaip duomenų šaltinį drobės programoje ir stulpelyje įgalinkite stulpelio lygio saugą. Norėdami konfigūruoti maskavimą, pritaikykite palaikomą maskavimo taisyklę valdomoje aplinkoje. Apsaugotame stulpelyje nebūtinai yra maskavimo taisyklė. Žr . Stulpelio lygio sauga ir Konfigūravimo taisyklių , teisių parinkčių ir palaikomų maskavimo taisyklių tipų kūrimas ir valdymas.

Svarbu

Nustatykite, kad administratorius pasirinktų tinkamas scenarijaus skaitymo ne šablonas teises. Nesuteikite visiems įrašams tik tam, kad įgalintumėte vieno įrašo pavyzdį. Patikrinkite prieigos apribojimus ne administratoriaus paskyroje, nes stulpelio lygio sauga neslepia sistemos administratorių duomenų.

Sintaksė

Dataverse.Unmask( Record, Column )
  • Record – būtina. Įrašas, kuris išlaiko savo "Dataverse" įrašo tapatybę ir yra susietas būtent su vienu "Dataverse" duomenų šaltiniu.
  • Stulpelis – būtina. Apsaugoto, palaikomo skaliarinio stulpelio identifikatorius tame įraše. Pateikite stulpelio identifikatorių, o ne teksto išraišką, kurioje yra stulpelio pavadinimas.

Stulpelyje galite naudoti leistiną rodomą vardą arba loginį pavadinimą. Aplink rodomą pavadinimą naudokite viengubas kabutes, kuriose yra tarpų, pvz 'Sensitive reference'., . Dvigubos kabutės sukuria teksto raidę ir nėra atitikmenys. Power Apps išsprendžia identifikatorių pagal stulpelio loginį pavadinimą.

Įrašų ir stulpelių reikalavimai

Pasirinktą galerijos įrašą, įrašą, kurį grąžino "LookUp", arba įrašą, saugomą kintamajame ar rinkinyje, galima naudoti, jei jis išlaiko savo "Dataverse" tapatybę ir susiejimą su lygiai vienu "Dataverse" šaltiniu. Kuriant anoniminį įrašą su tomis pačiomis lauko reikšmėmis, tapatybės nustatyti negalima.

Nepriskirkite įrašų iš skirtingų "Dataverse" lentelių tam pačiam įrašo kintamajam, kurį Dataverse.Unmasknaudoja . Toks kintamasis yra susietas su keliais šaltiniais ir yra atmetamas, net jei lentelės turi apsaugotus stulpelius su atitinkančiais pavadinimais. Naudokite atskirus vieno šaltinio kintamuosius arba skambučius.

Paskirties stulpelis turi būti apsaugotas ir turi palaikomą skaliarinį tipą. Peržvalgos reikšmių, įrašų, lentelių, failų, vaizdų ir neįrašytų stulpelių paskirties vietos nepalaikomos. Įrašo skaitymas per peržvalgą skiriasi nuo peržvalgos reikšmių stulpelio išrašymo. Žr. palaikomų maskavimo scenarijų maskavimo dokumentaciją ; formulės tipo priėmimas nenustato, kad galima konfigūruoti stulpelio maskavimo taisyklę.

Grąžinti reikšmę ir klaidas

Rezultatas turi tokį patį "Power Fx" tipą kaip tikslinis stulpelis. Pavyzdžiui, teksto stulpelis grąžina tekstą, o ne įrašą, kuriame yra tekstas.

Naudoti IfError , kad būtų galima apdoroti nesėkmingus skaitinius. "Dataverse" nustato atsakymą, kai prieiga yra apribota; nemanoma, kad dėl kiekvieno teisių atsisakymo įvyksta HTTP klaida.

Situacija Veikimas
Įrašas neturi susieto "Dataverse" šaltinio arba turi kelis "Dataverse" šaltinius. Power Apps Studio" atmeta įrašo argumentą.
Stulpelis nežinomas, neapsaugotas arba jo tipas yra nepalaikomas. Power Apps Studio" atmeta stulpelio argumentą.
Netuščio įrašo vykdymo metu nėra galiojančios tapatybės arba jo "Dataverse" šaltinio išspręsti negalima. Funkcija pateikia neleistiną įrašo klaidą.
"Dataverse" užklausa nepavyksta. Funkcija pateikia "Power Fx" klaidą, kurią galite apdoroti naudodami "IfError".
Sėkminga užklausa nepateikia eilutės, nenurodo pageidaujamo stulpelio arba pateikia nulinę reikšmę. Rezultatas tuščias.

Tik tuščias rezultatas neatpažįsta teisių problemos. Prieš reikšdami tuščią rezultatą kaip triktį, patikrinkite pasirinktą įrašą, jo reikšmę ir vartotojo prieigą.

Pavyzdžiai

Šiuose pavyzdžiuose naudojama iliustruojanti Customers lentelė "Dataverse" su apsaugotu teksto stulpeliu, pavadintu 'Sensitive reference'"". Įtraukite lentelę kaip duomenų šaltinį, konfigūruokite maskavimo taisyklę ir naudokite sintetinius įrašus su bandomuoju vartotoju, kuris turi atitinkamas teises. Pakeiskite lentelių ir stulpelių pavadinimus savais.

Skaityti pasirinktą įrašą

Nustatyti galerijos ypatybę Elementai kaip Customers. Pažymėjus įrašytą įrašą, ši formulė prašo jos ne šablonas nuorodos:

Dataverse.Unmask( Gallery1.Selected, 'Sensitive reference' )

Jei saugoma reikšmė yra "REF-12345" ir vartotojas turi teisę skaityti neįrašytą, laukiamas rezultatas yra tekstas "REF-12345". Formulė nekeičia užmaskuotos reikšmės, perskaitytos naudojant Gallery1.Selected.'Sensitive reference'"".

Teksto rezultato klaidos apdorokite

Teksto žymos ypatybėje Tekstas naudokite šią formulę, kurioje ketinate rodyti nemaskuotą reikšmę:

IfError(
    Dataverse.Unmask( Gallery1.Selected, 'Sensitive reference' ),
    "Unable to show this value."
)

Pakaitinė reikšmė yra tekstas, nes 'Sensitive reference' tai yra teksto stulpelis. Jei naudojate kitą palaikomą stulpelio tipą, prieš pateikdami teksto pranešimą naudokite suderinamą pakaitinę reikšmę arba konvertuokite rezultatą. IfError apdoroja klaidas, o ne sėkmingus tuščius rezultatus.

Visą atskleidimo ir slėpimo sąveiką žr. Užmaskuotos "Dataverse" stulpelio reikšmės atskleidimas.

Duomenų tvarkymas

Pakartotiniai vertinimai gali pakartotinai naudoti talpykloje saugomus rezultatus, o ne pateikti naujas tinklo užklausas. Nepasikliaukite kitu įvertinimu, kad iš naujo tikrintumėte neseniai pakeistas teises. Valdiklio slėpimas nėra autorizavimo riba ir neišvalo talpyklinių reikšmių.

Neišlikite nemaskuotų reikšmių naudodami SaveData, rašykite jas į žurnalus arba nukopijuokite į mažiau apsaugotą duomenų šaltinį. Ekrano kopijose arba diagnostikos prieduose venkite rodyti nemaskuotus duomenis.

  • Paskutinį kartą atnaujinta