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

Материал из ANT-Inform documentation
Перейти к: навигация, поиск
(Список команд адаптера: Пометка удаления AttachPcToContract. Change m and M semantics.)
(Список команд адаптера)
 
(не показана 51 промежуточная версия 2 участников)
Строка 24: Строка 24:
 
| <div id="Consumer">Consumer</div> || get_consumers || Импортируются потребители || || Команды -> Команды учётных систем -> Загрузка объектов -> Загрузить Потребителей
 
| <div id="Consumer">Consumer</div> || get_consumers || Импортируются потребители || || Команды -> Команды учётных систем -> Загрузка объектов -> Загрузить Потребителей
 
|-
 
|-
| <div id="GasDistribOrg">GasDistribOrg</div> || get_gas_distrib_orgs || Импортируются Газораспределительные организации ([[Перечень сокращений и обозначений#ГРО|ГРО]]) || || Команды -> Команды учётных систем -> Загрузка справочников -> Загрузить ГРО
+
| <div id="GasDistribOrg">GasDistribOrg</div> || get_gas_distrib_orgs || Импортируются Газораспределительные организации ([[Перечень сокращений и обозначений#ГРО|ГРО]]) || || Команды -> Команды учётных систем -> Загрузка справочников -> Загрузить [[ГРО]]
 
|-
 
|-
 
| <div id="GasDistribStation">GasDistribStation</div> || get_gas_distrib_stations || Импортируются [[Перечень сокращений и обозначений#ГРС|ГРС]] || || Команды -> Команды учётных систем -> Загрузка справочников -> Загрузить ГРС
 
| <div id="GasDistribStation">GasDistribStation</div> || get_gas_distrib_stations || Импортируются [[Перечень сокращений и обозначений#ГРС|ГРС]] || || Команды -> Команды учётных систем -> Загрузка справочников -> Загрузить ГРС
 
|-
 
|-
| <div id="GasDistribOut">GasDistribOut</div> || get_gas_distrib_outs || Импортируются Выходы [[Перечень сокращений и обозначений#ГРС|ГРС]]. [[Каскадное обновление статусов]]. || || Команды -> Команды учётных систем -> Загрузка справочников -> Загрузить Выходы ГРС
+
| <div id="GasDistribOut">GasDistribOut</div> || get_gas_distrib_outs || Импортируются Выходы [[ГРС]]. [[Каскадное обновление статусов]].
 +
{{ ambox | text = "Субъект РФ" (регион) выхода ГРС берётся из одноимённого свойства (РегистрСведений.ЗначенияСвойствОбъектов) (с версии [[история изменений|веб-сервиса 18.4.pre21]]) или из региона [[ГРО]], определённого для выхода [[ГРС]]. Регион [[ГРС]] импортируется в [[ГРС]], и для выхода не подходит, потому что разные выходы могут обслуживать разные регионы. }}
 +
|
 +
| Команды -> Команды учётных систем -> Загрузка справочников -> Загрузить Выходы [[ГРС]]
 
|-
 
|-
| <div id="GasConsObject">GasConsObject</div> || get_gas_cons_objects || Импортируются площадки. С дополнительными настройками также могут импортироваться пользователи АИС и зоны ответственности. Подробнее в описании опции [[Конфигурирование адаптера на стороне ИМУС#ais_ws_responseZonesBy|ais.ws.responseZonesBy]]. [[Каскадное обновление статусов]]. || || Команды -> Команды учётных систем -> Загрузка объектов -> Загрузить Площадки
+
| <div id="GasConsObject">GasConsObject</div> || get_gas_cons_objects || Импортируются площадки. С дополнительными настройками также могут импортироваться пользователи [[АИС]] в зоны ответственности. Подробнее в описании опции [[Конфигурирование адаптера на стороне ИМУС#ais_ws_responseZonesBy|ais.ws.responseZonesBy]].
 +
 
 +
Для целей диспетчерского контроля важно отслеживание объемов фактического потребления и плановых объёмов, поэтому при загрузке, в [[ИМУС]] площадка будет отнесена на [[#Consumer|потребителя]] верхнего уровня, плательщика (в терминах [[АИС]] владельца '''газового договора''').
 +
 
 +
[[Каскадное обновление статусов]].
 +
| || Команды -> Команды учётных систем -> Загрузка объектов -> Загрузить Площадки
 
|-
 
|-
 
| <div id="PointConnect">PointConnect</div> || get_point_connects || Импортируются [[Перечень сокращений и обозначений#ТП|Точки подключения]] || || Команды -> Команды учётных систем -> Загрузка объектов -> Загрузить Точки подключения
 
| <div id="PointConnect">PointConnect</div> || get_point_connects || Импортируются [[Перечень сокращений и обозначений#ТП|Точки подключения]] || || Команды -> Команды учётных систем -> Загрузка объектов -> Загрузить Точки подключения
Строка 40: Строка 48:
 
| <div id="Equip">Equip</div> || get_equips || Импортируются [[Перечень сокращений и обозначений#Корректор (Вычислитель)|Корректоры (Вычислители)]]. [[Каскадное обновление статусов]]. || || Команды -> Команды учётных систем -> Загрузка оборудования -> Загрузить Корректоры
 
| <div id="Equip">Equip</div> || get_equips || Импортируются [[Перечень сокращений и обозначений#Корректор (Вычислитель)|Корректоры (Вычислители)]]. [[Каскадное обновление статусов]]. || || Команды -> Команды учётных систем -> Загрузка оборудования -> Загрузить Корректоры
 
|-
 
|-
| <div id="Channel">Channel</div> || get_channels || Импортируются [[Перечень сокращений и обозначений#Канал|канал]]. [[Каскадное обновление статусов]]. || || Команды -> Команды учётных систем -> Загрузка оборудования -> Загрузить Каналы
+
| <div id="Channel">Channel</div> || get_channels || Импортируются [[Перечень сокращений и обозначений#Канал|канал]]. При загрузке каналов статус проставляется по родителю. [[Каскадное обновление статусов]]. || С версии адаптера 2.22.0.22. [http://serverprog:1090/browse/ASDU-2598 ASDU-2598] || Команды -> Команды учётных систем -> Загрузка оборудования -> Загрузить Каналы
 
|-
 
|-
 
| <div id="GasConsEquipClass">GasConsEquipClass</div> || get_gas_cons_equip_classes || Импортируются классы [[Перечень сокращений и обозначений#ГПО|ГПО]] || || Команды -> Команды учётных систем -> Загрузка оборудования -> Загрузить Классы ГПО
 
| <div id="GasConsEquipClass">GasConsEquipClass</div> || get_gas_cons_equip_classes || Импортируются классы [[Перечень сокращений и обозначений#ГПО|ГПО]] || || Команды -> Команды учётных систем -> Загрузка оборудования -> Загрузить Классы ГПО
Строка 47: Строка 55:
 
|-
 
|-
 
| <div id="GasConsEquip">GasConsEquip</div> || get_gas_cons_equips || Импортируется [[Перечень сокращений и обозначений#ГПО|ГПО]] || || Команды -> Команды учётных систем -> Загрузка оборудования -> Загрузить Газопотребляющее оборудование (ГПО)
 
| <div id="GasConsEquip">GasConsEquip</div> || get_gas_cons_equips || Импортируется [[Перечень сокращений и обозначений#ГПО|ГПО]] || || Команды -> Команды учётных систем -> Загрузка оборудования -> Загрузить Газопотребляющее оборудование (ГПО)
 +
|-
 +
| <div id="Pdz">Pdz</div> || get_pdz || Импортируется ПДЗ. При загрузке из АИС могут обновляться уже созданные в ИМУС ПДЗ без смены системы создателя. Задаваемые параметры (указаны значения по умолчанию):
 +
1. долг контрагента более
 +
*ais.ws.debtMore=0
 +
 +
2. вид реализации
 +
*ais.ws.realizationType=8
 +
||С [[история изменений|версии]] 22. [http://serverprog:1090/browse/ASDU-2768 ASDU-2768] || Команды -> Команды учётных систем -> Загрузка договоров и планов -> ПДЗ [https://jira.2mf.ant-inform.ru/browse/QUICK-13546 QUICK-13546]
 
|-
 
|-
 
| <div id="GasMeterType">GasMeterType</div> || get_gas_meter_types || Импортируются типы [[Перечень сокращений и обозначений#ИО|измерительного оборудования]]. || Из-за нашей схемы, импорт ограничен только в модели [[Перечень сокращений и обозначений#ИО|ИО]], не в конечные устройства, как это может быть в АИС. Данный вопрос на рассмотрении у аналитиков в задаче [http://serverprog:1090/browse/ESB-643 ESB-643].
 
| <div id="GasMeterType">GasMeterType</div> || get_gas_meter_types || Импортируются типы [[Перечень сокращений и обозначений#ИО|измерительного оборудования]]. || Из-за нашей схемы, импорт ограничен только в модели [[Перечень сокращений и обозначений#ИО|ИО]], не в конечные устройства, как это может быть в АИС. Данный вопрос на рассмотрении у аналитиков в задаче [http://serverprog:1090/browse/ESB-643 ESB-643].
Строка 60: Строка 76:
 
| <div id="Contract">Contract</div> || get_contracts || Импортируются договоры || || Команды -> Команды учётных систем -> Загрузка договоров и планов -> Загрузить Договоры
 
| <div id="Contract">Contract</div> || get_contracts || Импортируются договоры || || Команды -> Команды учётных систем -> Загрузка договоров и планов -> Загрузить Договоры
 
|-
 
|-
| <div id="PurchaseContract">PurchaseContract</div> || get_purchase_contracts || Импортируются [[#Договор закупки|договоры закупки газа]] || С [[история изменений|версии]] сервиса и адаптера 15pre5. [http://serverprog:1090/browse/ESB-502 ESB-502] || Команды -> Команды учётных систем -> Загрузка договоров и планов -> Загрузить Договоры закупки
+
| <div id="LpuDic">LpuDic</div> || get_lpus || Загружается информация о принадлежности ГРС к ЛПУ из 1С || ||
 +
|-
 +
| <div id="PurContract">PurContract</div> || get_pur_contracts || Импортируются [[Перечень сокращений и обозначений#Договор закупки|договоры закупки газа]] || С [[история изменений|версии]] сервиса 18.4.pre22 и адаптера 18.4.pre65. [http://serverprog:1090/browse/ESB-1385 ESB-1385] || Пункт меню запланирован - [http://serverprog:1090/browse/QUICK-6371 QUICK-6371]
 +
|-
 +
| <div id="PurchaseContract">PurchaseContract</div> || get_purchase_contracts || Импортируется [[Перечень сокращений и обозначений#Договор закупки|закупка (поставка) газа]] || С [[история изменений|версии]] сервиса и адаптера 15pre5. [http://serverprog:1090/browse/ESB-502 ESB-502]. С [[история изменений|версии]] сервиса 18.4.pre22 и адаптера 18.4.pre65 переименовано в Закупку, до этого было [[#Договор закупки|договор закупки]] . [http://serverprog:1090/browse/ESB-1385 ESB-1385] || Команды -> Команды учётных систем -> Загрузка договоров и планов -> Загрузить Договоры закупки. Изменение именования пункта запланировано - [http://serverprog:1090/browse/QUICK-6371 QUICK-6371]
 
|-
 
|-
 
| <div id="TransDic">TransDic</div> || get_trans_dics || Импортируются подразделения ТрансГазов || Создаются только [[Перечень сокращений и обозначений#ПМ|ПМ]].
 
| <div id="TransDic">TransDic</div> || get_trans_dics || Импортируются подразделения ТрансГазов || Создаются только [[Перечень сокращений и обозначений#ПМ|ПМ]].
Строка 83: Строка 103:
 
| <div id="AttachPcToContract">AttachPcToContract</div>
 
| <div id="AttachPcToContract">AttachPcToContract</div>
 
{{deprecated-inline|С появления [[#CcDailyPlan|CcDailyPlan]]}}
 
{{deprecated-inline|С появления [[#CcDailyPlan|CcDailyPlan]]}}
| get_relation_point_connect_to_contract || Осуществляется связка договоров с ТП || С момента появления [[#CcDailyPlan|CcDailyPlan]] объявляется устаревшей и будет удалена из следующих версий. Удалена с [[история изменений|версии]] 16.0.pre5 ([http://serverprog:1090/browse/RGC-1066 RGC-1066]). || Удалена
+
| get_relation_point_connect_to_contract || Осуществляется связка договоров с ТП || С момента появления [[#CcDailyPlan|CcDailyPlan]] объявляется устаревшей и будет удалена из следующих версий. Удалена с [[история изменений|версии 16.0.pre5]] ([http://serverprog:1090/browse/RGC-1066 RGC-1066]) в адаптере и [[история изменений|18.4.pre5 сервиса]] ([https://jira.spb.ant-inform.ru/browse/ESB-1040 ESB-1040]). || Удалена
 
|-
 
|-
| <div id="ContrPcDailyPlan">ContrPcDailyPlan</div>
+
| <div id="ContrPcDailyPlan"><s>ContrPcDailyPlan</s></div>
 
{{deprecated-inline|С появления [[#CcDailyPlan|CcDailyPlan]]}}
 
{{deprecated-inline|С появления [[#CcDailyPlan|CcDailyPlan]]}}
| get_contr_pc_daily_plans
+
| <s>get_contr_pc_daily_plans</s>
| Импортируются дневные планы (лимиты) по договорам и точкам подключения. Команда параметризованная. Может принимать от 1 до аргументов.
+
| Импортируются дневные планы (лимиты) по договорам и точкам подключения. Команда параметризованная. Может принимать от 1 до 3-х аргументов.
| С [[история изменений|версии]] адаптера 14.9.2 планы, которых нету в АИС удаляются и из ИМУС.
+
| С [[история изменений|версии]] адаптера 14.9.2 планы, которых нету в [[Перечень сокращений и обозначений#АИС РГ|АИС]] удаляются и из [[Перечень сокращений и обозначений#ИМУС|ИМУС]].
{{deprecated-inline|С появления [[#CcDailyPlan|CcDailyPlan]]}}С [[история изменений|появления]] [[#CcDailyPlan|CcDailyPlan]] объявляется устаревшей и будет удалена из следующих версий. Удалена с [[история изменений|версии]] 16.0.pre5 ([http://serverprog:1090/browse/RGC-1066 RGC-1066])
+
{{deprecated-inline|С появления [[#CcDailyPlan|CcDailyPlan]]}}С [[история изменений|появления]] [[#CcDailyPlan|CcDailyPlan]] объявляется устаревшей. '''Удалена''' с [[история изменений|версии]] 16.0.pre5 ([http://serverprog:1090/browse/RGC-1066 RGC-1066]) адаптер и [[история изменений#18.4|версии 18.4.pre5 сервиса]] - [https://jira.spb.ant-inform.ru/browse/ESB-991 ESB-991]
 
| Удалена
 
| Удалена
 
|-
 
|-
Строка 109: Строка 129:
 
* Для указания даты (начальной или конечной), применяются следующие правила:
 
* Для указания даты (начальной или конечной), применяются следующие правила:
 
** Если это число (пример -10, +5, 0, 10) то это количество дней от текущего. Причем отрицательные отсчитываются назад, положительные вперед. Знак + может быть опущен.
 
** Если это число (пример -10, +5, 0, 10) то это количество дней от текущего. Причем отрицательные отсчитываются назад, положительные вперед. Знак + может быть опущен.
*''' Если число начинается с _латинского_ символа M (например M-10, m10, M+10), данные считаются относительно '''текущего месяца''', причём:
+
* '''Если аргумент начинается с латинского символа M (например M-10, m10, M+10), данные считаются относительно '''текущего месяца''', причём:
 
** m (малая) означает отсчёт от '''первого дня месяца'''
 
** m (малая) означает отсчёт от '''первого дня месяца'''
 
** M (заглавная) - от '''последнего дня месяца'''.
 
** M (заглавная) - от '''последнего дня месяца'''.
** Если первым стоит символ #, то за ним должна стоять дата в формате yyyy.MM.dd - будет взята абсолютная дата.
+
* Если первым стоит символ #, то за ним должна стоять дата в формате yyyy.MM.dd - будет взята абсолютная дата.
 
* Обратите внимание, интервал больше 15 дней строго не рекомендуется - может быть недостаточно памяти в 1С для формирования результата. На некоторых машинах этот интервал еще меньше, и например в Белгороде составляет около 5 дней всего (там 1С 32 бита)
 
* Обратите внимание, интервал больше 15 дней строго не рекомендуется - может быть недостаточно памяти в 1С для формирования результата. На некоторых машинах этот интервал еще меньше, и например в Белгороде составляет около 5 дней всего (там 1С 32 бита)
 
Примеры:
 
Примеры:
* Сейчас грузится текущий месяц с начала и до сегодняшнего числа, за три приема чтобы не создавать каждый раз чрезмерной нагрузки, что соответствует: CcPcDailyPlan_m0..m10,CcPcDailyPlan_m11..m20,CcPcDailyPlan_m21..m31
+
* Сейчас грузится текущий месяц с начала и до сегодняшнего числа, за три приема чтобы не создавать каждый раз чрезмерной нагрузки, что соответствует: CcDailyPlan_m0..m10,CcDailyPlan_m11..m20,CcDailyPlan_m21..m31
* Текущий месяц точно по границам за один раз: CcPcDailyPlan_m0..M0
+
* Текущий месяц точно по границам за один раз: CcDailyPlan_m0..M0
* Загрузка недели (7 дней) предшествующей сегодняшнему дню: CcPcDailyPlan_-7
+
* Загрузка недели (7 дней) предшествующей сегодняшнему дню: CcDailyPlan_-7
* Загрузка недели (7 дней) вперед, от сегодняшнего дня: CcPcDailyPlan_0..+7 или просто CcPcDailyPlan_0..7
+
* Загрузка недели (7 дней) вперед, от сегодняшнего дня: CcDailyPlan_0..+7 или просто CcDailyPlan_0..7
* Загрузка последней недели месяца (7 дней): CcPcDailyPlan_M-7..M0
+
* Загрузка последней недели месяца (7 дней): CcDailyPlan_M-7..M0
* Загрузка +/- недели: CcPcDailyPlan_-7..+7 или CcPcDailyPlan_-7..7
+
* Загрузка +/- недели: CcDailyPlan_-7..+7 или CcDailyPlan_-7..7
* Загрузка первой недели (7 дней) месяца: CcPcDailyPlan_m0..m7
+
* Загрузка первой недели (7 дней) месяца: CcDailyPlan_m0..m7
* Загрузка целого месяца (31 день), но не далее текущего дня: CcPcDailyPlan_m0..m31..0
+
* Загрузка целого месяца (31 день), но не далее текущего дня: CcDailyPlan_m0..m31..0
* Загрузка планов с 21 февраля 2012 года до текущего дня (включительно): CcPcDailyPlan_#2012.02.21
+
* Загрузка планов с 21 февраля 2012 года до текущего дня (включительно): CcDailyPlan_#2012.02.21
* Загрузка планов с 21 февраля 2012 года по 25 февраля: CcPcDailyPlan_#2012.02.21..#2012.02.25
+
* Загрузка планов с 21 февраля 2012 года по 25 февраля: CcDailyPlan_#2012.02.21..#2012.02.25
 
| С [[история изменений|версии]] 15pre8. [http://serverprog:1090/browse/ESB-492 ESB-492].
 
| С [[история изменений|версии]] 15pre8. [http://serverprog:1090/browse/ESB-492 ESB-492].
 
Исключает использование команды [[#AttachPcToContract|AttachPcToContract]] - могут появляться нежелательные объекты если выполняются вместе.
 
Исключает использование команды [[#AttachPcToContract|AttachPcToContract]] - могут появляться нежелательные объекты если выполняются вместе.
До [[история изменений|версии адаптера 18.25]] не было различия между m и M ([https://jira.spb.ant-inform.ru/browse/ESB-915 ESB-915]).
+
До [[история изменений|версии адаптера 18.26]] не было различия между m и M ([https://jira.spb.ant-inform.ru/browse/ESB-915 ESB-915]).
 
| Команды -> Команды учётных систем -> Загрузка договоров и планов -> Загрузить Планы
 
| Команды -> Команды учётных систем -> Загрузка договоров и планов -> Загрузить Планы
 
|-
 
|-
| <div id="IndependentPlan">IndependentPlan</div>
+
| <div id="IndependentPlan"><s>IndependentPlan</s></div>
 
{{deprecated-inline|15.14.3}}
 
{{deprecated-inline|15.14.3}}
| get_independent_plans
+
| <s>get_independent_plans</s>
 
| Импортируются планы (лимиты) независимой поставки минуя РГК подобно планам [[#CcDailyPlan|CcDailyPlan]]. Параметры точно такие же.
 
| Импортируются планы (лимиты) независимой поставки минуя РГК подобно планам [[#CcDailyPlan|CcDailyPlan]]. Параметры точно такие же.
| | {{deprecated-inline|15.14.3}}С [[история изменений|версии]] 15.8. [http://serverprog:1090/browse/ESB-432 ESB-432]. '''Удалена''' с [[история изменений|версии]] 15.14.3 - [http://serverprog:1090/browse/ESB-602 ESB-602] и теперь такие планы загружаются совместно с обычными (сделано по причине необходимости удаления старых планов, таким образом новые должны за одну и ту же дату приходить все одновременно).
+
| | {{deprecated-inline|15.14.3}}С [[история изменений|версии 15.8]]. [http://serverprog:1090/browse/ESB-432 ESB-432]. '''Удалена''' с [[история изменений|версии]] 15.14.3 - [http://serverprog:1090/browse/ESB-602 ESB-602] в адаптере и [[история изменений#18.4|версии 18.4.pre5 сервиса]] - [https://jira.spb.ant-inform.ru/browse/ESB-991 ESB-991]. Теперь такие планы загружаются совместно с обычными (сделано по причине необходимости удаления старых планов, таким образом новые должны за одну и ту же дату приходить все одновременно).
 
| Нет
 
| Нет
 
|-
 
|-
Строка 151: Строка 171:
 
| <div id="GetInfo">GetInfo</div> || get_info || Выводится информация о запущенной версии адаптера [[Перечень сокращений и обозначений#ИМУС|ИМУС]] и Веб-сервиса на стороне [[Перечень сокращений и обозначений#ИУС-ГАЗ|ИУС-ГАЗ]] и некоторую другую полезную информацию || || Команды -> Команды учётных систем -> Дополнительно -> Информация
 
| <div id="GetInfo">GetInfo</div> || get_info || Выводится информация о запущенной версии адаптера [[Перечень сокращений и обозначений#ИМУС|ИМУС]] и Веб-сервиса на стороне [[Перечень сокращений и обозначений#ИУС-ГАЗ|ИУС-ГАЗ]] и некоторую другую полезную информацию || || Команды -> Команды учётных систем -> Дополнительно -> Информация
 
|-
 
|-
| Report (или GetReport) || нет || Генерируется отчет о состоянии и посылается по почте.
+
| {{anchor|Report}}Report (или GetReport) || нет || Генерируется отчет о состоянии и посылается по почте.
 
Может принимать 2 параметра (разделяются символом "%", значения от имени параметра разделяются символом: "+"):
 
Может принимать 2 параметра (разделяются символом "%", значения от имени параметра разделяются символом: "+"):
 
* '''to''' - адрес получателя. Если не задан, берется сконфигурированный по умолчанию список из [[Конфигурирование адаптера на стороне ИМУС#report_to|ais.ws.report.to]].
 
* '''to''' - адрес получателя. Если не задан, берется сконфигурированный по умолчанию список из [[Конфигурирование адаптера на стороне ИМУС#report_to|ais.ws.report.to]].
 
* '''file''' - список файлов (через "+") которые включить в архив отчета. Прежде всего для решения ШИВА. Имя файла "errors" имеет специальное значение - будут включены все файлы XML хранилища ошибок, которые не пустые.
 
* '''file''' - список файлов (через "+") которые включить в архив отчета. Прежде всего для решения ШИВА. Имя файла "errors" имеет специальное значение - будут включены все файлы XML хранилища ошибок, которые не пустые.
Пример: '''amq-command ReportNEW_to=p.alexeev@spb.ant-inform.ru%file=errors+D:\IMUS\esb\imus-esb\log\ais.log'''
+
Пример: '''amq-command Report_to=p.alexeev@spb.ant-inform.ru%file=errors+D:\IMUS\esb\imus-esb\log\ais.log'''
| С [[история изменений|версии]] адаптера 15.7 расширена параметрами и переименована из ReportNEW. [http://serverprog:1090/browse/ESB-416 ESB-416]
+
 
 +
{{ ambox | type = notice | text = Подсказка. Разделителем является символы "+" и ",", таким образом, сформировать отчёт без отправки куда-либо, просто чтобы был записан на сервере можно следующей коммандой:
 +
'''amq-command Report_to=+''' или '''amq-command Report_to=,'''
 +
}}
 +
| С [[история изменений|версии]] адаптера 15.7 расширена параметрами и переименована из ReportNEW.[http://serverprog:1090/browse/ESB-416 ESB-416]
 
| Команды -> Команды учётных систем -> Дополнительно -> Отчёт о состоянии
 
| Команды -> Команды учётных систем -> Дополнительно -> Отчёт о состоянии
 
|-
 
|-
| <div id="GenGcoFromPcAndConsumer">GenGcoFromPcAndConsumer</div> || gen_gco_from_pc_and_consumer || Производится генерация площадок из ТП и потребителя, если таковые не ведутся в АИС || [[Перечень сокращений и обозначений#ТП|не может быть автоматически определено (см. врезку в конце)]]
+
| <div id="GenGcoFromPcAndConsumer">GenGcoFromPcAndConsumer</div> || gen_gco_from_pc_and_consumer || Производится генерация площадок из ТП и потребителя, если таковые не ведутся в [[АИС]]. Т.к. таких объектов нет в [[АИС]] [[Каскадное обновление статусов|статус]] объектов всегда "В эксплуатации" || [[Перечень сокращений и обозначений#ТП|не может быть автоматически определено (см. врезку в конце)]]
 
Может генерироватья только из подключения, если установлена опция [[Конфигурирование адаптера на стороне ИМУС#genGCOonlyByPC|ais.ws.genGCOonlyByPC]]
 
Может генерироватья только из подключения, если установлена опция [[Конфигурирование адаптера на стороне ИМУС#genGCOonlyByPC|ais.ws.genGCOonlyByPC]]
 
| Команды -> Команды учётных систем -> Загрузка объектов -> Сгенерировать Площадки из подключений (и Потребителя)
 
| Команды -> Команды учётных систем -> Загрузка объектов -> Сгенерировать Площадки из подключений (и Потребителя)
 
|-
 
|-
| <div id="AutoMapTelemetry">AutoMapTelemetry</div> || get_relation_foreign_system || Забираются (переносятся из [[Перечень сокращений и обозначений#ИУС-ГАЗ|ИУС-ГАЗ]], если ведутся) [[Перечень сокращений и обозначений#Маппинг (связывание)|связки]] [[Перечень сокращений и обозначений#Канал|каналов]] телеметрии с [[Перечень сокращений и обозначений#УУГ|УУГ]] (только если на нем найден '''единственный''' канал) или [[Перечень сокращений и обозначений#Канал|каналами]].
+
| <div id="AutoImusMapTelemetry">AutoImusMapTelemetry (<s>AutoMapTelemetry</s>)</div> || get_relation_foreign_system || Забираются (переносятся из [[Перечень сокращений и обозначений#ИУС-ГАЗ|ИУС-ГАЗ]], если ведутся) [[Перечень сокращений и обозначений#Маппинг (связывание)|связки]] [[Перечень сокращений и обозначений#Канал|каналов]] телеметрии с [[Перечень сокращений и обозначений#УУГ|УУГ]] (только если на нем найден '''единственный''' нескрытый канал) или [[Перечень сокращений и обозначений#Канал|каналами]].
 
Обратите внимание, [[Перечень сокращений и обозначений#Маппинг (связывание)|связывание]] на уровне площадок или потребителей не поддерживается, потому что не точно.
 
Обратите внимание, [[Перечень сокращений и обозначений#Маппинг (связывание)|связывание]] на уровне площадок или потребителей не поддерживается, потому что не точно.
 
Данные импортируются из '''РегистрСведений.СинхронизацияССистемамиТелеметрии.СрезПоследних''' где установлен признак '''ВыполнятьСинхронизацию'''
 
Данные импортируются из '''РегистрСведений.СинхронизацияССистемамиТелеметрии.СрезПоследних''' где установлен признак '''ВыполнятьСинхронизацию'''
Строка 175: Строка 199:
 
| Производится попытка развесить измерительное оборудование по каналам (в АИС они на УУГ)
 
| Производится попытка развесить измерительное оборудование по каналам (в АИС они на УУГ)
 
| Устарела с [[история изменений|версии]] 15.0 ([http://serverprog:1090/browse/ESB-588 ESB-588]) адаптера и сервиса.
 
| Устарела с [[история изменений|версии]] 15.0 ([http://serverprog:1090/browse/ESB-588 ESB-588]) адаптера и сервиса.
Удалена с [[история изменений|версии]] 15.0 и должна быть везде удалена.
+
Удалена с [[история изменений|версии]] 15.0 адаптера и [[история изменений|18.4.pre5 сервиса]] ([https://jira.spb.ant-inform.ru/browse/ESB-1040 ESB-1040]).
 
| Удалена
 
| Удалена
 
|-
 
|-
 
| <div id="Query">Query</div> || debug || Позволяет выполнить 1С запрос из файла md/query.sql в АИС. Результат пишется в md/query.result.xml || || Нет
 
| <div id="Query">Query</div> || debug || Позволяет выполнить 1С запрос из файла md/query.sql в АИС. Результат пишется в md/query.result.xml || || Нет
 
|-
 
|-
| <div id="GenerateConsumptionDown">GenerateConsumptionDown</div> || нет || Генерируется вся недостающая структура потребления вниз от площадки: [[Перечень сокращений и обозначений#УУГ|узел]], [[Перечень сокращений и обозначений#Корректор (Вычислитель)|корректор]], [[Перечень сокращений и обозначений#Канал|канал]]. По всем трем ступеням, вне зависимости на какой обрывается цепочка потомков. Операция безопасная - второй объект не создается никогда, если есть уже один или более. Сгенерированные объекты имеют в поле "Ид. В системе создателя" префикс "gen:" - оставшаяся часть копируется с родителя.
+
| <div id="GenerateConsumptionDown">GenerateConsumptionDown</div> <br>новая команда DomainGenerateConsumptionDown || нет || Генерируется вся недостающая структура потребления вниз от площадки: [[Перечень сокращений и обозначений#УУГ|узел]], [[Перечень сокращений и обозначений#Корректор (Вычислитель)|корректор]], [[Перечень сокращений и обозначений#Канал|канал]]. По всем трем ступеням, вне зависимости на какой обрывается цепочка потомков. Операция безопасная - второй объект не создается никогда, если есть уже один или более. Сгенерированные объекты имеют в поле "Ид. В системе создателя" префикс "gen:" - оставшаяся часть копируется с родителя.
 +
Функционал отличается от генерации структуры вниз, которая выполняется в АРМ ИМУС
 
|
 
|
 
| Нет. Вместо этого [[Общий_порядок_загрузки_данных#Генерация структуры вниз|есть генерация в соответствующих объектах]].
 
| Нет. Вместо этого [[Общий_порядок_загрузки_данных#Генерация структуры вниз|есть генерация в соответствующих объектах]].
Строка 194: Строка 219:
 
* DumpQ_PcDay31d для дневных объемов
 
* DumpQ_PcDay31d для дневных объемов
 
* DumpQ_PcHour7d - для часовых
 
* DumpQ_PcHour7d - для часовых
* DumpQ_ContrDay31d - оперативные суточные объемы потребления в разрезе договоров (за 31 день)
+
* DumpQ_ContrDay31d - оперативные суточные объемы потребления в разрезе договоров
* DumpQ_ContrMonth2p - посуточные данные коммерческого месячного баланса в разрезе договоров и точек подключения (за текущий и предыдущий отчетные периоды – текущий и предыдущий месяцы)
+
* DumpQ_ContrMonth2p - посуточные данные коммерческого месячного баланса в разрезе договоров и точек подключения
 +
Команды параметризованы. Параметры точно такие же как у CcDailyPlan.
 
|
 
|
 
| Команды -> Команды учётных систем -> Экспорт данных -> {Часовые - утверждённый баланс, Суточные - утверждённый баланс, Суточные - утверждённое месячное распределение, Месячные - утверждённое месячное распределение}
 
| Команды -> Команды учётных систем -> Экспорт данных -> {Часовые - утверждённый баланс, Суточные - утверждённый баланс, Суточные - утверждённое месячное распределение, Месячные - утверждённое месячное распределение}
Строка 202: Строка 228:
 
| Нет. Вместо этого может быть вызвана в АРМе на панели "редактор" Зон.
 
| Нет. Вместо этого может быть вызвана в АРМе на панели "редактор" Зон.
 
|-
 
|-
| <div id="UpdateGcoMainContract">UpdateGcoMainContract</div> || нет || Проставляет основной договор на площадку с максимальным сроком действия если не проставлен никакой. Чтобы проставить '''всем''', можно передать параметр '''all'''
+
| <div id="UpdateGcoMainContract">UpdateGcoMainContract</div> || нет || Проставляет основной договор на площадку с максимальным сроком действия если не проставлен никакой. Если параметр '''all''' не указан, то будет проставлен основной договор только для тех площадок, где он не задан. Если параметр '''all''' указан, то основной договор будет актуализирован для всех площадок.
{{ ambox || text = Обратите внимание, команда локальна - данные не берутся из [[Перечень сокращений и обозначений#АИС РГ|АИС РГ]]. Т.к. площадка в общем-то может быть привязана к нескольким договорам (особенно учитывая дополнительные соглашения), для [[Перечень сокращений и обозначений#ИУС-ГАЗ|ИУС-ГАЗ]] это будет лишь некоей "суррогатной" сущностью, называемой '''''основным''''' договором, который будет показываться в формах и отчетах по умолчанию. Все договоры, вы всегда в состоянии посмотреть через привязку к [[Перечень сокращений и обозначений#Субъект распределения|субъектам распределения]] }}
+
Алгоритм по "простановке" договора работает следующим образом:
 +
 
 +
1. Для площадки вычисляется связь с ТП
 +
 
 +
2. На момент отработки команды во время ночной синхронизации (или принудительного запуска команды из АРМ) алгоритм подбирает все актуальные СР с этой ТП и определяет из них договоры.
 +
 
 +
3. Из найденных договоров выбирает один с максимальной датой окончания и пустой датой расторжения.
 +
 
 +
{{ ambox || text = [[Faq main contract|Обратите внимание, команда локальна]] }}
 
| С [[история изменений|версии]] адаптера 14.4.3. [http://serverprog:1090/browse/QUICK-2076 QUICK-2076]
 
| С [[история изменений|версии]] адаптера 14.4.3. [http://serverprog:1090/browse/QUICK-2076 QUICK-2076]
 
Пункт меню появится видимо с версии АРМ 1.5.80 ([http://serverprog:1090/browse/QUICK-2076 QUICK-2076])
 
Пункт меню появится видимо с версии АРМ 1.5.80 ([http://serverprog:1090/browse/QUICK-2076 QUICK-2076])
 
| Команды -> Команды учётных систем -> Загрузка договоров и планов -> Проставить площадку на основной договор
 
| Команды -> Команды учётных систем -> Загрузка договоров и планов -> Проставить площадку на основной договор
 
|-
 
|-
| <div id="ConsType">ConsType</div> || get_cons_types || Загрузка ИМУС ConsumerType - Категорий потребления. || С [[история изменений|версии]] адаптера 15pre7. [http://serverprog:1090/browse/ESB-504 ESB-504] || Команды -> Команды учётных систем -> Загрузка справочников -> Загрузить Категории потребления
+
| <div id="ConsumerType">ConsumerType</div> || get_cons_types || Загрузка ИМУС ConsumerType - Категорий потребления. || С [[история изменений|версии]] адаптера 15pre7. [http://serverprog:1090/browse/ESB-504 ESB-504] || Команды -> Команды учётных систем -> Загрузка справочников -> Загрузить Категории потребления
 
|-
 
|-
| <div id="AutoMapConsType">AutoMapConsType</div> || нет || Предпринимается попытка [[Перечень сокращений и обозначений#Маппинг (связывание)|автоматически сопоставить]] Категории потребления || С [[история изменений|версии]] 15.1pre1. [http://serverprog:1090/browse/ESB-508 ESB-508] || Нет
+
| <div id="AutoMapConsType">AutoMapConsType</div> || нет || Предпринимается попытка [[Перечень сокращений и обозначений#Маппинг (связывание)|автоматически сопоставить]] Категории потребления || С [[история изменений|версии]] 15.1pre1. [https://jira.spb.ant-inform.ru/browse/ESB-508 ESB-508] || Нет
 
|-
 
|-
| {{anchor|ExportQ}}ExportQ || write_q || Экспортирует распределённые по [[Перечень сокращений и обозначений#Субъект распределения|субъектам распределения]] суточные объёмы в [[Перечень сокращений и обозначений#АИС РГ|АИС РГ]]. Команда параметризованная. Параметры точно такие же как у [[#CcDailyPlan|CcDailyPlan]]. || С [[история изменений|версии]] 17.0.pre0. [http://serverprog:1090/browse/ESB-636 ESB-636].
+
| {{anchor|ExportQ}}ExportQ || write_q || [[Экспорт данных#ExportQ|Экспортирует распределённые]] по [[Перечень сокращений и обозначений#Субъект распределения|субъектам распределения]] суточные объёмы в [[АИС РГ]]. Команда параметризованная. Параметры точно такие же как у [[#CcDailyPlan|CcDailyPlan]]. || С [[история изменений|версии]] 17.0.pre0. [http://serverprog:1090/browse/ESB-636 ESB-636].
 +
{{ ambox | type = warning | text = [[Права доступа#Экспорт данных из ИМУС в АИС|Запись сначала должна быть включена явно]]! }}
 +
| Команды -> Команды учётных систем -> Экспорт данных (Веб-сервис) -> Суточные данные распределения (Веб-сервис)
 +
[https://jira.spb.ant-inform.ru/browse/QUICK-4198 QUICK-4198]. С версии АРМ ~1.5.449
 +
|-
 +
| {{anchor|ExportQMonth}}ExportQMonth || write_q || [[Экспорт данных#ExportQMonth|Экспортирует распределённые суточные]] объёмы месячного распределения в [[АИС РГ]]. Команда параметризованная.
 +
'''Параметры отделяются от команды знаком подчеркивания ("_")''', не пробел*!
 +
Добавлен новый формат команды для запуска по расписанию - z и * - для вычисления месяца:
 +
 
 +
* z – вычисляет месяц относительно текущего: z и z0 текущий месяц, z-1 - прошлый и т.д.
 +
 
 +
* * – вычисляет месяц по дате
 +
Примеры:
 +
* Выгрузка предыдущего месяца: ExportQMonth_z-1
 +
* Выгрузка за февраль: ExportQMonth_*2017.02.02
 +
| С [[история изменений|версии 19.5.pre1]] [https://jira.spb.ant-inform.ru/browse/ESB-1597 ESB-1597].
 +
{{ ambox | type = warning | text = [[Права доступа#Экспорт данных из ИМУС в АИС|Запись сначала должна быть включена явно]]! }}
 +
| В АРМ присутствует выгрузка через Зоны ГП. Планируется - [https://jira.2mf.ant-inform.ru/browse/QUICK-8295 QUICK-8295].
 +
|-
 +
| {{anchor|ExportQRaw}}ExportQRaw || write_q_raw || [[Экспорт данных#ExportQRaw|Экспортирует зону актирования]] по суткам (не распределённые по [[Перечень сокращений и обозначений#Субъект распределения|субъектам распределения]] суточные объёмы) в [[Перечень сокращений и обозначений#АИС РГ|АИС РГ]] (в противовес [[#ExportQ|ExportQ]]). Команда параметризованная. Параметры точно такие же как у [[#CcDailyPlan|CcDailyPlan]].
 +
 
 +
{{ ambox | type = warning | text = Реализации записи с нашей стороны не предоставляется, и она должна быть задана на стороне [[АИС]] константой [[Конфигурирование на стороне 1С#ASCUG_write_q_raw_custom_code|ASCUG_write_q_raw_custom_code]] }}
 +
| С [[история изменений|версии]] 18.2. [https://jira.spb.ant-inform.ru/browse/ESB-876 ESB-876].
 
{{ ambox | type = warning | text = [[Права_доступа#Экспорт данных из ИМУС в АИС|Запись сначала должна быть включена явно]]! }}
 
{{ ambox | type = warning | text = [[Права_доступа#Экспорт данных из ИМУС в АИС|Запись сначала должна быть включена явно]]! }}
| [[Экспорт данных|Пока нет]]
+
| Команды -> Команды учётных систем -> Экспорт данных (Веб-сервис) -> Суточные данные актирования (Веб-сервис)
 +
[https://jira.spb.ant-inform.ru/browse/QUICK-4198 QUICK-4198]. С версии АРМ ~1.5.449
 +
|-
 +
|-
 +
| {{anchor| ExportQRawMonth}} ExportQRawMonth || write_q_raw || [[Экспорт данных#EExportQRawMonth|Экспортирует зону актирования]] объёмы месячного потребления в [[АИС РГ]]. Команда параметризованная.
 +
'''Параметры отделяются от команды знаком подчеркивания ("_")''', не пробел*!
 +
Добавлен новый формат команды для запуска по расписанию - z и * - для вычисления месяца:
  
 +
* z – вычисляет месяц относительно текущего: z и z0 текущий месяц, z-1 - прошлый и т.д.
 +
 +
* * – вычисляет месяц по дате
 +
Примеры:
 +
* Выгрузка предыдущего месяца: ExportQRawMonth_z-45
 +
* Выгрузка за февраль:ExportQRawMonth_*2017.02.02
 +
 +
{{ ambox | type = warning | text = Реализации записи с нашей стороны не предоставляется, и она должна быть задана на стороне [[АИС]] константой [[Конфигурирование на стороне 1С#ASCUG_write_q_raw_month_custom_code|ASCUG_write_q_raw_month_custom_code]] }}
 +
| С [[история изменений|версии]] 23. [https://jira.spb.ant-inform.ru/browse/ASDU-3386 ASDU-3386].
 +
{{ ambox | type = warning | text = [[Права_доступа#Экспорт данных из ИМУС в АИС|Запись сначала должна быть включена явно]]! }}
 +
|
 
|-
 
|-
| {{anchor|ExportQRaw}}ExportQRaw || write_q_raw || Экспортирует утверждённые но не распределённые по [[Перечень сокращений и обозначений#Субъект распределения|субъектам распределения]] суточные объёмы в [[Перечень сокращений и обозначений#АИС РГ|АИС РГ]] (в противовес [[#ExportQ|ExportQ]]). Команда параметризованная. Параметры точно такие же как у [[#CcDailyPlan|CcDailyPlan]]. || С [[история изменений|версии]] 18.2. [https://jira.spb.ant-inform.ru/browse/ESB-876 ESB-876].
+
| {{anchor|ExportQRawTelezone}}ExportQRawTelezone || write_q_raw || [[Экспорт_данных#ExportQRawTelezone|Экспортирует суточные объёмы зоны КИО (телеметрии)]] в [[АИС РГ]] (в противовес [[#ExportQ|ExportQ]]). Команда параметризованная. Параметры точно такие же как у [[#CcDailyPlan|CcDailyPlan]].
 +
Для загрузки определенного представления, необходимо в конце команды указывать идентификатор системы телеметрии.
 +
Например (ASDU-3928): '''ExportQRawTelezone_m0..M0_50'''.
 +
 
 +
{{ ambox | type = warning | text = Реализации записи с нашей стороны не предоставляется, и она должна быть задана на стороне [[АИС]] константой [[Конфигурирование на стороне 1С#ASCUG_write_q_raw_custom_code|ASCUG_write_q_raw_custom_code]] }}
 +
| С [[version 19|версии]] 19.1. [https://jira.spb.ant-inform.ru/browse/ESB-1653 ESB-1653].
 
{{ ambox | type = warning | text = [[Права_доступа#Экспорт данных из ИМУС в АИС|Запись сначала должна быть включена явно]]! }}
 
{{ ambox | type = warning | text = [[Права_доступа#Экспорт данных из ИМУС в АИС|Запись сначала должна быть включена явно]]! }}
| [[Экспорт данных|Пока нет]]
+
| Пока нет
 
|-
 
|-
| <div id="Eval">Eval</div> || нет || Команда общего назначения для просмотра состояний, свойств и изменения настроек адаптера в без перезапуска. Сам адаптер доступен в контексте как '''ths''' (не this!). Допустим любой валидный Groovy код.
+
| {{anchor|Eval}}Eval || нет || Команда общего назначения для просмотра состояний, свойств и изменения настроек адаптера в без перезапуска. Сам адаптер доступен в контексте как '''ths''' (не this!). Допустим любой валидный Groovy код.
 
Например:
 
Например:
 
* "println ths.debug"
 
* "println ths.debug"
* "ths.debug = true".
+
* "ths.debug = true"
| С [[история изменений|версии]] 17.0.pre4. [http://serverprog:1090/browse/ESB-732 ESB-732].
+
* "Eval_log.info(Config.generateFromOutDown)".
 +
| С [[история изменений|версии]] 17.0.pre4. [https://jira.spb.ant-inform.ru/browse/ESB-732 ESB-732].
 +
С [[Version 18|версии 18.4.pre14]] ([https://jira.spb.ant-inform.ru/browse/ESB-1155 ESB-1155]) ths предоставляется для обратной совместимости, но совершенно не требуется, потому что выполняется в контсектсе адаптера и напрямую доступны все свойства и методы. Также добавлен доступ к глобальному объекту Config и вывод ошибки выполнения.
 
| Нет
 
| Нет
 +
|-
 +
| {{anchor|Full}}Full || прямой нет || Мета-команда "Загрузить всё". Точно также как проходит стандартная загрузка ночью. Выполняются в одном пакете команды из ais.tasks [https://jira.spb.ant-inform.ru/browse/ASDU-2925 ASDU-2925]
 +
| С адаптера [[Version 18|18.4.pre15]]. [https://jira.spb.ant-inform.ru/browse/ESB-1180 ESB-1180].
 +
| Команды -> Команды учётных систем -> Выполнить полную загрузку [https://jira.spb.ant-inform.ru/browse/QUICK-5646 QUICK-5646]
 +
|-
 +
| {{anchor|GasType}}GasType || get_gas_types || Загружаются виды газа в [[ПМ]] из планов, используемых в текущем году на дату загрузки.
 +
| С адаптера [[Version 18|18.4.pre26 и сервиса 18.4.pre15]]. [https://jira.spb.ant-inform.ru/browse/ESB-1233 ESB-1233].
 +
| Команды -> Команды учётных систем -> Загрузка договоров и планов -> Виды газа.
 +
|-
 +
|{{anchor|PriceVariant}}PriceVariant|| get_price_variants || Загружаются признаки цены в [[ПМ]]
 +
| С адаптера [[Version 19|версии 19.7]]. [https://jira.spb.ant-inform.ru/browse/ESB-2602 ESB-2602].
 +
| Пока нет
 +
|-
 +
| {{anchor|OkkCons}}OkkCons || get_okk_cons || Загружается признак ТСО для Потребителей.
 +
| С адаптера [[Version 23|23]]. [https://jira.spb.ant-inform.ru/browse/ASDU-2101 ASDU-2101].
 +
| Пока нет
 +
|-
 +
| {{anchor|OkkContract}}OkkContract || get_okk_contract || Загружается признак ТСО для Договоров.
 +
| С адаптера [[Version 23|23]]. [https://jira.spb.ant-inform.ru/browse/ASDU-2101 ASDU-2101].
 +
| Пока нет
 +
|
 
|}
 
|}

Текущая версия на 09:00, 1 декабря 2020

Команды адаптеру и принцип работы

За каждую операцию выполняется только одно действие, обычно это загрузка одного вида объектов (например площадок) или какая-либо генерация.

Посылать команды можно 3мя способами:

  1. Через очереди ActiveMQ из браузера, в очередь AIS.CMDCONF.IN (по умолчанию адрес http://localhost:8161/)
  2. Большинство команд (об исключениях будет написано дополнительно) могут быть также посланы через АРМ.
  3. С использованием консольной утилиты amq-command

Список команд адаптера

В общем случае имена команд зависимы от регистра.

Команда Соответсвующая операция ВЕБ-сервиса Описание Доп инфо Пункт меню внешних систем
Region
get_regions Импортируются Субъекты РФ. Создаются только ПМ. требуется маппинг Команды -> Команды учётных систем -> Загрузка справочников -> Загрузить Субъекты РФ
SubReg
get_sub_regs Импортируются районы Команды -> Команды учётных систем -> Загрузка справочников -> Загрузить Справочник Район
IndustryGroup
get_industry_groups Импортируются Группы отраслей. Создаются только ПМ. требуется маппинг. Команды -> Команды учётных систем -> Загрузка справочников -> Загрузить Группы отраслей
Industry
get_industrys Импортируются отрасли. Создаются только ПМ. требуется маппинг. Команды -> Команды учётных систем -> Загрузка справочников -> Загрузить отрасли промышленности
Consumer
get_consumers Импортируются потребители Команды -> Команды учётных систем -> Загрузка объектов -> Загрузить Потребителей
GasDistribOrg
get_gas_distrib_orgs Импортируются Газораспределительные организации (ГРО) Команды -> Команды учётных систем -> Загрузка справочников -> Загрузить ГРО
GasDistribStation
get_gas_distrib_stations Импортируются ГРС Команды -> Команды учётных систем -> Загрузка справочников -> Загрузить ГРС
GasDistribOut
get_gas_distrib_outs Импортируются Выходы ГРС. Каскадное обновление статусов. Команды -> Команды учётных систем -> Загрузка справочников -> Загрузить Выходы ГРС
GasConsObject
get_gas_cons_objects Импортируются площадки. С дополнительными настройками также могут импортироваться пользователи АИС в зоны ответственности. Подробнее в описании опции ais.ws.responseZonesBy.

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

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

Команды -> Команды учётных систем -> Загрузка объектов -> Загрузить Площадки
PointConnect
get_point_connects Импортируются Точки подключения Команды -> Команды учётных систем -> Загрузка объектов -> Загрузить Точки подключения
Tuug
get_uugs Импортируются Узлы Учёта Газа (УУГ). Каскадное обновление статусов. Команды -> Команды учётных систем -> Загрузка оборудования -> Загрузить Узлы учёта газа
EquipModel
get_equip_models Импортируются модели корректоров. Создаются только ПМ. требуется маппинг. Команды -> Команды учётных систем -> Загрузка оборудования -> Загрузить Модели корректоров
Equip
get_equips Импортируются Корректоры (Вычислители). Каскадное обновление статусов. Команды -> Команды учётных систем -> Загрузка оборудования -> Загрузить Корректоры
Channel
get_channels Импортируются канал. При загрузке каналов статус проставляется по родителю. Каскадное обновление статусов. С версии адаптера 2.22.0.22. ASDU-2598 Команды -> Команды учётных систем -> Загрузка оборудования -> Загрузить Каналы
GasConsEquipClass
get_gas_cons_equip_classes Импортируются классы ГПО Команды -> Команды учётных систем -> Загрузка оборудования -> Загрузить Классы ГПО
GasConsEquipType
get_gas_cons_equip_types Импортируются Типы ГПО Команды -> Команды учётных систем -> Загрузка оборудования -> Загрузить Типы ГПО
GasConsEquip
get_gas_cons_equips Импортируется ГПО Команды -> Команды учётных систем -> Загрузка оборудования -> Загрузить Газопотребляющее оборудование (ГПО)
Pdz
get_pdz Импортируется ПДЗ. При загрузке из АИС могут обновляться уже созданные в ИМУС ПДЗ без смены системы создателя. Задаваемые параметры (указаны значения по умолчанию):

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

  • ais.ws.debtMore=0

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

  • ais.ws.realizationType=8
С версии 22. ASDU-2768 Команды -> Команды учётных систем -> Загрузка договоров и планов -> ПДЗ QUICK-13546
GasMeterType
get_gas_meter_types Импортируются типы измерительного оборудования. Из-за нашей схемы, импорт ограничен только в модели ИО, не в конечные устройства, как это может быть в АИС. Данный вопрос на рассмотрении у аналитиков в задаче ESB-643.

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

Команды -> Команды учётных систем -> Загрузка оборудования -> Загрузить Типы измерителей
GasMeterModel
get_gas_meter_models Импортируются модели измерительного оборудования Команды -> Команды учётных систем -> Загрузка оборудования -> Загрузить Модели измерителей
GasMeter
get_gas_meters Импортируется измерительное оборудование Команды -> Команды учётных систем -> Загрузка оборудования -> Загрузить Измерители
PriorityMark
get_priority_marks Импортируются типы ценообразования Ранее, до версии 15 были виды договоров Команды -> Команды учётных систем -> Загрузка договоров и планов -> Загрузить Типы ценообразования
Contract
get_contracts Импортируются договоры Команды -> Команды учётных систем -> Загрузка договоров и планов -> Загрузить Договоры
LpuDic
get_lpus Загружается информация о принадлежности ГРС к ЛПУ из 1С
PurContract
get_pur_contracts Импортируются договоры закупки газа С версии сервиса 18.4.pre22 и адаптера 18.4.pre65. ESB-1385 Пункт меню запланирован - QUICK-6371
PurchaseContract
get_purchase_contracts Импортируется закупка (поставка) газа С версии сервиса и адаптера 15pre5. ESB-502. С версии сервиса 18.4.pre22 и адаптера 18.4.pre65 переименовано в Закупку, до этого было договор закупки . ESB-1385 Команды -> Команды учётных систем -> Загрузка договоров и планов -> Загрузить Договоры закупки. Изменение именования пункта запланировано - QUICK-6371
TransDic
get_trans_dics Импортируются подразделения ТрансГазов Создаются только ПМ.

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

Команды -> Команды учётных систем -> Загрузка справочников -> Загрузить Трансгазы
GasProducer
get_gas_producers Импортируются производители газа. Создаются только ПМ, требуется маппинг. Импортируются по новой схеме, в таблицу imus_mapping. С версии 15.0 Команды -> Команды учётных систем -> Загрузка справочников -> Загрузить Производителей газа
AutoMapGasProducer
нет Предпринимается попытка автоматически сопоставить Производителей Газа С версии 15.1pre1. ESB-508 нет
GasSupplier
get_gas_suppliers Импортируются Поставщики газа Создаются только ПМ.требуется маппинг. Импортируются по новой схеме, в таблицу imus_mapping. С версии 15.0 Команды -> Команды учётных систем -> Загрузка справочников -> Загрузить Поставщиков газа
AutoMapGasSupplier
нет Предпринимается попытка автоматически сопоставить Поставщиков Газа С версии 15.1pre1. ESB-508 Нет
GasVendor
get_gas_vendors Импортируются продавцы (владельцы) газа Создаются только ПМ, требуется маппинг. Импортируются по новой схеме, в таблицу imus_mapping. С версии 15pre6 Команды -> Команды учётных систем -> Загрузка справочников -> Загрузить Продавцов газа
AutoMapGasVendor
нет Предпринимается попытка автоматически сопоставить Продавцов Газа С версии 15.1pre1. ESB-508 Нет
AutoMapTransDic
нет Предпринимается попытка автоматически сопоставить отделений Трансгаза С версии адаптера 15.11.1. ESB-565 Нет
AttachPcToContract

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

get_relation_point_connect_to_contract Осуществляется связка договоров с ТП С момента появления CcDailyPlan объявляется устаревшей и будет удалена из следующих версий. Удалена с версии 16.0.pre5 (RGC-1066) в адаптере и 18.4.pre5 сервиса (ESB-1040). Удалена
ContrPcDailyPlan

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

get_contr_pc_daily_plans Импортируются дневные планы (лимиты) по договорам и точкам подключения. Команда параметризованная. Может принимать от 1 до 3-х аргументов. С версии адаптера 14.9.2 планы, которых нету в АИС удаляются и из ИМУС.

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

Удалена
CcDailyPlan get_cc_daily_plans Импортируются дневные планы (лимиты) по субъектам распределения (contract_connection) и площадкам. Команда параметризованная и приходит на смену ContrPcDailyPlan.

Может принимать от 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
С версии 15pre8. ESB-492.

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

Команды -> Команды учётных систем -> Загрузка договоров и планов -> Загрузить Планы
IndependentPlan

(deprecated in 15.14.3)

get_independent_plans Импортируются планы (лимиты) независимой поставки минуя РГК подобно планам CcDailyPlan. Параметры точно такие же. (deprecated in 15.14.3)С версии 15.8. ESB-432. Удалена с версии 15.14.3 - ESB-602 в адаптере и версии 18.4.pre5 сервиса - ESB-991. Теперь такие планы загружаются совместно с обычными (сделано по причине необходимости удаления старых планов, таким образом новые должны за одну и ту же дату приходить все одновременно). Нет
AttachPcToGco
get_relation_point_connect_to_gco Осуществляется связка ТП и площадок. Команды -> Команды учётных систем -> Загрузка объектов -> Загрузить Привязку ТП к Площадкам и каналам
AutoMapRegion
нет Предпринимается попытка автоматически сопоставить Субъекты РФ Нет
AutoMapIndustryGroup
нет Предпринимается попытка автоматически сопоставить Группы Отраслей Нет
AutoMapIndustry
нет Предпринимается попытка автоматически сопоставить Отрасли Нет
AutoMapEquipModel
нет Предпринимается попытка автоматически сопоставить модели корректоров Нет
AutoMapPriorityMark
нет Предпринимается попытка автоматически сопоставить виды ценообразования Нет
GetInfo
get_info Выводится информация о запущенной версии адаптера ИМУС и Веб-сервиса на стороне ИУС-ГАЗ и некоторую другую полезную информацию Команды -> Команды учётных систем -> Дополнительно -> Информация
Report (или GetReport) нет Генерируется отчет о состоянии и посылается по почте.

Может принимать 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

С версии адаптера 15.7 расширена параметрами и переименована из ReportNEW.ESB-416 Команды -> Команды учётных систем -> Дополнительно -> Отчёт о состоянии
GenGcoFromPcAndConsumer
gen_gco_from_pc_and_consumer Производится генерация площадок из ТП и потребителя, если таковые не ведутся в АИС. Т.к. таких объектов нет в АИС статус объектов всегда "В эксплуатации" не может быть автоматически определено (см. врезку в конце)

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

Команды -> Команды учётных систем -> Загрузка объектов -> Сгенерировать Площадки из подключений (и Потребителя)
AutoImusMapTelemetry (AutoMapTelemetry)
get_relation_foreign_system Забираются (переносятся из ИУС-ГАЗ, если ведутся) связки каналов телеметрии с УУГ (только если на нем найден единственный нескрытый канал) или каналами.

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

Команды -> Команды учётных систем -> Загрузка оборудования -> Загрузить привязку телеметрии
AutoRelateGasMetersToChannels

(deprecated in 15.14.2)

get_relation_gas_meter_to_uug Производится попытка развесить измерительное оборудование по каналам (в АИС они на УУГ) Устарела с версии 15.0 (ESB-588) адаптера и сервиса.

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

Удалена
Query
debug Позволяет выполнить 1С запрос из файла md/query.sql в АИС. Результат пишется в md/query.result.xml Нет
GenerateConsumptionDown

новая команда DomainGenerateConsumptionDown
нет Генерируется вся недостающая структура потребления вниз от площадки: узел, корректор, канал. По всем трем ступеням, вне зависимости на какой обрывается цепочка потомков. Операция безопасная - второй объект не создается никогда, если есть уже один или более. Сгенерированные объекты имеют в поле "Ид. В системе создателя" префикс "gen:" - оставшаяся часть копируется с родителя.

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

Нет. Вместо этого есть генерация в соответствующих объектах.
AttachPcToGcoGenerated
нет Связывание сгенерированных командой #GenGcoFromPcAndConsumer площадок с ТП Может использоваться неявно из команды #AttachPcToGco через опцию ais.ws.attachPcToGcoConsists Нет
Exec
нет Для - позволяет выполнить команду на сервере Нет
SetCodeKDFofConsumerIntoGeneratedGCO
debug Команда добавлена на запрос Курска добавить в комментарий сгенерированной площадки код КДФ. Вряд ли будет интересна кому-то еще. ESB-518. С версии адаптера 15.1. Нет
DumpQ
нет Параметризованная команда выгрузки актированных объемов.

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

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

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

Команды -> Команды учётных систем -> Экспорт данных -> {Часовые - утверждённый баланс, Суточные - утверждённый баланс, Суточные - утверждённое месячное распределение, Месячные - утверждённое месячное распределение}
RebuildZones
нет Вызывает перестроение всех Зон ГазоПотребления (ГП) т.к. для ускорения и избавления ошибок они не перестраиваются автоматически во время загрузки. См. QUICK-1944, QUICK-1883, QUICK-1824 Нет. Вместо этого может быть вызвана в АРМе на панели "редактор" Зон.
UpdateGcoMainContract
нет Проставляет основной договор на площадку с максимальным сроком действия если не проставлен никакой. Если параметр all не указан, то будет проставлен основной договор только для тех площадок, где он не задан. Если параметр all указан, то основной договор будет актуализирован для всех площадок.

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

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

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

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

С версии адаптера 14.4.3. QUICK-2076

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

Команды -> Команды учётных систем -> Загрузка договоров и планов -> Проставить площадку на основной договор
ConsumerType
get_cons_types Загрузка ИМУС ConsumerType - Категорий потребления. С версии адаптера 15pre7. ESB-504 Команды -> Команды учётных систем -> Загрузка справочников -> Загрузить Категории потребления
AutoMapConsType
нет Предпринимается попытка автоматически сопоставить Категории потребления С версии 15.1pre1. ESB-508 Нет
ExportQ write_q Экспортирует распределённые по субъектам распределения суточные объёмы в АИС РГ. Команда параметризованная. Параметры точно такие же как у CcDailyPlan. С версии 17.0.pre0. ESB-636. Команды -> Команды учётных систем -> Экспорт данных (Веб-сервис) -> Суточные данные распределения (Веб-сервис)

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

ExportQMonth write_q Экспортирует распределённые суточные объёмы месячного распределения в АИС РГ. Команда параметризованная.

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

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

Примеры:

  • Выгрузка предыдущего месяца: ExportQMonth_z-1
  • Выгрузка за февраль: ExportQMonth_*2017.02.02
С версии 19.5.pre1 ESB-1597. В АРМ присутствует выгрузка через Зоны ГП. Планируется - QUICK-8295.
ExportQRaw write_q_raw Экспортирует зону актирования по суткам (не распределённые по субъектам распределения суточные объёмы) в АИС РГ (в противовес ExportQ). Команда параметризованная. Параметры точно такие же как у CcDailyPlan. С версии 18.2. ESB-876. Команды -> Команды учётных систем -> Экспорт данных (Веб-сервис) -> Суточные данные актирования (Веб-сервис)

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

ExportQRawMonth write_q_raw Экспортирует зону актирования объёмы месячного потребления в АИС РГ. Команда параметризованная.

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

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

Примеры:

  • Выгрузка предыдущего месяца: ExportQRawMonth_z-45
  • Выгрузка за февраль:ExportQRawMonth_*2017.02.02
С версии 23. ASDU-3386.
ExportQRawTelezone write_q_raw Экспортирует суточные объёмы зоны КИО (телеметрии) в АИС РГ (в противовес ExportQ). Команда параметризованная. Параметры точно такие же как у CcDailyPlan.

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

С версии 19.1. ESB-1653. Пока нет
Eval нет Команда общего назначения для просмотра состояний, свойств и изменения настроек адаптера в без перезапуска. Сам адаптер доступен в контексте как ths (не this!). Допустим любой валидный Groovy код.

Например:

  • "println ths.debug"
  • "ths.debug = true"
  • "Eval_log.info(Config.generateFromOutDown)".
С версии 17.0.pre4. ESB-732.

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

Нет
Full прямой нет Мета-команда "Загрузить всё". Точно также как проходит стандартная загрузка ночью. Выполняются в одном пакете команды из ais.tasks ASDU-2925 С адаптера 18.4.pre15. ESB-1180. Команды -> Команды учётных систем -> Выполнить полную загрузку QUICK-5646
GasType get_gas_types Загружаются виды газа в ПМ из планов, используемых в текущем году на дату загрузки. С адаптера 18.4.pre26 и сервиса 18.4.pre15. ESB-1233. Команды -> Команды учётных систем -> Загрузка договоров и планов -> Виды газа.
PriceVariant get_price_variants Загружаются признаки цены в ПМ С адаптера версии 19.7. ESB-2602. Пока нет
OkkCons get_okk_cons Загружается признак ТСО для Потребителей. С адаптера 23. ASDU-2101. Пока нет
OkkContract get_okk_contract Загружается признак ТСО для Договоров. С адаптера 23. ASDU-2101. Пока нет