Tuval uygulamalarında veri kartlarını anlama

Kart denetimleri Düzenleme formu ve Görüntüleme formu tuval uygulaması denetimlerinin yapı taşlarıdır. Form kaydın tamamını, her kart ise söz konusu kaydın tek bir alanını temsil eder.

Tasarım çalışma alanında bir form denetimi seçtikten sonra kartlarla en kolay şekilde etkileşime geçebileceğiniz yer sağ bölmedir. Bu bölmede, gösterilecek alanların yanı sıra her bir alanın nasıl ve hangi sırada gösterileceğini seçebilirsiniz. Bu örnekte, Varlıklar adlı bir listeden oluşturulmuş bir uygulamada yer alan bir Düzenleme formu denetimi gösterilir.

İlk ekran.

Kartlarla çalışmaya başlamak için bkz. form ekleme ve veri formlarını anlama. Bu makalenin geri kalan kısımlarında kartların nasıl çalıştığı ve kartları nasıl özelleştirebileceğiniz ve hatta kendi kartlarınızı nasıl oluşturabileceğiniz hakkında daha fazla ayrıntıya yer verilmektedir.

Önceden tanımlanmış kartlar

Power Apps dizeler, sayılar ve diğer veri türleri için önceden tanımlanmış bir dizi kart sunar. Sağ bölmede, kullanılabilen varyasyonları görüntüleyebilir ve bir alan için kullanılan kartı değiştirebilirsiniz:

Seçili kart.

Bu örnekte, tek satırlı bir metin kartı seçilmiştir ancak URL'nin metni tek bir satırda gösterilemeyecek kadar uzundur. Kullanıcılarımızın daha geniş bir alanda düzenleme yapabilmesine olanak tanımak için bunu çok satırlı bir metin kartına dönüştürelim:

Çoklu satır düzenleme.

Bu veri kaynağının çeşitli alanları gösterilmemektedir ancak bir alanın onay kutusunu seçerek söz konusu alanı gösterebilir veya gizleyebilirsiniz. Bu örnekte, SecurityCode alanının nasıl gösterileceği açıklanmaktadır.

Bir kartı özelleştirme

Kartlar diğer denetimleri kapsar. Bir Düzenleme formu denetiminde kullanıcı, Ekle sekmesinden eklediğiniz standart bir Metin girişi denetimine veri girer.

Bir kartın içindeki denetimleri düzenleyerek kartın görünümünü nasıl değiştirebileceğimizi göstermek için bir örnek üzerinden gidebiliriz.

  1. İlk olarak SecurityCode alanı için en son eklediğimiz karta geri dönelim. Bir kez tıklayarak veya dokunarak bu kartı seçin:

    Güvenlik kodunu seçme.

  2. Giriş denetiminin kendisine tıklayarak veya dokunarak kartın içindeki Metin girişi denetimini seçin.

    Metin girişi seçme.

  3. Seçim kutusunu sürükleyerek kartın içindeki bu denetimi taşıyın ve seçim kutusunun kenarında bulunan tutamaçları sürükleyerek denetimi yeniden boyutlandırın:

    Metin girişini özelleştirme.

Bir kartın içindeki denetimleri yeniden boyutlandırabilir, taşıyabilir ve başka değişiklikler yapabilirsiniz ancak kilidini açmadan kartı silemezsiniz.

Kart kilidini açma

Denetim içeren kartlar, tıpkı diğer denetimler gibi, özellikler ve formüller içeren denetimlerdir. Bir form alanını görüntülemeyi seçtiğinizde, kart ve gerekli formüller sağ bölmede sizin için otomatik olarak oluşturulur. Bu formülleri sağ bölmenin Gelişmiş sekmesinde görebiliriz:

Gelişmiş kilitli.

Kartın en temel özelliklerinden biri hemen karşımıza çıkar: DataField özelliği. Bu özellik, kullanıcının bu kartta veri kaynağının hangi alanını göreceğini ve düzenleyebileceğini belirtir.

Gelişmiş sekmesinin üst tarafındaki başlık bu kartın özelliklerinin kilitli olduğunu belirtir. DataField, DisplayName ve Gerekli özelliklerinin yanında da bir kilit simgesi görünür. Bu formüller sağ bölmede oluşturulmuştur ve kilit, bu özelliklerde yanlışlıkla değişiklik yapılmasını önler.

Kilit simgeleri.

Bu özellikleri değiştirebilmek için kartın kilidini açmak üzere üst taraftaki başlığa tıklayın veya dokunun:

Kilidi kaldırılmış kart.

