שתף באמצעות

הפונקציות EndsWith ו- StartsWith‏

  • מאמר

חל על: אפליקציות קנבס זרימות שולחן העבודה Dataverse עמודות נוסחאות אפליקציות מונחות מודל Power Pages Power Platform CLI

בודקת אם מחרוזת טקסט מתחילה או מסתיימת במחרוזת טקסט אחרת.

תיאור

הפונקציה EndsWith בודקת אם מחרוזת טקסט אחת מסתיימת במחרוזת אחרת.

הפונקציה StartsWith בודקת אם מחרוזת טקסט אחת מתחילה במחרוזת אחרת.

עבור שתי הפונקציות, הבדיקות אינן תלויות רגישות. ערך ההחזרה של שתי הבדיקות הוא ערך true או false בוליאני.

השתמש ב- EndsWith וב- StartsWith עם הפונקציה Filter כדי לחפש את הנתונים ביישום שלך. באפשרותך גם להשתמש באופרטור in או בפונקציה Search כדי להסתכל במקום כלשהו במחרוזות טקסט, ולא רק בהתחלה או בסוף. בחירת הפונקציות שלך תהיה תלויה בצרכי היישום שלך ובשאלה איזו פונקציה ניתן להקצות עבור מקור נתונים מסוים שלך. אם לא ניתן להקצות אחת מהפונקציות הללו, אזהרת הקצאה תופיע בעת החיבור כדי להזהיר אותך לגבי מגבלה זו.

תחביר

EndsWith( Text, EndText )

  • טקסט – חובה. הטקסט לבדיקה.
  • EndText – חובה. הטקסט לחיפוש בסוף טקסט. אם EndText היא מחרוזת ריקה, EndsWith מחזיר true.

StartsWith( Text, StartText )

  • טקסט – חובה. הטקסט לבדיקה.
  • StartText – חובה. הטקסט לחיפוש בתחילת טקסט. אם StartText היא מחרוזת ריקה, StartsWith מחזיר true.

דוגמאות

נוסחה תיאור תוצאה
EndsWith( "שלום עולם", "עולם") בודק אם "Hello World" מסתיים ב- "world". הבדיקה אינה תלויית רישיות. נָכוֹן
EndsWith( "להתראות", "טוב") בודק אם "Good bye" מסתיים ב- "good". הארגומנט EndText ("good") מופיע בטקסט, אבל לא בסוף. שֶׁקֶר
EndsWith( "תמיד לומר שלום", "שלום") בודק אם "Always say hello" מסתיים ב- "hello". נָכוֹן
EndsWith( "ביי ביי", "") בודק אם "Bye bye" מסתיים במחרוזת טקסט ריקה (Len מחזירה 0). EndsWith מוגדרת להחזיר true במקרה זה, מה שמקל על השימוש בה בביטויי מסנן. נָכוֹן
נוסחה תיאור תוצאה
StartsWith( "שלום עולם", "שלום") בודק אם "Hello World" מתחיל ב- "hello". הבדיקה אינה תלויית רישיות. נָכוֹן
StartsWith( "להתראות", "שלום") בודק אם "Good bye" מתחיל ב- "hello". שֶׁקֶר
StartsWith( "תמיד לומר שלום", "שלום") בודק אם "Always say hello" מתחיל ב- "hello". למרות ש- "hello" מופיע בטקסט, הוא לא מופיע בהתחלה. שֶׁקֶר
StartsWith( "ביי ביי", "") בודק אם "Bye bye" מתחיל במחרוזת טקסט ריקה (Len מחזירה 0). StartsWith מוגדרת להחזיר true במקרה זה, מה שמקל על השימוש בה בביטויי מסנן. נָכוֹן

חוויית החיפוש של המשתמש

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

הדוגמאות בהמשך הנושא מציגות את התוצאות של חיפוש ברשימת לקוחות המכילה נתונים אלה:

דוגמה לרשימת הלקוחות.

כדי ליצור ערכת נתונים זו כאוסף, צור פקד Button‎ והגדר את מאפיין OnSelect שלו לנוסחה זו:

ClearCollect( Customers, Table( { שם: "Fred Garcia", חברה: "Northwind Traders" }, { שם: "Cole Miller", חברה: "Contoso" }, { שם: "Glenda Johnson", חברה: "Contoso" }, { שם: "מייק קולינס ", חברה: "Adventure Works" }, { שם: "Colleen Jones", חברה: "Adventure Works" } ) )

