图片 16

本人微信和易信公众号: 微软动态CRM专家罗勇
,回复261或者20170724可方便获取本文,同时可以在第一间得到我发布的最新的博文信息,follow
me!我的网站是 www.luoyong.me 。

 

Web API在Dynamics CRM中的功能越来越强大,Dynamics 365 (Dynamics CRM
V8.2) 又增加了一些通过通过Web API可以执行的操作(Action) ,比如
ExecuteWorkflow这个Action,具体Web
API可以执行哪些操作呢?可以参考SDK的 Web API Action Reference
章节,也有在线版本,在线版本是 Web API Action
Reference

。当然,这个章节的内容会变化,要查看Dynamics
CRM对应版本的SDK。今天要讲解的是利用Fiddler的Replay功能通过Web
API调用操作。

原创地址:http://www.cnblogs.com/jfzhu/archive/2012/10/12/2721888.html

在继续阅读之前,如果你对通过Web
API执行操作没有概念,强烈建议你先阅读我的文章:Dynamics CRM
2015/2016新特性之二十四:使用Web
API执行操作
 。

转载请注明出处

我们先看 ExecuteWorkflow
Action

的说明,可以知道它是一个绑定操作, 它有一个输入参数 EntityId
,也有返回参数,是个asyncoperation
实体记录类型。为了测试需要,先要找一个工作流,我这里有一个工作流如下,我这里故意没有选中
作为按需流程
,是因为我想看看不选中这个是否也可以通过代码执行这个工作流,当然在界面上通过运行工作流此时是找不到这个工作流的。

 

图片 1

Microsoft Dynamics
CRM本质上只是一个ASP.Net程序,当然它是一个很厉害的,高手们开发出来的程序。基本上每一个窗口或者对话框都有固定的URL,这些窗口或对话框的特性也是由URL中的query
string来决定。也就是说,如果你知道了某个窗口或对话框的URL是什么,你就可以在扩展CRM时,用JScript来打开这个窗口或对话框了。

 

 

然后我需要找一条这个工作流对应实体的一条记录,我这里选择一条记录。顺便介绍下如何获取记录ID的方法,右击一条记录,选择
在新窗口中打开 。

下面举一个简单的例子来看如何获得一个窗口的URL,以及这个URL能给我们什么信息。打开一个客户:

图片 2

图片 3

 

你可以点击上面的复制链接来获取URL,你也可以Ctrl +
N,然后从地址栏复制URL。

然后就会在新窗口中打开,可以看到打开记录时候的URL是类似: https://demo.luoyong.me/main.aspx?etc=10007&extraqs=&histKey=789763582&id=%7bB907DE1B-CF99-E611-8161-000D3A80C8B8%7d&newWindow=true&pagetype=entityrecord&sitemappath=SFA%7cExtensions%7cly\_test\#348434379
。这个URL中的id=%7b 和 %7d之间的就是这个记录的ID。

复制出来的URL为:

我们还需要执行的工作流的ID,在解决方案中双击打开该工作流,有类似这样的URL:https://demo.luoyong.me/sfa/workflow/edit.aspx?\_CreateFromId=%7b2721DA92-65A4-E511-80CB-000D3A80CE7F%7d&\_CreateFromType=7100&appSolutionId=%7b2721DA92-65A4-E511-80CB-000D3A80CE7F%7d&id=%7b6BEBC426-F722-4B64-AE5D-0DA379F8A8C4%7d 

http://yourserver/yourorganization/main.aspx?etc=1&extraqs=formid%3d0d6c2857-e8ca-435a-a830-a335ab2139fb&id=%7b8650EB9D-AAC5-E111-AD1C-00155DA83B2B%7d&pagetype=entityrecord

同样的我们可以拿到这个工作流的ID。

