MSCRM 2011 操作大全

68 阅读 0 评论 45 点赞

我是靠谱客的博主斯文溪流，最近开发中收集的这篇文章主要介绍MSCRM 2011 操作大全，觉得挺不错的，现在分享给大家，希望可以做个参考。

概述

CRM字段类型：
货币：new Money(Decimal){SQL更新Money类型字段，需要同时更新_base字段，存在汇率差的时候值不同}
查找：new EntityReference(objecttypename,Guid)
下拉：new OptionSet(Int)
选项集：false/true
时间：DateTime
整数：Integer
十进制数：Decimal
浮点数：Double
单行/多行文本：String
CRM系统：
存储列表值：StringMap

存储附件：annotation

CRM，8个基本数据操作：
Associate 创建多对多关系
Create 创建数据
Delete 删除数据
Disassociate 删除多对多关系
Execute 执行请求
Retrieve 查询一个记录
RetrieveMultiple 查询多个记录
Update 更新数据

1.Xrm.Page.context
用户ID：getUserId()
用户角色：getUserRoles()
用户语言：getUserLcid()
组织名称：getOrgUniqueName()
组织语言：getOrgLcid()
路径参数：getQueryStringParameters()
服务器路径：getServerUrl()/getClientUrl()
前追加组织名称：prependOrgName("/WebResource/**")效果：crmtest/WebResource/**
当前主题：getCurrentTheme()
OutLook：isOutlookClient()/isOutlookOnline()

2.Xrm.Page.data.entity
所有页面元素：attributes【forEach(),get(),getLength()】
单个元素：attributes.get("")【同Xrm.Page.getAttribute()】
实体名称：getEntityName()
实体ID：getId()
是否修改：getIsDirty()
保存事件：save()
添加保存时事件：addOnSave()
移出保存时事件：removeOnSave()

3.Xrm.Page.getAttribute("")
取值：getValue()
赋值：setValue()
是否改动：getIsDirty()
表单载入时的值：getInitialValue()[Boolean, optionset]
提交类型：getSubmitMode(),setSubmitMode()//always,never,ditry
必填等级：getRequiredLevel(),setRequiredLevel()//required、none
用户操作等级：getUserPrivilege()//canCreate()、canRead()、canUpdate()
事件：addOnChange()，removeOnChange()，fireOnChange()[强制执行]
其他：getAttributeType(),getFormat(),getMax(),getMaxLength(),getMin(),getName(),getParent(),getPrecision()
optionset：getOption(),getOptions(),getSelectedOption(),getText()

4.Xrm.Page.getControl("")
属性：getAttribute()【同Xrm.Page.getAttribute()】
禁用/启用：setDisabled(true),setDisabled(false),getDisabled()
显示/隐藏：setVisible(true),setVisible(false),getVisible()
描述：setLabel(),getLabel()
聚焦选中：setFocus
刷新：refresh()//仅限SubGrid
其他：addCustomView(),addOption(),removeOption(value),clearOptions(),getControlType(),getData(),setData(),getDefaultView(),setDefaultView(),getName(),getParent(),getSrc(),setSrc(),getInitialUrl(),getObject()

5.Xrm.Page.ui
页面所有控件：controls【forEach(),get(),getLength()】
单个控件：controls.get("")【同Xrm.Page.getControl()】

页面Tab：tabs【forEach(),get(),getLength()】
单个Tab：tabs.get()【sections,getDisplayState(),getLabel(),getName(),getParent(),getVisible(),setDisplayState(),setFocus(),setLabel(),setVisible()】

Tab-Sections：tabs.get(0).sections【forEach(),get(),getLength()】
单个Section：tabs.get(0).sections.get(0)【getLabel(),getName(),getParent(),getVisible(),setLabel(),setVisible(),controls】

页面导航：navigation.items【forEach(),get(),getLength()】
单个导航：navigation.items.get()【getId(),getLabel(),getVisible(),setFocus(),setLabel(),setVisible()】

窗体：formSelector.items【forEach(),get(),getLenght()】
单个窗体：formSelector.items.get()【getId(),getLabel(),navigate()-窗体跳跃】

6.窗体状态
var FORM_TYPE_CREATE = 1;
var FORM_TYPE_UPDATE = 2;
var FORM_TYPE_READ_ONLY = 3;
var FORM_TYPE_DISABLED = 4;
var FORM_TYPE_QUICK_CREATE = 5;
var FORM_TYPE_BULK_EDIT = 6;
var formType = Xrm.Page.ui.getFormType();

刷新当前页面：
window.location.href = window.location.href;
window.location.reload();

禁用页面所有控件：
Xrm.Page.ui.controls.forEach(function (control, index) {
control.setDisabled(true);
});

防止保存事件(需要执行上下文)：
function My_PreventSaveFunction(eContext) {
eContext.getEventArgs().preventDefault();
}

给Lookup取值赋值：
id:obj.getValue()[0].id;
name:obj.getValue()[0].name;

var objList = new Array();
var obj = new Object();
obj.id = accountObj[0].TerritoryId.Id;
obj.name = accountObj[0].TerritoryId.Name;
obj.typename = accountObj[0].TerritoryId.LogicalName;
objList[0] = obj;
Xrm.Page.getAttribute("yto_territory").setValue(accountObj[0].TerritoryId.Id == null ? null : objList);
Xrm.Page.getAttribute("yto_territory").setSubmitMode("always");
Xrm.Page.data.entity.save();

给OptionSet按条件显示列：
Xrm.Page.getControl("new_counter_type").clearOptions();
var options = Xrm.Page.getAttribute("new_counter_type").getOptions();
for (var i = 0; i < options.length; i++) {
if (options[i].value != 190 && options[i].value != 200 && options[i].value!="null" ) {
Xrm.Page.getControl("new_counter_type").addOption(options[i], i+1);
}
}
Xrm.Page.getControl("new_counter_type").addOption(Xrm.Page.getAttribute("new_counter_type").getOption(190),1);

JS，给日期类型控件赋值：
var fullYear = Xrm.Page.getAttribute("yto_confirmdate").getValue().getFullYear();
var month = Xrm.Page.getAttribute("yto_confirmdate").getValue().getMonth() + 1;
var date = Xrm.Page.getAttribute("yto_confirmdate").getValue().getDate();
Xrm.Page.getAttribute("yto_confirmdate").setValue(new Date(fullYear, month, date))//厂方确认交货日期+1月
Xrm.Page.data.entity.save();

7.给Lookup添加过滤：
var fetch = '<fetch version="1.0" output-format="xml-platform" mapping="logical" distinct="true"><entity name="new_expensesdetail"><attribute name="new_expensesdetailid"/><attribute name="new_name"/><attribute name="createdon"/><order attribute="new_name" descending="false"/><filter type="and"><condition attribute="statecode" operator="eq" value="0"/></filter><link-entity name="new_buget" from="new_expenseitem" to="new_expensesdetailid" alias="aa"><filter type="and"><condition attribute="new_bugetunit" operator="eq" uitype="businessunit" value="' + Xrm.Page.getAttribute("new_businessunit").getValue()[0].id + '"/><condition attribute="new_bedgetsheet" operator="eq" uitype="new_budgetcycle" value="' + Xrm.Page.getAttribute("new_feeperiod").getValue()[0].id + '"/></filter></link-entity></entity></fetch>';
var view = '<grid name="resultset" object="10069" jump="new_name" select="1" icon="1" preview="1"><row name="result" id="new_expensesdetailid"><cell name="new_name" width="300" /><cell name="createdon" width="125" /></row></grid>';
Xrm.Page.getControl("new_detailitem").addCustomView("{B9C6A1F4-0A03-424D-B843-E4D9281F8DEB}", "new_expensesdetail", "根据部门和费用期间筛选", fetch, view, true);
modifiedLookupParameter("new_detailitem", "DisableViewPicker", "1");
A.取fetchxml和viewxml:
高级查找-编辑列-F12-脚本dlg_editview.aspx
frameRender.FetchXml.value
frameRender.LayoutXml.value
B.addCustomView("可用系统视图GUID，以便覆盖","","","","",是否默认视图)

8.用Ribbon Editor给自定义按钮添加JS事件：Library($webresource:web资源的名称)
9.JS引用了REST等通用JS的方法，需在该实体的窗体库中引用通用JS。
10.Plugin调试步骤：Plugin Registration Tool => Profile => 保存ErrorDetail.txt => Stop Profile => Debug，加载ErrorDetail.txt和DLL => VS附加PlugRegistration.exe到进程 =>Debug Start
11.Plugin抛异常到页面：throw new InvalidPluginExecutionException("");
12.Plugin取值：
int statuscode = (preImageEntity.Attributes["statuscode"] as OptionSetValue).Value;
13.Plugin删除了类文件，还需要去RegisterFile.crmregister删除对应的引用，否则会出现部署失败
14.高级查找-编辑列-F12未出现开发人员工具：IE-Internet选项-安全-Internet-自定义级别-允许网站打开没有地址或状态栏的窗口-禁用
15.是否出现“添加已存在**明细”按钮方法：明细表中主表字段的必填等级=业务必须，则不出现添加已存在按钮，否则出现。
16.删除一个表数据，在Pre-Delete中，已经把与之关联的数据中包含它的字段都NULL了。查询与之关联的数据，不能再通过该字段。
17.货币类型后台赋值：new Money(decimal.Parse())
18.菜单关联视图：<SubArea Id="yto_yto_applytogoods_dqr" Title="待确认的要货申请" Icon="/_imgs/ico_16_customEntity.gif" Url="_root/homepage.aspx?etn=yto_applytogoods&viewid=%7b98B36DFB-4BA3-E211-8F62-00155D04D707%7d"></SubArea>
【函数】19.动态载入JS(CRM函数):loadScriptAdv("脚本URL","任意ID",false);
loadScriptAdv(Xrm.Page.context.prependOrgName("/WebResources/fw_rest"), "55EE635C-91BD-443F-A3E6-56ACEG4E574G", false);
【函数】20.获取Homepage选择的项(CRM函数)：getSelected("crmGrid")
【函数】打开模式窗口openStdDlg()
windos.open("http://172.16.4.215/yto/main.aspx?etc=1&id=%7ba7402069-e4db-e211-9396-90b11c1d4ddf%7d&pagetype=entityrecord","_blank");
21.插件异步：异步plugin需要异步服务执行，这个启动时间会比较慢。POST后才会去启动这个操作。另外，异步作业有个特点，就是可还原操作。出错了，改完数据或修正plugin，可以将操作继续执行。
22.VS新建解决方案，选不了组织，因为本机不能识别CRM电脑名，要添加HOSTS映射：172.16.4.217 crmtest
23.JS给日期控件赋值：Xrm.Page.getAttribute("yto_date").setValue(new Date()),但是JS取客户机时间，建议在JS赋值的基础上再用PreValidate插件
24.JS刷新CRM视图：Mscrm.Utilities.refreshCurrentGrid(entityTypeCode);
25.注意。报表做时间类型的比对时，在第一行把时间类型参数dbo.fn_LocalTimeToUTC()转成UTC时间。dbo.fn_UTCToLocalTime()转成本地时间
set @startDate=isnull(@startDate,'1900-01-01')
set @startDate=dbo.fn_LocalTimeToUTC(@startDate)
set @endDate=dbo.fn_LocalTimeToUTC(DATEADD(DD,1,@endDate))
26.多条记录拼接为一个字符串：
SELECT @re=@re+','+yto_name FROM yto_order
select @new_businessunit= stuff((select ';'+convert(varchar(50),businessunitid) from businessunit for xml path('')),1,1,'')
27.导入解决方案之后，需要去检查关于扩展功能的插件有没有出现重复项，删除较早的，不然会出现审批之后，按钮不会改变的问题。
28.不要使用任何系统自带的字段，如状态描述、创建日期来当作单据的字段使用！
29.域用户需要在CRM部署管理器中加入CRM部署管理员，才能进行开发和部署操作。
30.货币类型的字段赋值：=new Money(decimail) ！！！，切记。
31.VS链接项目发生安全性的问题，因为CRM服务器和本机的时间相隔超过5分钟。
32.Pre_Create中，不能用entity.Id来做引用，因为目前该数据尚不存在。
00000000-0000-0000-0000-000000000000
34.VS解决方案不显示CRM视图：修改“解决方案.sln”文件，添加节点
GlobalSection(CRMSolutionProperties) = preSolution
SolutionIsBoundToCRM = True
EndGlobalSection
35.转REST获取的日期类型（从“/Date***”到“Fri Nov 1 00:00:00 UTC+0800 2013”）
function dateReviver(value) {
var a;
if (typeof value === 'string') {
a = /Date(([-+]?d+))/.exec(value);
if (a) {
return new Date(parseInt(value.replace("/Date(", "").replace(")/", ""), 10));
}
}
return value;
};
36.REST查询需要的日期类型转换：var myDate = (new Date()).format("yyyy-MM-ddThh:mm:ss");
37.值为NULL的列查询后不包含在实体中：!Contains("")
38.实体创建的时候可以给ownerid赋值，但更新的时候给ownerid赋值不会更新。
39.CRM组织服务更新日期字段时，DateTime.Now和DateTime.UtcNow插入到数据库的值是一样的。
40.
【误区】
日期赋值：
entity["date1"]=entity["date2"]是对的（显示：2013.1.2；date1:2013.1.1 16:00:00 date2:2013.1.1 16:00:00）；
entity["date1"]=DateTime.Parse(entity["date2"].ToString())是错的（显示：2013.1.2 date1:2013.1.1 8:00:00已错 date2:2013.1.1 16:00:00）
entity["date1"] = DateTime.Now、entity["date1"] = DateTime.UtcNow，结果是一样的！（2013.1.1 16:00:00）
取值：
(DB,Retrieve,Image,Entity上取的都是-8H的，只有页面显示已经+8H)所以JS中和CS中的比较一定要注意。
41.通过数据库还原新组织后，由于顶级组织改变，所有业务部门的guid会改变。
42.CRM数据库新建视图后，给新用户权限，需‘授予’查询的实体和关联实体的视图的‘选择’权限就行了。
43.删除或者更新数据的时候，用最高权限的用户初始化的组织服务。
44.context.SharedVariables插件间的参数传递，注意context不同的时候，获取不到，所以最好用顶级context。
45.关于实体字段“货币”的赋值：service中create和update实体的时候，只有带上货币类型字段，“货币”会自动赋值。