本章包含：

前言

您可以在消息工具和响应程序中的 Input Mode 下拉列表中指定输入消息的形式（比如， Request, Response, Payload）。通过表单输入，您可以在 UI form 字段中输入参数，它提供了查看和使用现有消息的简单方法（例如，来自开发人员的示例、来自服务器的跟踪、等等）。消息被复制到文本视图后，表单输入视图将以 schema 感知和 schema 约束的方式填充，这种方式更易于编辑、管理和参数化消息。 

常规选项

表单输入视图顶部提供了一个操作下拉菜单，列出了可调用和使用的可用方法及操作。


在输入有效 WSDL URI 时自动创建操作列表。您可以通过从列表中选择一个操作来选择要使用的操作。

主面板包含消息的可扩展表示形式。基于 SOAP 的工具具有用于 SOAP Body 和 SOAP Header的子选项卡。有关 Header 子选项卡的消息，请查阅 Adding SOAP Headers。 如果您在 WSDL 选项卡中选择了纯 XML 消息类型，则 SOAP Body 和 SOAP Header 选项卡不可用。可用控件允许您指定如何为树中每个节点指定参数值。选项包含：

• 固定：如果要通过完成表单字段输入文字值（如字符串），请使用此选项。如果选中 Fixed ，其在 Value 选择框中，请在大开的空间中为工具参数输入文字值。控件的性质将随方法的不同而变化。有关更多详情，请查阅 Specifying Literal Values。

• 参数化：使用此选项可使用数据源中指定的值。必须首先将正确的数据源添加到响应程序套件。

• Auto 使用此选项可以自动生成参数值。当您希望评估服务的约束并决定哪种类型的数据将失败时，自动参数生成特别有用。如果选择了 Auto，您就不许在向控件右侧输入任何内容。值将自动生成。此选项不适用于表单 JSON。

• 脚本：如果希望脚本在运行时生成参数，请使用此选项。如果选择 Script，请单击 Edit Script，然后在打开的对话框中输入方法的位置（或方法本身）。方法应为返回对象（或包含默认构造方法的 Java 类）静态的 Java 方法，并且满足 Web 服务期望的签名。Parasoft 将转换方法为 SOAP 参数，并在工具执行时将其作为 SOAP 调用发送。有关添加方法的常规指南，请查阅 扩展和脚本基础。

• 输入：如果此工具链接到其他工具，并且您希望将第一个工具的结果用作第二个工具的参数，请使用此选项。 

指定文字值

如果根据方法（可能会有许多不同的选项可用）选择了 Fixed ，其在 Value 选择框中，您可以将文字值作为消息的一部分发送。

您可以配置将简单参数作为文字值发送的选项，也可以配置将嵌套参数发送到复杂类型对象（例如数组）中的选项。

配置简单参数

当配置一个简单的参数时，该选项将根据工具中是否指定了数据源以及 WSDL 的 XML 模式是否包含任何 nillable 元素而有所不同。

在为简单参数配置值时，可以使用以下选项：

• nil: 确定工具是否发送 nil 属性。如果启用此选项，工具则将会发送 nil 属性。如果没有启用此选项，工具则将不会发送 nil 属性。请注意，对于表单 JSON，这个字段应为 null 而非 nil。
• 固定值/参数化值：（仅在未选中 nil 多选框和选中“optional”多选框[如果存在]时可用）确定工具发送的值。如果工具中指定了数据源，则您将有机会选择 Fixed 或 Parameterized 值。如果数据源不可用，则仅可输入固定值。
  • Fixed 值是通过在可用的文本字段中编写输入指定的文字值。
    
    
    
    请注意，在上述示例中，第二和第三个固定项左侧的复选框表示该项是可选的。选中该框后，将在消息中发送该元素。如果未选中该框，它将被忽略。
  • Parameterized 值是来自数据源列的值。在配置参数化值时，将出现一个包含来自数据源的列名的下拉框。这些列名对应于工具中指定的数据源。工具将所选定数据源列的所有值作为文字值发送。
    
    
    
    如果从资源库数据源进行参数化，请确保使用记录列表列参数化复杂元素，并使用基元或基元列表列参数化简单元素。

配置嵌套参数

如果工具中指定的 WSDL 包含对象数组，则值框下的 GUI 将显示 Index 列和 Value 列。您将能够嵌套该工具作为消息的一部分发送的参数值。

使用来自数据资源库数据源的分层数据进行参数化

您可以参数化来自 Parasfot 数据资源库数据源列复杂的 XML 元素，它可以引用零个、一个或多个分层记录值。

1. 添加 Parasoft 资源库数据源，如 创建资源库数据源中所述。

2. 参数化所需列，如 Hierarchical Parameterization with Form Views中所述。

高级选项

可在表单输入视图中执行以下高级选项。

添加 SOAP 头文件

