De opdrachtbalk aanpassen met de opdrachtontwerper

Artikel
01/11/2024

Dit artikel helpt u bij het maken en bewerken van moderne opdrachten met behulp van de opdrachtontwerper en Power Fx.

De appontwerper openen

Maak een nieuwe modelgestuurde app met behulp van moderne appontwerper of open een bestaande modelgestuurde app met de moderne appontwerper.

Een nieuwe modelgestuurde app maken of bewerken met een moderne appontwerper

Meld u aan bij Power Apps.
Selecteer in het linkernavigatiedeelvenster de optie Oplossingen. Als het item zich niet in het deelvenster van het zijpaneel bevindt, selecteert u …Meer en selecteert u vervolgens het gewenste item.
Open of maak een oplossing om de nieuwe modelgestuurde app te bevatten.
Selecteer Nieuw > App > Modelgestuurde app.
Voer een naam in voor uw app en selecteer vervolgens Maken. Meer informatie: Een modelgestuurde app maken die een accounttabelpagina bevat

Een modelgestuurde app openen met een moderne appontwerper

Aanmelden bij Power Apps
Selecteer in het linkernavigatiedeelvenster de optie Oplossingen. Als het item zich niet in het deelvenster van het zijpaneel bevindt, selecteert u …Meer en selecteert u vervolgens het gewenste item.
Open de oplossing met de bestaande modelgestuurde app.
Selecteer de modelgestuurde app en selecteer vervolgens ... > Bewerken om de moderne appontwerper te openen.

Moderne opdrachten maken of bewerken

Als u eenmaal in de appontwerper bent, gebruikt u de opdrachtontwerper om uw opdrachtbalken aan te passen.

Notitie

Momenteel is de opdrachtontwerper alleen toegankelijk via de moderne appontwerper of binnen oplossingen voor bestaande opdrachten.
Reeds bestaande klassieke opdrachten kunnen op dit moment niet worden bewerkt binnen de opdrachtontwerper.

De opdrachtbalk bewerken

De opdrachtontwerper openen om een opdrachtbalk te bewerken

Selecteer elke gewenste tabel uit het gebied Pagina's in de appontwerper.
Selecteer ... en selecteer dan Bewerk opdrachtbalk.
Selecteer de locatie van de gewenste opdrachtbalk en selecteer vervolgens Bewerking. Meer informatie: Commandobalk locaties

Een nieuwe opdracht maken

In tegenstelling tot klassieke opdrachten worden moderne opdrachten alleen weergegeven in de app welke u aan het bewerken bent. Dit voorkomt dat ongewenste opdrachten worden overgedragen naar andere apps en zorgt ervoor dat de runtime-prestaties worden verbeterd.

De eerste keer dat de opdrachtontwerper wordt geopend voor een app, wordt een prompt weergegeven of u alleen JavaScript of Power Fx wilt gebruiken. Als u Power Fx selecteert, kunt u desgewenst ook JavaScript gebruiken. Bij selectie van Power Fx in het dialoogvenster wordt een onderdelenbibliotheek voor opdrachten gemaakt om Power Fx-formules op te slaan.

Open de opdrachtontwerper om een opdrachtbalk te bewerken en selecteer vervolgens + Nieuw opdracht.
Voer in het rechterdeelvenster een van de volgende opties in of selecteer deze:
- Label (optioneel). Voer een label in dat wordt weergegeven op de opdrachtknop.
- Pictogram. Selecteer een pictogram voor de opdrachtknop. U kunt kiezen uit alle systeempictogrammen of SVG-bestanden voor webbronnen. Om uw eigen pictogram te uploaden, kiest u Webbron upload dan een SVG formaat bestand. Selecteer vervolgens Opslaan en Publiceer de webresource. Ga voor meer informatie over het maken van een webresource voor de gewenste pictogramafbeelding naar Maak of bewerk modelgestuurde app-webresources om een app uit te breiden.
- Actie. Selecteer een van de volgende:
  - Formule uitvoeren. Voer de Power Fx-formule in om de opdrachtactie uit te voeren. Meer informatie: Power Fx gebruiken voor acties en zichtbaarheid
  - JavaScript. Geef de JavaScript-bibliotheek en de opdracht op om de opdrachtactie uit te voeren. Meer informatie: JavaScript gebruiken voor acties
- Zichtbaarheid. Selecteer Weergeven of Weergeven op voorwaarde van formule voor de opdrachtknop.
- Titel van knopinfo (optioneel). Voer een titel voor knopinfo in. De titel verschijnt voor de gebruiker wanneer hij zijn muis over de opdracht beweegt.
- Beschrijving van knopinfo (optioneel). Voer een beschrijving van de knopinfo in. De beschrijving verschijnt voor de gebruiker wanneer hij zijn muis over de infoknop beweegt.
- Tekst toegankelijkheid (optioneel). Voer de tekst in die door schermlezers zal worden gelezen.
- Ordernummer. De volgorde waarin de opdracht tijdens runtime wordt weergegeven in relatie tot andere opdrachten binnen dezelfde opdrachtbalk.
Sleep de opdracht en zet ze neer om stromen te vormen. U kunt moderne opdrachten ordenen tussen bestaande klassieke opdrachten.
Selecteer Opslaan en publiceren om de opdracht beschikbaar te maken voor andere app-gebruikers.
Afspelen selecteren om de app uit te voeren en uw wijzigingen te testen

Notitie

Het publiceren van Power Fx-formules in de onderdelenbibliotheek voor opdrachten kan enkele minuten duren. Deze achtergrondbewerking is mogelijk nog aan de gang nadat de opdrachtontwerper de aanvraag heeft voltooid en de ontwerper heeft ontgrendeld.

Power Fx gebruiken voor acties en zichtbaarheid

U kunt Power Fx gebruiken voor zowel acties (wat er gebeurt als de opdrachtknop is geselecteerd) als voor zichtbaarheid (logica om te bepalen wanneer de knop zichtbaar is). Power Fx wordt niet ondersteund in klassieke opdrachten.

U zult merken dat de opdracht modelgestuurde app een formulebalkervaring heeft die vergelijkbaar is met canvas-apps. Voor het werken met Dataverse-gegevens kunt u Power Fx-formules gebruiken, net zoals u zou doen in canvas-apps. Meer informatie: Power Fx gebruiken met opdrachten

Notitie

Dataverse is momenteel de enige gegevensbron die wordt ondersteund met opdrachten in modelgestuurde apps.
U kunt momenteel geen extra tabellen als gegevensbronnen rechtstreeks vanuit de opdrachtontwerper toevoegen. U kunt echter de opdrachtcomponentenbibliotheek in canvas studio openen en extra tabellen als gegevensbronnen toevoegen en deze vervolgens gebruiken in de opdrachtontwerper.
Niet alle functies die beschikbaar zijn in canvas-apps worden momenteel ondersteund voor modelgestuurde app-opdrachten. Daarnaast hebben we enkele nieuwe functies geïntroduceerd die specifiek zijn voor modelgestuurde app-opdrachten.
Zie Bekende beperkingen met moderne opdrachten voor meer beperkingen met moderne opdrachten.

JavaScript gebruiken voor acties

JavaScript wordt ondersteund met zowel klassieke als moderne opdrachten. Het is echter eenvoudiger om opdrachten te maken en uw JavaScript te koppelen met behulp van de moderne opdrachtontwerper.

Voor de Actie selecteer JavaScript uitvoeren.
Selecteer Bibliotheek toevoegen of selecteer een andere uit de lijst. De lijst wordt gevuld met alle bibliotheken die door de huidige opdrachtbalk worden gebruikt.
Selecteer Toevoegen en zoek naar bestaande JavaScript-webbronnen of u kunt uw eigen bronnen toevoegen.
Voer de Functienaam in. Selecteer bijvoorbeeld de Main_system_library.js bibliotheek en vervolgens roep deze functie aan: XrmCore.Commands.Open.opennewrecord.
Voeg parameters toe om door te geven aan uw functie.