从这个URL我们可以得到的信息为etc(entity type
code)为1,也就是客户的object type
code值为1。我们现在打开的这个表单的Form
ID为0d6c2857-e8ca-435a-a830-a335ab2139fb。该客户的ID为7b8650EB9D-AAC5-E111-AD1C-00155DA83B2B%7d。如果你要打开一个联系人的窗口,你只需要知道这个联系人的ID,联系人的object
type code,以及要用哪一个Form打开(Form
ID)。其实在SDK中有一个章节已经把这个部分讲的很明白了,大家可以参见SDK中“Open
Forms, Views, and Dialogs with a URL”这一章节。

我这里借助Fiddler来Replay,启用Fiddler抓包,右击一个请求,选择 Replay
> Reissue from Composer.

 

 图片 4

对于一个窗口或者表单(Form),我们已经知道如何查看它的URL了,但如果是一个对话框(Dialog),我们如何查看它的URL呢?比如点击客户上的Parent
Company查找按钮,就可以弹出一个对话框来。通常在这个对话框中,你是看不到URL的。

在Fiddler的Composer中打开页面类似如下:

图片 5

图片 6

我在之前的文章向大家介绍过使用F12 Developer
Tools来对CRM进行剖析
,这一文章中,我再向大家介绍另一个利器图片 7,来帮助我们获得对话框的URL,它就是Fiddler。当然Fiddler绝不只是用来获取URL的,它的功能非常强大,有兴趣的同学可以参看http://www.fiddler2.com/fiddler2/。首先启动Fiddler。

 

图片 8

然后我们就可以更改请求方法,请求URL,请求头Header和请求体Body。我这里更改如下:

然后点击Parent Company查找按钮,Fiddler可以显示出你访问过的URL是什么。

POST的URL我改成了:https://demo.luoyong.me/api/data/v8.2/workflows(6BEBC426-F722-4B64-AE5D-0DA379F8A8C4)/Microsoft.Dynamics.CRM.ExecuteWorkflow

图片 9

 Request
Body我改成了如下,特别注意这个Cookie的元素值要保留,用来认证的,当然也会过期:

选择带有lookup的那一行记录,复制URL,复制结果为:

Content-Type: application/json; charset=utf-8
Accept: application/json
OData-MaxVersion: 4.0
OData-Version: 4.0
Cookie: ReqClientId=dff59da0-52dd-42f9-8ab9-e62ad9b24e57;
e9cd027f-26a3-e511-80c6-000d3a807ec7_bd2a5c49-6b08-4eda-8a15-84159d9fd349=/Date(1478082706255)/;
persistentNavTourCookie=HideNavTour;
CRM_MSG_BAR_ServiceDeskAlert%23e9cd027f-26a3-e511-80c6-000d3a807ec7=HideMessage;
MSISAuth=77u/PD94bWwgdmVyc2lvbj0iMSlSNWN6UEdTQm9Md0FnQUFFWU8ydHhxQXNxTVo0NS83WUJRL3pGdk1ZWndQWld6RnhjcVhHYWx6ZjZscFVsUVBnVWprSnArVVZYY0IxcGNsMXF5VmZ0UVm5nVnFSc3pxV1RKbjlrMWxlRWhB;
MSISAuth1=M3VIZmdZZmVF0eUNvbnRleHRUb2tlbj4=;
CRM_MSG_BAR_e9cd027f-26a3-e511-80c6-000d3a807ec7GetAppsForCrm=HideMessage;
CRM_MSG_BAR_EnableS2SAlert%23e9cd027f-26a3-e511-80c6-000d3a807ec7=HideMessage

http://yourserver/yourorganization/_controls/lookup/lookupinfo.aspx?AllowFilterOff=0&DefaultType=1&DefaultViewId=%7bA9AF0AB8-861D-4CFA-92A5-C6281FED7FAB%7d&DisableQuickFind=0&DisableViewPicker=0&LookupStyle=single&ShowNewButton=1&ShowPropButton=1&browse=0&currentid=%7b8650EB9D-AAC5-E111-AD1C-00155DA83B2B%7d&objecttypes=1
857-e8ca-435a-a830-a335ab2139fb&id=%7b8650EB9D-AAC5-E111-AD1C-00155DA83B2B%7d&pagetype=entityrecord

 Request Body我改成了:

 