Şimdi Asset ve ID arasına boşluk koymak için DisplayName'i değiştirelim. Bu değişikliği yaparak, varsayılan öğeyi değiştirmiş oluyoruz. Bu kart sağ bölmede farklı bir etikete sahiptir:

Görünen adı değiştirme.

Artık bu kartın denetimi bize aittir ve ihtiyaçlarımızı karşılayacak şekilde kart üzerinde daha fazla değişiklik yapabiliriz. Ancak daha önce yaptığımız gibi kartı bir gösterimden diğerine (örneğin, tek satırlı metinden çok satırlı metine) geçirme olanağını kaybettik. Önceden tanımlanmış kartı artık denetleyebildiğimiz bir "özel karta" dönüştürdük.

Önemli

Bir kartın kilidini açarsanız kartı yeniden kilitleyemezsiniz. Bir kartı tekrar kilitli duruma getirmek için kartı kaldırın ve sağ bölmeye yeniden yerleştirin.

Kilidi açılmış bir kartın görünümünü ve davranışını çeşitli şekillerde (denetim ekleme ve denetim kaldırma gibi) değiştirebilirsiniz. Örneğin, Ekle sekmesindeki Simgeler menüsünden bir yıldız işareti ekleyebilirsiniz.

Yıldız ekleme.

Yıldız artık kartın bir parçasıdır ve formdaki kartları yeniden sıralamanız gibi durumlarda kartla birlikte taşınır.

Başka bir örnek olarak, ImageURL kartının kilidini açın ve ardından Ekle sekmesinden karta bir Görüntü denetimi ekleyin:

Görüntü ekleme.

Formül çubuğunda, bu denetimin Görsel özelliğini TextBox.Metin olarak ayarlayın; burada TextBox URL'nin bulunduğu Metin girişi denetiminin adıdır:

Görüntüyü gösterme.

Artık görüntüleri görebilir ve bunların URL'lerini düzenleyebiliriz. Image özelliği olarak Parent.Default'u da kullanabileceğimizi ancak kullanıcının URL'yi değiştirmesi durumunda bunun güncelleştirilmeyeceğini unutmayın.

Bu uygulamanın ikinci ekranında da aynısını yapabiliriz, burada bir kaydın ayrıntılarını görüntülemek için bir Görüntüleme formu denetimi kullanırız. Bu durumda, kullanıcı söz konusu ekrandaki URL'yi düzenlemeyeceği için etiketi gizlemek (kartın değil etiketin Görünür özelliğini false olarak ayarlayarak) isteyebiliriz:

Resim görüntülemeyi gösterme.

Bir formla etkileşim kurma

Bir kartın kilidini açtıktan sonra kartın, kendisini içeren formla etkileşim kurma biçimini değiştirebilirsiniz.

Aşağıda denetimlerin, kartlarıyla nasıl çalışması gerektiğine ve kartların formla nasıl çalışması gerektiğine ilişkin yönergeler verilmiştir. Bunlar yalnızca yönergelerdir. Power Apps'te, Power Apps'in içerdiği tüm denetimler için geçerli olduğu gibi, herhangi bir denetime başvuran formüller oluşturabilirsiniz ve bu, kartlar ve içerdikleri denetimler için de geçerlidir. Yaratıcı olun: Çeşitli yöntemlerle uygulama oluşturabilirsiniz.

DataField özelliği

Karttaki en önemli özellik DataField özelliğidir. Bu özellik, hangi alanın güncelleştirildiğine ve kartla ilgili diğer konulara ilişkin doğrulama gerçekleştirir.

İçeriye bilgi akışı

Bir kapsayıcı olarak form ThisItem özelliğini formun içindeki tüm kartlar için kullanılabilir hale getirir. Bu kayıt, ilgilenilen geçerli kayda ilişkin alanların tümünü içerir.

Her kartın Varsayılan özelliğinin ThisItem.FieldName olarak ayarlanması gerekir. Belirli koşullar altında, bu işlem sırasında bu değeri dönüştürmek isteyebilirsiniz. Örneğin, bir dizeyi biçimlendirmek veya değeri bir dilden diğerine çevirmek isteyebilirsiniz.

Kartın içindeki her denetimin alanın değerine ulaşmak için Parent.Default'a başvurması gerekir. Bu strateji, kartın Varsayılan özelliğinin, karttaki dahili formüller değiştirilmeden değişebilmesi için karta yönelik bir kapsülleme düzeyi sağlar.

Varsayılan olarak, DefaultValue ve Gerekli özellikleri, DataField özelliğine bağlı olarak veri kaynağının meta verilerinden alınır. DataSourceInfo işlevini kullanıp veri kaynağının meta verileriyle etkileşim kurarak kendi mantığınız ile bu formülleri geçersiz kılabilirsiniz.

