Dataverse.Unmask fonksiyon

Şunun için geçerlidir: Tuval uygulamaları

Tek bir Microsoft Dataverse kaydı için güvenli bir sütunun maskelenmemiş değerini istemektedir.

Description

İşlev Dataverse.Unmask bir sütunu zaman uyumsuz olarak okur ve sütunun Power Fx türüne sahip tek bir değer döndürür. Kayıt veya tablo döndürmez, kaynak kaydı güncelleştirmez, maskeleme kuralını değiştirmez veya maskelenmiş değerleri uygulamanızın başka bir yerinde değiştirmez.

Dataverse, kullanıcının izinlerini zorlar. İşlev erişim izni vermez veya sütun düzeyinde güvenliği atlamaz. Maskelenmemiş bir değeri okumak için kullanıcının tablo ve kayda, sütun Okuma iznine ve sütun güvenlik profilinde uygun Maskelenmemiş okuma iznine erişmesi gerekir.

Dataverse tablosunu tuval uygulamanıza veri kaynağı olarak ekleyin ve sütunda sütun düzeyinde güvenliği etkinleştirin. Maskelemeyi yapılandırmak için yönetilen bir ortamda desteklenen bir maskeleme kuralı uygulayın. Güvenli bir sütunun maskeleme kuralı olması gerekmez. Bkz. Sütun düzeyinde güvenlik ve Yapılandırma, izin seçenekleri ve desteklenen maskeleme kuralı türleri için maskeleme kuralları oluşturma ve yönetme.

Important

Yöneticinizden senaryo için uygun Maskelenmemiş okuma iznini seçmesini isteyin. Yalnızca tek kayıtlı bir örneği etkinleştirmek için Tüm kayıtlar'a izin verme. Sütun düzeyinde güvenlik sistem yöneticilerinden verileri gizlemediğinden, erişim kısıtlamalarını yönetici olmayan bir hesapla test edin.

Syntax

Dataverse.Unmask( Record, Column )
  • Kayıt - Gerekli. Dataverse kayıt kimliğini koruyan ve tam olarak bir Dataverse veri kaynağıyla ilişkilendirilmiş bir kayıt.
  • Sütun - Gerekli. Bu kayıtta güvenli, desteklenen bir skaler sütunun tanımlayıcısı. Sütun adını içeren bir metin ifadesi değil, sütun tanımlayıcısı sağlayın.

Sütun için geçerli bir görünen ad veya mantıksal ad kullanabilirsiniz. Gibi 'Sensitive reference'boşluklar içeren bir görünen adın çevresinde tek tırnak işareti kullanın. Çift tırnak işaretleri metin değişmez değeri oluşturur ve eşdeğer değildir. Power Apps, tanımlayıcıyı sütunun mantıksal adına çözümler.

Kayıt ve sütun gereksinimleri

Seçilen galeri kaydı, LookUp tarafından döndürülen bir kayıt veya değişken veya koleksiyonda depolanan bir kayıt, Dataverse kimliğini ve ilişkilendirmesini tek bir Dataverse kaynağıyla koruyorsa kullanılabilir. Aynı alan değerlerine sahip anonim bir kayıt oluşturmak bu kimliği oluşturmaz.

Farklı Dataverse tablolarındaki kayıtları tarafından Dataverse.Unmaskkullanılan kayıt değişkenine atamayın. Böyle bir değişken birden çok kaynakla ilişkilendirilir ve tablolarda eşleşen adlara sahip güvenli sütunlar olsa bile reddedilir. Ayrı tek kaynak değişkenleri veya çağrıları kullanın.

Hedef sütunun güvenliği sağlanmalıdır ve desteklenen bir skaler türe sahip olmalıdır. Arama değerli, kayıt, tablo, dosya, görüntü ve yazılmamış sütunlar desteklenmemektedir. Bir arama aracılığıyla kayıt okumak, arama değerli sütunun maskesini kaldırmaktan farklıdır. Desteklenen maskeleme senaryoları için maskeleme kuralı belgelerine bakın; formül türü kabulü, bir maskeleme kuralının bir sütun için yapılandırılabildiğini belirlemez.

