:: Alfresco. Añadir nuevas vistas a la biblioteca de documentos

A la hora de mostrar las entradas de la biblioteca de documentos disponemos de varias vistas (sencilla, detallada, galería,...) pero es posible añadir otras vistas adicionales.


Por ejemplo, en el caso de que necesitásemos añadir la "Vista de efectividad" podemos consultar el fichero siguiente: "$ALF_HOME/tomcat/webapps/share/WEB-INF/classes/alfresco/share-documentlibrary-config.xml" donde viene como ejemplo.

Copiaremos el siguiente código al fichero: "$ALF_HOME/tomcat/shared/classes/alfresco/web-extension/share-config-custom.xml":

< view-renderer iconclass="table" id="effectivity" index="90" label="button.view.effectivity" widget="Alfresco.DocumentListTableViewRenderer" >
< dependencies >
< js src="components/documentlibrary/documentlist-view-detailed.js" >< /js>
< js src="components/documentlibrary/documentlist-view-table.js" >< /js>
< css src="components/documentlibrary/documentlist-view-table.css" >< /css>
< /dependencies >
< json-config >
{
"actions": {
"show": "true"
},
"indicators": {
"show": "true"
},
"selector": {
"show": "true"
},
"thumbnail": {
"show": "true"
},
"propertyColumns": [
{
"property": "name",
"label": "table.effectivity.label.name",
"width": "300"
},
{
"property": "cm:description",
"label": "table.effectivity.label.description"
},
{
"property": "version",
"label": "table.effectivity.label.version",
"width": "50"
},
{
"property": "cm:modified",
"label": "table.effectivity.label.modified",
"width": "100"
},
{
"property": "cm:modifier",
"label": "table.effectivity.label.modifier",
"width": "100"
},
{
"property": "cm:from",
"label": "table.effectivity.label.from",
"width": "100"
},
{
"property": "cm:to",
"label": "table.effectivity.label.to",
"width": "100"
}
]
}
< /json-config >
< /view-renderer >

El codigo anterior debemos envolverlo entre las siguientes etiquetas:
< config condition="DocumentLibraryViews" evaluator="string-compare" >
< view-renderers >
..........
..........
< /view-renderers >
< /config >


A continuación accederemos a la siguiente url para que los cambios se hagan efectivos: http://localhost:8383/share/service/index y pulsaremos sobre el botón "Refresh webscripts".

En caso de que no veamos la nueva vista en nuestro Alfresco, podemos reiniciar el servicio.

:: MySQL. Habilitar el log

Por defecto el log de MySQL se encuentra des-habilitado.
En ocasiones necesitamos habilitarlo por diversos motivos, por ejemplo para realizar tareas de depuración, pero ¿cómo lo hacemos?

Para llevar a cabo esta tarea debemos seguir los pasos siguientes:

.- Ejecutamos la siguiente consulta para determinar los valores que tiene establecidos el log de MySQL

show variables like 'general_log%';

.- Establecemos el log a "ON" con la siguiente consulta
set global general_log=1;

En el caso de que necesitemos consultar el log, este se encuentra en la ruta devuelta por la primera consulta ejecutada. Será del tipo:
C:\xampp\mysql\data\nombre_del_equipo.log

:: Oracle. Cómo saber el conjunto de caracteres configurado

Aunque se trata este de un "tip"sencillo, en alguna ocasión hemos necesitado comprobar o asegurarnos del código de caracteres configurado en la base de datos Oracle con la que trabajamos.
Este valor configurado en la base de datos determina el conjunto de caracteres que puede almacenarse en ella.

La información sobre este conjunto de caracteres se almacena en la tabla de diccionario de datos denominada: "SYS.PROPS$".

De esta forma, para comprobar una serie de parámetros de nuestra base de datos, podríamos ejecutar la siguiente consulta:

SELECT * FROM NLS_DATABASE_PARAMETERS;

El valor devuelto, podría ser algo similar a lo siguiente:

:: Alfresco. Descriptor de un dashlet (Tip)

El descriptor de un webscript correspondiente a un dashlet es como cualquier otro descriptor, excepto por el parámetro: "familia".

< webscript > < shortname>Hola mundo Dashlet< /shortname > < description>Saludo al usuario< /description > < family>user-dashlet< /family > < url >/components/dashlets/holamundodashlet< /url >

Este parámetro puede ser de los tres tipos siguientes:

