Dijeli putem


pac power-fx

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

  1. Stvorite datoteku pod nazivom test-pfx.txt Izrazi dodatka Power Fx u mapi na računalu, npr c:\test. .

  2. Otvorite prozor komponente Windows PowerShell, dođite do testrun mape 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

  1. Dodajte sljedeći tekst i test-pfx.txt spremite 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" })
    
  2. Pokreni sljedeću naredbu:

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

    Rezultat 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

  1. Dodajte ovaj tekst i test-pfx.txt spremite datoteku.

    FirstN(Contacts, 5)
    

    Ta naredba dohvaća prvih pet kontakata iz aplikacije Dataverse.

  2. Pokreni sljedeću naredbu:

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

    Rezultat 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

  1. Dodajte sljedeći tekst i test-pfx.txt spremite datoteku.

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

    U ovom se primjeru koriste funkcije Mid, Ifi Set Power Fx.

  2. Pokrenite sljedeću naredbu:

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

    Rezultat 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>
    
  3. Dodajte parametar --echo i 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.

  1. Pokrenite popispac za aute naredbi.

    Možda ćete vidjeti rezultat kao što je sljedeće, a UNIVERSAL obuhvać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 OperatingSystem
    

    To nije dovoljno jer nije navedeno okruženje Dataverse.

  2. Pomoću pac značajke provjere autentičnosti stvorite profil za provjeru autentičnosti UNIVERSAL povezan s okruženjem Dataverse.

    Napomena

    Upotrijebite --environment parametar pomoću vrijednosti environmentid. Pronađite ID okruženja.

    Nemojte koristiti parametar jer --url će se time stvoriti DATAVERSE profil, a ne UNIVERSAL profil.

    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>
    
  3. Ponovno pac pokrenite popis za aute . Trebali biste vidjeti rezultat s profilom UNIVERSAL veze 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>
    
  4. Odaberite UNIVERSAL okruž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