Специальные поля для атрибутов SOAP
В окне Информация об атрибуте есть два поля для атрибутов SOAP, которые задают, как собираются данные из ответа SOAP.
Поле Тип атрибута может содержать любое значение из списка; это значение управляет возвращаемой информацией об
ответе. Для некоторых типов атрибутов нужно задать значение в поле Значение типа. Тип атрибута по умолчанию - Запрос XPath, который
выполняет запрос XPath контента ответа сервера SOAP. Значение типа - выполняемый запрос XPath. В следующей таблице описаны все типы атрибутов и значения типов, если они требуются.
| Тип атрибута | Описание | Значение типа | Тип возвращенных данных | Различия между протоколом FTP и file |
|---|---|---|---|---|
Запрос XPath |
Выполняет запрос XPath контента, возвращенного из соединения с URL. Запрос должен возвращать данные, нужные для атрибута, а не список узлов. | Запрос XPath для контента, полученного из соединения URL. Если задан запрос выбора строки, то это должен быть запрос XPath относительно запроса выбора строки. | Возвращаемые данные могут быть строкой, числом или отметкой времени. Браузер Agent Builder для SOAP обычно определяет правильный тип данных для атрибута из просматриваемых данных. Если формат данных - DateTime XML, то можно задать отметку времени в качестве типа атрибута, и агент преобразует значение в отметку времени Candle. | Нет |
Время ответа
|
Время в миллисекундах, затраченное на скачивание контента из затребованного URL. | Нет | Целое число (число миллисекунд) | Нет |
Сообщение ответа |
Сообщение ответа HTTP, возвращенное сервером. | Нет | Строка | Сообщение ответа применяется, только если URL использует протокол HTTP или HTTPS. |
Код ответа |
Код ответа HTTP, возвращенный сервером. | Нет | Целое число | Код ответа применяется, только если URL использует протокол HTTP или HTTPS. Для URL Файл или FTP это всегда 0. |
Длина ответа |
Размер контента, скачанного из затребованного URL (в байтах) | Нет | Целое число (размер в байтах) | Нет |
Заголовок ответа |
Заголовок ответа можно использовать для получения значения из одного из полей заголовков ответа URL. Аргумент задает запрашиваемое поле. | Поле заголовка ответа для сбора. | Строка | Обычно в протоколах FTP и file нет заголовков, которые можно собрать. |
URL требования |
С этим URL установлено соединение. Все ключевые слова ответа предоставляют информацию о соединении с этим URL. Для получения информации из контента, возвращенного из URL, можно использовать запрос XPath. | Нет | Строка | Нет |
Опции XPath
Язык XML Path позволяет выбирать узлы в документе XML. Ниже перечислены некоторые возможности использования XPath для источников данных SOAP:
- Использование предикатов в XPath для указания элементов XML, которые соответствуют строкам данных в группе атрибутов IBM® Tivoli Monitoring.
Можно использовать предикаты в XPath, который отображает элементы или атрибуты XML в атрибуты Tivoli Monitoring, как это показано в следующем примере:
Если в XPath есть несколько шагов местонахождения, то каждый шаг местонахождения может содержать один или несколько предикатов. Предикаты могут быть сложными и содержать логические значения или операторы формул. Например:Stat[@name="URLs"]/CountStatistic[@name="URIRequestCount"]/@count//PerformanceMonitor/Node/Server[@name="server1"]/Stat/Stat/Stat[@name="Servlets"]/Stat - Включение в XPath функций набора узлов, если строка содержит несколько элементов XML одного типа. Если позиция элемента XML в узле задает атрибут Tivoli Monitoring, в который отображается элемент. Примеры функций набора узлов:
position(),first(),last()иcount(). - Выполнение простых преобразований данных (например, подстрока). Если вы зададите следующую подстроку:
то XPath возвратит первые 3 символа элемента XML myXMLElement.substring(myXMLElement,1,3)
.., как в следующем примере: /../OrganizationDescription/OrganizationIdentifier