renderSearchPage (הפניה ל- API של JavaScript) עבור Dynamics 365 Channel Integration Framework 2.0

מאפשר לך לחפש בין הרשומות של סוג ישות מסוים. API זה פותח את דף הישות של ממשק מאוחד עם שדה החיפוש שבו מאוכלס מראש במחרוזת החיפוש המועברת כפרמטר.

תחביר

Microsoft.CIFramework.renderSearchPage(entityLogicalName, searchString, correlationId, searchType).then(successCallback, errorCallback);

פרמטרים

שם	Type	נדרש	תיאור‬‏‫‬
entityLogicalName	String	כן	השם הלוגי של הישות של הרשומה שברצונך לבצע עליה שאילתה, כגון "תיק לקוח".
מחרוזת חיפוש	String	כן	מחרוזת לחיפוש בין התכונות של רשומות הישות.
correlationId	GUID	לא	המזהה הייחודי של האירוע RenderSearchPage שהועלה.
סוג חיפוש	בוליאני	לא	סוג דף החיפוש לפתיחה - 0 לחיפוש רלוונטיות ו-1 לחיפוש המחולק לקטגוריות. אם לא סופק פרמטר, מתבצע חיפוש ברשומות לפי קטגוריה. לקבלת מידע על חיפוש רלוונטיות, ראה קביעת תצורה של חיפוש Dataverse.
הצלחההתקשרות חוזרת	פונקציה	לא	פונקציה שיש לקרוא לה כאשר רשומות מסוימות מאוחזרות.
errorהתקשרות חוזרת	פונקציה	לא	פונקציה שיש לקרוא לה כאשר הפעולה נכשלת.

ערך החזרה

לאחר הצלחה, מחזירה אובייקט Promise המכיל את התכונות שצוינו בתיאור של הפרמטר successCallback .

דוגמאות

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

var entityname = "account"
var searchterm = "Contoso"
var guid = "<use new guid for every api call>"
var searchtype = 0 // relevance search

Microsoft.CIFramework.renderSearchPage(entityname, searchterm, guid, searchtype).then(
      function (success) {
        console.log(success);
    },
    function (error) {
        console.log(error);
    }
  );

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

var entityname = "account"
var searchterm = "Contoso"

Microsoft.CIFramework.renderSearchPage(entityname, searchterm).then( // if search type is not passed, it defaults to categorized search
        function (success) {​​
            console.log(success);
    }​​,
    function (error) {​​
        console.log(error);
    }​​
);