Veri kartlarını anlamaUnderstand data cards

Kart denetimleri Düzenleme formu ve Görüntüleme formu denetimlerinin yapı taşlarıdır.Card controls are the building blocks of the Edit form and Display form controls. Form kaydın tamamını, her kart ise söz konusu kaydın tek bir alanını temsil eder.The form represents the entire record, and each card represents a single field of that record.

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.You can interact with cards most easily in the right-hand pane after you select a form control in the design workspace. 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.In that pane, you can choose which fields to show, how to show each field, and in what order to show them. Bu örnekte, Assets adlı bir SharePoint listesinden oluşturulmuş bir uygulamada yer alan bir Düzenleme formu denetimi gösterilir.This example shows an Edit form control in an app built from a SharePoint list that's named Assets.

Kartlarla çalışmaya başlamak için bkz. form ekleme ve veri formlarını anlama.To get started with cards, see add a form and understand data forms. Bu konu başlığının 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.The remainder of this topic goes into more detail about how cards work and how you can customize or even create your own.

Önceden tanımlanmış kartlarPredefined cards

PowerApps, dizeler, sayılar ve diğer veri türleri için önceden tanımlanmış bir dizi kart sunar.PowerApps offers a predefined set of cards for strings, numbers, and other data types. Sağ bölmede, kullanılabilen varyasyonları görüntüleyebilir ve bir alan için kullanılan kartı değiştirebilirsiniz:In the right-hand pane, you can see the variations available and change the card used for a field:

Bu örnekte, tek satırlı bir metin kartı seçilmiştir ancak URL'nin metni tek bir satırda gösterilemeyecek kadar uzundur.In this example, a single-line text card is selected, but the URL's text is longer than can be shown on a single line. 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:Let's change this to a multi-line text card to give our users more room to edit:

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.Several fields of this data source aren't being shown, but you can show or hide a field by selecting its checkbox. Bu örnekte, SecurityCode alanının nasıl gösterileceği açıklanmaktadır.This example illustrates how to show the SecurityCode field.

Kart özelleştirmeCustomize a card

Kartlar diğer denetimleri kapsar.Cards comprise other controls. Bir Düzenleme formu denetiminde kullanıcı, Ekle sekmesinden eklediğiniz standart bir Metin girişi denetimine veri girer.In an Edit form control, the user enters data in a standard Text input control that you add from the Insert tab.

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.Let's walk through an example of how to change a card's appearance by manipulating controls in it.

  1. İlk olarak SecurityCode alanı için en son eklediğimiz karta geri dönelim.First, let's return to the card that we inserted most recently, for the SecurityCode field. Bir kez tıklayarak veya dokunarak bu kartı seçin:Select this card by clicking or tapping it once:

  2. Giriş denetiminin kendisine tıklayarak veya dokunarak kartın içindeki Metin girişi denetimini seçin.Select the Text input control inside the card by clicking or tapping the input control itself.

  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:Move this control within the card by dragging the selection box, and resize the control by dragging the handles along the edge of the selection box:

Bir kartın içindeki denetimleri yeniden boyutlandırabilir, taşıyabilir ve başka değişiklikler yapabilirsiniz ancak kilidini açmadan kartı silemezsiniz.You can resize, move, and make other modifications to controls within a card, but you can't delete it without unlocking it first.

Kart kilidini açmaUnlock a card

Denetim içeren kartlar, tıpkı diğer denetimler gibi, özellikler ve formüller içeren denetimlerdir.In addition to containing controls, cards themselves are controls that have properties and formulas just like any other control. 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.When you choose to display a field on a form, the right-hand pane automatically creates the card for you and generates the needed formulas. Bu formülleri sağ bölmenin Gelişmiş sekmesinde görebiliriz:We can see these formulas in the Advanced tab of the right-hand pane:

Kartın en önemli özelliklerinden biri hemen karşımıza çıkar: DataField özelliği.We immediately see one of the most important properties of the card: the DataField property. Bu özellik, kullanıcının bu kartta veri kaynağının hangi alanını göreceğini ve düzenleyebileceğini belirtir.This property indicates which field of the data source the user sees and can edit in this card.