表单输入视图中 SOAP Header 子选项卡允许您指定头文件参数。若要添加头文件，请从表单输入视图的头文件子选项卡执行以下操作：

1. 单击 Add 按钮。将显示 Add New SOAP Header 对话框。

2. 选择 Custom， WS-Security， SAML 1.1 Assertion， SAML 2.0 Assertion, WS Addressing, WS ReliableMessaging，或 Import Schema Element作为可选响应头类型的响应头 ，单击 OK。有关可选项的更多详情，请查阅：
   • WS-Security Options
   • WS Addressing Options
   • SAML 1.1 Assertion Options
   • SAML 2.0 Assertion Options
   • WS Reliable Messaging Options

WS-Security 选项

如果从可选响应头类型选中 WS-Security ，通过右侧 GUI 面板中的 Timestamp、 Username Tokens、 BinarySecurityToken和 Optinals 的选项卡获得以下选项：

Timestamp 选项卡

在 Timestamp 选项卡中有以下选项：

Username Tokens 选项卡

在 Username Tokens 选项卡中有以下选项：

BinarySecurityToken 选项卡

在 Username Tokens 选项卡中有以下选项：

Options 选项卡

在 Options 选项卡中有以下选项：

WS Addressing 选项

如果选择了可用头文件类型的 WS Addressing ，将默认发送以下四个头文件类型：Action, To, MessageID, and Reply/To。以下头文件不是默认的：RelatesTo, From, FaultTo.这些头文件类型可以通过右侧 GUI 面板的 Action/To、 MessageID/ReplyTo和 RelatesTo/From/FaultTo 选项卡来配置。默认情况下，还使用 2004/08 命名空间（如 http://schemas.xmlsoap.org/ws/2004/08/addressing）。

Action/To 选项卡

在 Action/To 选项卡中有以下选项：

MessageID/ReplyTo 选项卡

在 MessageID/ReplyTo 选项卡中有以下选项：

RelatesTo/From/FaultTo 选项卡

在 RelatesTo/From/FaultTo 选项卡中有以下选项：

SAML 1.1 断言选项

如果选择了可用头文件类型的 SAML 1.1 Assertion 请查阅 Adding SAML Headers。

SAML 2.0 断言选项

如果选择了可用头文件类型的 SAML 2.0 Assertion ,将提供与 OASIS SAML 令牌配置文件对应的各种选项。有关更多详情，请查阅 http://www.oasis-open.org/committees/tc_home.php?wg_abbrev=security

WS Reliable Messaging 选项

如果选择了可用头文件类型的 WS ReliableMessaging ，将有以下选项：

自定义选项

如果选择了可用头文件类型的 自定义 ，将有以下选项：

Import Schema Element as Header Options

如果选择了可用头文件类型的 Import Schema Element as Header ，将出现一个对话框，您可以从 schema 位置加载声明的元素。加载完元素后，您可以为 SOAP 头文件选择多个元素。一旦您单击 OK，将向工具中添加一个带有选定元素结构的头文件。

Adding SAML Headers

表单输入视图中的 Header 子选项卡允许您指定头文件参数。当添加 SAML 1.1 头文件时，您可以选择四种类型的 SAML 确认方法：

• Sender-Vouches: Unsigned：包含最小的 sender-vouches SAML 断言，请求消息创建中不包含可选元素。没有 SAML 断言所需的签名或证书。
  • 请查阅 Sender-Vouches:SenderVouches Unsigned有关详情，请查阅Unsigned 。
• Sender-Vouches: Unsigned：SSL: 包含最小的 sender-vouches SAML 断言，而不需要签名，但是传输通过 SSL，因此需要证书，以便在传输层支持 SSAL。
  • 请查阅 Sender-Vouches: 未签名的：表单输入有关详情，请查阅SSL 。
• Sender-Vouches: Signed: 包含 sender-vouches SAML 断言，而断言和实体元素都已签名，而用于验证签名的证书的引用将在头中提供。
  • 请查阅 Sender-Vouches:SenderVouches Signed有关详情，请查阅Signed 。
• Holder-of-Key: 包含一个持有密钥的 SAML 断言，其中，使用发布方密钥存储在断言元素上有一个封装的签名，用于验证发布方签名的证书包含在断言签名中。然后使用用户证书署名实体，该证书被包含在断言的 SubjectConfirmation 元素。
  • 请查阅 Sender-Vouches:SenderVouches Signed有关详情，请查阅Signed 。

Sender-Vouches: Unsigned：

若要添加 Sender-Vouches: Unsigned 确认方法, 在表单输入视图的头文件子选项卡执行以下操作：

