在 Dynamics 365 中使用可編輯的網格

發行項
03/04/2017

發行︰ 2017年1月

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

可編輯的網格是 Microsoft Dynamics 365 中新的自訂控制項，在 Web 和行動用戶端 (行動電話用 Dynamics 365 和平板電腦用 Dynamics 365) 上提供豐富的內嵌編輯功能，包括在同一網格內將資料分組、排序和篩選的功能，讓您不必在記錄或檢視表之間切換。 Web 用戶端中表單上的主要網格和子格支援可編輯網格控制項，以及行動用戶端的儀表板和表單網格中也支援。雖然可編輯網格控制項提供編輯功能，但它允許唯讀網格中繼資料和欄位層級安全性設定。可編輯網格也支援商務規則和表單指令碼，因此您可以套用自訂商務邏輯，根據組織的需求。

注意

可編輯的網格已在 Dynamics 365 (Online 和內部部署) 的 2016 年 12 月更新推出。

本主題內容

啟用可編輯的網格

表單指令碼支援

可編輯網格支援的實體和檢視表

啟用可編輯的網格

您可以在實體層級啟用可編輯的網格以便在主要網格中使用，或在表單層級啟用，以將唯讀子格 (相關聯網格) 取代為可編輯的網格。

您可以為實體啟用可編輯網格控制項，使用 Dynamics 365 中的自訂工具 ([設定] > [自訂] > [自訂系統] > [實體] > [[Entity_Name]] > [控制項] 索引標籤)。

若要對表單中的網格啟用可編輯網格，請開啟表單編輯器，按兩下要取代為可編輯網格的唯讀網格，然後在 [控制項] 索引標籤中新增/啟用可編輯網格。

如有需要，您隨時可以將主要網格和相關聯的網格還原為非可編輯網格。另外，在執行階段，使用者可以切換可編輯的網格和唯讀網格。

其他資訊：TechNet：使用 [可編輯的網格] 自訂控制項將 Dynamics 365 中的網格 (清單) 變成可編輯

表單指令碼支援

可編輯的網格支援用戶端事件和方法，可根據業務需求撰寫自訂用戶端擴充功能。其他資訊：可編輯的 Grid 物件和方法 (用戶端參考)

可編輯網格支援的實體和檢視表

並非所有實體和檢視表都支援使用可編輯網格。

在網頁用戶端上，實體將支援可編輯網格，如果以下所有條件都成立：

實體可自訂 (IsCustomizable = true)
實體已重新整理 (IsAIRUpdated = true) 或自訂實體 (IsCustomEntity = true)
實體不是下層實體 (IsChildEntity = false)

在 Dynamics 365 行動用戶端上，實體將支援可編輯網格，如果實體可在行動用戶端的網站地圖中顯示。

如需支援可編輯的網格的實體的相關資訊，請參閱支援的立即可用實體一節，在 TechNet︰用 [可編輯的網格] 自訂控制項將 Dynamics 365 中的網格 (清單) 變成可編輯中

可編輯網格不支援彙總相關聯的檢視表 (彙總類型 = Related)。

使用下列範例程式碼產生 XML 檔案，您可在 Microsoft Excel 中開啟為 XML 表格，以檢視可編輯控制項的實體支援資訊。Excel 會自動分辨結構描述，並顯示下列各欄底下的資訊：

LogicalName：實體的邏輯名稱。
DisplayName：實體的顯示名稱。
CanEnableEditableGridWeb：顯示狀態 (True 或 False)，網頁用戶端的實體是否支援可編輯網格。
CanEnableEditableGridMobile：顯示狀態 (True 或 False)，行動用戶端的實體是否支援可編輯網格。 (行動電話用 Dynamics 365 和平板電腦用 Dynamics 365)。

using System;
using System.Linq;
using System.Xml.Linq;
using System.ServiceModel;
using System.ServiceModel.Description;
using System.Collections.Generic;
using System.Xml.Serialization;
using System.Xml;
using System.IO;

