pac power-fx

(Ukážka) Príkazy na prácu so službou Power Fx

Tieto príkazy použite na interakciu s údajmi v Dataverse pomocou príkazového riadka alebo skriptu. Skracujte čas a zložitosť operácií platformy Dataverse pomocou služby Power Fx.

Môžete použiť vzorce uvedené v článku Referenčné informácie pre vzorce – Power Platform CLI.

Príkazy

Príkaz	Popis
pac power-fx repl	(Ukážka) Spustenie interaktívnej slučky čítaniaEval-Print služby Power Fx
pac power-fx run	(Ukážka) Spustenie súboru s pokynmi pre Power Fx

pac power-fx repl

(Ukážka) Spustenie interaktívnej slučky čítaniaEval-Print služby Power Fx

Poznámka

Ak ste nainštalovali Power Platform CLI pomocou windows MSI, existuje známy problém s pac power-fx repl kde môže prostredie prestať reagovať pri použití tohto príkazu.

Voliteľné parametre pre power-fx repl

`--environment` `-env`

Určuje cieľovú hodnotu Dataverse. Hodnotou môže byť identifikátor GUID alebo absolútna URL adresa protokolu https. Ak nie je určené, použije sa aktívna organizácia vybratá pre aktuálny profil overenia.

Poznámky

Tento príkaz poskytuje prostredie na použitie vzorcov uvedených v téme Referenčné informácie pre vzorce – Power Platform CLI.

Spustením nasledujúceho príkazu spustite príkaz Power Fx repl:

pac power-fx repl

Potom môžete spustiť príkazy služby Power Fx.

Príklady

Nasledujúce príklady zobrazujú použitie pac power-fx repl príkazu.

Pridanie riadkov
Pomoc
Východ

Pridanie riadkov

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

Funkcia Power Fx repl reaguje takto:

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

Pomoc

Spustením nasledujúceho príkazu získate pomoc so všetkými príkazmi, ktoré sú k dispozícii v jazyku Power Fx repl:

Help()

Repl služby Power Fx reaguje s nasledujúcim výstupom:

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

Poznámka

Tieto príkazy sa časom zmenia a budú obsahovať ďalšie príkazy. Mal by byť synchronizovaný so zdokumentovanými príkazmi, ktoré sú aktuálne k dispozícii.

Východ

Príkaz ukončíte Exit() pomocou repl príkazu .

pac power-fx run

(Ukážka) Spustenie súboru s pokynmi pre Power Fx

Príklady

Nasledujúce príklady zobrazujú použitie pac power-fx run príkazu.

Vytváranie údajových záznamov
Dotazovanie tabuľky Dataverse
Používanie funkcií služby PowerFx

Poznámka

V každom z týchto príkladov je potrebné:

Vytvorte súbor s názvom test-pfx.txt s výrazmi služby Power Fx v priečinku v počítači, napríklad c:\test.
Otvorte okno prostredia Windows PowerShell, prejdite do test priečinka a použite run príkaz určujúci súbor, ktorý obsahuje príkazy: pac power-fx run --file test-pfx.txt.

Ak chcete použiť tabuľky Dataverse, musíte vytvoriť a vybrať overový profil. Pozrite si pac výber overenia a pac overenia.

Ak sa zobrazí kontrola chyby Riešenie problémov.

Vytváranie údajových záznamov

Do súboru pridajte nasledujúci text test-pfx.txt a uložte ho.

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

Spustite tento príkaz:

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

Môžete očakávať nasledujúci výstup:

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

Dotazovanie tabuľky Dataverse

Pridajte tento text do test-pfx.txt súboru a uložte ho.
```
FirstN(Contacts, 5)
```
Tento príkaz načíta prvých päť kontaktov z platformy Dataverse.

Spustite tento príkaz:

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

Môžete očakávať nasledujúci výstup:

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>

Používanie funkcií služby PowerFx

Do súboru pridajte nasledujúci text test-pfx.txt a uložte ho.
```
Set(x, 1)
Result = If( Mid( "asdf",x,1 ) = "a", "X", "Y" )
```
V tomto príklade sa používajú funkcie Mid, If a Set Power Fx.

Spustite nasledujúci príkaz:

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

Môžete očakávať nasledujúci výstup:

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

--echo Pridajte parameter a môžete očakávať tento výstup:

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>

Povinné parametre pre power-fx run

`--file` `-f`

Cesta k súboru, ktorý sa má vykonať

Voliteľné parametre pre power-fx run

`--echo` `-e`

True, ak sa vstupné príkazy majú odzrkadľovať späť na výstup.

Tento parameter nevyžaduje žiadnu hodnotu. Je to prepínač.

`--environment` `-env`

Riešenie problémov

Nasledujúce kroky slúžia na riešenie problémov s chybami, ktoré sa môžu vyskytnúť pri používaní pac power-fx príkazov.

Chyba, ak neexistuje žiadny profil overenia Dataverse

Takáto chyba sa môže zobraziť, ak nemáte k prostrediu Dataverse priradený univerzálny profil overenia.

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.

Ak chcete vyriešiť takéto chyby, vytvorte si univerzálny profil overovania priradený k prostrediu Dataverse.

Spustite zoznam overení príkazovpac.

Môže sa vám zobraziť napríklad takýto výsledok, ktorý obsahuje UNIVERSAL profil overenia bez URL adresy označujúci, že je priradený k prostrediu Dataverse.
```
Index Active Kind      Name Friendly Name Url User                Cloud  Type
[1]   *      UNIVERSAL                        you@yourcompany.com Public OperatingSystem
```
To nie je postačujúce, pretože nie je zadané žiadne prostredie Dataverse.

Vytvorte si pac overovacíUNIVERSAL profil pripojený k prostrediu Dataverse.

Poznámka

--environment Použite parameter pomocou hodnoty environmentid. Nájdite svoje ID prostredia.

Parameter nepoužívajte --url , pretože sa tým DATAVERSE vytvorí profil UNIVERSAL namiesto profilu.

Napríklad:

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>

Znova spustite pac zoznam overenia . Mal by sa zobraziť výsledok s profilom UNIVERSAL pripojenia s URL adresou pre vaše prostredie 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>

Vyberte prostredie a UNIVERSAL nastavte ho ako predvolený profil pomocou pac príkazu auth select .

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>

Pozrite si tiež

Microsoft Power Platform CLI Command Groups
Prehľad rozhrania Microsoft Power Platform CLI

Pripomienky

Bola táto stránka užitočná?

Last updated on 2026-01-14

Zdieľať cez

pac power-fx

Príkazy

pac power-fx repl

Voliteľné parametre pre power-fx repl

--environment -env

Poznámky

Príklady

Pridanie riadkov

Pomoc

Východ

pac power-fx run

Príklady

Vytváranie údajových záznamov

Dotazovanie tabuľky Dataverse

Používanie funkcií služby PowerFx

Povinné parametre pre power-fx run

--file -f

Voliteľné parametre pre power-fx run

--echo -e

--environment -env

Riešenie problémov

Chyba, ak neexistuje žiadny profil overenia Dataverse

Pozrite si tiež

Pripomienky

Ďalšie zdroje informácií

`--environment` `-env`

`--file` `-f`

`--echo` `-e`

`--environment` `-env`