Produced by Araxis Merge on 2/1/2017 2:56:30 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.
| # | 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\CrmSvcUtilExtensions\GeneratePicklistEnums | Readme.docx | Tue Dec 20 19:51:44 2016 UTC |
| 2 | Wed Feb 1 19:56:29 2017 UTC |
| Description | Between Files 1 and 2 |
|
|---|---|---|
| Text Blocks | Lines | |
| Unchanged | 0 | 0 |
| Changed | 0 | 0 |
| Inserted | 0 | 0 |
| Removed | 1 | 60 |
| 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 |
No regular expressions were active.
| 1 | Microsoft Dynamics C RM SDK | |||||
| 2 | GeneratePi cklistEnum s Readme | |||||
| 3 | ||||||
| 4 | Overview | |||||
| 5 | This sampl e extensio n to the c ode genera tion tool (CrmSvcUti l.exe) gen erates enu merations for the op tion sets, state cod es, and st atus codes in a Micr osoft Dyna mics CRM o rganizatio n. When co mpiled to an assembl y and load ed by the CrmSvcUtil program, this exten sion gener ates an ou tput sourc e code fil e containi ng these e numeration s that can be includ ed in your applicati on’s proje ct. These enumeratio ns make yo ur code mo re readabl e and are supported by Microso ft Visual Studio Int elliSense. For more informatio n on runni ng CrmSvcU til.exe, s ee the rel ated topic in the Mi crosoft Dy namics CRM SDK. | |||||
| 6 | ||||||
| 7 | Contents | |||||
| 8 | CodeCustom izationSer vice.cs - Implements ICustomiz eCodeDomSe rvice to m anipulate the Code D ocument Ob ject Model (DOM). | |||||
| 9 | FilteringS ervice.cs - Implemen ts ICodeW riterFilte rService t hat provid es custom logic to i ndicate if a given i tem (optio n set, sta te, or sta tus code) will have code gener ated for i t. | |||||
| 10 | NamingServ ice.cs – I mplements custom log ic to buil d enumerat ion type n ames that will appea r in the g enerated o utput file . | |||||
| 11 | GeneratePi cklistEnum s.csproj – Visual St udio proje ct file. | |||||
| 12 | GenerateOp tionSets.b at – Batch command f ile to exe cute the C rmSvcUtil. exe comman d with the sample ex tension. Y ou must cu stomize th e command in the bat ch file as appropria te for you r Microsof t Dynamics CRM insta llation. | |||||
| 13 | ||||||
| 14 | Instructio ns | |||||
| 15 | How to Bui ld the Sam ple | |||||
| 16 | To build t his sample extension , follow t hese steps . | |||||
| 17 | Edit the G enerateOpt ionSets.ba t file as appropriat e for your Microsoft Dynamics CRM instal lation. Sp ecifically , indicate the corre ct server and organi zation in the /url p ortion of the comman d and spec ify the ht tp or http s protocol depending on how yo ur server is configu red. | |||||
| 18 | Open the s olution fi le Generat ePicklistE nums.sln i n Visual S tudio 2012 or 2013. | |||||
| 19 | Press F6. | |||||
| 20 | ||||||
| 21 | How to Run the Sampl e | |||||
| 22 | Change the working f older to t he bin\Deb ug folder of your pr oject. | |||||
| 23 | Run the Ge nerateOpti onSets.bat file. | |||||
| 24 | ||||||
| 25 | Expected R esults | |||||
| 26 | ||||||
| 27 | You should see an Op tionSets.c s file in your worki ng folder. | |||||
| 28 | ||||||
| 29 | If you get a run-tim e authenti cation err or, you ma y need to provide a user name and passwo rd argumen t to the c ommand in the batch file becau se your de fault cred entials we re not fou nd in the system cre dential ca che. For m ore inform ation, ref er to the SDK topic Create Ear ly-Bound E ntity Clas ses with t he Code Ge neration T ool (CrmSv cUtil.exe) . | |||||
| 30 | ||||||
| 31 | A sample O ptionSets. cs output file is pr ovided in the Sample Code\CS\He lperCode f older. The sample lo cated at S ampleCode\ CS\QuickSt art makes use of thi s sample e numeration s file. | |||||
| 32 | ||||||
| 33 | ||||||
| 34 | About the Extension Source Cod e | |||||
| 35 | ||||||
| 36 | By default , the samp le extensi on does no t generate state cod es. This i s required because t he standar d output o f CrmSvcUt il, withou t this ext ension, in cludes the se state c odes. Deve lopers usi ng the ear ly-bound t ypes in th eir applic ations, fo r example: SampleCod e\CS\Helpe rCode\MyOr ganization CrmSdkType s.cs, will be able t o include the types file and t he enumera tions file in their applicatio n and comp ile it. | |||||
| 37 | ||||||
| 38 | If you are not using this samp le extensi on in conj unction wi th the sta ndard type s output f rom CrmSvc Util.exe, both of th ese prepro cessor dir ectives sh ould be re moved or c ommented o ut so that state cod e enumerat ions will be generat ed in the output fil e. | |||||
| 39 | ||||||
| 40 | FilteringS ervice.cs: #define SKIP_STATE _OPTIONSET S | |||||
| 41 | CodeCustom izationSer vice.cs: # define REM OVE_PROXY_ TYPE_ASSEM BLY_ATTRIB UTE | |||||
| 42 | ||||||
| 43 | About the Generated Code | |||||
| 44 | When revie wing the e xtension’s source co de, one th ing that y ou should be aware o f is how t he code ha ndles dupl icate opti on names o r names th at appear to be dupl icated aft er removin g spaces t o form a v alid ident ifier. Th e code gen erates a v alid ident ifier name for the o ption in a n option s et, and if that iden tifier has already b een used i n the opti on set, it will appe nd an unde rscore and number to the end o f the iden tifier. F or example , if an op tion set c ontained o ptions “It em,” “Item ,” “ItemVa lue,” and “Item Valu e”, the ge nerated en umeration option nam es would b e “Item”, “Item_2”, “ItemValue ,” and “It emValue_2. ” It is w orth notin g that if an option’ s name is changed an d the code for the o ption sets is regene rated, any existing code will be broken because th e code gen erated is based on t he name of the optio n. | |||||
| 45 | Important Notes | |||||
| 46 | The sample files are not inten ded to be used in a production environme nt. You sh ould deplo y this sam ple to a t est enviro nment and examine it for inter action or interferen ce with ot her parts of the sys tem. | |||||
| 47 | Before you deploy th is sample to a produ ction envi ronment, m ake sure t hat you co nsider the existing customizat ions you m ay have im plemented in Microso ft CRM 201 5. | |||||
| 48 | ||||||
| 49 | Copyright | |||||
| 50 | This docum ent is pro vided "as- is". Infor mation and views exp ressed in this docum ent, inclu ding URL a nd other I nternet We b site ref erences, m ay change without no tice. You bear the r isk of usi ng it. | |||||
| 51 | ||||||
| 52 | Some examp les depict ed herein are provid ed for ill ustration only and a re fictiti ous. No re al associa tion or co nnection i s intended or should be inferr ed. | |||||
| 53 | ||||||
| 54 | This docum ent does n ot provide you with any legal rights to any intell ectual pro perty in a ny Microso ft product . You may copy and u se this do cument for your inte rnal, refe rence purp oses. | |||||
| 55 | ||||||
| 56 | © 2015 Mic rosoft Cor poration. All rights reserved. | |||||
| 57 | ||||||
| 58 | Microsoft, Active Di rectory, A ctiveX, Bi zTalk, JSc ript, Micr osoft Dyna mics, Outl ook, Share Point, SQL Server, V isual Basi c, Visual Studio, Wi ndows, Win dows Serve r, and Win dows Vista are trade marks of t he Microso ft group o f companie s. | |||||
| 59 | ||||||
| 60 | All other trademarks are prope rty of the ir respect ive owners . |
Araxis Merge (but not the data content of this report) is Copyright © 1993-2016 Araxis Ltd (www.araxis.com). All rights reserved.