Вызов XML - сведения

Элементы Вызов XML содержат данные вызова и транспортную информацию для него. Данные вызова состоят из кода XML, передаваемого по транспортному протоколу HTTP или JMS. Сведения о транспортном протоколе - это информация, необходимая для отправки, получения и ответа в зависимости от выбранного протокола.

Автоматически обновить имя узла: Когда этот параметр включен, автоматически обновляется имя элемента вызова XML в тесте.
Односторонний: Этот параметр указывает, что ответ сервера после вызова не ожидается. Этот параметр выключает кнопку Обновить возвращаемые данные.
Тайм-аут (мс): Значение тайм-аута в миллисекундах. Если ответ не будет получен в течение указанного времени, возникнет ошибка.
Время обработки (мс): Программно вычисляемое время задержки для каждого пользователя в случае выполнения теста с несколькими виртуальными пользователями. Время обработки - это статистическая имитация времени, которое пользователи затрачивают на чтение или принятие решения перед выполнением действия.
Обновить возвращаемые данные: Эта кнопка открывает окно Предварительный просмотр возвращаемых данных. В этом окне можно выполнить вызов из рабочей области для создания или обновления возвращаемого сообщения, связанного с вызовом.

Сообщение

На этих страницах можно просмотреть данные XML вызова и получить доступ к корреляции данных в трех разных формах

Форма

Упрощенное представление сообщения, предназначенное для редактирования кода XML. В меню Схема можно включить режим помощника по редактированию кода XML, помогающий обеспечить соответствие кода XML спецификации XSD.

На панели Форма добавьте заголовки XML, необходимые для стандартных вызовов веб-служб. На панели Заголовок нажмите Добавить ( кнопка Добавить ), чтобы добавить структуру заголовка XML по умолчанию для запросов WS-Addressing, WS-ReliableMessaging или WS-Coordination, или выберите Дополнительно для других стандартов. Можно включать и выключать элементы заголовка XML и настраивать значения всех элементов XML. Выполняются проверки для гарантии правильности кода XML.

Прим.: Для того чтобы добавить заголовки XML к вызовам в IBM® Security AppScan, добавьте алгоритм Статические заголовки XML на вкладке Стек запросов запроса.

Дерево

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

Используйте столбец Пропустить, если пустой для выбора пустых элементов XML, которые следует пропустить. Этот столбец отображается только в том случае, если включен переключатель Показать столбец 'Пропустить, если пустой' в программе просмотра структуры XML на странице Окно > Параметры > Тест > Редактор тестов > Тест службы.

С помощью кнопки Фильтр можно скрыть или отобразить пространство имен, атрибут или текстовые узлы - в зависимости от своих требований.

Опция Разрешить только допустимые изменения позволяет активировать интеллектуальное редактирование, основанное на указанном документе схемы XML (XSD). Для задания набора документов XSD для рабочей среды в навигаторе тестов щелкните правой кнопкой мыши на проекте и выберите пункт Свойства и затем Каталог схем. Если схемы XSD нет или она не нужна, то опцию Разрешить только допустимые изменения следует выключить.

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

Исходный код

На этой панели отображается содержимое сообщения в формате XML или текстовом формате. Для форматирования кода XML выберите Форматировать текст XML. Для свертывания кода XML в одну строку выберите Упаковать текст XML в одну строку. Для кода JSON доступны аналогичные управляющие элементы.

Важное замечание: На панели Исходный код нельзя изменять теги, начинающиеся с SoaTag. Их изменение или удаление приведет к повреждению ссылок и подстановок. Восстановление удаленных тегов невозможно.

Вложения

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

ИД содержимого - это идентификатор, с помощью которого вызов обращается к вложениям. Способ применения этого идентификатора зависит от требований сервера.

Протокол

Эта страница содержит параметры протокола для отправки вызова. Протокол может быть HTTP или JMS индивидуально для каждого сообщения.

HTTP

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

Метод

Этот параметр позволяет указать метод HTTP для вызова XML. Поддерживаются следующие методы:

POST
GET
PUT
DELETE

Версия

Этот параметр позволяет выбрать версию HTTP (1.0 или 1.1).

URL

В этом поле указывается URL вызова XML.

Заголовки

Этот раздел позволяет добавить заголовки в вызов. Заголовки должны быть совместимы с указанным методом HTTP.

Приложение управляет следующими заголовками (их нельзя добавлять):

User-Agent
Host, Connection
Cache-Control
Pragma
Content-Type
Content-Length

Cookie

Этот раздел позволяет управлять cookie. Можно добавлять, изменять и удалять cookie и создавать ссылки.

JMS

На этой странице можно добавить прикрепляемые к вызову строки свойств для локальной конфигурации JMS. Они будут отправлены в виде свойств сообщения через JMS.

MQ

На этой странице можно переопределить добавляемые в вызов параметры для локальной конфигурации WebSphere MQ.

Имя

Это имя, показываемое в вызове сообщения как ссылка на эту конфигурацию протокола.

Имя администратора очередей

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

Имя очереди

Имя очереди, управляемой администратором очередей.

Использовать локальный администратор очередей

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

Адрес администратора очередей

IP-адрес или имя хоста удаленного сервера MQ.

Порт администратора очередей

Порт удаленного сервера MQ.

Канал клиента

Канал режима соединения с сервером удаленного администратора очередей.

Использовать временную очередь

Указывает, создает ли сервер MQ временную очередь. Если эта опция выбрана, то будет создана временная очередь, единственной целью которой будет получение заданных сообщений. Потом эта очередь будет удалена.

Имя очереди

