Сервлеты Info*Engine

Сервлет Info*Engine предоставляет интерфейс между Info*Engine и веб-сервером. Этот сервлет можно использовать для вызова заданий Info*Engine непосредственно по протоколу HTTP или HTTPS. При вызове заданий через сервлет Info*Engine виртуальная база данных (VDB) Info*Engine в ответ представляется в виде XML.

Эта форма также предоставляет конфигурацию по умолчанию для сервлета SOAP RPC. SOAP представляет собой облегченный протокол, основанный на XML, который может использоваться сторонними приложениями. Сервлеты SOAP в Info*Engine принимают и обрабатывают запросы SOAP Info*Engine, посылаемые по сети, что позволяет обмениваться информацией и удаленно выполнять пользовательские бизнес-задачи Info*Engine. Дополнительные сведения см. в разделе Службы SOAP.

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

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

Свойства сопоставления имен и паролей пользователей обычно настраиваются в файле wt.properties, а не в утилите "Администрирование свойств". Однако с помощью утилиты "Администрирование свойств" можно задать некоторые свойства сопоставления имен и паролей пользователей при настройке нового адаптера.

Относительный путь к заданию аутентификации, которое создается сайтом для аутентификации пользователей через Info*Engine. Путь связан с настроенной корневой папкой для задач. Свойство является необязательным.

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

Если свойство credentialsMapper не задано, Info*Engine не выполняет серверное задание сопоставления аутентификации перед выполнением указанного задания.

Относительный путь к каталогу, который создается сайтом для хранения файлов сопоставления аутентификации каждого пользователя. Имя каждого файла сопоставления должно совпадать с аутентифицированным именем пользователя, переданным в Info*Engine. Путь к каталогу связан с настроенной корневой папкой для задач. Свойство является необязательным.

◦ Если свойство задано, Info*Engine пытается открыть и прочитать файл сопоставления аутентификации, соответствующий предоставленному имени пользователя

Файл открывается до выполнения бизнес-задачи и до выполнения задания, названного в свойстве credentialsMapper.

credentialsTimeToLive

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

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

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

Путь к корню бизнес-задач XML.

Корневой каталог файловой системы, в котором сервлет может найти все бизнес-задачи XML. Это позволяет сервлету компилировать и выполнять задания локально.

Это свойство удобно использовать, когда сервлет работает без процессора задач.

Папка, в которой находятся скомпилированные задания.

Дополнительные файлы классов и JAR-файлы, которые должны добавляться в путь к классу при компиляции заданий. Введите стандартный путь к классу Java. Для системы Windows в качестве разделителя используется точка с запятой (;). Для системы Unix в качестве разделителя используется двоеточие (:).

compiler.libDirectoryn

Если дополнительные файлы класса и JAR-файлы добавлены в путь к классу, используйте это поле, чтобы указать папку, в которой расположены эти файлы.

Первое значение n должно равняться 1, а далее последовательно увеличиваться.

Корневая папка установки Info*Engine. Корневая папка установки для Info*Engine будет той же, что и корневая папка установки для Windchill (wt.home).

Имя сервера Info*Engine или процессора задач, используемого сервлетом. Это значение предоставлено по умолчанию.

Префикс, используемый в URL-адресах, ссылающихся на бизнес-задачи XML. Этот префикс помогает сервлету определять, следует ли посылать запросы процессору заданий или процессору шаблонов. Значение по умолчанию составляет /infoengine/servlet/IE/tasks/.

Сервлет Info*Engine предоставляет процессору задач URL-адреса, начинающиеся с этого префикса. Например, если используется префикс по умолчанию, то веб-сервер называется myServer, и пользователь вводит следующий URL-адрес:

Сервлет Info*Engine передает URL-адрес процессору задач, который находит и выполняет файл myTask.xml.

Для первой записи в префиксе необходимо задать то же значение, что вы ввели для URL-адреса приложения. Это значение задается при настройке модуля сервлетов для работы с сервлетом Info*Engine. Для модулей сервлетов JRun и Tomcat Windchill задает значение префикса и необходимые для пользователя настройки модуля сервлетов.

PTC не рекомендует изменять элемент префикса /servlet/IE/tasks/. При изменении этой части префикса необходимо вручную внести изменения в модуль сервлетов. Чтобы разрешить использование других ссылочных префиксов URL, настройте переадресацию URL-адресов на веб-сервере.

В Info*Engine можно настроить выполнение определенных заданий при запуске. Например, можно автоматически создавать подписки на очередь или событие. Первое значение n должно равняться 1, а затем последовательно увеличиваться, например, как в следующем примере.

Значением этого свойства является путь к заданию, которое инициируется при запуске Info*Engine.

Дополнительные сведения см. в разделе Задания Info*Engine.

request.xmlParser.debug

Включает отладку анализатора XML. При анализе входящих XML-данных информация печатается в целях отладки.

request.xmlStream.debug

Включает запросы на ведение журналов XML. При этом входящие XML-данные печатаются в целях отладки.

Webject-команда Send-Mail создает и отправляет сообщения по электронной почте. Настройка свойств webject-команды Send-Mail позволяет задавать значения, используемые по умолчанию при выполнении этой webject-команды.

Отправитель по умолчанию (адрес электронной почты, с которого отправляется сообщение), используемый в webject-команде Send-Mail.

Соответствует параметру FROM webject-команды.

Сервер по умолчанию, используемый в webject-команде Send-Mail.

Имя пользователя по умолчанию, которое указывается при соединении с сервером SMTP.

Соответствует параметру ИМЯ ПОЛЬЗОВАТЕЛЯ.

Пароль по умолчанию, связанный со свойством Наименование пользователя SMTP по умолчанию.

Соответствует параметру ПАРОЛЬ.

При первом входе в утилиту "Администрирование свойств" значение параметра Базовый URI генерируется автоматически. Эту информацию можно настроить позднее в параметрах сервлета.

Базовый URI по умолчанию для интерфейса пользователя утилиты "Администрирование свойств". Это значение определяет, какие службы, адаптеры и наборы свойств указываются на главной странице утилиты "Администрирование свойств".

Укажите полный URL-адрес каталога LDAP со свойствами для настройки.

Информация о конфигурации для службы или адаптера может быть обновлена во время работы службы или адаптера, что позволяет обновить свойства без перезапуска.

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

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

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

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