Vodič: Upotreba Microsoft Power Platform CLI-ja s portalima

U ovom primjeru vodiča vidjet ćete kako započeti s radom Microsoft Power Platform CLI-ja za ažuriranje uzorka konfiguracije portala.

Napomena

Ovaj se vodič usredotočuje na potrebne komande Microsoft Power Platform CLI za upotrebu portala Power Apps. Više informacija o naredbama koje se koriste u CLI-ju platforme Power Platform možete pornaći u odjeljku Uobičajene naredbe.

Preuzimanje i instalacija značajke Visual Studio Code

Za povezivanje na portale Power Apps i za upotrebu komandi Microsoft Power Platform CLI, koristite Visual Studio Code i integrirani terminal. Integrirani terminal olakšava povezivanje s Dataverse okruženjem te za preuzimanje, promjenu i prijenos konfiguracije portala. Umjesto toga možete koristiti i Windows PowerShell.

1. korak Provjera autentičnosti

Prije povezivanja navedite, preuzmite ili prenesite sve promjene za portal Power Apps, prvo se morate prijaviti u okruženje Dataverse. Više informacija o provjeri autentičnosti s pomoću Microsoft Power Platform CLI-a, pronađite na Microsoft Power Platform CLI – Auth.

Da biste provjerili autentičnost, otvorite Windows PowerShell i pokrenite sljedeću naredbu koristeći svoj URL Dataverse okruženja:

pac auth create -u [Dataverse URL]

Primjer

pac auth create -u https://contoso-org.crm.dynamics.com

Slijedite upute za provjeru autentičnosti da biste se prijavili u okruženje.

Primjer provjere autentičnosti za okruženje Dataverse s pomoću Microsoft Power Platform CLI.

2. korak Popis dostupnih portala

Koristite naredbu popis za popis dostupnih portala platforme Power Apps u Dataverse okruženju s kojim ste se povezali u prethodnom koraku.

pac paportal list

Primjer popisa portala.

3. korak Preuzimanje sadržaja portala

Preuzmite sadržaj web-mjesta portala iz povezanog okruženja Dataverse.

pac paportal download --path [PATH] -id [WebSiteId-GUID]

Primjer

pac paportal download --path c:\pac-portals\downloads -id d44574f9-acc3-4ccc-8d8d-85cf5b7ad141

Za parametar id koristite WebSiteId vraćen iz rezultata prethodnog koraka.

Primjer preuzimanja sadržaja portala.

4. korak Promjena sadržaja portala

Promijenite konfiguraciju s pomoću značajke Visual Studio Code i spremite promjene.

Napomena

Obavezno ažurirajte samo podržane tablice za upotrebu s Power Platform CLI. Više informacija potražite u odjeljku Podržane tablice.

Na primjer, zadana stranica portala prikazuje tekst poput ovog:

Uzorak teksta stranice portala

Ovaj je tekst vidljiv na html u web-stranice:

Visual Studio Code s tekstom istaknutim za promjenu.

Možete izmijeniti ovaj tekst i spremiti promjene:

Ažuriran tekst s pomoću koda Visual Studio Code.

Savjet

Možete promijeniti lokaciju putanje mape u PowerShell/integriranom terminalu na preuzeto mjesto i unijeti „kod.” da biste mapu otvorili izravno u značajci Visual Studio Code.

5. korak Prijenos promjena

Napomena

Ako prenosite u više okruženja, pročitajte članak Prijenos promjena pomoću profila za implementaciju da biste saznali kako prenijeti promjene pomoću profila za implementaciju.

Nakon što izvršite potrebne promjene, prenesite ih s pomoću sljedeće naredbe:

pac paportal upload --path [Folder-location]

Primjer

pac paportal upload --path C:\pac-portals\downloads\custom-portal\

Početak prijenosa.

Napomena

Provjerite je li točna putanja za sadržaj portala koji ste unijeli. Prema zadanim postavkama, kreira se mapa koju je portal imenovao (neslužbeni naziv) s preuzetim sadržajem portala. Na primjer, ako je neslužbeni naziv portala prilagođeni portal, putanja za gornju naredbu (--path) trebala bi biti C:\pac-portali\preuzimanja\custom-portal.

Prijenos se događa samo za sadržaj koji je izmijenjen. U ovom primjeru, budući da je promjena izvršena na web-stranici, sadržaj se prenosi samo za tablicu adx_webpage.

Prijenos dovršen samo za promijenjeni sadržaj.

Prijenos promjena pomoću profila za implementaciju

Kada radite s više različitih okruženja, razmislite o korištenju profila za implementaciju kako biste osigurali da se promjene prenesu u ispravno okruženje pomoću profila implementacije.

  1. Stvorite mapu pod nazivom deployment-profiles unutar mape koja sadrži sadržaj portala. Na primjer, ako se preuzeti sadržaj portala nalazi unutar "starter-portala", mapa profila implementacije trebala bi biti unutar ove mape.

    Mapa za profile implementacije

  2. Unutar mape profila implementacije stvorite YAML datoteku implementacije koja sadrži promjene specifične za okoliš. Na primjer, razvojno okruženje može se nazvati "dev.deployment.yml".

    Yaml profila implementacije za dev

  3. Uredite YAML datoteku implementacije pomoću Visual Studio koda u sljedećem obliku:

    <table-name>:
    - <record-id>: <GUID>
      <column-name>: <Name>
      <column-value>: <Value>
    

    Na primjer, sljedeći ogledni YAML kod ažurira vrijednost za "Sufiks naslova preglednika" iz zadanog "Prilagođeni portal" u "Prilagođeni portal (Dev)".

    adx_contentsnippet:
        - adx_contentsnippetid: 76227a41-a33c-4d63-b0f6-cd4ecd116bf8 # Replace with your content snippet ID
          adx_name: Browser Title Suffix # Setting name
          adx_value:  &nbsp;· Custom Portal (Dev) # Setting value
    
  4. Da biste prenijeli promjene u drugo okruženje pomoću YAML datoteke profila za implementaciju, najprije provjerite autentičnost na ciljnoj organizaciji.

  5. Nakon provjere autentičnosti i povezivanja s ispravnim okruženjem, za prijenos sadržaja koristite sljedeću naredbu:

    pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile dev

    Napomena

    U gornjem primjeru korišteni naziv profila implementacije je "dev" nakon što slijedi prethodne korake za stvaranje profila implementacije dev. Promijenite naziv iz "dev" u bilo koji drugi (kao što je QA za "qa.deployment.yml" ili Test za "test.deployment.yml") ako ste za YAML datoteku implementacije koristili drugi naziv datoteke.

6. korak Potvrda promjena

Da biste potvrdili promjene izvršene na web-stranici portala:

  1. Očistite predmemoriju na poslužitelju, ili koristite Konfiguracija sinkronizacije s pomoću portala Power Apps Studio.

  2. Pregledajte web-stranicu portala da biste vidjeli promjenu.

    Pogledajte ažurirani sadržaj stranice.

  3. Ako ste prethodno objasnili primjer profila implementacije, YAML isječak ažurirat će vrijednost kao što je prikazano u nastavku.

    Sufiks naslova preglednika iz aplikacije Upravljanje portalima

    Sufiks naslova preglednika ažuriran gore navedenom promjenom prikazuje promjenu kada otvorite portal u pregledniku:

    Promjena preglednika

Ovim završava vodič. Možete ponoviti gornje korake i sadržaj portala promijeniti za ostale podržane tablice.

Sljedeći koraci

Pregled podrške portala za Microsoft Power Platform CLI

Pogledajte također