Installare Microsoft Dynamics CRM List Component (vs Sharepoint 2010)

Una delle features più importanti, o quanto meno notevole, di MS Dynamics CRM 2011, è la totale integrazione “nativa” con Sharepoint 2010. Già nella V4 di Dynamics CRM possiamo parlare di integrazione con Sharepoint, così come non soltanto limitarci alla V2010 di Sharepoint ma anche alla V2007. Differenze??? Molte. Di che genere??? Riassunte nella tabella successiva:

Sharepoint 2007 Sharepoint 2010
CRM V4 IFrame IFrame
CRM 2011 IFrame List Component

Quando parliamo quindi di integrazione tra CRM e Sharepoint, non facciamo altro che riferirci al contenuto di una Document Library o di una Lista che verrà inclusa probabilmente in un IFrame di un form di una qualsiasi entità in CRM oppure nella “HomePage” di un qualsiasi link attivato da una personalizzazione della SiteMap.

Per ottenere il massimo dall’integrazione tra MS Dynamics CRM 2011 e Sharepoint 2010 ed ottenere la classica “Lista” di Sharepoint integrata in CRM con tutte le relative features proprie dello stesso Sharepoint 2010 è necessario installare MS Dynamics CRM List Component SUL SERVER SHAREPOINT.

Ecco di seguito gli step by step per installare il List Component:

1) Occorre innanzitutto effettuare il download
2) Copiare o spostare il file appena “scaricato” sul Server Sharepoint
3) Doppio click sul file e scegliere quindi una cartella nella quale decomprimere i files (3 in totale)
4) Nel browser (IE) aprire quindi la URL relativa alla Site Collection sulla quale installare il List Component
5) Cliccare quindi su Azioni Sito (in alto a sinistra) e poi dal menu Impostazioni Sito
6) Dalla sezione Raccolte selezionare Soluzioni
7) Cliccare sul tab SOLUZIONI e poi quindi su CARICA SOLUZIONE
8) Uploadare quindi il file precedentemente de-compresso: crmlistcomponent.wsp
9) Cliccare quindi su ATTIVA

Se si sta utilizzando la versione On-Premise di Sharepoint si deve quindi anche aggiungere l’estensione .htc tra i file consentiti:

10) Dalla cartella dove sono stati estratti i files del List Component, copiare il file AllowHtcExtn.ps1 (che è essenzialmente uno script) (suggerimento: creare una directory “temporanea” nella root c:\ – da cancellare una volta “lanciato” il comando)
11) Dalla Windows PowerShell o dalla Sharepoint Management Console eseguire il comando:
AllowHtcExtn.ps1 http://servername
dove http://servername  è  il nome della WEB Application URL

A questo punto è possibile tornare nell’area IMPOSTAZIONI di MS Dynamics CRM 2011 e quindi configurare la GESTIONE DEI DOCUMENTI nella SubArea SISTEMA, aggiungendo un nuovo sito di Sharepoint (Site Collection)

TroubleShooting Email Router in MS Dynamics CRM 4.0


Problema: Cliccando su CARICA DATI nel Configuration Manager dell’Email Router non è possibile collegarsi all’Organizzazione indicata nella Gestione Distribuzioni.

Scenario di Esempio:
3 Server: 1 Microsoft Dynamics CRM Server + Email Router, 1 Domain Controller, 1 SQL Server + Reporting Services.

1)      CRM Server è installato su porta di default dell’installazione (5555), è anche configurato un certificato Self-Signed per la connessione SSL su porta 443.

2)      Sul server “in locale” l’organizzazione di default è accessibile tramite URL
a.       http://servercrm:5555
b.      https://crm.mioserver.com (configurato un DNS Esterno) (facoltativo)

WORKAROUND:

1)      Database MSCRM_Config

Nel DB MSCRM_Config verificare nella tabella DeploymentProperties che siano rispettate le seguenti condizioni:

ColumnName Value
ADRootDomainScheme http
ADSdkRootDomain Servercrm:5555
ADWebApplicationRootDomain Servercrm:5555
AsyncSdkRootDomain (Blank) or servercrm:5555

