مشاركة عبر

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

  • مقالة

‏‫ملاحظة

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. وهو يؤثر على:

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

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

Power Apps formula If open paren slider1 dot value greater than 12 dot 59 comma notify open paren double-quote Valid! double-quote comma success close paren semi-colon Navigate open paren double-quote NextScreen double-quote comma None close paren comma notify open paren double-quote Invalid, try again double-quote comma error close paren close paren.

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

Power Apps formula If open paren slider1 dot value greater than 12 comma 59 semi-colon notify open paren double-quote Valid! double-quote semi-colon success close paren double semi-colon Navigate open paren double-quote NextScreen double-quote semi-colon None close paren semi-colon notify open paren double-quote Invalid, try again double-quote semi-colon error close paren close paren.

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

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

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

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

دالة Language

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

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

جدول مع نص مترجم.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • القيمة: تحويل رقم في سلسلة نصية إلى قيمة رقمية.
  • 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.