createTab (App-Profil-Manager)

Erstellt eine App-Registerkarte in einer fokussierten Sitzung und gibt den eindeutigen Bezeichner der Registerkarte zurück.

Syntax

Microsoft.Apm.createTab(AppTabInput);

Die Parameter

Die Struktur des JSON-Parameters AppTabInput sieht wie folgt aus:

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

Rückgabewert

Tabulatorkennung als Zeichenfolge.

Examples

In diesen Beispielen wird die createTab Methode verwendet, um eine neue Registerkarte zu starten.

Erstellen einer einfachen Registerkarte

Erstellt eine neue Registerkarte in der fokussierten Sitzung, wobei der Entitätsname, die recordId und der Name der App-Registerkartenvorlage als Parameter übergeben werden.

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

Erstellen einer Registerkarte zum Übergeben von Werten an ein Entitätsformular

Erstellt eine neue Registerkarte in der fokussierten Sitzung und übergibt den Entitätsnamen und den Namen der App-Registerkartenvorlage als Parameter. Außerdem wird das Zielentitätsformular mit zusätzlichen Werten aufgefüllt.

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

Erstellen einer Registerkarte mit einer Webressource

Erstellt eine neue Registerkarte in der fokussierten Sitzung und übergibt eine Webressource als Parameter für die App-Registerkartenvorlage.

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

Erstellen einer Registerkarte mit einer Webressource, die einen Webressourcenparameter übergibt

Erstellt eine neue Registerkarte in der fokussierten Sitzung und übergibt eine Registerkartenvorlage und einen Webressourcenparameter als Parameter für App-Registerkartenvorlagen.

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

Erstellen einer Registerkarte mit einer Webressource, die den Namen der Webressource und den Webressourcenparameter übergibt

Erstellt eine neue Registerkarte in der fokussierten Sitzung und übergibt eine Registerkartenvorlage, den Namen der Webressource und den Webressourcenparameter als Parameter für App-Registerkartenvorlagen.

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

Erstellen einer Registerkarte mit der Steuerungsseite des Power Apps-Komponentenframeworks

Erstellt eine neue Registerkarte in der fokussierten Sitzung, die ein Framework-Steuerelement als Parameter für die App-Registerkartenvorlage übergibt. Das Steuerelement wird vom API-Aufruf übergeben.

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

Sie können auch die folgenden Parameter übergeben:

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