配置接收器REST适配器以将信息从集成服务器发送到Web服务提供商。
先决条件
您已经使用适配器类型REST创建了接收器通道，并选择在集成目录中对其进行配置。
程序
配置代理服务器
如果可以使用HTTP代理服务器访问REST服务提供商，则可以配置为使用它。激活Use Proxy并输入主机名和代理用于接收HTTP请求的端口。如果代理需要用户身份验证，请输入用户名和密码。
定义自定义HTTP标头
用户定义的HTTP头元素可以在HTTP头选项卡上定义。用户定义的标头将覆盖任何自动添加的标头–例如，定义授权标头将覆盖通道中的其他身份验证设置。
标题值可能包含REST URL选项卡上定义的所有占位符。
定义传输级安全性
对于使用X.509启用TLS/SSL的端点身份验证，您可以配置证书：如果服务器从客户端请求证书，请激活使用客户端证书，并在密钥存储视图中指定密钥存储的名称，在密钥存储条目中指定证书别名。如果服务器需要用户身份验证，请激活“使用基本身份验证”并指定用户名和密码。
如果服务器需要使用OAuth SAML承载令牌配置文件进行身份验证，请使用OAuth激活Authorize并选择SAML承载断言流。
在访问令牌URL参数中指定访问令牌端点的URL，并在选项SAML Issuer、SAML Audience和SAML Recipient中配置该端点预期的SAML特定设置。使用SAML颁发者密钥存储和SAML颁发者密钥别名选项选择用于对断言进行签名的证书和密钥。
如果通道不使用主体传播，请在SAML主题选项中指定静态用户。
定义网络超时
您可以通过以秒为单位指定等待时间来配置连接和套接字超时。默认值为300。
定义REST URL
指定目标URL及其动态部分的信息源。REST请求通常提供有关要调用的服务、资源和/或资源类型以及要在URL中执行的操作的信息。
URL模式
URL模式描述了此通道通过使用动态部分的命名占位符生成的完整URL。占位符变量名必须用花括号括起来。
笔记
模式和生成的URL必须是URL编码形式。不应用自动转换。
资源来源
对于构成URL的每个模式变量，可以指定信息源。REST URL选项卡为多达十个变量提供了方便的输入字段。按下表所述指定图案元素。使用其中一个模式变量替换条目字段后，将显示一个新的组或表。通过添加行并在变量列中输入资源的名称，可以在附加模式元素表中定义附加元素。以下选项可用：
| Sources of Resources | ||
| Value Source (Select for common elements) | Type (Enter for additional elements) | Description / Expression |
| Manual Value | Manual | Manually provide a Static Value to be used. |
| Adapter Specific Attribute | Header | Retrieve the value from an Adapter-Specific Attribute by name. The predefined names are: service, resource, id, resource2, id2, operation. |
| XML Content Element | XPath | Retrieve the value from an XML payload by providing the XPath Expression that locates a single element or attribute with simple text content. |
| JSON Content Element | JSON | Retrieve the value from a JSON payload by providing a JSON Expression that locates an element with simple text content. |
| Binding Element | Binding | Retrieve the value from a PI-specific element. The available elements in the Binding Element list and their corresponding Expression entries are as follows:
|
定义REST操作
指定如何确定REST操作。
操作源
以下用于定位信息的选项可用：
| Operation Source | |
| Value Source | Description / Expression |
| Manual Value | Manually provide a Static Value to be used; no mapping (next step) is required. |
| Adapter Specific Attribute | Retrieve the value from an Adapter-Specific Attribute by name. |
| XML Content Element | Retrieve the value from an XML payload by providing the XPath Expression that locates a single element or attribute with simple text content. |
| JSON Content Element | Retrieve the value from a JSON payload by providing a JSON Expression that locates an element with simple text content. |
| Binding Element | Retrieve the value from a PI-specific element by selection from the Binding Element list. |
将源值映射到操作
如果选择了提供动态值（除手动值外的所有值）的源，则可以通过输入表达式来指定与操作关联的值。REST操作选项卡为每个操作提供了一个输入字段。如果定义的源的多个值与操作关联，则可以通过添加行并在操作列中输入GET、POST、PUT或DELETE，以及在表达式列中输入相应的值，在附加操作映射规则表中定义附加映射。
定义请求格式
指定传出消息的数据格式。您可以选择请求数据格式是JSON还是XML。要处理非结构化文本，请选择JSON。消息的外部元素声明操作/消息类型。您可以选择从消息中删除操作。您可以使用字符集名称指定消息的编码。如果预期的数据格式是JSON，则可以选择将XML负载转换为JSON。如果消息包含包装，您可以选择通过激活Strip-Outer元素来删除它。
如果负载预期包含转义XML标记名，则通道可以通过启用删除转义名称开始字符和/或删除无效名称字符的损坏，将转义字符转换回其原始值。在转义序列选项中指定使用的转义序列。
定义响应格式
对于同步场景，请指定响应消息的数据格式。从数据格式列表中选择XML或JSON。要处理非结构化文本，请选择JSON。消息编码可以由字符集源和值（如果适用）指定。您有以下选项：
•使用固定的手动值并提供字符集名称（默认值为UTF-8）
•使用HTTP头中的值（内容类型）
如果格式是JSON，REST适配器可以将其转换为XML。如果您希望根据消息内容在PI中进行进一步处理，这是必要的。激活转换为XML。如果JSON可能包含多个顶级元素，则还可以激活添加包装器元素选项。输入包装器元素的元素名称和元素命名空间。
如果JSON请求预期包含具有无效XML名称开始字符或XML名称字符的键，请激活转义无效名称开始字符和/或Mangle无效名称字符选项。这些将分别用转义序列选项中配置的序列转义XML标记开头或其余部分的无效字符。
定义操作规则
通过将传入操作/消息类型的名称映射回特定于适配器的变量，指定XI操作如何映射到REST资源。您需要为每个操作变量对向操作规则表中添加一行，并提供以下信息：
•PI中与所需操作及其命名空间相关联的消息类型的XI操作
•由保存信息及其值的变量生成的REST资源
定义响应确定
指定响应操作如何映射到XI操作。对于每个操作对，向响应类型表中添加一行，并提供以下信息：
•PI中与所需操作及其命名空间相关联的消息类型的XI操作
•REST响应操作名称和命名空间
后果
您已配置接收器REST适配器。
接收器Ping
当用户启动通道ping时，接收方通道尝试对动态URL执行HTTP头调用，并显示包含URL特定元数据的结果HTTP头。如果此调用成功执行，则动态URL有效。
如果此调用失败，则URL的路径可能错误。然后，接收器通道尝试执行HTTP选项调用，返回带有服务器特定元数据的结果HTTP头。如果此调用成功执行，则主机和端口有效，但动态URL不正确。
如果此调用也失败，则接收方只需尝试查找并连接到服务器。如果连接成功，则服务器不支持HTTP或HTTPS。如果此调用失败，则主机名和/或端口无效，或者服务器根本不允许连接。
2839
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
