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

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

Сообщение

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

Form
This view provides a simplified view of the message that focuses on editing the values of the XML content. Use the Schema menu to enable assistance with editing XML content so that the XML is valid and complies with the XSD specification.

In the Form view, add the XML headers that are required for standard web service calls. On the Header bar, click Add (Add button) to create the default XML header structure for WS-Addressing, WS-ReliableMessaging or WS-Coordination requests, or click More for other standards. You can enable or disable XML header elements and specify the correct values for each XML element. Checks are performed to ensure that the XML content is valid.

Прим.: To add XML headers to calls in IBM® Security AppScan, add a Static XML Headers algorithm on the Request Stack tab of the request.
Tree

This view provides a hierarchical view of the XML structure of the message, including elements, namespaces, and the associated values. You can use Add, Insert, Remove, Up, and Down to edit the XML elements and namespaces in the tree.

Use Skip if Empty column to select the empty XML elements that you want to skip. This column is visible only if you selected the Display the 'Skip if Empty' column in XML tree viewer check box in Window > Preferences > Test > Test editor > Service test.

Click Filter to hide or show namespace, attribute, or text nodes, depending on your requirements.

Click Allow only valid modifications to enable smart editing, based on a specified XML schema document (XSD). To specify a set of XSD documents for the workbench, in the test navigator, right-click the project and select Properties and Schema Catalog. Disable Allow only valid modifications if you do not have an XSD or if you want to bypass the schema.

You can right-click an XML element to convert it to an XML fragment. This enables you to perform data correlation (use datapools and create references) on the entire XML fragment instead of only on the value.

Source
This view displays the source XML content of the message or plain text content. To format XML content, click Format XML text. To wrap XML content into a single line, click Pack XML text to single line. Similar controls are available for JSON content.
Важное замечание: In the Source view, do not edit the tags that start with SoaTag. If you delete or change these tags, any references and substitutions in the test will be broken. You cannot recreate these tags after you delete them.

Вложения

На этой странице перечислены вложения 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 в алгоритме. Список свойств создается кнопками Добавить, Удалить и Изменить.

Комментарии