Содержание:

ARMLite - программа для автоматизации учета взвешивания транспорта на автомобильных весах. В данной инструкции содержится описание возможностей настройки программы под задачу пользователя. Инструкция предназначена для администратора системы взвешивания, а также может быть полезна IT-специалисту для решения задачи интеграции АРМ в информационную систему предприятия.

1. Установка

1.1. Системные и программные требования

• Windows: 7 / 8 / 10
• Microsoft .NET Framework 4.6
• Microsoft SQL Server 2012 или более новая версия (2014, 2016). Можно использовать бесплатную редакцию EXPRESS.
• Весовой терминал Mettler Toledo: IND780 / IND570 / IND560 / IND310 / JAGXTREME.

Аппаратные требования к компьютеру для ARMLite:

• 32-разрядный (x86) или 64-разрядный (x64) процессор 2 ГГц;
• ОЗУ 2 ГБ;
• Рекомендуется разрешение монитора: 1680х1050 и более.
• Программа занимает на диске 5 МБ.

1.2. Установка программы

Программа поставляется в виде архива без использования средств установки. Просто извлеките файлы из архива ARMLite.zip в любую папку на диске (например: C:\ARMLite\App). Рекомендуется организовать такую структуру папок:

• C:\ARMLite\App - отдельная папка для файлов программы
• C:\ARMLite\Backup - папка для резервных копий базы
• C:\ARMLite\Photos - папка для фото, если потребуется опция подключения к видео-камерам

Структура папки с программой (C:\ARMLite\App):

• db[] - папка для файлов базы данных SQLite. По умолчанию создается файл default.sqlite.
• config[] - папке с конфигурацией. Описание структуры конфигурационных файлов смотрите в отдельном разделе.
• config_path - в этом файле задается путь к папке с конфигурацией. По умолчанию задан путь к локальной папке config.
• $Папка пользователя$[]/user_settings - файл с установками рабочей среды пользователя (незначительные настройки интерфейса)
• $Папка пользователя$/export[] - папка по умолчанию для экспорта данных из АРМ
• ARM.exe - программа
• Shell.dll - оболочка программы
• ICSharpCode.AvalonEdit.dll
• Mono.Security.dll
• Npgsql.dll
• PdfSharp.Xps.dll
• PdfSharp-WPF.dll
• SQLite.Interop.dll
• System.Data.SQLite.dll

Далее, для работы программы необходимо создать базу данных. Программа поддерживает два типа базы данных:

• локальный файл базы (SQLite)
• серверная база данных на Microsoft SQL сервере (MSSQL).

1.3. Локальная база данных SQLite

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

Рис.1: Создание базы данных

На базе SQLite АРМ может работать и с двумя весами. Но в таких случаях, когда возможно развитие системы взвешивания, рекомендуется использовать серверную базу данных MSSQL как универсальное решение.

1.4. Серверная база данных MSSQL

Для возможности расширения системы взвешивания, когда требуется работать с общей базой данных на нескольких ПК, необходимо использовать базу данных MSSQL.

Рис.2: Схема сети

Для реализации этой схемы выполните действия:

1. На серверный компьютер или на ПК оператора установите Microsoft SQL Server 2012 или более новую версию (2014, 2016). Можно использовать бесплатную редакцию EXPRESS. В пакет установки должен быть включен инструмент администрирования SQL Server Management Studio. Смотрите инструкцию по установке MSSQL сервера и настройке удаленного подключения.
2. Откройте SQL Server Management Studio, подключитесь к SQL серверу.
3. Создайте пустую базу данных с любым наименованием. Для этого в обозревателе объектов откройте контекстное меню для папки Databases, нажмите New Database.... В окне создания базы введите Database name: например, ARM. Нажмите OK.

4. Запустите АРМ от имени администратора Windows. Если подключение к базе еще не было настроено, тогда появится окно как на рис.1. Нажмите изменить параметры подключения, затем Создание новой базы данных. Откроется окно подключения к базе как на рис.3.

   Рис.3: Параметры подключения к базе данных

   Если подключение к базе уже было настроено, и ожидается вход в АРМ, тогда выберите логин superuser, пароль по умолчанию не задан, нажмите Войти. В меню откройте Настройки >> Создание базы данных.

5. Выберите тип сервера: MSSQL. Задайте параметры подключения к серверу.

6. Выберите пустую базу данных, созданную по пункту 3.
7. Выберите назначение базы: Рабочая. Если создать тестовую базу, АРМ будет работать в тестовом режиме с эмулятором весов.
8. Нажмите Создать базу. Должно появиться окно с сообщением об успешном создании базы. В этом окне нажмите Подключиться. АРМ перезапустится и подключится к новой MSSQL базе.

1.5. Подключение весов

К АРМ можно подключить двое весов. Для каждого подключения к весам требуется активация. Подключение к весам не работает в тестовой базе данных.

