createTab (מנהל פרופיל יישום)

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

תחביר

Microsoft.Apm.createTab(AppTabInput);

פרמטרים

שם	סוג	נדרש	תיאור
AppTabInput	מחרוזת	כן	מאפייני קלט JSON של הכרטיסיה שתיווצר.

המבנה של פרמטר JSON AppTabInput הוא כדלקמן:

{
    //Unique Name of the Application Tab Template
    // type = string
    templateName: <unique name of the application tab template>;
    //additional context for tab creation and tab slugs
    // type  Map<string, string>
    appContext?:  Map<string, string>;
    //should this tab be focused after creation
    // type=boolean
    isFocused?: <true or false>;
}

ערך החזרה

מזהה כרטיסיה כמחרוזת.

דוגמאות

דוגמאות אלה משתמשות בשיטה createTab כדי להפעיל כרטיסייה חדשה.

יצירת כרטיסיה בסיסית

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

var tabInput = {templateName: "msdyn_entityrecord",  appContext: new Map().set("entityName", "account").set("entityId", " 22cc22cc-dd33-ee44-ff55-66aa66aa66aa"),  isFocused: true};
Microsoft.Apm.createTab(tabInput);

יצירת כרטיסיה המעבירה ערכים לטופס ישות

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

var formParams = {};
formParams["subject"] = "Collaboration task";
formParams["actualdurationminutes"] = 60;
formParams["prioritycode"] = 2;
formParams["scheduledend"] = "12/12/2030 10:00"
formParams["regardingobjectid"] = "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb";
formParams["regardingobjectidname"] = "How do I measure my tamp pressure?";
formParams["regardingobjectidtype"] = "incident";

var tabInput = {
templateName: "msdyn_entityrecord",
appContext: new Map().set("entityName", "task").set("formId", "d5b4a1b2-de4f-4f86-8768-b0730001e7d1").set("data", JSON.stringify(formParams)),
isFocused: true
};
Microsoft.Apm.createTab(tabInput);

יצירת כרטיסיה עם משאב אינטרנט

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

var tabInput = {templateName: "msdyn_omnichannel_kbsearch", isFocused: true};
Microsoft.Apm.createTab(tabInput);

יצירת כרטיסיה עם משאב אינטרנט המעביר פרמטר של משאב אינטרנט

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

var tabInput = {
    templateName:"msdyn_omnichannel_kbsearch",
    appContext: new Map().set("data", "Contoso"),
    isFocused: true}; 
Microsoft.Apm.createTab(tabInput);

יצירת כרטיסיה עם משאב אינטרנט המעביר שם משאב אינטרנט ופרמטר משאב אינטרנט

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

var tabInput = {
    templateName:" new_tabtemplate_customwebresource",
     appContext: new Map().set("data", " Contoso ").set("webresourceName","msdyn_kbsearchpagehost.html"),
    isFocused: true}; 
Microsoft.Apm.createTab(tabInput);

יצירת כרטיסיה עם דף הבקרה של Power Apps component framework

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

var controlDataParams = {};
controlDataParams["<parameter>"] = "<Value>";

x = new Map();
x.set("<custom_session_context_params_key>", "<Value>");
x.set("parametersStr", '[["controlName", "<Control_Name>"], ["data",'+JSON.stringify(controlDataParams)+']]');

Microsoft.Apm.createSession(
    {
        templateName: "<template_name>",
        sessionContext: x
    });

באפשרותך גם להעביר את הפרמטרים הבאים:

var controlDataParams = {};
controlDataParams["<parameter>"] = "<Value>";

x = new Map();
x.set("<custom_session_context_params_key>", JSON.stringify(controlDataParams));
x.set("<additional_custom_session_params>", "<Value>");

Microsoft.Apm.createSession(
    {
        templateName: "<template_name>",
        sessionContext: x
    });