pac power-fx

(Peržiūra) Darbo su "Power Fx" komandos

Naudokite šias komandas norėdami sąveikauti su duomenimis programoje "Dataverse" naudodami komandų eilutę arba scenarijų. Sumažinkite "Dataverse" operacijų laiką ir sudėtingumą naudodami "Power Fx".

Galite naudoti formules, išvardytas formulės nuorodoje – "Power Platform" CLI.

Komandas

Komanda	Apibūdinimas
pac power-fx repl	(Peržiūra) Interaktyvaus "Power Fx Read-Eval-Print Loop" paleidimas
pac power-fx run	(Peržiūra) Paleiskite "Power Fx" failo instrukcijas

pac power-fx repl

(Peržiūra) Interaktyvaus "Power Fx Read-Eval-Print Loop" paleidimas

Pastaba.

Jei įdiegėte "Power Platform" CLI naudodami "Windows" MSI, yra žinoma problema pac power-fx repl , dėl kurios apvalkalas gali nebeatsakyti naudojant šią komandą.

Pasirinktiniai parametrai, skirti power-fx repl

`--environment` `-env`

Nurodo tikslinį "Dataverse". Reikšmė gali būti GUID arba absoliutus https URL. Jei nenurodyta, bus naudojama aktyvi organizacija, pasirinkta dabartiniam autentifikavimo profiliui.

Pastabos

Ši komanda pateikia apvalkalą, kuriame galima naudoti formules, išvardytas formulės nuorodoje – "Power Platform" CLI.

Paleiskite "Power Fx repl" paleisdami šią komandą:

pac power-fx repl

Tada galėsite paleisti "Power Fx" komandas.

Pavyzdžiai

Tolesniuose pavyzdžiuose parodytas komandos naudojimas pac power-fx repl .

Eilučių įtraukimas
Pagalba
Išeiti

Eilučių įtraukimas

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

"Power Fx repl" atsako šiais elementais:

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

Žinynas

Vykdykite šią komandą, kad gautumėte pagalbos apie visas "Power Fx" komandas:

Help()

"Power Fx repl" atsako su tokia išvestis:

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

Pastaba.

Šios komandos laikui bėgant pasikeis, kad būtų įtraukta daugiau komandų. Jis turi būti sinchronizuotas su šiuo metu turimomis dokumentais pasiekiamomis komandomis.

Exit

Naudokite Exit() norėdami išeiti iš repl komandos.

pac power-fx run

(Peržiūra) Paleiskite "Power Fx" failo instrukcijas

Pavyzdžiai

Tolesniuose pavyzdžiuose parodytas komandos naudojimas pac power-fx run .

"Dataverse" įrašų kūrimas
Lentelės "Dataverse" užklausa
"PowerFx" funkcijų naudojimas

Pastaba.

Kiekviename iš šių pavyzdžių turite:

Sukurkite failą, pavadintą test-pfx.txt "Power Fx" išraiškomis, kompiuterio aplanke, pvz. c:\test, .
Atidarykite "Windows PowerShell" langą, pereikite į test aplanką ir naudokite komandą, nurodančią run failą, kuriame yra komandos: pac power-fx run --file test-pfx.txt.

Norėdami naudoti "Dataverse" lenteles, turite sukurti ir pasirinkti autentifikavimo profilį. Žrpac. autentifikavimo kūrimas ir pac autentifikavimas.

Jei gaunate klaidos pranešimą, patikrinkite Trikčių diagnostika.

"Dataverse" įrašų kūrimas

Įtraukite šį tekstą į test-pfx.txt failą ir įrašykite jį.

Collect(Contacts, { firstname: "Megan", lastname: "Bowen" })
Collect(Contacts, { firstname: "Garth", lastname: "Forth" })
Collect(Contacts, { firstname: "Adele", lastname: "Vance" })
Collect(Contacts, { firstname: "Patti", lastname: "Fernandez" })

Vykdykite šią komandą:

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

Galite tikėtis išvesties, pvz.:

