createTab (uygulama profili yöneticisi)

Odaklanmış bir oturumda bir uygulama sekmesi oluşturur ve sekmenin benzersiz tanımlayıcısını döndürür.

Sözdizimi

Microsoft.Apm.createTab(AppTabInput);

Parametreler

İsim	Türü	Required	Açıklama
AppTabInput	String	Yes	Oluşturulacak sekmenin JSON giriş özellikleri.

JSON AppTabInput parametresinin yapısı aşağıdaki gibidir:

{
    //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>;
}

Dönüş değeri

Dize olarak sekme tanımlayıcısı.

Örnekler

Bu örnekler, createTab yeni bir sekme başlatmak için yöntemi kullanır.

Temel sekme oluşturma

Odaklanmış oturumda yeni bir sekme oluşturur ve varlık adını, recordId'yi ve uygulama sekmesi şablon adını parametre olarak geçirir.

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

Varlık formuna değer geçiren bir sekme oluşturma

Odaklanılan oturumda yeni bir sekme oluşturur ve varlık adını ve uygulama sekmesi şablon adını parametre olarak geçirir. Ayrıca hedef varlık formunu ek değerlerle doldurur.

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);

Web kaynağıyla sekme oluşturma

Odaklanmış oturumda yeni bir sekme oluşturur ve uygulama sekmesi şablonu için parametre olarak bir web kaynağı geçirir.

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

İnternet kaynağı parametresini ileten bir web kaynağına sahip bir sekme oluşturun

Odaklanmış oturumda yeni bir sekme oluşturur ve bir sekme şablonu ve web kaynağı parametresini uygulama sekmesi şablonu parametreleri olarak geçirir.

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

İnternet kaynağı adını ve internet kaynağı parametresini ileten bir web kaynağına sahip bir sekme oluşturun

Odaklanmış oturumda bir sekme şablonu, web kaynağı adı ve web kaynağı parametresini uygulama sekmesi şablonu parametreleri olarak geçiren yeni bir sekme oluşturur.

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 denetim sayfasıyla bir sekme oluşturma

Odaklanmış oturumda yeni bir sekme oluşturur ve uygulama sekmesi şablonu için parametre olarak bir çerçeve denetimi geçirir. Denetim, API çağrısından geçirilir.

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
    });

Aşağıdaki parametreleri de geçirebilirsiniz:

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
    });