Listeler hakkında

Liste, bir geliştiricinin portalda tabloları ortaya çıkarmasına gerek kalmadan bir kayıt listesi işleyecek bir web sayfasını eklemek için kullandığınız veri odaklı bir yapılandırmadır. Listeleri kullanarak, kayıtları portal üzerinde görüntülenmek üzere açığa çıkartabilirsiniz.

Izgara sıralamayı destekler ve kayıtların sayısı, belirtilen sayfa boyutundan daha büyük ise sayfalandırılır. Ayrıntılar Görünümü Web Sayfası belirtilmişse her kayıt sayfaya bir bağlantı içerir ve kaydın kimliği, Kimlik Sorgu Dizesi Parametre Adı ile birlikte sorgu dizesine eklenir. Liste birden çok görünümü de destekler. Birden fazla görünüm belirtilmişse kullanıcının çeşitli görünümler arasında geçiş yapmasına izin vermek için açılan liste oluşturulur.

Veriler geçerli portal kullanıcısı, geçerli portal kullanıcısının ana Müşteri firması ve geçerli portal web sitesi tarafından filtrelenebilir. Portal Kullanıcısı Özniteliği ve Firma Özniteliği filtre koşulları için bir değer mevcutsa portal kullanıcının kendi (Benim) verilerini veya kendi ana Müşteri hesabının verilerini görüntülemesi için açılan liste işler.

Portalınıza bir liste ekleme

Liste, portal içerisindeki kayıtların listesinin başlatılmasını denetlemek için web sayfalarına olan ilişkileri ve çeşitli özellikleri içerir. Web sayfası ilişkisi, web sitesi içinde belirli bir sayfa düğümü için liste tanımının dinamik olarak çekilmesine izin verir. Mevcut Tablo görünümlerini görüntülemek veya yeni Tablo görünümlerini oluşturmak için Portallar > Listeler'e gidin.

Liste ile ilişkilendirilmiş web sayfaları sol taraftaki menüden İlgili gezinti bağlantılarında listelenen Web Sayfaları bağlantısı seçilerek görüntülenebilir. Listenizi oluştururken ilk adım, portal üzerinde bir liste oluşturmak istediğiniz tabloyu seçmektir. Ardından işlemek için bir veya daha fazla model yönetimli uygulama görünümü seçersiniz.

Bir web sayfasını oluştururken veya düzenlerken, Web Sayfası formunda sağlanan arama alanında bir liste belirtebilirsiniz. Sayfa şablonu genelde Sayfa şablonu olacaktır ancak ana şablonlar listenin oluşturulmasının gerekli olup olmadığını belirlemek için ihtiyaç duyulan mantığı içerdiğinden içerik için tasarlanmış çeşitli diğer şablonlardan biri de olabilir.

Liste öznitelikleri ve ilişkiler

Özel JavaScript ekleme

Formdaki Seçenekler sekmesi özel JavaScript girebileceğiniz bir metin alanı içerir; sayfanız jQuery kitaplığı içeriyorsa onu burada da kullanabilirsiniz. Komut dosyası bloğu, sayfanın sonuna, sayfa kapanış formu etiketinden hemen önce yerleştirilecektir.

Liste verilerini zaman uyumsuz olarak alır ve tamamlandığında bir loaded olayı tetikler, özel JavaScript bunu dinler ve ızgaradaki öğelerle bir şeyler yapar. Aşağıdaki kod küçük bir örnektir:

$(document).ready(function (){
$(".entitylist.entity-grid").on("loaded", function () {
$(this).children(".view-grid").find("tr").each(function (){
// do something with each row
$(this).css("background-color", "yellow");
});
});
}); 

Belirli bir öznitelik alanı bulun ve büyük olasılıkla işleme değerini değiştirmek için onun değerini alın. Aşağıdaki kod, accountnumber özniteliği değeri içeren her tablo hücresini alır. accountnumber değerini tablonuz ve görünümünüz için uygun olan öznitelikle değiştirin.

