CRM 2011: Editar el Get Starter Pane

29 09 2011

En CRM 2011 disponemos de los Get Starter Pane, paneles que aparecen en la parte superior de las listas principales. Esta nueva funcionalidad aporta mucho más de lo que inicialmente aparenta. Inicialmente uno puede pensar ‘vaya estorbo’, que ganas de perder espacio de pantalla a la lista… Pues bien, quizás cambiéis de opinión cuando veáis las posibilidades de este nuevo componente. Por defecto, el Get Starter Pane nos muestra un menú con ciertas acciones de ayuda pero, la potencia la obtenemos cuando comprobamos que podemos editar este componente.

En concreto, en el SDK encontrareis información sobre el Get Starter Pane (Create Custom Get Started Pane Content). Resumiendo lo que nos dice el SDK es que tenemos las instrucciones en el directorio SDK/Resources/GetSatrtedPaneTemplate.

En este artículo he seguido esas instrucciones para modificar el Get Started Pane de una entidad personalizada (Test) y mostrar una imagen con el texto Hellp World. Como podréis imaginaros si leeis las instrucciones del documento readme.docx del directorio que os comenté anteriormente, las posibilidades que nos abre este componente son infinitas! Este ejemplo simple, puede serviros de introducción. No seguiré al pie de la letra el guión del documento, simplemente os muestro los pasos que he seguido para el ejemplo:

1. Copiar el contenido entero del siguiente directorio en otro directorio (en el ejemplo lo he llamado Test)

SDK/Resources/GetSatrtedPaneTemplate/helpvisor

2. Eliminar todos los archivos que no voy a usar del template. En concreto, tan sólo voy a usar los archivos siguientes:

  • Redir.htm
  • Images/q-logo.png
  • 1033/helpvisortemplate.htm
  • Scripts/helpvisor.js

3. Editar la página helpvisortemplate.htm añadiendo el código que queramos. Obviamente si queremos mantener el formato original de CRM 2011, deberemos mantener los archivos de la carpeta contatns, los estilos… En este ejemplo tan solo mostraremos una imagen por tanto, no hará falta todos esos archivos. En el HTML hago una referencia relativa a una imagen que posteriormente será un webresource por tanto, es importante mantener la ubicación (y la nomenclatura de los webresource)

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "<a href="http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd&quot;>">http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"></a>
<html xmlns="<a href="http://www.w3.org/1999/xhtml&quot;>">http://www.w3.org/1999/xhtml"></a>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Starter Pane sample</title>
</head>
<body>
<div><img src="../Images/q-logo.png" alt="" id="logo" /></div>
</body>
</html>

4. Añadir una imagen al directori0 images (no es que sea necesario pero así mantengo ordenada toda la configuración del nuevo Pane…)

5. Crear los siguientes webresource a partir de los archivos que tenemos en el directorio. Podemos usar la herramienta WebResourceUtility del SDK o bien crearlos manualmente (teniendo mucho cuidado con la nomenclatura de los webresource que creemos)

  • new_samplePane_/redir.htm
  • new_samplePane_/1033/HelpVisorTemplate.htm
  • new_samplePane_/images/q-logo.png
  • new_samplePane_/scripts/HelpVisor.js

6. Exportar el SiteMap en una solución y editar el archivo customizations.xml que incluye. Añadir la entrada siguiente en el área donde queramos mostrar la lista principal de la entidad (con el nuevo Get Started Pane)

<SubArea Id="new_test" Entity="new_test" GetStartedPanePath="$webresource:new_samplePane_/redir.htm?data=HelpVisorTemplate.htm"/>

7. Importar nuevamente la solución con el customizations.xml modificado y publicar las personalizaciones

8. Comprobar que la opción de mostrar los Get Starter Pane en las opciones personales está activa

Tras realizar estos sencillos pasos (que podrían ser todavía más sencillos… esperemos que Microsoft vaya mejorando el método de edición de estos Pane), obtenemos la visualización de la nueva página en el Get Started Pane de la entidad Test.

Obviamente este es un ejemplo extremadamente simple, pero estoy seguro que si hacéis este ejercicio y sobretodo, leéis atentamente el guión del SDK veréis cuantas posibilidades nos brinda este componente.


Acciones

Information

Deja un comentario