import * as React from 'react'; // Маршрутизация портала по параметрам URL. // // Раздел бокового меню — rpnav: 'new' (подать заявку, по умолчанию), // 'approvals' (ждут моего решения), 'own' (мои заявки), 'search' (поиск // сразу по обеим категориям — и по своим заявкам, и по тем, где участвовал). // Открытая заявка — переход по ссылке из потока Power Automate или клик по // строке таблицы: // …/СтраницаПортала.aspx?rpmode=approve&rptype=<форма>&rpid= // где rptype = ключ формы в реестре (forms/registry), rpid = RowID заявки в // списке данных. Заявка показывается в выезжающей панели ПОВЕРХ текущего // раздела, поэтому rpnav сохраняется вместе с rpmode. // // Префикс rp (request-portal): имена id/mode/type зарезервированы SharePoint // (напр. ?id= он трактует как навигацию к элементу → «Элемент не существует»), // поэтому используем собственные, неконфликтные имена параметров. // // Навигация внутри портала идёт через navigate() — это history.pushState без // перезагрузки страницы. useRoute() подписан и на popstate (кнопка «назад»), // и на её собственное событие, поэтому реагирует на оба способа смены URL. // 'edit' — открыть СВОЮ незавершённую заявку (черновик / возвращённую / // отклонённую) на редактирование в той же выезжающей панели, что и просмотр. export type PortalMode = 'submit' | 'approve' | 'create' | 'edit'; /** Раздел бокового меню. */ export type NavSection = 'new' | 'approvals' | 'own' | 'search'; export interface IRoute { mode: PortalMode; /** Раздел бокового меню; сохраняется и когда поверх открыта заявка. */ nav: NavSection; /** Ключ формы (тип заявки) — для 'approve', 'edit' и 'create'. */ formKey?: string; /** Id заявки в списке данных — для 'approve' и 'edit'. */ itemId?: number; /** Id исходной заявки для предзаполнения — для 'create' (напр. орг. места на основе прием). */ sourceId?: number; } const ROUTE_CHANGE_EVENT = 'rp-route-change'; function parseNav(raw: string | undefined): NavSection { if (raw === 'approvals' || raw === 'own' || raw === 'search') return raw; return 'new'; } /** Разобрать строку запроса (по умолчанию — из адреса страницы) в маршрут. */ export function parseRoute(search: string = window.location.search): IRoute { const params = new URLSearchParams(search); const mode = params.get('rpmode'); const nav = parseNav(params.get('rpnav') ?? undefined); const formKey = params.get('rptype') ?? undefined; const idRaw = params.get('rpid'); const itemId = idRaw ? Number(idRaw) : undefined; const sourceRaw = params.get('rpsource'); const sourceId = sourceRaw ? Number(sourceRaw) : undefined; // Открытая заявка (панель поверх раздела) — при полном наборе параметров. if (mode === 'approve' && formKey && itemId && !isNaN(itemId)) { return { mode: 'approve', nav, formKey, itemId }; } // Редактирование собственной незавершённой заявки — та же панель, но с формой. if (mode === 'edit' && formKey && itemId && !isNaN(itemId)) { return { mode: 'edit', nav, formKey, itemId }; } // Создание производной заявки с предзаполнением из исходной. if (formKey && sourceId && !isNaN(sourceId)) { return { mode: 'create', nav: 'new', formKey, sourceId }; } return { mode: 'submit', nav }; } // Собрать query-строку маршрута, сохранив посторонние параметры страницы. function buildQuery(route: IRoute): string { const params = new URLSearchParams(window.location.search); params.delete('rpmode'); params.delete('rpnav'); params.delete('rptype'); params.delete('rpid'); params.delete('rpsource'); if (route.nav !== 'new') { params.set('rpnav', route.nav); } if ((route.mode === 'approve' || route.mode === 'edit') && route.formKey && route.itemId) { params.set('rpmode', route.mode); params.set('rptype', route.formKey); params.set('rpid', String(route.itemId)); } else if (route.mode === 'create' && route.formKey && route.sourceId) { params.set('rptype', route.formKey); params.set('rpsource', String(route.sourceId)); } const query = params.toString(); return `${window.location.pathname}${query ? `?${query}` : ''}${window.location.hash}`; } /** * Перейти на другой маршрут без перезагрузки страницы (SPA): обновляет * query-параметры адресной строки через history.pushState и оповещает * useRoute() своим событием (popstate на pushState сам не срабатывает). */ export function navigate(route: IRoute): void { window.history.pushState({}, '', buildQuery(route)); window.dispatchEvent(new Event(ROUTE_CHANGE_EVENT)); } /** Ссылка на маршрут (для href — открытие в новой вкладке, копирование и т.п.). */ export function routeUrl(route: IRoute): string { return buildQuery(route); } /** Текущий маршрут, реактивно обновляется по navigate() и кнопке «назад». */ export function useRoute(): IRoute { const [route, setRoute] = React.useState(() => parseRoute()); React.useEffect(() => { const onChange = (): void => setRoute(parseRoute()); window.addEventListener('popstate', onChange); window.addEventListener(ROUTE_CHANGE_EVENT, onChange); return () => { window.removeEventListener('popstate', onChange); window.removeEventListener(ROUTE_CHANGE_EVENT, onChange); }; }, []); return route; }