Делите путем


pac power-fx

(Преглед) Команде за рад са Повер Фк

Користите ове команде за интеракцију са подацима помоћу Dataverse командне линије или скрипте. Смањите време и сложеност ваших Датаверсе операција користећи Повер Фк.

Можете користити формуле наведене у референци формуле - Повер Платформ ЦЛИ.

Команде

Command Опис
pac power-fx repl (Преглед) Покрените интерактивни Повер Фк Реад-Eval-Print петље
pac power-fx run (Преглед) Покрените датотеку Повер Фк инструкција

pac power-fx repl

(Преглед) Покрените интерактивни Повер Фк Реад-Eval-Print петље

Белешка

Ако сте инсталирали Повер Платформ ЦЛИ користећи Виндовс МСИ, постоји познати проблем са pac power-fx repl којим љуска може престати да реагује када користите ову команду.

Опциони параметри за power-fx repl

--environment -env

Одређује циљну Датаверсе. Вредност може бити Гуид или апсолутни хттпс УРЛ. Када није наведено, користиће се активна организација изабрана за тренутни профил аутентификације.

Примедбе

Ова команда обезбеђује љуску за коришћење формула наведених у референци формуле - Повер Платформ ЦЛИ.

Покрените Повер Фк репл покретањем следеће команде:

pac power-fx repl

Након тога, можете покренути Повер Фк команде.

Примери

Следећи примери показују употребу команде pac power-fx repl .

Додајте редове
Collect(Contacts, { firstname: "Patti", lastname: "Fernandez" })

Повер Фк репл одговара са следећим:

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

Покрените следећу команду да бисте добили помоћ о свим командама које су доступне у Повер Фк репл:

Help()

Повер Фк репл одговара са следећим излазом:

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

Белешка

Ове команде ће се временом мењати како би укључиле више команди. Требало би да буде синхронизован са документованим тренутно доступним командама .

Exit

Користи се Exit() за излазак из команде repl .

pac power-fx run

(Преглед) Покрените датотеку Повер Фк инструкција

Примери

Следећи примери показују употребу команде pac power-fx run .

Белешка

У сваком од ових примера, морате:

  1. Креирајте датотеку названу test-pfx.txt помоћу Повер Фк израза у фасцикли на рачунару, као што је c:\test.

  2. Отворите прозор Виндовс ПоверСхелл-а , идите до фасцикле test и користите команду run која одређује датотеку која садржи команде: pac power-fx run --file test-pfx.txt.

Да бисте користили Датаверсе табеле, морате креирати и одабрати профил аутентификације. Погледајте pac аутх креирање и pac аутх селецт .

Ако добијете проверу грешке Решавање проблема .

Креирајте Датаверсе записе

  1. Додајте следећи текст и test-pfx.txt сачувајте датотеку.

    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. Покрени ову команду:

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

    Можете очекивати излаз као што је следеће:

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

Упит Датаверсе табеле

  1. Додајте овај текст и test-pfx.txt сачувајте датотеку.

    FirstN(Contacts, 5)
    

    Ова команда преузима првих пет контаката из Датаверсе.

  2. Покрени ову команду:

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

    Можете очекивати излаз као што је следеће:

    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>
    

Користите ПоверФк функције

  1. Додајте следећи текст и test-pfx.txt сачувајте датотеку.

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

    Овај пример користи Мид , Иф , и Сет Повер Фк функције.

  2. Покрените следећу команду:

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

    Можете очекивати излаз као што је следеће:

    PS C:\test> pac power-fx run --file test-pfx.txt
    x: 1
    true
    Result: "X"
    PS C:\test>
    
  3. Додајте параметар --echo и можете очекивати овај излаз:

    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>
    

Потребни параметри за power-fx run

--file -f

Путања датотеке за извршење

Опциони параметри за power-fx run

--echo -e

Истина ако улазне команде треба да одјекују назад на излаз

Овај параметар не захтева никакву вредност. То је прекидач.

--environment -env

Одређује циљну Датаверсе. Вредност може бити Гуид или апсолутни хттпс УРЛ. Када није наведено, користиће се активна организација изабрана за тренутни профил аутентификације.

Решавање проблема

Следе кораци за решавање грешака на које можете наићи приликом коришћења pac power-fx команди.

Грешка када не постоји профил за аутентификацију Датаверсе

Овакву грешку можете добити када немате универзални профил за аутентификацију повезан са Датаверсе окружењем.

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.

Да бисте решили овакве грешке, креирајте универзални профил за аутентификацију повезан са Датаверсе окружењем.

  1. Покрените команду pac аутх листу .

    Можда ћете видети резултат као што је следећи који укључује UNIVERSAL профил за аутентификацију без УРЛ-а који указује да је повезан са Датаверсе окружењем.

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

    Ово није довољно јер није наведено окружење Датаверсе.

  2. Користите pac аутх цреате да бисте креирали профил за аутентификацију повезан UNIVERSAL са Датаверсе окружењем.

    Белешка

    Користите параметар --environment користећи енвиронментид вредност. Пронађите ИД окружења .

    Немојте користити параметар --url јер ће то створити профил, DATAVERSE а не UNIVERSAL профил.

    На пример:

    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. Поново покрените pac аутх листу . Требало би да видите резултат са профилом UNIVERSAL везе са УРЛ-ом за ваше Датаверсе окружење.

    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. Изаберите окружење UNIVERSAL да бисте га учинили подразумеваним профилом помоћу команде pac за одабир аутх .

    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>
    

Такође погледајте

Мицрософт Повер Платформ ЦЛИ командне групе
Преглед Мицрософт Повер Платформ ЦЛИ