[筆記][Biztalk]呼叫Web API取得回傳物件

2017-08-04

通常呼叫GET HTTP method的RESTful API會取得API查詢的回傳物件，在Biztalk 2013內要怎麼接收呢?

例如，我寫了一個ASP.NET WebAPI，會依據所Request的Employee ID回傳Employee物件。Employee物件的定義如下:

public class Employee
{
    public string EmpName { get; set; }
    public string EmployeeID { get; set; }
}

在Biztalk中該怎麼做才能呼叫該Web API以取得Employee物件呢?在Biztalk專案中，要注意的

設定WCF-WebHttp Adapter

設定方式可以參考使用WCF-WebHttp Adapter呼叫Web API。其中要注意到的是，在Message頁籤中，Outbound Message區塊，要把GET寫上。以免Orchestration透過Send物件呼叫API時，帶入Message物件，卻導致Web API端無法辨識所需叫用的method。

建立回傳物件的XML Schema

以Employee物件來說，透過WCF-WebHttp Adapter呼叫Web API，回傳的訊息內容會長類似這個樣子。主要是Namespace會依據Web API專案中的Project及Controller而組成。

<Employee xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/LabRestful.Controllers">
	<EmpName>Employee A</EmpName>
	<EmployeeID>a456</EmployeeID>
</Employee>

所以，我們就要依據此XML設計對應的XML Schema。要注意的是，Target Namespace要記得跟XML的一樣，在這裡也就是"http://schemas.datacontract.org/2004/07/LabRestful.Controllers"

<?xml version="1.0" encoding="utf-16" ?> 
<xs:schema xmlns="http://schemas.datacontract.org/2004/07/LabRestful.Controllers" xmlns:b="http://schemas.microsoft.com/BizTalk/2003" attributeFormDefault="unqualified" elementFormDefault="unqualified" targetNamespace="http://schemas.datacontract.org/2004/07/LabRestful.Controllers" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:element name="Employee">
    <xs:complexType>
      <xs:sequence>
        <xs:element name="EmpName" type="xs:string" /> 
        <xs:element name="EmployeeID" type="xs:string" /> 
      </xs:sequence>
    </xs:complexType>
  </xs:element>
</xs:schema>