absenceEntryAccessService

absenceEntryAccessService

• absenceEntryAccessService
  • GetManyByUserAndPeriod(userId, dateFrom, dateTo) ⇒ Promise.<ApiResult.<GetAbsenceEntriesByUserResponseDto>>
  • Get(id) ⇒ Promise.<ApiResult.<GetAbsenceEntryResponseDto>>
  • Create(params) ⇒ Promise.<ApiResult.<CreateAbsenceEntryResponseDto>>
  • Update(params) ⇒ Promise.<ApiResult>
  • Approve(id) ⇒ Promise.<ApiResult>
  • Reject(id) ⇒ Promise.<ApiResult>
  • Remove(id) ⇒ Promise.<ApiResult>

AbsenceEntryAccessService ⏏

Отсутствия офис-менеджеров (Vacation / SickLeave / SpecialLeave / UnpaidLeave / TimeOffInLieu) в ManagerTimeTrackerService — заявки, утверждение/отклонение и привязка AU-документа.

Kind: Exported class

---

GetManyByUserAndPeriod(userId, dateFrom, dateTo) ⇒ Promise.<ApiResult.<GetAbsenceEntriesByUserResponseDto>>

Возвращает заявки на отсутствие, пересекающиеся с периодом [dateFrom..dateTo].

Принимаемые параметры

Param	Type	Description
userId	number	ID пользователя
dateFrom	string	Начало периода (ISO YYYY-MM-DD)
dateTo	string	Конец периода (ISO YYYY-MM-DD)

Возвращаемые данные

Returns: Promise.<ApiResult.<GetAbsenceEntriesByUserResponseDto>> - Список заявок (GetAbsenceEntriesByUserResponseDto)

---

Get(id) ⇒ Promise.<ApiResult.<GetAbsenceEntryResponseDto>>

Возвращает заявку по идентификатору

Принимаемые параметры

Param	Type	Description
id	number	Идентификатор заявки

Возвращаемые данные

Returns: Promise.<ApiResult.<GetAbsenceEntryResponseDto>> - Заявка под полем absence (GetAbsenceEntryResponseDto)

INFO

Если заявка не найдена или soft-удалена, сервер отвечает 200 с absence: null — 404 не возвращается.

---

Create(params) ⇒ Promise.<ApiResult.<CreateAbsenceEntryResponseDto>>

Создаёт заявку на отсутствие

Принимаемые параметры

Param	Type	Description
params	CreateAbsenceEntryRequestDto	Поля новой заявки. См. CreateAbsenceEntryRequestDto

Возвращаемые данные

Returns: Promise.<ApiResult.<CreateAbsenceEntryResponseDto>> - Идентификатор созданной заявки (CreateAbsenceEntryResponseDto)

WARNING

На день, на котором уже есть запись рабочего времени, создание блокируется (тип absence-entry-conflicts-with-time-entries).

---

Update(params) ⇒ Promise.<ApiResult>

Обновляет заявку. Идентификатор передаётся в теле

Принимаемые параметры

Param	Type	Description
params	UpdateAbsenceEntryRequestDto	Новое состояние заявки (включая id). См. UpdateAbsenceEntryRequestDto

Возвращаемые данные

Returns: Promise.<ApiResult> - Подтверждение операции (successfully: true)

WARNING

Изменения разрешены только для заявок в статусе Submitted — на любом другом статусе сервер возвращает 400 с типом manager-absence-entry-not-submitted (для коррекции уже одобренной или отклонённой заявки используйте Soft-удаление

• создание новой).

---

Approve(id) ⇒ Promise.<ApiResult>

Утверждает заявку — фиксирует approvedBy и approvedAt

Принимаемые параметры

Param	Type	Description
id	number	Идентификатор заявки

Возвращаемые данные

Returns: Promise.<ApiResult> - Подтверждение операции (successfully: true)

WARNING

Допускается только из статуса Submitted (иначе 400 manager-absence-entry-not-submitted). Для отпуска (Vacation) выполняется проверка остатка дней — единица счёта — рабочие дни (выходные и государственные праздники не списываются с annualVacationDays, §9 BUrlG). При превышении лимита — 400 manager-absence-entry-vacation-budget-exceeded.

---

Reject(id) ⇒ Promise.<ApiResult>

Отклоняет заявку — переводит её в статус Rejected

Принимаемые параметры

Param	Type	Description
id	number	Идентификатор заявки

Возвращаемые данные

Returns: Promise.<ApiResult> - Подтверждение операции (successfully: true)

WARNING

Допускается только из статуса Submitted (иначе 400 manager-absence-entry-not-submitted).

---

Remove(id) ⇒ Promise.<ApiResult>

Soft-удаление заявки.

Принимаемые параметры

Param	Type	Description
id	number	Идентификатор заявки

Возвращаемые данные

Returns: Promise.<ApiResult> - Подтверждение операции (successfully: true)

---