Работы по текущему обслуживанию xDE для SAP ERP ========================================================== Администрирование очереди входящих/исходящих документов ------------------------------------------------------- Администрирование очереди исходящих документов ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Администрирование очереди исходящих документов необходимо для выявления и устранения ошибок, возникших при отправке и обработке исходящих документов. Для просмотра очереди исходящих документов запустите транзакцию ``/TRL/XDE_OUTBOX``, введите на селекционном экране требуемые ограничения (например, по дате отправки) и нажмите кнопку |run| (Выполнить). .. image:: media/img244.png :scale: 80 :align: center :alt: Переход к очереди исходящих документов Система отобразит список исходящих документов, находящихся в одном из следующих статусов: * "A" - Документ отправлен на согласование (пользователю с ролью «Подписант») * "D" - Документ удален * "E" - Ошибка обработки документа * "N" - Документ аннулирован * "NI" - Получен запрос на аннулирование документа * "NR" - Аннулирование документа отклонено * "NS" - Отправлен запрос на аннулирование документа * "R" - Документ поставлен в очередь отправки * "R1" - Документ готов к отправке (включена функция отложенной отправки) * "S" - Документ отправлен * "SO" - Документ передан оператору ЭДО * "V" - Документ подписан * "W" - Документ отправлен в интеграционный модуль * "WI" - Подтверждение аннулирования документа отправлено в интеграционный модуль * "WIO" - Подтверждение аннулирования документа передано оператору ЭДО * "WN" - Запрос на аннулирование документа отправлен в интеграционный модуль * "WNO" - Запрос на аннулирование документа передан оператору ЭДО * "WR" - Отказ в аннулировании документа отправлен в интеграционный модуль * "WRO" - Отказ в аннулировании документа передан оператору ЭДО .. image:: media/img245.png :scale: 60 :align: center :alt: Очередь исходящих документов Система позволяет выполнить одно из следующих действий с отправкой: * Выполнить согласование * Выполнить отклонение * Отправить запрос на аннулирование * Выполнить отправку документа * Удалить документ * Выгрузить печатную форму * Выгрузить файлы ФНС * Выгрузить ZIP архив с файлами * Просмотреть логи по каждому документу Для выполнения операций необходимо выделить требуемые отправки и нажать соответствующую кнопку. .. image:: media/img246.png :scale: 60 :align: center :alt: Повторная отправка/удаление исходящих документов Для каждой отправки можно посмотреть историю обработки. Для этого необходимо выполнить двукратное нажатие на столбец ``Код статуса``. Откроется окно с историей обработки отправки. .. image:: ris168.png :scale: 49 :align: center :alt: Статус отправки Для статуса «E» можно посмотреть детальное описание ошибки. Для этого нужно нажать на пиктограмму |error2| в столбце ``Ошибка``. Откроется окно с описанием ошибки. .. image:: ris169.png :scale: 100 % :align: center :alt: Описание ошибки В таблице представлен перечень статусов отправок с описанием возможных вариантов обработки и результатов для каждого статуса. .. list-table:: Статусы отправки исходящих документов :widths: 10 20 40 :header-rows: 1 * - Код статуса - Описание - Вариант обработки/результат * - A - Документ отправлен на согласование - Документ был создан пользователем с ролью "Инициатор". В данном статусе документ будет находиться до тех пор, пока его не подпишет пользователь с ролью "Подписант" * - R1 - Документ готов к отправке - Документ сформирован и подписан, однако еще не передан в очередь на отправку (статус "R") (при включенной функции отложенной отправки) * - R - Документ поставлен в очередь отправки - В данном статусе документ будет находиться до тех пор, пока не запустится отчет для отправки очереди исходящих документов. При успешной работе отчета статус изменится на "W" * - W - Документ отправлен в ИМ - Документ отправлен в ИМ, однако еще не передан оператору ЭДО. Если документ находится в статусе «W» значительное время (от 5 минут и более), то возможны следующие причины: * Нет соединения с ИМ. Необходимо убедиться в том, что ИМ запущен и соединение с ИМ настроено корректно * Ошибка при обработке документа. В этом случае требуется анализ логов ИМ для выяснения причин ошибки. Если в ходе анализа будет установлено, что по каким-либо причинам ИМ не смог обработать документ, то документ может быть удален (кнопка «Удалить»). После удаления статус отправки изменится на «D» * - SO - Документ передан оператору ЭДО - Документ провалидирован на стороне ИМ и передан оператору ЭДО * - S - Документ отправлен - Документ получен контрагентом * - V - Документ подписан - Документ подписан контрагентом * - X - Документ отклонен - Документ отклонен контрагентом. Дальнейшая обработка документа невозможна * - WN - Запрос на аннулирование отправлен в ИМ - Запрос на аннулирование документа отправлен в ИМ, однако еще не передан оператору ЭДО * - WNO - Запрос на аннулирование передан оператору ЭДО - Запрос на аннулирование документа обработан ИМ и передан оператору ЭДО * - NS - Отправлен запрос на аннулирование - Запрос на аннулирование документа получен контрагентом. Ожидается ответ контрагента. В дальнейшем может быть получен статус "NR" или "N" * - NI - Получен запрос на аннулирование - От контрагента пришел запрос на аннулирование документа. Запрос на аннулирование можно принять/согласовать ("N") или отклонить ("NR") * - WI - Подтверждение аннулирования отправлено в ИМ - Запрос на аннулирование документа, полученный от контрагента, подтвержден. Подтверждение аннулирования отправлено в ИМ, однако еще не передано оператору ЭДО * - WIO - Подтверждение аннулирования передано оператору ЭДО - Запрос на согласование аннулирования документа провалидирован на стороне ИМ, подтверждение аннулирования передано оператору ЭДО * - N - Документ аннулирован - Документ аннулирован со стороны отправителя или получателя документа. Дальнейшая обработка документа невозможна * - WR - Отказ в аннулировании отправлен в ИМ - Отказ в аннулировании документа отправлен в ИМ, однако еще не передан оператору ЭДО * - WRO - Отказ в аннулировании передан оператору ЭДО - Отказ в аннулировании документа обработан ИМ и передан оператору ЭДО * - NR - Аннулирование отклонено - На запрос об аннулировании документа получен отказ (со стороны отправителя или получателя документа) * - E - Ошибка обработки документа - Если отправка находится в статусе «E», это означает, что в ходе последней операции обработки возникла ошибка. В первую очередь необходимо определить, какая операция привела к ошибке. Для этого в журнале обработки необходимо проанализировать статус, присвоенный отправке перед статусом «E»: * «W» - операция отправки в ИМ * «WN» - операция отправки запроса на аннулирование * «WI» - операция подтверждения запроса на аннулирование * «WR» - операция отклонения запроса на аннулирование Далее необходимо открыть детальное описание ошибки (пиктограмма |error2| в журнале обработки). Если причина ошибки понятна, необходимо устранить ее, после чего выполнить повторную отправку (кнопка «Отправить»). В этом случае Система повторит последнюю операцию из перечисленных выше. Операция будет выполнена с использованием сертификата пользователя, который изначально выполнял обработку. Если причина ошибки непонятна, может потребоваться дополнительный анализ логов ИМ. Если ошибку устранить невозможно и последней операцией была отправка (статус «W» перед статусом «E»), то отправка может быть удалена (кнопка «Удалить») * - D - Документ удален - Отправка была удалена, дальнейшая обработка невозможна Администрирование очереди входящих документов ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Администрирование очереди входящих документов необходимо для выявления и устранения ошибок, возникших при получении и обработке входящих документов. Для просмотра очереди входящих документов запустите транзакцию ``/TRL/XDE_INBOX``, введите на селекционном экране требуемые ограничения (например, по дате создания отправки) и нажмите кнопку |run| (Выполнить). .. image:: media/img247.png :scale: 90 :align: center :alt: Переход к очереди входящих документов Система отобразит список входящих документов. .. image:: media/img248.png :scale: 54 :align: center :alt: Очередь входящих документов Для документов в статусе «E» Система позволяет выполнить операцию повторно. Для этого необходимо выделить требуемые отправки и нажать кнопку ``Отправить``. .. image:: media/img249.png :scale: 80 :align: center :alt: Повторная отправка документов Для каждой отправки можно посмотреть историю обработки. Для этого необходимо выполнить двукратное нажатие на столбец ``Код статуса``. Откроется окно с историей обработки отправки. .. image:: ris173.png :scale: 47 :align: center :alt: Статус отправки Для статуса «E» можно посмотреть детальное описание ошибки. Для этого нажмите на пиктограмму |error2| в столбце ``Ошибка``. Откроется окно с описанием ошибки. .. image:: ris174.png :scale: 100 % :align: center :alt: Описание ошибки В таблице представлен перечень статусов отправок с описанием возможных вариантов обработки и результатов для каждого статуса. .. list-table:: Статусы отправки входящих документов :widths: 10 20 40 :header-rows: 1 * - Код статуса - Описание - Вариант обработки/результат * - I - Документ получен - Получен новый документ. Документ можно согласовать ("V"), отклонить ("X") или отправить запрос на аннулирование ("NS") * - WV1 - Документ предварительно согласован. Ожидается отправка - Запрос на подписание документа предварительно подтвержден, однако подтверждение еще не отправлено в ИМ (при включенной функции отложенной отправки) * - WV - Согласование документа отправлено в ИМ - Запрос на подписание документа подтвержден. Подтверждение отправлено в ИМ, однако еще не передано оператору ЭДО * - WVO - Согласование документа передано оператору ЭДО - Запрос на подписание документа провалидирован на стороне ИМ, подтверждение передано оператору ЭДО * - V - Документ подписан - Контрагент получил подтверждение согласования (подписания) документа. В дальнейшем для документа может быть запрошено аннулирование * - WX1 - Документ предварительно отклонен. Ожидается отправка - Документ предварительно отклонен, однако отказ в согласовании еще не отправлен в ИМ (при включенной функции отложенной отправки) * - WX - Отказ в согласовании документа отправлен в ИМ - Отказ в согласовании документа отправлен в ИМ, однако еще не передан оператору ЭДО * - WXO - Отказ в согласовании документа передан оператору ЭДО - Отказ в согласовании документа обработан ИМ и передан оператору ЭДО * - X - Документ отклонен - Контрагент получил отказ в согласовании документа. Дальнейшая обработка документа невозможна * - WN - Запрос на аннулирование отправлен в ИМ - Запрос на аннулирование документа отправлен в ИМ, однако еще не передан оператору ЭДО * - WNO - Запрос на аннулирование передан оператору ЭДО - Запрос на аннулирование документа обработан ИМ и передан оператору ЭДО * - NS - Отправлен запрос на аннулирование - Запрос на аннулирование документа получен контрагентом. Ожидается ответ контрагента. В дальнейшем может быть получен статус «NR» или «N» * - NI - Получен запрос на аннулирование - От контрагента пришел запрос на аннулирование документа. Запрос на аннулирование можно принять/согласовать ("N") или отклонить ("NR") * - WI - Подтверждение аннулирования отправлено в ИМ - Запрос на аннулирование документа, полученный от контрагента, подтвержден. Подтверждение аннулирования отправлено в ИМ, однако еще не передано оператору ЭДО * - WIO - Подтверждение аннулирования передано оператору ЭДО - Запрос на согласование аннулирования документа провалидирован на стороне ИМ, подтверждение аннулирования передано оператору ЭДО * - N - Документ аннулирован - Документ аннулирован со стороны отправителя или получателя документа. Дальнейшая обработка документа невозможна * - WR - Отказ в аннулировании отправлен в ИМ - Отказ в аннулировании документа отправлен в ИМ, однако еще не передан оператору ЭДО * - WRO - Отказ в аннулировании передан оператору ЭДО - Отказ в аннулировании документа обработан ИМ и передан оператору ЭДО * - NR - Аннулирование отклонено - На запрос об аннулировании документа получен отказ (со стороны отправителя или получателя документа) * - E - Ошибка обработки документа - Если отправка находится в статусе «E», это означает, что в ходе последней операции обработки возникла ошибка. В первую очередь необходимо определить, какая операция привела к ошибке. Для этого в журнале обработки необходимо проанализировать статус, присвоенный отправке перед статусом «E»: * "WV" - операция согласования * "WX" - операция отклонения * «WN» - операция отправки запроса на аннулирование * «WI» - операция подтверждения запроса на аннулирование * «WR» - операция отклонения запроса на аннулирование Далее необходимо открыть детальное описание ошибки (пиктограмма |error2| в журнале обработки). Если причина ошибки понятна, необходимо устранить ее, после чего выполнить повторно последнюю операцию (кнопка «Отправить»). Операция будет выполнена с использованием сертификата пользователя, который изначально выполнял обработку. Если причина ошибки непонятна, может потребоваться дополнительный анализ логов ИМ Анализ журнала приложения ------------------------- Модуль xDE для SAP ERP в ходе своей работы выполняет запись отладочной информации в журнал приложения SAP. Для просмотра отладочной информации запустите транзакцию ``SLG1`` и введите значения полей: * «Объект» = «/TRL/XDE»; * «С (дата/время)» = [начальная дата периода, за который требуется просмотреть отладочную информацию]; * «По (дата/время)» = [конечная дата периода, за который требуется просмотреть отладочную информацию]. Остальные поля заполните, как показано на рисунке ниже, после чего нажмите |run| (Выполнить). .. image:: ris175.png :scale: 91 :align: center :alt: Переход к просмотру отладочной информации Система отобразит список сохраненных журналов за указанный на предыдущем экране период времени. Для каждого журнала отображается следующая информация: * Дата создания журнала (1); * Время создания журнала (2); * Пользователь, под которым выполнялась программа (3); * Код транзакции (4); * Программа (5). .. image:: ris176.png :scale: 54 :align: center :alt: Список журналов Просмотр всех сообщений отдельного журнала выполняется двойным нажатием кнопки мыши по записи журнала в верхней половине экрана (1). Список сообщений журнала отображается в нижней половине экрана (2). .. image:: ris177.png :scale: 62 :align: center :alt: Просмотр всех сообщений отдельного журнала Для просмотра подробной информации в сообщении нажмите кнопку |detail| (Подробно) справа от сообщения. .. image:: ris178.png :scale: 82 :align: center :alt: Просмотр подробной информации в сообщении Описание возможных ошибок ------------------------- Отправка документов ~~~~~~~~~~~~~~~~~~~ В таблице приведено описание возможных ошибок при отправке документов. .. list-table:: Ошибки при отправке документов :widths: 10 20 40 40 :header-rows: 1 * - Код ошибки - Текст ошибки - Описание ошибки - Решение * - E030 - Нет полномочий на выполнение операции - Пользователю не присвоены полномочия на отправку документа - Выполнить присвоение требуемых полномочий – см. раздел :ref:`Настройка ролей пользователей ` * - E011 - Осуществите ведение видов док-ов отправок ОЭД для вида док-та SAP [Вид документа SAP] (``/TRL/XDE_SHIP_TY``) - Для вида документа SAP не присвоен вид документа ОЭД (вид документооборота) - Присвоить виду документа SAP соответствующий вид документа ОЭД – см. раздел :ref:`Настройка видов документов SAP ` * - E117 - Не удалось определить вид основного документа - Для вида документа SAP не присвоен вид основного документа - Присвоить виду документа SAP вид основного документа – см. раздел :ref:`Настройка видов документов SAP ` Подписание/отклонение/аннулирование документов ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ В таблице приведено описание возможных ошибок при подписании/отклонении/аннулировании документов. .. list-table:: Ошибки при подписании/отклонении/аннулировании документов :widths: 10 20 40 40 :header-rows: 1 * - Код ошибки - Текст ошибки - Описание ошибки - Решение * - E048 - В статусе [Код статуса] операция невозможна - Документ находится в статусе, в котором выполняемая операция невозможна - * - E030 - Нет полномочий на выполнение операции - Пользователю не присвоены требуемые полномочия - Выполнить присвоение требуемых полномочий – см. раздел :ref:`Настройка ролей пользователей ` * - E119 - Операция невозможна - Система настроена таким образом, что для вида данного документа в текущем статусе операция невозможна - * - E514 - [Тип бизнес-объекта SAP] [Идентификатор бизнес-объекта SAP] [Вид документа SAP] Ошибка генерации файла в ИМ - Не удалось получить файлы из ИМ для подписания/отклонения/аннулирования - Проверить работоспособность ИМ * - E000 - Не удалось отправить запрос. Попробуйте позже - Сервер ИМ недоступен - Проверить работоспособность ИМ Ошибки в журнале приложения ~~~~~~~~~~~~~~~~~~~~~~~~~~~ В таблице приведено описание возможных ошибок в журнале приложения. .. list-table:: Ошибки в журнале приложения :widths: 20 40 40 :header-rows: 1 :class: longtable * - Текст ошибки - Описание ошибки - Решение * - Ошибка сохранения статуса в кэше - Ошибка произошла при получении новых статусов из ИМ через веб-сервисы. Статус не может быть обработан при получении (например, отправка блокирована) и должен быть сохранен в таблицах Продукта (кэше статусов). При этом при сохранении в кэше произошла ошибка - Обратиться в поддержку Продукта * - Ошибка при удалении статуса из кэша - Ошибка произошла при получении новых статусов из ИМ через веб-сервисы. Статус был сохранен в кэше и успешно обработан позже. Однако Системе не удалось удалить данные статуса из кэша - Обратиться в поддержку Продукта * - Ошибка получения статуса из кэша - Ошибка произошла при получении новых статусов из ИМ через веб-сервисы. Статус был сохранен в кэше ранее, но Системе не удается получить данные статуса из кэша статусов - Обратиться в поддержку Продукта * - Статус удален из кэша - Статус был сохранен в кэше и успешно обработан позже - Действие не требуется * - Статус добавлен в кэш - Статус не может быть обработан при получении (например, отправка блокирована) и был сохранен в таблицах Продукта (кэше статусов) - Действие не требуется. Статус будет обработан позже * - Ошибка при сохранении последнего статуса - Ошибка произошла при получении новых статусов из ИМ через веб-сервисы. Системе не удалось сохранить идентификатор последнего полученного события - Обратиться в поддержку Продукта * - Новый статус не может быть обработан, есть статусы в кэше - Ошибка произошла при получении новых статусов из ИМ через веб-сервисы. Новый статус не может быть обработан, так как по этой отправке есть статусы в кэше статусов - Действие не требуется. Статус будет обработан позже * - Ошибка при выставлении статуса отправке - Системе не удалось обновить статус документа - Обратиться в поддержку Продукта * - Ошибка блокировки ящика - Системе не удалось блокировать ящик системы SAP для выполнения по нему отправки документов, либо получения статусов - Убедиться, что по данному ящику не запланировано несколько фоновых заданий. Если фоновое задание одно – игнорировать сообщение * - Ошибка обработки нового статуса - Входящий статус не может быть обработан - Проанализировать подробную информацию по ошибке в журнале приложения * - Отправка блокирована и не может быть отправлена - Документ блокирован в системе SAP и не может быть передан в ИМ - Действие не требуется. Документ будет обработан позже * - Ошибка отправки документа - Системе не удалось сформировать данные документа для передачи в ИМ - Проанализировать подробную информацию по ошибке в журнале приложения * - Ошибка инициализации Proxy-класса - Системе не удалось создать прокси-класс клиента веб-сервиса TerraLink xDE WebApi - Проверить корректность настройки логического порта. Один из настроенных портов должен быть отмечен в качестве стандартного * - Не удалось выполнить авторизацию в ИМ - Не удалось пройти авторизацию в ИМ при использовании TerraLink xDE WebApi - * Проверить корректность настроенного ApiKey в системе SAP * Проверить корректность настроенного ApiKey и ящика в системе SAP в ИМ * - Ошибка при вызове метода авторизации - Ошибка вызова метода авторизации TerraLink xDE WebApi - * Проверить корректность настройки логического порта * Убедится, что веб-сервис TerraLink xDE WebApi запущен и работает на сервере ИМ * - Ошибка при вызове метода ИМ. Операция: [название операции] - Ошибка вызова метода TerraLink xDE WebApi - * Проверить корректность настройки логического порта * Убедится, что веб-сервис TerraLink xDE WebApi запущен и работает на сервере ИМ * - Сессия ИМ истекла - Сессия авторизации в ИМ истекла - Действие не требуется. Система выполнит повторную авторизацию .. |run| image:: run.png :width: 27 :height: 28 .. |error2| image:: error2.png :width: 21 :height: 25 .. |detail| image:: detail.png :width: 21 :height: 25