Команды адаптера — различия между версиями
| Hubbitus (обсуждение | вклад) м (→Список команд адаптера:  Fix link) | Hubbitus (обсуждение | вклад)   (→Список команд адаптера:  Пометка удаления AttachPcToContract. Change m and M semantics.) | ||
| Строка 83: | Строка 83: | ||
| | <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]] объявляется устаревшей и будет удалена из следующих версий. || Удалена | + | | get_relation_point_connect_to_contract || Осуществляется связка договоров с ТП || С момента появления [[#CcDailyPlan|CcDailyPlan]] объявляется устаревшей и будет удалена из следующих версий. Удалена с [[история изменений|версии]] 16.0.pre5 ([http://serverprog:1090/browse/RGC-1066 RGC-1066]). || Удалена | 
| |- | |- | ||
| | <div id="ContrPcDailyPlan">ContrPcDailyPlan</div> | | <div id="ContrPcDailyPlan">ContrPcDailyPlan</div> | ||
| Строка 89: | Строка 89: | ||
| | get_contr_pc_daily_plans | | get_contr_pc_daily_plans | ||
| | Импортируются дневные планы (лимиты) по договорам и точкам подключения. Команда параметризованная. Может принимать от 1 до 3х аргументов. | | Импортируются дневные планы (лимиты) по договорам и точкам подключения. Команда параметризованная. Может принимать от 1 до 3х аргументов. | ||
| + | | С [[история изменений|версии]] адаптера 14.9.2 планы, которых нету в АИС удаляются и из ИМУС. | ||
| + | {{deprecated-inline|С появления [[#CcDailyPlan|CcDailyPlan]]}}С [[история изменений|появления]] [[#CcDailyPlan|CcDailyPlan]] объявляется устаревшей и будет удалена из следующих версий. Удалена с [[история изменений|версии]] 16.0.pre5 ([http://serverprog:1090/browse/RGC-1066 RGC-1066]) | ||
| + | | Удалена | ||
| + | |- | ||
| + | | {{anchor|CcDailyPlan}}CcDailyPlan | ||
| + | | get_cc_daily_plans | ||
| + | | Импортируются дневные планы (лимиты) по [[Перечень сокращений и обозначений#Субъект распределения|субъектам распределения]] (contract_connection) и площадкам. Команда параметризованная и приходит на смену [[#ContrPcDailyPlan|ContrPcDailyPlan]]. | ||
| + | Может принимать от 1 до 3х аргументов. | ||
| Параметры могут задаваться в трех формах: | Параметры могут задаваться в трех формах: | ||
| ''' Параметры отделяются от команды знаком подчеркивания ("_"), '''не пробел*! | ''' Параметры отделяются от команды знаком подчеркивания ("_"), '''не пробел*! | ||
| Строка 100: | Строка 108: | ||
| * Указываются только даты, без времени. Подразумевается 00:00:00 для начального дня, и 23:59:59 для конечного. | * Указываются только даты, без времени. Подразумевается 00:00:00 для начального дня, и 23:59:59 для конечного. | ||
| * Для указания даты (начальной или конечной), применяются следующие правила: | * Для указания даты (начальной или конечной), применяются следующие правила: | ||
| − | ** Если это число ( | + | ** Если это число (пример -10, +5, 0, 10) то это количество дней от текущего. Причем отрицательные отсчитываются назад, положительные вперед. Знак + может быть опущен. | 
| − | *''' Если число начинается с  | + | *''' Если число начинается с _латинского_ символа M (например M-10, m10, M+10), данные считаются относительно '''текущего месяца''', причём: | 
| + | ** 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 | 
| − | * Загрузка недели (7 дней) предшествующей сегодняшнему дню:  | + | * Текущий месяц точно по границам за один раз: CcPcDailyPlan_m0..M0 | 
| − | * Загрузка недели (7 дней) вперед, от сегодняшнего дня:  | + | * Загрузка недели (7 дней) предшествующей сегодняшнему дню: CcPcDailyPlan_-7 | 
| − | * Загрузка +/- недели:  | + | * Загрузка недели (7 дней) вперед, от сегодняшнего дня: CcPcDailyPlan_0..+7 или просто CcPcDailyPlan_0..7 | 
| − | * Загрузка первой недели (7 дней) месяца:  | + | * Загрузка последней недели месяца (7 дней): CcPcDailyPlan_M-7..M0 | 
| − | * Загрузка целого месяца (31 день), но не далее текущего дня:  | + | * Загрузка +/- недели: CcPcDailyPlan_-7..+7 или CcPcDailyPlan_-7..7 | 
| − | * Загрузка планов с 21 февраля 2012 года до текущего дня (включительно):  | + | * Загрузка первой недели (7 дней) месяца: CcPcDailyPlan_m0..m7 | 
| − | * Загрузка планов с 21 февраля 2012 года по 25 февраля:  | + | * Загрузка целого месяца (31 день), но не далее текущего дня: CcPcDailyPlan_m0..m31..0 | 
| − | + | * Загрузка планов с 21 февраля 2012 года до текущего дня (включительно): CcPcDailyPlan_#2012.02.21 | |
| − | + | * Загрузка планов с 21 февраля 2012 года по 25 февраля: CcPcDailyPlan_#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]). | ||
| | Команды -> Команды учётных систем -> Загрузка договоров и планов -> Загрузить Планы | | Команды -> Команды учётных систем -> Загрузка договоров и планов -> Загрузить Планы | ||
| |- | |- | ||
Версия 12:31, 12 июля 2013
Команды адаптеру и принцип работы
За каждую операцию выполняется только одно действие, обычно это загрузка одного вида объектов (например площадок) или какая-либо генерация.
Посылать команды можно 3мя способами:
- Через очереди ActiveMQ из браузера, в очередь AIS.CMDCONF.IN (по умолчанию адрес http://localhost:8161/)
- Большинство команд (об исключениях будет написано дополнительно) могут быть также посланы через АРМ.
- С использованием консольной утилиты 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 | Импортируются канал. Каскадное обновление статусов. | Команды -> Команды учётных систем -> Загрузка оборудования -> Загрузить Каналы | |||
| GasConsEquipClass | get_gas_cons_equip_classes | Импортируются классы ГПО | Команды -> Команды учётных систем -> Загрузка оборудования -> Загрузить Классы ГПО | |||
| GasConsEquipType | get_gas_cons_equip_types | Импортируются Типы ГПО | Команды -> Команды учётных систем -> Загрузка оборудования -> Загрузить Типы ГПО | |||
| GasConsEquip | get_gas_cons_equips | Импортируется ГПО | Команды -> Команды учётных систем -> Загрузка оборудования -> Загрузить Газопотребляющее оборудование (ГПО) | |||
| GasMeterType | get_gas_meter_types | Импортируются типы измерительного оборудования. | Из-за нашей схемы, импорт ограничен только в модели ИО, не в конечные устройства, как это может быть в АИС. Данный вопрос на рассмотрении у аналитиков в задаче ESB-643. | Команды -> Команды учётных систем -> Загрузка оборудования -> Загрузить Типы измерителей | ||
| GasMeterModel | get_gas_meter_models | Импортируются модели измерительного оборудования | Команды -> Команды учётных систем -> Загрузка оборудования -> Загрузить Модели измерителей | |||
| GasMeter | get_gas_meters | Импортируется измерительное оборудование | Команды -> Команды учётных систем -> Загрузка оборудования -> Загрузить Измерители | |||
| PriorityMark | get_priority_marks | Импортируются типы ценообразования | Ранее, до версии 15 были виды договоров | Команды -> Команды учётных систем -> Загрузка договоров и планов -> Загрузить Типы ценообразования | ||
| Contract | get_contracts | Импортируются договоры | Команды -> Команды учётных систем -> Загрузка договоров и планов -> Загрузить Договоры | |||
| PurchaseContract | get_purchase_contracts | Импортируются договоры закупки газа | С версии сервиса и адаптера 15pre5. ESB-502 | Команды -> Команды учётных систем -> Загрузка договоров и планов -> Загрузить Договоры закупки | ||
| 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). | Удалена | ||
| ContrPcDailyPlan (deprecated in С появления CcDailyPlan) | get_contr_pc_daily_plans | Импортируются дневные планы (лимиты) по договорам и точкам подключения. Команда параметризованная. Может принимать от 1 до 3х аргументов. | С версии адаптера 14.9.2 планы, которых нету в АИС удаляются и из ИМУС. (deprecated in С появления CcDailyPlan)С появления CcDailyPlan объявляется устаревшей и будет удалена из следующих версий. Удалена с версии 16.0.pre5 (RGC-1066) | Удалена | ||
| CcDailyPlan | get_cc_daily_plans | Импортируются дневные планы (лимиты) по субъектам распределения (contract_connection) и площадкам. Команда параметризованная и приходит на смену ContrPcDailyPlan. Может принимать от 1 до 3х аргументов. Параметры могут задаваться в трех формах: Параметры отделяются от команды знаком подчеркивания ("_"), не пробел*! 
 Примеры: 
 | С версии 15pre8. ESB-492. Исключает использование команды AttachPcToContract - могут появляться нежелательные объекты если выполняются вместе. До версии адаптера 18.25 не было различия между 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 и теперь такие планы загружаются совместно с обычными (сделано по причине необходимости удаления старых планов, таким образом новые должны за одну и ту же дату приходить все одновременно). | Нет | ||
| AttachPcToGco | get_relation_point_connect_to_gco | Осуществляется связка ТП и площадок. | Команды -> Команды учётных систем -> Загрузка объектов -> Загрузить Привязку ТП к Площадкам и каналам | |||
| AutoMapRegion | нет | Предпринимается попытка автоматически сопоставить Субъекты РФ | Нет | |||
| AutoMapIndustryGroup | нет | Предпринимается попытка автоматически сопоставить Группы Отраслей | Нет | |||
| AutoMapIndustry | нет | Предпринимается попытка автоматически сопоставить Отрасли | Нет | |||
| AutoMapEquipModel | нет | Предпринимается попытка автоматически сопоставить модели корректоров | Нет | |||
| AutoMapPriorityMark | нет | Предпринимается попытка автоматически сопоставить виды ценообразования | Нет | |||
| GetInfo | get_info | Выводится информация о запущенной версии адаптера ИМУС и Веб-сервиса на стороне ИУС-ГАЗ и некоторую другую полезную информацию | Команды -> Команды учётных систем -> Дополнительно -> Информация | |||
| Report (или GetReport) | нет | Генерируется отчет о состоянии и посылается по почте. Может принимать 2 параметра (разделяются символом "%", значения от имени параметра разделяются символом: "+"): 
 Пример: amq-command ReportNEW_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 | Команды -> Команды учётных систем -> Загрузка объектов -> Сгенерировать Площадки из подключений (и Потребителя) | ||
| 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 и должна быть везде удалена. | Удалена | ||
| Query | debug | Позволяет выполнить 1С запрос из файла md/query.sql в АИС. Результат пишется в md/query.result.xml | Нет | |||
| GenerateConsumptionDown | нет | Генерируется вся недостающая структура потребления вниз от площадки: узел, корректор, канал. По всем трем ступеням, вне зависимости на какой обрывается цепочка потомков. Операция безопасная - второй объект не создается никогда, если есть уже один или более. Сгенерированные объекты имеют в поле "Ид. В системе создателя" префикс "gen:" - оставшаяся часть копируется с родителя. | Нет. Вместо этого есть генерация в соответствующих объектах. | |||
| AttachPcToGcoGenerated | нет | Связывание сгенерированных командой #GenGcoFromPcAndConsumer площадок с ТП | Может использоваться неявно из команды #AttachPcToGco через опцию ais.ws.attachPcToGcoConsists | Нет | ||
| Exec | нет | Для - позволяет выполнить команду на сервере | Нет | |||
| SetCodeKDFofConsumerIntoGeneratedGCO | debug | Команда добавлена на запрос Курска добавить в комментарий сгенерированной площадки код КДФ. Вряд ли будет интересна кому-то еще. | ESB-518. С версии адаптера 15.1. | Нет | ||
| DumpQ | нет | Параметризованная команда выгрузки актированных объемов. На данный момент поддерживается параметры: 
 | Команды -> Команды учётных систем -> Экспорт данных -> {Часовые - утверждённый баланс, Суточные - утверждённый баланс, Суточные - утверждённое месячное распределение, Месячные - утверждённое месячное распределение} | |||
| RebuildZones | нет | Вызывает перестроение всех Зон ГазоПотребления (ГП) т.к. для ускорения и избавления ошибок они не перестраиваются автоматически во время загрузки. | См. QUICK-1944, QUICK-1883, QUICK-1824 | Нет. Вместо этого может быть вызвана в АРМе на панели "редактор" Зон. | ||
| UpdateGcoMainContract | нет | Проставляет основной договор на площадку с максимальным сроком действия если не проставлен никакой. Чтобы проставить всем, можно передать параметр all 
 | С версии адаптера 14.4.3. QUICK-2076 Пункт меню появится видимо с версии АРМ 1.5.80 (QUICK-2076) | Команды -> Команды учётных систем -> Загрузка договоров и планов -> Проставить площадку на основной договор | ||
| ConsType | get_cons_types | Загрузка ИМУС ConsumerType - Категорий потребления. | С версии адаптера 15pre7. ESB-504 | Команды -> Команды учётных систем -> Загрузка справочников -> Загрузить Категории потребления | ||
| AutoMapConsType | нет | Предпринимается попытка автоматически сопоставить Категории потребления | С версии 15.1pre1. ESB-508 | Нет | ||
| ExportQ | write_q | Экспортирует распределённые по субъектам распределения суточные объёмы в АИС РГ. Команда параметризованная. Параметры точно такие же как у CcDailyPlan. | С версии 17.0.pre0. ESB-636. 
 | Пока нет | ||
| ExportQRaw | write_q_raw | Экспортирует утверждённые но не распределённые по субъектам распределения суточные объёмы в АИС РГ (в противовес ExportQ). Команда параметризованная. Параметры точно такие же как у CcDailyPlan. | С версии 18.2. ESB-876. 
 | Пока нет | ||
| Eval | нет | Команда общего назначения для просмотра состояний, свойств и изменения настроек адаптера в без перезапуска. Сам адаптер доступен в контексте как ths (не this!). Допустим любой валидный Groovy код. Например: 
 | С версии 17.0.pre4. ESB-732. | Нет | 


