Получение сервиса клиентского уровня

Сервисы представляют основной API взаимодействия с системой в части функциональности, не связанной с конкретными элементами управления. Они позволяют получить информацию о текущем контексте выполнения, выполнять запросы к серверу, показывать модальные окна, взаимодействовать с разметкой и использовать множество других функций системы.

Доступ к сервисам предоставляет функция getService разметки (тип Layout). Функция getService принимает тип сервиса, который нужно предоставить. Список сервисов клиентского уровня приведён в справочнике по JS API в разделе Services.

В Web-клиент версии 17 и выше функция getService есть у всех ЭУ. Рекомендуется получать сервис в ближайшем элементе управления.

Следующий код демонстрирует пример получения списка всех операций редактирования, зарегистрированных для карточки, с помощью сервиса $EditOperationStore.

export function onMyButtonClick(sender: CustomButton, e: IEventArgs) { (1)
    let editOperationStore = sender.getService($EditOperationStore); (2)

    let editOperations = editOperationStore.getAll(); (3)
}

1	Метод onMyButtonClick обрабатывает событие нажатия кнопки.
2	Получаем разметку layout из элемента, вызвавшего событие. С помощью метода getService получаем сервис $EditOperationStore.
3	Вызываем метод getAll сервиса для получения списка всех операций редактирования.