// These namespaces are found in the Microsoft.Xrm.Sdk.dll assembly
// found in the SDK\bin folder.
using Microsoft.Xrm.Sdk;
using Microsoft.Xrm.Sdk.Query;
using Microsoft.Xrm.Sdk.Metadata;
using Microsoft.Xrm.Sdk.Client;
using Microsoft.Xrm.Sdk.Messages;

// This namespace is found in Microsoft.Crm.Sdk.Proxy.dll assembly
// found in the SDK\bin folder.
using Microsoft.Crm.Sdk.Messages;

namespace Microsoft.Crm.Sdk.Samples
{
    /// <summary>
    /// This sample generates an XML table to display the entity-support information for 
    ///  editable controls.
    /// </summary>
    public class DumpEditableGridEntityInfo
    {
        #region Class Level Members

        /// <summary>
        /// Stores the organization service proxy.
        /// </summary>
        OrganizationServiceProxy _serviceProxy;

        // Create storage for new attributes being created
        public List<AttributeMetadata> addedAttributes;

        // Specify which language code to use in the sample. If you are using a language
        // other than US English, you will need to modify this value accordingly.
        // See https://msdn.microsoft.com/en-us/library/0h88fahh.aspx
        public const int _languageCode = 1033;

        // Define the IDs/variables needed for this sample.
        public int _insertedStatusValue;

        #endregion Class Level Members

        #region How To Sample Code
        /// <summary>
        /// </summary>
        /// <param name="serverConfig">Contains server connection information.</param>
        /// <param name="promptForDelete">When True, the user will be prompted to delete all
        /// created entities.</param>
        public void Run(ServerConnection.Configuration serverConfig, bool promptForDelete)
        {
            try
            {

                // Connect to the Organization service. 
                // The using statement assures that the service proxy will be properly disposed.
                using (_serviceProxy = new OrganizationServiceProxy(serverConfig.OrganizationUri, serverConfig.HomeRealmUri, serverConfig.Credentials, serverConfig.DeviceCredentials))
                {
                    // This statement is required to enable early-bound type support.
                    _serviceProxy.EnableProxyTypes();

                    //<snippetDumpEditableGridEntityInfo1>
                    RetrieveAllEntitiesRequest request = new RetrieveAllEntitiesRequest()
                    {
                        EntityFilters = EntityFilters.Entity,
                        RetrieveAsIfPublished = true
                    };

                    // Retrieve the MetaData.
                    RetrieveAllEntitiesResponse response = (RetrieveAllEntitiesResponse)_serviceProxy.Execute(request);


                    // Create an instance of StreamWriter to write text to a file.
                    // The using statement also closes the StreamWriter.
                    // To view this file, right click the file and choose open with Excel. 
                    // Excel will figure out the schema and display the information in columns.

                    String filename = String.Concat("EditableGridEntityInfo.xml");
                    using (StreamWriter sw = new StreamWriter(filename))
                    {
                        // Create Xml Writer.
                        XmlTextWriter metadataWriter = new XmlTextWriter(sw);

                        // Start Xml File.
                        metadataWriter.WriteStartDocument();

                        // Metadata Xml Node.
                        metadataWriter.WriteStartElement("Metadata");

                        foreach (EntityMetadata currentEntity in response.EntityMetadata)
                        {
                            // Start Entity Node
                            metadataWriter.WriteStartElement("Entity");

                            bool canBeDisplayedInSitemap = currentEntity.IsCustomizable.Value;

                            if (canBeDisplayedInSitemap)
                            {
                                metadataWriter.WriteElementString("LogicalName", currentEntity.LogicalName);
                                metadataWriter.WriteElementString("DisplayName", currentEntity.DisplayName.UserLocalizedLabel?.Label);
                                metadataWriter.WriteElementString("CanEnableEditableGridWeb", (!(bool)currentEntity.IsChildEntity && ((bool)currentEntity.IsAIRUpdated || (bool)currentEntity.IsCustomEntity)).ToString());
                                metadataWriter.WriteElementString("CanEnableEditableGridMobile", (currentEntity.IsVisibleInMobileClient.Value || currentEntity.IsVisibleInMobileClient.CanBeChanged).ToString());
                            }

                            // Write the Entity's Information.

                            //End Entity Node
                            metadataWriter.WriteEndElement();
                        }

                        // End Metadata Xml Node
                        metadataWriter.WriteEndElement();
                        metadataWriter.WriteEndDocument();

                        // Close xml writer.
                        metadataWriter.Close();
                        Console.WriteLine("Dumped information in the EditableGridEntityInfo.xml file");
                    }
                }
            }

            // Catch any service fault exceptions that Microsoft Dynamics CRM throws.
            catch (FaultException<Microsoft.Xrm.Sdk.OrganizationServiceFault>)
            {
                // You can handle an exception here or pass it back to the calling method.
                throw;
            }
        }
        #endregion How To Sample Code

