DataSourceInfo işlevi
Şunlar için geçerlidir:
Tuval uygulamaları Model temelli 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 veri kaynağı herhangi bir 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 Microsoft Lists'te desteklenmemektedir.
Açıklama
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, 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, Bilgi, 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 için, dize olarak sütun adı. Phone sütunu, çift tırnak işaretleri ile birlikte "Phone" olarak geçirilir. Veri kaynağı düzeyinde bilgi için ColumnName bağımsız değişkeni kullanılamaz.
Not
Boşluklu sütun adları içeren SharePoint ve Excel veri kaynakları için her bir boşluğu "_x0020_" olarak belirtin. Örneğin, "Sütun Adı" öğesini "Sütun_x0020_Adı" olarak belirtin.
Ö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( IceCream, DataSourceInfo.DisplayName, "Quantity" ) | IceCream veri kaynağının Quantity sütunu için görünen adı döndürür. | "Quantity on Hand" |
| DataSourceInfo( IceCream, DataSourceInfo.MaxLength, "Flavor" ) | IceCream veri kaynağının Flavor sütunu için maksimum dize uzunluğunu döndürür. | 30 |
| DataSourceInfo( IceCream, DataSourceInfo.Required, "Flavor" ) | IceCream veri kaynağının Flavor sütunu gerekli midir? | true |
| DataSourceInfo( IceCream, DataSourceInfo.Required, "Quantity" ) | IceCream veri kaynağının Quantity sütunu gerekli midir? | false |
| DataSourceInfo( IceCream, DataSourceInfo.MaxValue, "Quantity" ) | IceCream veri kaynağının Quantity sütunu için maksimum sayısal değeri döndürür. | 100 |
| DataSourceInfo( IceCream, DataSourceInfo.MinValue, "Quantity" ) | IceCream veri kaynağının Quantity sütunu için minimum sayısal değeri döndürür. | 0 |
| DataSourceInfo( IceCream, DataSourceInfo.ReadPermission) | Geçerli kullanıcı, IceCream veri kaynağındaki kayıtları okuyabilir mi? | true |
| DataSourceInfo( IceCream, DataSourceInfo.EditPermission) | Geçerli kullanıcı, IceCream veri kaynağındaki kayıtları düzenleyebilir mi? | true |
| DataSourceInfo( IceCream, DataSourceInfo.CreatePermission) | Geçerli kullanıcı, IceCream veri kaynağında kayıt oluşturabilir mi? | false |
| DataSourceInfo( IceCream, DataSourceInfo.DeletePermission) | Geçerli kullanıcı, IceCream veri kaynağındaki kayıtları silebilir mi? | false |