مرجع الصيغ - Power Apps
في هذه المقالة، تعرف على جميع الدالات المتوفرة في Power Apps.
تضم الصيغ في Power Apps عناصر متعددة. المدرجة أدناه هي:
- تلتقط الدالات المعلمات، وتنفذ إحدى العمليات، وترجع قيمة. علي سبيل المثال ، Sqrt(25) ترجع 5. يتم تصميم الدالات بنفس طريقة تصميم دالات Microsoft Excel. تحتوي بعض الدالات على تأثيرات جانبية، مثل SubmitForm، والتي تكون مناسبة فقط في صيغة السلوك مثل Button.OnSelect.
- الإشارات ترجع معلومات حول البيئة. على سبيل المثال، يقوم Locationبإرجاع إحداثيات GPS الحالية الخاصة بالجهاز. لا تلتقط الإشارات معلمات ولا تحتوي على تأثيرات جانبية.
- التعدادات ترجع قيمة ثابتة معرفة مسبقا. علي سبيل المثال، Color هو قائمة تعداد تحتوي على قيم محددة مسبقا للألوان Color.RedوColor.Blueوما إلى ذلك. يتم تضمين قوائم التعداد الشائعة هنا؛ يتم وصف التعدادات الخاصة بالدالة مع الدالة.
- توفر عوامل التشغيل المسماة، مثل ThisItem وSelf، الوصول إلى المعلومات من داخل حاوية.
تشمل العناصر الأخرى:
A
Abs – قيمة مطلقة لرقم.
Acceleration – يقرأ مجس التسارع في جهازك..
Acos – ترجع قوس جيب تمام لرقم بالتقدير الدائري.
Acot – ترجع قوس ظل تمام لرقم بالتقدير الدائري.
AddColumns – ترجع جدولاً يتضمن أعمدة مضافة.
And – قيمة AND منطقية. ترجع القيمة true إذا كانت كافة الوسائط بالقيمة true. يمكنك أيضًا استخدام عامل التشغيل &&.
AIClassify – تصنف هذه الدالة النص إلى فئة أو أكثر من الفئات المتوفرة.
AIExtract – تستخرج هذه الدالة كيانات محددة مثل أرقام التسجيل أو أرقام الهاتف أو أسماء الأشخاص.
AIReply – تقوم هذه الدالة بصياغة رد على الرسالة التي تقدمه.
AISentiment – تكتشف هذه الدالة توجه النص الذي تقدمه.
AISummarize – تلخص هذه الدالة النص الذي تقدمه.
AITranslate – تترجم هذه الدالة نصًا من لغة أخرى.
App – يوفر معلومات حول التطبيق الذي يعمل حاليا والتحكم في سلوك التطبيق.
Asin – ترجع قوس جيب الزاوية لرقم بالتقدير الدائري.
Assert – يقيّم إلى true أو false في اختبار.
As – تسمية السجل الحالي في وظائف المعرض والنموذج ونطاق السجل مثل ForAll وWith وSum.
AsType – التعامل مع مرجع سجل على أنه نوع جدول محدد.
Atan – إرجاع قوس الظل لرقم بالتقدير الدائري..
Atan2 – إرجاع قوس الظل الذي يستند إلى إحداثية (س، ص)، بالتقدير الدائري.
Average – حساب متوسط تعبير الجدول أو مجموعة من الوسيطات.
B
Back – عرض الشاشة السابقة.
Blank – إرجاع قيمة فارغة يمكن استخدامها لإدخال قيمة NULL في مصدر البيانات.
Boolean – تحويل سلسلة نصية أو رقم أو قيمة غير مصنفة إلى قيمة منطقية.
C
Calendar – استرداد معلومات حول التقويم للإعدادات المحلية الحالية.
Char – ترجمة رمز الحرف إلى سلسلة.
Choices – إرجاع جدول بالقيم المحتملة لعمود بحث.
Clear – حذف كافة البيانات من مجموعة.
ClearCollect – حذف كافة البيانات من مجموعة ثم إضاف مجموعة من السجلات.
ClearData – مسح مجموعة أو كل المجموعات من مضيف التطبيق مثل جهاز محلي.
Clock – استرداد معلومات حول الساعة للإعدادات المحلية الحالية.
Coalesce – استبدال القيم الفارغة من دون تغيير القيم غيرالفارغة.
Collect – إنشاء مجموعة أو إضافة بيانات إلى مصدر البيانات.
Color – تعيين خاصية إلى قيمة ألوان مضمنة.
ColorFade – لإظهار تلاشي قيمة اللون.
ColorValue – ترجمة اسم اللون أو الرمز السداسي عشري لـ CSS إلى قيمة اللون.
Column – استرداد أسماء الأعمدة والقيم من نوع كائن غير مصنف.
ColumnNames – استرداد أسماء الأعمدة والقيم من نوع كائن غير مصنف.
Compass – إرجاع عنوان بوصلتك.
Concat – إنشاء السلاسل في مصدر البيانات.
Concatenate – إنشاء السلاسل.
Concurrent – تقييم صيغ متعددة في الوقت نفسه مع بعضها البعض.
Connection – إرجاع معلومات حول اتصال الشبكة.
نسخ – نسخ النص إلى الحافظة على الجهاز حيث يتم تشغيل التطبيق.
Count – حساب سجلات الجداول التي تحتوي علي أرقام.
Cos – إرجاع جيب تمام الزاوية المحددة بالتقدير الدائري.
Cot – إرجاع ظل تمام الزاوية المحددة بالتقدير الدائري.
CountA – تعداد سجلات الجداول غير الفارغة.
CountIf – حساب سجلات الجدول التي تفي بشرط ما.
CountRows – حساب سجلات الجدول.
D
DataSourceInfo – توفير معلومات حول مصدر البيانات.
Date – إرجاع قيمة تاريخ/وقت، بناء على قيم Year وMonth وDay.
DateAdd – إضافة أيام أو شهور أو فصول أو سنوات إلى قيمة تاريخ/وقت.
DateDiff – طرح قيمتي التاريخ، وتظهر النتيجة بالأيام أو الشهور أو أرباع السنة أو السنوات.
التاريخ والوقت- إرجاع قيمة التاريخ/الوقت، بناءً على مكونات التاريخ والوقت.
DateTimeValue – تحويل سلسلة التاريخ والوقت إلى قيمة تاريخ/وقت.
DateValue – تحويل سلسلة التاريخ فقط إلى قيمة تاريخ/وقت.
Day – استرداد جزء اليوم من قيمة التاريخ/الوقت.
Dec2Hex -تحويل رقم إلى سلسلة نصية سداسية عشرية.
Defaults – إرجاع القيم الافتراضية لمصدر البيانات.
Degrees - تحويل التقدير الدائري إلى درجات.
Disable – تعطيل إشارة، مثل Location لقراءة GPS.
Distinct – تلخيص سجلات الجدول مع إزالة التكرارات.
Download – تنزيل ملف من الويب إلى الجهاز المحلي.
DropColumns – إرجاع جدول يحتوي على عمود واحد أو أكثر تمت إزالته.
E
EDate - إضافة أشهر إلى التاريخ أو طرحها، دون تغيير اليوم من الشهر.
EditForm – إعادة تعيين عنصر تحكم نموذج لتحرير عنصر.
Enable – تمكين إشارة، مثل Location لقراءة GPS.
EncodeUrl – ترميز الأحرف الخاصة باستخدام ترميز عنوان URL.
EndsWith – التحقق مما إذا كانت سلسلة النص تنتهي مع سلسلة نصية أخرى.
EOMonth - يضيف أو طرح أشهر من التاريخ مع إرجاع آخر يوم في ذلك الشهر.
خطأ – إنشاء خطأ مخصص أو المرور عبر خطأ.
Errors – توفير معلومات عن الخطأ للتغييرات السابقة إلى مصدر البيانات.
exactin – التحقق مما إذا كانت السلسلة النصية مضمنة داخل سلسلة نصية أو جدول آخر، حسب الحالة. يستخدم أيضًا للتحقق مما إذا كان أحد السجلات موجودًا في جدول.
Exit – إنهاء التطبيق الذي يعمل حاليًا وتسجيل خروج المستخدم الحالي بشكل اختياري.
Exp - إرجاع e مرفوع إلى أُس.
F
Filter – إرجاع جدول تمت تصفيته استنادًا إلى معيار واحد أو أكثر.
Find – التحقق مما إذا كانت هناك سلسلة تظهر في أخرى وإرجاع الموقع.
First – إرجاع السجل الأول لجدول.
FirstN – إرجاع مجموعة السجلات الاولى (سجلات N) لجدول.
ForAll – حساب القيم وتنفيذ إجراءات لكافة سجلات الجدول.
G
GroupBy – إرجاع جدول يحتوي علي سجلات مجمعة معًا.
GUID – تحويل سلسلة GUID إلى قيمه GUID أو إنشاء قيمة معرف فريد عمومي (GUID) جديدة.
H
HashTags – استخراج علامات التجزئة (#strings) من سلسلة.
Dec2Hex -تحويل سلسلة نصية سداسية عشرية إلى رقم.
المضيف – توفير معلومات حول المضيف الحالي الذي يقوم بتشغيل التطبيق.
Hour – إرجاع جزء الساعة من قيمة التاريخ/الوقت.
I
If – إرجاع قيمة واحدة إذا كان الشرط صحيحًا وقيمة أخرى إذا لم يكن كذلك.
IfError - الكشف عن الأخطاء وتوفير قيمة بديلة أو اتخاذ اجراء.
in – التحقق مما إذا كانت السلسلة النصية مضمنة داخل سلسلة نصية أو جدول آخر، لا يعتمد هذا الأمر على الحالة. يستخدم أيضًا للتحقق مما إذا كان أحد السجلات موجودًا في جدول.
Index – إرجاع سجل من جدول بناء على الموضع المرتب.
Int – لتقريب القيمة تنازليًا إلى أقرب عدد صحيح.
IsBlank – التحقق من قيمة فارغة.
IsBlankOrError – التحقق من قيمة فارغة أو خطأ.
IsEmpty – التحقق من وجود جدول فارغ.
IsError – التحقق من وجود خطأ.
IsMatch – التحقق من وجود سلسلة مقابل نموذج. ويمكن استخدام التعبيرات العادية.
IsNumeric – التحقق من وجود قيمة رقمية.
ISOWeekNum – إرجاع رقم أسبوع الـ ISO لقيمة التاريخ/الوقت.
IsToday – للتحقق مما إذا كانت قيمة التاريخ/الوقت في وقت ما اليوم في المنطقة الزمنية للمستخدم.
IsType – التحقق مما إذا كان مرجع سجل يشير إلى نوع جدول محدد أم لا.
IsUTCToday – للتحقق مما إذا كانت قيمة التاريخ/الوقت في وقت ما اليوم بالتوقيت العالمي المنسق (UTC).
J
JSON – إنشاء سلسلة نصية JSON لجدول أو سجل أو قيمة.
L
Language – إرجاع علامة اللغة الخاصة بالمستخدم الحالي.
Last – إرجاع السجل الأخير لجدول.
LastN – إرجاع مجموعة السجلات الأخيرة (سجلات N) لجدول.
Launch – بدء صفحة ويب أو تطبيق لوحة.
Left – إرجاع الجزء الأيسر من السلسلة.
Len – إرجاع طول السلسلة.
Ln – إرجاع السجل الطبيعي.
LoadData – تحميل مجموعة من مضيف التطبيق مثل جهاز محلي.
Location – إرجاع موقعك كإحداثية مخطط باستخدام نظام المواقع العالمي (GPS) ومعلومات أخرى.
Log – إرجاع لوغاريتم في أي قاعدة من الأرقام.
LookUp – البحث عن سجل مفرد في جدول يستند إلى معيار واحد أو أكثر.
Lower – تحويل الأحرف الأقل في سلسلة نصية إلى أحرف كلها صغيرة.
M
Match – استخراج السلسلة الفرعية بناء على نمط ما. ويمكن استخدام التعبيرات العادية.
MatchAll – استخراج سلاسل فرعية متعددة بالاستناد إلى نمط. ويمكن استخدام التعبيرات العادية.
Max – الحد الأقصى لقيمة تعبير الجدول أو مجموعة من الوسائط.
Mid – إرجاع الجزء الأوسط من سلسلة.
Min – الحد الأدنى لقيمة تعبير الجدول أو مجموعة من الوسائط.
Minute – استرداد جزء الدقيقة من قيمة التاريخ/الوقت.
Mod – إرجاع القيمة المتبقية بعد قسمة المقسوم علي المقسوم عليه.
Month – استرداد جزء الشهر من قيمة التاريخ/الوقت.
N
Navigate – تغيير الشاشة التي يتم عرضها.
NewForm – إعادة تعيين عنصر تحكم نموذج لإنشاء عنصر.
Not – قيمة NOT منطقية. تقوم بإرجاع true إذا كانت الوسيطة الخاصة بها false ، وتقوم بإرجاع false إذا كانت الوسيطة الخاصة بها true. يمكنك أيضًا استخدام العامل !.
Notify – عرض رسالة شعار للمستخدم.
Now – إرجاع قيمة التاريخ/الوقت الحالية في المنطقة الزمنية للمستخدم.
O
Or – قيمة OR منطقية. ترجع القيمة trueإذا كان أي من الوسائط بالقيمة true. يمكنك أيضا استخدام ||العامل .
P
Param – الوصول للمعلمات التي تم إدخالها إلى تطبيق اللوحة عند تشغيلها.
Parent – توفير الوصول إلى خصائص عنصر تحكم الحاوية.
ParseJSON – تحويل مستند JSON ممثل كنص إلى قيمة كائن غير مصنف.
Patch – تعديل أو إنشاء سجل في مصدر البيانات، أو دمج السجلات خارج مصدر البيانات.
PDF – تصدير المحتويات من الشاشة الرئيسية إلى كائن لاستخدامها في سيناريوهات متعددة.
Pi – إرجاع الرقم π.
PlainText – إزالة علامات HTML وXML من سلسلة.
Power – إرجاع عدد مرفوع إلى أُس. يمكنك أيضا استخدام ^العامل .
Proper – تحويل الحرف الأول من كل كلمة في سلسلة إلى الأحرف الكبيرة، وتحول الباقي إلى حروف صغيرة.
R
Radians - تحويل الدرجات إلى تقدير دائري.
Rand – لإرجاع رقم عشوائي زائف بين 0 إلى 1.
RandBetween – لإرجاع رقم عشوائي زائف بين رقمين.
ReadNFC – قراءة علامة اتصال المجال القريب (NFC).
RecordInfo – توفير معلومات حول سجل مصدر البيانات.
Refresh – تحديث سجلات مصدر البيانات.
Relate – ربط سجلات جدولين وعدم تسجيلها من خلال علاقة واحد إلى متعدد أو متعدد إلى متعدد.
Remove – إزالة سجل واحد محدد أو أكثر من مصدر البيانات.
RemoveIf – إزالة السجلات من مصدر البيانات بالاستناد إلى شرط.
RenameColumns – إعادة تسمية أعمدة جدول.
Replace – استبدال جزء من سلسلة بسلسلة أخرى، بواسطة بدء موضع السلسلة.
RequestHide – إخفاء نموذج SharePoint.
Reset – إعادة تعيين التحكم في الإدخال إلى قيمته الافتراضية، مع تجاهل أي تغييرات على المستخدم.
ResetForm – إعادة تعيين عنصر تحكم نموذج لتحرير عنصر موجود.
Revert – إعادة تحميل ومسح الأخطاء الخاصة بسجلات مصدر البيانات.
RGBA – إرجاع قيمة لون لمجموعة من مكونات الأحمر والأخضر والأزرق وألفا.
Right – إرجاع الجزء الأيمن من السلسلة.
Round – تقريب إلى الرقم الأقرب.
RoundDown – تقريب لأسفل إلى الرقم السابق الأكبر.
RoundUp – تقريب لأعلى إلى الرقم الأصغر التالي
S
SaveData – حفظ مجموعة إلى مضيف التطبيق مثل جهاز محلي.
Search – البحث عن سجلات في جدول يحتوي على سلسلة في أحد الأعمدة الخاصة بها.
Second – استرداد جزء الثانية من قيمة التاريخ/الوقت.
Select – محكاة إجراء محددً في عنصر تحكم، مما يتسبب في تقييم الصيغة OnSelect.
Self – توفير الوصول إلى خصائص عنصر التحكم الحالي.
Sequence – إنشاء جدول بالأرقام التسلسلية، وهي ميزة مفيدة عند التكرار مع ForAll.
SendAppNotification (إصدار أولي) – إرسال إعلام في التطبيق مع إجراءات اختيارية إلى المستلم.
Set – تعيين قيمة متغير عمومي.
SetFocus – نقل تركيز الإدخال إلى عنصر تحكم معين.
SetProperty – محاكاة التفاعلات مع عناصر تحكم الإدخال.
ShowColumns – إرجاع جدول بأعمدة محددة فقط.
ShowHostInfo – عرض معلومات للمستخدم في التطبيق.
Shuffle – تسجيل سجلات جدول بشكل عشوائي.
Sin – إرجاع جيب الزاوية المحددة بالتقدير الدائري.
Sort – إرجاع جدول تم فرزه استنادًا إلى صيغة.
SortByColumns – إرجاع جدول تمت فرزه استنادا إلى عمود واحد أو أكثر.
Split – تقسيم السلسلة النصية إلى جدول السلاسل الفرعية.
Sqrt – إرجاع الجذر التربيعي لرقم.
StartsWith – تقوم بالتحقق مما إذا كانت سلسلة النص تبدأ مع سلسلة نصية أخرى.
StdevP – إرجاع الانحراف المعياري لوسيطاته.
Substitute – استبدال جزء من سلسلة بسلسلة أخرى، بواسطة سلاسل متطابقة.
SubmitForm – حفظ العنصر الموجود في عنصر تحكم النموذج إلى المصدر البيانات.
Sum – حساب متوسط تعبير الجدول أو مجموعة من الوسيطات.
Switch – مطابقة مع مجموعة من القيم، ثم تقييم صيغة مقابلة.
T
Table – إنشاء جدول مؤقت
Tan - إرجاع ظل الزاوية المحددة بالتقدير الدائري.
Text – تحويل أية قيمة وتنسيق قيمة رقم أو تاريخ/وقت إلى سلسلة نصية.
ThisItem – إرجاع سجل العنصر الحالي في معرض أو عنصر تحكم نموذج.
ThisRecord – إرجاع السجل الخاص بالعنصر الحالي في وظيفة نطاق السجل، مثل ForAll وWith وSum.
Time – إرجاع قيمة تاريخ/وقت، بناء على قيم Hour وMinute وSecond.
TimeValue – تحويل سلسلة الوقت فقط إلى قيمة تاريخ/وقت.
TimeZoneOffset – إرجاع الفرق بين UTC والوقت المحلي للمستخدم بالدقائق.
Today – إرجاع قيمة التاريخ الحالي فقط.
Trace - توفير معلومات إضافية في نتائج الاختبار الخاصة بك.
Trim – إزالة المسافات الزائدة من نهايات والجزء الداخلي من سلسلة نص .
TrimEnds – إزالة المسافات الزائدة من نهايات سلسلة نص.
Trunc – اقتطاع الرقم إلى جزء العدد صحيح فقط عن طريق إزالة أي جزء عشري.
U
Ungroup – إزالة التجميع.
UniChar – ترجمة رمز Unicode إلى سلسلة.
Unrelate – إلغاء ربط سجلات جدولين وعدم تسجيلها من خلال علاقة واحد إلى متعدد أو متعدد إلى متعدد.
Update – استبدال سجل في مصدر البيانات.
UpdateContext – تعيين قيمة واحدة أو أكثر من متغيرات السياق للشاشة الحالية.
UpdateIf – تعديل مجموعة من السجلات في مصدر البيانات استنادا إلى شرط.
Upper – تحويل الأحرف الأقل في سلسلة نصية إلى أحرف كلها كبيرة.
User – إرجاع معلومات حول المستخدم الحالي.
UTCNow – إرجاع قيمة التاريخ/الوقت الحالية بالتوقيت العالمي المتفق عليه (UTC).
UTCToday – إرجاع قيمة التاريخ الحالي فقط بالتوقيت العالمي المتفق عليه (UTC).
V
Validate – التحقق مما إذا كانت قيمة عمود واحد أو سجل كامل صالحة لمصدر البيانات.
Value – تحويل سلسلة إلى رقم.
VarP – إرجاع تباين الوسيطات الخاصة بها.
ViewForm – إعادة تعيين عنصر تحكم نموذج لعرض عنصر موجود.
W
Weekday – استرداد جزء يوم الأسبوع من قيمة التاريخ/الوقت.
WeekNum – إرجاع رقم أسبوع قيمة التاريخ/الوقت.
With – حساب القيم وتنفيذ إجراءات لسجل مفرد، بما في ذلك السجلات الموضعية لقيم مسماة.
Y
Year – استرداد جزء السنة من قيمة التاريخ/الوقت.