Today someone from Sales department tried to assign an entity (this time a Contact, previous time an Account) to someone else. In cleaning up and/or deviding contacts within the Sales team, this is a daily routine and common practice for our Sales people.

The error that the Sales person got had something to do with insufficient permissions on assigning an entity and that the role he/she was in, did not have enough permissions :

My first thought was : bullshit!

In my search for an answer, I discovered some interesting facts… (and a sleezy solution of course! )

• The standaard role that the Sales person had, was enough to assign entity-records to himself or anyone else.
• Even the CRM System Admin user could not assign the entity-record to someone.
• Other entity-records are easily assigned to other people.

Solution

This is just a temporary one (hopefully), until we install Update Roll Up #4 :

1. Give the System Administrator securityrole to the CRM-user that got the “insufficient permissions” error.
2. Let the user assign the entity-record to the designated CRM-user.
3. Remove the System Administrator securityrole.

That’s that! If there is anyone in CRM world that had this same problem, please leave a comment! I’m interested in a more… well… a better solution

This way…

• I can reach a larger public (or group of readers)
• English speakers don’t have to user Google translator anymore to read posts like a lot do with Crm 4.0 Plugin voor dummies
• I can freshen up my skills in talking another language than Dutch.
• English sounds kinda cool…

Maybe when I have some time off, I’ll translate my previous posts. Until then : happy google-translating

Use Filtered Views instead of Tables or Views, otherwise you will recieve errors when running the report after importing it :

An error has occurred during report processing.
Query execution failed for data set 'Test_Dataset'
For more information about this error navigate to the report server on the local server machine, or enable remote errors

Going back to basics and suddenly I started thinking : But what was the solution?

Viewstate in ASP.NET! So after some digging, some google I found my hero : Gustaf Westerlund.
Add this line to your web.config of your custom ASP.NET application for CRM 4.0 and you are done :

<pages enableViewState="true" />

Shame on me for not seeing that in an earlier stage!

The viewstate in your web.config in the root of your CRM installation is set to false. That means that every site “beneath” that root level is taking over this viewstate setting… To false! So basically… Viewstate is evil! ASP.NET is scary!

Ow…yeah… and don’t forget to enable this property for your databound controls :

AppendDataBoundItems="True"

Dit lost dus voor mij een berg problemen met databinding en postbacks op, misschien heeft die ene trouwe lezer van mijn blog er wat aan?

This is solving a lot of databinding and postback problems! Maybe I’m helping that one reader of my blog with this?

PS: Gustaf, thank you very much!

Therefore I posted some code which shows creation of a contact-record with duplicate detection :

contact eenContact = new contact();
eenContact.firstname = "Bert-Jan";
eenContact.lastname = "Diedering";
eenContact.address1_city = "Utrecht";

TargetCreateContact target = new TargetCreateContact();
target.Contact = eenContact;

CreateRequest request = new CreateRequest();
request.Target = target;
request.OptionalParameters = new OptionalParameter[]
{
new CreateDuplicatesOptionalParameter {Value = false}
};

CreateResponse response = (CreateResponse)client.Execute(request);

Also read a few words about the OptionalParameter.

1. Allereerst moeten we natuurlijk de log4net dll downloaden : http://logging.apache.org/log4net/download.html
2. Dan leggen we een referentie naar de dll.
3. Dan deze code bovenin je classes die je van logging wilt voorzien :

private static ILog logger = LogManager.GetLogger(MethodBase.GetCurrentMethod().DeclaringType.Name);

(owja MethodBase.GetCurrentMethod zit in de Sytem.Reflection class en op deze manier hoef je niet iedere keer een naam in te voeren die de huidige class representeerd…)

4. Vervolgens in de Page_Load van een Webapplicatie of in de Main van je console of Winforms applicatie :

XmlConfigurator.Configure();

5. Dan in de config-file (app.config of web.config) een configSection toevoegen :

<section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler, log4net" />

6. Onderaan de config-file je log4net configuratie toevoegen :

<log4net>
<appender name="ColoredConsoleAppender" type="log4net.Appender.ColoredConsoleAppender">
<mapping>
<level value="ERROR" />
<foreColor value="White" />
<backColor value="Red, HighIntensity" />
</mapping>
<layout type="log4net.Layout.PatternLayout, log4net">

<param name="ConversionPattern" value="%date [%thread] %-5level %logger [%property{NDC}] - %message%newline" />
</layout>
</appender>