{“EntityId”:”B907DE1B-CF99-E611-8161-000D3A80C8B8″}

由于上面的URL是被encode过的,所以不是很容易读,我推荐大家再使用一个URL
Decoder/Encoder的网站来帮助你对URL解码。

 我执行的话会返回HTTP Status为500,内部错误:

图片 10

HTTP/1.1 500 Internal Server Error
Cache-Control: no-cache
Pragma: no-cache
Content-Type: application/json; odata.metadata=minimal
Expires: -1
Server: Microsoft-IIS/8.5
REQ_ID: 5b92fe5f-7856-4817-bc18-210b20fa2b08
OData-Version: 4.0
X-AspNet-Version: 4.0.30319
X-Powered-By: ASP.NET
Date: Mon, 24 Jul 2017 15:33:39 GMT
Content-Length: 2869

解码后的URL为:

{
“error”:{
“code”:””,”message”:”Workflow must be marked as on-demand or child
workflow.”,”innererror”:{
“message”:”Workflow must be marked as on-demand or child
workflow.”,”type”:”System.ServiceModel.FaultException`1[[Microsoft.Xrm.Sdk.OrganizationServiceFault,
Microsoft.Xrm.Sdk, Version=8.0.0.0, Culture=neutral,
PublicKeyToken=31bf3856ad364e35]]”,”stacktrace”:” at
Microsoft.Crm.Extensibility.OrganizationSdkServiceInternal.Execute(OrganizationRequest
request, CorrelationToken correlationToken, CallerOriginToken
callerOriginToken, WebServiceType serviceType, Boolean checkAdminMode,
ExecutionContext executionContext)\r\n at Microsoft.Crm.”
}
}
}

http://yourserver/yourorganization/_controls/lookup/lookupinfo.aspx?AllowFilterOff=0&DefaultType=1&DefaultViewId=%7BA9AF0AB8-861D-4CFA-92A5-C6281FED7FAB%7D&DisableQuickFind=0&DisableViewPicker=0&LookupStyle=single&ShowNewButton=1&ShowPropButton=1&browse=0&currentid=%7B8650EB9D-AAC5-E111-AD1C-00155DA83B2B%7D&objecttypes=1
857-e8ca-435a-a830-a335ab2139fb&id={8650EB9D-AAC5-E111-AD1C-00155DA83B2B}&pagetype=entityrecord

提示很清晰,工作流必须要选中 作为按需流程
或者是子流程才行。于是我停用该工作流,然后激活该工作流,再来尝试,执行结果如下:

 

图片 11

我们来看URL里的参数:

如果查看原版的返回内容是这样的:

(1)objecttypes:这个参数后边的数值表示可以查找的entity type
code,这里的1表示是客户,如果我们还想查找联系人,可以将这里改为objecttypes=1,2。
(2)DefaultType:默认的查找entity

HTTP/1.1 200 OK
Cache-Control: no-cache
Pragma: no-cache
Content-Type: application/json; odata.metadata=minimal
Expires: -1
Server: Microsoft-IIS/8.5
REQ_ID: 0ad59cc7-ab4e-49bf-a05b-8b522db29c75
Preference-Applied: return=representation
OData-Version: 4.0
X-AspNet-Version: 4.0.30319
X-Powered-By: ASP.NET
Date: Mon, 24 Jul 2017 15:39:04 GMT
Content-Length: 38136

(3)DefaultViewId: 对默认entity的默认View

{
“@odata.context”:”https://demo.luoyong.me/api/data/v8.2/$metadata\#asyncoperations/$entity","statecode":0,"asyncoperationid":"f9349b37-8670-e711-826c-000d3a80c8b8","\_regardingobjectid\_value":"b907de1b-cf99-e611-8161-000d3a80c8b8","\_owningextensionid\_value":"c8556024-8670-e711-826c-000d3a80c8b8","createdon":"2017-07-24T15:39:03Z","\_workflowactivationid\_value":"c8556024-8670-e711-826c-000d3a80c8b8","depth":1,"messagename":"ExecuteWorkflow","\_ownerid\_value":"e9cd027f-26a3-e511-80c6-000d3a807ec7","name":"\\u7f57\\u52c7\\u6d4b\\u8bd5\\u5b9e\\u4f53\\u5b57\\u6bb5\\u503c\\u53d8\\u66f4\\u540e\\u8fd0\\u884c\\u7684\\u5de5\\u4f5c\\u6d41","requestid":null,"friendlymessage":null,"retrycount":null,"startedon":null
}

(4)DisableQuickFind: 对应Search栏

 可以看到执行成功,我去界面上也可以看到执行了工作流:

(5)DisableViewPicker: 不允许改变View

图片 12

(6) LookupStyle:决定是多选(multi)还是单选(single)

 

(7) ShowNewButton:显示New按钮

(8)ShowPropButton:显示Properties按钮

(9)browse:决定lookfor, view, search整个这些是否存在,1为不存在

图片 13

我们来构建一个URL,实现以下功能:

(1)objecttypes:可查找类型为客户、联系人(entity type code 1, 2)
(2)DefaultType:默认的查找entity为联系人

(3)DefaultViewId: 不使用这个参数,可以让系统决定使用哪个view

(4)DisableQuickFind: 不disable

(5)DisableViewPicker: disable

(6) LookupStyle:单选

(7) ShowNewButton:不显示

(8)ShowPropButton:不显示

(9)browse:0

构建好的URL应为:

http://yourserver/yourorganization/_controls/lookup/lookupinfo.aspx?AllowFilterOff=0&DefaultType=2&DisableQuickFind=0&DisableViewPicker=1&LookupStyle=single&ShowNewButton=0&ShowPropButton=0&browse=0&objecttypes=1,2

将这个URL直接复制到IE中打开,看到结果为:

图片 14

在JS中,如何利用这个URL来打开对话框呢?我们可以使用window.showModalDialog这个方法。举一个例子,我们为一个联系人选择parent
customer。

图片 15

在JS中,使用以下代码:

var url = Xrm.Page.context.prependOrgName("/_controls/lookup/lookupinfo.aspx?"
+ "AllowFilterOff=0&DefaultType=2&DisableQuickFind=0&DisableViewPicker=1" 
+ "&LookupStyle=single&ShowNewButton=0&ShowPropButton=0&browse=0&objecttypes=1,2");
var result = window.showModalDialog(url);
if (result != null) {
    var value = new Array();
    value[0] = new Object();
    value[0].id = result.items[0].id;
    value[0].name = result.items[0].name;
    value[0].entityType = result.items[0].type == 1 ? "account" : "contact";
    Xrm.Page.getAttribute("parentcustomerid").setValue(value);
}

再进阶一下,看一个多选的例子。我们要写一封email,我们要选择收件人:

图片 16

我们可以使用以下的URL及JScript:

/_controls/lookup/lookupinfo.aspx?AllowFilterOff=0&DefaultType=1&DisableQuickFind=0&DisableViewPicker=1&LookupStyle=multi&ShowNewButton=0&ShowPropButton=0&browse=0&objecttypes=1,2

注意参数中的值是multi,不是multiple。

var url = Xrm.Page.context.prependOrgName("/_controls/lookup/lookupinfo.aspx?"
+ "AllowFilterOff=0&DefaultType=1&DisableQuickFind=0&DisableViewPicker=1"
+ "&LookupStyle=multi&ShowNewButton=0&ShowPropButton=0&browse=0&objecttypes=1,2");
var result = window.showModalDialog(url);
if (result != null) {
    var value = new Array();
    for (var i = 0; i < result.items.length; i++) {
        value[i] = new Object();
        value[i].id = result.items[i].id;
        value[i].name = result.items[i].name;
        value[i].entityType = result.items[i].type == 1 ? "account" : "contact";
    }
    Xrm.Page.getAttribute("to").setValue(value);
}

 

 

admin

相关文章

发表评论

电子邮件地址不会被公开。 必填项已用*标注