1. 单击 Add 按钮。将显示 Add New SOAP Header 对话框。
   
   
   
   
2. 选择 SAML 1.1 Assertion 并单击 OK。将显示 SAML Assertion 向导。
   
   
   
   
3. 选择 Sender-Vouches: Unsigned 并单击 Next 按钮。
   
   
   
   
4. 选择所需的 SAML 语句类型并单击 Next。
   
   
   
   
5. 完成 Authentication Statement 所需字段并单击 Finish。有关身份验证语句的更多详情，请查阅 Adding and Modifying SAML Statements。

Sender-Vouches: Unsigned：SSL

若要添加 Sender-Vouches: Unsigned：SSL 确认方法, 在表单输入视图的头文件子选项卡执行以下操作：

1. 单击 Add 按钮。将显示 Add New SOAP Header 对话框。
   
   
   
   
2. 选择 SAML 1.1 Assertion 并单击 OK。将显示 SAML 断言向导。
3. 选择 Sender-Vouches: Unsigned：SSL 并单击 Next 按钮。
   
   
   
   
4. 选择 Use Conditions（如果需要）。
   • 如果选中 Use Conditions ，则选择所需条件类型或 None。
   • 如果选中 Audience Restriction 并且输入了一个大于 0 的值，则单击 Next ， Audience Restriction 控件会提示并相应地填充每个字段。
5. 单击 Next 按钮。
   
   
   
   
6. 选择所需的 SAML 语句类型并单击 Next。
   
   
   
   
7. 完成 Authentication Statement 所需字段并单击 Finish。有关身份验证语句的更多详情，请查阅 Adding and Modifying SAML Statements。

Sender-Vouches: Signed

若要添加 Sender-Vouches: Signed 确认方法, 在表单输入视图的头文件子选项卡执行以下操作：

1. 单击 Add 按钮。将显示 Add New SOAP Header 对话框。
   
   
   
   
2. 选择 SAML 1.1 Assertion 并单击 OK。将显示 SAML Assertion 向导。
   
   
   
   
3. 选择 Sender-Vouches: Signed 并单击 Next 按钮。
   
   
   
   
4. 选择所需 Signature Options 并单击 Next 按钮。
   
   
   
   
5. 选择 Use Conditions（如果需要）。
   • 如果选中 Use Conditions ，则选择所需条件类型或 None。
   • 如果选中 Audience Restriction 并且输入了一个大于 0 的值，则单击 Next ， Audience Restriction 控件会提示并相应地填充每个字段。
6. 单击 Next 按钮。
   
   
   
   
7. 从 Issuer Key Store 下拉菜单中选择要用于断言和主体上的发布方签名的密钥存储库，然后单击 Next。
8. 选择所需的 SAML 语句类型并单击 Next。
   
   
   
   
9. 完成 Authentication Statement 所需字段并单击 Finish。有关身份验证语句的更多详情，请查阅 Adding and Modifying SAML Statements。

Holder-of-Key

若要添加 Holder-of-Key 确认方法, 在表单输入视图的头文件子选项卡执行以下操作：

1. 单击 Add 按钮。将显示 Add New SOAP Header 对话框。
   
   
   
   
2. 选择 SAML 1.1 Assertion 并单击 OK。将显示 SAML Assertion 向导。
   
   
   
   
3. 选择 Holder-of-Key 然后单击 Next 按钮。
   
   
   
   
4. 选择 Use Conditions（如果需要）。
   • 如果选中 Use Conditions ，则选择所需条件类型或 None。
   • 如果选中 Audience Restriction 并且输入了一个大于 0 的值，则单击 Next ， Audience Restriction 控件会提示并相应地填充每个字段。
5. 单击 Next 按钮。
   
   
   
   
6. 选择用于断言元素上的发行者封装签名的密钥存储库，以及用户用于签名主体元素的密钥存储库，然后单击 Next。
7. 选择所需的 SAML 语句类型并单击 Next。
   
   
   
   
8. 完成 Authentication Statement 所需字段并单击 Finish。有关身份验证语句的更多详情，请查阅 Adding and Modifying SAML Statements。

添加和修改 SAML 语句

在创建断言期间必须添加 SAML 语句。以下可供选择：

• Authentication Statement
• Authorization Decision Statement
• Attribute Statement

创建断言之后，可以添加和修改 SAML 语句，以便扩展或自定义断言。为此：

1. 选择 SOAP Header 选项卡中的 SAML 断言。
2. 单击 Modify。
   
   
   
   
3. 在打开的对话框中编辑断言和添加或编辑 SAML 语句。
   • 当添加或修改语句时，请确保填写每个启用的字段。这些都是语句的最低要求。如果需要，将默认启用已禁用的字段，同时为它们填写字段。
   • 默认情况下， wsse:Security 元素包括 SAML 断言元素（根据 WS-Security SAML 概要文件规范）。如果您想把它直接放在头文件下面（如：允许与期望 SAML 断言元素直接位于 SOAP 信封头之下且不知道 WS-Security 的系统兼容），则请跳转至 WS-Security Attributes 选项卡并禁用掉 Wrap with a wsse:Security 元素。