Nel caso non si avesse accesso “diretto” al SQL Server ma si è amministratori di macchina locale dove è installato il CRM Server allora è possibile utilizzare il MICROSOFT DYNAMICS CONFIGURATION TOOL:

949079 (http://support.microsoft.com/kb/949079/ ) How to use the Microsoft Dynamics CRM Deployment Configuration tool for Microsoft Dynamics CRM 4.0”

Utilizzare poi da riga di comando le seguenti istruzioni:
- microsoft.crm.deploymentconfigtool.exe addresssettings update –sdkrootdomain:servercrm:5555
- microsoft.crm.deploymentconfigtool.exe addresssettings update -webapprootdomain:servercrm:5555

2)      “MICROSOFT CRM EMAIL ROUTER” Service:
Il Servizio dell’email router può essere eseguito con 3 diversi account: LOCAL SYSTEM, NETWORK Service ed un account “dedicato” che viene creato per motivi di sicurezza.
Può essere impostato l’account: LOCAL SYSTEM

3)      “MICROSOFT CRM ASYNCHRONUS PROCESSING”  (Servizio Elaborazione Eventi Asincroni di Microsoft CRM (ITA):
In caso di “Gestione Sicurezza” avanzata per il server SQL è opportuno creare un utente ad-hoc per il servizio in questione.
a.       Creare un utente che sia amministratore della macchina locale (utente di dominio membro del gruppo administrators del server dove è installato l’email Router)
b.      Assicurarsi che lo stesso utente abbia i permessi di dbdatareader e dbdatawriter sul server SQL ed in particolare sia per il database MSCRM_Config, sia per il database dell’organizzazione per la quale si vuole
gestire l’email router

4) L’utente che utilizza la Gestione Configurazione Router di Posta Elettronica per Microsoft Dynamics CRM deve appartenere al gruppo PRIVUSERGROUP creato da CRM durante l’installazione

5) Non è necessario che l’utente sia anche amministratore della distribuzione

6) Registro di Configurazione:

Verificare che in:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSCRM
La chiave ServerURL abbia il valore: http://servercrm:5555/MSCRMServices

In questo modo dovrebbe essere risolto il problema indicato.

CONSIDERAZIONI:
E’ molto utile fare alcune considerazioni di carattere “tecnico” e cioè:
Questi problemi legati all’email router si verificano frequentemente quando si ha a che fare con pubblicazioni IFD o con esposizione dell’organizzazione verso l’esterno (anche non in presenza di pubblicazione IFD). Questo perché probabilmente (come indicato all’inizio di questo articolo), si vuole raggiungere il server CRM con Autenticazione di Windows e magari anche su protocollo https.

a)      L’amministratore del Server CRM (ma anche quello della distribuzione) dovrebbe avere i permessi per accedere al Server SQL e ai database del CRM (Config + singole distribuzioni)

b)      La configurazione dei 2 servizi (Email Router e Asincrono) va fatta sin da un principio CORRETTAMENTE, per non imbattersi in ulteriori “inutili” problemi durante il deployment oppure durante l’utilizzo giornaliero da parte degli utenti

c)       E’ molto importante non sottovalutare il fatto che l’Email Router non si connette all’organizzazione, anche se tutto “sembra” funzionare, come invii e ricezione di posta elettronica sia per gli utenti che per le code. Infatti questo genera una moltitudine di errori nell’Event Viewer perlopiù sconosciuti o in ogni caso non riconducibili alla non corretta configurazione dell’Email Router.

Issue: Clicking on Load Data in the Email Router Configuration Manager receive an error that it’s impossible to connect to the Organization – The Event Viewer gives poor infos.

Example Scenario:
3 Server: 1 Microsoft Dynamics CRM Server + Email Router, 1 Domain Controller, 1 SQL Server + Reporting Services.

1)      CRM Server with default organization installed on default port (5555), it’s also installed ed configured a self-signed Certificate for SSL Connection on port 443.

2)      Locally, on Server, default organization is accesible with following URLs:
a.       http://servercrm:5555
b.      https://crm.myserver.com (External DNS Configured) (optional)

