...ecco i controlli da effettuare

Controllare che le estensioni dei dati per il reportoing service di CRM 2011 siano correttamente installate.

Controllare che l'utente con cui girano i servizi di reportistica abbia i ruoli dbowner, public e CRMReaderRole sui DB del CRM.

Controllare che tutti gli utenti con cui girano i servizi del CRM (sendbox, servizio dei processi asincroni, ...) e l'utente dell'application pool abbiano associato l'indirizzo http del server CRM sia come nome netbios, sia come nome full qualified.

Per settare l'SPN si lancia il comando:
setspn -a HTTP/nomeserver dominio\nome utente
setspn -a HTTP/nomeserver.dominio.suffisso dominio\nomeutente

...usare la Windows Power Shell

Lo script seguente mostra come abilitare il trace:

Add-PSSnapin Microsoft.Crm.PowerShell
$setting = Get-CRMSetting TraceSettings
$setting.Enabled="True"
Set-CrmSetting $setting

A questo punto per vedere l'impostazione si lancia:
Get-CrmSetting TraceSettings

Da cio' si puo' notare che la directory di default e' c:\crmdrop\logs

Per cambiare il path si usa:
$setting.Directory=”percorso”
nello script precedente vicino all'istruzione di abilitazione.

La stessa cosa si ripete per la disabilitazione, ma con un'importante differenza dovuta ad un baco nello snapin. Infatti a prima vista verrebbe da sostituire il "True" nello script precedente con "False" e rilanciare il tutto.

Lanciando il comando per visualizzare lo stato del trace si scopre pero' che esso e' rimasto inspiegabilmente abilitato.
In realta' il comando accettato e' la sotituzione del "True" con la stringa vuota!!!

Quindi il comando da lanciare per la disabilitazione del trace e':

$setting.Enabled=""

...nella connessione via codice alla platform del CRM 2011 online

In particolare viene usata per "presentare" la macchina all'apparato Windows Live che deve effettuare l'autenticazione.

La sua generazione e' realizzabile tramite unos trumento a riga di comando open source contenuto nell'SDK: DeviceRegistrationTool

Tale strumento memorizza di solito nel profilo dell'utente il device id che potra' essere usato dal codice residente sulla macchina per connettersi a windows live id e quindi al CRM 2011 on line (si ricordi che deve essere presente il componente Windows Identity Foundation).

Quindi tale id NON e' da ricreare per ciascun utente, ma piuttosto per ciascuna macchina. Esso e' da utilizzare come quarto parametro nell'instanziazione del proxy della platform del CRM utilizzando le classi di helper dell'SDK come nell'esempio riportato.

....quella descritta di seguito e' la procedura per per rimettere a posto le cose.

Bisogna seguire in rigorosa sequenza i passi seguenti (magari copiando su file come backup i vari mapping):

Eliminare dal path d'installazione del connettore crm4adapter nome tenancy crm, gli object provider (sono file XML) delle entita' duplicate;

Far girare lo strumento di configurazione del CRM mettendo il fag su "skip complete configuration" e TOGLIENDO i flag sulle entita' incriminate.

Chiudere e riaprire lo strumento di gestione del configuratore

Lanciare di nuovo il configuratore del CRM mettendo ancora il flag su "Skip complete configuration" e METTENDO i flag sulle entita' di prima

A questo punto tutto dovrebbe funzionare.

...costantemente tenere aggiornate le proprie macchine di sviluppo

MS garantisce infatti che l'importazione di organizzazioni e soluzioni puo' sempre essere fatto all'indietro, ma quasi mai in avanti!

L'esempio piu' lampante e' quello dell'import di un'organizzazione: se l'installazione di destinazione ha una rollup piu' recente l'importazione non puo' avvenire. Ovviamente sarebbe auspicabile che la versione della rollup sia la stessa.

Ma anche nel caso cio' non succeda, basta che la rollup della destinazione sia superiore. In fase di importazione e verifica appare un warning che segnala la diversa versione dei DB, ma l'operazione puo' essere lanciata.

Una cosa molto simile capita per le soluzioni.

...che puo' portare ad errori. Lo strumento infatti non accetta caratteri speciali (*, %, etc.).

Peccato che quando ci si connette al crm online bisogna farsi generare il famoso ID da inserire come parametro all'atto dell'instanziazione del proxy. La password generata dallo strumento in dotazione all'SDK per tale generazione inserisca tali caratteri nella password!!!br />

Prestare quindi mollta attenzione!!!

...di gestione automatica della posta elettronica del CRM.

L'errore e' del tipo:

