Конфигурирование адаптера на стороне ИМУС — различия между версиями
Hubbitus (обсуждение | вклад) (ConsType should be ConsumerType for dvisAbsent) |
(→Опции которые могут быть оставлены со значениями по умолчанию) |
||
(не показано 36 промежуточных версий 3 участников) | |||
Строка 9: | Строка 9: | ||
! colspan="2"| Для АИС<ref name="ais-its">В [[история изменений|версии]] 18.4.pre32 появилась поддержка двух учётных систем, указанные обязательные опции зависят от выбранного типа провайдера данных. За подробностями обращайтесь к опции конфигурации [[Конфигурирование адаптера на стороне ИМУС#ais.serviceProvider|ais.serviceProvider]]</ref> | ! colspan="2"| Для АИС<ref name="ais-its">В [[история изменений|версии]] 18.4.pre32 появилась поддержка двух учётных систем, указанные обязательные опции зависят от выбранного типа провайдера данных. За подробностями обращайтесь к опции конфигурации [[Конфигурирование адаптера на стороне ИМУС#ais.serviceProvider|ais.serviceProvider]]</ref> | ||
|- | |- | ||
− | | {{anchor|ais.ws.url|ais_ws_url}}ais.ws.url || URL Веб-сервиса. ''' | + | | {{anchor|ais.ws.url|ais_ws_url}}ais.ws.url || URL Веб-сервиса. Если<ref>C [[version 19|версии адаптера 19.5.pre16]] добавлена опциональность чтобы поддержать https схему, до этого требовалось указывать без протокола</ref> не начинается на http, префикс '''http://''' предполагается. |
|- | |- | ||
| {{anchor|ais.ws.user|ais_ws_user}}ais.ws.user || Пользователь для доступа | | {{anchor|ais.ws.user|ais_ws_user}}ais.ws.user || Пользователь для доступа | ||
Строка 15: | Строка 15: | ||
| {{anchor|ais.ws.password|ais_ws_password}}ais.ws.password || Пароль. До [[история изменений|версии]] 17 просьба не использовать символ @ и кавычек. | | {{anchor|ais.ws.password|ais_ws_password}}ais.ws.password || Пароль. До [[история изменений|версии]] 17 просьба не использовать символ @ и кавычек. | ||
|- | |- | ||
− | | {{anchor|settings.codesystem|settings_codesystem}}settings.codesystem || Код системы, от которой будет работать адаптер. Например "tverrgmain.ais". | + | | {{anchor|settings.codesystem|settings_codesystem}}settings.codesystem || Код [[Внешняя система|системы]], от которой будет работать адаптер. Например "tverrgmain.ais". |
|- | |- | ||
! colspan="2"| Для ITS<ref name="ais-its"/> | ! colspan="2"| Для ITS<ref name="ais-its"/> | ||
Строка 52: | Строка 52: | ||
| | | | ||
|- | |- | ||
− | | {{anchor|ais.ws.migrate.OrigIdsToUID|ais_ws_migrate_OrigIdsToUID}}ais.ws.migrate.OrigIdsToUID || false || Значение true может использоваться временно для миграции с файлового адаптера, когда требуется обновление кодов. При этом будет осуществляться обновление [[Перечень сокращений и обозначений#orig_id|orig_id]] перед любой другой обработкой. См. также параметр [[#ais_ws_migrate_OrigIdsToUID_Field|ais.ws.migrate.OrigIdsToUID_Field]] || | + | | {{anchor|ais.ws.migrate.OrigIdsToUID|ais_ws_migrate_OrigIdsToUID}}<strike>ais.ws.migrate.OrigIdsToUID</strike> || false || Значение true может использоваться временно для миграции с файлового адаптера, когда требуется обновление кодов. При этом будет осуществляться обновление [[Перечень сокращений и обозначений#orig_id|orig_id]] перед любой другой обработкой. См. также параметр [[#ais_ws_migrate_OrigIdsToUID_Field|ais.ws.migrate.OrigIdsToUID_Field]] || |
|- | |- | ||
− | | {{anchor|ais.ws.migrate.OrigIdsToUID_Field|ais_ws_migrate_OrigIdsToUID_Field}}ais.ws.migrate.OrigIdsToUID_Field || code || Если [[#ais_ws_migrate_OrigIdsToUID|ais.ws.migrate.OrigIdsToUID]] установлено в true, то значение отсюда будет иметь следующее значение при миграции: | + | | {{anchor|ais.ws.migrate.OrigIdsToUID_Field|ais_ws_migrate_OrigIdsToUID_Field}}<strike>ais.ws.migrate.OrigIdsToUID_Field</strike> || code || Если [[#ais_ws_migrate_OrigIdsToUID|ais.ws.migrate.OrigIdsToUID]] установлено в true, то значение отсюда будет иметь следующее значение при миграции: |
; code : Объекты загружались используя короткие коды из поля Код [[Перечень сокращений и обозначений#АИС РГ|АИС РГ]]. | ; code : Объекты загружались используя короткие коды из поля Код [[Перечень сокращений и обозначений#АИС РГ|АИС РГ]]. | ||
; foreignKey : Объекты загружались используя как идентификатор поле ВнешнийКлюч [[Перечень сокращений и обозначений#АИС РГ|АИС РГ]] | ; foreignKey : Объекты загружались используя как идентификатор поле ВнешнийКлюч [[Перечень сокращений и обозначений#АИС РГ|АИС РГ]] | ||
Строка 62: | Строка 62: | ||
| {{anchor|ais.ws.report.to|ais_ws_report_to}}ais.ws.report.to || aisreports@spb.ant-inform.ru || Список через запятую, '''без пробелов''' - email-адресов получателей отчёта по команде [[Команды адаптера#Report|Report]]. Используется если для команды не задан другой в момент вызова. || | | {{anchor|ais.ws.report.to|ais_ws_report_to}}ais.ws.report.to || aisreports@spb.ant-inform.ru || Список через запятую, '''без пробелов''' - email-адресов получателей отчёта по команде [[Команды адаптера#Report|Report]]. Используется если для команды не задан другой в момент вызова. || | ||
|- | |- | ||
− | | {{anchor|ais.ws.report.subject|ais_ws_report_subject}}ais.ws.report.subject || IMUS-ais report for %1$s || Тема письма отчёта о состоянии. Первый подстановочный плэйсхолдер (%1$s), если присутствует, будет заменён на имя системы из [[#settings_codesystem|settings.codesystem]] || | + | | {{anchor|ais.ws.report.subject|ais_ws_report_subject}}ais.ws.report.subject || IMUS-ais report for %1$s || Тема письма отчёта о состоянии. Первый подстановочный плэйсхолдер (%1$s), если присутствует, будет заменён на имя [[Внешняя система|системы]] из [[#settings_codesystem|settings.codesystem]] || |
|- | |- | ||
| {{anchor|ais.ws.directByPC|ais_ws_directByPC}}ais.ws.directByPC || 0 || Признак забирать [[Перечень сокращений и обозначений#ТП|Точки Подключения]] напрямую из справочников, вместо регистров. Для случая когда не ведутся площадки. Т.к. площадки не вести никто не разрешал, специального параметра конфигурации для этого нету, и соответственно такой случай автоматически не определить. Использование регистра предпочтительнее - там есть активность объектов, и не забирается мусор. | | {{anchor|ais.ws.directByPC|ais_ws_directByPC}}ais.ws.directByPC || 0 || Признак забирать [[Перечень сокращений и обозначений#ТП|Точки Подключения]] напрямую из справочников, вместо регистров. Для случая когда не ведутся площадки. Т.к. площадки не вести никто не разрешал, специального параметра конфигурации для этого нету, и соответственно такой случай автоматически не определить. Использование регистра предпочтительнее - там есть активность объектов, и не забирается мусор. | ||
Строка 73: | Строка 73: | ||
| {{anchor|ais.ws.generateFromOutDown|ais_ws_generateFromOutDown}}ais.ws.generateFromOutDown || true || Генерировать ли структуру вниз от Выходов [[Перечень сокращений и обозначений#ГРС|ГРС]] ([[Перечень сокращений и обозначений#УУГ|УУГ]], [[Перечень сокращений и обозначений#Корректор (Вычислитель)|Корректор]], [[Перечень сокращений и обозначений#Канал|Канал]]). Реализован забор и их узлов, если они есть для поставки. Но в подавляющем большинстве случаев это просто не нужно. Если включено, работает быстрее. || | | {{anchor|ais.ws.generateFromOutDown|ais_ws_generateFromOutDown}}ais.ws.generateFromOutDown || true || Генерировать ли структуру вниз от Выходов [[Перечень сокращений и обозначений#ГРС|ГРС]] ([[Перечень сокращений и обозначений#УУГ|УУГ]], [[Перечень сокращений и обозначений#Корректор (Вычислитель)|Корректор]], [[Перечень сокращений и обозначений#Канал|Канал]]). Реализован забор и их узлов, если они есть для поставки. Но в подавляющем большинстве случаев это просто не нужно. Если включено, работает быстрее. || | ||
|- | |- | ||
− | | {{anchor|ais.ws.telemetryUugOuterRelation|ais_ws_telemetryUugOuterRelation}}ais.ws.telemetryUugOuterRelation || || Параметр конфигурации для команды [[Команды адаптера# | + | | {{anchor|ais.ws.telemetryUugOuterRelation|ais_ws_telemetryUugOuterRelation}}ais.ws.telemetryUugOuterRelation || || Параметр конфигурации для команды [[Команды адаптера#AutoImusMapTelemetry|AutoImusMapTelemetry]]. Значение - разделенные запятой пары "[[Внешняя система|система_в_аис]]:[[Внешняя система|система_имус]]". '''Пробелы не допускаются'''. Все имена должны быть в нижнем регистре. Для русского текста должна использоваться [http://docs.oracle.com/javase/1.4.2/docs/tooldocs/windows/native2ascii.html Java-нотация] вида '''\u''' (например "стел" = "\u0441\u0442\u0435\u\043b") |
− | Специальная | + | Специальная [[Внешняя система|система]] [[ИМУС]] с именем 'skip' позволяет проигнорировать [[Внешняя система|системы]] которые не нужны. Будет отдельный [[Налагаемые требования целостности, коды ошибок#code2201_1|код ошибки 2201_1]]. |
− | | | + | | Псевдо [[Внешняя система|система]] skip добавлена в [[история изменений|версии]] 17.0. [http://serverprog:1090/browse/ESB-751 ESB-751]. |
|- | |- | ||
| {{anchor|ais.ws.muteErrors|ais_ws_muteErrors}}ais.ws.muteErrors || || Отключение пометки в объектах указанных через запятую кодов ошибок. | | {{anchor|ais.ws.muteErrors|ais_ws_muteErrors}}ais.ws.muteErrors || || Отключение пометки в объектах указанных через запятую кодов ошибок. | ||
Строка 84: | Строка 84: | ||
| Доступно с [[история изменений|версии]] адаптера 14.4.1 | | Доступно с [[история изменений|версии]] адаптера 14.4.1 | ||
|- | |- | ||
− | | {{anchor|ais.ws.gceAttachToAnyChannel|ais_ws_gceAttachToAnyChannel}}ais.ws.gceAttachToAnyChannel || false || Если установлено в true - | + | | {{anchor|ais.ws.gceAttachToAnyChannel|ais_ws_gceAttachToAnyChannel}}ais.ws.gceAttachToAnyChannel || false || Если установлено в true - ГПО вешается на любой нескрытый канал площадки, когда его больше 1, иначе (по умолчанию) только на единственный. [[Перечень сокращений и обозначений#ГПО|ГПО]] на скрытый канал не вешается никогда, даже если такой канал единственный. Если скрытый канал единственный и уже загруженный на этот канал, то связь не сбрасывается, в логе ошибка 1506_3. Если скрытый канал не единственный, то устанавливается связь с нескрытым каналом. Если это первая загрузка ГПО, то связи с каналом не будет, в логе ошибка 1506_3 || |
|- | |- | ||
| {{anchor|ais.ws.genGCOonlyByPC|ais_ws_genGCOonlyByPC}}ais.ws.genGCOonlyByPC || false || Способ генерации Площадок командой [[Команды адаптера#GenGcoFromPcAndConsumer|GenGcoFromPcAndConsumer]] | | {{anchor|ais.ws.genGCOonlyByPC|ais_ws_genGCOonlyByPC}}ais.ws.genGCOonlyByPC || false || Способ генерации Площадок командой [[Команды адаптера#GenGcoFromPcAndConsumer|GenGcoFromPcAndConsumer]] | ||
Строка 100: | Строка 100: | ||
; inspector : Импорт пользователей АИС и построение по ним Зон Ответственности из инспекторов площадок (inspector) ([http://serverprog:1090/browse/ESB-398 ESB-398]) | ; inspector : Импорт пользователей АИС и построение по ним Зон Ответственности из инспекторов площадок (inspector) ([http://serverprog:1090/browse/ESB-398 ESB-398]) | ||
; curator : из кураторов договоров ([http://serverprog:1090/browse/ESB-407 ESB-407]) | ; curator : из кураторов договоров ([http://serverprog:1090/browse/ESB-407 ESB-407]) | ||
− | ; sector : по Абонентскому участку площадки формируется Зона ответственности. (с [[история изменений|версии]] 15.3, [http://serverprog:1090/browse/ESB-511 ESB-511]). | + | ; sector : по Абонентскому участку площадки формируется Зона ответственности. (с [[история изменений|версии]] 15.3, [http://serverprog:1090/browse/ESB-511 ESB-511]) |
+ | ; engineer : формирование зоны ответственности по свойству площадки - "инженер по учету" ([http://serverprog:1090/browse/ASDU-4645 ASDU-4645]) . | ||
В [[Перечень сокращений и обозначений#ИМУС|ИМУС]] по перечисленным сущностям создаётся пользователь (по первым двум словам, у нас ограничение на 20 символов длины). В описании пишется префикс "@AIS:" и далее полное ФИО (название участка). '''Пользователь НЕ имеет роли и определенного пароля, для его использования необходимо администратору задать пароль и назначить желаемую роль вручную!'''. Также, создается одноименная зона ответственности, тоже с префиксом "@AIS". | В [[Перечень сокращений и обозначений#ИМУС|ИМУС]] по перечисленным сущностям создаётся пользователь (по первым двум словам, у нас ограничение на 20 символов длины). В описании пишется префикс "@AIS:" и далее полное ФИО (название участка). '''Пользователь НЕ имеет роли и определенного пароля, для его использования необходимо администратору задать пароль и назначить желаемую роль вручную!'''. Также, создается одноименная зона ответственности, тоже с префиксом "@AIS". | ||
− | {{ ambox | text = Префиксы используется для явного отличения происхождения данных пользователей и зон, т.к. в данных сущностях у нас не предусмотрено [[ | + | {{ ambox | text = Префиксы используется для явного отличения происхождения данных пользователей и зон, т.к. в данных сущностях у нас не предусмотрено [[Создано в|полей кода системы]] потому что их импорт не предполагался }} |
| С [[история изменений|версии]] 14.10pre5. | | С [[история изменений|версии]] 14.10pre5. | ||
|- | |- | ||
Строка 162: | Строка 163: | ||
|- | |- | ||
| {{anchor|ais.ws.reportMaxErrors|ais_ws_reportMaxErrors}}ais.ws.reportMaxErrors || 500 || Максимальное количество проблемных объектов которое выводить в каждом коде ошибок. Остальные просто не будут показаны, т.к. чаще всего если атрибут не установлен для всех, то и список бесполезен || | | {{anchor|ais.ws.reportMaxErrors|ais_ws_reportMaxErrors}}ais.ws.reportMaxErrors || 500 || Максимальное количество проблемных объектов которое выводить в каждом коде ошибок. Остальные просто не будут показаны, т.к. чаще всего если атрибут не установлен для всех, то и список бесполезен || | ||
+ | |- | ||
+ | | {{anchor|ais.ws.checkDayMonthPlan|ais_ws_checkDayMonthPlan}}ais.ws.checkDayMonthPlan || true || Реализовано для загрузки газа ЭТП посуточно || | ||
|- | |- | ||
| {{anchor|ais.ws.attachPcToGcoConsists|ais_ws_attachPcToGcoConsists}}ais.ws.attachPcToGcoConsists || both || Изменяет поведение команды [[Команды адаптера#AttachPcToGco|AttachPcToGco]] выполнять расширенные функции для обратной совместимости и наличию одной команды в АРМе. Возможные значения: | | {{anchor|ais.ws.attachPcToGcoConsists|ais_ws_attachPcToGcoConsists}}ais.ws.attachPcToGcoConsists || both || Изменяет поведение команды [[Команды адаптера#AttachPcToGco|AttachPcToGco]] выполнять расширенные функции для обратной совместимости и наличию одной команды в АРМе. Возможные значения: | ||
Строка 169: | Строка 172: | ||
|[http://serverprog:1090/browse/SUPPORT-2265 SUPPORT-2265] | |[http://serverprog:1090/browse/SUPPORT-2265 SUPPORT-2265] | ||
|- | |- | ||
− | | {{anchor|ais.ws.debug|ais_ws_debug}}ais.ws.debug || false || Свойство адаптера debug, отвечающее за сохранение всего набора входящих элементов и элементов скрываемых в файл *.meta.xml | + | | {{anchor|ais.ws.debug|ais_ws_debug}}ais.ws.debug || false || Свойство адаптера debug, отвечающее за сохранение всего набора входящих элементов и элементов скрываемых в файл *.meta.xml. Также при этом сохранаются все входящие планы во временной таблице tmpais_cc_daily_plan - для анализа. Её можно затем почистить вручную в любой момент. |
| [http://serverprog:1090/browse/ESB-732 ESB-732] | | [http://serverprog:1090/browse/ESB-732 ESB-732] | ||
|- | |- | ||
| {{anchor|ais.ws.dvisAbsent|ais_ws_dvisAbsent}}ais.ws.dvisAbsent || || Список через запятую, какие [[команды адаптера]] будут удалять свои объекты, если они больше не приходят с сервиса. | | {{anchor|ais.ws.dvisAbsent|ais_ws_dvisAbsent}}ais.ws.dvisAbsent || || Список через запятую, какие [[команды адаптера]] будут удалять свои объекты, если они больше не приходят с сервиса. | ||
− | Какие объекты, каких команд, скрывать (dvis), если они больше не приходят из удалённой системы. По умолчанию ни один. Это [[ | + | Какие объекты, каких команд, скрывать (dvis), если они больше не приходят из удалённой системы. По умолчанию ни один. Это [[Общий порядок загрузки данных#Удалённые (помеченные удаленными) объекты|не синхронизация, пометки удаления]], работающая давно, речь именно о том чтобы скрыть объекты, которые больше не приходят для обновления (физически удалены или разорвана историческая связь). |
− | Каждый элемент в строке может также заканчиваться знаком +, тогда будут удаляться не пришедшие объекты данного типа | + | Каждый элемент в строке может также заканчиваться знаком +, тогда будут удаляться все не пришедшие объекты данного типа системы [[Внешняя система|АИС]] и в том числе [[Общий порядок загрузки данных#Генерация структуры вниз|сгенерированные]]! В обратном случае, [[Внешняя система|системы]] '*.ais' и [[Перечень сокращений и обозначений#Ид. в системе создателя|origId]] не начинается с префикса указывающего что объект генерированный ("gen:"). |
− | + | ||
− | Есть исключение, ConsType для скрытия должен указываться как ConsumerType по имени объекта в БД (исторически сложилось). | + | Есть исключение, ConsType для скрытия должен указываться как ConsumerType по имени объекта в БД (исторически сложилось) |
+ | |||
+ | Для скрытия ПДЗ существуют свои правила: | ||
+ | * При установленном свойстве ais.ws.dvisAbsent=Pdz скрываются только те объекты, у которых система создателя соответствует АИС | ||
+ | * При синхронизации восстанавливаются из dvis все пришедшие объекты, даже если они созданы не в АИС . | ||
+ | | | ||
+ | * С [[история изменений|версии]] адаптера 17.0.pre5. [http://serverprog:1090/browse/ESB-527 ESB-527]. | ||
+ | * [[Перечень сокращений и обозначений#ПМ|ПМ]] не скрывались до версии 18.4.pre47 адаптера, просто потому что у них не было атрибута dvis [http://serverprog:1090/browse/QUICK-4099 QUICK-4099]. | ||
+ | * Обработка признака генерированности объекта ("gen:") добавлена с [[version 19|версии 19.1.2]] - [https://jira.spb.ant-inform.ru/browse/ESB-1579 ESB-1579]. | ||
|- | |- | ||
| {{anchor|ais.ws.gasMetersAttachToAnyChannel|ais_ws_gasMetersAttachToAnyChannel}}ais.ws.gasMetersAttachToAnyChannel || false || При включении ИО будет помещено на любой (в общем случае не детерминировано на какой именно) канал от узла, если канал в [[Перечень сокращений и обозначений#АИС РГ|АИС РГ]] не указан, и данный узел имеет более одного канала (ошибка [[Налагаемые требования целостности, коды ошибок#code1606|1606]] в случае множественности). Никакой ошибки уже не будет. | | {{anchor|ais.ws.gasMetersAttachToAnyChannel|ais_ws_gasMetersAttachToAnyChannel}}ais.ws.gasMetersAttachToAnyChannel || false || При включении ИО будет помещено на любой (в общем случае не детерминировано на какой именно) канал от узла, если канал в [[Перечень сокращений и обозначений#АИС РГ|АИС РГ]] не указан, и данный узел имеет более одного канала (ошибка [[Налагаемые требования целостности, коды ошибок#code1606|1606]] в случае множественности). Никакой ошибки уже не будет. | ||
Строка 186: | Строка 196: | ||
|- | |- | ||
| {{anchor|ais.ws.replaceGenerated|ais_ws_replaceGenerated}}ais.ws.replaceGenerated || || Список через запятую, какие [[Общий порядок загрузки данных#Генерация структуры вниз|сгенерированные]] объекты должны замещаться в случае единственности. Возможные значения: [[Команды адаптера#Tuug|Tuug]], [[Команды адаптера#Equip|Equip]], [[Команды адаптера#Channel|Channel]]. | | {{anchor|ais.ws.replaceGenerated|ais_ws_replaceGenerated}}ais.ws.replaceGenerated || || Список через запятую, какие [[Общий порядок загрузки данных#Генерация структуры вниз|сгенерированные]] объекты должны замещаться в случае единственности. Возможные значения: [[Команды адаптера#Tuug|Tuug]], [[Команды адаптера#Equip|Equip]], [[Команды адаптера#Channel|Channel]]. | ||
− | Каждый элемент в строке может также заканчиваться знаком +, тогда будет заменён | + | Каждый элемент в строке может также заканчиваться знаком +, тогда будет заменён сгенерированный элемент в любой [[Внешняя система|системe]] (например в АРМе, системы *.imus) иначе замещаются только [[Общий порядок загрузки данных#Генерация структуры вниз|сгенерированные]] адаптером АИС (система *.ais). |
Алгоритм замещения следующий: | Алгоритм замещения следующий: | ||
* Если включено например для [[Перечень сокращений и обозначений#УУГ|узла]] ([[Команды адаптера#Tuug|Tuug]]), из [[Перечень сокращений и обозначений#АИС РГ|АИС]] на площадку приходит [[Перечень сокращений и обозначений#УУГ|УУГ]], но до этого на ней уже был сгенерирован 1 экземпляр. [[Общий порядок загрузки данных#Генерация структуры вниз|Сгенерированные]] соответственно имеет в [[Перечень сокращений и обозначений#orig_id|orig_id]] префикс "gen:" и этой опцией он будет '''замещён''' (как буд-то это он и был изначально, то есть на нём в том числе будет показываться потребление прошлых периодов, если оно было) импортируемым из [[Перечень сокращений и обозначений#АИС РГ|АИС РГ]]. | * Если включено например для [[Перечень сокращений и обозначений#УУГ|узла]] ([[Команды адаптера#Tuug|Tuug]]), из [[Перечень сокращений и обозначений#АИС РГ|АИС]] на площадку приходит [[Перечень сокращений и обозначений#УУГ|УУГ]], но до этого на ней уже был сгенерирован 1 экземпляр. [[Общий порядок загрузки данных#Генерация структуры вниз|Сгенерированные]] соответственно имеет в [[Перечень сокращений и обозначений#orig_id|orig_id]] префикс "gen:" и этой опцией он будет '''замещён''' (как буд-то это он и был изначально, то есть на нём в том числе будет показываться потребление прошлых периодов, если оно было) импортируемым из [[Перечень сокращений и обозначений#АИС РГ|АИС РГ]]. | ||
* Если на данной площадке имеется больше 1 [[Перечень сокращений и обозначений#УУГ|УУГ]], то будет [[Налагаемые требования целостности, коды ошибок#code5001|ошибка 5001]] и пришедший из [[Перечень сокращений и обозначений#АИС РГ|АИС РГ]] [[Перечень сокращений и обозначений#УУГ|УУГ]] не будет добавлен. | * Если на данной площадке имеется больше 1 [[Перечень сокращений и обозначений#УУГ|УУГ]], то будет [[Налагаемые требования целостности, коды ошибок#code5001|ошибка 5001]] и пришедший из [[Перечень сокращений и обозначений#АИС РГ|АИС РГ]] [[Перечень сокращений и обозначений#УУГ|УУГ]] не будет добавлен. | ||
− | * Если было указано с + ([[Команды адаптера#Tuug|Tuug]]+), то не смотря на наличие нескольких [[Перечень сокращений и обозначений#УУГ|узлов]], замещаются сгененрированные элементы из любой системы. При этом элемент "передаётся" в систему АИС (то есть изменяется поле | + | * Если было указано с + ([[Команды адаптера#Tuug|Tuug]]+), то не смотря на наличие нескольких [[Перечень сокращений и обозначений#УУГ|узлов]], замещаются сгененрированные элементы из любой системы. При этом элемент "передаётся" в [[Внешняя система|систему]] [[АИС]] (то есть изменяется поле [[Создано в]]). |
| С [[история изменений|версии]] адаптера 17.0.pre6. [http://serverprog:1090/browse/ESB-716 ESB-716]. | | С [[история изменений|версии]] адаптера 17.0.pre6. [http://serverprog:1090/browse/ESB-716 ESB-716]. | ||
|- | |- | ||
| {{anchor|ais.ws.doNotAccount0Plan|ais_ws_doNotAccount0Plan}}ais.ws.doNotAccount0Plan | | {{anchor|ais.ws.doNotAccount0Plan|ais_ws_doNotAccount0Plan}}ais.ws.doNotAccount0Plan | ||
+ | {{deprecated-inline|с [[история изменений|версии]] 1.8.33, 1.9.0.5 вместо этого предлагается [[#profile_tab__AccountZeroPlan|profile_tab AccountZeroPlan]] ([https://jira.spb.ant-inform.ru/browse/QUICK-7948 QUICK-7948]) }} | ||
| false | | false | ||
| Не учитывать 0 план для актуальности [[Перечень сокращений и обозначений#Субъект распределения|субъектов распределения]]. | | Не учитывать 0 план для актуальности [[Перечень сокращений и обозначений#Субъект распределения|субъектов распределения]]. | ||
Строка 204: | Строка 215: | ||
| | | | ||
; Tuug : искать единственный канал от [[Перечень сокращений и обозначений#УУГ|УУГ]] | ; Tuug : искать единственный канал от [[Перечень сокращений и обозначений#УУГ|УУГ]] | ||
− | ; GasConsObject : искать единственный канал от Площадки | + | ; GasConsObject : искать единственный нескрытый канал от Площадки |
| С [[история изменений#18.4|версии адаптера 18.4.pre6]] [https://jira.spb.ant-inform.ru/browse/ESB-910 ESB-910]. | | С [[история изменений#18.4|версии адаптера 18.4.pre6]] [https://jira.spb.ant-inform.ru/browse/ESB-910 ESB-910]. | ||
+ | |- | ||
+ | | {{anchor|ais.ws.debtMore|ais_ws_debtMore}}ais.ws.debtMore || 0 || Параметр для Импорта ПДЗ Долг контрагента более || | ||
+ | |- | ||
+ | | {{anchor|ais.ws.realizationType|ais_ws_realizationType}}ais.ws.realizationType || 8 || Параметр для Импорта ПДЗ Вид реализации газа || | ||
|- | |- | ||
| {{anchor|ais.serviceProvider|ais_serviceProvider}}ais.serviceProvider | | {{anchor|ais.serviceProvider|ais_serviceProvider}}ais.serviceProvider | ||
Строка 213: | Строка 228: | ||
|- | |- | ||
| {{anchor|ais.ws.errorPriorities.notFound|ais_ws_errorPriorities_notFound}}ais.ws.errorPriorities.notFound | | {{anchor|ais.ws.errorPriorities.notFound|ais_ws_errorPriorities_notFound}}ais.ws.errorPriorities.notFound | ||
− | | 201:FATAL,401:WARNING,402:WARNING,406:WARNING,­501:WARNING,603:FATAL,701:WARNING,702:FATAL,­801:FATAL,803:WARNING,805:WARNING,901:FATAL,­903:FATAL,904:WARNING,1001:FATAL,1020:FATAL,­1201:WARNING,1202:FATAL,1301:FATAL,1401:WARNING,­1501:FATAL,1502:FATAL,1506_1:WARNING,1506_2:WARNING,­1506_3:WARNING,1506_4:WARNING,1561:WARNING,1601:WARNING,­1605:WARNING,1606_1: | + | | 201:FATAL,­401:WARNING,­402:WARNING,­406:WARNING,­501:WARNING,­601:WARNING,­603:FATAL,605:WARNING,­­701:WARNING,­702:FATAL,­801:FATAL,­803:WARNING,­805:WARNING,­901:FATAL,­902:FATAL,­903:FATAL,­904:WARNING,­1001:FATAL,­1020:FATAL,­1201:WARNING,­1202:FATAL,­1301:FATAL,­1401:WARNING,­1501:FATAL,­1502:FATAL,­1506_1:WARNING,­1506_2:WARNING,­1506_3:WARNING,­1506_4:WARNING,­1561:WARNING,­1601:WARNING,­1605:WARNING,­1606_1:WARNING,­1606_3:WARNING,­1701:WARNING,­1702:WARNING,­1703:FATAL,­1705:WARNING,­1851:FATAL,­1852:FATAL,­1901:WARNING,­1903:FATAL,­1904:FATAL,­1905:WARNING,­1906:WARNING,­1907:WARNING,­1908:FATAL,­2001:WARNING,­2002:WARNING,­2003:WARNING,­2004:WARNING,­2006:WARNING,­2007:WARNING,­2201:FATAL,­2201_1:FATAL,­2202:FATAL,­2203:FATAL,­2204:FATAL,­2205:FATAL,­2206:FATAL,­2207:FATAL,­5001:FATAL,­5003:WARNING,­10000:ERROR,­1582:WARNING,­2301:ERROR,­2302:ERROR,­2303:ERROR,­2304:ERROR,­2305:ERROR,­2401:ERROR,­2402:ERROR,­2403:ERROR,­2501:ERROR,­2502:ERROR,­2503:ERROR |
− | | Установка [[Фатальность ошибок|фатальности ошибок]] в которых речь о том что объект не найден по идентификатору. Чтобы переопределить отдельные значения предпочтительна короткая форма, например: '''ais.ws.errorPriorities.notFound=[[Налагаемые требования целостности, коды ошибок#code903_1|903_1]]:WARNING''' - то есть будут загружены [[Перечень сокращений и обозначений#ТП|ТП]] без выходов ГРС (с пустым [[Перечень сокращений и обозначений#Канал|каналом]] поставки), при этом в [[Общий порядок загрузки данных#Отчёт о состоянии синхронизации|отчёте]], если не [[#ais.ws.muteErrors|отключена]], появится [[Налагаемые требования целостности, коды ошибок#code903_1|ошибка 903_1]] с важностью WARNING. По умолчанию такие [[Перечень сокращений и обозначений#ТП|ТП]] не загружаются. Обратный пример повышения уровня: '''ais.ws.errorPriorities.notFound=[[Налагаемые требования целостности, коды ошибок#code1905|1905]]:FATAL'''. В таком случае не будут загружены [[Команды адаптера#CcDailyPlan|планы]], в которых не указана [[Перечень сокращений и обозначений#Договор закупки|поставка]]<ref>Это может быть весьма полезно если вы хотите исправлять ошибки, и не разбираться потом с дублями [[Перечень сокращений и обозначений#Субъект распределения|СР]], возникающих при повторной загрузке исправленных планов, как например запрашивал Рустам Фарукшин из Уфы</ref>. | + | | Строка без пробелов, через запятую перечисленными парами (разделёнными двоеточием). Установка [[Фатальность ошибок|фатальности ошибок]] в которых речь о том что объект не найден по идентификатору. Чтобы переопределить отдельные значения предпочтительна короткая форма, например: '''ais.ws.errorPriorities.notFound=[[Налагаемые требования целостности, коды ошибок#code903_1|903_1]]:WARNING''' - то есть будут загружены [[Перечень сокращений и обозначений#ТП|ТП]] без выходов ГРС (с пустым [[Перечень сокращений и обозначений#Канал|каналом]] поставки), при этом в [[Общий порядок загрузки данных#Отчёт о состоянии синхронизации|отчёте]], если не [[#ais.ws.muteErrors|отключена]], появится [[Налагаемые требования целостности, коды ошибок#code903_1|ошибка 903_1]] с важностью WARNING. По умолчанию такие [[Перечень сокращений и обозначений#ТП|ТП]] не загружаются. Обратный пример повышения уровня: '''ais.ws.errorPriorities.notFound=[[Налагаемые требования целостности, коды ошибок#code1905|1905]]:FATAL'''. В таком случае не будут загружены [[Команды адаптера#CcDailyPlan|планы]], в которых не указана [[Перечень сокращений и обозначений#Договор закупки|поставка]]<ref>Это может быть весьма полезно если вы хотите исправлять ошибки, и не разбираться потом с дублями [[Перечень сокращений и обозначений#Субъект распределения|СР]], возникающих при повторной загрузке исправленных планов, как например запрашивал Рустам Фарукшин из Уфы</ref>. |
| rowspan="3" | С [[Version 18|версии адаптера 18.4.pre34]] - [https://jira.spb.ant-inform.ru/browse/ESB-1313 ESB-1313]. | | rowspan="3" | С [[Version 18|версии адаптера 18.4.pre34]] - [https://jira.spb.ant-inform.ru/browse/ESB-1313 ESB-1313]. | ||
|- | |- | ||
| {{anchor|ais.ws.errorPriorities.notMapped|ais_ws_errorPriorities_notMapped}}ais.ws.errorPriorities.notMapped | | {{anchor|ais.ws.errorPriorities.notMapped|ais_ws_errorPriorities_notMapped}}ais.ws.errorPriorities.notMapped | ||
− | | 201_1:FATAL,401_1:WARNING,402_1:WARNING,501_1:WARNING,­603_1:WARNING,803_1:WARNING,904_1:WARNING,1201_1:FATAL,­1561_1:WARNING,1701_1:WARNING,1705_1:WARNING,1906_1:WARNING,­2001_1:WARNING,2002_1:WARNING,2003_1:WARNING,­2004_1:WARNING | + | | 201_1:FATAL,­401_1:WARNING,­402_1:WARNING,­501_1:WARNING,­601_1:WARNING,­603_1:WARNING,­605_1:WARNING,­803_1:WARNING,­904_1:WARNING,­1201_1:FATAL,­1561_1:WARNING,­1701_1:WARNING,­1705_1:WARNING,­1901_1:WARNING,­1906_1:WARNING,­2001_1:WARNING,­2002_1:WARNING,­2003_1:WARNING,­2004_1:WARNING |
| Установка фатальности ошибок в которых речь о том что объект не [[Перечень сокращений и обозначений#Маппинг (связывание)|замаплен]]. | | Установка фатальности ошибок в которых речь о том что объект не [[Перечень сокращений и обозначений#Маппинг (связывание)|замаплен]]. | ||
|- | |- | ||
| {{anchor|ais.ws.errorPriorities.notSingle|ais_ws_errorPriorities_notSingle}}ais.ws.errorPriorities.notSingle | | {{anchor|ais.ws.errorPriorities.notSingle|ais_ws_errorPriorities_notSingle}}ais.ws.errorPriorities.notSingle | ||
− | | 903_1:WARNING,1606_2:WARNING | + | | 903_1:WARNING,­903_2:WARNING,­1606_2:WARNING,­1853:FATAL,­1853_1:FATAL |
| Установка фатальности ошибок поиска однозначного соответствия. | | Установка фатальности ошибок поиска однозначного соответствия. | ||
|} | |} | ||
Строка 234: | Строка 249: | ||
| {{anchor|md.manager.sysCode|md_manager_sysCode}}<strike>md.manager.sysCode</strike> | | {{anchor|md.manager.sysCode|md_manager_sysCode}}<strike>md.manager.sysCode</strike> | ||
{{deprecated-inline|с [[история изменений|версии]] 14.10}} | {{deprecated-inline|с [[история изменений|версии]] 14.10}} | ||
− | | || | + | | || [[Внешняя система|Cистема]] от которой работает адаптер. || Сейчас должно использоваться [[#settings.codesystem|settings.codesystem]] |
|- | |- | ||
| {{anchor|md.manager.defaultDistrict.id|md_manager_defaultDistrict_id}}<strike>md.manager.defaultDistrict.id</strike> | | {{anchor|md.manager.defaultDistrict.id|md_manager_defaultDistrict_id}}<strike>md.manager.defaultDistrict.id</strike> | ||
Строка 277: | Строка 292: | ||
| {{anchor|ais.ws.policy.oldBehaveModifiedObjectDoesNotTouched|ais_ws_policy_oldBehaveModifiedObjectDoesNotTouched}}<s>ais.ws.policy.oldBehaveModifiedObjectDoesNotTouched</s> | | {{anchor|ais.ws.policy.oldBehaveModifiedObjectDoesNotTouched|ais_ws_policy_oldBehaveModifiedObjectDoesNotTouched}}<s>ais.ws.policy.oldBehaveModifiedObjectDoesNotTouched</s> | ||
{{deprecated-inline|с [[история изменений|версии]] ~16.0 [http://serverprog:1090/browse/ESB-592 ESB-592]}} | {{deprecated-inline|с [[история изменений|версии]] ~16.0 [http://serverprog:1090/browse/ESB-592 ESB-592]}} | ||
− | | true || Режим обновления объектов. По умолчанию используется старый режим (true) когда при изменении объекта в ИМУС (или любой другой системой), он полностью исключается из дальнейшего обновления (синхронизации). По значению false все синхронизируемые с АИС поля будут перезаписываться всегда. | + | | true || Режим обновления объектов. По умолчанию используется старый режим (true) когда при изменении объекта в [[ИМУС]] (или любой другой [[Внешняя система|системой]]), он полностью исключается из дальнейшего обновления (синхронизации). По значению false все синхронизируемые с АИС поля будут перезаписываться всегда. |
|[http://serverprog:1090/browse/ESB-391 ESB-391]. С версии адаптера 14.9.5 | |[http://serverprog:1090/browse/ESB-391 ESB-391]. С версии адаптера 14.9.5 | ||
Не используется с [[история изменений|версии]] ~16.0 [http://serverprog:1090/browse/ESB-592 ESB-592] | Не используется с [[история изменений|версии]] ~16.0 [http://serverprog:1090/browse/ESB-592 ESB-592] | ||
Строка 323: | Строка 338: | ||
| ais.ws.export.format.PcDay31d.fields || CONS_OID,CONS_SYS,CONS_NAME,​PC_OID,PC_SYS,PC_NAME,GCO_OID,GCO_SYS,​GCO_NAME,CORR_TIME,Q,SIGN_DATE || Список полей для выгрузки, через запятую, для указанной команды. * - означает все. [http://jira.spb.ant-inform.ru:1090/browse/ESB-727 ESB-727] | | ais.ws.export.format.PcDay31d.fields || CONS_OID,CONS_SYS,CONS_NAME,​PC_OID,PC_SYS,PC_NAME,GCO_OID,GCO_SYS,​GCO_NAME,CORR_TIME,Q,SIGN_DATE || Список полей для выгрузки, через запятую, для указанной команды. * - означает все. [http://jira.spb.ant-inform.ru:1090/browse/ESB-727 ESB-727] | ||
|- | |- | ||
− | | ais.ws.export.format.ContrDay31d.fields || CONS_OID,CONS_SYS,CONS_NAME,​PC_OID,PC_SYS,PC_NAME,PRMARK_OID,PRMARK_SYS,​PR_MARK_NAME,CONTR_OID,CONTR_SYS,CONTRACT_NUM,​CORR_TIME,Q,LAST_CHANGED_DATE || Список полей для выгрузки, через запятую, для указанной команды. * - означает все. [http://jira.spb.ant-inform.ru:1090/browse/ESB- | + | | ais.ws.export.format.ContrDay31d.fields || CONS_OID,CONS_SYS,CONS_NAME,​PC_OID,PC_SYS,PC_NAME,PRMARK_OID,PRMARK_SYS,​PR_MARK_NAME,CONTR_OID,CONTR_SYS,CONTRACT_NUM,​CORR_TIME,Q,LAST_CHANGED_DATE,PCONTR_OID,​PCONTR_SYS,PCONTR_NUM, || Список полей для выгрузки, через запятую, для указанной команды. * - означает все. [http://jira.spb.ant-inform.ru:1090/browse/ESB-3999 ESB-3999] |
|- | |- | ||
− | | ais.ws.export.format.ContrMonth2p.fields || CONS_OID,CONS_SYS,CONS_NAME,​PC_OID,PC_SYS,PC_NAME,PRMARK_OID,​PRMARK_SYS,PR_MARK_NAME,CONTR_OID,CONTR_SYS,​CONTRACT_NUM,CORR_TIME,Q,LAST_CHANGED_DATE || Список полей для выгрузки, через запятую, для указанной команды. * - означает все. [http://jira.spb.ant-inform.ru:1090/browse/ESB- | + | | ais.ws.export.format.ContrMonth2p.fields || CONS_OID,CONS_SYS,CONS_NAME,​PC_OID,PC_SYS,PC_NAME,PRMARK_OID,​PRMARK_SYS,PR_MARK_NAME,CONTR_OID,CONTR_SYS,​CONTRACT_NUM,CORR_TIME,Q,LAST_CHANGED_DATE,PCONTR_OID,​PCONTR_SYS,PCONTR_NUM || Список полей для выгрузки, через запятую, для указанной команды. * - означает все. [http://jira.spb.ant-inform.ru:1090/browse/ESB-3999 ESB-3999] |
|- | |- | ||
| ais.ws.export.format.PcHour7d.date || yyyy-MM-dd HH:mm:ss || Форматирование даты для соответствующей команды. В стиле [http://docs.oracle.com/javase/6/docs/api/java/text/SimpleDateFormat.html SimpleDateFormat]. [http://jira.spb.ant-inform.ru:1090/browse/ESB-727 ESB-727]. С [[история изменений|версии]] 17.0. | | ais.ws.export.format.PcHour7d.date || yyyy-MM-dd HH:mm:ss || Форматирование даты для соответствующей команды. В стиле [http://docs.oracle.com/javase/6/docs/api/java/text/SimpleDateFormat.html SimpleDateFormat]. [http://jira.spb.ant-inform.ru:1090/browse/ESB-727 ESB-727]. С [[история изменений|версии]] 17.0. | ||
Строка 383: | Строка 398: | ||
|- | |- | ||
| UMPressureB || kgs/cm2pb || Базовая единица измерения для перепада давления | | UMPressureB || kgs/cm2pb || Базовая единица измерения для перепада давления | ||
+ | |- | ||
+ | | {{anchor|profile_tab__AccountZeroPlan}}AccountZeroPlan || false || Использовать или нет 0 [[Команды адаптера#CcDailyPlan|план]] для актуальности [[СР]]. До [[Version 19|версии "19.4>(trunk - [https://jira.spb.ant-inform.ru/browse/QUICK-7948 QUICK-7948])"]] использовалась локальная опция [[#ais.ws.doNotAccount0Plan|ais.ws.doNotAccount0Plan]] | ||
|} | |} | ||
== Примечания == | == Примечания == | ||
<references/> | <references/> |
Текущая версия на 14:36, 5 декабря 2019
Содержание
Опции конфигурирования адаптера
Обязательные к заполнению на каждой РГК
Данные опции не имеют значений по умолчанию, и обязательно должны быть заданы для функционирования адаптера.
Опция конфигурации | Описание |
---|---|
Для АИС[1] | |
ais.ws.url | URL Веб-сервиса. Если[2] не начинается на http, префикс http:// предполагается. |
ais.ws.user | Пользователь для доступа |
ais.ws.password | Пароль. До версии 17 просьба не использовать символ @ и кавычек. |
settings.codesystem | Код системы, от которой будет работать адаптер. Например "tverrgmain.ais". |
Для ITS[1] | |
its.jdbc.driverClassName | Класс JDBC драйвера для доступа к БД (по умолчанию oracle.jdbc.driver.OracleDriver) |
its.jdbc.url | Строка коннекта к БД (jdbc:oracle:thin:@localhost:1521:ascug) |
its.jdbc.username | Логин доступа |
its.jdbc.password | Пароль для доступа |
its.jdbc.tablePattern | Шаблон именования таблиц. По умолчанию ascug.%s@new_its. Прежде всего для целей тестирования. |
Опции которые могут быть оставлены со значениями по умолчанию
Переопределяются при необходимости. Если не указаны в файле ais.properties - используются представленные ниже параметры
Опция конфигурации | Значение по умолчанию | Описание | Доп. Инфо | ||
---|---|---|---|---|---|
md.manager.cmdconf.in | AIS.CMDCONF.IN | Очередь JMS для посылки текстовых комманд (например через amq-command) | |||
jms.cmd.queue | AIS.CMD.IN | То же что и параметр выше, для прямых комманд в формате XML | |||
ais.ws.partialLog | 2 | Включение отдельного лога для каждой команды в директории md. Будет создаваться и каждый раз перезаписываться согласно имени команды, например Region.log.
Удобно использовать для внедрения и поиска ошибок, особенно совместно с md.manager.logData=true Возможные значения:
|
ESB-341 | ||
ais.ws.useOrigIdFusion | false | Если true - в orig_id используется полная связка "UID:code:foreignKey", в обратном случае только UID.
|
|||
|
false | Значение true может использоваться временно для миграции с файлового адаптера, когда требуется обновление кодов. При этом будет осуществляться обновление orig_id перед любой другой обработкой. См. также параметр ais.ws.migrate.OrigIdsToUID_Field | |||
|
code | Если ais.ws.migrate.OrigIdsToUID установлено в true, то значение отсюда будет иметь следующее значение при миграции: | Значение регистрозависимое | ||
ais.ws.report.to | aisreports@spb.ant-inform.ru | Список через запятую, без пробелов - email-адресов получателей отчёта по команде Report. Используется если для команды не задан другой в момент вызова. | |||
ais.ws.report.subject | IMUS-ais report for %1$s | Тема письма отчёта о состоянии. Первый подстановочный плэйсхолдер (%1$s), если присутствует, будет заменён на имя системы из settings.codesystem | |||
ais.ws.directByPC | 0 | Признак забирать Точки Подключения напрямую из справочников, вместо регистров. Для случая когда не ведутся площадки. Т.к. площадки не вести никто не разрешал, специального параметра конфигурации для этого нету, и соответственно такой случай автоматически не определить. Использование регистра предпочтительнее - там есть активность объектов, и не забирается мусор.
Может принимать следующие значения:
|
|||
ais.ws.generateFromOutDown | true | Генерировать ли структуру вниз от Выходов ГРС (УУГ, Корректор, Канал). Реализован забор и их узлов, если они есть для поставки. Но в подавляющем большинстве случаев это просто не нужно. Если включено, работает быстрее. | |||
ais.ws.telemetryUugOuterRelation | Параметр конфигурации для команды AutoImusMapTelemetry. Значение - разделенные запятой пары "система_в_аис:система_имус". Пробелы не допускаются. Все имена должны быть в нижнем регистре. Для русского текста должна использоваться Java-нотация вида \u (например "стел" = "\u0441\u0442\u0435\u\043b")
Специальная система ИМУС с именем 'skip' позволяет проигнорировать системы которые не нужны. Будет отдельный код ошибки 2201_1. |
Псевдо система skip добавлена в версии 17.0. ESB-751. | |||
ais.ws.muteErrors | Отключение пометки в объектах указанных через запятую кодов ошибок.
Для следующих кодов это имеет дополнительное значение: |
Доступно с версии адаптера 14.4.1 | |||
ais.ws.gceAttachToAnyChannel | false | Если установлено в true - ГПО вешается на любой нескрытый канал площадки, когда его больше 1, иначе (по умолчанию) только на единственный. ГПО на скрытый канал не вешается никогда, даже если такой канал единственный. Если скрытый канал единственный и уже загруженный на этот канал, то связь не сбрасывается, в логе ошибка 1506_3. Если скрытый канал не единственный, то устанавливается связь с нескрытым каналом. Если это первая загрузка ГПО, то связи с каналом не будет, в логе ошибка 1506_3 | |||
ais.ws.genGCOonlyByPC | false | Способ генерации Площадок командой GenGcoFromPcAndConsumer | Сделано для Мордовии чтобы площадки перевешивались ESB-364. Доступно с версии 14.7. | ||
ais.ws.forbiddenTasks | Список задач (имён команд адаптера), запрещенных к выполнению на системе, чтобы не загружался скажем мусор или не возможно было выполнить случайно из АРМа. Список команд через запятую. | С версии адаптера 14.10.pre2. ESB-405 | |||
ais.ws.distributePlansFromMonth | false | Если не ведётся разбивка планов в АИС по суткам (тогда на первом числе месяца указан весь месячный план), необходимо выставить в true чтобы разбивалось в ИМУС в момент импорта. Используется алгоритм целочисленного разбиения - "пила" из домена. (Можно было бы попробовать детектировать такой режим автоматически из конфигурации, но пока в Краснодаре, первом объекте где это нужно, нету доступа к данным константам). | ESB-425. С версии адаптера 14.10pre4 | ||
ais.ws.responseZonesBy | Используется в операции загрузки площадок. По умолчанию отключено. Возможные значения:
В ИМУС по перечисленным сущностям создаётся пользователь (по первым двум словам, у нас ограничение на 20 символов длины). В описании пишется префикс "@AIS:" и далее полное ФИО (название участка). Пользователь НЕ имеет роли и определенного пароля, для его использования необходимо администратору задать пароль и назначить желаемую роль вручную!. Также, создается одноименная зона ответственности, тоже с префиксом "@AIS".
|
С версии 14.10pre5. | |||
ais.ws.custom.gcoNamePattern | %1s | Используется в операции загрузки площадок для формирования имени. Можно использовать следующие подстановочные элементы:
|
ESB-496, ESB-551, ESB-560 | ||
ais.ws.custom.gcoNamePatternMove | %1$s (%5$s) | Используется в операции загрузки площадок для формирования имени. Можно использовать следующие подстановочные элементы:
|
ESB-496, ESB-551, ESB-560 | ||
ais.ws.custom.tuugNamePattern | %1$s | Используется в операции загрузки узлов для формирования имени. Можно использовать следующие подстановочные элементы:
|
QUICK-3830. С версии 17.0. | ||
ais.ws.custom.pcNamePattern | %1$s | Используется в операции загрузки ТП для формирования имени. Можно использовать следующие подстановочные элементы:
|
ESB-1317. С версии адаптера 18.4.pre35. | ||
ais.ws.custom.genUugName | %1$s | Формат имени узла при генерации от площадки.
|
ESB-528. С версии адаптера 15.7.1. | ||
ais.ws.custom.genEquipName | %1$s | Формат имени корректора при генерации от узла.
|
ESB-528. С версии адаптера 15.7.1. | ||
ais.ws.custom.genChannelName | %1$s | Формат имени канала при генерации от корректора.
|
ESB-528. С версии адаптера 15.7.1. | ||
ais.ws.prcLimitAddition | 0 | База для корректировки корректировки коридоров договоров. Если выставлено в ненулевое значение (чаще всего 100), то перебор к нему будет прибавляться, а недобор вычитаться из него. Суть в том что можно указать перебор/недобор как: 5%/10% (то есть от разрешенного плана), а можно 95%/110% как разрешенное количество процентов плана. Т.к. нам требуется последняя форма, выполняем соответствующее преобразование. | ESB-524 | ||
ais.ws.reportMaxErrors | 500 | Максимальное количество проблемных объектов которое выводить в каждом коде ошибок. Остальные просто не будут показаны, т.к. чаще всего если атрибут не установлен для всех, то и список бесполезен | |||
ais.ws.checkDayMonthPlan | true | Реализовано для загрузки газа ЭТП посуточно | |||
ais.ws.attachPcToGcoConsists | both | Изменяет поведение команды AttachPcToGco выполнять расширенные функции для обратной совместимости и наличию одной команды в АРМе. Возможные значения:
|
SUPPORT-2265 | ||
ais.ws.debug | false | Свойство адаптера debug, отвечающее за сохранение всего набора входящих элементов и элементов скрываемых в файл *.meta.xml. Также при этом сохранаются все входящие планы во временной таблице tmpais_cc_daily_plan - для анализа. Её можно затем почистить вручную в любой момент. | ESB-732 | ||
ais.ws.dvisAbsent | Список через запятую, какие команды адаптера будут удалять свои объекты, если они больше не приходят с сервиса.
Какие объекты, каких команд, скрывать (dvis), если они больше не приходят из удалённой системы. По умолчанию ни один. Это не синхронизация, пометки удаления, работающая давно, речь именно о том чтобы скрыть объекты, которые больше не приходят для обновления (физически удалены или разорвана историческая связь). Каждый элемент в строке может также заканчиваться знаком +, тогда будут удаляться все не пришедшие объекты данного типа системы АИС и в том числе сгенерированные! В обратном случае, системы '*.ais' и origId не начинается с префикса указывающего что объект генерированный ("gen:"). Есть исключение, ConsType для скрытия должен указываться как ConsumerType по имени объекта в БД (исторически сложилось) Для скрытия ПДЗ существуют свои правила:
|
| |||
ais.ws.gasMetersAttachToAnyChannel | false | При включении ИО будет помещено на любой (в общем случае не детерминировано на какой именно) канал от узла, если канал в АИС РГ не указан, и данный узел имеет более одного канала (ошибка 1606 в случае множественности). Никакой ошибки уже не будет.
|
ESB-690 | ||
ais.ws.replaceGenerated | Список через запятую, какие сгенерированные объекты должны замещаться в случае единственности. Возможные значения: Tuug, Equip, Channel.
Каждый элемент в строке может также заканчиваться знаком +, тогда будет заменён сгенерированный элемент в любой системe (например в АРМе, системы *.imus) иначе замещаются только сгенерированные адаптером АИС (система *.ais). Алгоритм замещения следующий:
|
С версии адаптера 17.0.pre6. ESB-716. | |||
ais.ws.doNotAccount0Plan
(deprecated in с версии 1.8.33, 1.9.0.5 вместо этого предлагается profile_tab AccountZeroPlan (QUICK-7948)) |
false | Не учитывать 0 план для актуальности субъектов распределения.
С версии адаптера 18.25 ESB-985 изменены умолчания и 0 план перестал учитываться для субъекта распределения для его активности[3]. Это вызвало множество недовольства. С версии адаптера 18.28 ESB-1067 умолчание возвращается обратно, а данной опцией в true можно включить затребованное ранее решение: Дата действия субъекта ставится по последнему ненулевому плану, и если нету ненулевых планов - он скрывается. |
С версии адаптера 18.28 ESB-1067 | ||
ais.ws.gceChannelBy | Tuug |
|
С версии адаптера 18.4.pre6 ESB-910. | ||
ais.ws.debtMore | 0 | Параметр для Импорта ПДЗ Долг контрагента более | |||
ais.ws.realizationType | 8 | Параметр для Импорта ПДЗ Вид реализации газа | |||
ais.serviceProvider | imus.ais.service.AisService | Задание провайдера данных. По умолчанию - АИС. Поддержка системы ITS для ПРГ и включается значением imus.its.service.ItsService. При этом также должны быть сконфигурированы опции its.*. | С версии адаптера 18.4.pre32 - KUPRG-6. | ||
ais.ws.errorPriorities.notFound | 201:FATAL,401:WARNING,402:WARNING,406:WARNING,501:WARNING,601:WARNING,603:FATAL,605:WARNING,701:WARNING,702:FATAL,801:FATAL,803:WARNING,805:WARNING,901:FATAL,902:FATAL,903:FATAL,904:WARNING,1001:FATAL,1020:FATAL,1201:WARNING,1202:FATAL,1301:FATAL,1401:WARNING,1501:FATAL,1502:FATAL,1506_1:WARNING,1506_2:WARNING,1506_3:WARNING,1506_4:WARNING,1561:WARNING,1601:WARNING,1605:WARNING,1606_1:WARNING,1606_3:WARNING,1701:WARNING,1702:WARNING,1703:FATAL,1705:WARNING,1851:FATAL,1852:FATAL,1901:WARNING,1903:FATAL,1904:FATAL,1905:WARNING,1906:WARNING,1907:WARNING,1908:FATAL,2001:WARNING,2002:WARNING,2003:WARNING,2004:WARNING,2006:WARNING,2007:WARNING,2201:FATAL,2201_1:FATAL,2202:FATAL,2203:FATAL,2204:FATAL,2205:FATAL,2206:FATAL,2207:FATAL,5001:FATAL,5003:WARNING,10000:ERROR,1582:WARNING,2301:ERROR,2302:ERROR,2303:ERROR,2304:ERROR,2305:ERROR,2401:ERROR,2402:ERROR,2403:ERROR,2501:ERROR,2502:ERROR,2503:ERROR | Строка без пробелов, через запятую перечисленными парами (разделёнными двоеточием). Установка фатальности ошибок в которых речь о том что объект не найден по идентификатору. Чтобы переопределить отдельные значения предпочтительна короткая форма, например: ais.ws.errorPriorities.notFound=903_1:WARNING - то есть будут загружены ТП без выходов ГРС (с пустым каналом поставки), при этом в отчёте, если не отключена, появится ошибка 903_1 с важностью WARNING. По умолчанию такие ТП не загружаются. Обратный пример повышения уровня: ais.ws.errorPriorities.notFound=1905:FATAL. В таком случае не будут загружены планы, в которых не указана поставка[4]. | С версии адаптера 18.4.pre34 - ESB-1313. | ||
ais.ws.errorPriorities.notMapped | 201_1:FATAL,401_1:WARNING,402_1:WARNING,501_1:WARNING,601_1:WARNING,603_1:WARNING,605_1:WARNING,803_1:WARNING,904_1:WARNING,1201_1:FATAL,1561_1:WARNING,1701_1:WARNING,1705_1:WARNING,1901_1:WARNING,1906_1:WARNING,2001_1:WARNING,2002_1:WARNING,2003_1:WARNING,2004_1:WARNING | Установка фатальности ошибок в которых речь о том что объект не замаплен. | |||
ais.ws.errorPriorities.notSingle | 903_1:WARNING,903_2:WARNING,1606_2:WARNING,1853:FATAL,1853_1:FATAL | Установка фатальности ошибок поиска однозначного соответствия. |
Устаревшие опции
Их использование не рекомендуется, некоторые уже полностью исключены (указывается версия) и не обрабатываются.
Опция конфигурации | Значение по умолчанию | Описание | Доп. Инфо |
---|---|---|---|
(deprecated in с версии 14.10) |
Cистема от которой работает адаптер. | Сейчас должно использоваться settings.codesystem | |
(deprecated in с версии 14.10) |
ID Федерального Округа РФ, в котором работает РГК (из таблицы district) | Сейчас берётся из настроек БД | |
(deprecated in с версии 14.10) |
ID РГК (из таблицы rgc) | Сейчас берётся из настроек БД | |
(deprecated in с версии 14.10) |
imus.common | owner_code_system региона (из таблицы region). | Сейчас берётся из настроек БД |
(deprecated in с версии 14.10) |
ID региона РГК (из таблицы rgc) | Сейчас берётся из настроек БД | |
|
true | Не импортировать помеченные на удаление объекты из АИС, если их еще нету в ИМУС. Если объект был загружен, и в следующий раз пришел помеченным на удаление, он в любом случае обновляется, в том числе становится скрытым (dvis=1) | Больше не используется с версии ~16.0 ESB-592 |
|
false | Если true - не будут создаваться метаобъекты с иерархией для тех объектов, где грузятся сами объекты, а не меты (ПМ) | ESB-308 |
|
true | Отключение кеширования в компоненте ДатаМаппер. Отключение может сэкономить немного памяти, требуемой адаптеру, но ведет к замедлению работы | Больше не используется с версии ~16.0 ESB-592 |
|
false | Отключение кеша объектов по XML хранилищу из md. Замедляет работу, но рекомендуется на этапе внедрения чтобы не очищать их вручную. НЕ используется для команд RunTask (всевозможные маппинги и автосвязки), влияет только на импорт объектов ( ESB-341. Заменило старое ais.ws.disableCache (ESB-351) | Больше не используется с версии ~16.0 (ESB-592) |
|
true | Режим обновления объектов. По умолчанию используется старый режим (true) когда при изменении объекта в ИМУС (или любой другой системой), он полностью исключается из дальнейшего обновления (синхронизации). По значению false все синхронизируемые с АИС поля будут перезаписываться всегда. | ESB-391. С версии адаптера 14.9.5
Не используется с версии ~16.0 ESB-592 Удалена с адаптера 18.4.pre1, ESB-1040 |
(deprecated in с адаптера 18.4.pre38 ESB-1325) |
Если задано не пустое значение, объекты будут помечаться ошибками в БД по указанному шаблону формируя имя.
|
С версий адаптера 18.4.pre13, 18.31 умолчание сменено на пустое значение (не метить ничего ошибками в БД). Для возврата к предыдущему поведению можно задать "Error:%1$s:%2$s" ESB-1155.
Удалена с адаптера 18.4.pre38, ESB-1325 | |
(deprecated in с адаптера 18.4.pre38 ESB-1325) |
true | Помечать ошибками Выходы ГРС (не указанные ГРО и Регион) (значение false) или нет (true) | ESB-334.
Удалена с адаптера 18.4.pre38, ESB-1325 |
(deprecated in с адаптера 18.4.pre38 ESB-1325) |
false | Выводить все пришедшие и сконвертированные данные. Может несколько замедлять работу. Прежде всего для траблешутинга. Сейчас есть более удобное средство - ais.ws.debug | Удалена с адаптера 18.4.pre38, ESB-1325 |
Параметры экспорта
Опция конфигурации | Значение по умолчанию | Описание |
---|---|---|
ais.file.dir | D:\AIS | Директория для экспорта CSV файлов объема |
export.task1.name | Первая задача экспорта. С версии 17.0 умолчание очищено, было: cmdpack:DumpQ_PcDay31d | |
export.task1.cron | 0 0 4 * * ? | Время выполнения первой задачи экспорта. Задается в формате библиотеки Quartz похожем на Unix cron. |
export.task2.name | Вторая задача экспорта. С версии 17.0 умолчание очищено, было: cmdpack:DumpQ_PcHour7d | |
export.task2.cron | 0 5 * * * ? | Время выполнения второй задачи экспорта. Задается в формате библиотеки Quartz похожем на Unix cron. |
export.task3.name | Третья задача экспорта. С версии 17.0 умолчание очищено, было: cmdpack:DumpQ_ContrDay31d | |
export.task3.cron | 0 30 10 * * ? | Время выполнения третьей задачи экспорта. Задается в формате библиотеки Quartz похожем на Unix cron. |
export.task4.name | Четвёртая задача экспорта. С версии 17.0 умолчание очищено, было: cmdpack:DumpQ_ContrMonth2p | |
export.task4.cron | 0 15 10 ? * 6L | Время выполнения четвёртой задачи экспорта. Задается в формате библиотеки Quartz похожем на Unix cron. |
ais.ws.export.format.PcHour7d.fields | CONS_OID,CONS_SYS,CONS_NAME,PC_OID,PC_SYS,PC_NAME,GCO_OID,GCO_SYS,GCO_NAME,CORR_TIME,Q,SIGN_DATE | Список полей для выгрузки, через запятую, для указанной команды. * - означает все. |
ais.ws.export.format.PcDay31d.fields | CONS_OID,CONS_SYS,CONS_NAME,PC_OID,PC_SYS,PC_NAME,GCO_OID,GCO_SYS,GCO_NAME,CORR_TIME,Q,SIGN_DATE | Список полей для выгрузки, через запятую, для указанной команды. * - означает все. ESB-727 |
ais.ws.export.format.ContrDay31d.fields | CONS_OID,CONS_SYS,CONS_NAME,PC_OID,PC_SYS,PC_NAME,PRMARK_OID,PRMARK_SYS,PR_MARK_NAME,CONTR_OID,CONTR_SYS,CONTRACT_NUM,CORR_TIME,Q,LAST_CHANGED_DATE,PCONTR_OID,PCONTR_SYS,PCONTR_NUM, | Список полей для выгрузки, через запятую, для указанной команды. * - означает все. ESB-3999 |
ais.ws.export.format.ContrMonth2p.fields | CONS_OID,CONS_SYS,CONS_NAME,PC_OID,PC_SYS,PC_NAME,PRMARK_OID,PRMARK_SYS,PR_MARK_NAME,CONTR_OID,CONTR_SYS,CONTRACT_NUM,CORR_TIME,Q,LAST_CHANGED_DATE,PCONTR_OID,PCONTR_SYS,PCONTR_NUM | Список полей для выгрузки, через запятую, для указанной команды. * - означает все. ESB-3999 |
ais.ws.export.format.PcHour7d.date | yyyy-MM-dd HH:mm:ss | Форматирование даты для соответствующей команды. В стиле SimpleDateFormat. ESB-727. С версии 17.0. |
ais.ws.export.format.PcDay31d.date | yyyy-MM-dd | Форматирование даты для соответствующей команды. В стиле SimpleDateFormat. ESB-727. С версии 17.0. |
ais.ws.export.format.ContrDay31d.date | yyyy-MM-dd | Форматирование даты для соответствующей команды. В стиле SimpleDateFormat. ESB-727. С версии 17.0. |
ais.ws.export.format.ContrMonth2p.date | yyyy-MM-dd | Форматирование даты для соответствующей команды. В стиле SimpleDateFormat. ESB-727. С версии 17.0. |
Глобальное конфигурирование в БД
В БД имеется таблица profile_tab, в которой хранятся значения key/value которые могут влиять на настройки приложения глобально, как АРМа, так и ESB.
Параметр | Пример значения | Описание |
---|---|---|
DayBeginingAt | 10 | Время начала отсчета суток в РГК |
AlarmBadState | select al.id from AlarmName as al where al.alarmWeight between 100 and 149 | Список ид. типов тревог <Нештатные ситуации> |
GdoRootZoneName | Все выхода ГРС | Имя зоны по-умолчанию для создания естественных зон ГП по новым выходам ГРС |
CompareIgnoreWords | г.;пос.;с.;р-н;д.;д/пос;сел.;р/н;ГРС;АГР;ГР_;_ГР;Вход;вход;ВХОД;Выход;выход;ВЫХОД;Площадка;площадка;ПЛОЩАДКА;УУГ | Слова, исключающиеся при сравнении строк (разделитель - ";", пробел - "_") |
CompareIgnorePrepositions | _на_;_в_;_при_;_с_;_из_;_для_;_к_;_по_;_ч/з_;_через_;_о_ | Предлоги, исключающиеся при сравнении строк (разделитель - ";", пробел - "_") |
UseTemporaryTables | false | Признак использования временных таблиц (таблицы типа TT_***) |
UseUpcontract | false | Признак импорта договоров ч/з UPCONTRACT |
UseHints | false | Признак использования оптимизационных hints в SQL (Например, +ORDERED )
|
UseHistJoin | false | Признак использования исторических атрибутов в архивах данных при построении запроса |
UMPressure | kgs/cm2 | Базовая единица измерения для давления |
UMTemperature | C | Базовая единица измерения для температуры |
UMVolume | nm3 | Базовая единица измерения для нормированного объема |
UMRVolume | m3 | Базовая единица измерения для рабочего объема |
UMEnergy | joule | Базовая единица измерения для калорийности |
UnboundTuugZoneName | Непривязанные УУГ | Наименование автоматически заполняемой зоны ГП с непривязанными УУГ |
SkipHistoryPoint | false | Признак отключения записи историзации (создание точек истории HISTORY_POINT, HISTORY_CHANGE, HISTORY_SET_CHANGE) |
UseHistJoin4Add | true | Признак, использования исторических атрибутов в зоне актирования при включенном атрибуте |
Company | 29,4 | Идентификатор текущей компании вида: <obj_type_id>,<obj_id> |
HideRoute | false | Признак не использования Ниток трубопровода: режим Трубопровод == Нитка |
PlanByGco | false | Признак ведения планов по площадкам |
UMPressureB | kgs/cm2pb | Базовая единица измерения для перепада давления |
AccountZeroPlan | false | Использовать или нет 0 план для актуальности СР. До версии "19.4>(trunk - [https://jira.spb.ant-inform.ru/browse/QUICK-7948 QUICK-7948])" использовалась локальная опция ais.ws.doNotAccount0Plan |
Примечания
- ↑ 1,0 1,1 В версии 18.4.pre32 появилась поддержка двух учётных систем, указанные обязательные опции зависят от выбранного типа провайдера данных. За подробностями обращайтесь к опции конфигурации ais.serviceProvider
- ↑ C версии адаптера 19.5.pre16 добавлена опциональность чтобы поддержать https схему, до этого требовалось указывать без протокола
- ↑ По запросу из Астрахани, что было сочтено разумным
- ↑ Это может быть весьма полезно если вы хотите исправлять ошибки, и не разбираться потом с дублями СР, возникающих при повторной загрузке исправленных планов, как например запрашивал Рустам Фарукшин из Уфы