Freigeben über


createTab (JavaScript-API-Referenz) für Dynamics 365 Channel Integration Framework 2.0

Hinweis

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

Die Parameter

Name Typ Erforderlich Beschreibung
Eingabe String Yes JSON-Eingabe
successCallback Funktion Nein Eine Funktion, die aufgerufen wird, wenn ein Datensatz erstellt wird. Die eindeutige Kennung (Registerkarten-ID) der erstellten Registerkarte wird in der Antwort zurückgegeben.
errorCallback Funktion Nein Eine Funktion zum Aufrufen, wenn der Vorgang fehlschlug. Ein Objekt mit den folgenden Eigenschaften wird übergeben:
errorCode: Zahl. Der Fehlercode.
message: Zeichenfolge. Eine Fehlermeldung, in der das Problem beschrieben wird.

Der Aufbau des input Parameters JSON ist wie folgt:

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

Rückgabewert

Promise mit dem Wert der Registerkarten-ID als Zeichenfolge

Example

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