1. Запустите ARM.exe. Выберите логин superuser, пароль по умолчанию не задан, нажмите Войти.
2. Откройте в меню Настройка >> Подключение весов / Активация. Выберите модель весового терминала, введите IP адрес терминала. Для проверки доступа по сети, можно нажать кнопку ping. Нажмите Применить. При успешном подключении к терминалу в этом же окне появится R-код.
3. Скопируйте R-код и вставьте в заявку на получение ключа активации.
4. На указанный в заявке адрес эл.почты будет отправлен Ключ активации. Скопируйте и вставьте ключ в окне активации. Нажмите Применить. В поле статуса активации должно появиться: Активация прошла успешно.
5. После активации в правом верхнем углу основного окна будет выводиться текущее значение массы от весов с единицей измерения как на терминале.

Рис.4: Подключение весов / Активация

Список весовых терминалов, которые можно подключить к АРМ:

• IND780
• IND560
• IND570
• IND310 - на терминале должна быть версия прошивки 2.х
• JAGXTREME

1.6. Обновление программы

Для обновления программы в большинстве случаев достаточно заменить два файла: ARM.exe и Shell.dll.

1. Перед обновлением рекомендуется сделать резервную копию текущей версии программы и базы данных. Если база данных находится в локальном файле SQLite в папке по умолчанию db, тогда достаточно создать архив всей папки АРМ включая базу данных. Для серверной базы данных MSSQL резервную копию можно сделать через АРМ в меню Настройка >> Резервное копирование базы данных или с помощью SQL Server Management Studio.
2. Загрузите архив с новой версией ARMLite.zip, извлеките файлы в любую папку на диске. Перенесите новые файлы ARM.exe и Shell.dll в папку с текущей рабочей программой.
3. Запустите ARM.exe. Если для новой версии требуется внести изменения в структуру базы данных, программа делает это автоматически при первом запуске новой версии. В этом случае выводится сообщение об успешном обновлении базы данных.
4. При запуске новой версии программа также может добавить в существующие конфигурационные файлы новые параметры со значениями по умолчанию.

1.7. Создание новой локальной базы данных SQLite

1. Запустите АРМ от имени администратора Windows. Войдите под логином superuser.
2. Откройте Меню >> Создание базы данных.
3. Выберите тип сервера: SQLite.
4. Задайте путь к базе с указанием имени нового файла (расширение файла можно указать *.sqlite или *.db). Можно указать относительный путь, например: db\mydb.sqlite.
5. Задайте пароль, чтобы зашифровать базу данных, или оставьте это поле пустым. ВНИМАНИЕ! Если пароль будет забыт или утерян, АРМ не предоставляет средств для восстановления этого пароля. Незашифрованная база данных (без пароля) может быть открыта программой администрирования SQLite.
6. По умолчанию создается Рабочая база данных для работы с весами. Выберите назначение базы: Тестовая, если хотите, чтобы АРМ работал в тестовом режиме (с эмулятором весов).
7. Нажмите Создать базу. Должно появиться окно с сообщением об успешном создании базы. В этом окне нажмите Подключиться. АРМ перезапустится и подключится к новой базе SQLite.

2. Архитектура АРМ

Краткие обозначения:

• ТС - транспортное средство
• ИС - информационная система

По сути ARMLite - это программа для ведения электронного журнала погрузок или разгрузок транспортных средств. Два взвешивания ТС (груженое и порожнее), фото-снимки взвешиваний, сопроводительные данные объединяются в один документ, который называется в АРМе накладная. Интерфейс пользователя позволяет работать со списком накладных при разных алгоритмах взвешивания ТС с элементами автоматизации (получение номеров из системы распознавания, автоматическое заполнение полей из внешней ИС).

2.1. Схема пользовательского интерфейса

На рис.5 схематично показаны ключевые объекты пользовательского интерфейса АРМ.

Рис.5: Схема пользовательского интерфейса АРМ

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

2.2. Особенности работы АРМ

1. Порядковый номер накладной задается автоматически без возможности изменения.
2. При запуске АРМ список накладных выводится за текущие сутки, но можно задать выборку за любое число или период.
3. В накладной может быть одно или два взвешивания.
4. Кнопка второго взвешивания становится доступна после первого взвешивания. Не имеет значения, в каком порядке выполнять взвешивания: груженая машина, затем порожняя; или порожняя, затем груженая.
5. Взвешивание 1 и Взвешивание 2 можно удалить для случаев, когда взвешивание было выполнено неправильно (неправильное позиционирование машины, взвешивание добавили не в ту накладную, два раза взвесили груженую машину или два раза порожнюю…).
6. Пользователь, у которого нет привилегии удаления взвешиваний, тем не менее, может отменить только последнее взвешивание до закрытия формы накладной.
7. Накладную можно заблокировать после того, как будет определена масса нетто. Это происходит при наличии двух взвешиваний или одного взвешивания брутто с заданной справочной тарой. После блокировки накладной все поля становятся недоступны для изменений. Разблокировать накладную может пользователь со специальной привилегией.
8. После появления второго взвешивания обновляется справочная тара, если разница масс груженой и порожней более минимального значения нетто (параметр в конфигурации: main.ini >> WEIGHING >> min_net).
9. Накладную можно удалить, если в ней нет ни одного взвешивания.
10. Для полей накладной можно задать значения по умолчанию. При создании накладной эти поля заполнятся автоматически. Чтобы использовать значения по умолчанию, в конфигурации должен быть задан параметр main.ini >> MISC >> use_defaults=true. Значения по умолчанию задаются в меню Настройка >> Значения по умолчанию для накладной.

