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

‏‫ملاحظة‬

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

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

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

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

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

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

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

تأليف البيئة

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

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

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

• أسماء الدالات: If وNavigate وCollect، وغير ذلك.
• التحكم في أسماء الخصائص: Screen.Fill وButton.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للغة التي سيتم استخدامها لنتيجة الوظيفة. الإعداد الافتراضي هو إعداد لغة المستخدم الحالي.

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

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

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

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

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

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

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

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

• Value( "12,345.678", "en-US" ) أو Value( "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" هي لغة المستخدم ترجع قيمة التاريخ/الوقت January 1, 1970 at 11:43:02.
• DateTimeValue( "11:43:02 1/2/01", "de-DE" ) أو DateTimeValue( "11:43:02 1/2/01" ) عند وجودها حيث "de-DE" هي لغة المستخدم ترجع قيمة التاريخ/الوقت February 1, 2001 at 11:43:02.

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

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

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

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

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