Dışarıya bilgi akışı

Kullanıcı kartlardaki denetimleri kullanarak bir kaydı değiştirdikten sonra SubmitForm işlevi bu değişiklikleri veri kaynağına kaydeder. Bu işlev çalıştığında, form denetimi, hangi alanın değiştirileceğini anlamak için her bir kartın DataField özelliğinin değerlerini okur.

Form denetimi aynı zamanda her bir kartın Güncelleştir özelliğinin değerini de okur. Söz konusu değer, bu alana ilişkin veri kaynağında depolanır. Burada başka bir dönüştürme uygulamak veya kartın Varsayılan formülünde uygulanan dönüştürmeyi geri almak gibi bir işlem yapabilirsiniz.

Valid özelliği DataField özelliğine dayalı olarak veri kaynağının meta verilerinden elde edilir. Bu, aynı zamanda Gerekli özelliğine ve Güncelleştir özelliğinin bir değer içerip içermediğine de bağlıdır. Güncelleştir özelliğindeki değer geçerli değilse Hata özelliği, kolay bir hata iletisi görüntüler.

Bir kartın DataField özelliği boş ise bu, kartın yalnızca denetim kapsayıcısı görevini gördüğü anlamına gelir. Form gönderildiğinde Geçerli ve Güncelleştir özellikleri dahil edilmez.

Bir örneğin ayrıntıları

Temel bir veri girişi kartını oluşturan denetimlere göz atalım. Denetimler arasındaki boşluk, her birini daha net şekilde gösterecek şekilde genişletildi:

Kartı bölümlerine ayırma.

Bu grafikte, veri kartındaki denetimler etiketlendirilmelidir:

Kartları bölümlerine ayırma.

Bu kartın çalışmasını sağlayan dört denetim:

Adı Tür Açıklama
TextRequiredStar Etiket denetimi Bir alanın gerekli olduğunu belirtmek için veri girişi formlarında yaygın olarak kullanılan bir yıldız görüntüler.
TextFieldDisplayName Etiket denetimi Bu alanın kolay adını görüntüler. Bu ad, veri kaynağı şemasındaki adla farklılık gösterebilir.
InputText Metin girişi denetimi Alanın başlangıç değerini görüntüler ve kullanıcının bu değeri değiştirebilmesine izin verir.
TextErrorMessage Etiket denetimi Doğrulamayla ilgili bir sorun oluşması durumunda kullanıcıya kolay bir hata iletisi görüntüler. Ayrıca alanın, gerekli olduğunda bir değere sahip olmasını da sağlar.

Bu denetimlerin verilerle doldurulması için denetimlerin özellikleri, bu temel formüller kullanılarak kartın özelliklerinden elde edilebilir. Formüllerin belirli bir alana atıfta bulunduğunu unutmayın. Aksine, tüm bilgiler karttan gelir.

Denetim özelliği Formül Açıklama
TextRequiredStar.Visible Parent.Required Yıldız yalnızca alanın gerekli olması durumunda görüntülenir. Sizin tarafınızdan veya veri kaynağının meta verileri tarafından uygulanan bir formül gereklidir.
TextFieldDisplayName.Text Parent.DisplayName Metin kutusu denetimi sizin sağladığınız veya veri kaynağının meta verilerinin sağladığı ve kartın DisplayName özelliğinde ayarlanmış kolay adı gösterir.
InputText.Default Parent.Default Metin girişi denetimi başlangıçta, veri kaynağındaki alanın, kartın varsayılan değeri ile sağlanan değerini gösterir.
TextErrorMessage.Text Parent.Error Bir doğrulama sorunu oluşursa kartın Hata özelliği bununla ilgili bir hata iletisi verir.

Not

Parent. Error özelliği, bir formül kullanarak ayarlayamayacağınızı bir salt çıkış özelliğidir. Bu nedenle, bu özellik sol üst köşenin solundaki veya Özellikler ya da Gelişmiş sekmelerde sağ kenarın yakınında Özellikler listesinde görünmez. Özelliğe başvuruda bulunan bir formül yazıyorsanız, formül çubuğu bu özelliği önerir.

Bu denetimlerden bilgi çekip veri kaynağına geri göndermek için aşağıdaki temel formülleri kullanabiliriz:

Denetim adı Formül Açıklama
DataCard.DataField "ApproverEmail" Alanın, kullanıcının bu kartta görüntüleyip düzenleyebileceği adı.
DataCard.Update InputText.Text SubmitForm işlevi kullanıldığında doğrulanacak ve veri kaynağına geri gönderilecek değer.

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).