Değer ve hatalar döndürme

Sonuç, hedef sütunla aynı Power Fx türüne sahiptir. Örneğin, metin sütunu metin içeren bir kayıt değil metin döndürür.

Başarısız okumaları işlemek için IfError kullanın. Dataverse, erişim kısıtlandığında yanıtı belirler; her izin reddinin bir HTTP hatası ürettiğini varsaymayın.

Durum Behavior
Kaydın ilişkili Dataverse kaynağı yok veya birden çok Dataverse kaynağı var. Power Apps Studio kayıt bağımsız değişkenini reddeder.
Sütun bilinmiyor, güvenli değil veya desteklenmeyen bir türe sahip. Power Apps Studio sütun bağımsız değişkenini reddeder.
Boş olmayan bir kaydın çalışma zamanında geçerli bir kimliği yoktur veya Dataverse kaynağı çözümlenemez. İşlev, geçersiz kayıt hatası döndürür.
Dataverse isteği başarısız oluyor. İşlev, IfError ile işleyebileceğiniz bir Power Fx hatası döndürür.
Başarılı bir istek satır döndürmez, istenen sütunu atlar veya null değer döndürür. Sonuç boş olur.

Boş bir sonuç tek başına bir izin sorununu tanımlamaz. Boş bir sonucu hata olarak ele almadan önce seçili kaydı, değerini ve kullanıcının erişimini denetleyin.

Examples

Bu örneklerde, adlı 'Sensitive reference'güvenli bir metin sütunu ile açıklayıcı Customers bir Dataverse tablosu kullanılır. Tabloyu veri kaynağı olarak ekleyin, maskeleme kuralı yapılandırın ve uygun izinlere sahip bir test kullanıcısı ile yapay kayıtlar kullanın. Tablo ve sütun adlarını kendi adlarınızla değiştirin.

Seçili kaydı okuma

Galerinin Items özelliğini olarak Customersayarlayın. Kaydedilmiş bir kayıt seçili durumdayken, bu formül maskelenmemiş başvurusunu istemektedir:

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

Depolanan değer ise "REF-12345" ve kullanıcının maskesini kaldırma izni varsa, beklenen sonuç metnidir "REF-12345". Formül, aracılığıyla Gallery1.Selected.'Sensitive reference'okunan maskelenmiş değeri değiştirmez.

Metin sonucu için hata işleme

Maskelenmemiş değeri görüntülemek istediğiniz metin etiketinin Text özelliğinde aşağıdaki formülü kullanın:

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

Değiştirme değeri metindir çünkü 'Sensitive reference' bir metin sütunudur. Desteklenen farklı bir sütun türü için, uyumlu bir değiştirme değeri kullanın veya kısa mesaj döndürmeden önce sonucu dönüştürün. Hata işleniyorsa, boş sonuçlar başarılı olmaz.

Tam bir gösterme ve gizleme etkileşimi için bkz. Maskelenmiş Dataverse sütun değerini gösterme.

Veri işleme

Yinelenen değerlendirmeler, yeni ağ istekleri yapmak yerine önbelleğe alınan sonuçları yeniden kullanabilir. Yakın zamanda değiştirilen izinleri yeniden denetlemek için başka bir değerlendirmeye güvenmeyin. Denetimi gizlemek yetkilendirme sınırı değildir ve önbelleğe alınmış değerleri temizlemez.

SaveData ile maskelenmemiş değerleri kalıcı hale getirmayın, günlüklere yazmayın veya daha az korumalı bir veri kaynağına kopyalayın. Ekran görüntülerinde veya tanılama eklerinde maskelenmemiş verileri açığa çıkarmaktan kaçının.

  • Son güncelleştirme: