Delen via


Catalogusartikelen weergeven, indienen en installeren

In elke organisatie kunnen er veel componenten en sjablonen zijn, verspreid over veel omgevingen. Met de catalogus Power Platform kunnen ontwikkelaars en makers het volgende doen:

  • Sjablonen en componenten eenvoudig binnen hun omgeving crowdsourcen en vinden
  • De nieuwste en gezaghebbende versie van een component vinden en installeren
  • Aan de slag gaan met sjablonen en componenten die directe waarde bieden

Belangrijk

Om items naar de catalogus te kunnen verzenden, hebt u een beheerde omgeving nodig. U kunt echter catalogusitems vanuit elke omgeving installeren. Meer informatie: Overzicht van beheerde omgevingen

Voordat u dit artikel leest, moet u:

Notitie

Ontwikkelaars kunnen ook de Power Platform CLI, Dataverse SDK voor .NET en Dataverse Web API gebruiken om de hier beschreven bewerkingen uit te voeren. Catalogus in Power Platform voor ontwikkelaars

Toegangscontroles

De catalogus heeft een aparte set toegangscontroles van Power Platform. Dit betekent dat makers in een bepaalde omgeving niet automatisch toestemming krijgen om items uit de catalogus te publiceren en op te halen. Er zijn vier toegangsrollen:

- Rol Stelt de gebruiker in staat het volgende te doen:
Catalogusindiener Items toevoegen aan de catalogus
Catalogusgebruiker Items ontdekken en installeren vanuit de catalogus
Catalogusfiatteur Inzendingen voor de catalogus goedkeuren.
Catalogusfiatteurs kunnen gebruikers zijn van uw centrale IT-afdeling of branche zijn die uw organisatie in staat wil stellen om deel te nemen aan het goedkeuringsproces.
Catalogusbeheerder De catalogus beheren.

Elke omgeving met een catalogus ziet deze rollen in het Power Platform-beheercentrum en deze kunnen worden toegewezen aan groepen of individuen, net als alle andere beveiligingsrollen.

Power Platform-beheerders en systeemaanpassers hebben al volledige toegang tot de catalogus. Wijs deze rollen echter niet toe voor het algemeen beheren van catalogustoegang, maar gebruik in plaats daarvan een van de rollen in de vorige tabel.

Verzending

Onbeheerde oplossingen in uw omgeving kunnen in de catalogus worden gepubliceerd. Tijdens uw normale proces van het creëren van oplossingen zou u kunnen besluiten dat wat u bouwt nuttig zou zijn als herbruikbaar artefact voor uzelf of anderen in uw organisatie.

Navigeer naar uw oplossingenpagina en elke onbeheerde oplossing heeft een nieuwe optie voor Publiceren naar catalogus in de drie verticale stippen naast de weergavenaam van de oplossing. Deze optie is uitgeschakeld voor iedereen zonder de rol Catalogusindiener.

Indiening van catalogus

Notitie

Deze optie is niet ingeschakeld voor beheerde oplossingen. U kunt geen beheerde oplossingen indienen bij de catalogus.

U kunt een app, stroom of andere component niet rechtstreeks in de catalogus indienen. U moet eerst controleren of deze in een onbeheerde oplossing bestaat. U kunt deze toevoegen aan een onbeheerde oplossing door Nieuwe oplossing boven aan het gebied Oplossingen te selecteren of door een bestaande component uit de lijst te kiezen, vervolgens Bestaande toevoegen te selecteren in het bovenste menu van de oplossing zelf en tot slot de gewenste component toe te voegen (zoals een app of een stroom).

Toevoegen aan oplossing

Notitie

Elke maker met de rol Catalogusindiener in een bepaalde omgeving kan publiceren. Nadat een oplossing is gepubliceerd, moet een maker echter deel uitmaken van de publicatiegroep om diezelfde oplossing opnieuw te kunnen publiceren. U ziet deze foutmelding als u geen toegang hebt. Deze kunt u aanvragen bij uw beheerder.

Toegang nodig: deze oplossing is al gepubliceerd vanwege de catalogusfout

Wanneer u Publiceren naar catalogus selecteert, is er een wizard met vier stappen:

Stap 1: Uw oplossing toevoegen

  1. Selecteer een catalogus: als u meerdere catalogi hebt ingesteld, kunt u selecteren in welke catalogus u dit item wilt publiceren.

  2. Selecteer beheerd item of sjabloon voor uw inzending.

    • Beheerde items kan niet door andere makers worden bewerkt. Uw omgeving deelt één exemplaar en van die kopie kan in de loop van de tijd een aangepaste versie worden gemaakt met updates. Makers kunnen vervolgens hun oplossingen bijwerken met uw updates.
    • Een sjabloon is een op zichzelf staande kopie die kan worden bewerkt. Makers kunnen zoveel exemplaren hebben als ze willen en zullen oplossingen in omgevingen niet automatisch bijwerken wanneer er nieuwe updates worden gepubliceerd.
  3. Een primair onderdeel selecteren: een oplossing kan veel componenten bevatten. Mogelijk wilt u dat makers een specifieke component openen om te bewerken nadat ze deze hebben geïnstalleerd, zoals het openen van Canvas Studio voor uw canvas-app. Stel de primaire component in op wat volgens u de "focus" van de oplossing is. Stel anders Niet gespecificeerd in zodat installateurs naar de oplossing zelf gaan.

Items opnieuw indienen

Als u een item opnieuw indient, ontvangt u een waarschuwingsbericht waarin u wordt geïnformeerd over de herindiening. Er wordt een versieveld weergegeven. Het laatste cijfer van het versienummer wordt automatisch voor u verhoogd. U kunt het versienummer desgewenst wijzigen, maar stel het versienummer vanuit deze interface niet in op een lager nummer. Als u het versienummer in de catalogusindiening bijwerkt, wordt ook het versienummer in de oorspronkelijke oplossing bijgewerkt.

Houd deze punten in gedachten wanneer u items opnieuw indient:

  • Het opnieuw indienen van een sjabloon vervangt het vorige item in de catalogus en heeft geen invloed op oplossingen die al gebruikmaken van het vorige catalogusitem. Makers die nu uw herindiening installeren, krijgen uw nieuwste versie.
  • Bij opnieuw indienen van beheerde artikelen wordt het catalogusitem bijgewerkt met uw meest recente versie, terwijl makers de volgende keer dat zij uw catalogusitem zien in een omgeving waarin dat catalogusitem al was geïnstalleerd, een knop Bijwerken te zien krijgen, waarmee de meest recente wijzigingen aan het beheerde item in die omgeving worden geïnstalleerd, waarna alle oplossingen die dat beheerde item gebruiken, eveneens worden bijgewerkt.
  • U kunt een beheerd item niet opnieuw als sjabloon indienen, en omgekeerd.

Stap 2: Catalogusinfo

Voer de volgende informatie in:

Veld Instructies
Title Hernoem het item indien nodig voordat het in de catalogus wordt ingediend. De naam van de oplossing is de standaardwaarde. U kunt de titel niet bewerken wanneer u een beheerd item indient.
Omschrijving Verstrek details over dit catalogusitem. Makers lezen uw beschrijving in de catalogusgalerie om er meer over te weten te komen.
Zakelijke reden Standaard moet uw beheerder alle catalogusindieningen goedkeuren voordat deze aan de catalogus worden toegevoegd. Dit veld bevat een rechtvaardiging voor uw indiening bij uw beheerder.
Werkt met Een stroom die u aan het bouwen bent, kan bijvoorbeeld bedoeld zijn om te werken met canvas-apps en model-apps. Geef hier aan waarmee uw catalogusitem moet werken.
Bedrijfscategorieën Selecteer maximaal vijf bedrijfscategorieën die uw catalogusitem beschrijven. Makers gebruiken deze categorieën om te zoeken naar catalogusitems die voor hen interessant zijn.
Uitgever Selecteer een bestaande uitgever in deze omgeving of maak een nieuwe uitgever, om verbinding te maken met deze catalogusindiening. Een maker kan een catalogusitem niet opnieuw indienen, tenzij hij of zij deel uitmaakt van de publicatiegroep die het item de eerste keer heeft ingediend.
Auteur Standaard is dit de huidige gebruiker, maar u kunt dit indien nodig wijzigen

Stap 3: Oplossingsinfo

Voer de volgende informatie in:

Veld Instructies
Oplossingspictogram Een pictogram toevoegen aan uw oplossing (216 x 216 pixels) om deze te helpen identificeren in de catalogusgalerie
sjabloonafbeeldingen Enkele schermopnamen of andere visuals toevoegen zodat makers meer details over dit catalogusitem kunnen begrijpen
Help-koppeling De URL voor Help-documentatie toevoegen
Koppeling van privacybeleid De URL voor privacybeleidsdocumentatie toevoegen
Koppeling naar juridische voorwaarden De URL voor documentatie over juridische voorwaarden toevoegen

Stap 4: controleren en voltooien

Deze laatste stap biedt een samenvatting van alle informatie die u hebt verstrekt. Als alles er goed uitziet, selecteert u Verzenden om te publiceren in de catalogus. Zoals eerder vermeld, moet u wachten op goedkeuring als uw catalogus een fiatteur vereist voordat de indiening kan worden voltooid. Neem contact op met uw beheerder of fiatteur als u het proces wilt versnellen.

Verwerving

Terwijl makers door de pagina Ontdekken bladeren en catalogusitems vinden die nuttig voor hen zijn, kunnen ze die artefacten verwerven en een kopie in hun omgeving installeren om ze te gaan gebruiken of ermee te gaan bouwen. Als u Ophalen selecteert in een sjabloon of beheerd item, wordt een pop-up met details geopend met informatie zoals een beschrijving, koppelingen, inbegrepen componenten, bedrijfscategorieën, uitvouwbare schermopnamen en meer.

Tegel Catalogusitem

Als de details overeenkomen met wat de maker zoekt, kan hij Ophalen selecteren in de pop-up met details om de aankoopwizard te starten.

Notitie

Als het catalogusitem een beheerd item is en al in de omgeving is geïnstalleerd, kunt u het beheerde item niet opnieuw installeren, omdat de omgeving dat beheerde item deelt. Als het beheerde item al in een omgeving is geïnstalleerd en er een update voor het beheerde item is gepubliceerd, ziet u een knop Bijwerken in plaats van Ophalen, waarmee de gedeelde beheerde oplossing in de omgeving wordt bijgewerkt. Als het beheerde item al is bijgewerkt en er geen nieuwe updates zijn gepubliceerd, is de knop Bijwerken uitgeschakeld totdat er een nieuwe update wordt gepubliceerd.

De aankoopwizard bestaat uit vier stappen:

Stap 1: verbindingen controleren

Bij deze stap worden de verbindingen voor de oplossing gecontroleerd om er zeker van te zijn dat ze voor u werken in uw omgeving. Als er verbindingsproblemen zijn, ziet u een rode statusmelding. Deze kunt u oplossen door het weglatingsteken (…) naast de problematische verbinding te selecteren om deze bij te werken.

Stap 2: omgevingsvariabelen

De publicerende maker kan besluiten dat bepaalde omgevingsvariabelen moeten worden opgegeven voordat u de oplossing kunt ophalen. Normaal gesproken zijn deze variabelen ingesteld op een bepaalde standaardwaarde. Als u niet zeker weet wat u moet invullen, neem dan contact op met de auteur van het catalogusitem of raadpleeg de details van de cataloguslijst, die in de catalogusdetails is te vinden. Meer informatie: Stap 2: catalogusinfo

Stap 3: configuratie

De publicerende maker bepaalt deze stap als hij of zij wil dat u aanvullende informatie verstrekt voor het gebruik van de oplossing. Dit kunnen zaken zijn als: "Op welke dagen van de week voert u een rapport uit?". Als er geen aanvullende informatie nodig is, is deze stap leeg.

Stap 4: overzicht

Wanneer u de laatste stap bereikt, het overzichtsscherm, wacht u nu tot het catalogusitem in uw omgeving is geïnstalleerd. Afhankelijk van de complexiteit kan dit minder dan een minuut tot enkele minuten duren. Wanneer u gereed bent, krijgt u verschillende opties in de vervolgkeuzelijst, afhankelijk van wat er in het catalogusitem is opgenomen en of de auteur een primaire component heeft ingesteld. Hier volgt een voorbeeld waarbij een canvas-app de primaire component van het catalogusitem is:

Installatieopties voor catalogusitems

In dit voorbeeld kunt u het volgende doen:

  • App bewerken: opent de app in Canvas Studio
  • Ga naar app: brengt u naar het app-scherm, als u nog niet gereed bent om te bewerken
  • Ga naar oplossingen: opent het oplossingsbestand

Afhankelijk van wat er in het catalogusitempakket zit, verschijnen er verschillende opties.

Nadat het catalogusitem is geïnstalleerd, kunt u het catalogusitem vinden:

  • In de lijst Onbeheerde oplossingen op de oplossingenpagina als het catalogusitem een sjabloon was
  • In de lijst Beheerde oplossingen op de oplossingenpagina als het catalogusitem een beheerd item was

Zoals eerder vermeld, kunnen sjablonen zo vaak worden opgehaald als u wilt, elk als een eigen exemplaar. De catalogus voegt een achtervoegsel toe aan de weergavenaam van de onbeheerde oplossing om de verschillende exemplaren van elkaar te onderscheiden. Beheerde items kunnen slechts één keer in de lijst met beheerde oplossingen worden opgenomen en alle makers in de omgeving delen dezelfde beheerde oplossing. Dit betekent dat u een beheerd item niet kunt terughalen naar dezelfde omgeving waarin het is gepubliceerd en de knop Bijwerken is uitgeschakeld.

Zie ook

Catalogus in Power Platform)
De catalogus beheren
Catalogus in Power Platform voor ontwikkelaars