2.3. Вид пользовательского интерфейса

Ниже на скриншотах показана реализация схемы пользовательского интерфейса (см. схему на рис.5). Раздел с таблицей накладных открывается в меню Разделы >> Накладные или нажатием клавиши F2.

Рис.6: Таблица накладных

По умолчанию при запуске программы задано ограничение выборки накладных как Данные за сегодня. Есть и другие режимы ограничения выборки: Данные за вчера и сегодня, Данные за указанную даты, Расширенный поиск. В режиме расширенного поиска можно указать произвольный период и другие параметры фильтра.

Рис.7: Расширенный поиск накладных

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

Рис.8: Принять ТС

По нажатию Открыть существующую или Создать новую накладную окно Принять ТС закрывается и открывается форма накладной.

Рис.9: Пример вида формы накладной

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

Если включена опция подключения к видео-камерам, тогда показания весов не выводятся на форму. В этом случае по нажатию кнопки Взвесить откроется отдельное окно (рис.10) с выводом текущих кадров от камер. В момент фиксации веса текущие кадры сохраняются в файлы и привязываются ко взвешиванию.

Рис.10: Окно взвешивания с фото-фиксацией

Если к АРМ подключено двое весов, тогда программа определяет на каких весах находится ТС, автоматически выбирает эти весы и выводит изображения с камер, которые подключены к этим весам.

3. Конфигурация

Все настройки программы задаются в конфигурационных файлах (INI, XML, TXT). Путь к папке с конфигурационными файлами задается в файле config_path. По умолчанию в нем задан относительный путь к локальной папке config. В АРМ есть встроенный текстовый редактор для внесения изменений в конфигурацию. Редактор конфигурации открывается в меню Настройка >> Конфигурация или Ctrl+K.

Рис.11: Текстовый редактор конфигурации

Структура папки config:

• export[]
  • export.ini - параметры экспорта данных в файл
  • fields.xml - список полей экспортируемых данных
• main[]
  • axles_rules.txt - параметры правил определения допустимых нагрузок на оси авто
  • main.ini - основные настройки
    • INTERACTION - параметры взаимодействия с внешней ИС
    • LIGHTS - настройки опции управления светофорами
    • MISC - разные настройки
    • PHOTOS - настройки опции фотоснимков
    • TERMINAL1 - параметры подключения к весам 1
    • TERMINAL2 - параметры подключения к весам 2
    • WEIGHING - параметры взвешивания
• recogn[]
  • recogn.ini - настройки опции подключения к системе распознавания номеров
• reports[] - в эту папку можно добавлять свои шаблоны отчетов (XML-файлы)
  • images[] - папка для изображений, которые выводятся в отчеты (логотип, статические картинки)
  • item_main.xml - шаблон отчета по выбранной накладной
  • list.xml - шаблон отчета, в котором содержится список накладных
  • axles.xml - шаблон отчета по выбранной накладной с таблицей осевых нагрузок
  • reports.ini - задается, какие шаблоны использовать
• terminal[] - файлы для загрузки в терминал
• view[]
  • form.xml - параметры формы накладной, список полей накладной
  • table.xml - список полей таблицы накладных
  • view.ini

3.1. Настройка формы накладной

Вид формы накладной настраивается в файле view\form.xml. Для настройки откройте форму накладной, нажмите Ctrl+K, откроется редактор конфигурации сразу с выбранным файлом view\form.xml. Внесите изменение в файл и сохраните Ctrl+S. Результат изменения сразу применится на форме. В файле можно задать параметры:

• Width - ширина окна формы
• Height - высота окна формы
• HeadersWidth - ширина наименований полей (слева)
• HeadersAlignment - горизонтальное выравнивание текста наименований полей
• FieldMargin - вертикальный отступ между полями

Также можно показать/скрыть поля и изменить наименования.

Рис.12: Файл конфигурации формы

Перечень всех допустимых полей в форме накладной:

На рис.13 показан пример, как может выглядеть форма накладной со всеми включенными полями.

Рис.13: Форма со всеми доступными полями АРМ

3.2. Структура данных АРМ

Для настройки таблицы накладных, экспорта накладных, создания шаблонов отчетов необходимо иметь представление о структуре данных АРМ. Структура данных АРМ не является описанием полей базы данных, но описывает свойства внутренних объектов АРМ. Структура данных АРМ используется в файлах конфигурации:

• export\fields.xml
• reports\*.xml - во всех шаблонах отчетов, находящихся в папке reports
• view\table.xml

Основной объект выходных данных АРМ это Накладная.

Структура типа Накладная:

Структура типа Масса:

Структура типа Организация:

Структура типа Документ:

Структура типа Представитель:

Структура типа Пользователь:

Структура типа Взвешивание:

Структура типа МассаОсей:

Структура типа Масса:

3.3. Настройка таблицы накладных

Вид таблицы накладных настраивается в файле view\table.xml. Для настройки откройте основной раздел Накладные, нажмите Ctrl+K, откроется редактор конфигурации сразу с выбранным файлом view\table.xml. Внесите изменение в файл и сохраните Ctrl+S. Результат изменений сразу отразится в таблице.