#26234 – The E-mail Router service could not process a provider work item using assembly: Microsoft.Crm.Tools.EmailProviders.dll and class: Microsoft.Crm.Tools.Email.Providers.SmtpPollingSendEmailProvider. System.NotSupportedException: The authentication endpoint Username was not found on the configured Secure Token Service! at Microsoft.Crm.ServiceProxyCache`1.BuildServiceProxy(Uri serviceUrl, Credential credentials, Uri homeRealmUrl, String passportEnvironment, IServiceConfiguration`1 serviceConfiguration) at Microsoft.Crm.ServiceProxyCache`1.GetNewServiceProxy(Uri serviceUrl, Credential credentials, Uri homeRealmUrl, String passportEnvironment) at Microsoft.Crm.Tools.Email.Providers.Utility.GetOrganizationUrl(Uri discoveryServiceUrl, Credential credentials, String organizationName) at Microsoft.Crm.Tools.Email.Providers.Utility.GetCrmService(Uri discoveryUri, String authMode, String userName, String password) at Microsoft.Crm.Tools.Email.Providers.CrmPollingSendEmailProvider.Run() at Microsoft.Crm.Tools.Email.Agent.ServiceCore.ExecuteProviderWork(Object providerQueueRequestObject)

Questo succede perche' l'utente con cui lavora il servizio non viene autenticato dal server claims che gestisce l'autenticazione delle installazioni IFD.

Per risolverlo c'e' un modo facile e un modo difficile:

Il modo facile e' di far lavorare il servizio con un utente riconosciuto dal CRM andando quindi a cambiare le credenziali del servizio dal pannello amministrativo dei servizi.

Il modo piu' complesso e' di inserire nel token di autenticazione il n ome dell'utente con cui il router si connette alla distribuzione del CRM (si tratta dell'utente utilizzato nello strumento di configurazione del router stesso), modificando la configurazione ADFS (attraverso l'apposito strumento) come riportato nella figura.

Praticamente bisogna ricercare l'endpoint di nome /adfs/services/trust/13/username e abilitarlo (tasto destro abilita). A questo punto si riavvia il servizio ADFS 2.0 e il gioco e' fatto!

... riconfigurazioni complete multiple degli adapter del CRM.

Per far vedere le modifiche alla struttura dati del CRM al connettore bisogna far girare ogni volta il rispettivo configuratore dall'interfaccia del connettore.

Ma solo la prima volta bisogna effettuare la configurazione completa, altrimenti si incorre nel problema.

Per risolverlo utilizzare la seguente procedura:

Salvare i mapping che coinvolgono le entita' duplicate

Eliminare dalla cartella degli object provider della company CRM interessata dal problema nel path di installazione del connettore, gli object provider delle entita' duplicate

Lanciare il configuratore del CRM dall'interfaccia del CRM facendo attenzione di flaggare "skyp the complete configuration..."

Ripristinare i mapping.

BUON LAVORO!!!

... agire sul DB del connettore.

Si tratta infatti di un baco del connettore:
a volte non vengono correttamente registrati gli object provider, specie se si usano pagine custom, nel DB "MSDI" del connettore.
Per uscire da questa situazione basta aprire la tabella "dbo.Maps" ed eliminare i record che hanno valori nulli. In una situazione funzionante l'unico campo che puo' contenere valori nulli e' "Settings": gli altri dovrebbero essere tutti valorizzati.
Se qualche altro campo risulta essere null, eliminare il record di cui esso fa parte.

Automagicamente tutto ricomincia a funzionare!

...ma bisogna stare molto attenti alle sue limitazioni e decidere se utilizzarlo di conseguenza

Una delle limitazioni che trovo personalmente piu' frustante e' l'impossibililita' di filtrare sui campi delle entita' "madri" rispetto ad una relazione.

L'esempio piu' eclatante e' quando si vuole filtrare per il campo Name di una lookup (es. ragione sociale del cliente di una fattura partendo dalla fattura). Il REST permette solo di filtare sulla prorieta' ID della EntityReference e quindi sul GUID.

Se si prova ad impostare il filtro su un altro campo del record padre (ad esempio il Name) si ottiene un errore del tipo:
Reference to property Name on complex type EntityReference is not supported

Quindi resta da dire ancora una cosa:
Speriamo nelle rollup!

.... i campi inseriti nella regola non sono esposti.

Un esempio lampante sono le regole che riguardano lo stato del record su un form. Se i campi dello stato non sono esposti nel form i pulsanti relativi non si vedono, come se non ci fossero.

In realta' c'e' un javascript che va a verificare la regola, ma non trovando l'attributo va in errore, allora il motore di render "elimina" il pulsante.

Quindi basta pubblicare nel form i campi relativi alle regole!!!!