Liste görünümlerinde değerlerin yanı sıra özel simgeleri görüntüleme
Power Apps ortamı yöneticileri ve özelleştiriciler, bir görünüme grafik ekleyebilir ve JavaScript'i kullanarak bir grafiği sütun değerine göre seçmek için kullanılan mantığı oluşturabilir. Yetenek, metnin veya sayısal değerlerin yanı sıra simgeleri görüntüleyen liste görünümlerini özelleştirmenizi sağlar.
Bu örnek, Dynamics 365 Sales gibi belirli uygulamalarla kullanılabilen fırsat tablosu için bir görünümde özel simgeler görüntüler. Özel simgeleri, firma veya ilgili kişi tablosu gibi diğer standart tablolarda ya da özel tablolarda görünümlerde görüntüleyebilirsiniz.
Liste görünümlerindeki özel simgeler Birleşik Arabirim, eski web istemcisi, mobil uygulama ve App for Outlook'ta görüntülenebilir.
Not
Uygulama mobile offline modundayken özel simgeler kullanılamaz.
Web kaynakları olarak özel grafikler ve JavaScript ekleme
Özelleştirmeniz için gereken yeni grafik dosyalarını oluşturun. 16x16 piksel simge boyutunu öneririz (büyük resimler aşağı doğru ölçeklendirilir).
Hangi simgelerin hangi değerleri göstereceğini oluşturan bir veya daha fazla JavaScript işlevi yazın (genellikle özelleştirmek istediğiniz her sütun için bir işleve ihtiyaç duyarsınız). Her işlev girdi olarak bir satır veri nesnesi ve bir dil (LCID) kodu kabul etmeli ve görüntü adını ve araç ipucu metnini içeren bir diziye dönmelidir. Örnek bir işlev için bu makalenin ileriki bölümünde bkz. Örnek JavaScript işlevi.
Ortamınızda bir yönetici olarak oturum açın ve çözüm gezginini açın.
Varsayılan Çözüm açılır penceresi belirir. Buradan, Bileşenler > Web Kaynakları'na gidin.
Şimdi, her defasında bir özel grafiği web kaynağı olarak karşıya yükleyebilirsiniz. Yeni bir web kaynağı oluşturmak için Yeni düğmesini seçin. Kaynağı oluşturmanıza yardımcı olmak için başka bir açılır pencere açılır. Buradaki adımları izleyin:
Yeni kaynağa anlamlı bir Ad verin. Bu, JavaScript kodunuzdan her bir grafiğe başvurmanız için kullanacağınız addır.
Grafik dosyanızı (PNG, JPEG, veya GIF) kaydetmek amacıyla kullandığınız grafik biçimini Tür olarak ayarlayın.
Tarayıcı penceresini açmak için Dosya Seç öğesini seçin. Grafik dosyanızı bulmak ve seçmek için kullanın.
İsterseniz bir Görünen Ad ve/veya Açıklama ekleyin.
Kaydet'i seçin ve ardından Web Kaynağı penceresini kapatın.
Sahip olduğunuz her grafik dosyası için önceki adımı tekrarlayın.
Şimdi, son web kaynağı olarak JavaScript'inizi ekleyin. Yeni bir web kaynağı oluşturmak için araç çubuğunda Yeni öğesini seçin. Kaynağı oluşturmanıza yardımcı olmak için başka bir açılır pencere açılır. Aşağıdakileri yapın:
Yeni kaynağa anlamlı bir Ad verin.
Tür'ü Komut Dosyası (JScript) olarak ayarlayın.
Metin düzenleyicisi penceresini açmak için Metin Düzenleyicisi'ni (Tür ayarının yanında) seçin. JavaScript kodunuzu buraya yapıştırın ve kaydetmek için Tamam'ı seçin.
İsterseniz bir Görünen Ad ve/veya Açıklama ekleyin.
Kaydet'i seçin ve ardından Web Kaynağı penceresini kapatın.
Varsayılan Çözüm açılır penceresi hala açıkken Bileşenler > Tablolar ağacını genişletin ve özelleştirmek istediğiniz tabloyu bulun.
Tablonuzu genişletin ve Görünümler simgesini seçin.
Şimdi de seçtiğiniz tablo için görünümler listesini görürsünüz. Listeden bir görünüm seçin. Sonra araç çubuğundaki Diğer Eylemler açılan listesini açın ve Düzenle'yi seçin.
Seçilen görünümünüzü düzenlemek için denetimlerle bir açılır pencere belirir. Görünümün bir parçası olan her bir sütunu gösterir. Hedef sütunu seçin ve ardından Ortak Görevler kutusunda Özellikleri Değiştir öğesini seçin. Sütun Özelliklerini Değiştir iletişim kutusu açılır, burada şu ayarları yapın:
Web Kaynağı: JavaScript işlevlerinizi tutmak için oluşturduğunuz web kaynağının adını belirtin (listeden seçmek için Gözat öğesini seçin).
Fonksiyon Adı: Seçilen sütunu ve görünümü değiştirmek için yazdığınız işlevin adını yazın.
Tamam'ı seçerek Sütun Özelliklerini Değiştir iletişimini kapatın.
Görünümünüzü kaydetmek için Kaydet ve Kapat'ı seçin.
Gerektiğinde her bir tablo, görünüm ve sütun için bu adımları yineleyin.
Hazır olduğunuzda, değişikliklerinizi yayımlamak için Tüm Özelleştirmeleri Yayımla'yı seçin. Ardından, Varsayılan Çözüm penceresini kapatın.
Örnek JavaScript işlevi
Özel simgeleri ve araç ipuçlarını görüntüleyen JavaScript işlevinden şu iki diyalog beklenir: layoutxml öğesinde belirtilen tüm satır nesnesi ve çağıran kullanıcının Yerel Kimliği (LCID). LCID parametresi araç ipucu metnini birden çok dilde belirtmenizi sağlar. Ortam tarafından desteklenen diller hakkında daha fazla bilgi için bkz. Dilleri etkinleştirme ve Dil paketlerini yükleme veya yükseltme. Kodunuzda kullanabileceğiniz yerel kimlik (LCID) değerlerinin listesi için bkz. Microsoft Tarafından atanan Yerel Kimlikler.
Önceden tanımlanmış sınırlı sayıda seçenekleri olan bir özniteliğin seçenek ayar türü için özel simgeler ekleyeceğinizi varsayarsak, yerelleştirme sorunlarını önlemek için etiket yerine seçeneklerin tam sayı değerini kullandığınızdan emin olun.
Not: Simgeyi belirlemek için veri almanız gerekiyorsa, Birleşik Arabirim boole değerine çözümlenen (şerit kurallarına benzer şekilde) bir JavaScript Promise nesnesini döndürmeyi destekler. Özel işlevinizde zaman uyumlu XMLHttpRequest (XHR) kullanmayın.
Aşağıdaki örnek kod, opportunityratingcode (Derecelendirme) özniteliği içinde simgeleri ve araç ipuçlarını üç değerden birine (1: Sıcak, 2: Ilık, 3: Soğuk) göre görüntüler. Örnek kod ayrıca yerelleştirilmiş araç ipucu metninin nasıl görüntülendiğini gösterir. Bu örnek ile çalışmak için 16x16 görüntülerle üç web kaynağını şu adlarda oluşturmanız gerekir: new_Hot, new_Warm ve new_Cold.
Önemli
Bu örnek için Dynamics 365 Sales uygulamasıyla kullanılabilen fırsat tablosu gerekir.
function displayIconTooltip(rowData, userLCID) {
var str = JSON.parse(rowData);
var coldata = str.opportunityratingcode_Value;
var imgName = "";
var tooltip = "";
switch (parseInt(coldata,10)) {
case 1:
imgName = "new_Hot";
switch (userLCID) {
case 1036:
tooltip = "French: Opportunity is Hot";
break;
default:
tooltip = "Opportunity is Hot";
break;
}
break;
case 2:
imgName = "new_Warm";
switch (userLCID) {
case 1036:
tooltip = "French: Opportunity is Warm";
break;
default:
tooltip = "Opportunity is Warm";
break;
}
break;
case 3:
imgName = "new_Cold";
switch (userLCID) {
case 1036:
tooltip = "French: Opportunity is Cold";
break;
default:
tooltip = "Opportunity is Cold";
break;
}
break;
default:
imgName = "";
tooltip = "";
break;
}
var resultarray = [imgName, tooltip];
return resultarray;
}
Özel simge görünümü görüntüleme davranışı
Birincil sütun
Kılavuz listesi görünümünde, tablonun birincil sütununa uygulanan özel simgeler, sistem tarafından oluşturulan varsayılan simgenin yerini alır.
Diğer sütunlar
Kılavuz listesi görünümünde, tablonun birincil sütunu olmayan bir sütuna uygulanan özel simgeler, sistem tarafından oluşturulan varsayılan simgenin yanı sıra ikincil simge olarak görüntülenir.
Kart formları
Özel simgeler, görünüm bir kart formu kullanmak üzere yapılandırıldığında varsayılan olarak sistem tarafından oluşturulan simgenin yerini alır.
Ayrıca bkz.
Model yönetimli uygulama görünümlerini anlama
Not
Belge dili tercihlerinizi bizimle paylaşabilir misiniz? Kısa bir ankete katılın. (lütfen bu anketin İngilizce olduğunu unutmayın)
Anket yaklaşık yedi dakika sürecektir. Kişisel veri toplanmaz (gizlilik bildirimi).