Рис.14: Файл конфигурации таблицы

Таким образом в таблицу можно вывести любой перечень полей, которые есть в структуре данных АРМ, включая вложенные свойства. Вложенные свойства задаются через точку. Все вложенные типы и их свойства перечислены в разделе 3.2.

Чтобы изменить порядок полей, в редакторе файла нажмите Alt+Вниз, Alt+Вверх. Чтобы скрыть поле, можно просто удалить строку или закомментировать её нажатием Ctrl+/. Закомментированные строки (отмечены зеленым) остаются в файле, но не используются.

3.4. Настройка экспорта выборки накладных

Выборку накладных можно экспортировать в файл в формате CSV, который можно обработать программно или открыть в Excel. Параметры CSV задаются в файле export\export.ini. Описание всех параметров указано в самом файле. Перечень и формат полей задается в файле export\fields.xml так же, как при настройке таблицы накладных (см. п.3.3). Если экспорт полей нужен в том же виде, как настроена таблица АРМ, тогда просто скопируйте содержание файла view\table.xml в export\fields.xml.

3.5. Настройка отчетов

В АРМ есть два типа отчетов:

• по накладной - открывается в окне с формой накладной в отдельной закладке.
• по выборке накладных - в отчет выводится список накладных, который показан в таблице основного раздела Накладные.

Рис.15: Доступ к отчетам

В конфигурации можно настроить вывод в меню до 3х отчетов по накладной и до 3х отчетов по выборке накладных.

Рис.16: Настройка списка отчетов

Выбор отчета по накладной также доступен в окне накладной в закладке просмотра отчета.

Рис.17: Просмотр отчета

Вы можете создать свой шаблон отчета по примеру стандартных шаблонов. Откройте просмотр отчета (как на рис.17), нажмите Ctrl+K, откроется редактор конфигурации сразу с выбранным файлом шаблона этого отчета. Внесите изменение в файл и сохраните Ctrl+S. Результат изменений сразу отразится в просмотре отчета.

Рекомендуется экспериментировать с копиями стандартных шаблонов. Чтобы сделать дубликат файла, выберите стандартный шаблон и нажмите Ctrl+Shift+D. Редактор запросит ввести имя нового файла. Учитывайте, что АРМ использует те файлы шаблонов, которые заданы в файле reports.ini.

Чтобы показать список возможных атрибутов или значений, установите курсор в нужном контексте и нажмите Ctrl+Пробел.

Рис.18: Редактор шаблона отчета

4. Администрирование

4.1. Привилегии пользователей

Для аутентификации пользователей используются внутренние учетные записи, которые хранятся в базе данных системы. При запуске программы запрашивается логин и пароль для дальнейшей работы с базой. Каждому пользователю присваивается роль. Ограничение доступа к выборочным функциям задается на роль пользователя.

В роль system включены все привилегии. Эта роль принадлежит единственному пользователю superuser, у которого, соответственно, есть доступ ко всем функциям. По умолчанию пароль для superuser не задан. Рекомендуется задать надежный пароль для superuser и не использовать эту учетную запись в работе. Заданный пароль для пользователя не может быть восстановлен - используется необратимое шифрование пароля при записи в базу данных.

Для добавления/изменения пользователей и ролей откройте в меню Настройка >> Пользователи и роли. Этот раздел доступен пользователю с привилегией администрирования учетных записей.

Рис.19: Привилегии пользователей

4.2. Журнал действий пользователей

Значимые действия пользователя отмечаются в журнале, который хранится в базе данных. Для просмотра журнала откройте в меню Настройка >> Журнал действий пользователей. Для доступа к журналу у пользователя должна быть привилегия Просмотр журнала действий пользователей.

Рис.20: Журнал действий пользователей

Список действий, которые отмечаются в журнале:

• Вход в программу.
• Выход из программы.
• Пользователь сменил себе пароль.
• Не удалось войти под логином.
• Удаление накладной.
• Отмена взвешивания в накладной.
• Разблокировка накладной.
• Изменения в справочниках (удаление, скрытие, добавление, обновление записи).
• Экспорт / импорт справочника.
• Изменения в учетных записях (удаление, добавление, изменение пользователя).
• Изменения в группах учетных записей (удаление, добавление, изменение группы).
• Изменение списка привилегий для группы пользователей.
• Очистка журнала действий пользователей.

4.3. Справочники

Справочник - это список наименований с возможными дополнительными атрибутами. В АРМ предусмотрены справочники:

• Транспортные средства
• Марки транспортных средств
• Продукты
• Грузополучатели
• Грузоотправители
• Экспедиторы
• Водители
• Владельцы ТС
• Направления

Список справочников находится в меню Разделы.

Рис.21: Просмотр и редактирование справочника

Списки наименований из этих справочников выводятся в соответствующие поля на форме накладной. Если у оператора есть привилегия редактирования справочника, тогда справочник может пополняться новыми записями по мере ввода новых данных через форму накладной. Но можно и заранее заполнить справочники нужными данными. Это делается вручную или через импорт из файла.

Импорт / Экспорт записей

