Команды адаптера — различия между версиями
Hubbitus (обсуждение | вклад) (Регион Выхода ГРС, добавлено описание. ESB-1393. Сервис 18.4.pre21.) |
Hubbitus (обсуждение | вклад) (ESB-1385 АИС: Изменить загрузку закупки - на пару PurContract и PurchaseContract. Service 18.4.pre22. Adapter 18.4.pre65.) |
||
Строка 63: | Строка 63: | ||
| <div id="Contract">Contract</div> || get_contracts || Импортируются договоры || || Команды -> Команды учётных систем -> Загрузка договоров и планов -> Загрузить Договоры | | <div id="Contract">Contract</div> || get_contracts || Импортируются договоры || || Команды -> Команды учётных систем -> Загрузка договоров и планов -> Загрузить Договоры | ||
|- | |- | ||
− | | <div id=" | + | | <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 || Импортируются подразделения ТрансГазов || Создаются только [[Перечень сокращений и обозначений#ПМ|ПМ]]. |
Версия 15:16, 3 апреля 2014
Команды адаптеру и принцип работы
За каждую операцию выполняется только одно действие, обычно это загрузка одного вида объектов (например площадок) или какая-либо генерация.
Посылать команды можно 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 | Импортируются договоры | Команды -> Команды учётных систем -> Загрузка договоров и планов -> Загрузить Договоры | |||
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). | Удалена | ||
(deprecated in С появления CcDailyPlan) |
|
Импортируются дневные планы (лимиты) по договорам и точкам подключения. Команда параметризованная. Может принимать от 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х аргументов. Параметры могут задаваться в трех формах: Параметры отделяются от команды знаком подчеркивания ("_"), не пробел*!
Примеры:
|
С версии 15pre8. ESB-492.
Исключает использование команды AttachPcToContract - могут появляться нежелательные объекты если выполняются вместе. До версии адаптера 18.26 не было различия между m и M (ESB-915). |
Команды -> Команды учётных систем -> Загрузка договоров и планов -> Загрузить Планы | ||
(deprecated in 15.14.3) |
|
Импортируются планы (лимиты) независимой поставки минуя РГК подобно планам 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 параметра (разделяются символом "%", значения от имени параметра разделяются символом: "+"):
Пример: 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 |
Команды -> Команды учётных систем -> Загрузка объектов -> Сгенерировать Площадки из подключений (и Потребителя) | ||
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 |
нет | Генерируется вся недостающая структура потребления вниз от площадки: узел, корректор, канал. По всем трем ступеням, вне зависимости на какой обрывается цепочка потомков. Операция безопасная - второй объект не создается никогда, если есть уже один или более. Сгенерированные объекты имеют в поле "Ид. В системе создателя" префикс "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.
С версии 18.4.pre14 (ESB-1155) ths предоставляется для обратной совместимости, но совершенно не требуется, потому что выполняется в контсектсе адаптера и напрямую доступны все свойства и методы. Также добавлен доступ к глобальному объекту Config и вывод ошибки выполнения. |
Нет | ||
Full | прямой нет | Мета-команда "Загрузить всё". Точно также как проходит стандартная загрузка ночью. Выполняются в одном пакете команды из всех 5 задач импорта: import.task[1-5].name. | С адаптера 18.4.pre15. ESB-1180. | Команды -> Команды учётных систем -> Выполнить полную загрузку QUICK-5646 | ||
GasType | get_gas_types | Загружаются виды газа в ПМ из планов, используемых в текущем году на дату загрузки. | С адаптера 18.4.pre26 и сервиса 18.4.pre15. ESB-1233. | Команды -> Команды учётных систем -> Выполнить полную загрузку QUICK-5646 |