        #region Main
        /// <summary>
        /// Standard Main() method used by most SDK samples.
        /// </summary>
        /// <param name="args"></param>
        static public void Main(string[] args)
        {
            try
            {
                // Obtain the target organization's Web address and client logon 
                // credentials from the user.
                ServerConnection serverConnect = new ServerConnection();
                ServerConnection.Configuration config = serverConnect.GetServerConfiguration();
                DumpEditableGridEntityInfo app = new DumpEditableGridEntityInfo();
                app.Run(config, false);                
            }
            catch (FaultException<Microsoft.Xrm.Sdk.OrganizationServiceFault> ex)
            {
                Console.WriteLine("The application terminated with an error.");
                Console.WriteLine("Timestamp: {0}", ex.Detail.Timestamp);
                Console.WriteLine("Code: {0}", ex.Detail.ErrorCode);
                Console.WriteLine("Message: {0}", ex.Detail.Message);
                Console.WriteLine("Plugin Trace: {0}", ex.Detail.TraceText);
                Console.WriteLine("Inner Fault: {0}",
                    null == ex.Detail.InnerFault ? "No Inner Fault" : "Has Inner Fault");
            }
            catch (System.TimeoutException ex)
            {
                Console.WriteLine("The application terminated with an error.");
                Console.WriteLine("Message: {0}", ex.Message);
                Console.WriteLine("Stack Trace: {0}", ex.StackTrace);
                Console.WriteLine("Inner Fault: {0}",
                    null == ex.InnerException.Message ? "No Inner Fault" : ex.InnerException.Message);
            }
            catch (System.Exception ex)
            {
                Console.WriteLine("The application terminated with an error.");
                Console.WriteLine(ex.Message);

                // Display the details of the inner exception.
                if (ex.InnerException != null)
                {
                    Console.WriteLine(ex.InnerException.Message);

                    FaultException<Microsoft.Xrm.Sdk.OrganizationServiceFault> fe
                        = ex.InnerException
                        as FaultException<Microsoft.Xrm.Sdk.OrganizationServiceFault>;
                    if (fe != null)
                    {
                        Console.WriteLine("Timestamp: {0}", fe.Detail.Timestamp);
                        Console.WriteLine("Code: {0}", fe.Detail.ErrorCode);
                        Console.WriteLine("Message: {0}", fe.Detail.Message);
                        Console.WriteLine("Plugin Trace: {0}", fe.Detail.TraceText);
                        Console.WriteLine("Inner Fault: {0}",
                            null == fe.Detail.InnerFault ? "No Inner Fault" : "Has Inner Fault");
                    }
                }
            }
            // Additional exceptions to catch: SecurityTokenValidationException, ExpiredSecurityTokenException,
            // SecurityAccessDeniedException, MessageSecurityException, and SecurityNegotiationException.

            finally
            {

                Console.WriteLine("Press <Enter> to exit.");
                Console.ReadLine();
            }

        }
        #endregion Main

    }
}

另請參閱

可編輯的 Grid 物件和方法 (用戶端參考)
TechNet：使用 [可編輯的網格] 自訂控制項將 Dynamics 365 中的網格 (清單) 變成可編輯

Microsoft Dynamics 365

共用方式為

在 Dynamics 365 中使用可編輯的網格

本主題內容

啟用可編輯的網格

表單指令碼支援

可編輯網格支援的實體和檢視表

另請參閱

其他資源