Onderdelenbibliotheek

In het overzichtsartikel voor het maken van onderdelen krijgt u informatie over onderdelen in een canvas-app. Wanneer u onderdelen in een app maakt, kunt u ook een bibliotheek met onderdelen maken die u opnieuw kunt gebruiken. Door een onderdeelbibliotheek te maken, kunnen app-makers eenvoudig een of meer onderdelen delen en bijwerken met andere makers.

Onderdelenbibliotheken zijn containers met onderdeeldefinities die het gemakkelijk maken om:

  • Ontdek en zoek componenten.
  • Updates publiceren.
  • App-makers op de hoogte brengen van beschikbare updates voor onderdelen.

Notitie

Onderdelenbibliotheken zijn de aanbevolen manier om onderdelen in apps te hergebruiken. Wanneer een onderdelenbibliotheek wordt gebruikt, behoudt een app afhankelijkheden van de onderdelen die worden gebruikt. De app-maker wordt gewaarschuwd wanneer updates voor afhankelijke onderdelen beschikbaar komen. Maak daarom herbruikbare onderdelen in onderdeelbibliotheken. Een vroegere Power Apps-functie die het importeren van onderdelen van een canvas-app naar een andere mogelijk maakte, is buiten gebruik gesteld.

Verschil tussen een app en een onderdelenbibliotheek

Een onderdelenbibliotheek biedt een gecentraliseerde en beheerde opslagplaats voor onderdelen die kunnen worden hergebruikt.

Het deelvenster Invoegen in het linkernavigatievenster bevat standaard een onderdelentabblad als u een onderdelenbibliotheek maakt. Wanneer u een app maakt, worden in deze weergave schermen weergegeven in plaats van onderde3len.

Notitie

De schermen in een onderdeelbibliotheek zijn alleen beschikbaar voor testen. Het biedt makers van bibliotheken een manier om snel de gemaakte onderdelen op een echt scherm te testen en ook het bijwerkgedrag te valideren, aangezien onderdelen in de loop van de tijd worden verbeterd. Om de onderdelen uit de bibliotheek te gebruiken, moet u een app maken die de onderdelenbibliotheek gebruikt.

U kunt componenten uit de componentbibliotheek vooraf bekijken door de schermen in de bibliotheek te gebruiken met de optie Afspelen. Wanneer u het onderdelentabblad selecteert, is de afspeeloptie uitgeschakeld. De onderdelenbibliotheek wordt niet weergegeven wanneer Power Apps Mobile wordt gebruikt.

Notitie

De onderdelenbibliotheek die in dit artikel wordt besproken, verschilt van het Power Apps component framework waarmee ontwikkelaars en makers codeonderdelen kunnen maken voor modelgestuurde en canvas-apps. Zie Power Apps component framework overview voor meer informatie.

Werken met de onderdelenbibliotheek

U kunt vanuit dezelfde interface een nieuwe onderdelenbibliotheek maken of een bestaande onderdelenbibliotheek bewerken. Ga naar Power Apps> selecteer Meer in de linkernavigatie > selecteer Ontdek alles> selecteer Onderdelenbibliotheken in het gedeelte App-verbeteringen. U kunt de optie Componentbibliotheken ook vastzetten op uw Power Apps-interface. Zie Linkernavigatie in Power Apps voor meer informatie.

Een voorbeeldonderdelenbibliotheek maken

De stappen voor het maken van onderdelen in een onderdelenbibliotheek zijn hetzelfde als voor het maken van onderdelen in een app. U maakt een onderdelenbibliotheek en hergebruikt vervolgens de stappen voor het maken van onderdelen vanuit voorbeeld van onderdelenoverzicht. Vervolgens gebruikt u de onderdeelbibliotheek om de herbruikbare onderdelen in een nieuwe app op te geven.

  1. Aanmelden bij Power Apps.

  2. Selecteer Onderdelenbibliotheken in het linkernavigatievenster en selecteer vervolgens Nieuwe onderdelenbibliotheek.. Als u onderdeelbibliotheken niet ziet in het linkernavigatievenster, selecteert u Meer in het linkernavigatievenster, selecteert u de knop Alles ontdekken en selecteert u Onderdeelbibliotheken in de sectie App-verbeteringen .

  3. Geef de componentbibliotheek de naam Menu components; of kies een andere naam.

  4. Volg de stappen om onderdelen te maken vanuit het voorbeeld van onderdelenoverzicht. U hoeft Power Apps Studio niet te openen of een nieuwe lege app te maken, omdat u al een nieuwe onderdeelbibliotheek hebt gemaakt. Begin met stap 2.

    Nadat u de stappen hebt gevolgd om onderdelen te maken, volgt u ook de volgende reeks stappen voor onderdelen aan een scherm toevoegen en de stappen voor uitvoereigenschap maken.

  5. Nadat u de onderdelen hebt gemaakt en getest, slaat u de onderdeelbibliotheek op door het pictogram Opslaan te selecteren in de app-acties.

    U kunt ook opslaan met versienotities onder het pijlmenu naast het pictogram Opslaan . Een versieopmerking is handig om versies van een onderdelenbibliotheek op te halen en voor het upgraden van de onderdelen die in apps worden gebruikt vanuit deze onderdelenbibliotheek. Zie het artikel Understand Power Apps Studio voor meer informatie over app-acties.

    Versieopmerking bij het opslaan van een onderdelenbibliotheek.

    Tip

    Een versieopmerking is handig bij het bekijken van versies van een onderdelenbibliotheek en voor de app-makers die uw onderdelenbibliotheek gebruiken om wijzigingen te beoordelen en apps bij te werken die deze onderdelen naar behoefte gebruiken. Ga naar een onderdelenbibliotheek bijwerken voor meer informatie.

  6. U kunt een opgeslagen onderdeelbibliotheek publiceren. Alleen gepubliceerde updates van de onderdelenbibliotheek zijn beschikbaar voor apps die een onderdelenbibliotheek gebruiken. Selecteer het pictogram Publiceren in de app-acties om de versie van de onderdeelbibliotheek te publiceren:

    Onderdelenbibliotheekversie publiceren.

Aanpassing van bibliotheekonderdelen

Wanneer u een onderdeel in een onderdeelbibliotheek maakt, kunt u instellen of apps die gebruikmaken van de bibliotheekonderdelen het onderdeel kunnen aanpassen. Deze instelling is standaard ingeschakeld in de onderdeleneigenschappen. Schakel deze instelling uit om de mogelijkheid om het onderdeel in andere apps aan te passen, te verwijderen.

Optie om aanpassing van dit onderdeel toe te staan wanneer het door een app wordt gebruikt.

Wanneer u een onderdeel toevoegt dat aanpassing toestaat, ziet u een optie om dit onderdeel te bewerken voor meer aanpassingen. De app maakt een lokale kopie en u kunt wijzigingen aanbrengen in de kopie van het lokale onderdeel. De koppeling met de onderdeelbibliotheek wordt verwijderd zodra u het onderdeel bewerkt.

Een onderdeel bewerken dat mag worden aangepast.

Als u Onderdeel bewerken selecteert, wordt u gevraagd om het onderdeel lokaal te kopiëren voor aanpassing.

Als u niet toestaat dat de onderdelen worden aangepast, worden in de verbruikende apps de optie voor het bewerken van het onderdeel niet weergegeven.

Geen optie om onderdeel te bewerken in app die het onderdeel verbruikt.

In dit geval is de enige manier om het onderdeel te bewerken de onderdelenbibliotheek te bewerken waarin het onderdeel is opgeslagen.

Importeren vanuit een onderdelenbibliotheek

Nadat u een onderdeelbibliotheek hebt gemaakt en gepubliceerd, kunnen apps de onderdelen uit deze onderdeelbibliotheek gebruiken door de bibliotheek te importeren. U kunt ook een onderdelenbibliotheek delen.

Bewerk een bestaande app of maak een nieuwe app om uit een onderdelenbibliotheek te importeren. Nadat de app is geopend in Canvas-appstudio, selecteert u Invoegen of + in de linkernavigatie. Selecteer Meer onderdelen ophalen om de onderdelenbibliotheken weer te geven die beschikbaar zijn in de huidige omgeving:

Meer onderdelen ophalen.

U ziet de lijst met onderdeelbibliotheken die beschikbaar zijn in de huidige omgeving aan de rechterkant van het scherm. Selecteer een afzonderlijk onderdeel uit een componentbibliotheek. Of gebruik Alles selecteren om alle onderdelen tegelijk uit de bibliotheek te importeren:

Onderdelen importeren.

Notitie

Als een maker de onderdelenbibliotheek niet ziet in de importsectie, zorg er dan voor dat de onderdelenbibliotheek wordt gedeeld met de maker. Zie machtigingen voor de onderdelenbibliotheek voor meer informatie.

Notitie

U kunt meerdere onderdelen en in verschillende onderdeelbibliotheken selecteren en importeren.

Onderdelen die beschikbaar zijn in de app worden weergegeven onder de categorie Aangepast in de lijst met onderdelen in het deelvenster Invoegen. Onderdelen die beschikbaar zijn in geïmporteerde onderdelenbibliotheken, worden weergegeven onder de categorie Bibliotheekonderdelen:

Onderdelen in de app invoegen.

Een onderdelenbibliotheek bijwerken

U kunt een bestaande onderdelenbibliotheek wijzigen en eventuele wijzigingen opslaan met andere versie-opmerkingen. De bijgewerkte versie van de onderdelenbibliotheek moet echter worden gepubliceerd voor gebruik in bestaande apps die de onderdelenbibliotheek gebruiken. In de stappen van de voorbeeldonderdeelbibliotheek wordt uitgelegd hoe u een onderdeelbibliotheek publiceert nadat u deze hebt opgeslagen.

Er zijn twee manieren waarop apps die de componenten uit de bibliotheek gebruiken, de laatste wijzigingen kunnen krijgen.

Methode 1: Melding van een update van onderdelen bij het bewerken van een app

Makers van andere apps krijgen een melding wanneer bijgewerkte onderdelen beschikbaar zijn. De melding verschijnt wanneer makers de apps bewerken in de canvas-appstudio. Ze kunnen ervoor kiezen de onderdelen bij te werken:

Update beschikbaar.

Selecteer Beoordelen, en dan ziet u de optie om de component bij te werken:

Onderdeel bijwerken.

Versieopmerkingen die u toevoegt wanneer u de versie van de onderdeelbibliotheek publiceert, worden hier weergegeven.

Selecteer Bijwerken om de onderdelen bij te werken.

Methode 2: Proactieve controle op updates

Gebruik deze methode om proactief te controleren op de app-update terwijl u aan de app in Studio werkt.

Als u dit wilt controleren, selecteert u het deelvenster Onderdeel invoegen aan de linkerkant en selecteert u vervolgens het pictogram Controleren op updates .

Controleren op de nieuwste onderdelen

Als er updates zijn voor onderdelen die in de bibliotheek worden gebruikt, krijgt u een bericht om de meest recente wijzigingen te bekijken en op te halen. Wanneer u de app bekijkt en bijwerkt, wordt de app bijgewerkt met de nieuwste onderdelen.

Een onderdeel bijwerken vanuit een onderdelenbibliotheek in een app waarin het onderdeel wordt gebruikt

Als u een onderdeel uit een onderdelenbibliotheek importeert, kunt u dit niet bewerken in de app waarin het onderdeel wordt gebruikt. Als u Het onderdeel Bewerken selecteert, ziet u een optie voor het maken van een kopie van het onderdeel in de huidige app, zodat u wijzigingen kunt aanbrengen:

Bibliotheekonderdeel bewerken.

Als u Een kopie maken selecteert, wordt het onderdeel gekopieerd naar de lokale app. De lokale kopie van het onderdeel wordt weergegeven onder de categorie Aangepast in het deelvenster Invoegen. Deze lokale kopie van het onderdeel ontvangt geen updates als een nieuwe versie van de oorspronkelijke onderdeelbibliotheek later wordt gepubliceerd.

Notitie

De in-use exemplaren van onderdelen uit de onderdeelbibliotheek worden niet beïnvloed nadat u een lokale kopie van een onderdeel hebt gemaakt en gekoppeld bent aan de definitie van de onderdeelbibliotheek. Alleen exemplaren van de lokaal gekopieerde onderdelen (uit de categorie Aangepast) worden aangemerkt als de lokale app-componenten.

Een onderdelenbibliotheek verwijderen

Als er door een canvas-app naar een onderdelenbibliotheek wordt verwezen, kan deze niet worden verwijderd. Deze voorwaarde geldt voor zowel Power Platform- als niet-Power Platform-omgevingen. Verwijder het onderdeel uit de app voordat u de bibliotheek verwijdert. U kunt informatie vinden over de apps die de onderdelenbibliotheek gebruiken, in de weergave van oplossingsafhankelijkheden of in het bericht dat wordt weergegeven wanneer u de bibliotheek probeert te verwijderen.

Een bibliotheekonderdeel verwijderen.

Machtigingen voor componentbibliotheken

Het delen van een onderdelenbibliotheek werkt op dezelfde manier als het delen van een canvas-app. Wanneer u een onderdelenbibliotheek deelt, staat u anderen toe de onderdelenbibliotheek opnieuw te gebruiken. Eenmaal gedeeld, kunnen anderen de onderdelenbibliotheek bewerken en onderdelen uit deze gedeelde bibliotheek importeren voor het maken en bewerken van apps. Indien een gebruiker als mede-eigenaar een onderdelenbibliotheek heeft gedeeld, kan deze gebruiker een onderdelenbibliotheek gebruiken, bewerken en delen, maar de eigenaar niet verwijderen of wijzigen.

Aanvullende overwegingen bij het delen van onderdelenbibliotheken met beveiligingsgroepen:

  • U kunt de UI voor delen niet gebruiken bij het delen van onderdelenbibliotheken die zijn gemaakt als onderdeel van een oplossing. Gebruik in plaats daarvan de Set-PowerAppRoleAssignment-cmdlet met het machtigingsniveau CanEdit om de onderdelenbibliotheken te delen met de geselecteerde beveiligingsgroep.
  • Onderdelenbibliotheken gemaakt in een Power Platform-omgeving zonder een Dataverse-database gedeeld als Mede-eigenaar kennen automatisch de machtiging CanEdit toe aan de geselecteerde beveiligingsgroep.

Bekende beperkingen

  • Bekende beperkingen die van toepassing zijn op onderdelen zijn ook van toepassing op onderdeelbibliotheken.

  • U kunt geen onderdelen importeren uit een lokaal opgeslagen onderdelenbibliotheek. U kunt een onderdeelbibliotheek downloaden door een kopie downloaden uit de app-acties te selecteren. Maar als u probeert de opgeslagen onderdeelbibliotheek te importeren, ziet u het volgende foutbericht:

    Onderdelenbibliotheekbestand importeren.

  • Als u voor de eerste keer een app en een onderdelenbibliotheek in een omgeving importeert, moet u ervoor zorgen dat de app de nieuwste versie gebruikt van het onderdeel dat in de onderdelenbibliotheek is opgenomen. Anders ontvangt de app geen updates na het importeren. De app herkent en vraagt om de bijgewerkte versie bij het importeren van de volgende onderdeelbibliotheek in dezelfde omgeving.

  • Codeonderdelen worden niet ondersteund in onderdelenbibliotheken.

Zie ook