כמו בדוגמה זו, ניתן להציג רשימת רשומות בפקד Gallery בחלק התחתון של המסך. ליד החלק העליון של המסך, ניתן להוסיף פקד Text input בשם SearchInput כדי שהמשתמשים יוכלו לציין אילו רשומות מענייניות אותם.

גלריית לקוחות.

כאשר המשתמש מקליד תווים ב- SearchInput‎, התוצאות בגלריה מסוננות באופן אוטומטי. במקרה זה, הגלריה מוגדרת להציג רשומות שעבורן שם הלקוח (ולא שם החברה) מתחיל ברצף תווים ב- SearchInput. אם המשתמש מקליד co בתיבת החיפוש, הגלריה מציגה את התוצאות הבאות:

גלריית לקוחות עם חיפוש.

כדי לבצע סינון על בסיס העמודה Name‎, הגדר את המאפיין Items‎ של פקד ה- gallery לאחת מהנוסחאות הבאות:

נוסחה תיאור תוצאה
Filter( Customers, StartsWith( Name, SearchInput.Text) ) מסננת את מקור הנתונים Customers‎ לאיתור רשומות שבהן מחרוזת החיפוש מופיעה בתחילת העמודה Name‎. הבדיקה אינה תלויית רישיות. אם המשתמש מקליד co בתיבת החיפוש, הגלריה מציגה את Colleen Jones ואת Cole Miller. הגלריה אינה מציגה את Mike Collins מכיוון שהעמודה Name עבור רשומה זו אינה מתחילה במחרוזת החיפוש. דוגמה ל- StartsWith.
מסנן (לקוחות, SearchInput.Text in Name) מסננת את מקור הנתונים Customers‎ לאיתור רשומות שבהן מחרוזת החיפוש מופיעה במקום כלשהו בעמודה Name‎. הבדיקה אינה תלויית רישיות. אם המשתמש מקליד co בתיבת החיפוש, הגלריה מציגה את Colleen Jones, Cole Miller ו- Mike Collins מכיוון שמחרוזת החיפוש מופיעה במקום כלשהו בעמודה Name של כל הרשומות הללו. דוגמה ל- SearchInput.Text בשם.
חיפוש (לקוחות, SearchInput.Text, "שם" ) בדומה לשימוש באופרטור in, הפונקציה Search מחפשת התאמה במקום כלשהו בעמודה Name של כל רשומה. שים לב שיש להקיף את שם העמודה במרכאות כפולות. דוגמה ל- SearchInput.Text עם שם.

ניתן להרחיב את החיפוש כך שיכלול את העמודה Company‎ בנוסף לעמודה Name‎:

נוסחה תיאור תוצאה
Filter( Customers, StartsWith( Name, SearchInput.Text ) || StartsWith( Company, SearchInput.Text ) ) מסננת את מקור הנתונים Customers לאיתור רשומות שבהן העמודה Name או העמודה Company מתחילה במחרוזת החיפוש (לדוגמה, co). האופרטור || הוא true אם אחת מהפונקציות מסוג StartsWith היא true. סנן באמצעות StartsWith.
מסנן( לקוחות, SearchInput.Text בשם || SearchInput.Text בחברה ) מסננת את מקור הנתונים Customers לאיתור רשומות שבהן העמודה Name או העמודה Company מכילה את מחרוזת החיפוש (לדוגמה, co) במקום כלשהו. מסנן עם טקסט חיפוש בשם.
חיפוש( לקוחות, SearchInput.Text, "שם", "חברה") בדומה לשימוש באופרטור in‎, הפונקציה Search‎ מסננת את מקור הנתונים Customers לאיתור רשומות שבהן העמודה Name או העמודה Company מכילה את מחרוזת החיפוש (לדוגמה, co) במקום כלשהו. הפונקציה Search קלה יותר לקריאה ולכתיבה בהשוואה לפונקציה Filter אם ברצונך לציין כמה עמודות וכמה אופרטורים מסוג in. שים לב שיש להקיף את שמות העמודות במרכאות כפולות. מסנן עם טקסט חיפוש בשם, חברה.