$(document).ready(function (){
   $(".entitylist.entity-grid").on("loaded", function () {
      $(this).children(".view-grid").find("td[data-attribute='accountnumber']").each(function (i, e){
         var value = $(this).data(value);
         // now that you have the value you can do something to the value
      });
   });
});

Liste yapılandırması

Bir listedeki kayıtlar için (Oluştur, Düzenle, Sil vb.) eylemleri kolayca etkinleştirebilir ve yapılandırabilirsiniz. Ayrıca varsayılan etiketleri, boyutları ve diğer öznitelikleri geçersiz kılmak mümkündür, böylece liste tam olarak istediğiniz şekilde görüntülenir.

Bu ayarlar liste formunun Yapılandırma bölümünde bulunur. Varsayılan olarak, yalnızca Temel Ayarlar gösterilir. Ek ayarları görmek için Gelişmiş Ayarlar'ı seçin.

Öznitelikler

Genel eylem ayarları

Genel olarak, Tablo eylemlerinin yapılandırılabilir ayarları vardır. Tüm durumlarda, bu özelleştirme açısından daha fazla seçenek vermek içindir ve alanlar gerekli değildir. Yalnızca eylemi eklemek, uygun ayrıcalığın Tablo İzinleri tarafından sağlanmış olması koşuluyla eylemin portal üzerine alınmasına olanak tanır.

Genellikle, yalnızca Onay Gerekli seçeneğini belirlemeniz durumunda görüntülenecek olan ilgili iletişim kutusunu her eylem için yapılandırabilirsiniz.

Genel iletişim kutusu gelişmiş ayarları

Oluştur eylemi ayarları

Eylem Oluşturma'yı etkinleştirmek liste üzerinde bir düğme oluşturur; seçildiğinde kullanıcıya Tablo İzinleri tarafından Oluştur ayrıcalığı verilmiş olması durumunda yeni bir kayıt oluşturmak için kullanılabilecek temel formun bulunduğu bir iletişim kutusu açılır.

Form Oluştur iletişim kutusu gelişmiş ayarları

İndirme eylemi ayarları

Bir İndir Eylemi'ni etkinleştirmek, liste seçildiğinde bir Excel (.xlsx) dosyasına listeden verileri yükleyen bir düğme oluşturur.

Ayrıntılar eylemi ayarları

Bir Ayrıntılar Eylemi'ni etkinleştirmek, kullanıcıya listede seçili satırın salt okunur temel formu görüntüleme olanağı sağlar.

Ayrıntılar iletişim kutusu gelişmiş ayarları

Düzenleme eylemi ayarları

Bir Düzenle Eylemi'ni etkinleştirmek, Tablo İzinleri tarafından Yazma ayrıcalığı verilmiş olması koşuluyla kullanıcıya varlık listesindeki seçili satırın kayıt verilerine bağlı olan düzenlenebilir bir temel formu görüntüleme olanağı tanır.

Düzenleme formu iletişim kutusu gelişmiş ayarları

Silme eylemi ayarları

Bir Silme Eylemi'ni etkinleştirmek, Tablo İzinleri tarafından Silme ayrıcalığı verilmiş olması koşuluyla kullanıcıya listedeki seçili satırın kaydını kalıcı olarak silme olanağı tanır.

Silme iletişim kutusu (gelişmiş) ayarları

İş akışı eylemi ayarları

Bir İş Akışı eylemi'ni etkinleştirmek, bir kullanıcının listedeki seçili satırın kaydında isteğe bağlı bir iş akışı çalıştırmasına izin verir. Listeye istenilen sayıda İş Akışı eylemi ekleyebilirsiniz.

Listelerin güvenliğini sağlama

Bir listeyi güvence altına almak için, kayıtların görüntülendiği tablonun Tablo İzinlerini yapılandırmanız ve ayrıca Tablo İzinlerini Etkinleştir ayarını seçmek için onay kutusunu seçmeniz gerekir. Bunu yapmazsanız, aşağıdaki uyarıyı görürsünüz:

"Bu kayıt için tablo izinleri etkinleştirilmelidir yoksa internetteki herhangi bir kişi verileri görebilir."

