Besturingselementen van kaarten zijn de bouwstenen van de besturingselementen voor de formulieren Bewerken en Weergeven. Het formulier vertegenwoordigt de volledige record en elke kaart één veld van dat record.

De eenvoudigste manier om te communiceren met kaarten is via het rechterdeelvenster wanneer een formulierbesturingselement is geselecteerd in de ontwerp-werkruimte. In dit deelvenster kunt u kiezen welke velden u wilt weergeven, kiezen hoe elk veld moet worden weergegeven en kunt u de velden rangschikken.

Als u wilt beginnen met kaarten, leest u Een formulier toevoegen en Gegevensformulieren begrijpen. In de rest van dit onderwerp krijgt u meer informatie over hoe kaarten werken en hoe u deze kunt aanpassen of zelf maken.

Vooraf gedefinieerde kaarten

PowerApps biedt een vooraf gedefinieerde set kaarten voor tekenreeksen, cijfers en andere gegevenstypen. U kunt in het rechterdeelvenster de beschikbare variaties zien en de kaart die wordt gebruikt voor een veld wijzigen:

In dit voorbeeld wordt een kaart met één regel tekst geselecteerd, maar de tekst van de URL is langer dan op één regel kan worden weergegeven. Laten we dit wijzigen in een kaart met meerdere regels tekst om onze gebruikers meer ruimte te geven om bewerkingen uit te voeren:

U ziet ook dat verschillende velden van deze gegevensbron niet worden weergegeven. U kunt deze weergeven en verbergen door het oogpictogram te selecteren:

Een kaart aanpassen

Kaarten bestaan uit nog meer besturingselementen. De gebruiker voert gegevens in in een standaardbesturingselement Tekstinvoer dat u kunt toevoegen in het tabblad Invoegen.

We nemen enkele voorbeelden door waarin het uiterlijk van de kaart wordt gewijzigd door besturingselementen te manipuleren.

  1. Eerst gaan we terug naar de kaart die we het recentst hebben geplaatst, die voor het veld SecurityCode. Selecteer deze kaart door er één keer op te klikken of te tikken:

  2. Selecteer het besturingselement Tekstinvoer in de kaart door op het invoerbesturingselement zelf te klikken of te tikken.

  3. U kunt dit besturingselement binnen de kaart verplaatsen door het selectievakje te slepen, en u kunt de grootte van het besturingselement wijzigen door de ingangen langs de rand van het selectievakje te slepen:

    U kunt het besturingselement vergroten, verkleinen, verplaatsen of andere wijzigingen aanbrengen, maar u kunt het niet verwijderen zonder het eerst te ontgrendelen. In de volgende sectie wordt beschreven hoe u een kaart kunt ontgrendelen.

  4. U kunt een of meer besturingselementen in de kaart invoegen, zoals deze stervorm in het menu Vormen op het tabblad Invoegen:

    Dit nieuwe besturingselement maakt nu deel uit van de kaart en verhuist mee met de kaart als u bijvoorbeeld de volgorde van de kaarten in het formulier wijzigt.

In een ander voorbeeld kunt u een afbeelding weergeven in een Afbeelding-besturingselement in plaats van de URL van de afbeelding in een Tekstinvoer-besturingselement, zoals in deze afbeelding wordt weergegeven

  1. Op het tabblad Invoegen kunt u een afbeeldingsbesturingselement toevoegen onder de kaart ImageURL:

  2. Stel in de formulebalk de Afbeelding-eigenschap van dit besturingselement in op TextBox.Text. Hierin is TextBox de naam van het besturingselement Invoertekst dat de URL bevat:

    Tip: druk op de Alt-toets om de naam van elk besturingselement weer te geven.

    En nu kunnen we de afbeeldingen zien en de URL's bewerken. Let op: we hadden Parent.Default kunnen gebruiken als de Afbeelding-eigenschap, maar deze wordt niet bijgewerkt wanneer de gebruiker een nieuwe URL opgeeft.

  3. We kunnen doen in het tweede scherm van deze app hetzelfde te doen. We gebruiken dan een besturingselement Formulier weergeven om de details van een record weer te geven. Hier wilt u mogelijk het tekstvak verbergen (stel de eigenschap Visible van het labelbesturingselement, niet de kaart, in op false) omdat de gebruiker de URL op dat scherm niet bewerkt:

Een kaart ontgrendelen

Kaarten bevatten besturingselementen maar zijn zelf ook besturingselementen met eigenschappen en formules net als andere besturingselementen. Wanneer u ervoor kiest om een veld in een formulier weer te geven, maakt het rechterdeelvenster automatisch de kaart voor u en genereert de benodigde formules. Deze formules staan in het deelvenster Geavanceerd, dat beschikbaar is via het tabblad Weergave:

We zien hier meteen een van de belangrijkste eigenschappen van de kaart: de eigenschap DataField. Deze eigenschap geeft aan welk veld van de gegevensbron de gebruiker kan zien en bewerken in deze kaart.

In de weergave Geavanceerd geeft de grote banner bovenaan aan dat de eigenschappen van deze kaart zijn vergrendeld. Er wordt ook een vergrendelingspictogram weergegeven naast de eigenschappen DataField, Standaard en DisplayName. Het rechterdeelvenster creëert deze formules en de vergrendeling voorkomt onbedoelde wijzigingen aan deze eigenschappen.

Klik of tik op de banner bovenaan voor het ontgrendelen van de kaart zodat u deze eigenschappen kunt wijzigen:

We wijzigen nu de DisplayName zodat er een spatie tussen Asset en ID komt te staan. Door deze wijziging, wijzigen we wat er voor ons is gegenereerd. Deze kaart heeft in het rechterdeelvenster een andere label:

We hebben nu de controle over deze kaart en kunnen deze verder aanpassen aan wat we nodig hebben. Maar we kunnen de kaart niet meer van de ene weergave in de andere veranderen (bijvoorbeeld tekst met één regel naar tekst met meerdere regels), zoals we eerder hebben gedaan. We hebben de vooraf gedefinieerde kaart omgezet in een 'aangepaste kaart' die we nu zelf bepalen.

Waarschuwing: u kunt een eenmaal ontgrendelde kaart niet meer vergrendelen. U kunt de vergrendelde status herstellen door de kaart te verwijderen en opnieuw in het rechterdeelvenster te plaatsen.

Communiceren met het formulier

Nadat u de kaart hebt ontgrendeld, kunt u de interactie met het formulier erin wijzigen.

Hieronder vindt u enkele richtlijnen voor hoe besturingselementen moeten werken in combinatie met hun kaart en hoe de kaarten moeten werken in combinatie met het formulier. Dit zijn slechts richtlijnen. Net als bij elk besturingselement in PowerApps kunt u formules maken die verwijzen naar een ander besturingselement in PowerApps, en dat geldt ook voor kaarten en besturingselementen binnen kaarten. Wees creatief: er zijn veel manieren om een app te maken.

De eigenschap DataField

De belangrijkste eigenschap op de kaart is de eigenschap DataField. Deze eigenschap bepaalt de validatie, welke veld wordt bijgewerkt, en andere aspecten van de kaart.

Binnenkomende gegevens

Als container komt op het formulier ThisItem beschikbaar voor alle kaarten die het bevat. Deze record bevat alle velden voor de huidige belangrijke record.

De eigenschap Default van elke kaart moet worden ingesteld op ThisItem.FieldName. Onder bepaalde omstandigheden is het raadzaam deze waarde in het begin te veranderen. U wilt bijvoorbeeld een tekenreeks opmaken of de waarde naar een andere taal omzetten.

Elk besturingselement in de kaart moet verwijzen naar Parent.Default om bij de waarde van het veld te komen. Deze strategie biedt een niveau van inkapseling voor de kaart zodat de eigenschap Default van de kaart kan wijzigen zonder dat de interne formules van de kaart worden gewijzigd.

Standaard worden de eigenschappen DefaultValue en Required opgehaald uit de metagegevens van de gegevensbron op basis van de eigenschap DataField. U kunt deze formules overschrijven met uw eigen logica, en de metagegevens van de gegevensbron integreren met behulp van de functie DataSourceInfo.

