Napomena
Za pristup ovoj stranici potrebna je autorizacija. Možete se pokušati prijaviti ili promijeniti direktorije.
Za pristup ovoj stranici potrebna je autorizacija. Možete pokušati promijeniti direktorije.
(Pretpregled) Naredbe za rad s dodatkom Power Fx.
Koristite ove naredbe za interakciju s podacima u Dataverse pomoću naredbenog retka ili skripte. Smanjite vrijeme i složenost podatkovnih operacija pomoću dodatka Power Fx.
Možete koristiti formule navedene u referenci formule – Power Platform CLI.
Naredbe
| Naredba | Opis |
|---|---|
| pac power-fx repl | (Pretpregled) Pokretanje interaktivne petlje čitanja dodatka Power FxEval-Print |
| pac power-fx run | (Pretpregled) Pokretanje datoteke s uputama za Power Fx |
pac power-fx repl
(Pretpregled) Pokretanje interaktivne petlje čitanja dodatka Power FxEval-Print
Napomena
Ako ste instalirali Power Platform CLI pomoću msi-ja sustava Windows, postoji poznati problem pac power-fx repl zbog kojeg ljuska može prestati reagirati prilikom korištenja ove naredbe.
Neobavezni parametri za power-fx repl
--environment
-env
Određuje ciljni Dataverse. Vrijednost može biti GUID ili apsolutni https URL. Kada nije navedeno, koristit će se aktivna tvrtka ili ustanova odabrana za trenutni profil za auth.
Primjedbe
Ova naredba sadrži ljusku za korištenje formula navedenih u referencama za formule – Power Platform CLI.
Pokrenite ponovno pokretanje dodatka Power Fx pokretanjem sljedeće naredbe:
pac power-fx repl
Nakon toga možete pokrenuti naredbe dodatka Power Fx.
Primjeri
Sljedeći primjeri pokazuju korištenje naredbe pac power-fx repl .
Dodavanje redaka
Collect(Contacts, { firstname: "Patti", lastname: "Fernandez" })
Dodatak Power Fx reagira sa sljedećim:
{contactid:GUID("118d7b47-8f80-ee11-8179-0022482a40c7"), fullname:"Patti Fernandez", ...}
Help
Pokrenite sljedeću naredbu da biste dobili pomoć za sve naredbe koje su dostupne u dodatku Power Fx repl:
Help()
Power Fx repl odgovara sljedećim izlazom:
Abs Acos Acot AddColumns And
Asin AsType Atan Atan2 Average
Blank Boolean Char Clear ClearCollect
Coalesce Collect ColorFade ColorValue Concat
Concatenate Cos Cot Count CountA
CountIf CountRows Date DateAdd DateDiff
DateTime DateTimeValue DateValue Day Dec2Hex
Decimal Degrees Distinct DropColumns EDate
EncodeUrl EndsWith EOMonth Error Exp
Filter Find First FirstN Float
ForAll GUID Help Hex2Dec Hour
If IfError Index Int IsBlank
IsBlankOrError IsEmpty IsError IsMatch IsNumeric
IsToday Language Last LastN Left
Len Ln Log LookUp Lower
Match MatchAll Max Mid Min
Minute Mod Month Not Notify
Now OptionSetInfo Or ParseJSON Patch
Pi PlainText Power Proper Radians
Rand RandBetween Refresh Remove Replace
RGBA Right Round RoundDown RoundUp
Second Sequence Set Shuffle Sin
Sort Split Sqrt StartsWith StdevP
Substitute Sum Switch Table Tan
Text Time TimeValue TimeZoneOffset Today
Trim TrimEnds Trunc Upper Value
VarP Weekday With Year
>>
Napomena
Te će se naredbe s vremenom promijeniti tako da uključuju više naredbi. Potrebno ga je sinkronizirati s dokumentiranom trenutno dostupnom naredbom.
Exit
Koristi Exit() se za izlaz iz naredbe repl .
pac power-fx run
(Pretpregled) Pokretanje datoteke s uputama za Power Fx
Primjeri
Sljedeći primjeri pokazuju korištenje naredbe pac power-fx run .
Napomena
U svakom od ovih primjera morate učiniti sljedeće:
Stvorite datoteku pod nazivom
test-pfx.txtIzrazi dodatka Power Fx u mapi na računalu, nprc:\test. .Otvorite prozor komponente Windows PowerShell, dođite do
testrunmape i upotrijebite naredbu koja određuje datoteku koja sadrži naredbe:pac power-fx run --file test-pfx.txt.
Da biste koristili tablice Dataverse, morate stvoriti i odabrati profil za auth. Pogledajte pac članak Stvaranje iauthpac odabir autentičnosti.
Ako se prikazuje poruka o pogrešci, provjerite Otklanjanje poteškoća.
Stvaranje zapisa za Dataverse
Dodajte sljedeći tekst i
test-pfx.txtspremite datoteku.Collect(Contacts, { firstname: "Megan", lastname: "Bowen" }) Collect(Contacts, { firstname: "Garth", lastname: "Forth" }) Collect(Contacts, { firstname: "Adele", lastname: "Vance" }) Collect(Contacts, { firstname: "Patti", lastname: "Fernandez" })Pokreni sljedeću naredbu:
PS C:\test> pac power-fx run --file test-pfx.txtRezultat možete očekivati na sljedeći način:
{contactid:GUID("80eb0c02-9180-ee11-8179-0022482a40c7"), fullname:"Megan Bowen", ...} {contactid:GUID("81eb0c02-9180-ee11-8179-0022482a40c7"), fullname:"Garth Forth", ...} {contactid:GUID("82eb0c02-9180-ee11-8179-0022482a40c7"), fullname:"Adele Vance", ...} {contactid:GUID("83eb0c02-9180-ee11-8179-0022482a40c7"), fullname:"Patti Fernandez", ...}
Slanje upita tablici s podacima
Dodajte ovaj tekst i
test-pfx.txtspremite datoteku.FirstN(Contacts, 5)Ta naredba dohvaća prvih pet kontakata iz aplikacije Dataverse.
Pokreni sljedeću naredbu:
PS C:\test> pac power-fx run --file test-pfx.txtRezultat možete očekivati na sljedeći način:
Connected to... Your Organization Connected as you@yourorg.onmicrosoft.com contactid fullname ... ============================================== ================== ===== GUID("eeb27495-d127-ed11-9db1-00224804f8e2") Yvonne McKay (sample) GUID("cba0ed9e-d127-ed11-9db1-00224804f8e2") Susanna Stubberod (sample) GUID("cea0ed9e-d127-ed11-9db1-00224804f8e2") Nancy Anderson (sample) GUID("6cc7483c-7a77-ee11-8179-00224809f375") Maria Campbell (sample) GUID("49b0be2e-d01c-ed11-b83e-000d3a572421") Sidney Higa (sample) PS C:\test>
Korištenje funkcija PowerFx
Dodajte sljedeći tekst i
test-pfx.txtspremite datoteku.Set(x, 1) Result = If( Mid( "asdf",x,1 ) = "a", "X", "Y" )U ovom se primjeru koriste funkcije Mid, Ifi Set Power Fx.
Pokrenite sljedeću naredbu:
PS C:\test> pac power-fx run --file test-pfx.txtRezultat možete očekivati na sljedeći način:
PS C:\test> pac power-fx run --file test-pfx.txt x: 1 true Result: "X" PS C:\test>Dodajte parametar
--echoi možete očekivati ovaj izlaz:PS C:\test> pac power-fx run --file test-pfx.txt --echo Set(x, 1) x: 1 true Result = If( Mid( "asdf",x,1 ) = "a", "X", "Y" ) Result: "X" PS C:\test>
Obavezni parametri za power-fx run
--file
-f
Put datoteke za izvršavanje
Neobavezni parametri za power-fx run
--echo
-e
True ako se naredbe za unos trebaju odjeknu natrag na izlaz
Ovaj parametar ne zahtijeva vrijednost. To je prekidač.
--environment
-env
Određuje ciljni Dataverse. Vrijednost može biti GUID ili apsolutni https URL. Kada nije navedeno, koristit će se aktivna tvrtka ili ustanova odabrana za trenutni profil za auth.
Rješavanje problema
U nastavku su navedeni koraci za otklanjanje pogrešaka na koje možete naići prilikom korištenja pac power-fx naredbi.
Pogreška kada ne postoji profil za provjeru autentičnosti za Dataverse
Ako nemate univerzalni profil za provjeru autentičnosti povezan s okruženjem Dataverse, može vam se prikazati ova pogreška.
PS C:\test> pac power-fx run --file test-pfx.txt
Error 8-16: Name isn't valid. 'Contacts' isn't recognized.
Error 18-59: The specified column 'firstname' does not exist.
Error 0-60: The function 'Collect' has some invalid arguments.
Error 8-16: Name isn't valid. 'Contacts' isn't recognized.
Error 18-59: The specified column 'firstname' does not exist.
Error 0-60: The function 'Collect' has some invalid arguments.
Error 8-16: Name isn't valid. 'Contacts' isn't recognized.
Error 18-59: The specified column 'firstname' does not exist.
Error 0-60: The function 'Collect' has some invalid arguments.
Error 8-16: Name isn't valid. 'Contacts' isn't recognized.
Error 18-63: The specified column 'firstname' does not exist.
Error 0-64: The function 'Collect' has some invalid arguments.
Da biste riješili takve pogreške, stvorite univerzalni profil za provjeru autentičnosti povezan s okruženjem Dataverse.
Pokrenite popispac za aute naredbi.
Možda ćete vidjeti rezultat kao što je sljedeće, a
UNIVERSALobuhvaća profil za provjeru autentičnosti bez URL-a koji upućuje na to da je povezan s okruženjem Dataverse.Index Active Kind Name Friendly Name Url User Cloud Type [1] * UNIVERSAL you@yourcompany.com Public OperatingSystemTo nije dovoljno jer nije navedeno okruženje Dataverse.
Pomoću pac značajke provjere autentičnosti stvorite profil za provjeru autentičnosti
UNIVERSALpovezan s okruženjem Dataverse.Napomena
Upotrijebite
--environmentparametar pomoću vrijednosti environmentid. Pronađite ID okruženja.Nemojte koristiti parametar jer
--urlće se time stvoritiDATAVERSEprofil, a neUNIVERSALprofil.Na primjer:
PS C:\test> pac auth create --environment f2cef599-b112-4803-bb5d-090077017685 --name ConnectionName 'you@yourcompany.onmicrosoft.com' authenticated successfully. Validating connection... Default organization: YourOrganization Connected to... YourOrganization Connected as you@yourcompany.onmicrosoft.com Authentication profile created * UNIVERSAL ConnectionName https://yourcompany.crm.dynamics.com/ : you@yourcompany.onmicrosoft.com Public PS C:\test>Ponovno pac pokrenite popis za aute . Trebali biste vidjeti rezultat s profilom
UNIVERSALveze s URL-om za okruženje Dataverse.PS C:\test> pac auth list Index Active Kind Name Friendly Name Url User Cloud Type [1] * UNIVERSAL you@yourcompany.com Public OperatingSystem [2] * UNIVERSAL ConnectionName YourOrganization https://yourcompany.crm.dynamics.com/ you@yourcompany.com Public User PS C:\test>Odaberite
UNIVERSALokruženje da biste ga tvorili kao zadani profil pomoću pac naredbe za odabir aute .PS C:\test> pac auth select --index 2 New default profile: * UNIVERSAL ConnectionName https://yourcompany.crm.dynamics.com/ : you@yourcompany.com Public PS C:\test>
Vidi također
Microsoft Power Platform CLI Command Groups
Pregled CLI-ja za Microsoft Power Platform