CRM 2011 - 使用 JScript 设置默认值

Question

我们本地有 CRM 2011。联系人实体已自定义为使用对自定义实体国家/地区的查找，而不仅仅是文本字段。创建新联系人时，我们希望将国家/地区字段默认设置为加拿大。我有以下函数可以做到这一点：

            function SetDefaultCountryCode(countryFieldId) {

                var _canadaId = "{FC167B4D-1C3B-E111-8904-F2EA3FE25706}";

                var countryControl = Xrm.Page.getAttribute(countryFieldId);

                // only attempt the code if the control exists on the form
                if (countryControl != null) {
                    var currentCountry = countryControl.getValue();

                    // if country is not specified, then set it to the default one (Canada) 
                    if (currentCountry == null) {
                        var defaultCountry = new Object();
                        defaultCountry.entityType = "cga_country";
                        defaultCountry.id = _canadaId;
                        defaultCountry.name = "Canada";
                        var countryLookupValue = new Array();
                        countryLookupValue[0] = defaultCountry;

                        countryControl.setValue(countryLookupValue);
                    }
                }
            }

在 OnLoad 表单上，我调用如下函数：

    // set Country fields to Canada if not set
    SetDefaultCountryCode('cga_address1country');

我们有两个服务器 - DEV 和 TEST。这个 JScript 在 DEV 中运行良好。当我在 TEST 中运行它时，它不起作用，因为 TEST 中的加拿大有不同的 id (GUID) - 当我手动创建它时。我希望可以从 DEV 导出 Country 实体值并将其导入到 TEST 中并保留其 GUID。不幸的是这不起作用。我将数据导出到 Excel 文件，其中包含国家/地区的 GUID。在导入之前，我还会删除 TEST 中任何现有的国家/地区记录。当我尝试导入它时，导入成功但没有创建任何记录。如果我在 Excel 文件中添加新行而不指定 Guid，它将导入它。在我看来，导入功能并不是为了保留记录的 GUID。但这也意味着我的脚本将无法工作，因为它依赖于 GUID。

我这里有两个问题：

1. 是否可以导出/导入保留 GUID 的实体数据？

2. 如果我在 DEV 和 TEST 中无法拥有相同的 GUID，我如何才能使 JScript 正常工作？

预先感谢您的任何帮助/反馈。

Answer 1

对 GUID 进行硬编码是非常糟糕的做法，您发现了它的问题。
正如您上面所说，我们不能有相同的 GUID，但我们有相同的名称。因此，我们必须使用 JScript 和 jQuery 查询国家/地区名称来检索 GUID。

为了从客户端（或实体表单）撤回信息：

1. 我们将使用/使用 REST 端点（在浏览器中测试）。
2. 上传 jQuery 库。
3. 上传 Json2 库。
4. 使用 jQuery 库中的 AJAX 函数。
5. 定义您的实体、列和标准。

让我们寻找查询 REST 端点。

 http://yourHostName/yourOrg/XRMServices/2011/OrganizationData.svc/new_CountrytSet?$select=new_Name,new_CountryId&$filter=new_Name eq 'Canada'

获取此 URL，替换您的实际值并将其粘贴到浏览器中，您会发现响应以 XML 格式返回。如果有任何错误，请确保实体名称及其属性区分大小写。

查看结果后，我们将使用 AJAX 调用来调用此 URL。

$.ajax({
                type: "GET",
                contentType: "application/json; charset=utf-8",
                datatype: "json",
                url: 'http://yourHostName/yourOrg/XRMServices/2011/OrganizationData.svc/new_CountrytSet?$select=new_Name,new_CountryId&$filter=new_Name eq 'Canada'',
                beforeSend: function (XMLHttpRequest) {
                    //Specifying this header ensures that the results will be returned as JSON.             
                    XMLHttpRequest.setRequestHeader("Accept", "application/json");
                },
                success: function (data) {
                    if (data.d && data.d.results) {
                        //var _canadaId = "{FC167B4D-1C3B-E111-8904-F2EA3FE25706}"; no longer be used
                        var _canadaId = data.d.results[0].ContactId;

                        // now we have the GUID of Canada, now I can continue my process

                    }

                },
                error: function (XmlHttpRequest) {

                    alert("Error : " + XmlHttpRequest.status + ": " + XmlHttpRequest.statusText + ": " + JSON.parse(XmlHttpRequest.responseText).error.message.value);
                }

            });

但在将代码复制到表单之前，您必须从此处下载 jQuery lib
然后将其作为 Web 资源上传，将此 Web 资源添加到表单加载库中。

以下是要放入表单加载事件处理程序中的完整代码：

var context = GetGlobalContext();

// retireve the invoice record id (Opened Form)
var invoiceId = context.getQueryStringParameters().id;
var customerId;

//Retrieve the server url, which differs on-premise from on-line and 
//shouldn't be hard-coded.
// this will return something like http://yourHostName/yourOrg
var serverUrl = context.getServerUrl();


//The XRM OData end-point
var ODATA_ENDPOINT = "/XRMServices/2011/OrganizationData.svc";

var odataUri = serverUrl + ODATA_ENDPOINT;

function SetDefaultCountryCode(countryFieldId, odataUri) {

    odataUri = odataUri + '/ContactSet?$select=ContactId,FullName&$filter=FullName eq \'Ahmed Shawki\'';
    $.ajax({
        type: "GET",
        contentType: "application/json; charset=utf-8",
        datatype: "json",
        url: odataUri,
        beforeSend: function (XMLHttpRequest) {
            //Specifying this header ensures that the results will be returned as JSON.             
            XMLHttpRequest.setRequestHeader("Accept", "application/json");
        },
        success: function (data) {
            if (data.d && data.d.results) {
                //var _canadaId = "{FC167B4D-1C3B-E111-8904-F2EA3FE25706}"; no longer be used
                var _canadaId = data.d.results[0].ContactId;

                var countryControl = Xrm.Page.getAttribute(countryFieldId);

                // only attempt the code if the control exists on the form
                if (countryControl != null) {
                    var currentCountry = countryControl.getValue();

                    // if country is not specified, then set it to the default one (Canada) 
                    if (currentCountry == null) {
                        var defaultCountry = new Object();
                        defaultCountry.entityType = "cga_country";
                        defaultCountry.id = _canadaId;
                        defaultCountry.name = "Canada";
                        var countryLookupValue = new Array();
                        countryLookupValue[0] = defaultCountry;

                        countryControl.setValue(countryLookupValue);
                    }
                }
            }

        },
        error: function (XmlHttpRequest) {

            alert("Error : " + XmlHttpRequest.status + ": " + XmlHttpRequest.statusText + ": " + JSON.parse(XmlHttpRequest.responseText).error.message.value);
        }

    });

}

还有一件事，不要忘记选中表单属性上的“将执行上下文作为第一个参数传递”框。

编辑：除了将 jQuery 库添加到表单加载事件处理程序之外，还添加 Json2 lib 作为网络资源。

有关REST 端点的详细信息。

Answer 2

确实可以导出和导入记录及其指南，但不是本地的。您必须构建一个可以为您导出数据的应用程序，然后通过目标环境中的 CRM API 创建相同的记录。您只需清除对创建无效的字段（createdon、statecode 等）并指定相同的 Guid。然后 CRM 将使用该 Guid 创建记录。

旧的 4.0 配置数据工具执行此操作。我不记得它是否适用于 2011 年的组织，但这可能是一个起点。