Переменные среды позволяют стандартизировать пути
вывода, перечисленные в спецификациях документов. Создайте переменную
среды для общего выходного расположения, а затем укажите эту
переменную с именем отдельного файла в спецификации документа.
Для задания переменных среды используется тот же синтаксис, то и
для задания свойств pre-command и post-command; имя переменной среды
должно быть заключено в фигурные скобки: ${переменная}.
Пример: ${MY_RPE_OUTPUT}\defectData\testData.pdf
Прим.: Переменные среды можно задавать на следующих уровнях:
- Пользовательский профайл: переменные пользовательского профайла
доступны только зарегистрированному пользователю.
- Система: переменные системы доступны любому пользователю,
вошедшему в систему.
При использовании переменных среды,
определенных для конкретного пользовательского профайла, документы
следует генерировать с учетной записью этого пользователя. В
противном случае найти переменную среды не удастся.
Если спецификация документа, содержащая переменную среды,
переносится на другой компьютер, необходимо задать переменную среды
на этом компьютере, иначе спецификация документа также не будет
работать.
Преимущества использования переменных среды вместо
абсолютных путей
- Если требуется изменить общее расположение выходных файлов на
другую папку или сервер, то достаточно обновить переменную среды.
Не нужно изменять каждую спецификацию документа по отдельности.
- Можно управлять выводом отчета с помощью API командной строки.
Пример
Создание примера переменной
среды в Microsoft Windows XP:
- Щелкните правой кнопкой мыши на значке Мой
компьютер.
- Выберите пункт Свойства.
- Выберите вкладку Дополнительно.
- Выберите Переменные среды.
- В разделе Системные переменные нажмите кнопку Создать.
- Введите Имя переменной. Пример:
MY_RPE_OUTPUT
- Введите Значение переменной. Пример:
d:\myreports
- Нажмите OK в каждом окне для сохранения
изменений и выхода.
Дополнительная информация о создании
переменных среды в конкретной системе содержится в документации по
этой системе.
Указание переменной среды в пути вывода
спецификации документа:
- В приложении Панель запуска создайте спецификацию документа.
- На панели Спецификация документа выберите тип вывода. Пример: Цель: PDF
- Щелкните правой кнопкой мыши на типе вывода и выберите
Настроить вывод.
- В поле Путь введите путь файла вывода. Пример:
${MY_RPE_OUTPUT}\defectData\testData.pdf
- Нажмите кнопку OK.
- Опубликуйте тестовый документ и убедитесь в том, что вывод
генерируется в правильном расположении.