Partager via


createTab (référence de l’API JavaScript) pour Dynamics 365 Channel Integration Framework 2.0

Note

Utilisez cette API uniquement lorsque la session ciblée appartient au fournisseur ou s’il s’agit de la session principale ou par défaut.

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

Syntaxe

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

Paramètres

Nom Type Obligatoire Description
entrée Chaîne Oui Entrée JSON
successCallback Fonction Non Fonction à appeler lorsqu’un enregistrement est créé. L’identificateur unique (ID d’onglet) de l’onglet créé est renvoyé dans la réponse.
errorCallback Fonction Non Fonction à appeler lorsque l’opération échoue. Un objet avec les propriétés suivantes sera passé :
errorCode : Numéro. Code d'erreur.
message : Chaîne. Un message d’erreur décrivant le problème.

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

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

Valeur retournée

Promesse avec la valeur de l’ID de l’onglet sous forme de chaîne

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