EndsWithופונקציות StartsWith

חל על: אפליקציות Canvas Studio Copilot Studio זורמות עמודות נוסחאות Dataverse אפליקציות מונחות דגמים Power Platform CLI Dataverse פונקציות Power Pages

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

תיאור

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

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

עבור שתי הפונקציות, הבדיקות אינן תלויות רישיות אם מקור הנתונים העורפי תומך בהן כברירת מחדל. לדוגמה, אוספים, Dataverse,‏ SharePoint ו- SQL Server תומכים באותיות רישיות כברירת מחדל. Oracle לא תומך. ערך ההחזרה של שתי הבדיקות הוא ערך true או false בוליאני.

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

תחביר

EndsWith( טקסט, טקסט קצה )

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

StartsWith( Text, StartText )

• Text - נדרש. הטקסט לבדיקה.
• StartText – נדרש. הטקסט לחיפוש בתחילת טקסט. אם StartText הוא מחרוזת ריקה, החזרת StartsWithTrue.

דוגמאות

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

נוסחה	תיאור	תוצאה
StartsWith(Hello World, hello)	בודק אם "Hello World" מתחיל ב- "hello". הבדיקה אינה תלויית רישיות.	true
StartsWith("להתראות", "שלום")	בודק אם "Good bye" מתחיל ב- "hello".	false
StartsWith("תמיד תגיד שלום", "שלום")	בודק אם "Always say hello" מתחיל ב- "hello". למרות ש- "hello" מופיע בטקסט, הוא לא מופיע בהתחלה.	false
StartsWith("ביי ביי", "" )	בודק אם "Bye bye" מתחיל במחרוזת טקסט ריקה (Len מחזירה 0). ההקלה על השימוש בה בביטויים StartsWith של מסנן מוגדרת להחזיר True במקרה זה.	true

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

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

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

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

ClearCollect(Customers, Table({ Name: "Fred Garcia", Company: "Northwind Traders" }, { Name: "Cole Miller", Company: "Contoso" }, { Name: "Glenda Johnson", Company: "Contoso" }, { Name: "Mike Collins", Company: "Adventure Works" }, { Name: "Colleen Jones", Company: "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 עבור רשומה זו אינה מתחילה במחרוזת החיפוש.
Filter( Customers, SearchInput.Text in Name )‎	מסננת את מקור הנתונים Customers‎ לאיתור רשומות שבהן מחרוזת החיפוש מופיעה במקום כלשהו בעמודה Name‎. הבדיקה אינה תלויית רישיות. אם המשתמש מקליד co בתיבת החיפוש, הגלריה מציגה את Colleen Jones,Cole Miller ו- Mike Collins מכיוון שמחרוזת החיפוש מופיעה במקום כלשהו בעמודה Name של כל הרשומות הללו.
Search( Customers, SearchInput.Text, "Name" )‎	בדומה לשימוש באופרטור in, הפונקציה Search מחפשת התאמה במקום כלשהו בעמודה Name של כל רשומה. שים לב שיש להקיף את שם העמודה במרכאות כפולות.

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

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