pac power-fx

(معاينة) أوامر للعمل مع Power Fx

استخدم هذه الأوامر للتفاعل مع البيانات في Dataverse استخدام سطر أوامر أو برنامج نصي. تقليل وقت وتعقيد عمليات Dataverse باستخدام Power Fx.

يمكنك استخدام الصيغ المدرجة في مرجع الصيغة - Power Platform CLI.

الاوامر

أمر	‏‏الوصف
pac power-fx repl	(معاينة) تشغيل حلقة Power Fx Read-Eval-Print التفاعلية
تشغيل pac power-fx	(معاينة) تشغيل ملف تعليمات Power Fx

pac power-fx repl

(معاينة) تشغيل حلقة Power Fx Read-Eval-Print التفاعلية

‏‫ملاحظة‬

إذا قمت بتثبيت Power Platform CLI باستخدام Windows MSI، فهناك مشكلة معروفة تتعلق pac power-fx repl بمكان توقف shell عن الاستجابة عند استخدام هذا الأمر.

معلمات اختيارية ل power-fx repl

`--environment` `-env`

تحديد Dataverse الهدف. قد تكون القيمة GUID أو مطلق https URL. عند عدم التحديد، سيتم استخدام المؤسسة النشطة المحددة لملف تعريف المصادقة الحالي.

ملاحظات

يوفر هذا الأمر shell لاستخدام الصيغ المدرجة في مرجع الصيغة - Power Platform CLI.

ابدأ إعادة توصيل Power Fx عن طريق تشغيل الأمر التالي:

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

استخدم Exit() للخروج من repl الأمر.

تشغيل pac power-fx

(معاينة) تشغيل ملف تعليمات Power Fx

الأمثلة

توضح الأمثلة التالية استخدام pac power-fx run الأمر .

إنشاء سجلات Dataverse
الاستعلام عن جدول Dataverse
استخدام وظائف PowerFx

‏‫ملاحظة‬

في كل من هذه الأمثلة، تحتاج إلى:

أنشئ ملفا باسم test-pfx.txt مع تعبيرات Power Fx في مجلد على الكمبيوتر الخاص بك، مثل c:\test.
افتح نافذة Windows PowerShell، وانتقل إلى test المجلد واستخدم run الأمر الذي يحدد الملف الذي يحتوي على الأوامر: pac power-fx run --file test-pfx.txt.

لاستخدام جداول Dataverse، يجب عليك إنشاء ملف تعريف مصادقة وتحديده. راجع pac auth create وحدد pac auth.

إذا تلقيت خطأ، فتحقق من استكشاف الأخطاء وإصلاحها.

إنشاء سجلات Dataverse

أضف النص التالي إلى 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" })

قم بتشغيل هذا الأمر:

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

أضف هذا النص إلى test-pfx.txt واحفظ الملف.
```
FirstN(Contacts, 5)
```
يسترد هذا الأمر جهات الاتصال الخمسة الأولى من Dataverse.

قم بتشغيل هذا الأمر:

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

أضف النص التالي إلى test-pfx.txt واحفظ الملف.
```
Set(x, 1)
Result = If( Mid( "asdf",x,1 ) = "a", "X", "Y" )
```
يستخدم هذا المثال دالات Mid و If و Set Power Fx.

شغّل الأمر التالي:

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>

أضف المعلمة --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

`--file` `-f`

مسار الملف المراد تنفيذه

معلمات اختيارية لتشغيل power-fx

`--echo` `-e`

صواب إذا كان يجب إعادة تكرار أوامر الإدخال إلى الإخراج

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

`--environment` `-env`

استكشاف الأخطاء وإصلاحها

فيما يلي خطوات لاستكشاف الأخطاء التي قد تواجهها عند استخدام 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.

قم بتشغيل قائمة مصادقة الأمر pac.

قد ترى نتيجة مثل ما يلي تتضمن UNIVERSAL ملف تعريف مصادقة بدون عنوان URL يشير إلى أنه مقترن ببيئة Dataverse.
```
Index Active Kind      Name Friendly Name Url User                Cloud  Type
[1]   *      UNIVERSAL                        you@yourcompany.com Public OperatingSystem
```
هذا غير كاف لأنه لم يتم تحديد بيئة Dataverse.

استخدم pac auth create لإنشاء UNIVERSAL ملف تعريف مصادقة متصل ببيئة Dataverse.

‏‫ملاحظة‬

استخدم المعلمة --environment باستخدام قيمة environmentid. ابحث عن معرف البيئة الخاص بك.

لا تستخدم المعلمة --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>

قم بتشغيل قائمة pac auth مرة أخرى. يجب أن تشاهد نتيجة مع UNIVERSAL ملف تعريف الاتصال مع عنوان URL لبيئة 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>

UNIVERSAL حدد البيئة لجعلها ملف التعريف الافتراضي باستخدام الأمر pac 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>

راجع أيضًا

مجموعات أوامر Microsoft Power Platform CLI
نظرة عامة على Microsoft Power Platform CLI

الملاحظات

هل كانت هذه الصفحة مفيدة؟

Last updated on 2026-01-07

مشاركة عبر

pac power-fx

الاوامر

pac power-fx repl

معلمات اختيارية ل power-fx repl

--environment -env

ملاحظات

الأمثلة

إضافة صفوف

تعليمات

Exit

تشغيل pac power-fx

الأمثلة

إنشاء سجلات Dataverse

الاستعلام عن جدول Dataverse

استخدام وظائف PowerFx

المعلمات المطلوبة لتشغيل power-fx

--file -f

معلمات اختيارية لتشغيل power-fx

--echo -e

--environment -env

استكشاف الأخطاء وإصلاحها

خطأ عند عدم وجود ملف تعريف مصادقة Dataverse

راجع أيضًا

الملاحظات

الموارد الإضافية

`--environment` `-env`

`--file` `-f`

`--echo` `-e`

`--environment` `-env`