Переменные окружения

Переменная окружения - строка, которая используется для хранения текстовой информации, в частности, путь подключения к внешним ресурсам. Переменные окружения задаются в свойствах проекта (Проект → Свойства проекта → Переменные окружения), используются при настройке определения документа или в скриптах.

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

В случае, если проект содержит несколько определений документов, множество правил проверки по базе данных, скриптов, редактирование перечисленных объектов займет много времени.

Чтобы при переносе проекта не изменять все используемые объекты, необходимо в свойствах проекта задать пути к внешним ресурсам с помощью переменных окружения, далее при создании правил, настройке экспорта, написании скриптов использовать эти переменные. Таким образом, при запуске проекта в другой среде использование переменных окружения позволит редактировать параметры подключения только в диалоговом окне Переменные окружения. Это, в свою очередь, упростит процесс.

Типы переменных окружения

Переменные окружения ABBYY FlexiCapture делятся на два типа:

• Строка – текстовая переменная.
• Строка соединения с базой данных - строка соединения с ODBC-совместимой базой данных.

Создание и редактирование переменных окружения

Чтобы создать новую переменную окружения, выполните следующие шаги:

1. В свойствах проекта на вкладке Переменные окружения нажмите кнопку Новая….
2. В открывшемся диалоговом окне выберите тип переменной, введите название переменной. Тип переменной не может быть изменен в дальнейшем.
3. В зависимости от выбранного типа переменной заполните поле Значение следующим образом:
• Для переменной типа Строка введите требуемое значение (например, путь к папке в файловой системе или адрес электронной почты).
• Для переменной типа Строка подключения ADO укажите путь подключения к базе, параметры доступа пользователя и другие параметры соединения в зависимости от выбранного драйвера.
4. При необходимости заполните поле Описание.

Чтобы отредактировать/удалить существующую переменную, нажмите кнопку Правка… / Удалить.

Использование переменных окружения

• Переменные окружения типа Строка можно использовать:
• при настройке источника импорта изображений;
• при настройке экспорта документов в файлы данных и изображений.

При обращении к переменной используется следующий синтаксис: <Env:Название_переменной_окружения> или <$:Название_переменной_окружения>.

• Переменные окружения типа Строка соединения с базой данных могут быть использованы при подключении к различным базам данных в зависимости от назначения, например:
• При создании правила проверки по базе данных;
• В определении документа при настройке экспорта;
• В определении документа при подключении набора данных к внешнему источнику данных;
• В свойствах поля при ограничении области значений.
• В скриптах можно применять переменные окружения любого типа. Для этого необходимо использовать свойство IProperties EnviromentVariables, доступное в интерфейсе IProject.