Простой список наименований (без доп. атрибутов) можно легко импортировать из текстового файла, когда наименования заданы построчно. Кодировка файла: UTF8. Для импорта/экспорта данных с атрибутами текстовый файл должен быть сформатирован как CSV.

Удаление записей

Ненужные записи можно скрыть нажатием в меню записи Удалить. Скрытую запись можно восстановить. Если повторно нажать Удалить для скрытой записи, тогда запись будет удалена из базы данных. Невозможно удалить запись из базы данных, если эта запись связана с накладной, то есть если запись была выбрана в соответствующем поле на форме накладной.

5. Опции

Некоторые элементы пользовательского интерфейса могут быть скрыты в зависимости от подключенных опций. Статус активации и список доступных опций можно увидеть в меню Справка >> О программе

Рис.22: О программе

5.1. Опция 1. Проверка осевых нагрузок

Системные и программные требования:

• Весовой терминал IND780
• Аппаратный ключ доступа для запуска приложений на терминале IND780
• Программа взвешивания осей Axles780 (запускается на весовом терминале)

Программу терминала можно загрузить/обновить из АРМ, для этого в меню АРМ нажмите Сервис >> Загрузить программу взвешивания осей на терминал >> Terminal 1 (или Terminal 2).

Принцип работы программы терминала:

Программа работает отдельно от АРМ и без участия оператора. При въезде ТС на весы начинается процесс определения нагрузок на оси. После остановки ТС на весах программа определяет статический общий вес. Если задан параметр ожидания выхода водителя, тогда статический вес будет зафиксирован только после заданного таймаута. Результаты распределения общей массы по осям определяются после съезда ТС с весов и записываются в общедоступные переменные весового терминала. Эти данные могут быть считаны из внешних программ через порт TCP терминала. При въезде следующего ТС, в начале процесса взвешивания старые результаты удаляются из переменных терминала.

При взаимодействии с АРМ логика работы программы терминала немного меняется. При остановке ТС на весах оператор сам принимает решение в какой момент взвешивать (до или после выхода водителя). По нажатию кнопки Взвесить фиксируется статический вес (в течение 3х секунд ожидается значение веса с признаком стабильности). Это значение статического веса передается программе взвешивания осей на терминале и будет использоваться при распределении по осям после съезда ТС с весов.

Настройка опции проверки осевых нагрузок в АРМ:

Откройте в меню Настройка >> Конфигурация >> файл main.ini >> секция [AXLES]. Обратите внимание на следующие параметры:

use_axles Использовать опцию: “Проверка осевых нагрузок”.

• false - Не использовать опцию. По нажатию кнопки Взвесить будет зафиксироваться только общая масса ТС.
• true - По нажатию кнопки Взвесить фиксируется общий текущий вес и выводится сообщение: Ожидается съезд с весов.... В течение 20 минут (задается в параметре leave_scale_timeout) идет чтение результатов поосного взвешивания. Если есть данные, заполняется таблица осей. Если нет данных в течение периода ожидания, тогда выводится сообщение: Время ожидания данных по осевым нагрузкам истекло.

leave_scale_timeout Время ожидания съезда машины с весов (в минутах).

wait_driver_out Время ожидания выхода водителя после остановки на весах (в секундах).

Этот параметр задается для автоматического взвешивания без взаимодействия через АРМ. После остановки ТС на весах программа терминала автоматически фиксирует общую массу ТС. В параметре wait_driver_out задается задержка перед фиксацией общей массы. Если требуется не учитывать массу водителя, установите временную задержку достаточную для выхода водителя из машины. По умолчанию это отключено (задано 0 секунд).

axles_limits_mode Какие правила ограничений осевых нагрузок использовать по умолчанию.

• Custom - Простой режим определения допустимых нагрузок. В меню Настройка >> Пользовательские ограничения осевых нагрузок задаются допустимые нагрузки в зависимости только от количества осей ТС. Таким образом, для определения допустимых нагрузок, после взвешивания осей не требуется вводить дополнительные параметры (расстояния между осями и скатность колес).
• Rules - Определение допустимых нагрузок будет выполняться в соответствие с Постановлением Правительства РФ “Об утверждении Правил перевозок грузов автомобильным транспортом”. Для каждого номера тягача и номера прицепа потребуется задать расстояния между осями и скатность.

Если будет использоваться только простой режим определения допустимых нагрузок Custom, тогда можно убрать лишние поля из таблицы осей. Откройте форму накладной и нажмите Ctrl+K.

Рис.23: Настройка таблицы осей на форме

В случае использования Правил, задать конфигурацию осей тягача и прицепа можно через наглядную интерактивную схему. Для этого на форме накладной нажмите кнопку Параметры осевых нагрузок. Конфигурации осей тягача и прицепа привязываются соответственно к номерам тягача и прицепа для возможных комбинаций тягача с другими прицепами.

Рис.24: Интерактивная схема конфигурации осей и нагрузок

Рис.25: Простой режим определения допустимых осевых нагрузок

5.2. Опция 2. Подключение к системе распознавания номеров

Взаимодействие с системой распознавания номеров сделано следующим образом. При нажатии Принять ТС, сразу после открытия окна (см.рис.8) выполняется запрос в базу распознанных номеров на поиск последних распознаваний за указанный период. Номера попадают в поля Номер тягача или Номер прицепа в зависимости от идентификаторов распознавателей.

