תמיכה גלובלית

הערה

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". היתרון של מחרוזת התבנית המותאמת אישית היא שבאפשרותך לציין בדיוק את מה שאתה רוצה.

החלק "[$-en-US]" לפני מחרוזת התבנית המותאמת אישית מיידע את Text באיזו שפה לפרש את מחרוזת התבנית המותאמת אישית. מחרוזת זו הוזנה עבורך ונכתבת בשפת העריכה שלך כברירת מחדל. בדרך כלל לא תצטרך לשנות מחרוזת זו. זה שימושי כאשר מחברים משפות שונות עורכים את אותו יישום.

הארגומנט השלישי ל- Text מציין באיזו שפה להשתמש עבור תוצאת הפונקציה. ברירת המחדל היא הגדרת השפה של המשתמש הנוכחי.

לקבלת מידע נוסף, עיין בתיעוד של הפונקציה טקסט.

קריאת מספרים, תאריכים ושעות

קיימות ארבע פונקציות לקריאת מספרים, תאריכים ושעות שסופקו על-ידי המשתמש:

• Value: המרת מספר במחרוזת טקסט לערך מספר.
• DateValue: המרת ערך תאריך במחרוזת טקסט לערך תאריך/שעה. כל זמן שהוא שצוין במחרוזת הטקסט זוכה להתעלמות.
• TimeValue: המרת ערך שעה במחרוזת טקסט לערך תאריך/שעה. הפונקציה מתעלמת מכל תאריך שצוין במחרוזת הטקסט.
• DateTimeValue: המרת ערך תאריך ושעה במחרוזת טקסט לערך תאריך/שעה.

אם השתמשת ב- Excel, כל הפונקציות הללו משולבות בפונקציית Value הבודדת. הן מתפרקות כאן משום של- Power Apps יש סוגים נפרדים עבור ערכי תאריך/שעה ומספרים.

לכל הפונקציות הללו יש אותם ארגומנטים:

• String, required: מחרוזת מהמשתמש. לדוגמה, מחרוזת מסווגת כפקד קלט טקסט ונקראת מהפקד עם המאפיין Text.
• Language, optional: השפה שבה יש לפרש את String. כברירת מחדל, הגדרת השפה של המשתמש.

לדוגמה:

• 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 .

מידע על לוח השנה והשעון

הפונקציות לוח שנה ו- שעון מספקות מידע על לוח השנה והשעון עבור השפה הנוכחית של המשתמש.

בין היתר, השתמש בפונקציות אלה כדי לספק פקד רשימה נפתחת עם רשימת אפשרויות בחירה.

לקבלת מידע נוסף, עיין בתיעוד של הפונקציות לוח שנה ושעון.