<appender name="GeneralFileLog" type="log4net.Appender.RollingFileAppender">       <file value="BertusTool.log" />       <appendToFile value="true" />       <maximumFileSize value="10000KB" />       <rollingStyle value="Size" />       <maxSizeRollBackups value="5" />       <layout type="log4net.Layout.PatternLayout, log4net">         <param name="ConversionPattern" value="%date [%thread] %-5level %logger [%property{NDC}] - %message%newline" />       </layout>     </appender>

<!-- levels: DEBUG, INFO, WARN, ERROR, FATAL -->
<root>
<level value="INFO"/>
<appender-ref ref="GeneralFileLog" />
<appender-ref ref="ColoredConsoleAppender" />
</root>
</log4net>

De eerste appender zorgt ervoor dat er een console geopend wordt, waarin gelogd wordt. De laatste appender is een fileappender.

7. In je code kun je dan bijvoorbeeld zeggen :

logger.Error("Help!", ex);

8. Voor meer informatie over andere appenders :

http://logging.apache.org/log4net/release/config-examples.html

Zo… dat vergeet ik niet zo snel meer

Edit : Een collega van me bij Sogyo kwam met de melding dat hij een errormelding kreeg op de log4net configuratie zoals hierboven beschreven. Na een onderzoek kwam ik tot de conclusie dat de SyntaxHighlighter de value in het conversionPattern foutief weergeeft. Ik heb het pattern vervangen door een simpele, die wel correct wordt weergegeven (bron : http://logging.apache.org/log4net/release/config-examples.html)

Edit2 : André Boonzaaijer heeft een sheet voor als je wilt weten hoe je standaard framework logging wilt gebruiken

Hier zijn mijn bevindingen :

1. De looks zijn perfect!
2. Alle opties van Windows Mobile 2003 zitten er in, met nog een aantal extra.
3. Af en toe doen de notification geluiden (gebeld worden, reminders, smsjes) het niet meer. Wat hiervan de oorzaak is weet ik nog niet.
4. Internet explorer 6! Nadeel is wel dat veel websites niet ontdekken dat het een mobile internet explorer is dus daarom wordt de gehele pagina gerenderd ipv de mobile versie.
5. Voordeel van IE6 is dat aangetoond wordt hoeveel kb er nog geladen moet worden.
6. Bovenin de titel balk wordt aangegeven hoeveel GPRS bereik je eigenlijk hebt. Was eerder niet zo…
7. Bij het openen van een text bericht wordt de gehele conversatie weergegeven.
8. Het scherm is te locken/unlocken.
9. Phone en Contacts knop worden onderin weergegeven.
10. Knoppen die eerder verstopt zaten onder het toetsenbord, zijn nu beschikbaar onderin het scherm.
11. Maar liefst 5 skins oftewel themes!
12. Rete snel (oftewel ietsje sneller dan voorheen met Windows Mobile 2003) en de snelheid is aan te passen
13. Het flashen van de ROM kan ook vanaf Radio version 1.13.00 (proefondervindelijk ondervonden)
14. Internetinstellingen van T-mobile was binnen paar minuten gebeurd.

* Mad Props (of kudos) voor een zekere Rus genaamd Cotulla !!

Deze vragen worden in deze post beantwoord aan de hand van een scenario, om een beeld te krijgen van een mogelijk doel van een plugin.

Scenario

Stel : De afdeling Finance krijgt een brief binnen met daarin de melding dat een bepaalde medewerker schade heeft gereden aan de lease-auto. De Finance medewerker wil hiervan de medewerker op de hoogte stellen door middel van een email, maar er niet teveel tijd aan besteden. De stappen die de Finance medewerker dus zal doorlopen zijn de volgende :

1. Zoek de desbetreffende medewerker op in CRM.
2. Start een nieuwe email activiteit voor de medewerker.
3. Koppel eventueel een attachment aan de email.
4. Kies een template die overeenkomt met de soort brief.
5. Klik op Send.*

* Dit zou ook in bulk mogelijk moeten zijn : bijvoorbeeld alle medewerkers emailen hoeveel vakantie dagen ze nog hebben of dat de urenstaat nog ingevuld moet worden.

Omdat het over Finance emails gaan, en omdat de inhoud niet aan andere gebruikers van CRM zichtbaar mag zijn, moeten de emails afgeschermt worden, maar wel onder een medewerker komen te hangen in een soort van berichtgeschiedenis.

Het idee

Wat uit dit scenario op te maken is,  is het volgende :

Voordat een email gecreeerd wordt aan de hand van een speciale Finance template, moet de betreffende persoon in het Regarding veld (dus niet de Recipient) vervangen worden door een Finance Dossier van die persoon. De email komt hierdoor dan niet onder de History van Activities van de persoon zelf. De email komt nu in de History van Activities van het Finance Dossier van die persoon. Waarom? Omdat niet iedere CRM gebruiker hoeft te zien dat een medewerker een boete heeft gereden of schade veroorzaakt aan een lease-auto. Deze informatie is namelijk alleen nuttig voor de afdeling Finance. Dus : het dossier moet afgeschermt worden. Dit kan met behulp van Security Roles setten voor gebruikers groepen. Voordat de email verzonden moet worden,

Stap 1 : Het begin

Men neme de CRM 4.0 VPC van Microsoft, open het meegeleverde Visual Studio 2005 en start een nieuw Class Library project.

• Hernoem Class1 naar FinanceDossierPlugin (of iets anders moois)
• Leg een referentie naar de Microsoft.Crm.Sdk.dll en de Microsoft.Crm.SdkTypeProxy.dll.
• Voeg een paar usings toe :

using Microsoft.Crm.Sdk;
using System.IO;
using Microsoft.Crm.Sdk.Query;

• Implementeer de interface IPlugin met Shift+ALT+F10
• Om ook te kunnen loggen :

using (TextWriter logger = TextWriter.Synchronized(File.AppendText(@"C:\Program Files\Microsoft Dynamics CRM Server\Trace\FinancePlugin.txt")))  {
//plugin code
}

• Een try… catch om de code heen om InvalidPluginExecutionException af te vangen :

try {

}
catch(Exception ex)
{
string logMessage = "Exceptie in de Finance plugin: ";
log.WriteLine(logMessage + ex.Message);
throw new InvalidPluginExecutionException(logMessage, ex);
}

• Nu gaan we bepalen of we in de goede context zitten :

if (  context.InputParameters.Properties.Contains(ParameterName.Target) &&
context.InputParameters.Properties[ParameterName.Target] is Microsoft.Crm.Sdk.DynamicEntity
)
{
Microsoft.Crm.Sdk.DynamicEntity entity = (Microsoft.Crm.Sdk.DynamicEntity)context.InputParameters.Properties[ParameterName.Target];
if (entity.Name != EntityName.email.ToString())
{
log.WriteLine("De entiteit in deze context is geen email maar " + entity.Name);
return;
}
if (context.Stage != (int)Microsoft.Crm.Sdk.MessageProcessingStage.AfterMainOperationOutsideTransaction)
{
log.WriteLine("Plugin moet in post-stage runnen!");
throw new InvalidPluginExecutionException("Plugin moet in post-stage runnen!");
}
// Business Logic
}
else
{
log.WriteLine("Verkeerde context...");
return;
}

In regels 1 t/m 4 kijken we of de Message wel een Create opdracht is. Aan de hand van de target kun je dat bepalen. In regel 7 t/m 11 kijken we of het een email bericht betreft. We willen natuurlijk een actie uitvoeren voordat de email verstuurd wordt. In regel 12 t/m 16 wordt gekeken of we daadwerkelijk wel in de post-stage zitten.

Stap 2 : Business logica

Nu de business logica. De email moet dus voordat deze verzonden wordt het regarding veld omgezet hebben naar een bij een medewerker behorend contactpersoon. Hiervoor hebben we het Id van de email nodig omdat hier aan een contactpersoon gekoppeld zit. Met het emailId kunnen we het contactId ophalen, die we daarna kunnen gebruiken om de bijbehorende Finance Dossier op te halen en die te koppelen aan het regardingobjectid van de email. Vervolgens moet de email geupdate worden. De email wordt namelijk voor het verzenden opgeslagen als Activity.

ICrmService service = context.CreateCrmService(false);   Guid EmailID = Guid.Empty;
Guid ContactID = Guid.Empty;
Guid FinanceDossierID = Guid.Empty;

if (context.OutputParameters.Properties.Contains(ParameterName.Id))
{
EmailID = new Guid(context.OutputParameters.Properties[ParameterName.Id].ToString());
if (entity.Properties.Contains("regardingobjectid"))
{
email deEmail = (email)service.Retrieve(EntityName.email.ToString(), EmailID, new AllColumns());
if(deEmail.regardingobjectid.type == EntityName.contact.ToString())
{
ContactID = deEmail.regardingobjectid.Value;
DynamicEntity financeDossier = RetrieveFinanceDossier(ContactID, service);
Key financeSleutel = financeDossier.Properties["new_financedossierid"] as Key;
FinanceDossierID = financeSleutel.Value;
}
deEmail.regardingobjectid.type = "new_financedossier";
deEmail.regardingobjectid.Value = FinanceDossierID;
service.Update(deEmail);
}
} 

In regel 1 halen we de context afhankelijke CrmService op. Deze gebruiken we in regel 11 om de huidige email op te halen met alle kolommen. Om de custom entiteit op te halen die new_financedossier heet, heb ik een method gemaakt die RetrieveFinanceDossier heet.

In regel 12 t/m 18 verkrijgen we het FinanceDossierId die we nodig hebben om in regel 19 t/m 20 te koppelen aan het regardingobjectid van de email. In regel 21 updaten we de email.
Aan het einde van deze post-send executie van de plugin, wordt de geupdate email verstuurd. Maar voordat onze plugin uberhaubt iets gaat doen, moet deze uiteraard eerst gedeployed worden.

private DynamicEntity RetrieveFinanceDossier(Guid ContactID, ICrmService service) {    ConditionExpression con = new ConditionExpression();
con.AttributeName = "new_financedossierlookupid";
con.Operator = ConditionOperator.Equal;
con.Values = new string[] { ContactID.ToString() };
FilterExpression filter = new FilterExpression();
filter.FilterOperator = LogicalOperator.And;
filter.AddCondition(con);
QueryExpression query = new QueryExpression();
query.EntityName = "new_financedossier";
query.ColumnSet = new AllColumns();
query.Criteria = filter;
RetrieveMultipleRequest retrieve = new RetrieveMultipleRequest();
retrieve.Query = query;
retrieve.ReturnDynamicEntities = true;
RetrieveMultipleResponse retrieved = (RetrieveMultipleResponse)service.Execute(retrieve);
if (retrieved.BusinessEntityCollection.BusinessEntities.Count == 1)
{
return (DynamicEntity)retrieved.BusinessEntityCollection.BusinessEntities[0];
}
else
{
return null;
}
}

Stap 3 : Plugin deployen

Voordat de CRM server de dll slikt, moet deze eerst gesigned worden.

• Sign het project door met de rechtermuisknop op het project klikken, Properties te kiezen en vervolgens het tabblad Signing.
• Vink “Sign the assembly” aan.
• Klik in de dropdownbox op New..
• Kies in de popup een naam voor de plugin keyfile.
• Zet het vinkje “Protect my key file with a password” uit.
• Klik op OK.
• Build het project.

Nu het project gesigned is, hebben we de PluginRegistrationTool nodig. Deze is standaard meegeleverd met de SDK, maar die moet je dan nog wel zelf builden. Pas wel op dat je de referentie naar de webservices aanpast, voordat je gaat builden. Wanneer de build succesvol is, is het aan te raden om de Plugin Registration tool als Tool in Visual Studio op te nemen :

• Klik op tools, External Tools.
• Klik in de popup op Add, en vul een naam.
• Zoek de zojuist gebuilde executable op bij Command.
• Vink “Use Output window” aan.
• Vink “Close on exit” uit.
• Klik op OK.

Start nu de geregistreerde Visual Studio tool. Om connectie te kunnen maken met je CRM server moet je een paar connectie gegevens invullen :

• Een label (voor meerdere connecties)
• Discovery Server (meestal localhost)
• Poort (op de CRM 4.0 VPC van Microsoft is dat standaard 5555)
• Domain niet invullen
• User Name = administrator (moet als Security Role in CRM in de groep “System Administrators”)
• Klik op Connect
• Voer een wachtwoord in.
• Nu de CrmService Url en de MetaDataService Url in beeld zijn, klik op Connect.

Hieronder een screenshot van de Plugin Registration Tool :

Zoek nu je zojuist gebuilde assembly op en kies voor de optie Disk (voor het debuggen in het Stap 4)
Klik op Register Selected Plugins, gevolgd door OK van de popup.

Nu ga we een Step toevoegen. Een step is een actie die uitgevoerd moet worden. Een image is een exacte kopie van deze step, maar is alleen nodig als je meerdere servers hebt waar CRM op draait.

• Klap de Assembly op en klik met de rechtermuisknop op de plugin en kies “Register New Step”.
• Dit scherm gaat het om. Hier voeren we de Step gegevens in.

• Voer bij message “Create” in. Dit omdat we voordat een email gecreeerd (en verstuurd wordt) deze stap uit moet voeren.
• Voer bij Primary entity “email” in
• Voer bij Secondary entity “none” in.
• Klik op “Register New Step”

De nieuwe stap staat in de treeview onder de assembly. Naast de Create message kun je ook nog andere messages (voor andere stappen of steps) afvangen zoals Update of Delete.
Nu gaan we de plugin testen.

Stap 4 : Testen

Voor het testen gaan we in CRM gaan we naar de browser van de client en selecteren een medewerker.

• Open het scherm voor de medewerker.
• Klik op “Send Email”
• Kies nu een template uit die je eerder aangemaakt hebt en klik op OK.
• Zoals je ziet in onderstaand screenshot is, staat er in het regarding veld de medewerker naar wie we de email gaan sturen. Deze wordt zometeen door de plugin gewijzigd in het bijbehorende Finance Dossier.

• Klik nu op “Send” om de email te verzenden.

Om te kijken of alles gelukt is, gaan we naar de medewerker zijn Finance Dossier en zien daar een email staan die verstuurd is, aan de hand van een template.
Open de email en zie dat het regarding veld verander is van de medewerker zijn of haar bijbehorende Finance Dossier :

En zoals ze in die filmpjes van Channel9 en ASP.NET altijd zo mooi kunnen zeggen : “And there you have it…” .

Opmerkingen

Een paar opmerkingen betreft deze uitwerking :

1. De code in dit artikel houdt geen rekening met de selectie van meerdere medewerkers.
2. Wanneer je een contactpersoon (medewerker) enkel selecteerd en vervolgens op de email knop klikt, een template kiest en “Send” kiest, wordt de email niet aan een Finance Dossier gekoppeld (lees : komt in de History van bijbehorend Finance Dossier te staan). De email wordt in dit geval aan de History van de persoon zelf gekoppeld.
3. Voor bulkmail naar meerdere contactpersonen (medewerkers) moet je je step anders configureren. Misschien behandel ik dit in een volgende post.

Tracing

Indien je tracing aangezet hebt voor CRM, kun je naast onze eigen plugin-logfile (FinanceDossier.txt) ook andere logging vinden in de volgende map :

C:\Program Files\Microsoft Dynamics CRM Server\Trace\*.*

Debugging

Het debuggen van je plugin word goed beschreven op deze site van Robert John.

Tijdens het debuggen is het handig om je Dynamic Entity objecten weer te kunnen geven. Net als de standaard Debugger Visualizers van Visual Studio kan dat als je de stappen van deze site van Simon Hutson uitvoerd.

Tenslotte

Mijn blogposts zijn persoonlijk en schrijf ik in eigen tijd. Ze beschrijven meestal onderzoeken die ik voor mijn werk doe, maar dat geeft niet per definitie aan hoe ik bij Sogyo te werk ga.
Plugins worden door Microsoft tot op zekere hoogte ondersteund, maar je blijft altijd zelf verantwoordelijk voor je code.

Mocht je vragen hebben met betrekking tot deze post of heb je hulp nodig met andere aanverwante CRM activiteiten, dan hoor ik dat graag!

Maar hoe fijn is ReSharper?

Persoonlijk ben ik van mening dat je lui bent als je ReSharper gebruikt. Aan de andere kant, hoe vaak gebeurd het niet dat je even niet meer weet hoe je iets moet implementeren? Of hoe vaak gebeurd het niet dat je het gevoel hebt, hetzelfde stukje code in een ander project opnieuw aan het typen bent?

En hoe vaak is die discussie al niet gevoerd op internet? Martin Fowler heeft zelfs de Tools pagina op zijn refactoring site al uitgeschakeld. Een beetje googlen en het lijkt of iedereen er toch wel met veel plezier gebruik van maakt! Er zijn zelfs fanatiekelingen die het twitteren!

Ouderwets

Noem me ouderwets, maar ik ben tegen. Okay, onderstaande screencast is dan wel een leuk voorbeeld van een pluspunt van ReSharper… Maar dat wil nog niet zeggen dat ik ook lui ga worden! Liever klop ik zelf mijn code zodat ik weet wat ik maak, dan dat ik tv ga kijken en ondertussen een ingewikkelde applicatie schrijf… Of…

Let op : Ondanks dat ik van een resharpende collega deze screencast kreeg en dat ik het woord “lui” heb genoemd, wil dat niet zeggen dat mijn werkgever luie mensen in dienst heeft