Если переключатель Использовать временную очередь выключен, в этом параметре указывается имя очереди, куда поступают возвращаемые сообщения с сервера MQ. Этой очередью должен управлять администратор очередей, указанный в поле Имя администратора очередей.

Вызовы и возвращаемые сообщения связываются по идентификатору зависимости в сообщении MQ. Это значит, что параметру отчета сообщения присваивается значение MQC.MQRO_COPY_MSG_ID_TO_CORREL_ID. Сервер должен учитывать это ограничение. Это обеспечивает поддержку транспортного протокола для SOAP, предоставляемого WebSphere MQ.

Целевая служба

Этот параметр предназначен для Microsoft .NET с транспортным протоколом IBM WebSphere MQ для SOAP. В нем указывается имя файла ASPX в каталоге обработчика событий .NET.

Использовать заголовок RFH2

Указывает, используется ли в сообщениях SOAP заголовок RFH2, в котором применяется предопределенный формат сообщения MQ. Когда выбран, другие параметры раздела Дескриптор сообщения становятся неактивными. Этот параметр используется для транспортного протокола WebSphere MQ для SOAP. Если используется привязка WebSphere Integration Developer (WID) MQ, она поддерживает сообщения и с заголовком RFH2, и без.

Дескриптор сообщения

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

Использовать временную очередь

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

Соединение SSL

Позволяет задать использование конфигурации SSL, если параметр Канал клиента указывает на защищенный канал. Кнопка Открыть редактор SSL позволяет создать новую конфигурацию SSL, а кнопка Изменить - изменить конфигурацию, связанную с текущим тестом.

Если в WSDL, применяемом для создания вызова сообщения, сервер WebSphere MQ указан с помощью поддерживаемого URI JMS, то конфигурация SSL создается автоматически. Если генератору тестов не удалось создать конфигурацию SSL, ее необходимо создать вручную.

Если WSDL создан службой WebSphere MQ (amqwdeployWMService), то в нем необходимо поменять привязку транспортного протокола с HTTP на JMS для предотвращения создания конфигурации HTTP генератором тестов.

Комплект шифров

Комплект шифров, используемый в конфигурации канала.

Локальная защита XML

Эта страница предназначена для добавления пользовательского алгоритма защиты, реализованного в классе Java™. Пользовательские алгоритмы можно применять к данным XML, которые отправляются на сервер или принимаются с сервера.

Добавить, Вставить, Удалить, Переместить вверх и Переместить вниз

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

Инструменты

Эта кнопка позволяет изменить режим отображения стека алгоритмов.

Пользовательский алгоритм защиты

После добавления пользовательского алгоритма защиты в стек. В этом окне можно указать класс Java с реализацией алгоритма. Этот класс Java использует следующий интерфейс:

/**
* ***************************************************************
* IBM Confidential
* 
* (c) Copyright IBM Corporation. 2008. Все права защищены.
* 
* The source code for this program is not published or otherwise
* divested of its trade secrets, irrespective of what has been
* deposited with the U.S. Copyright Office.
* *************************************************************** 
* 
*/

package com.ibm.rational.test.lt.models.wscore.datamodel.security.xmlsec;

import java.util.Properties;
import org.w3c.dom.Document;


public interface ICustomSecurityAlgorithm {
	
	/**
	 * Следующие методы допустимы в обоих случаях:
	 * Выполнение в рабочей среде и выполнение теста.
	 */
	
	
	/**
	 * Вызывается для обработки документа, передаваемого передаваемого по транспортному протоколу.
	 * @param subject
	 */
	void process(Document subject);
	/**
	 * Вызывается для обратной обработки документа, полученного с сервера.
	 * @param subject
	 */
	void unProcess(Document subject);
	
	/**
	 * Свойства, заданные в пользовательском интерфейсе CustomSecurityAlgorithm.
	 * @param map
	 */
	void setProperties(Properties map);
	
	/**
	 * Следующие методы допустимы только в контексте преобразования в интерфейс службы тестирования
	 * или доступа к предыдущей информации XML, если файл jar с пользовательским алгоритмом защиты
	 * развернут в проекте тестирования производительности. В этом случае алгоритм нельзя использовать
	 * непосредственно из рабочей среды.
	 */
	
	/**
	 * Этот объект соответствует объекту ITestExecutionService.
	 * Он относится только к алгоритму, связанному с выполнением теста.
	 * Для применения этого объекта файл jar с реализацией следует развернуть
	 * в проекте тестирования производительности, а не в среде JRE.
	 * 
	 * Предыдущий документ xml, полученный в ходе выполнения, можно получить с
	 * помощью следующей строки:
	 * IDataArea area = ((ITestExecutionService)executionObject).findDataArea(IDataArea.VIRTUALUSER);
	 *String previousXML = (String) area.get("PREVIOUS_XML"); //$NON-NLS-1$
	 * 
	 */
	void setExecutionContext(Object executionObject);

Метод process изменяет XML перед отправкой серверу.
Метод unprocess изменяет XML после приема сервером.
Метод setProperties извлекает свойства пользовательского интерфейса защиты из редактора защиты.
Метод setExecutionContext вызывается в ходе тестирования с объектом ITestExecutionServices, который соответствует сообщению, использующему этот пользовательский интерфейс защиты.

Имя класса пользовательского алгоритма защиты: В этом поле указывается класс с реализацией алгоритма защиты. Нажмите кнопку Выбрать класс и выберите класс в рабочей области.
Имя алгоритма: В этом поле указывается имя текущего алгоритма.
Свойства: В этом списке указываются свойства, используемые методом setProperties в алгоритме. Список свойств создается кнопками Добавить, Удалить и Изменить.

Комментарии