Утилита GrdUtil.exe позволяет сохранять шаблоны образов, прошивки ключей и списки конечных пользователей во встроенной базе формата Microsoft Access (*.mdb). Информация из базы данных может быть в любой момент использована для программирования и обновления памяти ключей, в том числе дистанционного.
Важно!
Режим базы данных является основным и рекомендуемым способом работыс GrdUtil.exe.
Каждый факт записи шаблона образа в ключ фиксируется и сохраняется в базе в виде так называемой прошивки. В прошивках могут содержаться данные, уникальные для каждого ключа. Поэтомув дальнейшем прошивки активно используются для обновления памяти ключей, а также для получения статистических отчетов по любым параметрам прошивок.
Если же база данных отключена, то образ, который нужно записать в ключ, загружается из файла *.nsd, и результаты программирования не сохраняются. Это сужает возможности обновления и программирования памяти ключей и увеличивает временные и трудозатраты на обслуживание ключей.
Настройка базы данных
Чтобы настроить базу данных GrdUtil.exe, выполните команду меню База данных | Настройка базы данных.
Важно!
Настройка базы данных возможна только при отключенном режиме базы данных.
На экране появится диалог, выполненный в виде Мастера, состоящего из нескольких страниц. Переход между страницами осуществляется с помощью кнопок [Далее] и [Назад], расположенных в нижней части диалога.
1. На первой странице Мастера выберите тип настройки базы данных Экспресс-настройка:
Важно!
1. Вариант Пользовательская настройка в данном руководстве подробно не рассматривается. Он необходим только в ситуации, когда предполагается использование базы данных с какими-либо специфичными настройками, например, при использовании Microsoft SQL Server. В таком случае настройка базы данных должна выполняться системным администратором.
2. В состав ПО Guardant входят SQL-скрипты для создания БД (см. grdutil_access.sql и grdutil_ms_sql_server.sql в поддиректории Doc каталога установки SDK).
2. После нажатия кнопки [Далее] появляется стандартный системный диалог открытия файла, в котором надо указать путь к файлу базы данных по умолчанию "%Program Files%\Guardant \Guardant %#%%Public Code%\Bin\GrdUtil.mdb":
3. После указания файла базы данных появляется последняя страница диалога. Для завершения процедуры настройки базы данных нажмите на кнопку [Готово]:
После завершения настройки база данных готова к работе.
Работа в сети
Работа в сетевом режиме является побочной возможностью базы GrdUtil.exeи не тестировалась досконально
База данных GrdUtil.exe поддерживает возможность работы в сети. В этом случае файл *.mdb помещается на сетевой диск. Настройка базы данных для работы в сети происходит аналогично (см. выше).
Включение базы данных
Чтобы включить режим базы данных, выполните команду База данных | Режим работы с БД.
После выполнения команды к окну Редактора образа добавятся окна Инструменты базы данных (справа) и Прошивки (внизу):
Конвертация базы данных
Формат базы данных меняется от версии к версии GrdUtil, и в некоторых случаях после обновления комплекта разработчика может требоваться конвертация БД.
Признаком необходимости конвертации служит сообщение, которое выдается при запуске утилиты программирования:
По нажатию на кнопку OK в диалоге сообщения происходит возврат в главное окно утилиты.
Чтобы конвертировать базу данных в актуальный формат, сохраните копию текущей БД и выполните команду меню База данных | Включить базу данных.
На экране появится предупреждение о необратимости операции:
По нажатию на кнопку Да появляется диалог конвертации:
Чтобы начать процесс конвертации, нажмите на кнопку Конвертировать в нижней части диалога. По успешном завершении конвертации будет выдано соответствующее сообщение.
Теперь можно включить базу данных и приступить к работе.
Важно!
Для конвертации базы данных GrdUtil из командной строки служит команда: [путь]GrdUtil.exe -dbConvert
Инструменты базы данных
Окно Инструменты базы данных состоит из набора кнопок-пиктограмм, посредством которых происходит управление базой шаблонов, прошивок и конечных пользователей:
Элемент интерфейса |
Назначение |
|
|---|---|---|
|
Выполнить команду меню *Ключ |
Запись в ключ{*}, Ctrl+W |
|
Загрузить в Редактор образа последнюю прошивку для текущего ключа, подсоединенного к порту |
|
|
Вывести в окне Прошивки список прошивок за указанный период для ключа, подсоединенного к порту |
|
|
Вызвать диалог Образы для работы с базой шаблонов образов |
|
|
Вызвать диалог Клиенты для работы базой конечных пользователей защищенного приложения |
|
|
Вызвать диалог Поиск для задания параметров поиска прошивок, хранящихся в базе данных |
Кроме того, некоторые кнопки дублируются гиперссылками в верхней части окна, упрощающими работу с базой данных.
Образы
Диалог Образы вызывается по нажатию кнопки Управление образами и служит для работы с базой шаблонов образов, которые используются для программирования ключей.
Элементы управления диалога позволяют сохранять шаблоны в базе данных, удалять шаблоны и загружать их в Редактор образа:
Элементы управления диалога Образы:
Элемент интерфейса |
Назначение |
|---|---|
Кнопка |
Загрузить выбранный шаблон образа в Редактор |
Кнопка |
Удалить выбранный шаблон образа из базы данных |
Поле ввода имении версии шаблона образа |
Ввести имя шаблона образа, чтобы выбрать его из списка |
Окно, отображающее список шаблонов |
Основное окно вкладки, в котором отображается списокшаблонов образов. Под окном выводится информация о количестве ключей, запрограммированных текущим шаблоном |
Кнопка |
Сохранить шаблон образа в базе данных |
Кнопка |
Сохранить шаблон образа в базе данных с новым именеми / или версией |
Сохранение шаблона образа в базе данных
При завершении работы с текущим образом GrdUtil.exe запрашивает подтверждение на его сохранение, если изменения не были сохранены:
Внешним признаком того, что образ была изменен, и перед закрытием его необходимо сохранить, служит звездочка после названия образа в заголовке главного окна GrdUtil.exe:
Чтобы сохранить редактируемую маску в базе данных, выполните команду меню База данных | Сохранить образ в БД.
1. Если образ ранее уже сохранялся в базе данных, то сохранение образа происходит сразу после выполнения вышеуказанной команды, без выдачи диалога.
2. Если образ ранее не сохранялся в базе данных, то на экране появится диалоговое окно Сохранить образ в базе данных, содержащее поля ввода Имя и Версия. Первое служит для задания имени (по умолчанию модель ключа), второе – для задания версии образа (по умолчанию 1.0).
По нажатию кнопки [OK] происходит сохранение образа в базе данных. Сохраненный образ появляется в списке шаблонов в диалоге Образы.
Имя и версия сохраненного образа, а также указание на то, что образ сохранен в базе данных, отображаются в заголовке главного окна GrdUtil.exe:
Имя и версия сохраненного образа также будут отображаться в секции критериев поиска (окно Инструменты базы данных).
Сохранение шаблона образа в базе данных под другим именем
В базе данных нельзя сохранить маску, имя и версия которой совпадают с именем и версией шаблона, уже имеющегося в базе. В этом случае GrdUtil.exe выдает предупреждение и предлагает сохранить шаблон с другой версией.
Чтобы сохранить редактируемую маску с другим именем и/или новой версией, выполните команду База данных | Записать маску в базу данных, как...
На экране появляется диалог Сохранить шаблон в базе данных, содержащий 2 поля ввода: Имя и Версия. Первое служит для задания имени (по умолчанию содержит текущее имя образа), второе – для задания версии образа (по умолчанию содержит увеличенное на 1.0 текущее значение версии образа).
По нажатию кнопки [OK] происходит сохранение образа в базе данных. Сохраненный образ появляется в списке шаблонов в окне вкладки Образы.
Имя и версия сохраненного образа, а также указание на то, что образ сохранен в базе данных, отображаются в заголовке главного окна GrdUtil.exe:
Загрузка шаблона образа из базы данных
Чтобы загрузить маску из базы данных в Редактор, выделите нужную строку в списке шаблонов образов и выполните команду База данных | Загрузить маску из базы данных (или дважды щелкните левой кнопкой мыши на выделенной строке).
Выбранный образ будет загружен в Редактор. В заголовке главного окна GrdUtil.exe отобразятся имя и версия образа, а также указание на то, что образ загружен в Редактор из базы данных:
Имя и версия загруженного в Редактор образа также будут отображаться в секции критериев поиска (окно Инструменты базы данных).
После загрузки образа Редактор показывает список полей и значения, записанные в них на момент последней модификации образа.
Удаление шаблона образа из базы данных
Чтобы удалить маску из базы данных, выделите нужную строку в списке образов и выполните команду База данных | Удалить маску из базы данных.
1. Если удаляемый шаблон образа уже был использован для программирования ключей, то с ним связаны прошивки – записи в базе данных о каждом факте программирования электронного ключа определенной образом.
В этом случае шаблон образа невозможно удалить до удаления всех прошивок, которые на нем основаны. При попытке удаления GrdUtil.exe выдаст сообщение:
После удаления всех прошивок (см. пункт Удаление прошивки), связанных с данным шаблоном, шаблон можно будет удалить. При этом утилита запросит подтверждение на удаление из базы данных:
После нажатия кнопки [Да] в диалоге подтверждения шаблон образа будет удален из базы данных.
2. Если удаляемый шаблон образа не использовался для программирования ключей, то маску можно удалить сразу же, после вывода на экран формального диалога подтверждения на удаление образа (см. выше).
Клиенты
Диалог Клиенты вызывается по нажатию кнопки Управление записями клиентов и служит для работы с базой конечных пользователей защищенного приложения. Элементы управления диалога позволяют добавлять и удалять конечных пользователей из списка, а также определять пользователя, на которого будет зарегистрирована прошивка:
Элементы управления диалога Клиенты:
Элементинтерфейса |
Назначение |
|---|---|
Кнопка |
Сделать текущим выбранного конечного пользователя. Все прошивки будут регистрироваться на текущего клиента до тех пор, пока не будет выбран другой конечный пользователь. Информация о текущем клиенте отображается напротив кнопки |
Кнопка |
Добавить в базу нового конечного пользователя |
Кнопка |
Получить информацию о конечном пользователе |
Кнопка |
Удалить из базы выбранного конечного пользователя |
Поле вводаимени клиента |
Ввести имя конечного пользователя, чтобы выбрать его из списка |
Окно, отображающее список клиентов |
Основное окно вкладки, в котором отображается список конечныхпользователей. Под окном выводится информация о количествеключей, запрограммированных для текущего пользователя |
В начале работы с базой данных диалог Клиенты содержит только пользователя по умолчанию (запись Anonymous).
Добавление клиента в базу данных
Чтобы добавить нового конечного пользователя в базу данных, выполните команду База данных | Добавить клиента.
В появившемся диалоге Клиенты заполните следующие поля ввода: Имя клиента, Номер телефона, Адрес, Примечания.
Назначение этих полей следует из их названий.
Обязательным для заполнения является только поле Имя клиента.
После заполнения полей нажмите на кнопку [ОК] для завершения диалога: имя нового клиента появится в списке диалога Клиенты.
Важно!
В базе данных не может быть нескольких конечных пользователей с одинаковыми именами. При попытке добавления клиента, имя которого совпадает с именем клиента, уже сохраненного в базе, выдается предупреждение.
Редактирование информации о клиенте
Чтобы получить или изменить информацию о конечном пользователе, выберите его имя в списке и выполните команду База данных | Информация о пользователе.
В появившемся диалоге Клиенты (см. предыдущий пункт), можно изменить содержимое всех полей ввода, кроме поля Имя клиента.
Регистрация прошивки на выбранного клиента
Чтобы программируемые ключи регистрировались на определенного конечного пользователя, необходимо предварительно выбрать его из списка клиентов – сделать его текущим.
Для этого выполните команду База данных | Выбрать пользователя. Команду удобно выполнять двойным щелчком мыши или нажатием клавиши [Enter] на нужной строке списка.
После выбора клиента его имя устанавливается в поле ввода (вкладка Клиенты), а также отображается над этим полем с пометкой текущий.
Все программируемые в дальнейшем ключи будут регистрироваться в базе данных на текущего пользователя до момента выбора другого клиента.
Удаление клиента из базы данных
Чтобы удалить конечного пользователя из базы данных, выделите мышью нужную строку в списке и выполните команду База данных | Удалить клиента.
1. Если на удаляемого клиента уже регистрировались программируемые ключи, то с ним связаны прошивки – записи в базе данных о каждом факте программирования электронного ключа для этого клиента.
В таком случае удалить клиента будет невозможно до удаления всех прошивок, которые на него зарегистрированы.
После удаления всех прошивок, связанных с данным клиентом, его можно будет удалить. При этом утилита запросит подтверждение на удаление клиента из базы данных:
После нажатия кнопки [Да] в диалоге подтверждения клиент будет удален из базы данных.
2. Если на удаляемого клиента не регистрировались программируемые ключи, то его можно удалить сразу же после вывода на экран формального диалога подтверждения на удаление клиента.
Поиск
Диалог Поиск вызывается по нажатию кнопки Поиск прошивок ключей и служит для задания параметров поиска прошивок, хранящихся в базе данных. Диалог содержит набор флагов, установка / снятие которых определяет критерии поиска:
Можно задавать, как отдельные параметры поиска, так и их произвольные комбинации. При этом необходимо учитывать, что поиск осуществляется по строгому соответствию заданным параметрам,т. е. чтобы получить положительный результат поиска, необходимо выполнение ВСЕХ его условий.
Т. о., к примеру, всегда можно узнать в какой именно ключ (ID, тип) записан тот или иной образ (имя, версия), и у какого конечного пользователя этот ключ должен находиться.
Важно!
1. При первом запуске базы данных параметры поиска не заданы, в дальнейшем состояние критериев поиска запоминается, и они содержат те значения, которые имели на момент последней установки.
2. Если параметры поиска не заданы, то после выполнения команды База данных | Получить список прошивок в окне Прошивки будут выведены все прошивки, зарегистрированные на данного пользователя.
Элементы управления вкладки Поиск:
Элемент интерфейса |
Назначение |
|---|---|
Флаг Использовать имя образа |
Вывести в результатах поиска все прошивки для текущего образа. При поиске прошивок учитывается имя образа |
Флаг Использовать версию образа |
Вывести в результатах поиска все прошивки для текущего образа. При поиске прошивок учитывается версия образа |
Флаг Использовать имя клиента |
Вывести в результатах поиска все прошивки для текущего конечного пользователя. Выбор текущего пользователя происходит на вкладке Клиенты |
Флаг Использовать тип ключа |
Вывести в результатах поиска все прошивки для ключей заданного типа. Тип ключа выбирается из списка, который становится доступным после установки флага |
Список для выборатипа ключа |
Выбрать тип ключа для использования в качестве критерия поиска. Возможные варианты^*^ В GrdUtil.exe не различаются локальные и сетевые ключи. Поэтому при поддержке обеих разновидностей ключей (например, Guardant Sign и Guardant Sign Net) рекомендуется создавать отдельные маски для программирования локальных и сетевых ключей.: Guardant Sign/ Time /Code /CodeTime / Stealth III / Stealth II / Stealth / Fidus |
Флаг Использовать ID ключа |
Вывести в результатах поиска все прошивки для ключа с заданным ID. Идентификатор считывается из ключа, подсоединенного к порту, либо вводится вручную в поле, которое становится доступным после установки флага |
Поле ввода ID ключа |
Ввести идентификатор ключа, который будет использоваться в качестве критерия поиска |
Кнопка Получить ID из ключа |
Считать идентификатор из ключа, подсоединенного к порту. В случае, когда ключей несколько, считывается ID первого найденного ключа |
Флаг Использовать даты |
Вывести в результатах поиска все прошивки за указанное время. |
Флаг Использовать Точную дату |
Вывести в результатах поиска все прошивки за указанную дату (число, месяц, год). Дата задается при помощи календаря, открывающегося по нажатию кнопки выпадающего списка, либо вручную, путем редактирования даты в поле ввода |
Флаги Запись с даты/ Запись по дату |
Вывести в результатах поиска все прошивки за указанный временной диапазон. Начальное и/ или конечное значение диапазона задается при помощи календаря, открывающегося по нажатию кнопки выпадающего списка, либо вручную, путем редактирования даты в поле ввода |
Вывод результатов поиска
Чтобы найти прошивки согласно заданным критериям поиска, выполните команду меню База данных | Поиск прошивок ключей.
Результаты поиска в виде списка прошивок выводятся в окне Прошивки, расположенном в нижней части окна GrdUtil.exe (см. скриншот в разделе Прошивки).
Сброс результатов поиска
Чтобы очистить окно Прошивки от текущих результатов поиска, щелкните на любой строке списка правой кнопкой мыши и выберите пункт Очистить результаты поиска в появившемся контекстном меню.