Gelişmiş sekmesinin üst tarafındaki başlık bu kartın özelliklerinin kilitli olduğunu belirtir.On the Advanced tab, the banner at the top indicates that the properties of this card are locked. DataField, DisplayName ve Required özelliklerinin yanında da bir kilit simgesi görünür.A lock icon also appears next to the DataField, DisplayName, and Required properties. Bu formüller sağ bölmede oluşturulmuştur ve kilit, bu özelliklerde yanlışlıkla değişiklik yapılmasını önler.The right-hand pane created these formulas, and the lock prevents accidental changes to these properties.

Bu özellikleri değiştirebilmek için kartın kilidini açmak üzere üst taraftaki başlığa tıklayın veya dokunun:Click or tap the banner at the top to unlock the card so that you can modify these properties:

Şimdi Asset ve ID arasına boşluk koymak için DisplayName'i değiştirelim.Let's modify the DisplayName to put a space between Asset and ID. Bu değişikliği yaparak, varsayılan öğeyi değiştirmiş oluyoruz.By making this change, we're altering what was generated for us. Bu kart sağ bölmede farklı bir etikete sahiptir:In the right-hand pane, this card has a different label:

Artık bu kartın denetimi bize aittir ve ihtiyaçlarımızı karşılayacak şekilde kart üzerinde daha fazla değişiklik yapabiliriz.We've now taken control over this card and can modify it further to fit our need. 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.But we've lost the ability to change the card from one representation to another (for example, single-line text to multi-line text) as we did before. Önceden tanımlanmış kartı artık denetleyebildiğimiz bir "özel karta" dönüştürdük.We've transformed the predefined card into a "custom card" that we now control.

Önemli: Bir kartın kilidini açarsanız kartı yeniden kilitleyemezsiniz.Important: You can't relock a card if you unlock it. Bir kartı tekrar kilitli duruma getirmek için kartı kaldırın ve sağ bölmeye yeniden yerleştirin.To get a card back to a locked state, remove it, and reinsert it in the right-hand pane.

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.You can change the appearance and behavior of an unlocked card in a variety of ways, such as adding and deleting controls within it. Örneğin, Ekle sekmesindeki Simgeler menüsünden bir yıldız işareti ekleyebilirsiniz.For example, you can add a star shape from the Icons menu on the Insert tab.

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.The star is now a part of the card and will travel with it if, for example, you reorder the cards within the form.

Başka bir örnek olarak, ImageURL kartının kilidini açın ve ardından Ekle sekmesinden karta bir Görüntü denetimi ekleyin:As another example, unlock the ImageURL card, and then add an Image control to it from the Insert tab:

Formül çubuğunda, bu denetimin Image özelliğini TextBox.Text olarak ayarlayın; burada TextBox URL'nin bulunduğu Metin girişi denetiminin adıdır:In the formula bar, set the Image property of this control to TextBox.Text, where TextBox is the name of the Text input control that holds the URL:

İpucu: Her bir denetimin adını göstermek için Alt tuşuna basın.Tip: Press the Alt key to show the name of each control.

Artık görüntüleri görebilir ve bunların URL'lerini düzenleyebiliriz.And now we can see the images and edit their URLs. 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.Note that we could have used Parent.Default as the Image property, but it wouldn't have updated if the user changed the URL.

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.We can do the same thing on the second screen of this app, where we use a Display form control to display the details of a record. Bu durumda, kullanıcı söz konusu ekrandaki URL'yi düzenlemeyeceği için etiketi gizlemek (kartın değil etiketin Visible özelliğinifalse olarak ayarlayarak) isteyebiliriz:In this case, we may want to hide the label (set the Visible property of the label, not the card, to false) because the user won't edit the URL on that screen:

Bir formla etkileşim kurmaInteract with a form