Liste güvenliğini sağlama işlemi sayfaya erişen her kullanıcı için yalnızca izin verilmiş kayıtların gösterilmesini sağlar. Bu, liste aracılığıyla sunulan model yönetimli uygulama görünümlerine ek filtre eklenerek sağlanır. Bu filtre, Okuma izni aracılığıyla, yalnızca kullanıcının erişebileceği kayıtları filtreler.

Ayrıca, liste için tanımlanan herhangi bir eylem, bu eylem için kayıt başına temelinde ilgili izinlere uyar. Diğer bir deyişle, bir kayıt için Düzenleme eyleminiz varsa Düzenleme eylemi o kayıt için etkinleştirilir. Sil, Oluştur, vb için de aynı durum geçerlidir. Hiç kullanılabilir kayıt yoksa, liste yüklendiğinde bunu belirten bir ileti gösterilir.

Ancak iyi bir web sitesi tasarımı kullanıcının tablo için izni bulunan bir role sahip olup olmadığını (herhangi bir kaydı görmek zorunda olduğu bir durum olmayacaktır), sayfaya hiçbir şekilde erişimi olmamasını gerektirir. İdeal olarak, sayfa Web Sayfası Erişim İzinleri kullanılarak korunmalıdır.

Tablo İzinlerini Etkinleştir'i seçerek bir listeyi güvence altına aldıysanız ve oturum açmış olan kullanıcı için geçerli kayıt düzeyi eylemlerini görüntülemek istiyorsanız EntityList/ShowRecordLevelActions site ayarını doğru olarak ayarlamanız gerekir. Örneğin, Preston ve Teddy olmak üzere iki kullanıcı vardır. Preston Servis Talebi tablosunda kişi düzeyinde tüm erişime, Teddy genel okuma erişimine sahiptir. Tüm servis talebi kayıtlarını göstermek için bir liste oluşturulmuşsa Preston onun ilgili kişisiyle ilgili kayıtlardaki tüm eylemleri (Görüntüleme, Düzenleme ve Silme) görür. Diğer kayıtlarda ise yalnızca Görünüm eylemini görür. Diğer taraftan, Teddy yalnızca tüm kayıtlarda görüntüleme eylemini görür.

Entitylist/ShowRecordLevelActions site ayarı yanlış değerine ayarlanmışsa ve tabloda birden fazla izin varsa tüm kayıt düzeyi eylemleri görünür. Ancak bir kullanıcı, yetkisi olmayan bir eylemi gerçekleştirmeye çalıştığında bir hata görüntülenir.

Görünüm ayrıntılar sayfası ekleme

Bir web sayfasını, Ayrıntılar Görünümü Web Sayfası araması için ayarlayarak, ızgarada listelenen bir kaydın ayrıntıları, ilgili formun veya sayfanın yapılandırmasına bağlı olarak, salt okunur veya düzenlendi olarak görüntülenebilir.

Bu sayfa, Liquid kullanılarak oluşturulmuş, tamamen özelleştirilmiş bir sayfa olabilir. Büyük olasılıkla en yaygın senaryo ayrıntılar sayfasının bir temel form veya Gelişmiş form içeren bir web sayfası olmasıdır.

Dikkat edilmesi gereken önemli nokta, ızgarada listelenen her kaydın ayrıntılar sayfasına bir köprü bağlantısı olması ve bağlantının kaydın kimliğiyle adlandırılmış bir Sorgu Dizesi parametresi içermesidir. Sorgu Dizesi parametresinin adı, listede belirtilen Kimlik Sorgu Dizesi Parametre Adına bağlıdır. Dikkat edilmesi gereken en son nokta, hedeflenen ayrıntılar web sayfasının, sorgulamak ve verilerini yüklemek için gerekli olan kayıt kimliğini almak üzere Sorgu Dizesi parametresinin adını bilmesidir.

Ayrıntıları görüntülemek için temel formu kullanma

Bir temel form oluşturmak için temel form sayfasında bulunan yönergelere bakın.

Listedeki kaydın temel forma yüklenmesini sağlamak için bilinmesini gereken önemli ayarlar:

Temel Formdaki Kayıt Kimliği Parametresinin Adı Listedeki Kimlik Sorgu Dizesi Parametresi Adıyla eşleşmelidir.

Mod gereksinimlerinize göre Düzenle veya Salt Okunur olabilir.

Ayrıntıları görüntülemek için gelişmiş formu kullanma

Listedeki kaydın Gelişmiş forma yüklenmesini sağlamak için bilinmesini gereken önemli ayarlar:

Gelişmiş Form Adımındaki Birincil Anahtar Sorgu Dizesi Parametresinin Adı Listedeki Kimlik Sorgu Dizesi Parametresi Adıyla eşleşmelidir.

Mod gereksinimlerinize göre Düzenle veya Salt Okunur olabilir.

Oluştur işlevi için ayrıntılar sayfası kullanma

Bir özel sayfa, temel form veya Gelişmiş formu Oluştur işleviyle aynı şekilde kullanabilirsiniz. Bu formda bir Oluştur eylemi tanımlamak için alternatif bir yoldur. Oluştur için aynı anda Oluştur eylemi ve özel sayfa tanımlayamazsınız: özel eylem tanımlamak önceliklidir.

Listede Oluştur Aramasına bir web sayfası atarsanız ve Yapılandırmayı kullanarak bir Oluştur eylemi belirtmezseniz, listede kullanıcıyı Oluştur için belirlediğiniz özel sayfaya bağlayan bir Oluştur düğmesi oluşturulur.

Liste filtresi yapılandırması

Listeye kayıtları filtreleme özelliği eklemek kolaydır: Filtreleme seçeneğini etkinleştirmeniz ve kullanıcılara görüntülenecek bir veya daha fazla filtre türü seçmeniz yeterlidir. Kullanıcı tarafından sağlanan metinle eşleşen bir öznitelik tarafından filtreleme yapmak veya bir dizi seçenek arasından seçim yapmak mümkündür. Hatta aklınıza gelebilecek hemen hemen her türlü filtreyi Gelişmiş Bul'u kullanarak tasarlayabilirsiniz.

Liste filtresini etkinleştirme

Meta Veriler Filtresi bölümünde Etkin onay kutusunu seçin. Görüntülendiğinde Filtre alanını listeye ekleyecektir. Siz En az bir filtre türü tanımlayıncaya kadar kutu boş olarak görüntülenir.

Yönlendirme ayarını kullanarak listedeki Filtre alanının nasıl oluşturulacağını belirleyebilirsiniz. Varsayılan olarak, Yatay Filtre alanını listenin üstünde oluşturur. Dikey yönlendirme, Filtre alanını listenin soluna bir kutu olarak ekler.

Filtre türleri

Metin filtresi

Metin filtresi, listenin Filtre alanına listenin tablo türünün özniteliğine bağlanan bir metin kutusu ekler. Bir kullanıcı filtreyi uyguladığında, liste yalnızca seçilen özniteliği değeri içeren kayıtları görüntüler.

Metin filtresi eklemek için +Metin Filtresi'ni seçin.

Metin filtresi aşağıdaki öznitelikleri kullanır:

Öznitelik Filtre Kümesi

Öznitelik Filtre Kümesi, listeye filtre uygulamak için listenin seçili tablo türünün tek bir özniteliğine bağlanan bir dizi seçenek ekler. Bir kullanıcı filtreyi uyguladığında, liste yalnızca belirlenen seçeneklerden en az biriyle tam olarak eşleşen kayıtları görüntüler.

Öznitelik Filtre Kümesi aşağıdaki öznitelikleri kullanır:

Öznitelik Filtre Kümesi seçenekleri

Öznitelik Filtre Kümesinde, seçim listesi ve Boole öznitelikleri hariç, istenilen sayıda seçenek olabilir. Boole Öznitelik Filtre Kümesinde yalnızca bir veya iki seçenek olabilir—bir doğru seçenek ve bir yanlış seçenek. Seçim Listesi Öznitelik Filtre Kümesinde, seçim listesindeki her olası değer için en fazla bir seçenek olabilir.

Seçenekler aşağıdaki özniteliklere sahiptir:

Arama Kümesi

Arama Kümesi, listeye filtre uygulamak için listenin seçili tablo türüyle ilgili bir tabloya bağlanan bir dizi seçenek ekler. Bir kullanıcı filtreyi uyguladığında, liste yalnızca seçilen ilgili kayıtlardan en az biriyle tam olarak eşleşen kayıtları görüntüler.

Arama Kümesi aşağıdaki öznitelikleri kullanır:

Arama Kümesi seçenekleri

Bir Arama Kümesi tipik olarak istenen sayıda seçeneğe sahip olabilir; tek sınırlama seçilen ilgili türün ilgili kayıtlarının sayısına ilişkindir.

Seçenekler aşağıdaki özniteliklere sahiptir:

Aralık Filtresi Kümesi

Aralık Filtre Kümesi Filtre alanına her biri bir veya iki koşula sahip bir dizi seçenek ekler. Bir kullanıcı filtreyi uyguladığında, liste yalnızca belirlenen seçeneklerden en az birindeki tüm koşullarla tam olarak eşleşen kayıtları görüntüler.

Aralık Filtresi Kümesi aşağıdaki öznitelikleri kullanır:

Aralık Filtre Kümesi seçenekleri

Aralık Filtre Kümesinde istenen sayıda seçenek olabilir. Her seçenek bir veya iki alt koşulu olan bir filtre koşulu oluşturur; koşulun doğru olabilmesi için her iki alt koşulun da karşılanması gerekir.

Seçenekler aşağıdaki özniteliklere sahiptir:

Dinamik Seçim Listesi Kümesi

Dinamik Seçim Listesi Kümesi filtreleme için belirtilen bir Seçim listesi alanındaki tüm değerleri temsil eden bir dizi seçenek ekler. Bu Öznitelik Filtre Kümesinde bir Seçim Listesi seçmekten farklıdır. Öznitelik Filtre Kümesinde filtre uygulamak üzere kullanıcı için kullanılabilir olacak seçenekler kümesini belirtmeniz gerekir; Dinamik Seçim Listesi Kümesinde, yalnızca Seçim Listesi alanını belirtmeniz gerekir. Tüm seçenekleri kümesi otomatik olarak sağlanacaktır. Daha fazla denetime gereksinim duyarsanız Öznitelik Filtre Kümesi kullanmanızı öneririz.

Dinamik Seçim Listesi Kümesi aşağıdaki seçenekleri kullanır:

Dinamik Arama Kümesi

Dinamik Arama Kümesi, listeye filtre uygulamak için listenin seçili tablo türüyle ilgili bir tabloya bağlanan bir dizi dinamik seçenek ekler. Bir kullanıcı filtreyi uyguladığında, liste yalnızca seçilen ilgili kayıtlardan en az biriyle tam olarak eşleşen kayıtları görüntüler.

Arama Kümesinden farklıdır. Arama Kümesinde, filtre uygulamak için ilgili tabloları el ile belirtmelisiniz. Dinamik Arama Kümesinde, yalnızca üzerinde filtre uygulanacak ilişkiyi belirtmeniz gerekir. Belirtilen ilgili tabloların görünümüne dayalı bir seçenekler listesi oluşturulur.

Dinamik Arama Kümesi aşağıdaki seçenekleri kullanır:

FetchXML filtresi

Aralık filtresi, Metin filtresi gibi basit bir metin kutusu veya diğer filtre türleri gibi seçenekler kümesi oluşturabilir. FetchXML kullanarak liste için hemen hemen her türde filtreyi el ile oluşturmanıza olanak tanır.

FetchXML filtresi yalnızca bir öznitelik kullanır:

Liste Harita görünümü

Listeler ile verilerin Harita görünümünü etkinleştirmek ve yapılandırmak mümkündür; bu, bir adresin yakınlarındaki konumları bulmak için kullanılan arama işleviyle birlikte Bing tarafından desteklenir. Kayıtlarınızı enlem ve boylam değerleriyle doldurup bu bölümde listelenen gerekli yapılandırma seçeneklerini belirttiğinizde, kayıtlarınız harita üzerinde iğneler olarak işlenir. Enlem veya boylam değeri olmayan kayıtlar arama dışında tutulur. Sayfa ilk yüklendiğinde, Varsayılan Merkezi Enlem ve Varsayılan Merkez Boylam koordinatlarından itibaren Mesafe Değerleri alanındaki başlangıç değeri dahilinde olan tüm kayıtlar görüntülenir (Belirtilen Mesafe Birimine göre mil veya kilometre olarak). Harita görünümü kullanıldığında belirtilen görünüm yok sayılır ve eşlenebilir sonuçları döndürmek için veri kümesine bir mesafe sorgusu uygulanır.

Liste Takvim görünümü

Liste Takvim görünümünü, bir listeyi takvim olarak işlemek için kullanın. Bu işlemde, yapılandırılan her bir kayıt tek bir olay gibi davranır.

Kayıtların bir takvim kullanılarak görüntülenmesi için bu kayıtların en az bir tarih alanı içermesi gerekir. Olayların kesin başlangıç ve bitiş tarihleri olması için ilgili alanların yerinde olması vb. gerekir. Bu alanların yapılandırıldığını varsayarsak bir Liste Takvim görünümü portalda görüntülenir.

Liste OData akışları

Etkinleştirilirse, bir tablo bir OData akışı için yayımlanabilir. OData protokolü, verilerle RESTful web hizmetleri aracılığıyla etkileşim kurmak için kullanılan uygulama düzeyinde bir protokoldür. Bu akıştan alınan veriler bir web tarayıcısında görüntülenebilir, bir istemci tarafı web uygulaması tarafından kullanılabilir veya Excel içine aktarılabilir.

Listeler için gelişmiş görünümü filtresi

Kayıtların güvenliğini sağlamak istiyorsanız Tablo İzinlerini kullanabilirsiniz. Ancak yalnızca geçerli portal kullanıcısıyla ilgili filtre seçenekleri kümesinin bir parçası olarak bir filtre sağlamak istiyorsanız Liste özelliğini kullanabilirsiniz. Bu özellik, geçerli kullanıcının, kullanıcının ana firmasının ya da web sitesinin herhangi bir düzeyde filtrelenmesini destekler. Herhangi bir ilgili kişi kaydını eşleştirmek için görünüm filtresi oluşturmanız yeterlidir. Kod kendi değerini çalışma sırasındaki gerçek değerle değiştirir. Filtre Koşulları bölümündeki alanlara değer atanması gerekmez.

• Denetim, uitype="contact" olan tüm koşul öğelerini bulur ve değeri, geçerli portal kullanıcısının ilgili kişi kimliğinin gerçek değerine ayarlar.
• Denetim, uitype="account" olan tüm koşul öğelerini bulur ve değeri, geçerli portal kullanıcısının ana firma kimliğinin gerçek değerine ayarlar.
• Denetim, uitype="adx_website" olan tüm koşul öğelerini bulur ve değeri, geçerli portal kullanıcısının web sitesi kimliğinin gerçek değerine ayarlar.

Örnek Filtre Ölçütlerini Görüntüleme

Aşağıdaki görüntüde, filtre durumuna atanan rastgele bir ilgili kişi gösterilmektedir, bu ilgili kişi bir saplama "sözde değer" ilgili kişisi olacaktır ancak herhangi bir ilgili kişi de olabilir. Bu kaydın kimliği, sayfayı görüntüleyen kullanıcının kimliğinin gerçek değeri ile değiştirilir. Kullanıcı oturum açmadıysa hiçbir kayıt döndürülmez. Bu, verileri kullanıcıya ve web sitesine göre filtrelemede bağlam bakımından daha fazla esneklik sağlar.

Ayrıca bkz.

• Microsoft Learn: Liste kullanarak birçok Dataverse kaydını görüntüleme
• Portal yapılandırma
• Bir portaldaki yeni bir URL'ye yönlendirme