ModernERP EAM / Рабочая инструкция

EAM и APS: недоступность, очередь и повторная доставка

Сопоставьте оборудование с ресурсом APS и контролируйте подтверждение, изменение и отмену ограничений.

Редакция от 21 ноября 2026 года. Действия и ограничения сверены с исходниками EAM; установленная версия и права могут отличаться.

Перед началом

Кому нужен доступ

Администраторы EAM и APS настраивают подключение и разрешения. Главный механик/диспетчер подтверждает простои в своём scope; пользователи без прав не меняют mapping и очередь.

Что подготовить

Существующий APS workspace, source ID импортированного снимка, external ID ресурса, tenant и организации. Подтвердите, что остановка выбранного оборудования действительно делает ресурс целиком недоступным.

1. Создайте подключение и отдельные права

В EAM откройте «APS», создайте HTTPS-подключение. На стороне APS настройте отдельную учётную запись ROLE_EAM_CONNECTOR и grants tenant/organization/connection/workspace/source. В EAM задайте EAM_APS_CREDENTIALS по connection UUID.

Проверьте результат: Учётная запись не получила доступ к остальным API APS. Пароли не включены в outbox или исходный код.

2. Сопоставьте именно ресурс планирования

Укажите оборудование, external ID ресурса, workspace и source. Текущий Pro-ресурс часто является участком section:<id>, а не отдельным станком. Для полной блокировки требуется явное подтверждение и основание.

Проверьте результат: Остановка одного станка не заблокирует цех необоснованно. Выбран существующий ресурс нужного импортированного источника.

3. Выберите влияние и подтвердите простой

INFORMATIONAL регистрирует факт без ограничения календаря. RESOURCE_UNAVAILABLE применяет подтверждённую недоступность к сопоставленному ресурсу. Обновление и отмена передают новую версию того же бизнес-объекта.

Проверьте результат: Черновик не попал в жёсткие ограничения. CAPACITY_REDUCTION не используется: частичная потеря мощности в V1 запрещена.

4. Запустите доставку и проверьте подтверждение

Администратор настраивает app:eam:availability:deliver по расписанию. Приёмник подтверждает событие после commit. В интерфейсе следите за pending, попытками и failed; повтор неизменного события не должен создавать новое ограничение.

Проверьте результат: Есть подтверждённая доставка, а фактический APS-календарь отражает окно. Один успешный HTTP-запрос не заменяет проверку нужного ресурса.

5. Устраните ошибку и повторите отправку

При остановке APS события остаются в очереди. Дождитесь штатного backoff; не переписывайте nextAttemptAt вручную. Для failed доступен штатный retry с сохранением eventId/payload, истории и счётчика попыток.

Проверьте результат: После восстановления очередь разгружается. Одинаковый eventId с другим содержимым не отправлен как «повтор»: приёмник отвергает конфликт.

6. Проверьте перенос или снятие окна

Отмена снимает только собственное влияние записи; пересекающиеся ручные и другие EAM-окна остаются. При переносе workspace/source доставляются отмена старому адресату и новое состояние. Сохраните grants старого адресата до ACK отмены.

Проверьте результат: Старое ограничение снято, новое подтверждено. Между workspace нет распределённой транзакции: результат проверен для каждого события.

7. Пересчитайте расписание

Изменение доступности повышает revision и требует нового расчёта APS. Событие EAM не утверждает новый производственный план автоматически. Реимпорт ERP повторно накладывает сохранённые EAM-ограничения.

Проверьте результат: Используется актуальный расчёт, а утверждение выполнено ответственным по принятому процессу.

Ограничения и ошибки

Нет автоматического бесконечного продления открытого ремонта: ожидаемый конец нужно обновлять. Отключение подключения сохраняет pending и историю. При включении проверяйте reconciliation; после его ошибки сверку можно повторить без удаления данных.

Если действие недоступно, проверьте роль, разрешения, принадлежность к участку и статус документа. При ошибке сохраните номер документа, время и текст сообщения; передайте их ответственному, прежде чем повторять изменяющую операцию.

Экраны интерфейса

Иллюстрации показывают отдельные экраны. Доступные действия сверяйте с вашей ролью и установленной версией; скриншоты не подтверждают выполнение всего сценария.

Режим влияния на APS
Реальный интерфейс · учебные данныеУчебные INFORMATIONAL-записи не подтверждают живую отправку в APS.Нажмите, чтобы открыть оригинал.

Примеры и команды

Ограниченная порция доставки

Команда отправляет реальные события настроенным получателям. Запускайте в нужной установке с подготовленными credentials; для постоянной работы используйте согласованное расписание от пользователя приложения.

php bin/console app:eam:availability:deliver --limit=100