Вызов запроса номеров также доступен из формы накладной, по нажатию кнопки Получить номер.

Поддерживается подключение к системам распознавания:

• SecurOS
• AutoTRASSIR
• Авто Орион Про

Для настройки подключения откройте в меню Настройка >> Конфигурация >> файл recogn.ini. Задайте параметр recogn_system=Securos (или AutoTrassir, OrionPro). В этом же файле найдите соответствующий раздел [SECUROS] (или [AUTO_TRASSIR], [ORION_PRO]), в котором задается строка подключения к базе данных и идентификаторы распознавателей.

5.3. Опция 3. Подключение к видео-камерам

Список видео-камер задается в меню Настройка >> Видео-камеры.

Рис.26: Список видео-камер

Для подключения видео-камеры:

1. Добавьте запись в таблицу камер. Введите IP, логин, пароль. Для камер фирмы AXIS может потребоваться создание специального ONVIF-пользователя через веб-интерфейс камеры. Введите логин пароль этого пользователя.
2. Введите номер ячейки от 1 до 6. В зависимости от количества камер сетка изображений может быть 2х1, 2х2, 3х2. Привязка камеры к весам задается в поле ID весов, введите код весов 1 или 2.
3. В контекстном меню записи нажмите Проверить камеру. Если появилось изображение, текущий URI и разрешение автоматически сохранятся в свойствах записи этой камеры и будут использоваться при работе в АРМ.
4. Для проверки, как выглядит сетка изображений со всех камер, нажмите в меню Разделы >> Принять ТС или клавишу F9.

Рис.27: Проверка камеры

5.4. Опция 4. Управление светофорами

Системные и программные требования:

• Весовой терминал IND780
• Плата дискретных выходов для терминала IND780: Discrete I/O Board, Relay version

Для активации логики работы дискретных выходов нажмите в меню АРМ Сервис >> Управление светофорами >> Настроить терминал 1. При этом в региональных настройках терминала должен быть задан английский язык. В конфигурации АРМ в файле main.ini задайте параметр use_lights=true.

Принцип работы светофоров

Рис.28: Схема расположения светофоров

6. Разное

6.1. Список горячих клавиш

В главном окне программы:

• F1 - Открыть главное меню
• F2 - Открыть основной раздел “Накладные”
• F3 - Открыть накладную с последним взвешиванием
• F9 - Принять ТС
• Ctrl+U - Пользователи и роли
• Ctrl+K - Редактор конфигурации
• Ctrl+Q - Выход - завершить работу пользователя в АРМ
• Ctrl+1 - Справочник “Транспортные средства”
• Ctrl+2 - Справочник “Марки транспортных средств”
• Ctrl+3 - Справочник “Продукты”
• Ctrl+4 - Справочник “Грузополучатели”
• Ctrl+5 - Справочник “Грузоотправители”
• Ctrl+6 - Справочник “Экспедиторы”
• Ctrl+7 - Справочник “Водители”
• Ctrl+8 - Справочник “Владельцы ТС”
• Ctrl+9 - Справочник “Направления”

В разделе “Накладные”

• F5 - Обновить набор данных - перезагрузить из базы
• F6 - Открыть отчет по выбранной накладной
• F7 - Открыть табличный отчет с текущей выборкой накладных
• F8 - Экспорт в CSV
• F9 - Принять ТС
• Ctrl+N - Добавить новую пустую накладную
• Ctrl+F - Открыть расширенный поиск
• Esc - Смена фокуса в режиме расширенного поиска: таблица накладных / поле поиска номера
• Enter - Открыть выбранную накладную
• Ctrl+D - Удалить выбранную накладную
• Ctrl+L - Заблокировать выбранную накладную
• Ctrl+K - Открыть конфигурацию полей таблицы накладных

В разделе справочника

• F5 - Обновить набор данных - перезагрузить из базы
• Ctrl+N - Добавить новую запись
• Ctrl+F - Фокус на поле поиска
• Esc - Выйти в главное меню
• Enter - Открыть выбранную запись
• Ctrl+D - Скрыть/Удалить выбранную запись

В форме накладной:

• Ctrl+N - Создать новую накладную
• Esc - Закрыть окно
• Ctrl+S - Сохранить изменения
• F6 - Открыть просмотр отчета
• Ctrl+L - Заблокировать / разблокировать накладную на изменения
• Ctrl+D - Удалить накладную
• Ctrl+W - Взять значение веса с выбранных весов / Открыть окно взвешивания с фото-фиксацией
• Tab - Фокус на следующее поле
• Shift+Tab - Фокус на предыдущее поле
• F4 - Показать список в поле со списком
• Ctrl+K - Открыть конфигурацию полей формы накладной

В окне просмотра отчета по накладной:

• Esc - Закрыть окно
• Ctrl+K - Открыть редактор шаблона выбранного отчета

6.2. Примеры алгоритмов обработки ТС

Алгоритм 1: (тара взвешивается в начале смены)

