使用 Microsoft Dynamics 365 Web 服務

 

發行︰ 2017年1月

適用於： Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2016、Dynamics CRM Online

Web 服務提供 API，讓您為 Microsoft Dynamics 365 (線上和內部部署) 撰寫程式時使用。 本主題介紹可用的 Web 服務，並提供了解和比較的基本資訊。

本主題內容

Web API

組織服務

組織資料服務

探索 Web 服務

部署 Web 服務

Web API

Web API 是 Microsoft Dynamics 365 (線上和內部部署) 的新功能，將提供與 Organization 服務的同位。

注意

在這個首次發行版本中，仍有許多問題待解決，才能達成同位。 如需待解決問題的詳細資訊，請參閱Microsoft Dynamics 365 Web API 限制。

與 Organization 服務相較之下，Web API 提供跨各種程式設計語言、平台和裝置的更佳相容性。Web API 實作 OData (開放資料通訊協定) v4。OData 是 OASIS 標準，用於建置和使用 RESTful API，透過豐富的資料來源。 您可以深入了解，前往 OData 通訊協定和 OASIS 標準網站。

由於 Web API 是以開放式標準為建置基礎，因此您不需要使用 Microsoft Dynamics 365 專屬的用戶端程式庫。 您可以選擇針對特定作業撰寫 HTTP 要求，或是使用協力廠商程式庫為您要使用的語言或平台產生類別。 檢視可用程式庫的清單。

Web API 最後將取代 Organization 服務和 Organization Data 服務，但這兩項現有的 Web 服務仍會提供以便逐步轉換成單一 Web API。 您應優先選擇使用 Web API 來進行將支援 Microsoft Dynamics 365 和未來 Microsoft Dynamics 365 (線上) 版本的新開發工作。 針對透過不在伺服器上執行的程式碼存取 Microsoft Dynamics 365 資料的任何專案使用 Web API，包括來自 Web 資源的 XmlHttpRequests 以及來自 Microsoft Dynamics 365 應用程式用戶端中執行的指令碼。 目前無法對伺服器上執行的程式碼輕鬆使用 Web API，例如外掛程式或工作流程組件。

其他資訊：使用 Microsoft Dynamics 365 Web API。

組織服務

Organization 服務有時也稱為「SOAP 端點」，自 Microsoft Dynamics CRM 2011 起即已提供。 這是大部分使用 Microsoft Dynamics 365 的開發人員早已熟悉的 Web 服務。Organization 服務最適合搭配 .NET 使用。Microsoft Dynamics 365 SDK 提供一組組件和工具，可讓您產生強型別類別和 Proxy、簡化開發程序，並使用 Microsoft Visual Studio 享受更佳的開發體驗。 如果您是 .NET 開發人員而不需支援其他平台，則不需立即移轉至 Web API。 您需要使用 Organization 服務支援要部署至組織的任何功能，使用 Microsoft Dynamics 365 以前發行的 Microsoft Dynamics 365 版本。

在伺服器上的外掛程式或工作流程組件中執行的商務邏輯預期使用 Organization 服務。 輸入和輸出參數使用特定類別，是以支援 Organization 服務的組件定義。

其他資訊：使用 Microsoft Dynamics 365 組織服務

組織資料服務

Organization Data 服務有時也稱為 "OData" 或 "REST" 端點，也是自 Microsoft Dynamics CRM 2011 起即已提供。 此服務實作 OData v2 標準。 雖然未來幾年此服務將繼續以現有狀態提供，但會隨 Microsoft Dynamics 365 遭到取代。Organization Data 服務一直受限於執行建立、讀取、更新及刪除作業，且未曾支援呼叫 Organization 服務中所使用專用訊息的功能，因此始終無法達到與組織服務的功能同位。 在 OData v2 和 v4 標準之間實作的變更不允許升級服務，以符合與組織服務同位的服務的要求。 我們能夠套用收到的許多有關組織資料服務的意見反應，並套用它以改善 Web API。

此版本 Microsoft Dynamics 365 SDK 未包含有關組織資料服務的資訊。 您可以找到有關組織資料服務的資訊，在 Microsoft Dynamics CRM 2015 版本的文件中，位於搭配 Web 資源使用 OData 端點。

探索 Web 服務

Microsoft Dynamics 365 是多組織用戶共享應用程式。 這表示，單一部署可代管多個 Dynamics 365 的執行個體，且每個都有自己的資料、透過不同的 URL 提供。 此外，尤其當 Microsoft Dynamics 365 伺服器代管於資料中心內時，特定伺服器可隨著資源移動或負載平衡變更。 探索 Web 服務提供讓用戶端偵測可用伺服器和組織的方式，讓使用者依據自己的使用者帳戶連接。 您可以選擇使用 Web API Discovery 服務或 IDiscoveryService Web 服務。Web API Discovery 服務與 Web API 提供相同的優勢，適合更多種不同的程式設計語言、平台和裝置使用。

其他資訊：使用 Web API 為您的組織探索 URL 或 使用組織服務為您的組織探索 URL

部署 Web 服務

對於 Dynamics 365 (內部部署)，您可以使用部署 Web 服務，透過程式設計的方式執行動作來管理您的部署。 這些作業基本上與您可以在伺服器上使用安裝在伺服器上的部署管理員工具用戶端執行的作業相同。 您可以建立、匯入或刪除組織，以及在程式碼中套用特定設定。 當您想要自動化特定程序 (如果您要提供代管服務或想要自動化建立測試環境的程序)，這會很實用。

其他資訊：部署 Web 服務簡介。

另請參閱

連線至 Microsoft Dynamics 365
在 Microsoft Dynamics 365 中驗證使用者
Use Microsoft Dynamics 365 web services
使用 XRM 工具，建立 Windows 用戶端應用程式
建立新型行動應用程式

Microsoft Dynamics 365

© 2017 Microsoft. 著作權所有，並保留一切權利。 著作權