Uitgaande gegevens

Nadat de gebruiker een record wijzigt met behulp van besturingselementen in de kaarten slaat de functie SubmitForm de wijzigingen op in de gegevensbron. Wanneer deze functie wordt uitgevoerd, leest het besturingselement in het formulier de waarden van de eigenschap DataField van elke kaart om te weten welk veld moet worden gewijzigd.

Het besturingselement van het formulier leest ook de waarde van de eigenschap Update van elke kaart. Deze waarde wordt opgeslagen in de gegevensbron voor dit veld. Dit is de plek waar u een andere transformatie kunt toepassen, bijvoorbeeld als u de transformatie die is toegepast in de Standaard-formule van de kaart ongedaan wilt maken.

De eigenschap Valid wordt aangestuurd vanuit de metagegevens van de gegevensbron op basis van de eigenschap DataField. Deze is ook gebaseerd op de eigenschap Required en is afhankelijk van of de eigenschap Update een waarde bevat. Als de waarde in de eigenschap Update niet geldig is, biedt de eigenschap Error een beschrijvend foutbericht.

Als de eigenschap DataField van een kaart Leeg is, is de kaart slechts een container van besturingselementen. De eigenschappen Valid en Update zijn niet actief wanneer het formulier wordt verzonden.

Een voorbeeld ontleden

We bekijken de besturingselementen die samen een kaartinvoer van gegevens vormen. De afstand tussen de besturingselementen is vergroot zodat elk besturingselement beter zichtbaar is:

Houd de Alt-toets ingedrukt om de namen van de besturingselementen weer te geven die samen deze kaart vormen:

Vier besturingselementen zorgen ervoor dat deze kaart werkt:

Naam Type Beschrijving
TextRequiredStar Het besturingselement Label Toont een ster, doorgaans gebruikt in formulieren voor gegevensinvoer om aan te geven dat een veld is vereist.
TextFieldDisplayName Het besturingselement Label Toont de beschrijvende naam van dit veld. Deze naam kan afwijken van de naam in het schema van de gegevensbron.
InputText Het besturingselement InputText Toont de beginwaarde van het veld en geeft de gebruiker de gelegenheid die waarde te wijzigen.
TextErrorMessage Het besturingselement Label Toont een beschrijvend foutbericht aan de gebruiker als er een probleem optreedt bij validatie. Zorgt er ook voor dat het veld een waarde bevat, indien dit is vereist.

Door deze besturingselementen te vullen met gegevens, kunnen de bijbehorende eigenschappen worden bepaald vanuit de eigenschappen van de kaart, via deze formules. Houd er rekening mee dat geen van deze formules naar een bepaald veld verwijst. Alle gegevens zijn afkomstig van de kaart.

Eigenschap van het besturingselement Formule Beschrijving
TextRequiredStar.Visible Parent.Required De ster wordt alleen weergegeven als het veld is vereist. 'Vereist' is een formule die wordt aangedreven door u of door de metagegevens van de gegevensbron.
TextFieldDisplayName.Text Parent.DisplayName Het tekstvakbesturingselement toont de beschrijvende naam die door u of door de metagegevens van de gegevensbron worden geboden en die is ingesteld op de eigenschap van de kaart DisplayName.
InputText.Default Parent.Default In het tekstinvoerbesturingselement vindt u in eerste instantie de waarde van het veld van de gegevensbron, zoals bepaald door de standaardwaarde van de kaart.
TextErrorMessage.Text Parent.Error Als een validatieprobleem optreedt, biedt de eigenschap Error van de kaart een bijpassend foutbericht.

Als u gegevens wilt ophalen uit deze besturingselementen en terug in de gegevensbron wilt plaatsen, bieden we de volgende formules:

De naam van het besturingselement Formule Beschrijving
DataCard.DataField "ApproverEmail" De naam van het veld dat de gebruiker kan weergeven en bewerken in deze kaart.
DataCard.Update InputText.Text De waarde die moet worden gevalideerd en teruggeplaatst in de gegevensbron wanneer SubmitForm wordt uitgevoerd.