Получение контекста объектов в серверном расширении
Программист может использовать в серверном расширении контекст объектов Docsvision для доступа к данным системы.
Разработчику доступен пользовательский контекст объектов. Пользовательский контекст создаётся для каждого пользователя при его входе в Web-клиент. Права на работу с объектами соответствуют правам данного пользователя в системе Docsvision.
Сервис ICurrentObjectContextProvider предоставляет методы для получения контекста объектов. ICurrentObjectContextProvider может быть получен следующим способом:
private readonly ICurrentObjectContextProvider _currentObjectContextProvider;
public DocumentRegistrationController(ICurrentObjectContextProvider currentObjectContextProvider)
{
_currentObjectContextProvider = currentObjectContextProvider;
}
Получить контекст объектов можно используя следующие функции сервиса ICurrentObjectContextProvider.
-
GetOrCreateCurrentSessionContext— возвращает контекст объектов текущего пользователя. -
GetOrCreateExclusivePoolSessionContext— возвращает контекст объектов из отдельного пула сессий Web-клиента.
Web-клиент периодически закрывает неиспользуемые пользовательские сессии, из-за чего контекст объектов, сохранённый в статический объект класса (серверного расширения или контроллера), спустя время станет недействительным. Всегда получайте контекст объектов заново (с помощью функции GetOrCreateCurrentSessionContext).
Примеры работы с контекстом объектов рассмотрены в Руководстве разработчика. Следующий код демонстрирует пример получения объектной модели карточки Документ.
Document document = objectContext.GetObject<Document>(Guid.Parse("9E11083F-D0EC-4F9F-8981-285498280BD9")); (1)
| 1 | В метод GetObject передаются тип объекта (Document) и идентификатор объекта (ID карточки). |
Не используйте метод GetOrCreateApplicationPoolSessionContext, это приведет к блокировкам потоков под нагрузкой.
|
После использования полученный через GetOrCreateExclusivePoolSessionContext контекст необходимо освобождать, т.к. он арендует сессию из отдельного пула сессий Web-клиента. После завершения работы сессия должна быть возвращена обратно в пул.
Количество одновременно арендованных сессий ограничено пятью. Если полученные контексты не освобождать, новые запросы сессии могут завершиться ошибкой из-за исчерпания лимита.
using (var pooledSessionContext = currentObjectContextProvider.GetOrCreateExclusivePoolSessionContext())
{
var sessionContext = pooledSessionContext.Context; (1)
}
| 1 | Работа с SessionContext. |