共用方式為


Xrm.Page.data.entity (用戶端參考)

 

發行︰ 2016年11月

適用於: Dynamics CRM 2015

Xrm.Page.data.entity 提供方法擷取頁面上顯示記錄的特定資訊、save 方法,以及表單中的所有屬性集合。 屬性資料受限於表單欄位所代表的屬性。

Xrm.Page.data.entity 屬性和方法

  • 屬性
    實體的屬性集合。

  • getDataXml
    傳回字串,其代表儲存記錄時要傳送至伺服器的 xml。

  • getEntityName
    傳回字串,表示記錄之屬性邏輯名稱。

  • getId
    傳回字串,代表記的 GUID id 值。

  • getIsDirty
    傳回布林值,指示表單上是否已修改任何欄位。

  • OnSave
    使用 addOnSave 和 removeOnSave 方法新增或移除儲存活動的事件處理常式

  • getPrimaryAttributeValue
    取得實體的主要屬性值的字串。

  • 儲存​​
    儲存完成之後,使用關閉表單或開啟新表單的選項儲存記錄。

屬性

Xrm.Page.data.entity.attributes 集合提供方法,存取表單上顯示記錄的資料。 如需此集合的詳細資訊,請參閱 集合 (用戶端參考)。 如需此集合之物件可用的屬性與方法,請參閱 Xrm.Page.data.entity 屬性 (用戶端參考)

getDataXml

傳回字串,其代表儲存記錄時要傳送至伺服器的 XML。 只有已變更的欄位的資料會傳送至伺服器。

注意

此函數無法與 平板電腦專用 Microsoft Dynamics CRM 搭配使用。

Xrm.Page.data.entity.getDataXml()
  • 傳回值
    **類型:**字串

    **範例:**在此範例中,客戶記錄的下列三個欄位已更新:

    • 名稱

    • accountnumber

    • telephone2

    "<account><name>Contoso</name><accountnumber>55555</accountnumber><telephone2>425 555-1234</telephone2></account>"
    

getEntityName

傳回字串,表示記錄之屬性邏輯名稱。

Xrm.Page.data.entity.getEntityName()
  • 傳回值
    **類型:**字串。 實體的名稱。

    **範例:**在此範例中,客戶記錄進行編輯。

    "account"
    

getId

傳回字串,代表記的 GUID id 值。

Xrm.Page.data.entity.getId()
  • 傳回值
    **類型:**字串

    **範例:**記錄的 GUID Id 值。

    "{825CB223-A651-DF11-AA8B-00155DBA3804}"
    

getIsDirty

傳回布林值,指示表單上是否已修改任何欄位。

Xrm.Page.data.entity.getIsDirty()
  • 傳回值
    **類型:**布林

OnSave

使用 addOnSave 和 removeOnSave 方法新增或移除儲存活動的事件處理常式

addOnSave

新增當記錄儲存時將呼叫的函數。

Xrm.Page.data.entity.addOnSave([function reference])
  • 參數
    **類型:**函數參考

    **備註:**這個函數會加入至事件處理常式管線底端。 執行內容是自動設定為傳遞至事件處理常式 (使用此方法所設定) 的第一個參數。 如需詳細資訊,請參閱執行內容 (用戶端參考)

    **範例:**在此範例中,JavaScript 程式庫包含兩個函數。addMessageToOnSave 函數新增至表單 OnLoad 事件,會新增 displayOrgName 函數做為 OnSave 事件的處理常式。

    function displayOrgName(execContext)
    {
        try {
            alert(execContext.getContext().getOrgUniqueName());
        }
        catch (e) {
            alert(e.message);
        }
    }
    
    function addMessageToOnSave() {
        Xrm.Page.data.entity.addOnSave(displayOrgName);
    }
    

removeOnSave

移除當記錄儲存時將呼叫的函數。

Xrm.Page.data.entity.removeOnSave([function reference])
  • 參數
    **類型:**函數參考

    **範例:**在此範例中,JavaScript 程式庫包含兩個函數。removeMessageFromOnSave 函數新增至表單事件,會移除 displayOrgName 函數做為 OnSave 事件的處理常式。

    function displayOrgName(execContext)
    {
        try {
            alert(execContext.getContext().getOrgUniqueName());
        }
        catch (e) {
            alert(e.message);
        }
    }
    
    function removeMessageFromOnSave() {
        Xrm.Page.data.entity.removeOnSave(displayOrgName);
    }
    

getPrimaryAttributeValue

取得實體的主要屬性值的字串。

Xrm.Page.data.entity.getPrimaryAttributeValue()

每個實體有一個指派為 PrimaryNameAttribute 的字串屬性。 當記錄的連結顯示時,使用此屬性的值。

  • 傳回值
    **類型:**字串。 實體的主要屬性的值。

  • 備註
    此方法僅適用於更新的實體

儲存​​

儲存完成之後,使用關閉表單或開啟新表單的選項,以同步方式儲存記錄。

Xrm.Page.data.saveXrm.Page.data.entity.save 都會儲存記錄,但是 Xrm.Page.data.save 在儲存作業完成之後提供回呼函數。

Xrm.Page.data.entity.save( null | "saveandclose" |"saveandnew" )
  • 引數

    • save()
      如果參數未包含,只是儲存記錄。 這相當於使用 [儲存] 命令。

    • save("saveandclose")
      這相當於使用 [儲存後關閉] 命令。

    • save("saveandnew")
      這相當於使用 [儲存並新增] 命令。

  • 備註
    在 Web 應用程式使用快速建立表單時,不套用 saveandnew 選項。 其運作方式就如同使用 saveandclose。平板電腦專用 Microsoft Dynamics CRM 中快速建立表單會套用 saveandnew 行為。

另請參閱

用戶端程式設計參考
表單指令碼快速參考
Xrm.Page.data.entity 屬性 (用戶端參考)
撰寫 Microsoft Dynamics CRM 2015 表單的程式碼
使用 Xrm.Page 物件模型

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