createTab (administrador de perfiles de aplicaciones)

Crea una pestaña de aplicación en una sesión enfocada y devuelve el identificador único de la pestaña.

Syntax

Microsoft.Apm.createTab(AppTabInput);

Parámetros

La estructura del parámetro JSON AppTabInput es la siguiente:

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

Valor devuelto

Identificador de pestaña como String.

Examples

En estos ejemplos se usa el createTab método para iniciar una nueva pestaña.

Crear una pestaña básica

Crea una nueva pestaña en la sesión enfocada, pasando el nombre de la entidad, recordId y el nombre de la plantilla de pestaña de la aplicación como parámetros.

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

Crear una pestaña pasando valores a un formulario de entidad

Crea una nueva pestaña en la sesión enfocada pasando el nombre de la entidad y el nombre de la plantilla de la pestaña de la aplicación como parámetros. También rellena el formulario de entidad de destino con valores adicionales.

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

Crear una pestaña con un recurso web

Crea una nueva pestaña en la sesión enfocada pasando un recurso web como parámetro para la plantilla de pestaña de la aplicación.

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

Crear una pestaña con un recurso web pasando el parámetro de recurso web

Crea una nueva pestaña en la sesión enfocada pasando una plantilla de pestaña y un parámetro de recurso web como parámetros de plantilla de pestaña de aplicación.

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

Crear una pestaña con un recurso web que pase el nombre del recurso web y el parámetro del recurso web

Crea una nueva pestaña en la sesión enfocada pasando una plantilla de pestaña, un nombre de recurso web y un parámetro de recurso web como parámetros de plantilla de pestaña de aplicación.

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

Crear una pestaña con la página de control del marco de componentes de Power Apps

Crea una nueva pestaña en la sesión enfocada pasando un control de marco como parámetro para la plantilla de pestaña de la aplicación. El control se pasa desde la llamada 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
    });

También puede pasar los siguientes parámetros:

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