के माध्यम से साझा करें


pac power-fx

(पूर्वावलोकन) Power Fx के साथ कार्य करने के लिए आदेश

कमांड लाइन या स्क्रिप्ट का उपयोग करके Dataverse में डेटा के साथ इंटरैक्ट करने के लिए इन कमांड का उपयोग करें। Power Fx का उपयोग करके अपने Dataverse संचालन के समय और जटिलता को कम करें.

आप सूत्र संदर्भ - Power Platform CLI में सूचीबद्ध सूत्रों का उपयोग कर सकते हैं.

आदेश

Command विवरण
pac power-fx repl (पूर्वावलोकन) इंटरएक्टिव Power Fx Read-Eval-Print Loop लॉन्च करें
pac power-fx run (पूर्वावलोकन) Power Fx निर्देशों की कोई फ़ाइल चलाएँ

pac power-fx repl

(पूर्वावलोकन) इंटरएक्टिव Power Fx Read-Eval-Print Loop लॉन्च करें

नोट

यदि आपने Windows MSI का उपयोग करके Power Platform CLI स्थापित किया है, तो इस आदेश का उपयोग करते समय शेल कहाँ प्रत्युत्तर देना बंद कर सकता है, इसके साथ pac power-fx replएक ज्ञात समस्या है.

के लिए वैकल्पिक पैरामीटर power-fx repl

--environment -env

लक्ष्य Dataverse निर्दिष्ट करता है. मान एक Guid या निरपेक्ष https URL हो सकता है। निर्दिष्ट नहीं होने पर, वर्तमान प्रमाणीकरण प्रोफ़ाइल के लिए चयनित सक्रिय संगठन का उपयोग किया जाएगा।

टिप्पणियां

यह आदेश सूत्र संदर्भ - Power Platform CLI में सूचीबद्ध सूत्रों का उपयोग करने के लिए एक शेल प्रदान करता है.

निम्न आदेश चलाकर Power Fx repl प्रारंभ करें:

pac power-fx repl

उसके बाद, आप Power Fx कमांड चला सकते हैं।

उदाहरण

निम्नलिखित उदाहरण आदेश का pac power-fx repl उपयोग दिखाते हैं।

पंक्तियाँ जोड़ें
Collect(Contacts, { firstname: "Patti", lastname: "Fernandez" })

Power Fx repl निम्न के साथ प्रतिक्रिया देता है:

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

Power Fx repl में उपलब्ध सभी आदेशों के बारे में मदद प्राप्त करने के लिए निम्न आदेश चलाएँ:

Help()

Power Fx repl निम्नलिखित आउटपुट के साथ प्रतिक्रिया करता है:

  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() लिए उपयोग करेंrepl

pac power-fx run

(पूर्वावलोकन) Power Fx निर्देशों की कोई फ़ाइल चलाएँ

उदाहरण

निम्नलिखित उदाहरण आदेश का pac power-fx run उपयोग दिखाते हैं।

नोट

इनमें से प्रत्येक उदाहरण में, आपको यह करना होगा:

  1. अपने कंप्यूटर पर किसी फ़ोल्डर में Power Fx व्यंजकों के साथ नाम वाली test-pfx.txt फ़ाइल बनाएँ, जैसे .c:\test

  2. एक Windows PowerShell विंडो खोलें, फ़ोल्डर पर test नेविगेट करें और उस फ़ाइल को निर्दिष्ट करने वाले कमांड का run उपयोग करें जिसमें कमांड शामिल हैं: pac power-fx run --file test-pfx.txt.

Dataverse तालिकाओं का उपयोग करने के लिए, आपको एक प्रमाणीकरण प्रोफ़ाइल बनानी और चुननी होगी। प्रमाणीकरण क्रिएट और pac ऑथ सेलेक्ट देखेंpac

अगर आपको कोई गड़बड़ी मिलती है , तो समस्या हल करने की जांच करें.

Dataverse रिकॉर्ड बनाएं

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

एक Dataverse तालिका क्वेरी करें

  1. इस पाठ को फ़ाइल में test-pfx.txt जोड़ें और सहेजें.

    FirstN(Contacts, 5)
    

    यह कमांड Dataverse से पहले पांच संपर्कों को पुनर्प्राप्त करता है।

  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>
    

PowerFx फ़ंक्शंस का उपयोग करें

  1. फ़ाइल में test-pfx.txt निम्न पाठ जोड़ें और सहेजें.

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

    यह उदाहरण Power Fx फ़ंक्शंस का उपयोग करता है, यदि औरसेट करें .

  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

लक्ष्य Dataverse निर्दिष्ट करता है. मान एक Guid या निरपेक्ष https URL हो सकता है। निर्दिष्ट नहीं होने पर, वर्तमान प्रमाणीकरण प्रोफ़ाइल के लिए चयनित सक्रिय संगठन का उपयोग किया जाएगा।

समस्‍या निवारण

कमांड का उपयोग करते pac power-fx समय आपके सामने आने वाली त्रुटियों के निवारण के लिए निम्नलिखित चरण दिए गए हैं।

त्रुटि जब कोई Dataverse प्रमाणीकरण प्रोफ़ाइल मौजूद नहीं है

आपको इस तरह की त्रुटि तब मिल सकती है जब आपके पास Dataverse परिवेश से संबद्ध सार्वभौमिक प्रमाणीकरण प्रोफ़ाइल नहीं होती है.

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.

इस तरह की त्रुटियों को हल करने के लिए, Dataverse परिवेश से संबद्ध एक सार्वभौमिक प्रमाणीकरण प्रोफ़ाइल बनाएं.

  1. कमांड pac प्रमाणीकरण सूची चलाएँ।

    आपको निम्न जैसा परिणाम दिखाई दे सकता है जिसमें एक UNIVERSAL प्रमाणीकरण प्रोफ़ाइल शामिल है जिसमें कोई URL नहीं है जो यह दर्शाता है कि यह Dataverse परिवेश से संबद्ध है.

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

    यह पर्याप्त नहीं है क्योंकि कोई Dataverse वातावरण निर्दिष्ट नहीं है.

  2. Dataverse परिवेश से कनेक्ट प्रमाणीकरण प्रोफ़ाइल बनाने UNIVERSAL के लिए प्रमाणीकरण क्रिएट का उपयोग करेंpac.

    नोट

    environmentid मान का उपयोग करके पैरामीटर का --environment उपयोग करें। अपनी परिवेश ID ढूँढें.

    पैरामीटर का --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। आपको अपने Dataverse परिवेश के लिए URL के साथ कनेक्शन प्रोफ़ाइल के साथ 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. प्रमाणीकरण चयन कमांड का उपयोग करके इसे pac डिफ़ॉल्ट प्रोफ़ाइल बनाने के लिए परिवेश का UNIVERSAL चयन करें।

    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>
    

भी देखें

Microsoft Power Platform CLI कमांड समूह
Microsoft Power Platform CLI अवलोकन