發行自訂

發行︰ 2017年1月

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

發行自訂可讓 Web 應用程式得知影響使用者介面的資料發生變更。

何時發行自訂

自訂會在建立新項目或刪除現有項目時自動發行。

您必須在更新會影響使用者介面的結構描述中繼資料或實體之後發行變更。您可以決定先等候，再將一組相關的變更一起發行。

只有發行的自訂才會隨解決方案一起匯出。匯出解決方案之前，一律要先發行自訂。

當您執行將出現在平板電腦專用 Microsoft Dynamics 365 中的自訂時，您必須明確發行自訂，以確定每個項目會與平板電腦用 Dynamics 365 應用程式同步處理。

注意

發行自訂可能會妨礙正常系統作業。在生產環境中，建議您將發行自訂排定在最不會干擾使用者的時候。

下表列出您可用來發行自訂的兩個訊息。

訊息	描述
PublishAllXmlRequest	發行所有自訂。
PublishXmlRequest	發行指定的自訂。

使用 PublishXmlRequest 訊息時，您會使用 ParameterXml 參數指定要發行的項目。ParameterXML 必須符合Publish request schema。

如果您想要建立應用程式來編輯 Microsoft Dynamics 365 中可自訂的項目，則必須擷取這些項目的所有未發行定義。如果開發人員定義了一些變更，但是未將它們發行，您的應用程式必須能夠擷取這些變更，才能在使用者介面中顯示這些變更。

使用下列兩種方法可擷取未發行的中繼資料：

RetrieveAsIfPublished 參數
使用下列訊息可擷取實體、屬性、實體關聯和選項組資料：
RetrieveUnpublished 要求
使用下列訊息可擷取使用者介面項目，例如表單、範本、視覺效果和 Web 資源定義：
- RetrieveUnpublishedRequest
- RetrieveUnpublishedMultipleRequest

Microsoft Dynamics 365