1. Въезд порожнего ТС на весы в начале смены.
2. Нажать Принять ТС, ввести номер, нажать Создать новую накладную, нажать Взвесить.
3. Въезд груженого ТС на весы.
4. Нажать Принять ТС, ввести номер, нажать Открыть недавно созданную накладную с этим ТС для второго взвешивания.
5. Нажать Взвесить (вторая кнопка). При появлении второго взвешивания будет рассчитана масса груза. Наименьшая масса из двух взвешиваний будет записана в поле Справочная тара.
6. Ввести дополнительные данные в поля накладной.
7. Нажать Заблокировать, распечатать акт.
8. Далее при следующих рейсах, эта машина взвешивается только груженая. Нажать Принять ТС, ввести номер, нажать Создать новую накладную, нажать Взвесить. Масса груза определиться с учетом справочной тары.
9. Ввести дополнительные данные в поля накладной.
10. Нажать Заблокировать, распечатать акт.

Алгоритм 2: (всегда два взвешивания)

1. Въезд груженого или порожнего ТС на весы.
2. Нажать Принять ТС, ввести номер. Если найдена накладная, в которой ожидается второе взвешивание, нажать Открыть. Если накладная для данного ТС не найдена или все предыдущие накладные с этим ТС заблокированы, тогда нажать Создать новую накладную.
3. В форме накладной нажать Взвесить.
4. Ввести дополнительные данные в поля накладной, если они известны на данный момент.
5. Если есть два взвешивания и все доп. данные введены, тогда нажать Заблокировать, распечатать акт.

7. Интеграция с внешней системой

7.1. Веб-сервис АРМ

Интерфейс реализуется посредством HTTP RESTful.
Формат передаваемых данных: JSON.
Кодировка UTF-8.
Авторизация: Basic.
Веб-сервис встроен в АРМ. URL веб-сервиса: http:/IP_ПК_оператора:8080/ARM

Ниже приводится описание методов для взаимодействия внешних клиентов с веб-сервисом АРМ. В заголовках URL веб-сервиса сокращается как ...

7.1.1. Описание общих форматов

Формат даты/времени согласно ISO 8601: yyyyMMddThh:mm:ss.fffZ, где T - разделитель даты и времени; Z - разделитель временной зоны (значение временной зоны не передается); fff - миллисекунды (всегда 000).

Формат веса: в килограммах, целочисленный (int)

7.1.2. URL: …/waybill

Метод: POST. Создание новой накладной. В базе данных АРМ создается накладная с заданными значениями из соответствующих атрибутов запроса. Новая запись добавляется в список в разделе Накладные. После успешного создания накладной можно автоматически открыть форму новой накладной с помощью атрибута show_form.

Запрос:

Ответ:

Статусы:

• OK - запрос выполнен успешно.
• LoggedOff - пользователь не выполнил вход в АРМ.
• Busy - не соблюдаются условия выполнения запроса из-за другой активности пользователя. Например, если задан атрибут show_form=1, и у оператора открыта какая-либо форма, тогда задается значение Busy. Если задан атрибут show_form=0, тогда допускается параллельная работа оператора в другой форме, новая запись добавится в фоне.
• Exception - ошибка в обработчике запроса на стороне АРМ.

7.1.3. URL: …/waybill/{request_id}

Метод: PUT. Изменение данных в накладной. Можно использовать данный метод для автоматического открытия формы накладной для оператора при втором взвешивании. Для этого требуется задать атрибут show_form=1. Атрибуты запроса и ответа соответствуют описанию как в пункте 7.1.1. Имеются отличия только в перечне статусов:

• OK - запрос выполнен успешно.
• LoggedOff - пользователь не выполнил вход в АРМ.
• Busy - не соблюдаются условия выполнения запроса из-за другой активности пользователя. Например, если задан атрибут show_form=1, и у оператора открыта какая-либо форма, тогда задается значение Busy. Если задан атрибут show_form=0, тогда допускается параллельная работа оператора в другой форме, запись обновится в фоне, но при условии, что открытая форма накладной не отображает обновляемую запись.
• NotFound - накладная не найдена в базе данных АРМ по заданному request_id.
• Locked - обновляемая накладная заблокирована.
• Exception - ошибка в обработчике запроса на стороне АРМ.

7.1.4. URL: …/weighing/{request_id}

Метод: GET. Получение данных о взвешивании.

Ответ:

Статусы:

• OK - запрос выполнен успешно. Возвращает OK также когда взвешивание отсутствует. При наличии данных у взвешивания должно быть заполнено вложенное поле weighing_dt.
• AxlesInProcess - запрос выполнен успешно. Но по заданному request_id сейчас ожидается съезд с весов для получения результатов взвешивания осей. Максимальное время ожидания осей задается в конфигурации АРМ (параметр leave_scale_timeout).
• LoggedOff - пользователь не выполнил вход в АРМ.
• NotFound - накладная не найдена в базе данных АРМ по заданному request_id.
• Exception - ошибка в обработчике запроса на стороне АРМ.

7.1.5. URL: …/lockwaybill/{request_id}

Метод: PUT. Блокировка накладной. После блокировки пользователь не может внести изменения в накладную, отменить или добавить взвешивание.

Ответ:

• OK - запрос выполнен успешно.
• LoggedOff - пользователь не выполнил вход в АРМ.
• NotFound - накладная не найдена в базе данных АРМ по заданному request_id.
• Busy - у пользователя открыта форма именно этой накладной, которая найдена по заданному request_id.
• Locked - обновляемая накладная уже заблокирована.
• Exception - ошибка в обработчике запроса на стороне АРМ.

7.1.6. URL: …/capture

Метод: POST. Фиксация текущих весовых данных аналогично нажатию кнопки Взвесить. Накладная и взвешивание сохраняется в базе данных, затем отправляется ответ на запрос.

Запрос:

Ответ:

• OK - запрос выполнен успешно.
• LoggedOff - пользователь не выполнил вход в АРМ.
• Busy - у пользователя НЕ открыта форма накладной с заданным request_id.
• Failed - не удалось зафиксировать взвешивание. Возможные причины: текущая масса меньше допустимой; при втором взвешивании расчетная масса нетто получается меньше допустимой; время ожидания весовых данных истекло; кнопки взвешивания заблокированы.
• Exception - ошибка в обработчике запроса на стороне АРМ.

7.1.7. URL: …/status

Метод: GET. Проверка текущего состояния АРМ.

Ответ:

Статусы:

• OK - запрос выполнен успешно.
• LoggedOff - пользователь не выполнил вход в АРМ.
• Busy - у пользователя открыто диалоговое окно (форма накладной или другая форма редактирования записи). При этом можно выполнить запрос, который не требует участия пользователя, например, блокировка, создание или обновление накладной без открытия формы.
• Ready - пользователь не занят редактированием, можно выполнить любой запрос.
• ScaleError - не выводятся текущие показания весов. Это проверяется в АРМ после получения состояния Ready. Т.е. при статусе ScaleError можно выполнять запросы на блокировку, создание или обновление накладной.

7.1.8. URL: …/printform/{request_id}

Метод: GET. Экспорт ответа по накладной в файл PDF. Каталог выгрузки сформированных печатных форм задается в Конфигурации >> файл main\main.ini >> INTERACTION >> printform_dir. При формировании отчета используется шаблон, который задан в Конфигурации >> файл reports\reports.ini >> printform_template_path. Имя файла задается как “{request_id}.pdf”. При наличии одноименного файла в каталоге файл перезаписывается.

Ответ:

Статусы:

• OK - запрос выполнен успешно.
• Exception - ошибка в обработчике запроса на стороне АРМ. Возможная причина: не задан путь к каталогу выгрузки.

7.2. Внешний веб-сервис

На внешний веб-сервис передаются накладные по событиям:

• сохранение любых изменений в накладной;
• добавление взвешивания в накладную;
• блокировка накладной.

Рекомендуется включить в АРМ передачу накладных только по событию блокировки накладной. Это гарантирует, что данные в локальной базе АРМ будут совпадать с переданными данными на сервер.

Адрес внешнего веб-сервиса задается в конфигурации АРМ, в файле main.ini >> INTERACTION. Для каждого метода адрес задается отдельно:

• target_service_status_url (GET)
• target_service_url (POST)
• target_service_process_url (POST)

1. Метод (target_service_status_url)

Назначение метода:

Проверка связи с сервером.

Входные атрибуты (запрос):

без атрибутов

Выходные атрибуты (ответ):

• status [string] - “ok” - сервер готов к работе.

2. Метод (target_service_url)

Назначение метода:

Передача данных из накладных.

Входные атрибуты (запрос):

• type [int] - 1 - есть два взвешивания (тара и брутто); 0 - одно взвешивание или нет взвешиваний.
• date_time [string] - дата/время изменений в накладной в формате “dd.MM.yyyy HH:mm”.
• cargo_net [int] - Масса нетто (кг).
• cargo_gross [int] - Масса брутто (кг).
• cargo_car [int] - Масса тары (кг).
• id_request [int?] - Внешний идентификатор.
• id_trip [int?] - Идентификатор рейса.
• car_number [string] - Номер авто.
• driver_name [string] - Ф.И.О. водителя.
• doc_num [string] - Номер транспортной накладной.

Выходные атрибуты (ответ):

• status [string] - “ok” - сервер принял данные.

3. Метод (target_service_process_url)

Назначение метода:

Передача текущих показаний весов для автоматического режима взвешиваний (фиксация показаний программой сервера).

Входные атрибуты (запрос):

• id_request [int] - Внешний идентификатор.
• id_trip [int] - Идентификатор рейса.
• date_time [string] - Текущие дата/время в формате “dd.MM.yyyy HH:mm:ss”.
• value [int] - Текущие показания весов (кг).

Выходные атрибуты (ответ):

• status [string] - не используется в АРМ.

7.2. Описание полей базы данных

Дата/время хранится как целое число (int) секунд, прошедших с 01.01.2000 00:00:00.

Таблица Waybills - Накладные:

Таблица Weighings - Взвешивания:

Таблица UserAccounts - Пользователи:

Таблица Drivers - Водители:

Таблица Products - Грузы:

Таблица Vehicles, Fractions, CarOwners, Paths - Марки ТС, Фракции материала, Владельцы ТС, Направления:

Таблица NumDefs - Номера ТС:

Таблицы Shippers, Consignees, Forwarders - Грузоотправители, Грузополучатели, Экспедиторы: