Stefano Beretta Microsoft Dynamics CRM Blog - Crm Sviluppo lato client

Attenzione al ForceSubmit!!!

Stefano Beretta — Mon, 12 Jul 2010 16:12:09 GMT

...a volte puo' provocare disastri.

Quando la si usa bisogna avere in mente quello che essa fa: forza la platform del CRM a salvare il record corrente passando nel post del form http il valore del campo.

Se pero', ad esempio, il record e' in uno stato di disattivazione, cio' manda in errore la platform perche' l'oggetto non poteva essere aggiornato.

Quindi quando si setta questa proprieta' a true bisogna anche verificare lo stato del record!!!

Torniamo sulle lookup

Stefano Beretta — Sun, 11 Jul 2010 15:28:00 GMT

...ho deciso di rimettere un vecchio psot che spiega come gestire le lookup che come comportamento predefinito offrono la possibilita' di spaziare su piu' entita'.

In realta' l'oggetto javascript usato dalle lookup offre la proprieta' lookuptype che punta all'object type code delle entita' da visualizzare.

Se allora per esempio si desidera che una lookup di tipo customer (di solito permette di selezionare account e contatti) visualizzi solo gli account bast scrivere:
crmForm.all.customerid.setAttribute("lookuptypes", "1");
perche' l'object type code degli account e' appunto 1.

Gestire i pulsanti delle griglie dal form dell'entita' madre

Stefano Beretta — Sun, 25 Apr 2010 21:21:57 GMT

...javascript per risolvere il problema.

Queste funzioni prima nascondono alcuni pulsanti e poi ne rinominano altri. Il tutto tramite array di nomi e di titoli passati come parametri

Modificare i filtri predefiniti delle viste di sistema

Stefano Beretta — Fri, 26 Feb 2010 09:14:53 GMT

...bisogna modificare la struttura XML della vista.

Quindi si esporta in XML, l'entita' desiderata, si apre l'XML, si ricerca la vista dqa modificare (ad esempio quick find o advanced find) e si rimuove il filtro (e' scritto in sintassi fetch xml, linguaggio ormai comunemente compreso dagli sviluppatori).

Nulla di piu' facile

Rivalutiamo la voce di menu Crea Link

Stefano Beretta — Fri, 26 Feb 2010 09:02:37 GMT

...tale voce risulta essere essenziale per includere gli url del CRM in altre applicazioni web, oppure in altre zone della stessa interfaccia utente del CRM (i-frame, site map, eccetera).
Molte volte si pena non poco, essendo la UI del CRM fatta a frame, a capire l'url "vero" di una certa pagina che ci serve visualizzare in un iframe o in una pagina custom e quindi si perde una marea di tempo.
Selezionando invece copia link dal menu' si ha gratis l'url desiderato.

Come gia' detto, rivalutiamo quella voce di menu'!

Come lanciare un workflow dal client

Stefano Beretta — Wed, 02 Dec 2009 12:30:08 GMT

...basta conoscere il comando SOAP.
La funzione javascript e' simile a quelle riportate nell'SDK per richiamare i metodi dei servizi web della platform.

ExecuteWorkflow = function(entityId, workflowId)
{
var xml = "" +
"" +
"" +
GenerateAuthenticationHeader() +
" " +
" " +
" " +
" " + entityId +
" " +
" " + workflowId + " " +
" " +
" " +
" " +
" " +
"";

var xmlHttpRequest = new ActiveXObject("Msxml2.XMLHTTP");
xmlHttpRequest.Open("POST", "/mscrmservices/2007/CrmService.asmx", false);
xmlHttpRequest.setRequestHeader("SOAPAction","http://schemas.microsoft.com/crm/2007/WebServices/Execute");
xmlHttpRequest.setRequestHeader("Content-Type", "text/xml; charset=utf-8");
xmlHttpRequest.setRequestHeader("Content-Length", xml.length);
xmlHttpRequest.send(xml);
var resultXml = xmlHttpRequest.responseXML;
return(resultXml.xml);
}
var theWorkflowId = "3FD2DD58-4708-43D7-A21B-F0F90A0AA9F2"; //da cambiare***
ExecuteWorkflow(crmForm.ObjectId, theWorkflowId);

I misteri dell'evento on save

Stefano Beretta — Thu, 19 Nov 2009 17:05:33 GMT

Una proprieta' molto utile quando si lavora con i form del CRM e' event.Mode
Essa si usa per conoscere, all'interno dell'evento onSave, la causa del salvataggio del form.
Nella figura qui sotto sono riportati i valori documentati

None : 0

Save : 1

SaveAndClose : 2

Delete : 3

Load : 4

Deactivate : 5

Reactivate : 6

Email Send : 7

Email Reply : 8

Email Forward : 9

Kb Submit : 10

Kb Reject : 11

Kb Publish : 12

Kb UnPublish : 13

Kb Rate : 14

Lead Unqualify : 15

Lead Qualify : 16

Quote Accept : 17

Quote CreateOrder : 18

Order ProcessOrder : 19

Opportunity AddRelatedOrder : 21

Opportunity AddRelatedQuote : 22

Opportunity AddRelatedInvoice : 23

Quote CreateRevision : 24

Quote CloseQuote : 25

Order CancelOrder : 26

Invoice Close : 27

Quote GetProducts : 28

Quote Activate : 29

Email ReplyAll : 30

Contract Hold : 31

Contract ReleaseHold : 32

Contract Cancel : 33

Contract Renew : 34

Product ConvertToKit : 35

Product ConvertFromKit : 36

ContractDetail Cancel : 37

