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

Для целей диспетчерского контроля важно отслеживание объемов фактического потребления и плановых объёмов, поэтому при загрузке, в ИМУС площадка будет отнесена на потребителя верхнего уровня, плательщика (в терминах АИС владельца газового договора).

Каскадное обновление статусов.

1. долг контрагента более

• ais.ws.debtMore=0

2. вид реализации

• ais.ws.realizationType=8

С версии 17.0.pre2. ESB-643

требуется маппинг. Импортируются по новой схеме, в таблицу imus_mapping. С версии 15.0

(deprecated in С появления CcDailyPlan)

(deprecated in С появления CcDailyPlan)

(deprecated in С появления CcDailyPlan)С появления CcDailyPlan объявляется устаревшей. Удалена с версии 16.0.pre5 (RGC-1066) адаптер и версии 18.4.pre5 сервиса - ESB-991

Может принимать от 1 до 3х аргументов. Параметры могут задаваться в трех формах: Параметры отделяются от команды знаком подчеркивания ("_"), не пробел*!

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

Примеры:

• Сейчас грузится текущий месяц с начала и до сегодняшнего числа, за три приема чтобы не создавать каждый раз чрезмерной нагрузки, что соответствует: CcDailyPlan_m0..m10,CcDailyPlan_m11..m20,CcDailyPlan_m21..m31
• Текущий месяц точно по границам за один раз: CcDailyPlan_m0..M0
• Загрузка недели (7 дней) предшествующей сегодняшнему дню: CcDailyPlan_-7
• Загрузка недели (7 дней) вперед, от сегодняшнего дня: CcDailyPlan_0..+7 или просто CcDailyPlan_0..7
• Загрузка последней недели месяца (7 дней): CcDailyPlan_M-7..M0
• Загрузка +/- недели: CcDailyPlan_-7..+7 или CcDailyPlan_-7..7
• Загрузка первой недели (7 дней) месяца: CcDailyPlan_m0..m7
• Загрузка целого месяца (31 день), но не далее текущего дня: CcDailyPlan_m0..m31..0
• Загрузка планов с 21 февраля 2012 года до текущего дня (включительно): CcDailyPlan_#2012.02.21
• Загрузка планов с 21 февраля 2012 года по 25 февраля: CcDailyPlan_#2012.02.21..#2012.02.25

Исключает использование команды AttachPcToContract - могут появляться нежелательные объекты если выполняются вместе. До версии адаптера 18.26 не было различия между m и M (ESB-915).

(deprecated in 15.14.3)

Может принимать 2 параметра (разделяются символом "%", значения от имени параметра разделяются символом: "+"):

• to - адрес получателя. Если не задан, берется сконфигурированный по умолчанию список из ais.ws.report.to.
• file - список файлов (через "+") которые включить в архив отчета. Прежде всего для решения ШИВА. Имя файла "errors" имеет специальное значение - будут включены все файлы XML хранилища ошибок, которые не пустые.

Пример: amq-command Report_to=p.alexeev@spb.ant-inform.ru%file=errors+D:\IMUS\esb\imus-esb\log\ais.log

Подсказка. Разделителем является символы "+" и ",", таким образом, сформировать отчёт без отправки куда-либо, просто чтобы был записан на сервере можно следующей коммандой: amq-command Report_to=+ или amq-command Report_to=,

Может генерироватья только из подключения, если установлена опция ais.ws.genGCOonlyByPC

Обратите внимание, связывание на уровне площадок или потребителей не поддерживается, потому что не точно. Данные импортируются из РегистрСведений.СинхронизацияССистемамиТелеметрии.СрезПоследних где установлен признак ВыполнятьСинхронизацию Команда внешних систем в АРМе появилась с версии 1.5.70 (17.0 сервис).

(deprecated in 15.14.2)

Удалена с версии 15.0 адаптера и 18.4.pre5 сервиса (ESB-1040).

Функционал отличается от генерации структуры вниз, которая выполняется в АРМ ИМУС

На данный момент поддерживается параметры:

• DumpQ_PcDay31d для дневных объемов
• DumpQ_PcHour7d - для часовых
• DumpQ_ContrDay31d - оперативные суточные объемы потребления в разрезе договоров
• DumpQ_ContrMonth2p - посуточные данные коммерческого месячного баланса в разрезе договоров и точек подключения

Команды параметризованы. Параметры точно такие же как у CcDailyPlan.

Алгоритм по "простановке" договора работает следующим образом:

1. Для площадки вычисляется связь с ТП

2. На момент отработки команды во время ночной синхронизации (или принудительного запуска команды из АРМ) алгоритм подбирает все актуальные СР с этой ТП и определяет из них договоры.

3. Из найденных договоров выбирает один с максимальной датой окончания и пустой датой расторжения.

Обратите внимание, команда локальна

Пункт меню появится видимо с версии АРМ 1.5.80 (QUICK-2076)

QUICK-4198. С версии АРМ ~1.5.449

Параметры отделяются от команды знаком подчеркивания ("_"), не пробел*! Добавлен новый формат команды для запуска по расписанию - z и * - для вычисления месяца:

• z – вычисляет месяц относительно текущего: z и z0 текущий месяц, z-1 - прошлый и т.д.

• * – вычисляет месяц по дате

Примеры:

• Выгрузка предыдущего месяца: ExportQMonth_z-1
• Выгрузка за февраль: ExportQMonth_*2017.02.02

QUICK-4198. С версии АРМ ~1.5.449

Параметры отделяются от команды знаком подчеркивания ("_"), не пробел*! Добавлен новый формат команды для запуска по расписанию - z и * - для вычисления месяца:

• z – вычисляет месяц относительно текущего: z и z0 текущий месяц, z-1 - прошлый и т.д.

• * – вычисляет месяц по дате

Примеры:

• Выгрузка предыдущего месяца: ExportQRawMonth_z-45
• Выгрузка за февраль:ExportQRawMonth_*2017.02.02

Реализации записи с нашей стороны не предоставляется, и она должна быть задана на стороне АИС константой ASCUG_write_q_raw_month_custom_code

Для загрузки определенного представления, необходимо в конце команды указывать идентификатор системы телеметрии. Например (ASDU-3928): ExportQRawTelezone_m0..M0_50.

Реализации записи с нашей стороны не предоставляется, и она должна быть задана на стороне АИС константой ASCUG_write_q_raw_custom_code

Например:

• "println ths.debug"
• "ths.debug = true"
• "Eval_log.info(Config.generateFromOutDown)".

С версии 18.4.pre14 (ESB-1155) ths предоставляется для обратной совместимости, но совершенно не требуется, потому что выполняется в контсектсе адаптера и напрямую доступны все свойства и методы. Также добавлен доступ к глобальному объекту Config и вывод ошибки выполнения.