Конфигурирование адаптера на стороне ИМУС — различия между версиями
Материал из ANT-Inform documentation
Hubbitus (обсуждение | вклад) (Add underscore versions of all anchors (like export.task4.cron -> export_task4_cron)) |
Hubbitus (обсуждение | вклад) (→Глобальное конфигурирование в БД: Add ahchor profile_tab__PlanByGco) |
||
| Строка 263: | Строка 263: | ||
| HideRoute || false || Признак не использования Ниток трубопровода: режим Трубопровод == Нитка | | HideRoute || false || Признак не использования Ниток трубопровода: режим Трубопровод == Нитка | ||
|- | |- | ||
| − | | PlanByGco || false || Признак ведения планов по площадкам | + | | {{anchor|profile_tab__PlanByGco}}PlanByGco || false || Признак ведения планов по площадкам |
|- | |- | ||
| UMPressureB || kgs/cm2pb || Базовая единица измерения для перепада давления | | UMPressureB || kgs/cm2pb || Базовая единица измерения для перепада давления | ||
Версия 16:07, 14 февраля 2013
Содержание
Опции конфигурирования адаптера
Обязательные к заполнению на каждой РГК
Данные опции не имеют значений по умолчанию, и обязательно должны быть заданы для функционирования адаптера.
| Опция конфигурации | Описание |
|---|---|
| ais.ws.url | URL Веб-сервиса. Без http:// |
| ais.ws.user | Пользователь для доступа |
| ais.ws.password | Пароль. Просьба не использовать символ @ и кавычек. |
| settings.codesystem | Код системы, от которой будет работать адаптер. Например "tverrgmain.ais". |
Опции которые могут быть оставлены со значениями по умолчанию
Переопределяются при необходимости. Если не указаны в файле ais.properties - используются представленные ниже параметры
| Опция конфигурации | Значение по умолчанию | Описание | Доп. Инфо | ||
|---|---|---|---|---|---|
| (deprecated in с версии 14.10) |
Система от которой работает адаптер. | Сейчас должно использоваться 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) | Сейчас берётся из настроек БД | |||
| md.manager.cmdconf.in | AIS.CMDCONF.IN | Очередь JMS для посылки текстовых комманд (например через amq-command) | |||
| jms.cmd.queue | AIS.CMD.IN | То же что и параметр выше, для прямых комманд в формате XML | |||
| md.manager.logData | false | Выводить все пришедшие и сконвертированные данные. Может несколько замедлять работу. Прежде всего для траблешутинга. Сейчас вероятно более удобны будет использовать ais.ws.debug | |||
| ais.ws.partialLog | 0 | Включение отдельного лога для каждой команды в директории md. Будет создаваться и каждый раз перезаписываться согласно имени комманды, например Region.log.
Удобно использовать для внедрения и поиска ошибок, особенно совместно с md.manager.logData=true Возможные значения:
|
ESB-341 | ||
| |
false | Отключение кеша объектов по XML хранилищу из md. Замедляет работу, но рекомендуется на этапе внедрения чтобы не очищать их вручную. НЕ используется для команд RunTask (всевозможные маппинги и автосвязки), влияет только на импорт объектов ( ESB-341. Заменило старое ais.ws.disableCache (ESB-351) | Больше не используется с версии ~16.0 (ESB-592) | ||
| ais.ws.useOrigIdFusion | false | Если true - в orig_id используется полная связка "UID:code:foreignKey", в обратном случае только UID.
|
|||
| ais.ws.migrate.OrigIdsToUID | false | Значение true может использоваться временно для миграции с файлового адаптера, когда требуется обновление кодов. При этом будет осуществляться обновление orig_id перед любой другой обработкой. См. также параметр ais.ws.migrate.OrigIdsToUID_Field | |||
| 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 | Параметр конфигурации для команды AutoMapTelemetry. Значение - разделенные запятой пары "система_в_аис:система_имус". Пробелы не допускаются. Все имена должны быть в нижнем регистре. Для русского текста должна использоваться Java-нотация вида \u (например "стел" = "\u0441\u0442\u0435\u\043b") | ||||
| |
true | Не импортировать помеченные на удаление объекты из АИС, если их еще нету в ИМУС. Если объект был загружен, и в следующий раз пришел помеченным на удаление, он в любом случае обновляется, в том числе становится скрытым (dvis=1) | Больше не используется с версии ~16.0 ESB-592 | ||
| |
false | Если true - не будут создаваться метаобъекты с иерархией для тех объектов, где грузятся сами объекты, а не меты (ПМ) | ESB-308 | ||
| |
true | Отключение кеширования в компоненте ДатаМаппер. Отключение может сэкономить немного памяти, требуемой адаптеру, но ведет к замедлению работы | Больше не используется с версии ~16.0 ESB-592 | ||
| ais.ws.doNotMarkErrorsInOuts | true | Помечать ошибками Выходы ГРС (не указанные ГРО и Регион) (значение false) или нет (true) | ESB-334 | ||
| ais.ws.muteErrors | Отключение пометки в объектах указанных через запятую кодов ошибок.
Для следующих кодов это имеет дополнительное значение: |
Доступно с версии адаптера 14.4.1 | |||
| ais.ws.gceAttachToAnyChannel | false | Если установлено в true - ГПО вешается на любой канал площадки, когда его больше 1, иначе (по умолчанию) только на единственный | |||
| ais.ws.genGCOonlyByPC | false | Способ генерации Площадок командой GenGcoFromPcAndConsumer | Сделано для Мордовии чтобы площадки перевешивались ESB-364. Доступно с версии 14.7. | ||
| |
true | Режим обновления объектов. По умолчанию используется старый режим (true) когда при изменении объекта в ИМУС (или любой другой системой), он полностью исключается из дальнейшего обновления (синхронизации). По значению false все синхронизируемые с АИС поля будут перезаписываться всегда. | ESB-391. С версии адаптера 14.9.5 | ||
| 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.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 | Сумма (корректировка) прибавляемая к коридорам договоров к приходящим из АИС. Чаще всего скажем для перебора 10 процентов оттуда приходит 10, а мы хотим в договоре видеть 110. Таким образом здесь надо выставить 100. | ESB-524 | ||
| ais.ws.reportMaxErrors | 500 | Максимальное количество проблемных объектов которое выводить в каждом коде ошибок. Остальные просто не будут показаны, т.к. чаще всего если атрибут не установлен для всех, то и список бесполезен | |||
| ais.ws.attachPcToGcoConsists | both | Изменяет поведение команды AttachPcToGco выполнять расширенные функции для обратной совместимости и наличию одной команды в АРМе. Возможные значения:
|
SUPPORT-2265 | ||
| ais.ws.debug | false | Cвойство адаптера debug, отвечающее за сохранение всего набора входящих элементов и элементов скрываемых в файл *.meta.xml | ESB-732 | ||
| ais.ws.dvisAbsent | false | Список через запятую, какие команды адаптера будут удалять свои объекты, если они больше не приходят с сервиса.
Какие объекты, каких команд, скрывать (dvis), если они больше не приходят из удалённой системы. По умолчанию ни один. Это не синхронизация, пометки удаления, работающая давно, речь именно о том чтобы скрыть объекты, физически удалённые в АИС, которые больше не приходят (физически удалены или разорвана историческая связь). Каждый элемент в строке может также заканчиваться знаком +, тогда будут удаляться не пришедшие объекты данного типа любых систем! В обратном случае, только системы '*.ais'. В режиме дебага список всех скрываемых элементов будет записан в метахранилище (*.meta.xml). |
С версии адаптера 17.0.pre5. ESB-527. ПМ не скрываются, потому что у них просто нету атрибута dvis QUICK-4099. |
Параметры экспорта
| Опция конфигурации | Значение по умолчанию | Описание |
|---|---|---|
| ais.file.dir | D:\AIS | Директория для экспорта CSV файлов объема |
| export.task1.name | cmdpack:DumpQ_PcDay31d | Первая задача экспорта |
| export.task1.cron | 0 0 4 ? | Время выполнения первой задачи экспорта. Задается в формате библиотеки Quartz похожем на Unix cron. |
| export.task2.name | cmdpack:DumpQ_PcHour7d | Вторая задача экспорта |
| export.task2.cron | 0 5 * ? | Время выполнения второй задачи экспорта. Задается в формате библиотеки Quartz похожем на Unix cron. |
| export.task3.cron | 0 30 10 ? | Время выполнения третьей задачи экспорта. Задается в формате библиотеки Quartz похожем на Unix cron. |
| export.task4.cron | 0 15 10 ? * 6L | Время выполнения третьей задачи экспорта. Задается в формате библиотеки Quartz похожем на Unix cron. |
Глобальное конфигурирование в БД
В БД имеется таблица 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 | Базовая единица измерения для перепада давления |
