createTab (JavaScript API-Referenz) für Dynamics 365-Kanalintegrationsframework 2.0

Anmerkung

Verwenden Sie diese API nur, wenn die fokussierte Sitzung zum Anbieter gehört oder wenn es sich um die Home- oder Standardsitzung handelt.

Erstellt eine Registerkarte in einer fokussierten Sitzung und gibt die eindeutige Kennung der erstellten Registerkarte zurück.

Syntax

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

Parameter

Name des Dataflows	Art	Erforderlich	Beschreibung des Dataflows
Eingabe	Zeichenfolge	Ja	JSON-Eingabe
successCallback	Funktion	Nein	Eine Funktion zum Aufrufen, wenn ein Datensatz erstellt wird. In der Antwort wird eine eindeutige Kennung (Tab-ID) des erstellten Tabs zurückgegeben.
errorCallback	Funktion	Nein	Eine Funktion zum Aufrufen, wenn der Vorgang fehlschlug. Es wird ein Objekt mit den folgenden Eigenschaften übergeben: ErrorCode: Zahl. Der Fehlercode. message: Zeichenfolge. Eine Fehlermeldung, die das Problem beschreibt.

Der input JSON-Parameter hat die folgende Struktur:

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

Zurückgegebener Wert

Promise mit dem Wert der Registerkarten-ID als Zeichenfolge

Beispiel

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