{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", ...}

Lentelės "Dataverse" užklausa

Įtraukite šį tekstą į test-pfx.txt failą ir įrašykite jį.
```
FirstN(Contacts, 5)
```
Ši komanda nuskaito pirmuosius penkis kontaktus iš "Dataverse".

Vykdykite šią komandą:

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

Galite tikėtis išvesties, pvz.:

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>

"PowerFx" funkcijų naudojimas

Įtraukite šį tekstą į test-pfx.txt failą ir įrašykite jį.
```
Set(x, 1)
Result = If( Mid( "asdf",x,1 ) = "a", "X", "Y" )
```
Šiame pavyzdyje naudojamos funkcijos Mid, If ir Set Power Fx.

Įvykdykite toliau nurodytą komandą.

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

Galite tikėtis išvesties, pvz.:

PS C:\test> pac power-fx run --file test-pfx.txt
x: 1
true
Result: "X"
PS C:\test>

Įtraukite parametrą --echo ir galite tikėtis šios išvesties:

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>

Būtini parametrai power-fx run

`--file` `-f`

Vykdytinų failų kelias

Pasirinktiniai parametrai, skirti power-fx run

`--echo` `-e`

Teisinga, jei įvesties komandos turi atkartoti išvestį

Šiam parametrui nereikia reikšmės. Tai jungiklis.

`--environment` `-env`

Nurodo tikslinį "Dataverse". Reikšmė gali būti GUID arba absoliutus https URL. Jei nenurodyta, bus naudojama aktyvi organizacija, pasirinkta dabartiniam autentifikavimo profiliui.

Trikčių šalinimas

Toliau pateikiami veiksmai, kaip pašalinti klaidas, su kuriomis galite susidurti naudodami pac power-fx komandas.

Klaida, kai nėra "Dataverse" autentifikavimo profilio

Galite gauti tokią klaidą, kai neturite universalaus autentifikavimo profilio, susieto su "Dataverse" aplinka.

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.

Norėdami išspręsti panašias klaidas, sukurkite universalų autentifikavimo profilį, susietą su "Dataverse" aplinka.

Vykdykite komandų pac autentifikavimo sąrašą.

Galite matyti tokį rezultatą kaip toliau, kuriame yra UNIVERSAL autentifikavimo profilis be URL, nurodantis, kad jis susietas su "Dataverse" aplinka.
```
Index Active Kind      Name Friendly Name Url User                Cloud  Type
[1]   *      UNIVERSAL                        you@yourcompany.com Public OperatingSystem
```
To nepakanka, nes nenurodyta jokia "Dataverse" aplinka.

Autentifikavimo profilio, prijungto prie "Dataverse" aplinkos, kūrimas UNIVERSAL naudojant pac autentifikavimo kūrimą.

Pastaba.

Naudokite parametrą --environment naudodami environmentid reikšmę. Raskite savo aplinkos ID.

Nenaudokite parametro, --url nes taip bus sukurtas profilis, DATAVERSE o ne profilis UNIVERSAL .

Pavyzdys.

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>

Dar kartą paleiskite pac autentifikavimo sąrašą . Turėtumėte matyti rezultatą su UNIVERSAL ryšio profiliu su savo "Dataverse" aplinkos URL.

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>

Pasirinkite aplinką, UNIVERSAL kad ji taptų numatytuoju profiliu, naudodami autentifikavimopac pasirinkimo komandą.

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>

Taip pat žr.

"Microsoft Power Platform" CLI komandų grupės
"Microsoft Power Platform" CLI apžvalga

Atsiliepimus

Ar šis puslapis buvo naudingas?

Last updated on 2026-01-14

Dalintis per

pac power-fx

Komandas

pac power-fx repl

Pasirinktiniai parametrai, skirti power-fx repl

--environment -env

Pastabos

Pavyzdžiai

Eilučių įtraukimas

Žinynas

Exit

pac power-fx run

Pavyzdžiai

"Dataverse" įrašų kūrimas

Lentelės "Dataverse" užklausa

"PowerFx" funkcijų naudojimas

Būtini parametrai power-fx run

--file -f

Pasirinktiniai parametrai, skirti power-fx run

--echo -e

--environment -env

Trikčių šalinimas

Klaida, kai nėra "Dataverse" autentifikavimo profilio

Taip pat žr.

Atsiliepimus

Papildomi ištekliai

`--environment` `-env`

`--file` `-f`

`--echo` `-e`

`--environment` `-env`