Экспорт данных — различия между версиями

Версия 19:54, 19 апреля 2013

ЭКСПЕРИМЕНТАЛЬНО^[1] реализован экспорт распределённых суточных данных из ИМУС в АИС Регионгаз.

Обратите внимание, по умолчанию ВЕБ-сервис ASCUG остался только для чтения! Возможность записи должна быть включена представителем компании явным заданием константы ASCUG_ENABLE_WRITE!

Требуемые изменения в конфигурации

К сожалению, видимо конфигурация АИС писалась без учета возможности работы в чисто серверном режиме (какими являются ВЕБ-сервис, внешние соединения и т.д.) и в том числе имеет плохой стиль взаимодействия с пользователем в различных частях системы, даже не проверяя что это в данный момент возможно. Такие проверки делаются легко с помощью конструкций вида:

#Если наКлиенте Тогда 
	Вопрос("Вы точно хотите продолжить?", РежимДиалогаВопрос.ДаНет);
#КонецЕсли

Мы настоятельно рекомендуем кому-либо из представителей региональной компании, имеющей договор на поддержку, обратиться в поддержку ООО «Аудит НТ» для внесения данных изменений в основной состав конфигурации с очередным обновлением

Таким образом, при использовании на сервере таких конструкций это приводит к ошибке, поскольку такие функции просто не определены. Подробнее про это рекомендуется прочитать в интернете, например [1]. В конфигурации АИС проблема усугубляется тем, что такое взаимодействие присутствует в модулях объекта, что вообще дурной практикой. Это приводит даже просто к невозможности создания документов к сожалению.

Таким образом все такие операции в модуле документа СуточноеПотребление должны быть обрамлены условными конструкциями препроцессору (сейчас таких мест 6 штук для конфигурации версии 1.1.28).

Для простоты при совпадении номера конфигурации и условии что не вносилось ручных изменений в данный модуль, можно его скопировать также из предложенного нами cf-файла. Или внести соответствующие изменения самостоятельно.

Обратите внимание, данные изменения никак не затрагивают обычное использование АИС Регионгаз, потому что данные конструкции именно указывают на то что в обычном режиме это и выполняются, и не выполняются только в режиме сервера.

Тестирование

В процессе тестирования, пока не доступен функционал отправки запроса на экспорт из АРМ, можно посылать команды из консоли с помощью утилитки amq-command, на сервере ИМУС.

Основная команда для этого ExportQ с параметрами. Например: «amq-command ExportQ_<DateFrom>..<DateTo>..<DateBound>», точно также как для планов.

Описание параметров <DateFrom>..<DateTo>..<DateBound>:

• Может принимать от 1 до 3х аргументов.
• Первый обязателен.
• Параметры отделяются от команды знаком подчеркивания ("_"), не пробел!
• Разделяются аргументы ".." также без пробелов.
• Значения 3х параметров следующие:
  • Первый - начало интервала для которого загружаются планы.
  • Второй - окончание интервала.
  • Третий - ограничение заданного выше интервала указанным числом. Сделано прежде всего чтобы можно было делать относительные интервалы, ограниченные сверху. Например 30 дней с начала месяца, но не далее сегодняшнего числа.
• Указание второго параметра не обязательно, тогда он будет принят концом текущего дня.
• Указание третьего параметра также не обязательно - тогда не будет этого ограничения.
• Указываются только даты, без времени. Подразумевается 00:00:00 для начального дня, и 23:59:59 для конечного.
• Для указания даты (начальной или конечной), применяются следующие правила:
  • Если это число (Пример -10, +5, 0, 10) то это количество дней от текущего. Причем отрицательные отсчитываются назад, положительные вперед. Знак + может быть опущен.
  • Если число начинается с латинского символа M в любом регистре, (например M-10, m10, M+10) - берется количество дней относительно начала текущего месяца.
  • Если первым стоит символ #, то за ним должна стоять дата в формате yyyy.MM.dd - будет взята абсолютная дата.

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

• С начала текущего месяца, до сегодня, за три приема чтобы не создавать каждый раз чрезмерной нагрузки, что соответствует: ExportQ_M0..M10..0,ExportQ_M11..M20..0,ExportQ_M21..M31..0
• Загрузка недели (7 дней) предшествующей сегодняшнему дню: ExportQ_-7
• Загрузка недели (7 дней) вперед, от сегодняшнего дня: ExportQ_0..+7 или просто ExportQ_0..7
• Загрузка +/- недели: ExportQ_-7..+7 или просто ExportQ_-7..7
• Загрузка первой недели (7 дней) текущего месяца: ExportQ_M0..M7
• Загрузка целого месяца (31 день), но не далее текущего дня: ExportQ_M0..M31..0
• Загрузка с 21 февраля 2012 года до текущего дня (включительно): ExportQ_#2012.02.21
• Загрузка c 21 февраля 2012 года по 25 февраля: ExportQ_#2012.02.21..#2012.02.25

Примечания

1. ↑ С версии 17.0. Мы очень просим всех желающих принять участие в тестировании данного функционала. Высказать свои замечания, предложения, пожелания.