Partage via


createTab (Référence API JavaScript) pour l'environnement d'intégration du canal de Dynamics 365 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 Requis Description
entrée String Oui Saisie d’JSON
successCallback Function No Fonction à appeler lorsqu’un enregistrement est créé. L’identifiant unique (ID de l’onglet) de l’onglet créé est renvoyé dans la réponse.
errorCallback Function No Fonction à appeler lorsque l’opération échoue. Un objet avec les propriétés suivantes est transmis :
errorCode : Numéro. Code d’erreur.
message : Chaîne. Message d’erreur décrivant le problème.

La structure du paramètre input 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 renvoyée

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

Exemple

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