diff --git a/README.md b/README.md index 3f0f232..0a2bb29 100644 --- a/README.md +++ b/README.md @@ -225,6 +225,44 @@ WEB-приложение "ПАРУС 8 Онлайн" поддерживает в ``` +### Интеграция в разделы - вызов из действия + +Панель может быть вызвана из действия раздела Системы (только для WEB-клиента). Для это необходимо зарегистрировать в разделе метод с кодом "P8PANELS_OPEN", при этом метод обязательно должен иметь "Тип метода" - "Встроенный", а "Доступность" - "Клиентский". Для метода необходимо настроить параметры: + +- `SPANEL` - строка, обязательный, уникальное имя (`name`) той панели из "p8panels.config", которая должна быть открыта действием +- `SCAPTION` - строка, необязательный, заголовок вкладки WEB-приложения "ПАРУС 8 Онлайн", в которой будет открыта панель, если не задан - будет использовано видимое наименование панели (`caption`) из "p8panels.config" +- `NIDENT` - число, необязательный, но требуется если предполагается, что панель должна работать со списком отмеченных документов, параметр следует привязать к контексту "Идентификатор отмеченных записей" + +Указанные параметры - зарезервированы и могут выполнять только указанную функцию. Тем не менее, метод может иметь произвольный набор прочих параметров, необходимых для работы панели. Все параметры (кроме `SPANEL` и `SCAPTION` - они системные и требуется непосредственно для корректного откытия панели, но не для её работы) будут переданы в панель в виде GET-запроса. Получить их значения в коде панели можно применив специальный API фреймворка, реализованный в `NavigationCtx`: + +``` +import { NavigationCtx } from "../../context/navigation"; //Контекст навигации + +const MyPanel = () => { + //Подключение к контексту навигации + const { getNavigationSearch } = useContext(NavigationCtx); + + //Считаем параметры, переданные из действия + const actionPrms = getNavigationSearch(); + + return ( +