Bir kartın kilidini açtıktan sonra kartın, kendisini içeren formla etkileşim kurma biçimini değiştirebilirsiniz.After you unlock a card, you can change how it interacts with the form that contains it.

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.Below are some guidelines for how controls should work with their card and how the cards should work with the form. Bunlar yalnızca yönergelerdir.These are only guidelines. PowerApps'te, 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.As with any control in PowerApps, you can create formulas that reference any other control in PowerApps, and that's no less true for cards and controls within cards. Yaratıcı olun: Çeşitli yöntemlerle uygulama oluşturabilirsiniz.Be creative: you can create an app in many ways.

DataField özelliğiDataField property

Karttaki en önemli özellik DataField özelliğidir.The most important property on the card is the DataField property. Bu özellik, hangi alanın güncelleştirildiğine ve kartla ilgili diğer konulara ilişkin doğrulama gerçekleştirir.This property drives validation, what field is updated, and other aspects of the card.

İçeriye bilgi akışıInformation flowing in

Bir kapsayıcı olarak form ThisItem özelliğini formun içindeki tüm kartlar için kullanılabilir hale getirir.As a container, the form makes ThisItem available to all cards within it. Bu kayıt, ilgilenilen geçerli kayda ilişkin alanların tümünü içerir.This record contains all of the fields for the current record of interest.

Her kartın Default özelliğinin ThisItem.AlanAdı olarak ayarlanması gerekir.The Default property of every card should be set to ThisItem.FieldName. Belirli koşullar altında, bu işlem sırasında bu değeri dönüştürmek isteyebilirsiniz.Under certain circumstances, you might want to transform this value on the way in. Örneğin, bir dizeyi biçimlendirmek veya değeri bir dilden diğerine çevirmek isteyebilirsiniz.For example, you might want to format a string or translate the value from one language to another.

Kartın içindeki her denetimin alanın değerine ulaşmak için Parent.Default'a başvurması gerekir.Each control within the card should reference Parent.Default to get at the field's value. Bu strateji, kartın Default özelliğinin, karttaki dahili formüller değiştirilmeden değişebilmesi için karta yönelik bir kapsülleme düzeyi sağlar.This strategy provides a level of encapsulation for the card so that the card's Default property can change without changing the internal formulas of the card.

Varsayılan olarak, DefaultValue ve Required özellikleri, DataField özelliğine bağlı olarak veri kaynağının meta verilerinden alınır.By default, DefaultValue and Required properties are taken from the data source's metadata based on the DataField property. 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.You can override these formulas with your own logic, integrating the data source's metadata by using the DataSourceInfo function.

Dışarıya bilgi akışıInformation flowing out

Kullanıcı kartlardaki denetimleri kullanarak bir kaydı değiştirdikten sonra SubmitForm işlevi bu değişiklikleri veri kaynağına kaydeder.After the user modifies a record by using controls in the cards, the SubmitForm function saves those changes to the data source. 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.When that function runs, the form control reads the values of each card's DataField property to know what field to change.

Form denetimi aynı zamanda her bir kartın Update özelliğinin değerini de okur.The form control also reads the value of each card's Update property. Söz konusu değer, bu alana ilişkin veri kaynağında depolanır.This value will be stored in the data source for this field. Burada başka bir dönüştürme uygulamak veya kartın Default formülünde uygulanan dönüştürmeyi geri almak gibi bir işlem yapabilirsiniz.This is the place to apply another transform, perhaps to reverse the transform that was applied in the card's Default formula.

Valid özelliği DataField özelliğine dayalı olarak veri kaynağının meta verilerinden elde edilir.The Valid property is driven from the metadata of the data source, based on the DataField property. Bu, aynı zamanda Required özelliğine ve Update özelliğinin bir değer içerip içermediğine de bağlıdır.It's also based on the Required property and whether the Update property contains a value. Update özelliğindeki değer geçerli değilse Error özelliği, kolay bir hata iletisi görüntüler.If the value on the Update property isn't valid, the Error property provides a user-friendly error message.

Bir kartın DataField özelliği boş ise bu, kartın yalnızca denetim kapsayıcısı görevini gördüğü anlamına gelir.If the DataField property of a card is blank, the card is just a container of controls. Form gönderildiğinde Valid ve Update özellikleri dahil edilmez.Its Valid and Update properties don't participate when the form is submitted.