• user-dashlet: Es un webscript que implementa un dashlet que puede ser añadido en el panel del usuario
• site-dashlet: Es un webscript que implementa un dashlet que puede ser añadido al panel del sitio
• dashlet: Es un webscript que implementa un dashlet que puede ser añadido en cualquier panel

:: Alfresco. User dashlet

En una entrada anterior -y a modo de prueba de concepto- habíamos explicado brevemente cómo desarrollar un dashlet webscript sencillo, que mostraba un mensaje.
Respecto a la entrada anterior, únicamente modificaremos una línea "user-dashlet" en lugar de "site-dashlet".

¿Cómo realizar un dashlet sencillo (webscript dashlet)?
1.- Crearemos un fichero denominado "holamundodashlet.get.desc.xml" con el siguiente contenido

<webscript>
    <shortname>Dashlet de ejemplo</shortname>
    <description>Dashlet de ejemplo que muestra un literal</description>
    <family>user-dashlet</family>
      <url>/components/dashlets/holamundodashlet</url>
</webscript>

2.- Crearemos un fichero denominado "holamundodashlet.get.html.ftl" con el siguiente contenido

<div class="dashlet">
<div class="title" >Dashlet de ejemplo</div>
<div class="body" >Mensaje mostrado en el dashlet</div>
</div>

3.- Estos ficheros los copiamos en la ruta "tomcat/shared/classes/alfresco/web-extension/site-webscripts/org/alfresco/components/dashlets"

4.- Reiniciamos el servicio y si no existen errores tendremos a nuestra disposición un nuevo dashlet

Para comprobar el correcto funcionamiento, y puesto que se trata de un "dashlet de usuario", accederemos al panel de inicio y en la rueda dentada que aparece en la parte superior derecha seleccionaremos la opción "Personalizar el panel de inicio".

Pulsaremos sobre el botón: "Añadir dashlets" y seleccionaremos el que hemos desarrollado, y pulsaremos sobre el botón: "Aceptar".

:: Velocity. Notación de referencias silenciosa

Cuando Velocity encuentra una referencia indefinida, el comportamiento por defecto es el de escribir el nombre de la referencia. Por ejemplo:.

<input name="correo" type="text" value="$correo"/>

Cuando el formulario se carga por primera vez la referencia $correo no tiene valor. En este caso quizás preferiríamos que se mostrase un texto en blanco en lugar del literal: "$correo". Usando la notación de referencias silenciosa, se obviará el comportamiento normal de Velocity.

De esta manera, en lugar de utilizar $correo en la plantilla Velocity, utilizaríamos $!correo. Con esta modificación el ejemplo anterior quedaría así:

<input name="correo" type="text" value="$!correo"/>

Ahora cuando el formulario se carga por primera vez y $correo no tenga valor una cadena vacía se escribirá en lugar de "$correo".

Igualmente, la notación formal y la silenciosa pueden ser utilizadas conjuntamente:

<input name="correo" type="text" value="$!{correo}"/>

:: Liferay. Tipos de página

A la hora de crear páginas en Liferay, las alternativas que este CMS (gestor de contenidos) pone a nuestra disposición son las siguientes:


• Página en blanco: como su propio nombre indica, se muestra una página sin contenido en la que es posible insertar -de forma manual- los componentes (portlets) que se necesiten. Al seleccionar esta opción, escogeremos una disposición de página de entre las disponibles.
Una disposición de página determina cómo se ordenarán los portlets que insertemos en la página, como por ejemplo en una sola columna, a dos columnas (50-50, 30-70,70-30), etcétera.

• Panel: una página que permite mostrar cualquier número de portlets en ella, pero únicamente uno a la vez. El usuario seleccionará el portlet a mostrar a través de un menú. El portlet seleccionado ocupará la página entera.

• Web insertada: muestra contenido de otra página web dentro de nuestro portal. Un administrador puede establecer una URL desde el menú de configuración de páginas, mostrándose esta en el contexto de nuestro portal.

• Enlace a URL: una página que simplemente redirecciona a la URL configurada, ya sea una url de nuestro portal o un enlace a una web externa.

• Enlace a página de este sitio: permite seleccionar una página dentro de nuestro sitio a la que la página creada redireccionará al usuario. Puede ser útil, por ejemplo, para ubicar una página que se encuentra en un nivel de profundidad mayor en el menú de navegación del sitio de forma que esté más visible, creando una página que la enlace a un nivel más superior de la estructura.

En cualquier caso, en Liferay es posible crear tipos de página personalizados de acuerdo a necesidades concretas.