WORKAROUND:

1)      Database MSCRM_Config

In the DataBase MSCRM_Config verify that in the DeploymentProperties table will be following conditions:

ColumnName Value
ADRootDomainScheme http
ADSdkRootDomain Servercrm:5555
ADWebApplicationRootDomain Servercrm:5555
AsyncSdkRootDomain (Blank) or servercrm:5555

In case the user could not access directly SQL Server (for security reasons) but he is an administrator of local machine where is installed CRM Server, it’s possible to use MICROSOFT DYNAMICS CONFIGURATION TOOL:

949079 (http://support.microsoft.com/kb/949079/ ) How to use the Microsoft Dynamics CRM Deployment Configuration tool for Microsoft Dynamics CRM 4.0”

Then, from command line launch following instructions:
- microsoft.crm.deploymentconfigtool.exe addresssettings update –sdkrootdomain:servercrm:5555
- microsoft.crm.deploymentconfigtool.exe addresssettings update -webapprootdomain:servercrm:5555

2)      “MICROSOFT CRM EMAIL ROUTER” Service:
Email Router Service could be executed with 3 different accounts (better 3 types ;-) ): LOCAL SYSTEM, NETWORK Service or a dedicated account, created “ad-hoc” before for security reasoned.
It could be leaved the account LOCAL SYSTEM for this Service.

3)      “MICROSOFT CRM ASYNCHRONUS PROCESSING”:
In case of an adavanced Security Management of all infrastructure (and for SQL Server in particular) it’s useful to create an “ad-hoc” user for this service.
a.  Create a user that will be administrator of local machine (domain user member of Administrators Group on that Machine where is installed the Email Router)
b.  The same user must have DBDATAREADER and DBDATAWRITE Permissions on the SQL Server and in particular for MSCRM_Config and for the Organization’s Database which you would manage the email
configuration/distribution.

4) The user that runs the Email Router Configuration Manager must be a member of PRIVUSERGROUP, created by CRM during the installation (like the Computer that runs the Email Router)

5) Windows System Registry:

Verify that in:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSCRM
The Key ServerURL has the value: http://servercrm:5555/MSCRMServices

In this way the problem could be resolved.

CONSIDERATIONS:
It’s very useful making few “technical” considerations, in the detail:
Different issues connected to the email router configuration happen frequently overall when you are trying to configure IFD or if you would like to expose CRM Website on the Internet (without IFD): sometimes IT managers prefers not to use IFD and leave Windows Authentication also with encryption (SSL & htpps)

a)      The CRM Adminisitrator (but also the administrators of a specified organization) could have permission to access and manage the CRM Databases on SQL Server. (Config + single organizations)

b)      The exact configuration for 2 services (Email Router and Asynchronus) must be done CORRECTLY starting from the “second after” the completed installation of CRM Server :-)

c)       It’s very important also to consider that sometimes the Email Router doesn’t connect to the organization, but at the same time, every “email fact”  are working correctly. It means that users can send and receive emails from CRM Platform, queues are working fine, but if you check in the Event Viewer, you could find a lot of errors that most of times are not related correctly to Email Router Issues.

Update Rollup 13 Released

(ENG)
The SE (Sustained Engineering) Team of Microsoft Dynamics released the v13 of Update Rollup. Update Rollup 13 is cumulative and could be downloaded from the link below:

More informations also on the official blog of the team:

http://blogs.msdn.com/b/crm/archive/2010/09/23/update-rollup-13-for-microsoft-dynamics-crm-4-0.aspx

(ITA)
Il Microsoft Dynamics CRM SE Team ha rilasciato la nuova versione (v13) dell’Update Rollup. Questa release è cumulativa e può essere scaricata dai seguenti link:

Maggiori informazioni sul blog ufficiale del Team Dynamics CRM:

http://blogs.msdn.com/b/crm/archive/2010/09/23/update-rollup-13-for-microsoft-dynamics-crm-4-0.aspx

Iscriviti

Get every new post delivered to your Inbox.