DataSourceInfo işlevi

Şunlar için geçerlidir: Tuval uygulamaları Model yönetimli uygulamalar

Bir veri kaynağı hakkında bilgi döndürür.

Genel bakış

Veri kaynakları, kullanıcı deneyimini iyileştirmek için zengin ölçüde bilgi sağlayabilir.

Patch işlevini kullanmadan önce kullanıcı girişini doğrulamak ve kullanıcıya anında geri bildirim sağlamak için sütun düzeyinde bilgileri kullanabilirsiniz. Validate işlevi bu bilgilerin aynısını kullanır.

Örneğin, kayıtları düzenleme ve oluşturma izni olmayan kullanıcılar için Düzenle ve Yeni düğmelerini devre dışı bırakmak veya gizlemek için veri kaynağı düzeyinde bilgileri kullanabilirsiniz.

Veri kaynakları, sağladıkları bilgi miktarı açısından değişiklik gösterir. Hiç veri sağlamayan veri kaynakları da mevcuttur. Koleksiyonlar bilgi sağlamaz. Bir bilgi sağlanmadıysa varsayılan kullanılır veya boş değer döndürülür.

Not

Şu anda, DataSourceInfo işlevi Listeler'de Microsoft desteklenmemektedir.

Description

Sütun bilgileri

Bir veri kaynağının belirli bir sütunuyla ilgili bilgileri almak için DataSourceInfo'yu kullanabilirsiniz:

Bilgi Bağımsız Değişkeni	Sonuç Türü	Açıklama
DataSourceInfo.DisplayName	Dize	Sütunun görünen adı. Bir görünen ad tanımlanmadıysa sütun adını döndürür.
DataSourceInfo.MaxLength	Numara	Sütunun içerebileceği maksimum karakter sayısı. Yalnızca dize içeren sütunlar için geçerlidir. Maksimum değer ayarlanmadıysa boş değer döndürülür.
DataSourceInfo.MaxValue	Numara	Bir sütunun içerebileceği maksimum sayısal değer. Yalnızca sayı içeren sütunlar için geçerlidir. Maksimum değer ayarlanmadıysa boş değer döndürülür.
DataSourceInfo.MinValue	Numara	Bir sütunun içerebileceği minimum sayısal değer. Yalnızca sayı içeren sütunlar için geçerlidir. Minimum değer ayarlanmadıysa boş değer döndürülür.
DataSourceInfo.Required	Boole	Bu sütun için bir değer gerekir mi? Veri kaynağı tarafından ayarlanmadıysa false değerini döndürür.

Üçüncü bağımsız değişken bir sütunun dize olarak adıdır. Örneğin, People koleksiyonundaki Phone sütunu, çift tırnak işaretleri ile birlikte "Phone" olarak geçirilir.

Veri kaynağı bilgileri

Bir veri kaynağının bilgilerini bütün olarak almak için DataSourceInfo öğesini de kullanabilirsiniz:

Bilgi Bağımsız Değişkeni	Sonuç Türü	Açıklama
DataSourceInfo.AllowedValues	Boole	Kullanıcılara bu veri kaynağı için hangi tür izinler verilebilir? Veri kaynağı tarafından ayarlanmadıysa boş değer döndürür.
DataSourceInfo.CreatePermission	Boole	Geçerli kullanıcının bu veri kaynağında kayıt oluşturma izni var mı? Veri kaynağı tarafından ayarlanmadıysa true değerini döndürür.
DataSourceInfo.DeletePermission	Boole	Geçerli kullanıcının bu veri kaynağındaki kayıtları silme izni var mı? Veri kaynağı tarafından ayarlanmadıysa true değerini döndürür.
DataSourceInfo.EditPermission	Boole	Geçerli kullanıcının bu veri kaynağındaki kayıtları düzenleme izni var mı? Veri kaynağı tarafından ayarlanmadıysa true değerini döndürür.
DataSourceInfo.ReadPermission	Boole	Geçerli kullanıcının bu veri kaynağındaki kayıtları okuma izni var mı? Veri kaynağı tarafından ayarlanmadıysa doğru değerini döndürür.

Not

