createTab (gestionnaire de profils d’application)

Crée un onglet d’application dans une session ciblée et renvoie l’identificateur unique de l’onglet.

Syntaxe

Microsoft.Apm.createTab(AppTabInput);

Paramètres

La structure du paramètre JSON AppTabInput est la suivante :

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

Valeur retournée

Identificateur de tabulation sous forme de chaîne.

Examples

Ces exemples utilisent la createTab méthode de lancement d’un nouvel onglet.

Créer un onglet de base

Crée un nouvel onglet dans la session ciblée, en transmettant le nom de l’entité, l’ID d’enregistrement et le nom du modèle d’onglet d’application en tant que paramètres.

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

Créer un onglet en passant des valeurs à un formulaire d’entité

Crée un nouvel onglet dans la session ciblée en transmettant le nom de l’entité et le nom du modèle d’onglet de l’application en tant que paramètres. Il remplit également le formulaire d’entité cible avec des valeurs supplémentaires.

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

Créer un onglet avec une ressource web

Crée un nouvel onglet dans la session ciblée en transmettant une ressource Web en tant que paramètre pour le modèle d’onglet d’application.

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

Créer un onglet avec un paramètre de ressource web transmettant une ressource web

Crée un nouvel onglet dans la session prioritaire en transmettant un modèle d’onglet et un paramètre de ressource Web en tant que paramètres de modèle d’onglet d’application.

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

Créer un onglet avec une ressource Web transmettant le nom de la ressource Web et le paramètre de ressource Web

Crée un nouvel onglet dans la session ciblée en transmettant un modèle d’onglet, un nom de ressource Web et un paramètre de ressource Web en tant que paramètres de modèle d’onglet d’application.

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

Créer un onglet avec la page de contrôle de l’infrastructure du composant Power Apps

Crée un nouvel onglet dans la session ciblée en passant un contrôle d’infrastructure en tant que paramètre pour le modèle d’onglet d’application. Le contrôle est transmis à partir de l’appel d’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
    });

Vous pouvez également passer les paramètres suivants :

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