Deli putem


pac power-fx

(Pregled) Komande za rad sa programom Power Fx

Koristite ove komande za interakciju sa podacima u dataverse pomoću komandne linije ili skripte. Smanjite vreme i složenost operacija Dataverse pomoću usluge Power Fx.

Možete da koristite formule navedene u referenci formule – Power Platform CLI.

Komande

Command Opis
pac power-fx repl (Pregled) Pokretanje interaktivnog Power Fx čitanjaEval-Print petlјi
pac power-fx pokretanje (Pregled) Pokretanje datoteke sa uputstvima za Power Fx

pac power-fx repl

(Pregled) Pokretanje interaktivnog Power Fx čitanjaEval-Print petlјi

Belešku

Ako ste instalirali Power Platform CLI koristeći Windows MSI, pac power-fx repl postoji poznat problem gde shell može prestati da se odaziva kada koristi ovu komandu.

Opcionalni parametri za power-fx repl

--environment -env

Navodi ciljni Dataverse. Vrednost može biti GUID ili apsolutni https URL. Kada nije navedeno, koristiće se aktivna organizacija izabrana za trenutni profil potvrde potvrde.

Primedbe

Ova komanda obezbeđuje škodu za korišćenje formula navedenih u referenci formule – Power Platform CLI.

Pokrenite Power Fx repl tako što ćete pokrenuti sledeću komandu:

pac power-fx repl

Nakon toga možete da pokrenete Power Fx komande.

Primeri

Sledeći primeri pokazuju upotrebu komande pac power-fx repl .

Dodavanje redova
Collect(Contacts, { firstname: "Patti", lastname: "Fernandez" })

Power Fx repl odgovara na sledeće:

{contactid:GUID("118d7b47-8f80-ee11-8179-0022482a40c7"), fullname:"Patti Fernandez", ...}
Pomoć

Pokrenite sledeću komandu da biste dobili pomoć za sve komande koje su dostupne u programskom dodatku Power Fx:

Help()

Power Fx repl odgovara sa sledećim rezultatom:

  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
>>

Belešku

Ove komande će se vremenom promeniti kako bi obuhvatile više komandi. Trebalo bi da se sinhronizuje sa dokumentovanim trenutno dostupnim komandama.

Izlaz

Koristite Exit() je za napuštanje komande repl .

pac power-fx pokretanje

(Pregled) Pokretanje datoteke sa uputstvima za Power Fx

Primeri

Sledeći primeri pokazuju upotrebu komande pac power-fx run .

Belešku

U svakom od ovih primera morate da:

  1. Kreirajte datoteku imenovanu test-pfx.txt pomoću Power Fx izraza u fascikli na računaru, na primer c:\test.

  2. Otvorite Prozor programa Windows PowerShell, pomerite testrun se do fascikle i koristite komandu koja navodi datoteku koja sadrži komande: pac power-fx run --file test-pfx.txt.

Da biste koristili Dataverse tabele, morate da kreirate i izaberete profil potvrde vemocije. Pogledajte izbor potvrde pac potvrde veutocije i biranje potvrde veutocije.

Ako dobijete grešku, proverite rešavanje problema.

Kreirajte Dataverse zapise

  1. Dodajte sledeći tekst u datoteku test-pfx.txt i sačuvajte je.

    Collect(Contacts, { firstname: "Megan", lastname: "Bowen" })
    Collect(Contacts, { firstname: "Garth", lastname: "Forth" })
    Collect(Contacts, { firstname: "Adele", lastname: "Vance" })
    Collect(Contacts, { firstname: "Patti", lastname: "Fernandez" })
    
  2. Pokreni ovu komandu:

    PS C:\test> pac power-fx run --file test-pfx.txt
    

    Izlaz možete da očekujete na sledeć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", ...}
    

Upit za tabelu "Dataverse"

  1. Dodajte ovaj tekst u datoteku test-pfx.txt i sačuvajte je.

    FirstN(Contacts, 5)
    

    Ova komanda preuzima prvih pet kontakata iz usluge Dataverse.

  2. Pokreni ovu komandu:

    PS C:\test> pac power-fx run --file test-pfx.txt
    

    Izlaz možete da očekujete na sledeć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šćenje PowerFx funkcija

  1. Dodajte sledeći tekst u datoteku test-pfx.txt i sačuvajte je.

    Set(x, 1)
    Result = If( Mid( "asdf",x,1 ) = "a", "X", "Y" )
    

    Ovaj primer koristi funkcije Mid, If i Set Power Fx.

  2. Pokrenite sledeću komandu:

    PS C:\test> pac power-fx run --file test-pfx.txt
    

    Izlaz možete da očekujete na sledeći način:

    PS C:\test> pac power-fx run --file test-pfx.txt
    x: 1
    true
    Result: "X"
    PS C:\test>
    
  3. Dodajte parametar --echo i možete da očekujete 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 pokretanje

--file -f

Putanja datoteke za izvršavanje

Opcionalni parametri za power-fx pokretanje

--echo -e

True if input commands should echo back to output

Ovaj parametar ne zahteva nikakvu vrednost. To je prekidaи.

--environment -env

Navodi ciljni Dataverse. Vrednost može biti GUID ili apsolutni https URL. Kada nije navedeno, koristiće se aktivna organizacija izabrana za trenutni profil potvrde potvrde.

Rešavanje problema

Slede koraci za rešavanje problema sa greškama na koje možete da naiđete prilikom korišćenja pac power-fx komandi.

Greška kada ne postoji profil potvrde identiteta za Dataverse

Možete da dobijete grešku kao što je ova kada nemate univerzalni profil potvrde identiteta povezan sa Dataverse okruženjem.

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 otklonili greške kao što su ove, kreirajte univerzalni profil potvrde identiteta povezan sa Dataverse okruženjem.

  1. Pokrenite listu potvrde identiteta komande.

    Možda ćete videti rezultat kao što UNIVERSAL je sledeći koji uključuje profil potvrde identiteta bez URL adrese koji ukazuje na to da je povezan sa Dataverse okruženjem.

    Index Active Kind      Name Friendly Name Url User                Cloud  Type
    [1]   *      UNIVERSAL                        you@yourcompany.com Public OperatingSystem
    

    Ovo nije dovoljno zato što nije navedeno Dataverse okruženje.

  2. Koristite pac auth create to create a UNIVERSAL authentication profile connected to a Dataverse environment.

    Belešku

    Koristite parametar --environment koristeći vrednost id okruženja. Pronađite ID okruženja.

    Nemojte koristiti parametar --url zato što će ovo kreirati profil DATAVERSE , a ne profil UNIVERSAL .

    Na primer:

    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>
    
  3. Ponovo pokrenite listu potvrde identiteta usluge Pac . Trebalo bi da vidite rezultat sa profilom UNIVERSAL veze sa URL adresom za Dataverse okruženje.

    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>
    
  4. Izaberite okruženje UNIVERSAL da biste ga postavili kao podrazumevani profil pomoću komande za izbor pac potvrde veobrana .

    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đe

Microsoft Power Platform CLI Command Groups
Microsoft Power Platform CLI pregled