الدعم العمومي

‏‫ملاحظة‬

يُعد Microsoft Power Fx هو الاسم الجديد للغة صيغة تطبيقات اللوحة. هذه المقالات قيد التقدم حيث نقوم باستخراج اللغة من تطبيقات اللوحة ودمجها مع منتجات Microsoft Power Platform الأخرى وإتاحتها كمصدر مفتوح. ابدأ ب نظرة عامة على Microsoft Power Fx نبذة عن مقدمة عن اللغة.

أثناء بناء المنطق وتشغيله على ال سواء، سيتم عرض النص المعروض بواسطة Power Fx باللغات المناسبة. يتم استخدام الكتابة في التاريخ و الأرقام وعرضها للغة والمنطقة الخاصة بك.

على سبيل المثال، تستخدم بعض مناطق العالم . (نقطة) كفاصل عشري، بينما تستخدم مناطق أخرى , (فاصلة). وهذا ما يفعله Excel أيضا. لا يتم ذلك عادةً في لغات البرمجة الأخرى، والتي تستخدم بشكل عام نقطة أساسية (.) كفاصل عشري لجميع المستخدمين في جميع أنحاء العالم. لكي تكون قابلا للقرب قدر الإمكان بالنسبة للصانع على كافة المستويات، من المهم أن يكون 3,14 رقما عشريا لشخص في باريس قام باستخدام هذه الجملة في كل تلك التعليمات الموجزة الخاصة به.

ويمكنك التعرف علي التطبيقات التي تقوم بإنشاءها بشكل عمومي. استخدم الدالات لغة ونص وقيمة وDateValue والوظائف الأخرى لتعديل ما يتم عرضه واستخدامه كإدخال بلغات مختلفة.

إعدادات اللغة

عند استخدام الاستوديو الاصليه أو المشغل الأصلي، يتم توفير اللغة المستخدمة بواسطة نظام التشغيل المضيف. النسبة لنظام التشغيل Windows، يمكن التحكم في هذا الإعداد ضمن "جميع الإعدادات" و"إعدادات اللغة والوقت". كما يتيح لك Windows امكانيه تحديد الأحرف التي سيتم استخدامها للفاصل العشري، وتجاوز إعداد اللغة.

عند استخدام خبرات الويب، يتم توفير اللغة المستخدمة بواسطة المستعرض. يكون معظم المستعرض الافتراضي لإعداد نظام التشغيل المضيف مع بعضها يوفر أيضا طريقه لتعيين اللغة يدويا.

تأليف البيئة

تتكيف بيئة التأليف مع إعداد اللغة للمؤلف. ويتم تخزين التطبيق نفسه بطريقه خاصة باللغة، وبذلك يستطيع الكتاب الذين يستخدمون لغات مختلفه تحرير نفس التطبيق.

الأسماء في الصيغ

تكون معظم العناصر في الصيغ دائما باللغة الانجليزيه:

• أسماء الدالات: If وNavigate وCollect، وغير ذلك.
• التحكم في أسماء الخصائص: Screen.Fill والزر.OnSelect وTextbox.Font وغير ذلك.
• أسماء التعدادات: Color.Aqua وDataSourceInfo.MaxValue وFontWeight.Bold وغير ذلك.
• سجلات الإشارات: Compass.Heading وLocation. Latitude وApp.ActiveScreen وغير ذلك.
• عوامل التشغيل: Parent وin وexactIn وغير ذلك.

اثناء ترجمه تجربه التاليف، ستظهر أسماء التحكم والكائنات الأخرى باللغة الاصليه للكاتب. في الاسبانيه، تظهر بعض أسماء عناصر التحكم بالشكل التالي:

عند ادراج أحد عناصر التحكم هذه في تطبيقك، سيكون اسمها بشكل افتراضي باللغة الإنجليزية. يتم إجراء هذا التغيير لتمكين التناسق مع أسماء خصائص عناصر التحكم وبقية الصيغة. على سبيل المثال، يتم إدراج Casilla المدرجة أعلاه كـ Checkbox1.

وبعد ان يتم ادراج أحد عناصر التحكم، يمكنك تغيير الاسم إلى اي شيء ترغب فيه. أثناء تحديده، يعرض الجانب الأيمن من شريط "المحتوى" اسم عنصر التحكم. يؤدي تحديد هذا الاسم إلى إسقاط مربع نص حيث يمكنك تحرير الاسم:

إذا كنت ترغب في ذلك، فيمكنك أعاده تسميه عنصر التحكم إلى Casilla1. يعود سبب الأحمر المتعرج، في هذه الحالة معروض بواسطة المستعرض، إلى أن الاسم ليست كلمة إسبانية وليس له أهمية.

يمكنك استخدام اي أسماء ترغب فيها ل:

• أسماء عناصر التحكم
• أسماء المجموعات
• أسماء متغيرات السياق

فواصل الصيغ وعامل التسلسل

ستقوم بعض الفواصل وعوامل التشغيل بالإزاحة استنادًا إلى الفاصل العشري للغة المؤلف:

الفاصل العشري للغة المؤلف	الفاصل العشري لتطبيقات Power Apps	فاصل قائمة Power Apps	عامل تسلسل Power Apps
. (نقطة أو علامة نهاية الجملة)	. (نقطة أو علامة نهاية الجملة)	, (فاصلة)	; (فاصلة منقوطة)
, (فاصلة)	, (فاصلة)	; (فاصلة منقوطة)	؛؛ (فاصلة منقوطة مزدوجة)

يتوافق التغيير في فاصل قائمة Power Apps مع ما يحدث لفاصل قائمة Excel. وهو يؤثر على:

• الوسيطات في استدعاءات الدالات.
• الحقول في سجل.
• السجلات في جدول.

على سبيل المثال، ضع في اعتبارك الصيغة التالية التي يتم التعبير عنها باستخدام اللغة والمنطقة التي تستخدم نقطه أو فتره كالفاصل العشري، مثل اليابان أو المملكة المتحدة:

الآن اعرض هذه الصيغة نفسها في لغة ومنطقة حيث يتم استخدام فاصلة للفاصل العشري، مثل فرنسا أو إسبانيا:

يظهر التمييز عوامل التشغيل التي تتغير بين الإصدارين. مشغل تحديد الخاصية في . (نقطه) في Slider1.Value هو نفسه دائمًا، بصرف النظر عو الفاصل العشري.

لا تتغير الصيغة داخليًا، تتغير فقط طريقة عرضها وتحريرها بواسطة المؤلف. يمكن لكتابين مختلفين باستخدام لغتين مختلفتين عرض نفس الصيغة وتحريرها، مع رؤية الفواصل والعوامل المناسبة للغة الخاصة بهم.

إنشاء تطبيق عمومي

ويمكن للتطبيق الذي تقوم بإنشاءه ان يقوم باستخدام لغات مختلفه، مما يوفر تجربه مستخدم رائعه للمستخدمين في جميع انحاء العالم.

دالة Language

تقوم وظيفة لغة بإرجاع علامة اللغة للمستخدم الحالي. على سبيل المثال، تقوم هذه الدالة بإرجاع "en-GB" للمستخدمين في بريطانيا العظمى و"de-DE" للمستخدمين في ألمانيا.

من بين الأشياء الأخرى، يمكنك استخدام دالة Language لعرض النص المترجم للمستخدمين. يمكن ان يشتمل تطبيقك علي جدول يضم القيم المترجمة في تطبيقك:

ثم استخدم صيغه كالتالي لسحب السلاسل المترجمة من الجدول:

LookUp( Table1, TextID = "Hello" && (LanguageTag = Left( Language(), 2 ) || IsBlank( LanguageTag ))).LocalizedText

قد تكون السلاسل المترجمة في لغات أخرى أطول من مما هي في لغتك. في كثير من الحالات، ستحتاج التسميات والعناصر الأخرى التي تعرض السلاسل في واجهه المستخدم إلى ان تكون أوسع للتوافق.

لمزيد من المعلومات، راجع وثائق وظيفة لغة.

تنسيق الأرقام والتواريخ والأوقات

تتم كتابه الأرقام والتواريخ والأوقات بتنسيقات مختلفه في أجزاء مختلفه من العالم. ويختلف معني الفاصلة، والأرقام العشرية، وترتيب الشهر، والتاريخ، والسنه من الموقع إلى الموقع.

تعمل وظيفة نص على تنسيق الأرقام والتواريخ باستخدام إعداد اللغة الخاص بالمستخدم.

تتطلب دالة Text سلسلة تنسيق لمعرفة الطريقة التي تريد بها تنسيق الرقم أو التاريخ. ويمكن لسلسله التنسيق هذه ان تستخدم أحد النموذجين التاليين:

