createTab (Referencia de API JavaScript) para Marco de integración de canal de Dynamics 365 2.0

Nota

Utilice esta API solo cuando la sesión enfocada pertenezca al proveedor o si es la sesión principal o predeterminada.

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

Sintaxis

Microsoft.CIFramework.createTab(input, correlationId).then(successCallback, errorCallback);

Parámetros

Asignar nombre	Type	Necesario	Descripción
entrada	String	Sí	Entrada de JSON
successCallback	Function	No	Una función para llamar cuando se crea un registro. En la respuesta se devuelve el identificador único (Id. de pestaña) de la pestaña creada.
errorCallback	Function	No	Una función a la que se llama cuando la operación tiene error. Se pasará un objeto con las siguientes propiedades: errorCode: Número. Código de error. message: Cadena. Un mensaje de error que describe el problema.

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

{
    //Unique name of the tab 
    // type = string
    templateName: <unique name of the tab template>;

    //additional context for tab creation and tab slugs
    // type = JSON Object
    templateParameters?:<>
    
    //should this tab be focused after the creation
    // type=boolean
    isFocused?: <true or false>;
}

Valor de retorno

Promise con un valor del Id. de pestaña como cadena

Ejemplo

var tabInput = {
    //Unique Name of the Application Tab Template
    // type = string
    templateName: "msdyn_test_entity",
    templateParameters: {
    entityName: "incident",
    data: "{}",
    },
    isFocused: true
};
Microsoft.CIFramework.createTab(tabInput).then((tabId)=>{
    console.log("created tab with id" + tabId);
}, (error)=>{
    console.log(error);
});