Azure API 管理 WSDL 导入在 SOAP 编码的数组类型上失败

Question

我正在尝试从 WSDL 创建 API，目前在导入步骤期间从 Azure APIM 返回此错误:

Error: Parsing error : Line 17, position 22: Unable to import API from WSDL: Undefined
complexType 'http://schemas.xmlsoap.org/soap/encoding/:Array' is used as a base for 
complex type restriction.

我发现 Array 类型不符合 WSI 标准，但希望了解如何修改 WSDL 使其工作？我不拥有生成 WSDL 的服务，但 WSDL 自创建以来一直没有更改，并且提供商表示我们可以对其进行修改以使 Azure APIM 导入步骤正常工作。只是意味着，由于 Azure APIM 是直通，我可以从 WSDL 中切出什么，从而仍然 (a) 让 Azure APIM 导入它，以及 (b) 允许调用在运行时成功地流经 Azure APIM？

我将 WSDL 精简为这样，但如果有任何问题请告诉我，因为原始 WSDL 大约有 5,500 行:

<?xml version="1.0"?>

<definitions 
    xmlns:s="http://www.w3.org/2001/XMLSchema" 
    xmlns:http="http://schemas.xmlsoap.org/wsdl/http/" 
    xmlns:mime="http://schemas.xmlsoap.org/wsdl/mime/" 
    xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" 
    xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" 
    xmlns:s0="urn:ChestersCopperpotsServiceSoap" 
    xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
    xmlns:atls="http://tempuri.org/vc/atl/server/"
    targetNamespace="urn:ChestersCopperpotsServiceSoap" 
    xmlns="http://schemas.xmlsoap.org/wsdl/"
>
    <types>
        <s:schema targetNamespace="urn:ChestersCopperpotsServiceSoap" attributeFormDefault="qualified" elementFormDefault="qualified">
            <s:import namespace="http://schemas.xmlsoap.org/soap/encoding/"/>
            <s:complexType name="CMessage">
                <s:sequence>
                    <s:element name="Code" type="s:int"/>
                    <s:element name="Text" type="s:string"/>
                </s:sequence>
            </s:complexType>
            <s:complexType name="GetMessages_return_Array">
                <s:complexContent>
                    <s:restriction base="soapenc:Array">
                        <s:attribute ref="soapenc:arrayType" wsdl:arrayType="s0:CMessage[]"/>
                    </s:restriction>
                </s:complexContent>
            </s:complexType>
            <s:complexType name="MyHeader">
                <s:sequence>
                    <s:element name="m_SessionID" type="s:string"/>
                </s:sequence>
            </s:complexType>
        </s:schema>
    </types>

    <message name="GetMessagesIn">
    </message>
    <message name="GetMessagesOut">
        <part name="return" type="s0:GetMessages_return_Array"/>
    </message>
    <message name="m_Header">
        <part name="m_Header" type="s0:MyHeader"/>
    </message>

    <portType name="ChestersCopperpotsServiceSoap">
        <operation name="GetMessages">
            <input message="s0:GetMessagesIn"/>
            <output message="s0:GetMessagesOut"/>
        </operation>
    </portType>

    <binding name="ChestersCopperpotsServiceSoap" type="s0:ChestersCopperpotsServiceSoap">
        <soap:binding transport="http://schemas.xmlsoap.org/soap/http" style="rpc"/>
        <operation name="GetMessages">
            <soap:operation soapAction="#GetMessages" style="rpc"/>
            <input>
                <soap:body use="encoded" namespace="urn:ChestersCopperpotsService" encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"/>
                <soap:header message="s0:m_Header" part="m_Header" use="encoded" namespace="urn:ChestersCopperpotsService" encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"/>
            </input>
            <output>
                <soap:body use="encoded" namespace="urn:ChestersCopperpotsService" encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"/>
                <soap:header message="s0:m_Header" part="m_Header"  use="encoded" namespace="urn:ChestersCopperpotsService" encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"/>
            </output>
        </operation>
    </binding>

    <service name="ChestersCopperpotsService">
        <port name="ChestersCopperpotsServiceSoap" binding="s0:ChestersCopperpotsServiceSoap">
            <soap:address location="http://localhost:80/ChestersCopperpots/ccSOAP.dll?Handler=Default"/>
        </port>
    </service>

</definitions>

来自 Azure APIM 的完整消息堆栈为:

Informational: ParsingXMLStarted : Started parsing XML
Informational: ParsingXMLComplete : Completed parsing XML
Verbose: WsdlImportRuleVerifyWadl11Schema : WSDL validated against XML Schema
Informational: WsdlPrecheckComplete : Completed WSDL verification. WSDL is considered valid.
Informational: WsdlParsingStarted : Service : Endpoint :
Informational: WsdlIdentification : WsdlVersion: 'Wsdl11' TargetNamespace: 'urn:ChestersCopperpotsServiceSoap'.
Informational: LoadedSchema : Target Namespace: 'urn:ChestersCopperpotsServiceSoap'.
Informational: LoadedSchemas : Loaded '1' schemas.
Informational: LoadedTypes : Loaded '0' types.
Informational: LoadedMessages : Loaded '3' messages.
Informational: LoadedInterfaces : Loaded '1' interfaces.
Informational: LoadedBindings : Loaded '1' bindings.
Informational: LoadedServices : Loaded '1' services.
Informational: WsdlParsingComplete : Parsed 1 operations and 3 messages
Informational: ApiType : Creating SOAP Passthrough API
Informational: APICreated : Name : chesterscopperpotsservice Service Url: http://localhost:80/ChestersCopperpots/ccSOAP.dll?Handler=Default
Informational: XsdParsing : Starting to parse urn:ChestersCopperpotsServiceSoap
Error: Parsing error : Line 17, position 22: Unable to import API from WSDL: Undefined complexType 'http://schemas.xmlsoap.org/soap/encoding/:Array' is used as a base for complex type restriction.

Answer 1

我的钱在这部分(由于缺少行#，我怀疑这是触发错误的地方)。 APIM 中的 SOAP 到 REST 转换仅支持“嵌入”数组，而您的数组引用的是另一个定义(上面的“s0.CMessage”)。尝试用

替换该位

<s:complexType name="GetMessages_return_Array">
                <sequence>
                    <element name="ArrayOfCMessages" type="CMessage" minOccurs="1" maxOccurs="1"/>
            </sequence>
</s:complexType>