DataSourceInfo , geçerli kullanıcının istenen izne sahip olup olmadığını belirleyemezse true değerini döndürür . Gerçek işlem gerçekleştirildiğinde izinler sunucu tarafından yeniden denetlenir ve izin verilmiyorsa bir hata gösterilir. Şu anda, DataSourceInfo işleviyle ile izin denetimi yalnızca Microsoft Dataverse kullanıldığında mümkündür.

Sözdizimi

DataSourceInfo( DataSource,Information [, ColumnName] )

• DataSource – Gerekli. Kullanılacak veri kaynağı.
• Bilgi - Gerekli. Almak istediğiniz bilgi türü.
• ColumnName – İsteğe bağlı. Sütun düzeyinde bilgi alınabilecek sütun adı. Veri kaynağı düzeyinde bilgi için ColumnName bağımsız değişkeni kullanılamaz.

Not

3.24042 sürümünden önce Power Apps'te, sütun adları çift tırnak kullanılarak metin dizesiyle belirtilirdi ve bir veri kaynağına bağlıysa bunların ayrıca mantıksal adlar olması da gerekiyordu. Örneğin, çift tırnaklı "cr43e_name" mantıksal adı, tırnaklar olmadan Ad görünen adının yerine kullanılıyordu. Boşluklar bulunan sütun adlarını içeren SharePoint ve Excel veri kaynakları için her boşluk, "_x0020_" ile belirtilirdi: Örneğin, "Sütun Adı", "Sütun_x0020_Adı" olarak. Bu sürümden sonra tüm uygulamalar bu makalede açıklanan yeni sözdizimi şeklinde otomatik olarak güncelleştirildi.

Örnekler

Bu bölümdeki örneklerde IceCream adlı bu veri kaynağı kullanılmıştır:

Veri kaynağı şu bilgileri de sağlamaktadır:

• Quantity için görünen ad, "Quantity on Hand"dir.
• Flavor için maksimum uzunluk 30 karakterdir.
• Flavor sütunu bir değer içermelidir. Quantity sütunu gerekli değildir.
• Minimum Quantity değeri 0'dır.
• Maksimum Quantity değeri 100'dür.
• Geçerli kullanıcı, IceCream veri kaynağının kayıtlarını okuyabilir ve düzenleyebilir ancak kayıt oluşturamaz veya silemez.

Formül	Açıklama	Sonuç
DataSourceInfo( Dondurma, DataSourceInfo.DisplayName, Miktar )	IceCream veri kaynağının Quantity sütunu için görünen adı döndürür.	"Quantity on Hand"
DataSourceInfo( Dondurma, DataSourceInfo.MaxLength, Lezzet )	IceCream veri kaynağının Flavor sütunu için maksimum dize uzunluğunu döndürür.	30
DataSourceInfo( Dondurma, DataSourceInfo.Required, Lezzet )	IceCream veri kaynağının Flavor sütunu gerekli midir?	doğru
DataSourceInfo( Dondurma, DataSourceInfo.Required, Miktar )	IceCream veri kaynağının Quantity sütunu gerekli midir?	YANLIŞ
DataSourceInfo( Dondurma, DataSourceInfo.MaxValue, Miktar )	IceCream veri kaynağının Quantity sütunu için maksimum sayısal değeri döndürür.	Kategori 100
DataSourceInfo( Dondurma, DataSourceInfo.MinValue, Miktar )	IceCream veri kaynağının Quantity sütunu için minimum sayısal değeri döndürür.	0
DataSourceInfo( Dondurma, DataSourceInfo.ReadPermission)	Geçerli kullanıcı, IceCream veri kaynağındaki kayıtları okuyabilir mi?	doğru
DataSourceInfo( Dondurma, DataSourceInfo.EditPermission)	Geçerli kullanıcı, IceCream veri kaynağındaki kayıtları düzenleyebilir mi?	doğru
DataSourceInfo( Dondurma, DataSourceInfo.CreatePermission)	Geçerli kullanıcı, IceCream veri kaynağında kayıt oluşturabilir mi?	YANLIŞ
DataSourceInfo( Dondurma, DataSourceInfo.DeletePermission)	Geçerli kullanıcı, IceCream veri kaynağındaki kayıtları silebilir mi?	YANLIŞ