Aangepaste formulieren maken
Notitie
De actie Aangepast formulier weergeven is gebaseerd op de technologie voor adaptieve kaarten. Raadpleeg deze pagina voor meer informatie over adaptieve kaarten.
Met berichtvakken kunt u gebruikers vragen verschillende gegevens in te voeren, zoals tekst, datums en bestanden, of informatie en resultaten op het scherm weergeven.
Hoewel de meeste acties van deze groep scenario's kunnen verwerken waarin een enkele invoer is vereist, kan bij sommige automatiseringen een combinatie van invoer en/of uitvoer zijn vereist. De beste aanpak bij het verwerken van deze scenario's is de actie Aangepast formulier weergeven.
Als u een aangepast formulier wilt maken, implementeert u de actie Aangepast formulier weergeven en selecteert u de knop Aangepast formulierontwerper om de formulierontwerper te openen.
Aan de linkerkant van de ontwerper bevindt zich een lijst met alle beschikbare invoerelementen die u kunt toevoegen aan het formulier, zoals tekst, datum en bestandsinvoer, en sommige niet-interactieve elementen, zoals teksten en afbeeldingen.
U kunt een element aan het aangepaste formulier toevoegen door erop te dubbelklikken of door het te slepen en in het werkruimtegebied van de ontwerper neer te zetten. Gebruik het voorbeeldvenster aan de onderkant van de formulierontwerper om te zien hoe het geconfigureerde formulier eruit zal zien tijdens de uitvoering.
Nadat u een element hebt toegevoegd, kunt u alle beschikbare eigenschappen aan de rechterkant van de formulierontwerper verwerken. De beschikbare eigenschappen kunnen verschillen afhankelijk van de aard van het geselecteerde element.
Notitie
Afgezien van de formulierelementen, biedt de formulierontwerper enkele eigenschappen om het uiterlijk van het bovenliggende dialoogvenster van het aangepaste formulier te configureren. U kunt deze configureren door een lege ruimte in de werkruimte te selecteren en de beschikbare eigenschappen te bekijken in het respectievelijke deelvenster.
Wanneer een gebruiker een aangepast formulier invult, worden de verstrekte gegevens opgeslagen in de aangepaste objectvariabele CustomFormData. Gebruik de volgende notatie om toegang te krijgen tot de waarde van een specifiek invoerelement dat is opgeslagen in het aangepaste object: %CustomFormData['ElementID']%.
Belangrijk
De id van elk element moet uniek zijn en mag niet leeg zijn. Ook moet het beginnen met een letter en kan het Latijnse letters, cijfers en spaties bevatten. U kunt geen variabelen gebruiken in id-velden. Als een ongeldige id wordt opgegeven, wordt de laatst gebruikte geldige id automatisch hersteld na het sluiten en opslaan van de formulierontwerper.
Notitie
U kunt meer informatie over aangepaste objecten en de verwerking hiervan vinden in Geavanceerde gegevenstypen.
Afgezien van invoer en niet-interactieve elementen, biedt de formulierontwerper enkele acties om extra functionaliteit in uw formulieren te implementeren.
Beschouw acties als knoppen waarmee u verschillende functies kunt uitvoeren op basis van welke knop wordt ingedrukt. Gebruik bijvoorbeeld een actie Verzenden als een opslagknop om de verstrekte gebruikersgegevens te verzamelen en op te slaan voor later gebruik in uw stroom.
Notitie
Acties kunnen alleen aan het einde van de formulierstructuur worden toegevoegd, na elk ander type formulierelement.
Net als de andere elementen heeft elke actie een id die deze uniek beschrijft. Wanneer een actie is geselecteerd, wordt de id ervan opgeslagen in de variabele ButtonPressed.
Als een formulier meerdere acties bevat, gebruikt u deze variabele en voorwaarden om te controleren welke wordt ingedrukt en om verschillende functionaliteit voor elk scenario te implementeren. Raadpleeg Aangepaste formulieren verwerken voor meer informatie over het implementeren van dit gedrag.
De volgende schermopname laat zien hoe het eerder geconfigureerde aangepaste formulier eruitziet wanneer de stroom wordt uitgevoerd.
Aangepaste formulierelementen
Naam van element | Type | Specificaties | Indelingseigenschappen | Validatie-eigenschappen | Stijleigenschappen | Achtergrondafbeelding |
---|---|---|---|---|---|---|
Aangepast formulier | Bovenliggend dialoogvenster | Titel | Minimale hoogte in pixels, Verticale uitlijning van inhoud | URL, Invullingsmodus, Horizontale uitlijning, Verticale uitlijning | ||
Tekstinvoer | Invoer | Id, Label, Standaardwaarde, Meerdere regels, Stijl, Maximale lengte | Spatiëring, Scheidingsteken, Hoogte | Validatie vereist, Foutbericht, Patroon | ||
Getalinvoer | Invoer | Id, Label, Standaardwaarde, Minimumwaarde, Maximumwaarde | Spatiëring, Scheidingsteken, Hoogte | Validatie vereist, Foutbericht | ||
Datuminvoer | Invoer | Id, Label, Standaardwaarde, Minimumwaarde, Maximumwaarde | Spatiëring, Scheidingsteken, Hoogte | Validatie vereist, Foutbericht | ||
Tijdsinvoer | Invoer | Id, Label, Standaardwaarde, Minimumwaarde, Maximumwaarde | Spatiëring, Scheidingsteken, Hoogte | Validatie vereist, Foutbericht | ||
Invoer in-/uitschakelen | Invoer | ID, Label, Titel, Standaardwaarde, Waarde indien ingeschakeld, Waarde indien uitgeschakeld | Spatiëring, Scheidingsteken, Hoogte, Terugloop | Validatie vereist, Foutbericht | ||
Invoer van keuzeset | Invoer | ID, Label, Standaardwaarde, Meerdere selecties toestaan, Stijl, Keuzen | Spatiëring, Scheidingsteken, Hoogte, Terugloop | Validatie vereist, Foutbericht | ||
Bestandsinvoer | Invoer | Id, Label, Standaardwaarde | Spatiëring, Scheidingsteken, Hoogte | Validatie vereist, Foutbericht | ||
Tekstblok | Element | Id, Tekst | Spatiëring, Scheidingsteken, Horizontale uitlijning, Hoogte, Terugloop, Maximumaantal regels, Maximale breedte | Lettertype, Grootte, Gewicht, Kleur, Subtiel, Cursief, Doorhalen | ||
Afbeelding | Element | Id, URL, Alternatieve tekst | Spatiëring, Scheidingsteken, Horizontale uitlijning, Hoogte, Hoogte in pixels, Breedte in pixels, Grootte | Stijl, Achtergrondkleur | ||
Verzenden | Actie | Id, Titel, Opgegeven invoer negeren | ||||
URL openen | Actie | Id, Titel, URL |
Eigenschappen van aangepast formulierelement
Eigenschapsnaam | Optioneel | Accepteert | Standaard | Beschrijving |
---|---|---|---|---|
Meerdere selecties toestaan | N.v.t. | Booleaanse waarde | Onwaar | Staat het selecteren van meerdere keuzen toe |
Alternatieve tekst | Ja | Tekstwaarde | Alternatieve tekst die de afbeelding beschrijft | |
Achtergrondkleur | Ja | Tekstwaarde | Past een achtergrond toe op een transparante afbeelding. Deze eigenschap respecteert de afbeeldingsstijl. Alleen hexadecimale waarden zijn acceptabel in deze eigenschap | |
Keuzes | Ja | Titel en Waarde | Beschrijft keuzen voor gebruik in de keuzeset. Bevat een titel (tekst om weer te geven) en een waarde (onbewerkte waarde voor de keuze) | |
Kleur | N.v.t. | Standaard, Donker, Licht, Accent, Goed, Waarschuwing, Attentie | Standaard | Bepaalt de kleur van de tekst |
Standaardwaarde | Ja | Tekstwaarde, Numerieke waarde | De standaardwaarde van het invoerelement | |
Foutbericht | Ja | Tekstwaarde | Foutbericht dat moet worden weergegeven als de ingevoerde invoer ongeldig is | |
Invullingsmodus | N.v.t. | Voorblad, Horizontaal herhalen, Verticaal herhalen, Herhalen | Beschrijft hoe de afbeelding het gebied moet vullen | |
Lettertype | N.v.t. | Standaard, Monospace | Standaard | Type lettertype dat moet worden gebruikt voor rendering |
Hoogte | N.v.t. | Auto, Uitrekken, Pixels | Auto | Geeft de hoogte van het element aan. De optie 'Pixels' is alleen beschikbaar voor afbeeldingselementen |
Hoogte in pixels | Nee | Numerieke waarde | 0 | Geeft de gewenste hoogte van de afbeelding op. De afbeelding wordt vervormd om op die exacte hoogte te passen. Hiermee wordt de eigenschap 'Grootte' overschreven. De standaardwaarde van 0 bepaalt dat er geen specifieke hoogte is opgegeven |
Horizontale uitlijning | N.v.t. | Links, Midden, Rechts | Tekstblok: Links Afbeelding: Links |
Bepaalt hoe dit element horizontaal wordt gepositioneerd. Voor aangepaste formulieren wordt hiermee beschreven hoe de achtergrondafbeelding moet worden uitgelijnd als deze moet worden bijgesneden of als de modus Vullen herhalen wordt gebruikt |
Id | Nee | Tekstwaarde | Is afhankelijk van het element | Unieke id voor de waarde. Wordt gebruikt om verzamelde invoer te identificeren wanneer de actie Verzenden wordt uitgevoerd. Als tijdelijk een ongeldige id wordt gebruikt en de formulierontwerper is gesloten, is de laatst gebruikte geldige id van toepassing |
Opgegeven invoer negeren | N.v.t. | Booleaanse waarde | Onwaar | Indien deze actie is ingeschakeld, sluit deze actie het formulier zonder de geselecteerde invoer op te slaan en werkt deze als de knop Annuleren |
Cursief | N.v.t. | Booleaanse waarde | Onwaar | Indien ingeschakeld, wordt de tekst cursief gemaakt |
Label | Ja | Tekstwaarde | Label voor deze invoer | |
Maximale lengte | Nee | Numerieke waarde | 0 | Geeft het maximumaantal te verzamelen tekens op. De standaardwaarde van 0 bepaalt dat er geen maximumlengte is opgegeven |
Maximumaantal regels | Nee | Numerieke waarde | 0 | Geeft het maximumaantal weer te geven regels op. De standaardwaarde van 0 bepaalt dat er geen maximumaantal regels is opgegeven |
Maximale waarde | Ja | Tekstwaarde | Hint van maximumwaarde. Voor datum- en tijdinvoer moet de waarde worden uitgedrukt in het regionale indeling van uw machine | |
Maximale breedte | Nee | Numerieke waarde | 0 | Geeft de maximale breedte van het tekstblok in pixels op. De standaardwaarde van 0 bepaalt dat er geen maximumbreedte is opgegeven |
Minimumhoogte in pixels | Nee | Numerieke waarde | 0 | Geeft de minimale hoogte van het formulier aan. De standaardwaarde van 0 bepaalt dat er geen minimale hoogte is opgegeven |
Minimumwaarde | Ja | Tekstwaarde | Hint van minimumwaarde. Voor datum- en tijdinvoer moet de waarde worden uitgedrukt in het regionale indeling van uw machine | |
Meerdere regels | N.v.t. | Booleaanse waarde | Onwaar | Indien ingeschakeld, zijn meerdere invoerregels toegestaan |
Patroon | Ja | Tekstwaarde | Reguliere expressie die de vereiste indeling van deze tekstinvoer aangeeft | |
Scheidingsteken | N.v.t. | Booleaanse waarde | False | Indien ingeschakeld, wordt er een scheidingslijn getekend boven aan het element |
Grootte | N.v.t. | Tekstblok: Standaard, Klein, Gemiddeld, Groot, Extra groot Afbeelding: Auto, Uitrekken, Klein, Normaal, Groot |
Tekstblok: Standaard Afbeelding: Auto |
Bepaalt de grootte van de tekst of afbeelding |
Spatiëring | N.v.t. | Standaard, Geen, Klein, Normaal, Groot, Extra groot, Opvulling | Standaard | Bepaalt de afstand tussen dit element en het voorafgaande element |
Doorhalen | N.v.t. | Booleaanse waarde | Onwaar | Indien ingeschakeld, wordt de tekst doorgestreept |
Stijl | N.v.t. | Tekstinvoer: Tekst, Tel, URL, E-mail Invoer van keuzeset: Compact, Uitgebreid Afbeelding: Standaard, Persoon |
Tekstinvoer: Tekst Invoer van keuzeset: Compact Afbeelding: Standaard |
De stijl van de teksthint, keuzeset of afbeelding |
Subtiel | N.v.t. | Booleaanse waarde | Onwaar | Indien ingeschakeld, wordt de tekst enigszins afgezwakt weergegeven zodat deze minder prominent is |
Tekst | Ja | Tekstwaarde | Nieuw tekstblok | Tekst die moet worden weergegeven |
Titel | Ja | Tekstwaarde | Invoer in-/uitschakelen: Nieuwe invoer in-/uitschakelen Verzenden: OK |
Titel voor het aangepaste formulier of schakelknop of label voor de knop die deze actie vertegenwoordigt |
URL | Ja | Tekstwaarde | De URL van de afbeelding (voor afbeeldingselement en aangepast formulier) of de URL die moet worden geopend (voor actie URL openen) | |
Validatie vereist | Ja | Booleaanse waarde | Onwaar | Bepaalt of deze invoer vereist is of niet |
Waarde indien uitgeschakeld | Ja | Tekstwaarde | Onwaar | De waarde als de schakelknop is uitgeschakeld |
Waarde indien ingeschakeld | Ja | Tekstwaarde | Waar | De waarde als de schakelknop is ingeschakeld |
Verticale uitlijning | N.v.t. | Boven, Midden, Onder | Hiermee wordt beschreven hoe de afbeelding moet worden uitgelijnd als deze moet worden bijgesneden of als de modus Vullen herhalen wordt gebruikt | |
Verticale inhoudsuitlijning | N.v.t. | Boven, Midden, Onder | Boven | Hiermee wordt gedefinieerd hoe de inhoud verticaal moet worden uitgelijnd binnen de container. Alleen relevant voor formulieren met vaste hoogte of formulieren met een gespecificeerde minimale hoogte |
Gewicht | N.v.t. | Standaard, Lichter, Vetter | Standaard | Bepaalt het gewicht van de tekst |
Breedte in pixels | Nee | Numerieke waarde | 0 | De gewenste schermbreedte van de afbeelding. Hiermee wordt de eigenschap 'Grootte' overschreven. De standaardwaarde van 0 bepaalt dat er geen specifieke breedte is opgegeven |
Terugloop | N.v.t. | Booleaanse waarde | False | Indien ingeschakeld, kan tekst teruglopen. Anders wordt tekst afgekapt |
Bekende problemen en beperkingen
Probleem: Het voorbeeldvenster lijkt te werken zoals verwacht wanneer de URL-eigenschap percentagetekens bevat, maar er treedt een validatiefout Ongeldige waarde op.
Oplossing: dit probleem treedt op omdat Power Automate probeert de percentagetekens te herleiden tot variabelen of expressies. Om dit op te lossen, slaat u de URL eerder in de stroom op in een variabele, voert u escaping uit op de percentagetekens en gebruikt u die variabele vervolgens in de eigenschap URL. In het voorbeeld wordt de afbeelding niet weergegeven, maar deze wordt wel weergegeven tijdens runtime.