Merge pull request #80724 from vladvino/soapArrays

Clarified array support in WSDL

Author: GitHubber17

articles/api-management/api-management-api-import-restrictions.md

@@ -13,12 +13,14 @@ ms.workload: mobile
 ms.tgt_pltfrm: na
 ms.devlang: na
 ms.topic: article
-ms.date: 09/29/2017
+ms.date: 06/26/2019
 ms.author: apipm
-
 ---
+
 # API import restrictions and known issues
+
 ## About this list
+
 When importing an API, you might come across some restrictions or identify issues that need to be rectified before you can successfully import. This article documents these, organized by the import format of the API.
 
 ## <a name="open-api"> </a>OpenAPI/Swagger
@@ -27,35 +29,54 @@ If you're receiving errors importing your OpenAPI document, make sure you've val
 
 ### <a name="open-api-general"> </a>General
 
-* Required parameters across both path and query must have unique names. (In OpenAPI a parameter name only needs to be unique within a location, for example path, query, header. However, in API Management we allow operations to be discriminated by both path and query parameters (which OpenAPI doesn't support). That's why we require parameter names to be unique within the entire URL template.)
-* **$ref** pointers can't reference external files.
-* **x-ms-paths** and **x-servers** are the only supported extensions.
-* Custom extensions are ignored on import and aren't saved or preserved for export.
-* **Recursion** - API Management doesn't support definitions defined recursively (for example, schemas referring to themselves).
-* Source file URL (if available) is applied to relative server URLs.
+-   Required parameters across both path and query must have unique names. (In OpenAPI a parameter name only needs to be unique within a location, for example path, query, header. However, in API Management we allow operations to be discriminated by both path and query parameters (which OpenAPI doesn't support). That's why we require parameter names to be unique within the entire URL template.)
+-   **\$ref** pointers can't reference external files.
+-   **x-ms-paths** and **x-servers** are the only supported extensions.
+-   Custom extensions are ignored on import and aren't saved or preserved for export.
+-   **Recursion** - API Management doesn't support definitions defined recursively (for example, schemas referring to themselves).
+-   Source file URL (if available) is applied to relative server URLs.
 
 ### <a name="open-api-v2"> </a>OpenAPI version 2
 
-* Only JSON format is supported.
+-   Only JSON format is supported.
 
 ### <a name="open-api-v3"> </a>OpenAPI version 3
 
-* If many **servers** are specified, API Management will try to select the first HTTPs URL. If there aren't any HTTPs URLs - the first HTTP URL. If there aren't any HTTP URLs - the server URL will be empty.
-* **Examples** isn't supported, but **example** is.
-* **Multipart/form-data** isn't supported.
+-   If many **servers** are specified, API Management will try to select the first HTTPs URL. If there aren't any HTTPs URLs - the first HTTP URL. If there aren't any HTTP URLs - the server URL will be empty.
+-   **Examples** isn't supported, but **example** is.
+-   **Multipart/form-data** isn't supported.
 
 > [!IMPORTANT]
 > See this [document](https://blogs.msdn.microsoft.com/apimanagement/2018/04/11/important-changes-to-openapi-import-and-export/) for important information and tips related to OpenAPI import.
 
 ## <a name="wsdl"> </a>WSDL
-WSDL files are used to generate SOAP Pass-through APIs or serve as the backend of a SOAP-to-REST API.
-* **SOAP bindings** -Only SOAP bindings of style ”document” and “literal” encoding are supported. There is no support for “rpc” style or SOAP-Encoding.
-* **WSDL:Import** - This attribute isn't supported. Customers should merge the imports into one document.
-* **Messages with multiple parts** - These types of messages aren't supported.
-* **WCF wsHttpBinding** - SOAP services created with Windows Communication Foundation should use basicHttpBinding - wsHttpBinding isn't supported.
-* **MTOM** - Services using MTOM <em>may</em> work. Official support isn't offered at this time.
-* **Recursion** - Types that are defined recursively (for example, refer to an array of themselves) are not supported by APIM.
-* **Multiple Namespaces** - Multiple namespaces can be used in a schema, but only the target namespace can be used to define message parts. Namespaces other than the target which are used to define other input or output elements are not preserved. Although such a WSDL document can be imported, on export all message parts will have the target namespace of the WSDL.
+
+WSDL files are used to create SOAP pass-through and SOAP-to-REST APIs.
+
+-   **SOAP bindings** -Only SOAP bindings of style ”document” and “literal” encoding are supported. There is no support for “rpc” style or SOAP-Encoding.
+-   **WSDL:Import** - This attribute isn't supported. Customers should merge the imports into one document.
+-   **Messages with multiple parts** - These types of messages aren't supported.
+-   **WCF wsHttpBinding** - SOAP services created with Windows Communication Foundation should use basicHttpBinding - wsHttpBinding isn't supported.
+-   **MTOM** - Services using MTOM <em>may</em> work. Official support isn't offered at this time.
+-   **Recursion** - Types that are defined recursively (for example, refer to an array of themselves) are not supported by APIM.
+-   **Multiple Namespaces** - Multiple namespaces can be used in a schema, but only the target namespace can be used to define message parts. Namespaces other than the target which are used to define other input or output elements are not preserved. Although such a WSDL document can be imported, on export all message parts will have the target namespace of the WSDL.
+-   **Arrays** - SOAP-to-REST transformation supports only wrapped arrays shown in the example below:
+
+```xml
+    <complexType name="arrayTypeName">
+        <sequence>
+            <element name="arrayElementValue" type="arrayElementType" minOccurs="0" maxOccurs="unbounded"/>
+        </sequence>
+    </complexType>
+    <complexType name="typeName">
+        <sequence>
+            <element name="element1" type="someTypeName" minOccurs="1" maxOccurs="1"/>
+            <element name="element2" type="someOtherTypeName" minOccurs="0" maxOccurs="1" nillable="true"/>
+            <element name="arrayElement" type="arrayTypeName" minOccurs="1" maxOccurs="1"/>
+        </sequence>
+    </complexType>
+```
 
 ## <a name="wadl"> </a>WADL
+
 Currently, there are no known WADL import issues.