This commit is contained in:
@@ -15,6 +15,7 @@ export const REQUEST_TYPES: IRequestType[] = [
|
|||||||
|
|
||||||
// Отдел кадров
|
// Отдел кадров
|
||||||
{ id: 'hr-vacation', categoryId: 'hr', title: 'Заявка на отпуск', icon: 'calendar' },
|
{ id: 'hr-vacation', categoryId: 'hr', title: 'Заявка на отпуск', icon: 'calendar' },
|
||||||
|
{ id: 'hr-unpaid-leave', categoryId: 'hr', title: 'Отпуск без содержания', icon: 'calendar' },
|
||||||
{ id: 'clearance-form', categoryId: 'hr', title: 'Обходной лист', icon: 'clipboard' },
|
{ id: 'clearance-form', categoryId: 'hr', title: 'Обходной лист', icon: 'clipboard' },
|
||||||
{ id: 'hr-transfer', categoryId: 'hr', title: 'на перемещение сотрудников', icon: 'send' },
|
{ id: 'hr-transfer', categoryId: 'hr', title: 'на перемещение сотрудников', icon: 'send' },
|
||||||
|
|
||||||
|
|||||||
@@ -0,0 +1,37 @@
|
|||||||
|
# Отпуск без содержания (hr-unpaid-leave)
|
||||||
|
|
||||||
|
**Назначение:** заявление сотрудника на отпуск без сохранения заработной платы.
|
||||||
|
**Категория:** Отдел кадров
|
||||||
|
**Списки SP:** «Отпуск без содержания — данные» / «Отпуск без содержания — согласование»
|
||||||
|
**RequestTypeId (внешний API маршрутов):** _плейсхолдер_ — получит новый числовой id
|
||||||
|
при заведении типа в админке approval-route (как `hr-vacation` получил 11).
|
||||||
|
|
||||||
|
## Маршрут
|
||||||
|
- Тип заявки в approval-route API (`/api/request-types`): `pageUrl` «hr-unpaid-leave».
|
||||||
|
- Фазы: только согласование. Фазы исполнения нет — после согласования заявка
|
||||||
|
получает статус «Согласовано» (без Planner).
|
||||||
|
- **Матрица редактируема заявителем** при новой заявке / черновике / возврате
|
||||||
|
(как Vacation / RecruitingHire): `useMatrixEditor(editable = !readOnly)`.
|
||||||
|
|
||||||
|
## Особое поведение
|
||||||
|
- **Заявку можно подать за другого сотрудника.** Поле «Сотрудник» — People-picker
|
||||||
|
(`Employee`). Планируемый маршрут резолвится по e-mail **выбранного** сотрудника
|
||||||
|
(`getPlannedMatrix(..., data.Employee, ...)`), reloadKey матрицы включает `data.Employee`.
|
||||||
|
- **Автоподстановка должности** из профиля (`SPS-JobTitle` через `approval.getJobTitle`) —
|
||||||
|
для текущего пользователя при создании и при выборе другого сотрудника.
|
||||||
|
- **Период вводится двумя датами** (с / по), обе обязательны, конец ≥ начала.
|
||||||
|
`DaysCount` считается при сохранении (включительно) для отчётности — в UI не показывается.
|
||||||
|
- **Замещающий** (`Substitute`, People) — необязателен.
|
||||||
|
- **Заголовок элемента** (`Title`): `Отпуск без содержания — {ФИО} — дд.мм.гггг`.
|
||||||
|
|
||||||
|
## Отличия от «Заявка на отпуск» (hr-vacation)
|
||||||
|
- Даты с/по вместо «дата начала + количество дней».
|
||||||
|
- Добавлены поля «В связи с» (`Reason`) и «Лицо замещающее» (`Substitute`).
|
||||||
|
|
||||||
|
## Секции формы
|
||||||
|
RequestSection (сотрудник · должность · дата начала · дата окончания · основание · замещающий)
|
||||||
|
|
||||||
|
## Точки входа
|
||||||
|
- rptype: `hr-unpaid-leave`
|
||||||
|
- Режим согласующего (просмотр): есть (`UnpaidLeaveView`)
|
||||||
|
- «Создать на основе»: нет
|
||||||
@@ -0,0 +1,20 @@
|
|||||||
|
@import '../../../../styles/design-tokens';
|
||||||
|
|
||||||
|
.back {
|
||||||
|
display: inline-flex;
|
||||||
|
align-items: center;
|
||||||
|
gap: $sp-2;
|
||||||
|
margin-bottom: $sp-4;
|
||||||
|
padding: 0;
|
||||||
|
border: 0;
|
||||||
|
background: transparent;
|
||||||
|
color: $navy-700;
|
||||||
|
font-family: $font-sans;
|
||||||
|
font-size: $fs-sm;
|
||||||
|
cursor: pointer;
|
||||||
|
transition: color .18s;
|
||||||
|
|
||||||
|
&:hover {
|
||||||
|
color: $gold-600;
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,250 @@
|
|||||||
|
import * as React from 'react';
|
||||||
|
import { useState, useMemo, useCallback, useEffect } from 'react';
|
||||||
|
import styles from './UnpaidLeaveForm.module.scss';
|
||||||
|
import {
|
||||||
|
Alert,
|
||||||
|
FormCard,
|
||||||
|
InitiatorLine,
|
||||||
|
FormModeProvider,
|
||||||
|
Icon,
|
||||||
|
RequestNumber,
|
||||||
|
SubmitActions,
|
||||||
|
useRequestSubmit
|
||||||
|
} from '../../shared/ui';
|
||||||
|
import {
|
||||||
|
ApprovalMatrix,
|
||||||
|
StatusBadge,
|
||||||
|
useMatrixEditor,
|
||||||
|
getPlannedMatrix,
|
||||||
|
notifyActiveStep,
|
||||||
|
useRequestTypeId,
|
||||||
|
REQUEST_STATUS,
|
||||||
|
isEditableStatus,
|
||||||
|
IApproverToWrite,
|
||||||
|
findUnassignedStep
|
||||||
|
} from '../../shared/approval';
|
||||||
|
import { IRequestFormProps } from '../../models/types';
|
||||||
|
import { approvalListTitle, dataListTitle } from '../../shared/listTitles';
|
||||||
|
import { FORM_ID, IFormData, EMPTY_DATA, SetField } from './model';
|
||||||
|
import { saveUnpaidLeaveRequest, unpaidLeaveApprovalService } from './submit';
|
||||||
|
import { loadUnpaidLeaveRequest } from './load';
|
||||||
|
import { RequestSection } from './sections/RequestSection';
|
||||||
|
|
||||||
|
const UnpaidLeaveForm: React.FC<IRequestFormProps> = ({ requestType, context, onCancel, onSaved, editId }) => {
|
||||||
|
const [data, setData] = useState<IFormData>(EMPTY_DATA);
|
||||||
|
const [requestId, setRequestId] = useState<number | undefined>(editId);
|
||||||
|
const [requestStatus, setRequestStatus] = useState<string | undefined>(undefined);
|
||||||
|
const [requestCode, setRequestCode] = useState<string | undefined>(undefined);
|
||||||
|
const submit = useRequestSubmit();
|
||||||
|
|
||||||
|
const readOnly = !isEditableStatus(requestStatus);
|
||||||
|
const set: SetField = (key, value) => setData((prev) => ({ ...prev, [key]: value }));
|
||||||
|
|
||||||
|
const approval = useMemo(() => unpaidLeaveApprovalService(), []);
|
||||||
|
// pageUrl формы (requestType.id совпадает с ним по конвенции портала, см.
|
||||||
|
// data/requests.ts) → числовой RequestTypeId, нужный approval-route API.
|
||||||
|
const requestTypeIdState = useRequestTypeId(context, requestType.id);
|
||||||
|
const requestTypeId = requestTypeIdState.id;
|
||||||
|
|
||||||
|
// Открыта СВОЯ заявка на редактирование (черновик/возврат) — подгружаем содержимое и статус.
|
||||||
|
useEffect(() => {
|
||||||
|
if (!editId) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
let alive = true;
|
||||||
|
loadUnpaidLeaveRequest(editId)
|
||||||
|
.then((loaded) => {
|
||||||
|
if (alive) {
|
||||||
|
setData(loaded.data);
|
||||||
|
setRequestStatus(loaded.status);
|
||||||
|
setRequestCode(loaded.code || undefined);
|
||||||
|
}
|
||||||
|
})
|
||||||
|
.catch((e) => {
|
||||||
|
if (alive) {
|
||||||
|
submit.setError(`Не удалось загрузить заявку №${editId}: ${(e as Error).message}`);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
return () => {
|
||||||
|
alive = false;
|
||||||
|
};
|
||||||
|
// eslint-disable-next-line react-hooks/exhaustive-deps
|
||||||
|
}, [editId]);
|
||||||
|
|
||||||
|
// Новая заявка — по умолчанию на себя: подставляем текущего пользователя и его должность.
|
||||||
|
useEffect(() => {
|
||||||
|
if (editId) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
let alive = true;
|
||||||
|
const user = context.pageContext.user;
|
||||||
|
setData((prev) => ({ ...prev, Employee: prev.Employee || user.email }));
|
||||||
|
approval
|
||||||
|
.getJobTitle(user.loginName)
|
||||||
|
.then((title) => {
|
||||||
|
if (alive && title) {
|
||||||
|
setData((prev) => ({ ...prev, Position: prev.Position || title }));
|
||||||
|
}
|
||||||
|
})
|
||||||
|
.catch(() => undefined);
|
||||||
|
return () => {
|
||||||
|
alive = false;
|
||||||
|
};
|
||||||
|
// eslint-disable-next-line react-hooks/exhaustive-deps
|
||||||
|
}, [editId]);
|
||||||
|
|
||||||
|
// Выбор другого сотрудника подтягивает его должность.
|
||||||
|
const handleEmployeeChange = (login: string): void => {
|
||||||
|
setData((prev) => ({ ...prev, Employee: login }));
|
||||||
|
if (!login) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
approval
|
||||||
|
.getJobTitle(login)
|
||||||
|
.then((title) => setData((prev) => ({ ...prev, Position: title || prev.Position })))
|
||||||
|
.catch(() => undefined);
|
||||||
|
};
|
||||||
|
|
||||||
|
// Планируемый маршрут резолвится по e-mail ВЫБРАННОГО сотрудника (не текущего
|
||||||
|
// пользователя) — так работает подача за другого. У заявки на редактировании
|
||||||
|
// маршрут читается из уже записанных строк, чтобы не затереть правки инициатора.
|
||||||
|
const loadMatrix = useCallback(
|
||||||
|
() =>
|
||||||
|
editId
|
||||||
|
? approval.getMatrixForRequest(editId)
|
||||||
|
: getPlannedMatrix(context, requestTypeId as number, data.Employee, approval, 'Approval'),
|
||||||
|
[context, approval, editId, data.Employee, requestTypeId]
|
||||||
|
);
|
||||||
|
const matrix = useMatrixEditor(
|
||||||
|
loadMatrix,
|
||||||
|
`${data.Employee}-${editId ?? 'new'}`,
|
||||||
|
!readOnly,
|
||||||
|
!!editId || (!!data.Employee && !!requestTypeId),
|
||||||
|
(login) => approval.getJobTitle(login)
|
||||||
|
);
|
||||||
|
|
||||||
|
// Даты корректны, если конец не раньше начала (обе обязательны).
|
||||||
|
const datesValid = !!(data.StartDate && data.EndDate && data.EndDate >= data.StartDate);
|
||||||
|
const isValid = !!(
|
||||||
|
data.Employee &&
|
||||||
|
data.Position.trim() &&
|
||||||
|
datesValid &&
|
||||||
|
data.Reason.trim()
|
||||||
|
);
|
||||||
|
const validate = (): string | undefined => {
|
||||||
|
if (!data.Employee || !data.Position.trim() || !data.StartDate || !data.EndDate || !data.Reason.trim()) {
|
||||||
|
return 'Заполните обязательные поля: сотрудник, должность, дата начала, дата окончания, основание.';
|
||||||
|
}
|
||||||
|
if (!datesValid) return 'Дата окончания не может быть раньше даты начала.';
|
||||||
|
if (requestTypeIdState.error) return `Не удалось определить тип заявки: ${requestTypeIdState.error}`;
|
||||||
|
if (!requestTypeId) return 'Тип заявки ещё определяется — подождите немного и повторите.';
|
||||||
|
return undefined;
|
||||||
|
};
|
||||||
|
|
||||||
|
const toApprovers = (rows: typeof matrix.rows): IApproverToWrite[] =>
|
||||||
|
rows.map((r) => ({
|
||||||
|
email: r.email,
|
||||||
|
position: r.position,
|
||||||
|
allowReassign: r.allowReassign,
|
||||||
|
order: r.order,
|
||||||
|
// Транзитом из маршрута в строку списка: наследование бэкенд применил
|
||||||
|
// при resolve, форма только переносит значения (см. IMatrixRow.slaHours).
|
||||||
|
slaHours: r.slaHours,
|
||||||
|
askOverdueReason: r.askOverdueReason
|
||||||
|
}));
|
||||||
|
|
||||||
|
const save = (status: string): (() => Promise<void>) => async (): Promise<void> => {
|
||||||
|
// validate()/validateSubmit() уже гарантировали requestTypeId к моменту вызова
|
||||||
|
// (см. useRequestSubmit.run — валидирует ДО save), но TS этого через границу
|
||||||
|
// замыкания не видит — локальный const и явная проверка снимают both проблемы.
|
||||||
|
const rtId = requestTypeId;
|
||||||
|
if (!rtId) {
|
||||||
|
throw new Error('Тип заявки не определён — обновите страницу и повторите.');
|
||||||
|
}
|
||||||
|
const { id, code } = await saveUnpaidLeaveRequest(requestId, rtId, data, toApprovers(matrix.rows), status);
|
||||||
|
setRequestId(id);
|
||||||
|
setRequestStatus(status);
|
||||||
|
if (code) {
|
||||||
|
setRequestCode(code);
|
||||||
|
}
|
||||||
|
if (onSaved) {
|
||||||
|
onSaved();
|
||||||
|
}
|
||||||
|
// Отправка на согласование — уведомляем первый активный шаг (поток оповещения).
|
||||||
|
if (status === REQUEST_STATUS.onApproval) {
|
||||||
|
await notifyActiveStep(context, approval, id, {
|
||||||
|
requestTypeId: rtId,
|
||||||
|
dataListName: dataListTitle(FORM_ID),
|
||||||
|
approvalListName: approvalListTitle(FORM_ID)
|
||||||
|
});
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
// На отправку (в отличие от черновика) маршрут должен быть полностью
|
||||||
|
// укомплектован — иначе шаг без назначенного человека молча пропадёт при записи.
|
||||||
|
const validateSubmit = (): string | undefined => {
|
||||||
|
const formError = validate();
|
||||||
|
if (formError) return formError;
|
||||||
|
if (matrix.error) {
|
||||||
|
return `Не удалось определить маршрут согласования: ${matrix.error}. Попробуйте ещё раз или обратитесь к администратору.`;
|
||||||
|
}
|
||||||
|
const unassigned = findUnassignedStep(matrix.rows);
|
||||||
|
if (unassigned) {
|
||||||
|
return `Шаг ${unassigned.order} маршрута согласования («${unassigned.position || 'без должности'}») без назначенного человека — выберите согласующего или удалите шаг.`;
|
||||||
|
}
|
||||||
|
return undefined;
|
||||||
|
};
|
||||||
|
|
||||||
|
const handleSaveDraft = (): Promise<void> => submit.run('draft', save(REQUEST_STATUS.draft), validate);
|
||||||
|
const handleSubmit = (): Promise<void> => submit.run('submit', save(REQUEST_STATUS.onApproval), validateSubmit);
|
||||||
|
|
||||||
|
const sectionProps = { data, set, context, onEmployeeChange: handleEmployeeChange };
|
||||||
|
|
||||||
|
return (
|
||||||
|
<div>
|
||||||
|
<button type="button" className={styles.back} onClick={onCancel}>
|
||||||
|
<Icon name="arrow-left" size="sm" />
|
||||||
|
<span>К списку заявок</span>
|
||||||
|
</button>
|
||||||
|
|
||||||
|
<FormCard
|
||||||
|
title={requestType.title}
|
||||||
|
subtitle="Категория: Отдел кадров"
|
||||||
|
belowSubtitle={<InitiatorLine listTitle={dataListTitle(FORM_ID)} itemId={requestId} />}
|
||||||
|
headerRight={
|
||||||
|
requestId || requestStatus ? (
|
||||||
|
<>
|
||||||
|
{requestStatus && <StatusBadge status={requestStatus} />}
|
||||||
|
{requestCode && <RequestNumber code={requestCode} />}
|
||||||
|
</>
|
||||||
|
) : undefined
|
||||||
|
}
|
||||||
|
>
|
||||||
|
{submit.savedKind && !submit.error && (
|
||||||
|
<Alert variant="ok">
|
||||||
|
{submit.savedKind === 'draft' ? 'Черновик сохранён.' : 'Заявка отправлена на согласование.'}
|
||||||
|
</Alert>
|
||||||
|
)}
|
||||||
|
{submit.error && <Alert variant="err">{submit.error}</Alert>}
|
||||||
|
|
||||||
|
<FormModeProvider readOnly={readOnly}>
|
||||||
|
<RequestSection {...sectionProps} />
|
||||||
|
</FormModeProvider>
|
||||||
|
|
||||||
|
<ApprovalMatrix editor={matrix} search={(q) => approval.searchUsers(q)} />
|
||||||
|
|
||||||
|
<SubmitActions
|
||||||
|
submit={submit}
|
||||||
|
isValid={isValid}
|
||||||
|
readOnly={readOnly}
|
||||||
|
onCancel={onCancel}
|
||||||
|
onSaveDraft={handleSaveDraft}
|
||||||
|
onSubmit={handleSubmit}
|
||||||
|
submitLabel="Отправить на согласование"
|
||||||
|
/>
|
||||||
|
</FormCard>
|
||||||
|
</div>
|
||||||
|
);
|
||||||
|
};
|
||||||
|
|
||||||
|
export default UnpaidLeaveForm;
|
||||||
@@ -0,0 +1,14 @@
|
|||||||
|
@import '../../../../styles/design-tokens';
|
||||||
|
|
||||||
|
.state {
|
||||||
|
padding: $sp-8;
|
||||||
|
color: $gray-500;
|
||||||
|
font-size: $fs-sm;
|
||||||
|
text-align: center;
|
||||||
|
}
|
||||||
|
|
||||||
|
.toolbar {
|
||||||
|
display: flex;
|
||||||
|
justify-content: flex-end;
|
||||||
|
margin-bottom: $sp-4;
|
||||||
|
}
|
||||||
@@ -0,0 +1,144 @@
|
|||||||
|
import * as React from 'react';
|
||||||
|
import { useState, useEffect, useMemo, useCallback } from 'react';
|
||||||
|
import type { WebPartContext } from '@microsoft/sp-webpart-base';
|
||||||
|
import styles from './UnpaidLeaveView.module.scss';
|
||||||
|
import { Alert, FormCard, InitiatorLine, FormModeProvider, PrintButton } from '../../shared/ui';
|
||||||
|
import {
|
||||||
|
ApproverService,
|
||||||
|
DecisionPanel,
|
||||||
|
StatusBadge,
|
||||||
|
ApprovalMatrix,
|
||||||
|
useMatrixEditor,
|
||||||
|
notifyActiveStep,
|
||||||
|
useRequestTypeId
|
||||||
|
} from '../../shared/approval';
|
||||||
|
import { approvalListTitle, dataListTitle } from '../../shared/listTitles';
|
||||||
|
import { FORM_ID, IFormData, EMPTY_DATA, SetField } from './model';
|
||||||
|
import { loadUnpaidLeaveRequest } from './load';
|
||||||
|
import { unpaidLeaveApprovalService } from './submit';
|
||||||
|
import { RequestSection } from './sections/RequestSection';
|
||||||
|
|
||||||
|
interface IUnpaidLeaveViewProps {
|
||||||
|
context: WebPartContext;
|
||||||
|
itemId: number;
|
||||||
|
/** pageUrl формы — см. IApprovalViewProps в forms/viewRegistry.ts. */
|
||||||
|
formKey: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
// В режиме чтения поля не редактируются, поэтому обновление — пустышка.
|
||||||
|
const NOOP_SET: SetField = () => undefined;
|
||||||
|
|
||||||
|
// Заявка без содержания только для просмотра (режим согласующего). Переиспользует
|
||||||
|
// ту же секцию, что и форма подачи; редактирование выключено через
|
||||||
|
// <FormModeProvider readOnly> — поля сами становятся неизменяемыми.
|
||||||
|
const UnpaidLeaveView: React.FC<IUnpaidLeaveViewProps> = ({ context, itemId, formKey }) => {
|
||||||
|
const [data, setData] = useState<IFormData>(EMPTY_DATA);
|
||||||
|
const [status, setStatus] = useState<string>('');
|
||||||
|
const [code, setCode] = useState<string>('');
|
||||||
|
const [loading, setLoading] = useState<boolean>(true);
|
||||||
|
const [error, setError] = useState<string | null>(null);
|
||||||
|
|
||||||
|
const approval = useMemo(() => unpaidLeaveApprovalService(), []);
|
||||||
|
const { id: requestTypeId } = useRequestTypeId(context, formKey);
|
||||||
|
const approverService = useMemo(() => new ApproverService(approval, dataListTitle(FORM_ID)), [approval]);
|
||||||
|
|
||||||
|
// Матрица маршрута из фактических строк заявки (read-only). decisionSeq в
|
||||||
|
// reloadKey: после решения строки на сервере меняются — перечитываем матрицу.
|
||||||
|
const [decisionSeq, setDecisionSeq] = useState<number>(0);
|
||||||
|
const loadApprovers = useCallback(() => approval.getMatrixForRequest(itemId), [approval, itemId]);
|
||||||
|
const approvers = useMatrixEditor(loadApprovers, `a-${itemId}-${decisionSeq}`, false, true, (l) =>
|
||||||
|
approval.getJobTitle(l)
|
||||||
|
);
|
||||||
|
|
||||||
|
useEffect(() => {
|
||||||
|
let alive = true;
|
||||||
|
setLoading(true);
|
||||||
|
loadUnpaidLeaveRequest(itemId)
|
||||||
|
.then((loaded) => {
|
||||||
|
if (alive) {
|
||||||
|
setData(loaded.data);
|
||||||
|
setStatus(loaded.status);
|
||||||
|
setCode(loaded.code);
|
||||||
|
setError(null);
|
||||||
|
setLoading(false);
|
||||||
|
}
|
||||||
|
})
|
||||||
|
.catch((e) => {
|
||||||
|
if (alive) {
|
||||||
|
setError(`Не удалось загрузить заявку №${itemId}: ${(e as Error).message}`);
|
||||||
|
setLoading(false);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
return () => {
|
||||||
|
alive = false;
|
||||||
|
};
|
||||||
|
}, [itemId]);
|
||||||
|
|
||||||
|
if (loading) {
|
||||||
|
return <div className={styles.state}>Загрузка заявки…</div>;
|
||||||
|
}
|
||||||
|
if (error) {
|
||||||
|
return (
|
||||||
|
<div className={styles.state}>
|
||||||
|
<Alert variant="err">{error}</Alert>
|
||||||
|
</div>
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
const sectionProps = { data, set: NOOP_SET, context };
|
||||||
|
|
||||||
|
const notify = (): void => {
|
||||||
|
// requestTypeId ещё не резолвился — решение уже применилось (строка списка
|
||||||
|
// обновлена), просто нечего уведомлять на следующем шаге; не проваливаем
|
||||||
|
// весь UI ради необязательного оповещения.
|
||||||
|
if (!requestTypeId) return;
|
||||||
|
notifyActiveStep(context, approval, itemId, {
|
||||||
|
requestTypeId,
|
||||||
|
dataListName: dataListTitle(FORM_ID),
|
||||||
|
approvalListName: approvalListTitle(FORM_ID)
|
||||||
|
}).catch(() => undefined);
|
||||||
|
};
|
||||||
|
|
||||||
|
return (
|
||||||
|
<div>
|
||||||
|
<div className={`${styles.toolbar} rp-no-print`}>
|
||||||
|
<PrintButton />
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div className="rp-print-root">
|
||||||
|
<FormCard
|
||||||
|
title="Отпуск без содержания"
|
||||||
|
subtitle={`№${code || itemId}`}
|
||||||
|
belowSubtitle={<InitiatorLine listTitle={dataListTitle(FORM_ID)} itemId={itemId} />}
|
||||||
|
headerRight={status ? <StatusBadge status={status} /> : undefined}
|
||||||
|
>
|
||||||
|
<FormModeProvider readOnly>
|
||||||
|
<RequestSection {...sectionProps} />
|
||||||
|
</FormModeProvider>
|
||||||
|
</FormCard>
|
||||||
|
|
||||||
|
<ApprovalMatrix editor={approvers} search={(q) => approval.searchUsers(q)} />
|
||||||
|
</div>
|
||||||
|
|
||||||
|
{/* Панель решения — ВНЕ печати и FormModeProvider (комментарий редактируемый). */}
|
||||||
|
<div className="rp-no-print">
|
||||||
|
<DecisionPanel
|
||||||
|
service={approverService}
|
||||||
|
requestId={itemId}
|
||||||
|
search={(q) => approval.searchUsers(q)}
|
||||||
|
onDecided={(newStatus) => {
|
||||||
|
setStatus(newStatus);
|
||||||
|
setDecisionSeq((n) => n + 1);
|
||||||
|
notify();
|
||||||
|
}}
|
||||||
|
onDelegated={() => {
|
||||||
|
setDecisionSeq((n) => n + 1);
|
||||||
|
notify();
|
||||||
|
}}
|
||||||
|
/>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
);
|
||||||
|
};
|
||||||
|
|
||||||
|
export default UnpaidLeaveView;
|
||||||
@@ -0,0 +1,16 @@
|
|||||||
|
{
|
||||||
|
"dataListTitle": "Отпуск без содержания — согласование",
|
||||||
|
"columns": [
|
||||||
|
{ "internalName": "TansuSiteApprover", "title": "Согласующий", "type": "User", "userSelectionMode": "PeopleOnly" },
|
||||||
|
{ "internalName": "ApprovalStatus", "title": "Статус", "type": "Choice", "choices": ["Черновик", "Ждёт очереди", "На согласовании", "На исполнении", "Согласовано", "Выполнено", "Отклонено", "Возвращена на доработку"] },
|
||||||
|
{ "internalName": "Ticket", "title": "Заявка", "type": "Lookup", "lookupList": "Отпуск без содержания — данные", "lookupShowField": "Title" },
|
||||||
|
{ "internalName": "Date", "title": "Дата", "type": "DateTime" },
|
||||||
|
{ "internalName": "Comment", "title": "Комментарий", "type": "Note" },
|
||||||
|
{ "internalName": "StepOrder", "title": "Порядок", "type": "Number" },
|
||||||
|
{ "internalName": "AllowReassignToOtherApprovers", "title": "Можно перепоручать", "type": "Boolean" },
|
||||||
|
{ "internalName": "Phase", "title": "Фаза", "type": "Choice", "choices": ["Согласование", "Исполнение"] },
|
||||||
|
{ "internalName": "SLAhours", "title": "SLA, часов", "type": "Number" },
|
||||||
|
{ "internalName": "AskOverdueReason", "title": "Опрос причины просрочки", "type": "Boolean" },
|
||||||
|
{ "internalName": "DelegatedBy", "title": "Кем переназначено", "type": "User", "userSelectionMode": "PeopleOnly" }
|
||||||
|
]
|
||||||
|
}
|
||||||
@@ -0,0 +1,54 @@
|
|||||||
|
import { getSP } from '../../shared/pnp/pnpjs';
|
||||||
|
import { dataListTitle } from '../../shared/listTitles';
|
||||||
|
import { FORM_ID, IFormData, EMPTY_DATA } from './model';
|
||||||
|
|
||||||
|
export interface ILoadedRequest {
|
||||||
|
data: IFormData;
|
||||||
|
/** Ф.И.О. сотрудника из поля Employee (для заголовка режима чтения). */
|
||||||
|
employeeName: string;
|
||||||
|
status: string;
|
||||||
|
/** Уникальный код заявки; '' — если запись создана до появления поля. */
|
||||||
|
code: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Прочитать заявку без содержания по id: модель формы + статус (правка / просмотр). */
|
||||||
|
export async function loadUnpaidLeaveRequest(itemId: number): Promise<ILoadedRequest> {
|
||||||
|
const item = (await getSP()
|
||||||
|
.web.lists.getByTitle(dataListTitle(FORM_ID))
|
||||||
|
.items.getById(itemId)
|
||||||
|
.select(
|
||||||
|
'Id',
|
||||||
|
'Position',
|
||||||
|
'StartDate',
|
||||||
|
'EndDate',
|
||||||
|
'Reason',
|
||||||
|
'RequestStatus',
|
||||||
|
'RequestUniqueCode',
|
||||||
|
'Employee/Title',
|
||||||
|
'Employee/EMail',
|
||||||
|
'Substitute/EMail'
|
||||||
|
)
|
||||||
|
.expand('Employee', 'Substitute')()) as Record<string, unknown>;
|
||||||
|
|
||||||
|
const employee = item.Employee as { Title?: string; EMail?: string } | undefined;
|
||||||
|
const substitute = item.Substitute as { EMail?: string } | undefined;
|
||||||
|
const start = (item.StartDate as string) || '';
|
||||||
|
const end = (item.EndDate as string) || '';
|
||||||
|
|
||||||
|
const data: IFormData = {
|
||||||
|
...EMPTY_DATA,
|
||||||
|
Employee: employee?.EMail || '',
|
||||||
|
Position: (item.Position as string) || '',
|
||||||
|
StartDate: start.slice(0, 10), // ISO → YYYY-MM-DD для input type=date
|
||||||
|
EndDate: end.slice(0, 10),
|
||||||
|
Reason: (item.Reason as string) || '',
|
||||||
|
Substitute: substitute?.EMail || ''
|
||||||
|
};
|
||||||
|
|
||||||
|
return {
|
||||||
|
data,
|
||||||
|
employeeName: employee?.Title || '',
|
||||||
|
status: (item.RequestStatus as string) || '',
|
||||||
|
code: (item.RequestUniqueCode as string) || ''
|
||||||
|
};
|
||||||
|
}
|
||||||
@@ -0,0 +1,59 @@
|
|||||||
|
import { WebPartContext } from '@microsoft/sp-webpart-base';
|
||||||
|
import { RequestTypeId } from '../../models/types';
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Тип заявки этой формы — ключ реестра форм (forms/registry.ts). Имена списков
|
||||||
|
* SharePoint выводятся из него, см. shared/listTitles.ts.
|
||||||
|
*/
|
||||||
|
export const FORM_ID: RequestTypeId = 'hr-unpaid-leave';
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Данные формы «Отпуск без содержания» (без сохранения заработной платы). Ключи
|
||||||
|
* по возможности = internalName колонок списка данных (см. shared/listTitles.ts).
|
||||||
|
* Employee/Substitute хранят e-mail выбранного сотрудника (то, что отдаёт
|
||||||
|
* PeopleField); по Employee резолвится маршрут согласования, поэтому заявку можно
|
||||||
|
* подать и за другого сотрудника. В отличие от «Заявки на отпуск» здесь обе даты
|
||||||
|
* (с/по) вводятся явно, а DaysCount считается при сохранении.
|
||||||
|
*/
|
||||||
|
export interface IFormData {
|
||||||
|
/** E-mail сотрудника, за которого заявка (People). Пусто = не выбран. */
|
||||||
|
Employee: string;
|
||||||
|
Position: string;
|
||||||
|
/** ISO YYYY-MM-DD (input type=date). */
|
||||||
|
StartDate: string;
|
||||||
|
/** ISO YYYY-MM-DD (input type=date). */
|
||||||
|
EndDate: string;
|
||||||
|
/** Основание «В связи с …». */
|
||||||
|
Reason: string;
|
||||||
|
/** E-mail замещающего на время отсутствия (People). Пусто = не выбран. */
|
||||||
|
Substitute: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Обновление одного поля формы с сохранением типа значения. */
|
||||||
|
export type SetField = <K extends keyof IFormData>(key: K, value: IFormData[K]) => void;
|
||||||
|
|
||||||
|
/** Пропсы секции формы: срез данных + колбэк обновления + контекст (people picker). */
|
||||||
|
export interface ISectionProps {
|
||||||
|
data: IFormData;
|
||||||
|
set: SetField;
|
||||||
|
context: WebPartContext;
|
||||||
|
/**
|
||||||
|
* Выбор сотрудника подтягивает его должность — поэтому у поля «Сотрудник»
|
||||||
|
* отдельный обработчик. Если не передан (режим чтения) — правка через set.
|
||||||
|
*/
|
||||||
|
onEmployeeChange?: (login: string) => void;
|
||||||
|
}
|
||||||
|
|
||||||
|
export const EMPTY_DATA: IFormData = {
|
||||||
|
Employee: '',
|
||||||
|
Position: '',
|
||||||
|
StartDate: '',
|
||||||
|
EndDate: '',
|
||||||
|
Reason: '',
|
||||||
|
Substitute: ''
|
||||||
|
};
|
||||||
|
|
||||||
|
/** Плейсхолдер для поля выбора сотрудника. */
|
||||||
|
export const EMPLOYEE_PLACEHOLDER = 'Начните вводить Ф.И.О. сотрудника…';
|
||||||
|
/** Плейсхолдер для поля выбора замещающего. */
|
||||||
|
export const SUBSTITUTE_PLACEHOLDER = 'Начните вводить Ф.И.О. замещающего…';
|
||||||
@@ -0,0 +1,15 @@
|
|||||||
|
{
|
||||||
|
"dataListTitle": "Отпуск без содержания — данные",
|
||||||
|
"columns": [
|
||||||
|
{ "internalName": "RequestUniqueCode", "title": "Уникальный код заявки", "type": "Text" },
|
||||||
|
{ "internalName": "RequestStatus", "title": "Статус", "type": "Choice", "choices": ["Черновик", "На согласовании", "Согласовано", "Отклонено", "Возвращена на доработку", "Выполнение", "Закрыта"] },
|
||||||
|
|
||||||
|
{ "internalName": "Employee", "title": "Сотрудник", "type": "User", "userSelectionMode": "PeopleOnly", "required": true },
|
||||||
|
{ "internalName": "Position", "title": "Должность", "type": "Text" },
|
||||||
|
{ "internalName": "StartDate", "title": "Дата начала", "type": "DateTime", "dateOnly": true },
|
||||||
|
{ "internalName": "EndDate", "title": "Дата окончания", "type": "DateTime", "dateOnly": true },
|
||||||
|
{ "internalName": "DaysCount", "title": "Количество дней", "type": "Number" },
|
||||||
|
{ "internalName": "Reason", "title": "Основание (в связи с)", "type": "Note" },
|
||||||
|
{ "internalName": "Substitute", "title": "Лицо, замещающее на время отсутствия", "type": "User", "userSelectionMode": "PeopleOnly" }
|
||||||
|
]
|
||||||
|
}
|
||||||
@@ -0,0 +1,37 @@
|
|||||||
|
import * as React from 'react';
|
||||||
|
import { CollapseSection, FormField, TextInput, TextArea, PeopleField } from '../../../shared/ui';
|
||||||
|
import { ISectionProps, EMPLOYEE_PLACEHOLDER, SUBSTITUTE_PLACEHOLDER } from '../model';
|
||||||
|
|
||||||
|
/** Единственная секция формы «Отпуск без содержания»: сотрудник, должность, период, основание, замещающий. */
|
||||||
|
export const RequestSection: React.FC<ISectionProps> = ({ data, set, context, onEmployeeChange }) => (
|
||||||
|
<CollapseSection title="Отпуск без содержания" icon="people">
|
||||||
|
<FormField label="Сотрудник" htmlFor="Employee" required full>
|
||||||
|
<PeopleField
|
||||||
|
context={context}
|
||||||
|
value={data.Employee}
|
||||||
|
onChange={onEmployeeChange ?? ((v) => set('Employee', v))}
|
||||||
|
placeholder={EMPLOYEE_PLACEHOLDER}
|
||||||
|
/>
|
||||||
|
</FormField>
|
||||||
|
<FormField label="Должность" htmlFor="Position" required>
|
||||||
|
<TextInput id="Position" value={data.Position} onChange={(v) => set('Position', v)} />
|
||||||
|
</FormField>
|
||||||
|
<FormField label="Дата начала" htmlFor="StartDate" required>
|
||||||
|
<TextInput id="StartDate" type="date" value={data.StartDate} onChange={(v) => set('StartDate', v)} />
|
||||||
|
</FormField>
|
||||||
|
<FormField label="Дата окончания" htmlFor="EndDate" required>
|
||||||
|
<TextInput id="EndDate" type="date" value={data.EndDate} onChange={(v) => set('EndDate', v)} />
|
||||||
|
</FormField>
|
||||||
|
<FormField label="В связи с" htmlFor="Reason" required full>
|
||||||
|
<TextArea id="Reason" value={data.Reason} onChange={(v) => set('Reason', v)} />
|
||||||
|
</FormField>
|
||||||
|
<FormField label="Лицо, замещающее на время отсутствия" htmlFor="Substitute" full>
|
||||||
|
<PeopleField
|
||||||
|
context={context}
|
||||||
|
value={data.Substitute}
|
||||||
|
onChange={(v) => set('Substitute', v)}
|
||||||
|
placeholder={SUBSTITUTE_PLACEHOLDER}
|
||||||
|
/>
|
||||||
|
</FormField>
|
||||||
|
</CollapseSection>
|
||||||
|
);
|
||||||
@@ -0,0 +1,98 @@
|
|||||||
|
import { getSP } from '../../shared/pnp/pnpjs';
|
||||||
|
import { ApprovalListService, IApproverToWrite, writeRoute } from '../../shared/approval';
|
||||||
|
import { buildRequestUniqueCode } from '../../shared/requestCode';
|
||||||
|
import { approvalListTitle, dataListTitle } from '../../shared/listTitles';
|
||||||
|
import { FORM_ID, IFormData } from './model';
|
||||||
|
|
||||||
|
/** Экземпляр сервиса списка согласования этой формы. */
|
||||||
|
export function unpaidLeaveApprovalService(): ApprovalListService {
|
||||||
|
return new ApprovalListService(approvalListTitle(FORM_ID));
|
||||||
|
}
|
||||||
|
|
||||||
|
/** email / claims-логин → пользователь сайта (Id для Person-поля + Title для заголовка). */
|
||||||
|
async function ensureUser(login: string): Promise<{ Id: number; Title: string }> {
|
||||||
|
const full = login.indexOf('|') >= 0 ? login : `i:0#.f|membership|${login}`;
|
||||||
|
return getSP().web.ensureUser(full);
|
||||||
|
}
|
||||||
|
|
||||||
|
function pad2(n: number): string {
|
||||||
|
return n < 10 ? `0${n}` : `${n}`;
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Число дней отпуска включительно по датам с/по. Пусто/некорректно → пусто (null). */
|
||||||
|
function computeDays(startIso: string, endIso: string): number | undefined {
|
||||||
|
if (!startIso || !endIso) return undefined;
|
||||||
|
const diff = new Date(endIso).getTime() - new Date(startIso).getTime();
|
||||||
|
if (!Number.isFinite(diff) || diff < 0) return undefined;
|
||||||
|
return Math.round(diff / 86400000) + 1;
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Осмысленный заголовок элемента (системная колонка Title). */
|
||||||
|
function buildTitle(employeeName: string): string {
|
||||||
|
const now = new Date();
|
||||||
|
return `Отпуск без содержания — ${employeeName} — ${pad2(now.getDate())}.${pad2(now.getMonth() + 1)}.${now.getFullYear()}`;
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Поля элемента списка данных из модели формы (+ Employee/Substitute по Id, + вычисленный DaysCount). */
|
||||||
|
function buildItem(
|
||||||
|
data: IFormData,
|
||||||
|
status: string,
|
||||||
|
employeeId: number,
|
||||||
|
employeeName: string,
|
||||||
|
substituteId: number | undefined
|
||||||
|
): Record<string, unknown> {
|
||||||
|
const days = computeDays(data.StartDate, data.EndDate);
|
||||||
|
return {
|
||||||
|
Title: buildTitle(employeeName),
|
||||||
|
RequestStatus: status,
|
||||||
|
EmployeeId: employeeId,
|
||||||
|
Position: data.Position || null,
|
||||||
|
StartDate: data.StartDate || null,
|
||||||
|
EndDate: data.EndDate || null,
|
||||||
|
DaysCount: days ?? null,
|
||||||
|
Reason: data.Reason || null,
|
||||||
|
SubstituteId: substituteId ?? null
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface ISaveResult {
|
||||||
|
id: number;
|
||||||
|
/** Задан только при создании новой заявки (существующий код не меняется). */
|
||||||
|
code?: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Сохранить заявку без содержания: содержимое + маршрут согласования.
|
||||||
|
* existingId задан → обновляем ту же запись (черновик/доработка), иначе создаём новую.
|
||||||
|
* Фазы исполнения нет — writeRoute вызывается с пустым списком исполнителей.
|
||||||
|
* Возвращает Id заявки (+ код при создании).
|
||||||
|
*/
|
||||||
|
export async function saveUnpaidLeaveRequest(
|
||||||
|
existingId: number | undefined,
|
||||||
|
requestTypeId: number,
|
||||||
|
data: IFormData,
|
||||||
|
approvers: IApproverToWrite[],
|
||||||
|
status: string
|
||||||
|
): Promise<ISaveResult> {
|
||||||
|
const list = getSP().web.lists.getByTitle(dataListTitle(FORM_ID));
|
||||||
|
const employee = await ensureUser(data.Employee);
|
||||||
|
// Замещающий необязателен: резолвим только если выбран.
|
||||||
|
const substituteId = data.Substitute ? (await ensureUser(data.Substitute)).Id : undefined;
|
||||||
|
const item = buildItem(data, status, employee.Id, employee.Title || data.Employee, substituteId);
|
||||||
|
|
||||||
|
let id: number;
|
||||||
|
let code: string | undefined;
|
||||||
|
if (existingId) {
|
||||||
|
await list.items.getById(existingId).update(item);
|
||||||
|
id = existingId;
|
||||||
|
} else {
|
||||||
|
const added = await list.items.add(item);
|
||||||
|
id = (added as { Id: number }).Id;
|
||||||
|
// Код известен только после создания элемента (нужен его Id).
|
||||||
|
code = buildRequestUniqueCode(requestTypeId, id, new Date());
|
||||||
|
await list.items.getById(id).update({ RequestUniqueCode: code });
|
||||||
|
}
|
||||||
|
|
||||||
|
await writeRoute(unpaidLeaveApprovalService(), id, approvers, [], status);
|
||||||
|
return { id, code };
|
||||||
|
}
|
||||||
@@ -28,6 +28,9 @@ const formRegistry: Record<string, React.LazyExoticComponent<FormComponent>> = {
|
|||||||
'hr-vacation': React.lazy(
|
'hr-vacation': React.lazy(
|
||||||
() => import(/* webpackChunkName: 'form-vacation' */ './Vacation/VacationForm')
|
() => import(/* webpackChunkName: 'form-vacation' */ './Vacation/VacationForm')
|
||||||
),
|
),
|
||||||
|
'hr-unpaid-leave': React.lazy(
|
||||||
|
() => import(/* webpackChunkName: 'form-unpaid-leave' */ './UnpaidLeave/UnpaidLeaveForm')
|
||||||
|
),
|
||||||
'wh-tmc-transfer': React.lazy(
|
'wh-tmc-transfer': React.lazy(
|
||||||
() => import(/* webpackChunkName: 'form-tmc-transfer' */ './TmcTransfer/TmcTransferForm')
|
() => import(/* webpackChunkName: 'form-tmc-transfer' */ './TmcTransfer/TmcTransferForm')
|
||||||
),
|
),
|
||||||
|
|||||||
@@ -35,6 +35,9 @@ const viewRegistry: Record<string, React.LazyExoticComponent<ViewComponent>> = {
|
|||||||
'hr-vacation': React.lazy(
|
'hr-vacation': React.lazy(
|
||||||
() => import(/* webpackChunkName: 'view-vacation' */ './Vacation/VacationView')
|
() => import(/* webpackChunkName: 'view-vacation' */ './Vacation/VacationView')
|
||||||
),
|
),
|
||||||
|
'hr-unpaid-leave': React.lazy(
|
||||||
|
() => import(/* webpackChunkName: 'view-unpaid-leave' */ './UnpaidLeave/UnpaidLeaveView')
|
||||||
|
),
|
||||||
'wh-tmc-transfer': React.lazy(
|
'wh-tmc-transfer': React.lazy(
|
||||||
() => import(/* webpackChunkName: 'view-tmc-transfer' */ './TmcTransfer/TmcTransferView')
|
() => import(/* webpackChunkName: 'view-tmc-transfer' */ './TmcTransfer/TmcTransferView')
|
||||||
),
|
),
|
||||||
|
|||||||
@@ -23,6 +23,7 @@ import { RequestTypeId } from '../models/types';
|
|||||||
const LIST_TITLE_BASE: Record<RequestTypeId, string> = {
|
const LIST_TITLE_BASE: Record<RequestTypeId, string> = {
|
||||||
'clearance-form': 'Обходной лист',
|
'clearance-form': 'Обходной лист',
|
||||||
'hr-vacation': 'Заявка на отпуск',
|
'hr-vacation': 'Заявка на отпуск',
|
||||||
|
'hr-unpaid-leave': 'Отпуск без содержания',
|
||||||
'it-1c-ticket': 'Заявка в отдел 1С',
|
'it-1c-ticket': 'Заявка в отдел 1С',
|
||||||
'it-workplace-setup': 'Организация рабочего места',
|
'it-workplace-setup': 'Организация рабочего места',
|
||||||
'recruiting-hire': 'Прием на работу',
|
'recruiting-hire': 'Прием на работу',
|
||||||
|
|||||||
Reference in New Issue
Block a user