Contract Invoice : 38

Contract Clone : 39

Incident Cancel : 40

Email Assign : 41

Change SalesStage : 42

SalesOrder GetProducts : 43

InvoiceGetProducts : 44

TemplateMakeOrgAvailable : 45

TemplateMakeOrgUnavailable : 46

Assign : 47

IncidentAssignToUser : 49

OrderLock : 50

OrderUnlock : 51

InvoiceLock : 52

InvoiceUnlock : 53

ConvertResponse : 54

ReportMakeOrgAvailable : 60

ReportMakeOrgUnavailable : 61

WorkflowAddCheckStep : 62

WorkflowUpdateCondition : 63

WorkflowCreateAction : 64

SendInvite : 65

WorkflowAddElseIfStep : 66

WorkflowAddElseStep : 67

WorkflowDeleteStep : 68

Il bello, o il brutto dipende dai punti di vista, e' che quelli non sono tutti i valori restituiti, alcuni dei quali sono molto importanti. Praticamente ogni operazione eseguita dall'utente o dal CRM stesso che provochi un salvataggio del form e' codificata nella proprieta'.

La cosa bella e' quindi che possiamo conoscere lato client anche molte delle operazioni "segrete" eseguite dal CRM che provocano il salvataggio del form. La cosa meno bella e' che non ne esiste un elenco completo e quindi bisogna sperimentare...

Un piccolo esempio: quando si evade un ordine di vendita il CRM salva il form prima di scatenare l'operazione; in questo caso event.Mode vale 56, valore non documentato.

Evitare i messaggi javascript di chiusura

Stefano Beretta — Sat, 01 Aug 2009 08:43:00 GMT

Nel CRM solitamente quando si chiude senza salvare un form la cui proprieta' isDirty e' true si ottiene un messaggio di tipo confirm che chiede sostanzialmente se si e' sicuri.

Cio' e' sicuramente utile nella quasi totalita' dei casi, ma a volte puo' causare scomodita': come togliere questa caratteristica?

Apparantemente non si puo'; nella documentazione (SDK) non e' riportato alcun metodo o chiamata in tal senso.

Guardando pero' al codice Javascript usato dal CRM si scopre una bellissima funzione che fa proprio quello. Basta richiamarla nell'onload del form e il gioco e' fatto:

crmForm.detachCloseAlert();

Ancora IE 8

Stefano Beretta — Mon, 27 Jul 2009 23:15:13 GMT

Ritorno su IE8 perche' vorrei ancora una volta alzare un warning

Ho gia' avuto occasione di dire e di scrivere che alcune caratteristiche anche apprezzate dagli sviluppatori lato client del CRM presenti in IE 7 non sono piu' presenti in IE 8 o funzionano in modo diverso.

Cio' significa che bisogna rivedere TUTTE le personalizzazioni a livello di javascript sul nuovo browser.

Purtroppo in qualche caso si hanno amare sorprese...

E' pur vero che IE 8 consente di porre il proprio motore in modalita' "compatibile con Internet Explorer 7", ma in alcuni casi cio' non risolve il problema: codice javascript che in IE 7 dava luogo a certi risultati, in IE 8 potrebbe andare in errore o, come avviene nella maggior parte dei casi, semplicemnte non funzionare.

Sicuramente IE 8 e' piu' conforme agli standard del W3C, ma questo e' il prezzo da pagare...

Attenzione a IE8

Stefano Beretta — Fri, 24 Jul 2009 06:32:20 GMT

Internet Explorer 8 ha sicuramente portato novita' e un aumento di prestazioni anche nel CRM.

Bisogna pero' fare attenzione perche' ha anche portato dei cambiamenti a livello di javascript non sempre graditi.
Uno di questi cambiamenti e' particolarmente subdolo ed e' mriassunto in una frase: LA PROPRIETA' innerHTML E' DI SOLA LETTURA
Tutti coloro che usano questa proprieta' per, ad esempio, iniettare proprio codice HTML nei form del CRM , ottengono come risuktato il nulla.
Il codice non viene iniettato, ma non si ottiene nemmeno un messaggio di errorre e quindi e' possibile che non ci accorga del problema.

Una possibile soluzione potrebbe essere quella di sostituire un inter nodo del DOM utilizzando le concatenazioni parent/child.
E' sicuramente una prospettiva piu' macchinosa nel senso che per sostituire ad esempio un nome e quindi una stringa di pochi caratteri, bisogna agire su un elemento del dom magari lungp dieci righe, ma almeno funziona.
Ecco un esempio di funzione adatta allo scopo:

function replace_html(el, html) {
if( el ) {
var oldEl = (typeof el === "string" ? document.getElementById(el) : el);
var newEl = document.createElement(oldEl.nodeName);

newEl.id = oldEl.id;
newEl.className = oldEl.className;

newEl.innerHTML = html;
if(oldEl.parentNode)
oldEl.parentNode.replaceChild(newEl, oldEl);
else
oldEl.innerHTML = html;

return newEl;
}
}

GESTIRE I PULSANTI DEL CRM

Stefano Beretta — Tue, 23 Jun 2009 14:58:43 GMT

GESTIRE I PULSANTI DEL CRM

Spesso risulta utile nascondere i pulsanti del CRM nei form e nelle griglie, nonche' i link posti della barra di navigazione verticale di sinistra:

var lis = document.getElementsByTagName('LI');

var i = 0;

< lis.length) {
while (i
if (lis[i].getAttribute('title') == 'View directions to this account.')
{

lis[i].outerHTML='inserire un tag SPAN vuoto in questo punto'
}
i = i + 1;
}