Partekatu bidez


pac power-fx

(Aurrebista) Power Fx-ekin lan egiteko komandoak

Erabili komando hauek datuekin elkarreragiteko Dataverse komando lerro edo script bat erabiliz. Murriztu zure Dataverse eragiketen denbora eta konplexutasuna Power Fx erabiliz.

Formula erreferentzian zerrendatutako formulak erabil ditzakezu - Power Platform CLI.

Komandoak

Komandoa Deskribapenak
pac power-fx repl (Aurrebista) Abiarazi Power Fx irakurketa interaktiboaEval-Print begizta
pac power-fx run (Aurrebista) Exekutatu Power Fx-en argibideen fitxategia

pac power-fx repl

(Aurrebista) Abiarazi Power Fx irakurketa interaktiboaEval-Print begizta

Oharra

Power Platform CLI Windows MSI erabiliz instalatu baduzu, arazo pac power-fx replezagun bat shell-ak komando hau erabiltzean erantzuteari utz diezaiokeenean.

Aukerako parametroak power-fx repl

--environment -env

Helburuko Dataverse-a zehazten du. Balioa Guid edo https URL absolutua izan daiteke. Zehaztu ezean, uneko autentifikazio-profilerako hautatutako erakunde aktiboa erabiliko da.

Oharrak

Komando honek shell bat eskaintzen du Formula erreferentzia - Power Platform CLI atalean zerrendatutako formulak erabiltzeko.

Abiarazi Power Fx repl komando hau exekutatuz:

pac power-fx repl

Ondoren, Power Fx komandoak exekutatu ditzakezu.

Adibideak

Ondorengo adibideek komandoaren pac power-fx repl erabilera erakusten dute.

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

Power Fx repl-ak honako hau erantzuten du:

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

Exekutatu komando hau Power Fx repl-n erabilgarri dauden komando guztiei buruzko laguntza lortzeko:

Help()

Power Fx repl-ak honako irteera honekin erantzuten du:

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

Oharra

Komando hauek denboran zehar aldatu egingo dira, komando gehiago sartzeko. Unean erabilgarri dauden dokumentatutako komandoekin sinkronizatu behar da.

Exit

Erabili Exit() komandotik repl irteteko.

pac power-fx run

(Aurrebista) Exekutatu Power Fx-en argibideen fitxategia

Adibideak

Ondorengo adibideek komandoaren pac power-fx run erabilera erakusten dute.

Oharra

Adibide horietako bakoitzean, honako hauek egin behar dituzu:

  1. Sortu Power Fx adierazpenekin izendatutako test-pfx.txt fitxategi bat ordenagailuko karpeta batean, adibidez c:\test.

  2. Ireki Windows PowerShell-eko leihoa, nabigatu karpetara test eta erabili run komandoak dituen fitxategia zehazten duen komandoa: pac power-fx run --file test-pfx.txt.

Dataverse-ren taulak erabiltzeko, autentifikazio-profil bat sortu eta hautatu behar duzu. Ikus pac auth create eta pac auth hautatu.

Errorea jasotzen baduzu, egiaztatu Arazoak konpontzen.

Sortu Dataverse-ren erregistroak

  1. Gehitu ondorengo testua fitxategiari test-pfx.txt eta gorde fitxategiari.

    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. Exekutatu komando hau:

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

    Honelako emaitzak espero ditzakezu:

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

Kontsultatu Dataverse-ren taula bat

  1. Gehitu test-pfx.txt testu hau eta gorde fitxategia.

    FirstN(Contacts, 5)
    

    Komando honek Dataverse-ko lehenengo bost kontaktuak eskuratzen ditu.

  2. Exekutatu komando hau:

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

    Honelako emaitzak espero ditzakezu:

    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>
    

Erabili PowerFx-en funtzioak

  1. Gehitu ondorengo testua fitxategiari test-pfx.txt eta gorde fitxategiari.

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

    Adibide honetan Mid, If eta Set Power Fx funtzioak erabiltzen dira.

  2. Exekutatu ondoko komandoak:

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

    Honelako emaitzak espero ditzakezu:

    PS C:\test> pac power-fx run --file test-pfx.txt
    x: 1
    true
    Result: "X"
    PS C:\test>
    
  3. Gehitu parametroa --echo eta irteera hau espero dezakezu:

    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>
    

Beharrezko parametroak honako power-fx run

--file -f

Exekutatu beharreko fitxategiaren bide-izena

Aukerako parametroak power-fx run

--echo -e

True (egia) sarrerako komandoek irteerara itzuli behar badute

Parametro honek ez du baliorik behar. Aldaketa bat da.

--environment -env

Helburuko Dataverse-a zehazten du. Balioa Guid edo https URL absolutua izan daiteke. Zehaztu ezean, uneko autentifikazio-profilerako hautatutako erakunde aktiboa erabiliko da.

Arazoak konpontzea

Hona hemen komandoak erabiltzean pac power-fx sor ditzakezun erroreak konpontzeko urratsak.

Errorea Dataverse-ren autentifikazio-profilik ez dagoenean

Horrelako errore bat lor dezakezu Dataverse ingurune batekin lotutako autentifikazio-profil unibertsalik ez duzunean.

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.

Horrelako akatsak konpontzeko, sortu Dataverse ingurune batekin lotutako autentifikazio profil unibertsala.

  1. Exekutatu autentifikazio-zerrenda komandoapac.

    Baliteke honako emaitza bat ikustea, URLrik gabeko autentifikazio-profila UNIVERSAL barne, Dataverse ingurune batekin lotuta dagoela adierazten duena.

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

    Hau ez da nahikoa, ez baita Dataverse ingurunerik zehaztu.

  2. Erabili pac auth create Dataverse ingurune batekin konektatutako autentifikazio-profila UNIVERSAL sortzeko.

    Oharra

    Erabili parametroa --environment environmentid balioa erabiliz. Bilatu zure ingurunearen IDa.

    Ez erabili parametroa, --url profil bat DATAVERSE sortuko baitu eta ez profil bat UNIVERSAL .

    Adibidez:

    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. Exekutatu autentifikazio-zerrendapac berriro. Emaitza bat ikusi beharko zenuke konexio-profilarekin UNIVERSAL zure Dataverse ingurunearen URLarekin.

    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. Hautatu ingurunea UNIVERSAL profil lehenetsia bihurtzeko, auth select komandoapac erabiliz.

    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>
    

Ikus baita ere

Microsoft Power Platform-en CLI komando-taldeak
Microsoft Power Platform-en CLI ikuspegi orokorra