Bir örneğin ayrıntılarıDissecting an example

Temel bir veri girişi kartını oluşturan denetimlere göz atalım.Let's look at the controls that make up a basic data-entry card. Denetimler arasındaki boşluk, her birini daha net şekilde gösterecek şekilde genişletildi:The space between controls has been increased to show each more clearly:

Bu kartı oluşturan denetimlerin adlarını göstermek için Alt tuşunu basılı tutun:Hold down the Alt key to show the names of the controls that make up this card:

Bu kartın çalışmasını sağlayan dört denetim:Four controls make this card work:

AdName TürType AçıklamaDescription
TextRequiredStarTextRequiredStar Etiket denetimiLabel control 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.Displays a star, which is commonly used on data-entry forms to indicate that a field is required.
TextFieldDisplayNameTextFieldDisplayName Etiket denetimiLabel control Bu alanın kolay adını görüntüler.Displays the user-friendly name of this field. Bu ad, veri kaynağı şemasındaki adla farklılık gösterebilir.This name can differ from what is in the data source's schema.
InputTextInputText Metin girişi denetimiInput text control Alanın başlangıç değerini görüntüler ve kullanıcının bu değeri değiştirebilmesine izin verir.Displays the initial value of the field and allows the user to change that value.
TextErrorMessageTextErrorMessage Etiket denetimiLabel control Doğrulamayla ilgili bir sorun oluşması durumunda kullanıcıya kolay bir hata iletisi görüntüler.Displays a user-friendly error message to the user if a problem occurs with validation. Ayrıca alanın, gerekli olduğunda bir değere sahip olmasını da sağlar.Also ensures that the field has a value if one is required.

Bu denetimlerin verilerle doldurulması için denetimlerin özellikleri, bu temel formüller kullanılarak kartın özelliklerinden elde edilebilir.To populate these controls with data, their properties can be driven from the properties of the card, through these key formulas. Bu formüllerden hiçbirinin belirli bir alana başvurmadığını unutmayın.Note that none of these formulas refers to a specific field. Aksine, tüm bilgiler karttan gelir.Instead, all information comes from the card.

Denetim özelliğiControl property FormülFormula AçıklamaDescription
TextRequiredStar.VisibleTextRequiredStar.Visible Parent.RequiredParent.Required Yıldız yalnızca alanın gerekli olması durumunda görüntülenir.The star appears only if the field is required. Sizin tarafınızdan veya veri kaynağının meta verileri tarafından uygulanan bir formül gereklidir.Required is a formula that's driven by you or the metadata of the data source.
TextFieldDisplayName.TextTextFieldDisplayName.Text Parent.DisplayNameParent.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.The text-box control shows the user-friendly name, which you or the data source's metadata provides, and which is set on the card's DisplayName property.
InputText.DefaultInputText.Default Parent.DefaultParent.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.The text-input control initially shows the value of the field from the data source, as provided by the card's default value.
TextErrorMessage.TextTextErrorMessage.Text Parent.ErrorParent.Error Bir doğrulama sorunu oluşursa kartın Error özelliği bununla ilgili bir hata iletisi verir.If a validation problem occurs, the card's Error property provides an appropriate error message.

Bu denetimlerden bilgi çekip veri kaynağına geri göndermek için aşağıdaki temel formülleri kullanabiliriz:To pull information out of these controls and push it back into the data source, we have the following key formulas:

Denetim adıControl name FormülFormula AçıklamaDescription
DataCard.DataFieldDataCard.DataField "ApproverEmail""ApproverEmail" Alanın, kullanıcının bu kartta görüntüleyip düzenleyebileceği adı.The name of the field that the user can display and edit in this card.
DataCard.UpdateDataCard.Update InputText.TextInputText.Text SubmitForm işlevi kullanıldığında doğrulanacak ve veri kaynağına geri gönderilecek değer.The value to validate and push back into the data source when SubmitForm runs.