143. Araxis Merge File Comparison Report

Produced by Araxis Merge on 2/1/2017 2:56:20 PM Eastern Standard Time. See www.araxis.com for information about Merge. This report uses XHTML and CSS2, and is best viewed with a modern standards-compliant browser. For optimum results when printing this report, use landscape orientation and enable printing of background images and colours in your browser.

143.1 Files compared

#	Location	File	Last Modified
1	C:\Araxis_Merge_Comprasion\Pub_un\BTSSS_CIF_122016.zip\BTSSS_CIF_12_20_16\clean\CRM\trunk\SDK\SampleCode\CS\Azure\PersistentQueueListener	PersistentQueueListener_Readme.docx	Tue Dec 20 19:51:42 2016 UTC
2			Wed Feb 1 19:56:20 2017 UTC

143.2 Comparison summary

Description	Between Files 1 and 2
Description	Text Blocks	Lines
Unchanged	0	0
Changed	0	0
Inserted	0	0
Removed	1	89

143.3 Comparison options

Whitespace
Character case	Differences in character case are significant
Line endings	Differences in line endings (`CR` and `LF` characters) are ignored
CR/LF characters	Not shown in the comparison detail

143.4 Active regular expressions

No regular expressions were active.

143.5 Comparison detail

1		Microsoft Dynamics C RM SDK
2		Persistent Queue Lis tener Read me
3		This folde r contains sample co de demonst rating how to write a listener applicati on that re ads messag es from a Windows Az ure persis tent queue . These me ssages are sent to t he queue f rom Micros oft Dynami cs CRM 201 5.
4		Instructio ns
5		Persistent Queue Lis tener Proj ect
6		Configure Windows Az ure and Mi crosoft Dy namics CRM Integrati on
7		Navigate t o http://w ww.microso ft.com/win dowsazure/ and follo w the step s to sign up for a W indows Azu re account . Setting up an acc ount requi res a cred it card bu t there ma y be trial accounts available which at t he time of this writ ing do not charge yo ur credit card. Ple ase read a ny agreeme nts entere d into car efully as the detail s may have changed.
8		Configure Windows Az ure ACS fo r Microsof t Dynamics CRM integ ration by following the instru ctions in the SDK to pic Config ure Window s Azure In tegration with Micro soft Dynam ics CRM.
9
10		Download W indows Azu re Service Bus Issue r Certific ate from t he Microso ft Dynamic s CRM Serv er
11		On a machi ne with th e Windows Azure SDK installed, launch th e Microsof t Dynamics CRM web a pplication .
12		Navigate t o Settings , and then click Cus tomization s.
13		Select Dev eloper Res ources.
14		Click Down load Certi ficate und er Windows Azure Bus Issuer Ce rtificate. If there is no cert ificate, o ne must be configure d before p roceeding.
15		Note the i ssuer name of the ce rtificate mentioned above the Download C ertificate link for later use while conf iguring Wi ndows Azur e using th e Plug-in Registrati on tool.
16		Import the downloade d certific ate into t he local c ertificate store by following these step s.
17		Run the Ce rtificate snap-in of the MMC ( Microsoft Management Console). Open the Start Menu , select R un, enter certmgr.ms c, and pre ss <Enter> .
18		Expand the Certifica tes tree n ode.
19		Right clic k Trusted Root Certi fication A uthorities , select A ll Tasks, and then s elect Impo rt.
20		Follow the Certifica te Import Wizard dia log steps to import the certif icate.
21		Export the certifica te you jus t imported using bas e-64 encod ing by fol lowing the se next st eps.
22		Under the Trusted Ro ot Certifi cation Aut horities n ode, selec t the Cert ificates n ode.
23		Right-clic k the cert ificate in the list that you j ust import ed.
24		In the con text menu, select Al l Tasks, a nd then se lect Expor t.
25		Follow the Certifica te Export Wizard dia log to exp ort a base -64 encode d file wit h a .cer f ile name e xtension t o a machin e with the Windows A zure SDK i nstalled. This certi ficate fil e is for l ater use w hile confi guring Win dows Azure using the Plug-in R egistratio n tool.
26		Configurin g Microsof t Dynamics CRM to po st to Wind ows Azure on creatio n of a let ter.
27		The follow ing proced ure is sim ilar to th e walkthro ugh in the SDK docum entation, except tha t some set tings and values are specific to this sa mple. For more infor mation, se e Walkthro ugh: Regis ter an Azu re-Aware P lug-in wit h Plug-in Registrati on Tool.
28		Using the Plug-in Re gistration tool loca ted in the Bin folde r of the S DK downloa d, connect to the Mi crosoft Dy namics CRM organizat ion which will post to the Win dows Azure endpoint.
29		Select the Register button, an d then fro m the drop down list select Reg ister New Service En dpoint.
30		In the Nam e field en ter a mean ingful ide ntifier su ch as ‘Per sistentQue ueListener ’.
31		In the Des cription f ield enter ‘Persiste nt Queue s ample’.
32		In the Sol ution Name space fiel d enter th e Windows Azure serv ice namesp ace.
33		In the Pat h field en ter the pa th of the persistent queue. Th is is defi ned in the sample co de as ‘MyQ ueue’.
34		In the Con tract drop down selec t Persiste ntQueue.
35		Ensure the Claim dro pdown is s et to None .
36		If you hav e never co nfigured t he service endpoint for the qu eue, compl ete these next steps . Otherwis e, continu e with ste p10.
37
38		One time s etup to co nfigure Wi ndows Azur e through the Plug-i n Registra tion tool for each n ew queue:
39		Select the Save & Co nfigure AC S button.
40		On the ACS Configura tion scree n, enter t he Managem ent Key, C ertificate File, and Issuer Na me.
41		Select the Configure ACS butto n and then select th e Yes butt on when pr ompted to confirm. T he screen should dis play confi guration s etup compl etion with out any er ror.
42		Select the Close but ton to clo se the win dow.
43		On the Ser vice Endpo int Detail s screen, select the Save & Ve rify Authe ntication button to verify the configura tion. A wi ndow shoul d open and display V erify Auth entication : Success.
44		Select the Close but ton to clo se the win dow.
45		Select the Save butt on to save the endpo int config uration.
46		Under the Registered Plugins & Custom Wo rkflow Act ivities li st, right click the (ServiceEn dpoint) Pe rsistentQu eueListene r (the ide ntifier fr om step #3 ) node.
47		Select Reg ister New Step.
48		In the Mes sage field enter Cre ate.
49		In the Pri mary Entit y field en ter letter .
50		Select Reg ister New Step.
51		After the Plug-in Re gistration tool comp letes the step regis tration su ccessfully , close th e tool.
52		How to Ins tall, Buil d, and Run the Sampl e
53		In Windows Explorer, open the WindowsAzu re.sln sol ution.
54		Right-clic k the Pers istentQueu eListener project.
55		Select the Set as St artUp Proj ect menu o ption.
56		Compile an d run the project by pressing F5.
57		At the pro mpt, enter appropria te informa tion (as s hown in th e example screenshot below) to start the listener.
58		After the console ap plication displays: Press [Ent er] to ret rieve a me ssage from the queue (type qui t to exit) , create a nd save a new letter activity in Microso ft Dynamic s CRM.
59		Press <Ent er> in the console w indow to v iew the me ssage post ed from Mi crosoft Dy namics CRM . There ma y be a del ay of seco nds up to a few minu tes before the Micro soft Dynam ics CRM as ynchronous service p osts the m essage to the Window s Azure Se rvice Bus, so be pat ient.
60
61		Expected R esults
62
63		You should see:
64		Troublesho oting
65		Build erro r(s)
66		Ensure the proper re ferences a re added a nd the pro ject is ta rgeting th e .NET Fra mework 4.5 .2 and not the .NET Framework 4.5.2 Clie nt Profile .
67		Run-time e rrors
68		If project hangs whi le the hos t is openi ng check i f Fiddler or some ot her proxy is prevent ing the sa mple from working.
69		If everyth ing seems to run fin e but upon creating a new lett er in Micr osoft Dyna mics CRM n othing sho ws up in t he console window, f ollow thes e steps.
70		Open the M icrosoft D ynamics CR M web appl ication.
71		Navigate t o Settings , then to System Job s.
72		Look for a job regar ding the c reated let ter with ‘ Waiting’ f or the Sta tus Reason .
73		Open that job and vi ew details to get tr oubleshoot ing inform ation.
74		If you are experienc ing errors when runn ing the sa mple, chec k the foll owing.
75		You have f ollowed al l instruct ions in th is documen t correctl y.
76		The server , organiza tion, and logon cred entials yo u entered are correc t.
77		Your accou nt on the Microsoft Dynamics C RM server has the re quired pri vileges to perform t he sample’ s intended operation .
78		Important Notes
79		The sample files sho uld not be used in a productio n environm ent withou t prior te sting. You should de ploy an ap plication that uses this sampl e code to a test env ironment a nd examine it for in teraction or interfe rence with other par ts of the system.
80		Before you deploy ap plications that use this sampl e code to a producti on environ ment, make sure that you consi der the ex isting cus tomization s that you may have implemente d in Micro soft Dynam ics CRM.
81
82		Copyright
83		Microsoft may have p atents, pa tent appli cations, t rademarks, copyright s, or othe r intellec tual prope rty rights covering subject ma tter in th is documen t. Except as expres sly provid ed in any written li cense agre ement from Microsoft , the furn ishing of this docum ent does n ot give yo u any lice nse to the se patents , trademar ks, copyri ghts, or o ther intel lectual pr operty.
84
85		© 2014 Mic rosoft Cor poration. All rights reserved.
86
87		Microsoft, Microsoft Dynamics, Active Di rectory, O utlook, Vi sual Studi o, Windows , Windows Server, an d Windows Vista are trademarks of the Mi crosoft gr oup of com panies.
88
89		All other trademarks are prope rty of the ir respect ive owners .