createTab (JavaScript API Reference) для Dynamics 365 Channel Integration Framework 2.0

Нотатка

Використовуйте цей API лише тоді, коли сфокусований сеанс належить провайдеру або якщо це домашній сеанс або сеанс за замовчуванням.

Створює вкладку у фокусованому сеансі та повертає унікальний ідентифікатор створеної вкладки.

Синтаксис

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

Параметри

Ім'я	Тип	Необхідний	Опис
Вводу	Рядок	Так	Вхід JSON
Зворотній дзвінок	Функція	Ні	Функція для виклику під час створення запису. У відповіді повертається унікальний ідентифікатор (ідентифікатор вкладки) створеної вкладки.
errorЗворотний дзвінок	Функція	Ні	Функція для виклику, коли операція не вдається. Буде передано об'єкт з наступними властивостями: errorCode: Число. Код помилки. повідомлення: Рядок. Повідомлення про помилку з описом проблеми.

Структура параметра input JSON виглядає наступним чином:

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

Значення, що повертається

Promise зі значенням ідентифікатора вкладки як String

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