• تعداد عمومي واعي. على سبيل المثال، Text( Now(), DateTimeFormat.LongDate ). ستقوم هذه الصيغة بتنسيق التاريخ الحالي بالتنسيق المناسب للغة. يعتبر هذا الأسلوب الطريقة المفضلة لتحديد سلسلة التنسيق.
• سلسله تنسيق مخصصة. على سبيل المثال، تعرض Text( Now(), "[$-en-US]dddd, mmmm dd, yyyy" ) نفس النص كالتعداد عند استخدامه باللغة "en-US". ان الميزة الخاصة بسلسلة التنسيق المخصصة هي انه يمكنك تحديد ما تريده بالضبط.

تخبر "[$-ar-sa]" الموجود في مقدمه سلسله التنسيق المخصصة Text باللغة التي ستترجم فيها سلسله التنسيق المخصصة. يتم ادراج هذه السلسلة لك وتتخذ لغة التأليف لديك بشكل افتراضي. لا تحتاج عادةً إلى تغيير هذه السلسلة. وتعتبر مفيدة عندما يقوم مؤلفون من لغات مختلفة بتحرير نفس التطبيق.

تحدد الوسيطة الثالثة لدالة Text hللغة التي سيتم استخدامها لنتيجة الدالة. الإعداد الافتراضي هو إعداد لغة المستخدم الحالي.

لمزيد من المعلومات، راجع وثائق وظيفة نص.

قراءة الأرقام والتواريخ والأوقات

هناك أربعه دالات لقراءه الأرقام والتواريخ والأوقات التي يوفرها المستخدم:

• Value: تحوِّل رقم في سلسلة نصية إلى قيمة رقمية.
• DateValue: تحويل قيمة تاريخ في سلسلة نصية إلى قيمة تاريخ/وقت. يتم تجاهل أي وقت محدد في السلسلة النصية.
• TimeValue: تحويل قيمة وقت في سلسلة نصية إلى قيمة تاريخ/وقت. ويتم تجاهل اي تاريخ محدد في السلسلة النصية.
• DateTimeValue: تحويل قيمة تاريخ ووقت في سلسلة نصية إلى قيمة تاريخ/وقت.

إذا كنت قد استخدمت Excel، يتم دمج كافة هذه الدالات في دالة Value واحدة. لقد تم فصلها هنا نظرًا لأن Power Apps تحتوي على أنواع منفصلة لقيم وأرقام التاريخ/الوقت.

كل هذه الدالات لها نفس الوسيطات:

• يتطلب سلسلة: سلسلة من المستخدم. على سبيل المثال، تتم كتابة سلسلة لعنصر تحكم إدخال النص وقراءة من عنصر التحكم بواسطة خاصية النص.
• لغة، اختياري: اللغة المراد ترجمة سلسلة إليها. بشكل افتراضي، إعداد اللغة للمستخدم.

على سبيل المثال:

• القيمة( "12,345.678", "en-US" ) أو القيمة( "12,345.678" ) عند تحديد موقعها حيث تكون "en-US" هي لغة المستخدم فإنها تُرجع الرقم 12345.678، جاهزاً لعمليات الحساب.
• DateValue( "1/2/01", "es-ES" ) أو DateValue( "1/2/01" ) عند تحديد موقعها حيث تكون "es-ES" هي لغة المستخدم، تُرجع قيمة التاريخ/الوقت 1 فبراير 2001 عند منتصف الليل.
• TimeValue( "11:43:02", "fr-FR" ) أو TimeValue( "11:43:02" ) عند وجودها حيث "fr-FR" هي لغة المستخدم ترجع قيمة التاريخ/الوقت 1 يناير 1970 في تمام الساعة 11:43:02.
• DateTimeValue( "11:43:02 1/2/01", "de-DE" ) أو DateTimeValue( "11:43:02 1/2/01" ) عند وجودها حيث "de-DE" هي لغة المستخدم ترجع قيمة التاريخ/الوقت 1 فبراير 2001 في تمام الساعة 11:43:02.

لمزيد من المعلومات، راجع الوثائق الخاصة بوظائف قيمة وDateValue وTimeValue وDateTimeValue.

معلومات التقويم والساعة

توفر وظيفتا تقويم وساعة معلومات التقويم والساعة للغة المستخدم الحالية.

من بين الأشياء الأخرى، استخدم هذه الدالات لتوفير عنصر تحكم القائمة المنسدلة مع قائمه من الخيارات.

لمزيد من المعلومات، راجع وثائق وظيفتي Calendar وClock.