zylk.net

Alfresco Share online edition addon in googlecode

2013-05-18T13:03:35Z

Alfresco Share online edition addon now available for downloading in googlecode.

http://code.google.com/p/alfresco-share-online-edition-addon/

A video demo of the addon (it works with LibreOffice && MS Office).

Como darle uso a tu viejo android

2013-05-13T09:24:29Z

El caso es que conforme a que Android asegura su posición dominante como sistema operativo de dispositivos moviles y tablets, es cada vez más común tener tirado por casa un móvil viejo de recambio que puede ser utilizado para múltiples usos. Y es que con un dispositivo android tenemos un potencial servidor, y si no mirad la aplicación Servers Ultimate en Google Play.

El artículo de hoy se aleja un poco de los posts habituales sobre Liferay, Alfresco, Nuxeo, o Sinadura que tratamos en el blog de zylk, y trata de como utilizar un dispositivo android como un punto de control UPnP/DLNA para el equipo hifi de casa, en mi caso en una habitación diferente a la de mi ordenador personal.

Para ello disponemos de un ordenador de sobremesa con ubuntu que hará de servidor de medios, y en cuyo disco dispongo de mi música en formato digital. Lo primero que necesito es un servidor de DLNA, y en ubuntu tenemos una opción muy sencilla con minidlna o mediatomb, que se pueden instalar y configurar via apt-get o aptitude.

Además es posible que tengas un DLNA server sin saberlo, por ejemplo, en tu router de Vodafone. El caso es que un servidor DLNA, es muy interesante como servidor de medios, puesto que podemos conectar nuestra Smart TV o nuestro reproductor multimedia en red y consumir videos o música desde allí.

Pero en caso de hoy, voy a hablar de como utilizar un programa para Android que permite consumir estos servidores UPnp/DLNA, y que se llama BubbleUPnP. Para utilizarlo necesitamos también un BubbleUPnp Server, un servidor java que se instalara también en el ordenador de sobremesa y que permitirá envolver los diferentes orígenes UPnP que tenemos en la red.

Lo bonito del tema, es que una vez conectado tu móvil viejo android con la aplicación BubbleUPnP, a tu equipo hifi, no sólo vas a poder hacer streaming de audio desde el móvil dedicado, sino que vas a poder programar, ejecutar y renderizar una lista de música desde tu móvil actual o desde una tablet, utilizando las diferentes librerías de los orígenes DLNA configurados

Edito un pequeño esquema:

Crear un accceso directo a Sinadura Desktop en unity

2013-05-10T14:38:09Z

Ya llevo un tiempo intentando usar unity como gestor de ventanas de mi ubuntu 12.04, los problemas de rendimiento y de madurez de unity están ahí... pero creo que en un par de versiones se solucionarán y me acostumbraré a usar unity. Una cosa que me ha resultado interesante es poder añadir al buscador rápido de aplicaciones (tecla windows del teclado) las aplicaciones que se instalan sin ser paquetes de la distribución. Para ello basta con crear el siguiente fichero sinadura.desktop en la siguiente localización /home/gus/.local/share/applications con el siguiente contenido:

[Desktop Entry]
Type=Application
Name=Sinadura-Desktop
Comment=Sign files with smartcard
Icon=/home/gus/sinadura/resources/images/sinadura.ico
Exec=/home/gus/sinadura/bin/sinadura.sh
Terminal=false
Categories=Development;Sign;Office

Adaptando los paths a path de instalación. Una vez creado el fichero ya se puede buscar la aplicación escribiendo sindura en el lanzador de aplicaciones y se puede dejar fijo en el lanzador rápido. También.

Una imagen de como queda la cosa ....

Digital signature actions for Alfresco Share

2013-05-06T15:31:22Z

I post here two demo videos of the digital signature components for Alfresco Share.

Digital signature action in Alfresco ECM via applet

Validate digital signatures in Alfresco ECM

More information in alfresco form.

Related links:

Sinadura ECM demo videos

2013-04-29T16:09:46Z

Here there are some demo videos of sinadura ECM, our digital signature client for Alfresco ECM. Sinadura ECM is a java desktop application that provides a simple integration (browse Alfresco repository, download files from Alfresco repository, multiple upload to Alfresco repository, update and search PDFs...) with Alfresco ECM.

Sinadura ECM download, sign and update in Alfresco

Sinadura ECM multiple sign and upload in Alfresco

Configuring Sinadura ECM connector for Alfresco:

Sinadura ECM search, view properties, download, sign and update in Alfresco :

Do not hesitate to contact us via the following form

More information (screenshots and videos):

http://addons.alfresco.com/addons/sinadura-pdf-digital-signature-client-alfresco-ecm

Dashboards para cianoplan basados en pentaho BI server

2013-03-25T11:02:45Z

Durante el mes de febrero un equipo mixto de Zylk.net. y la empresa Cianoplan ha estado desarrollando/implantando una solución BI basada en el proyecto Pentaho.
El equipo estaba compuesto por Pablo Perez y Esther Barriocanal de Cianoplan, y por Gustavo Fernández e Irune Prado de Zylk.net.

El objetivo del proyecto era instalar la herramienta y dotar al equipo de Cianoplan de la autonomía suficiente para poder crear reports y modificar los desarrollos realizados.
En este caso el proyecto se orienta en crear unos dashboards a modo de cuadro de mando, para representar visualmente las ventas por diferentes dimensiones, así como unos reports y un cubo olap con la herramienta siguiente.

Para comenzar con todo esto, se desarrolló un proceso de transformación de datos o ETL (extract, transform, load) como base para obtener la información necesaria para los demás componentes.

Como en todos los proyectos de BI lo que se hizo fue:

Analizar los indicadores que se querían obtener.
Analizar los distintos orígenes de datos necesarios para poder realizar las mediadas.
Diseñar e implementar el proceso de carga y transformación de datos.
Diseñar e implementar el cubo OLAP.
Diseñar e implementar los dashboards.
Diseñar e implementar unos reports de ejemplo.
Formar a los usuarios.

Las dos primeras partes, fueron en su mayoría trabajo de Cianoplan, ya que los conocedores del negocio y de los datos era, como en todos los proyectos de BI, ellos.

Una vez analizados los indicadores se procedió a la creación del proceso de ETL, consistiendo en la extracción de las información del ERP y el volcado de los mismos a la base de datos de conocimiento. Todo esto, mediante la herramienta 'data-integration' de la suite Pentaho.

El proceso además tenía cierto problema relacionado con el origen de datos y la arquitectura que se quería montar. La base de datos del ERP está en una intranet y las base de datos de conocimientos en otro zona de red comunicada por internet.

Una vez creada la base de datos de conocimiento se procedió al diseño del cubo OLAP.

Después se diseñó el dashboard, agrupando diferentes necesidades (estudio promocional, objetos a analizar, desgloses, navegables, ...)

Como podemos ver en el detalle el dashboard contiene los siguientes ejes de catalogación

Tipo de análisis: General o Promocional
Importe de ventas por: Cliente, TPVs y Grupos de cliente
Posibilidad de análisis por un único cliente, TPV o grupo con un selector AJAX

Además, se permiten visualizar los datos con una comparativa por años, meses o cuartos, y se realizan varias navegaciones, entre la que se destaca la navegación por familias / subfamilias / artículos.

Para finalizar se crearon varios reports y se formó al equipo de Cianoplan para que pudiera crearlos de manera autónoma.

En este ejemplo, el report se filtra por actividad, mediante un selector múltiple.

Optimizaciones SEO para liferay portal

2013-05-07T10:11:28Z

Llevamos una par de semanas trabajando con un cliente (http://www.visuresolutions.com) para optimizar su web actual en base a las indicaciones de un experto SEO (Daniel Pinillos, http://www.danielpinillos.com/ y http://www.seovision.es/). La web del cliente está basada en liferay 5.2.3 CE y necesita ciertas mejoras en el ámbito del posicionamiento web que no proporciona el gestor de portales liferay para esa versión. El experto en SEO nos indicó que sería interesante conseguir las siguientes tres cosas en la web:

* Poder tener dominios separados para identificar país
* Poder tener dominios separados para identificar país e idioma
* Poder tener urls distintas por cada idioma

Desde el punto de vista del liferay 5.2.3, poco ofrece el gestor de portales para afrontar estas necesidades. Pongamos un ejemplo. Imaginemos que tenemos la siguiente url http://www.dominio.com/products/mesa-boogie y nuestra empresa quiere abrir el mercado alemán y el latino empezando por Méjico. Desde un punto de vista SEO para la salida de las nuevas webs en los dos paises objetivo se necesitaría las siguientes urls http://www.dominio.mx/productos/mesa-boogie y http://www.dominio.de/produckte/mesa-boogie.

Desde el punto de vista de liferay lo que se nos plantea son varios problemas que dependiendo de la versión de liferay se pueden afrontar de una u otra manera. Si el portal se fuera a crear desde cero y se partiera de una versión 6.x lo ideal sería:

a) crear los contenidos en el scope global
b) crear dos sitios web y crear las estructura de páginas distinta para site con los contenidos del scope global

Con esta estructura podríamos tener las urls requeridas pero tiene varios problemas

1) Hay que hacer una administración doble de las estructuras de los sites para poder mantener distintos dominios y urls distintas
2) El sistema de cambio de idioma de liferay implica una cookie y una redirección por lo que para los indexadores tipo google no es algo especialmente amigable (esto en liferay 6.x se puede cambiar y que las urls tenga /en /es /de en el path. No es la solución ideal pero se podría usar aunque no se puede asociar un idioma por defecto a un site
3) Al tener sitios separados los metas de lenguajes alternativos y urls canonicas no tienen sentido y no se pueden aplicar de manera automática en los tres sites

La parte positiva de esta orientación es que no requiere cambios en el producto y se puede implantar y gestionar desde la interfaz web del liferay.

El caso es que con estos problemas señalados y sobre todo teniendo en cuenta que la versión de liferay existente es la 5.2.3 hemos pensado que un upgrade a la 6 no soluciona los problemas de SEO al 100% y por eso hemos pensado una alternativa que implica modificar el producto en tres aspectos

a) Permitir tener varios virtual hosts asociados a un site (en 5.x comunidades u organizaciones)
b) Permitir que cada virtual host tenga un idioma asociado
c) Permitir que la url de una página pueda traducirse
d) Permitir que las urls de distintos idiomas no requieran cookies y redirecciones para fijar el idioma

A lo largo de los siguientes artículos iremos explicando los cambios realizados para conseguir el objetivo marcado. De momento hemos realizado las pruebas de concepto para conseguir las tres urls siguientes que cumplen con lo especificado:

http://test.visuresolutions.es/empresa
http://test.visuresolutions.us/company
http://test.visuresolutions.de/gesellschaft

Es decir representan la misma página (descripción de la empresa cliente) en tres idiomas distintos asociado cada idioma a un dominio (en este caso subdominio).

Login por email en Alfresco Share

2013-03-18T08:58:18Z

Recientemente, en el contexto de un proyecto, nos han solicitado la posibilidad de autenticarse en Alfresco a través del mail de usuario, y no del username, para un directorio de usuarios openLDAP. En este directorio de usuarios, se centralizarian los usuarios externos a la organización, mientras que los usuarios internos estarían gestionados en un directorio de usuarios (Directorio Activo) independiente.

La solución técnica de la autenticación requiere de dos pequeños desarrollos:

Por un lado, debemos/podemos modificar el subsistema de autenticación de usuarios por defecto de Alfresco para openLDAP de manera que desde java podamos hacer una búsqueda en el openLDAP por mail, identificar el usuario y enviar correctamente sus credenciales (este tipo de modificaciones ya las hemos hecho aquí en otras ocasiones, con motivo del conector de CIFS para openLDAP). Por supuesto este mail debe ser único en el directorio de usuarios externo.
Además de esto, es necesario controlar las variables de sesión de Share.

Este sistema permite hacer login tanto con el mail como con el nombre de usuario del openLDAP. Y una vez logueado con el email, el usuario visualizará la interfaz como si lo hubiese realizado con el usuario de LDAP.

Por otro lado, hemos realizado una serie de modificaciones en las búsquedas de usuarios de Alfresco Share para adaptarlo a estos usuarios con mail como login:

En primer lugar, el buscador de personas tiene que ser capaz de buscar por mail.
La búsqueda de miembros de un sitio también se ha extendido para poder buscar por mail.
Las invitaciones de usuarios son ahora también buscables por mail.

El buscador de personas de Alfresco Share podría hacer búsquedas como esta:

Y en proceso de invitación de personas en SItios podríamos buscar también por email:

Por último, para gestionar invitaciones a los sitios de los usuarios externos (openLDAP), hemos desarrollado un pequeño módulo que permite agregarles desde Alfresco, creando el usuario en openLDAP si es necesario. Este módulo es similar al que proporciona Alfresco pero, utilizando un opeLDAP externo por un lado, y pudiendo asignar un rol definido, como en el caso de un usuario interno de Alfresco.

Debug remoto de una instancia de liferay

2013-03-14T11:36:32Z

Normalmente los desarrolladores están acostumbrados a hacer debug en sus máquinas locales desde el eclipse lo cual es una buena práctica, pero suele requerir arrancar las aplicaciones desde el propio eclipse y que efecftivamente el servidor esté en la máquina local. Existe otra posibilidad para hacer depuración en aplicaciones java que consiste en conectarse a un puerto remoto desde el eclipse. Para ello basta con seguir tres pasos muy simples.

1) Activar el debug en el servidor remoto

-Xdebug -Xrunjdwp:transport=dt_socket,address=0.0.0.0:5050,server=y,suspend=n

2) Configurar el eclipse desde el panel Run -> Run configurations

3) Comenzar el debug de la aplicación.

En nuestro caso lo hemos aplicado al debug de una instancia de liferay que se estaba comportando de manera un poco extraña y no sabíamos determinar la causa.

Para la configuración seguimos este post que aporta información más detallada de como realizar la configuración.

Los sistemas de cuota en Alfresco ECM

2013-03-11T11:35:20Z

Hoy vamos a hablar de las capacidades de cuota en Alfresco ECM. Es posible definir una cuota de datos para un usuario por defecto en el repositorio, que es una opción que aparece en el formulario de creación de usuarios de Alfresco (ya sea Share o Explorer) desde hace ya muchas versiones.

También es posible definir una cuota máxima para el tamaño máximo de un archivo. Normalmente cuando tenemos un sistema de albergue de archivos en una aplicación web, suele haber limitaciones en el tamaño de esa subida, en cada una de las capas. Por ejemplo, el servidor apache o el contenedor de servlets Tomcat limitan la súbida máxima a través de un POST, y se ha de modificar en numerosas ocasiones, para permitir tamaños de archivo grandes. En el mundo java, además puede haber problemas de memoria heap al subir archivos muy grandes (> 100Mb por ejemplo) en algunos sistemas que no estén bien parametrizados.

Alfresco, por defecto en la versión 4 no presenta una cuota por archivo definida en su repositorio, es decir, que si hay alguna limitación será más bien una limitación de sus capas intermedias (proxys) o bien de los propios uploaders (flash o HTML5). Sin embargo, existen situaciones en donde se requiere gestionar un umbral de subida o creación de datos, por una política dada de crecimiento de un repositorio, backups etc etc. De este modo, podemos evitar que un usuario no pueda subir una película en alta definición, las isos de su distribución de linux preferida o incluso máquinas virtuales completas con la variable (en bytes):

system.content.maximumFileSizeLimit=20971520

que podeís encontrar buceando en el archivo repository.properties de Alfresco.

También existen otras problemáticas de repositorio que exigen imponer cuotas en un espacio o carpeta de documentos, o incluso en un sitio de Alfresco Share. Esta es una funcionalidad que no se encuentra por defecto en Alfresco, pero que ha sido implementada en este proyecto abanderado por la comunidad:

que permite definir los comportamientos y constraints para el repositorio que permitar limitar los datos por debajo de un espacio de Alfresco. Basándonos en este módulo, es posible cambiar la interfaz de creación de Sites para un usuario Administrador de Alfresco, que permita redefinir una cuota de Sitio definida previamente.

Una de las bondades de este módulo es que calcula los tamaños de cada folder sujeto a cuota de modo que podemos tener informes de uso de cada uno de los sites / folder con un poco de javascript API.

grafico de dependencias de sinadura desktop

2013-03-10T14:21:17Z

La semana pasada estuvimos reorganizando el proyecto de sinadura-desktop para automatizar la publicación de la versiones, tanto en el repo de maven como en el repo de svn. Como consecuencia de esta reorganización hemos modificado mínimamente los poms de todos los proyectos y las dependencias entre ellos. Todo esto para poder trabajar con el trunk de cada proyecto y que en la carpeta de tags estuvieran las versiones estables correspondientes. Todo automatizado con el jenkis y con el siguiente plugin de maven

Los proyectos que manejamos en sinadura-desktop son los siguientes

Módulo de interfaces - EE (interfaces a implementar con las funcionalidades Entreprise)
Módulo de implementación - EE (implementación de los módulos Entreprise)

Módulo TSA
Módulo OCSP
Módulo XADES

Módulo xmlsec

Modulo de core
Módulo de Escritorio

Módulo de VFS

A continuación dejo un gráfico de las relaciones entre ellos para la versión 3.3.4 del programa.

Espero que si alguien tiene que desarrollar algo con este programa el gráfico de dependencias pueda ayudarle a entender como y donde hacer cada modificación.

En la wiki del proyecto existe un manual para desarrolladore (http://www.sinadura.net/es/wik/-/wiki/sinadura/DevManual300) donde se explica como montar el entorno de desarrollo.

Alfresco Share 4 y Single Sign On con CAS

2013-03-03T18:35:48Z

Os dejo aquí unas notas sobre como casificar Alfresco Share, para la version 4.x de Alfresco. Por defecto, Alfresco Share no es una aplicación que esta casificada y que necesita algunos cambios "out of the box" para que se autentique contra un servidor centralizado de autenticación CAS.

La arquitectura planteada en este artículo sería algo así:

En el repositorio, debemos definir una cadena de autenticación externa en el alfresco-global.properties

authentication.chain=external1:external,alfrescoNtlm1:alfrescoNtlm
# IMPORTANTE! Sin esta propiedad Alfresco Share no se autenticará correctamente
external.authentication.proxyUserName=

Estamos en la aproximación de que Alfresco Share y Alfresco Repository conforman dos capas (máquinas) separadas.

En Alfresco Share, debemos añadir en primer lugar las algunas librerías en $TOMCAT_HOME/webapps/share/WEB-INF/lib

cas-client-core-3.1.12.jar
opensaml-1.0.1.jar
zk-cas-filter.jar

Además es necesario modificar el web.xml de share.war para configurar los filtros de CAS, así como compilar un filtro a medida (zk-cas-filter.jar). El código java se puede obtener de este wiki, que es de donde he partido para la integración de Alfresco Share y CAS:

http://ifaq.wikispaces.com/CAS+-+CASificando+Alfresco+Share

Los filtros en el web.xml son:

   <filter>
   <filter-name>Authentication Filter</filter-name>
   <filter-class>org.jasig.cas.client.authentication.AuthenticationFilter</filter-class>
   <init-param>
   <param-name>casServerLoginUrl</param-name>
   <param-value>https://services.zylk.net/cas</param-value>
   </init-param>
   <init-param>
   <param-name>serverName</param-name>
   <param-value>https://share.zylk.net</param-value>
   </init-param>
   </filter>

   <filter>
   <filter-name>Ticket Validation Filter</filter-name>
   <filter-class>org.jasig.cas.client.validation.Cas20ProxyReceivingTicketValidationFilter</filter-class>
   <init-param>
   <param-name>casServerUrlPrefix</param-name>
   <param-value>https://services.zylk.net</param-value>
   </init-param>
   <init-param>
   <param-name>serverName</param-name>
   <param-value>https://share.zylk.net</param-value>
   </init-param>
   </filter>

   <filter>
   <filter-name>Alfresco Share Filter</filter-name>
   <filter-class>net.zylk.alfresco.cas.filter.AlfrescoShareFilter</filter-class>
   </filter>

   <filter-mapping>
   <filter-name>Authentication Filter</filter-name>
   <url-pattern>/page/*</url-pattern>
   </filter-mapping>
   <filter-mapping>
   <filter-name>Authentication Filter</filter-name>
   <url-pattern>/p/*</url-pattern>
   </filter-mapping>
   <filter-mapping>
   <filter-name>Authentication Filter</filter-name>
   <url-pattern>/proxy/*</url-pattern>
   </filter-mapping>

   <filter-mapping>
   <filter-name>Ticket Validation Filter</filter-name>
   <url-pattern>/page/*</url-pattern>
   </filter-mapping>
   <filter-mapping>
   <filter-name>Ticket Validation Filter</filter-name>
   <url-pattern>/p/*</url-pattern>
   </filter-mapping>
   <filter-mapping>
   <filter-name>Ticket Validation Filter</filter-name>
   <url-pattern>/proxy/*</url-pattern>
   </filter-mapping>

   <filter-mapping>
   <filter-name>Alfresco Share Filter</filter-name>
   <url-pattern>/page/*</url-pattern>
   </filter-mapping>
   <filter-mapping>
   <filter-name>Alfresco Share Filter</filter-name>
   <url-pattern>/p/*</url-pattern>
   </filter-mapping>
   <filter-mapping>
   <filter-name>Alfresco Share Filter</filter-name>
   <url-pattern>/proxy/*</url-pattern>
   </filter-mapping>

Notad que las propiedades principales definidas en el web.xml atienden a la url del servicio de autenticación centralizado (CAS) por un lado, y por otro a la redirección que hará este junto con el ticket de autenticación, al servidor donde está desplegado Alfresco Share.

Por último, en el archivo de configuración principal de Alfresco Share share-config-custom.xml definimos la sección remote y el endpoint del repositorio, es decir la url del repositorio de Alfresco, poniendo a true el parámetro external auth.

   <config evaluator="string-compare" condition="Remote">
   <remote>
   <keystore>
   <path>alfresco/web-extension/alfresco-system.p12</path>
   <type>pkcs12</type>
   <password>alfresco-system</password>
   </keystore>

   <connector>
   <id>alfrescoCookie</id>
   <name>Alfresco Connector</name>
   <description>Connects to an Alfresco instance using cookie-based authentication</description>
   <class>org.springframework.extensions.webscripts.connector.AlfrescoConnector</class>
   </connector>

   <endpoint>
   <id>alfresco</id>
   <name>Alfresco - user access</name>
   <description>Access to Alfresco Repository WebScripts that require user authentication</description>
   <connector-id>alfrescoCookie</connector-id>
   <endpoint-url>http://alf.zylk.net:8080/alfresco/wcs</endpoint-url>
   <identity>user</identity>
   <external-auth>true</external-auth>
   </endpoint>
   </remote>
   </config>

En el ejemplo de arriba no se ha securizado nada más que la capa web de acceso a través del frontal Apache.

Enlaces útiles:

Snippets for CMIS content viewer portlet, a Liferay plugin to query and render CMIS objects from an Alfresco CMIS repository

2013-03-01T10:23:10Z

Siguiendo con el artíclo que escribió cesar sobre el visualizador de contenidos CMIS usando groovy vamos a exponer dos ejemplos de uso que nos han parecido interesantes.

El primero consiste en mostrar un listado de todos los pdfs de una carpeta del gestor documental. Una lista con su nombre descripción y un enlace para la descarga.

Lo primero que habría que definir es la query CMIS que se va a utlizar

SELECT * FROM cmis:document WHERE cmis:contentStreamMimeType LIKE 'application/pdf'

y lo segundo el script de groovy que se va a encargar de la presentación de los objetos devueltos por la query CMIS

html.append("<table style=\"width: 640px;\">");
html.append("<tr>");
      html.append("<th style=\"width:5%;\"></th>");
      html.append("<th style=\"width:25%;\">Nombre</th>");
      html.append("<th style=\"width:20%;\">Creado por</th>");
      html.append("<th style=\"width:20%;\">Modificado por</th>");
html.append("</tr>");

for (CMISObject doc : listaObjetos) {
   html.append("<tr>");
    html.append("<td><img alt=\"PDF\" src=\"/html/themes/_unstyled/images/file_system/small/pdf.png\" ></td>");
    html.append("<td><a href=\"#\">" + doc.getName() + "</a></td>");
   html.append("<td>" + doc.getCreatedBy() + "</td>");
    html.append("<td>" + doc.getLastModifiedBy() + "</td>");
    //html.append("<td>" + doc.getType().getDescription() + "</td>");
    html.append("</tr>");
};

html.append("</table>");

El segundo ejemplo consiste en lista un conjunto de contenidos custom, es decir en el gestor de contenidos se define un modelo documental por ejemplo una noticia, que tiene una serie de propiedades personalizadas. La idea es presentar una lista de esas noticias mostrando los datos personalizados. Además en se va a usar el sistema variables para las querys de CMIS para ver como un dato de la sesión de liferay se puede usar para filtrar (en tiempo de ejecución) los datos que visualiza el usuario en el portal. En este caso solo se van a mostrar las noticias que el mismo ha creado.

Lo primero que habría que definir es la query CMIS que se va a utlizar

SELECT * FROM zylk-new:noticia WHERE zylk-new:status LIKE 'Published' AND cmis:createdBy LIKE '[$SCREENNAME$]'

y lo segundo el script de groovy que se va a encargar de la presentación de los objetos devueltos por la query CMIS

for (CMISObject obj : listaObjetos) {
   html.append("<h2>" + obj.getProperty("zylk-new:title").getValueAsString() + "</h2>");
   html.append("<br />");
   html.append(obj.getProperty("zylk-new:description").getValueAsString());
   html.append("<br />");
   html.append("<hr />");

};

para más información sobre el portlet contacta con nosotros

CMIS content viewer portlet, a Liferay plugin to query and render CMIS objects from an Alfresco CMIS repository

2013-02-26T19:17:35Z

A usual situation in many-content (web and media) systems is the combination of a portal (such as Liferay Portal) and a CMIS 1.0 container such as Alfresco repository. That architectural aproximation consists on one hand, of a java portal as CMS presentation tier, and on the other, a ECM repository as its CMIS backend. Our requirement is to render CMIS objects via Liferay portlet delegating the workflow publication and the definition of the corresponding types and metadata for blog, events, web documents and media assets in Alfresco repository. So the general purpose of this portlet, is to be a content viewer portlet of CMIS objects from an external repository.

We developed a portlet that can execute a configurable groovy script for rendering CMIS objects. Groovy is a dynamic programming language (like python, ruby or perl) that is used as a scripting language within the java plattform.

The configuration of the portlet allows to specify all required data:

CMIS Repository: Binding type('AtomPub', 'Webservices'), Authentication mode ('None', 'Standard'), and url of the CMIS repository and the username and password (if needed)
CMIS data query: a CMIS query, limit of the number of the results given for the defined query, and a root parent search folder for restricting the search by path in CMIS repository. The portlet also uses Liferay variables when the query will be executed: '[$COMPANYID$]', '[$GROUPID$]', '[$USERID$]', '[$SCREENNAME$]', '[$LOCALE$]', '[$COUNTRY$]' and '[$LANGUAGE$]'
Groovy script: The groovy script allows to read, process and check the resulting list of CMIS objects (called 'objects') for specified query. A Liferay variable of the class 'ThemeDisplay' (called themeDisplay') contains the information related to Liferay: the logged user in the portal, the current community, the current language etc. etc.

The properties of CMIS repository are set in the configuration of the portlet:

with the corresponding CMIS query:

and the groovy script to render:

The groovy script can preview the final results, before publishing:

And finally, in a Liferay page:

This portlet is tested in LF 6.0 EE SP1 & SP2, LF 6.1.x CE, and Alfresco 4.x EE and Nuxeo 5.6 DM CMIS repositories.

Mis addons preferidos de Alfresco ECM

2013-01-28T16:38:31Z

A nivel de core:

- Thrascan cleaner: Esencial en la gestión del ciclo de vida de borrado de un documento.

http://addons.alfresco.com/addons/trashcan-cleaner
http://www.ixxus.com/blog/2011/09/alfresco-node-lifecycle
http://alfrescoshare.wordpress.com/tag/trashcan-cleaner-module

- Bulk Filesystem Import: Otro de los addons "must", ya incluido en las últimas versiones 4.x de Alfresco ECM.

http://addons.alfresco.com/addons/bulk-filesystem-import-tool
http://code.google.com/p/alfresco-bulk-filesystem-import/

- Javascript Console: Un plugin básico para desarrolladores de webscripts.

http://addons.alfresco.com/addons/javascript-console
https://code.google.com/p/share-extras/wiki/JavascriptConsole

- Alfresco Site Folder quota module: Una funcionalidad de cuota por Sitio incluida en el roadmap pero que aún no forma parte de las funcionalidades por defecto.

http://nathanmcminn.com/node/7

- CIFS for openLDAP: Compatibilidad de uso de Alfresco a través de unidades compartidas CIFS con openLDAP.

http://addons.alfresco.com/addons/alfresco-cifs-authenticator-openldap-users

- JDBC authenticator: Gestión de usuarios de Alfresco desde una base de usuarios externas. Esencial para una integración con una aplicación a medida.

http://addons.alfresco.com/addons/alfresco-custom-jdbc-authenticator

A nivel de interfaz y extensión de funcionalidad para Share:

- Alfresco PDF Toolkit: Acciones extras para archivos PDF

https://addons.alfresco.com/addons/alfresco-pdf-toolkit
http://code.google.com/p/alfresco-pdf-toolkit/

- Media viewers: Los improvements relativos a los visualizadores basados en HTML5.

http://addons.alfresco.com/addons/media-viewers
http://code.google.com/p/share-extras/wiki/MediaViewers

- Zip archive: Un descompresor de archivos zip en servidor. Muy útil!

http://addons.alfresco.com/addons/unzip-share-action-zip
http://labs.atolcd.com/projects/unzip-action

- ACP exporter/importer for share: Un módulo para la exportación e importación desde Share.

http://addons.alfresco.com/addons/importexport-acpzip-share
http://labs.atolcd.com/projects/share-import-export

A nivel de sistemas:

- Alfresco Shell Tools: La navaja suiza para Alfresco 4.x

http://addons.alfresco.com/addons/alfresco-shell-tools
http://code.google.com/p/alfresco-shell-tools/

- Alfresco EE nagios module: El módulo de monitorización para Alfresco ECM.

http://addons.alfresco.com/addons/alfresco-nagios-icinga-plugin

Y por ultimo, mencionar también:

- sinadura ECM: El conector de firma digital sinadura PDF para Alfresco ECM.

http://addons.alfresco.com/addons/sinadura-pdf-digital-signature-client-alfresco-ecm

Gestion de certificados con openssl

2013-01-25T12:35:02Z

En los proyectos, normalmente, en la fase de desarrollo se suelen usar certificados auto-firmados para los temas relacionados con canales de comunicación seguros. A continuación vamos a mostrar una serie de comandos para crear llaves, solicitudes de certificados etc.. para no tener que usar certificados autofirmados. Si se hace esto y se instalan los certificados de la CA de desarrollo en los equipos no tendremos que preocuparnos durante el desarrollo de los temas relacionados con los certificados.

lo primero que habría que hacer es crear el par de llaves, publica y privada

openssl genrsa -out zylk-apache.key 2048

Una vez tenemos las llaves en el fichero zylk-apache.key, procedemos a crear la solicitud de certificado

openssl req -config openssl.cnf -new -nodes -key zylk-apache.key -out zylk-apache.csr

es importante remarcar que el fichero openssl.cnf define los valores por defecto del certificado y que además el common name es el dato más importante a la hora de crear un certificado ya que es el campo en el que se añadirá la url del servidor a securizar

por último si disponemos de una CA de pruebas para desarrollo firmaríamos el csr

openssl ca -config openssl.cnf -in zylk-apache.csr -out zylk-apache.cert

Otro punto a tener en cuenta es que se pueden crear extensiones del certificado, por ejemplo para que sirva para más de una URL. Para ello crearíamos un fichero con el siguiente contenido

[ mydomain_http ]
nsCertType      = server
keyUsage        = digitalSignature,nonRepudiation,keyEncipherment
extendedKeyUsage        = serverAuth
subjectKeyIdentifier    = hash
authorityKeyIdentifier = keyid,issuer
subjectAltName          = @mydomain_http_subject
[ mydomain_http_subject ]
DNS.1 = x-zylk.net
DNS.2 = x-sinadura.net
DNS.3 = x-app.kerozain.com

Y lo usariamos a la hora de firmar el csr añadiendo al comando de firma de csr el siguiente parámetro

-extfile /home/waffel/ssl/fichero.extension -extensions mydomain_http

Con estos tres comandos básicos de openssl se pueden cubrir las necesidades de un proyecto durante la fase de desarrollo/test

tareas condicionales usando ant y jenkins

2013-01-23T18:02:37Z

Ayer por la tarde actualizamos a la versión 3 nuestro hudson y se rompió entero... como llevaba un tiempo queriendo migrar el hudson a jenkins decidimos que era un buen momento para reorganizar todo el sistema de integración continua y usar un truco para poder realizar tareas con condiciones desde ant, manejando las condiciones desde las interfaz de hudson a partir de ahora jenkins. Explico a continuación el problema y la solución adoptada en zylk.net.

En zylk.net tenemos todos los proyectos automatizados con tareas de ant o con tareas de maven. Personalmente nos gusta más ant aunque usamos indistintamente cualquiera de las dos alternativa. Al tener las tareas automatizadas con ant tenemos un problema típico que consiste en como gestionar las partes del proyecto que son dependientes del entorno de una manera cómoda. Hasta aquí el problema.

Las posibles soluciones que hemos ido trabajando son las siguientes

Crear tareas diferentes para cada entorno, por ejemplo tener una tarea de compilado otra de empaquetado y otra de despliegue distinta para cada entorno
Ser capaces de parametrizar la ejecución de las tareas en base a ciertos valores que cambian
Disponer de tareas condicionales que se ejecutan o no en base a ciertos valores de ciertas variables.

En este caso hemos modificado las corrientas de ant para que tengan las siguiente estructura

<property name="deploy" value="true" /> <target name="deploy.check"> <condition property="deploy-control"> <and> <contains string="${deploy}" substring="true" /> </and> </condition> </target> <target if="${deploy-control}" name="remote-deploy"depends="deploy.check"> </target>

en este snipet de ant vemos dos tareas

deploy.check
remote-deploy

La primera es una tarea que lo que hace es comprobar el valor de una variable ${deploy} y en base a su valor, fija otra varible ${deploy-control}
La segunda que depende de la primera solo se ejecuta si la variable ${deploy-control} existe (if="${deploy-control}")

El estado de la variable deploy se pude controlar desde tres puntos

build.xml o properties asociado <property name="deploy" value="true" />.
linea de comandos -Ddeploy = true.
o desde la interfaz de jenkins como un parámetro de entrada de la tarea de jenkins. Es decir desde la interfaz web del producto.

Con este pequeño cambio en las tareas de ant podemos parametrizar las ejecuciones y en base a un check dentro del jenkins y realizar tareas especificas para un entorno concreto. Por ejemplo pone unos ficheros de configuración u otros dependiendo de valor de una variable

<target name="environment.prod.check"> <echo message="Mege para produccion ${deploy.prod} ${environment.prod}" /> <condition property="environment.prod"> <and> <contains string="${deploy.prod}" substring="true" /> </and> </condition> <echo message="Mege para produccion 2 ??? ${deploy.prod} ${environment.prod}" /> </target> <target name="merge-prod" if="${environment.prod}" depends="init,environment.prod.check"> <echo message="se usara el context-prod.xml" /> <copy file="context-prod.xml" tofile="META-INF/context.xml"/> <copy file="WEB-INF/web-prod.xml" tofile="WEB-INF/web.xml" /> </target>

En este caso si desde la interfaz de jenkins ponemos el valor true a la variable ${deploy.prod}, conseguiremos que el empaquetado generado tenga el web.xml y el context.xml para el entorno productivo.

Estas cosas se pueden hacer con tareas tipo if de ant pero no son estándares 100%

Entorno de integracion continua para desarrollos en liferay portal basado en hudson

2012-12-20T18:33:58Z

En el desarrollo de software, el ciclo de vida de los proyectos suele pasar por los siguientes estados:

Desarrollo → Pruebas → Producción.

En cada uno de estos estados se realizan unas tareas que pueden dar origen a pasar al siguiente estado o volver al estado anterior. Dependiendo del número de veces que se pase entre los estados en un desarrollo y de los hitos que se marquen, para poder pasar entre los distintos estados, se puede hablar de desarrollos más o menos orientados a metodologías ágiles (siendo esto una simplificación grandísima y errónea si se interpreta al pie de la letra de lo que son metodologías ágiles).

Para realizar estas tareas de manera automática, además de para otras cosas como la validación de la calidad de código, test unitarios etc... se suelen utilizar herramientas de integración continua.

En zylk.net utilizamos hudson/jenkins junto con tareas de ant y/o maven para el procedimiento y la gestión del ciclo de vida de los desarrollos. Un tipo de desarrollos que se realizan en zylk son aquellos basados en liferay, con el sdk del producto. A continuación se muestra un gráfico que ilustra la gestión de proyectos de liferay y la visión que tenemos en zylk de como realizarlos desde el punto de vista del ciclo de vida de Desarrollo → Pruebas → Producción.

En el gráfico podemos ver las siguientes partes

Entorno de desarrollo en PC
Entorno de QA
Entorno de Testing
Entorno productivo

Y un conjunto de herramientas que usamos en el desarrollo como son

Gestor de versiones (subversion)
Gestor de incidencias (mantis)
Gestor de envío de notificaciones (servidor de email, zimbra)
Gestor de ciclo de vida para paso entre entornos (hudson/jenkins)

Desde el punto de vista de zylk una de las partes más importante es el entorno de PC, pensado con una características principal, debe ser auto-consistente, es decir el proyecto que se esté desarrollando debe poder ejecutarse en el PC local del desarrollador.

El entorno de QA es el encargado de descargar las versiones nuevas del sistema de gestión de versiones, compilar, hacer los test pertinentes y desplegar en los distintos entornos.

Una vez explicado este tema, de manera general, la parte particular que nos ocupa en este artículo es describir los problemas y soluciones que hemos adoptado en zylk.net para adaptar los desarrollos de liferay a esta metodología, teniendo en cuenta que queríamos un alineamiento total con el producto y su SDK.

Los problemas principales que nos encontramos fueron dos:

Poder especificar la versión del SDK con la que realizar las tareas en el entorno del SDK, de manera externa.
Poder ejecutar las tareas de compilación y despliegue que el propio SDK facilita pero desde fuera de las carpetas del propio SDK
Poder desplegar en maquinas remotas las compilaciones.

Además se debería poder seguir usando el SDK de manera normal en el entorno del PC precisamente para que cualquier desarrollador pueda desarrollar siguiendo las buenas prácticas para recomendadas por el producto.

Las soluciones fueron muy básicas y poco intrusivas y consisten en pequeñas variaciones del SDK de liferay que se usa en el entorno de QA (en el entorno de PC se usa el SDK estándar precisamente para poder utilizar todo el know-how existente en internet relacionado con liferay) que permite hacer las tareas que hemos comentado.

Con este modelo disponemos de un control del ciclo de vida de los desarrollos basados en liferay para poder gestionar de manera sencilla que se adecua a la forma de trabajo que se usa en zylk.net para el resto de desarrollos no basados en liferay.

A continuación unas imágenes de la herramienta de integración que usamos en zylk.net

vista de los proyectos de un cliente

vista del detalle del despliegue de un proyecto concreto en el entorno de test.

Alfresco CIFS authenticator for openLDAP users addon

2012-08-27T02:00:04Z

What is Alfresco CIFS authenticator for openLDAP users addon ?

Actually, Alfresco provides some CIFS authenticators (passthru, ntlm...), but not for a LDAP subsystem. To solve this problem, we have implemented a component that allows you to use CIFS with openLDAP users.

How to install it

The installation is tracked via an AMP package. First, stop Alfresco, copy the file in ${ALF_HOME}/amps and use ${ALF_HOME}/bin/apply_amps script to install de AMP. Then, copy configuration files to the extension directory to customize and configure the authentication parameters. Once they are configured, restart your Alfresco instance.

How to configure it

In alfresco-global.properties, we can add the new subsystem in the autentication.chain of alfresco-global.properties file.

authentication.chain=alfrescoNtlm1:alfrescoNtlm,myldap:ldap,ldapSamba1:ldapSamba

Then we can customize the authentication subsystem with the help of the files

${EXT_ROOT}/subsystems/Authentication/ldapSamba/ldapSamba1/ldap-samba-authentication-context.xml
${EXT_ROOT}/subsystems/Authentication/ldapSamba/ldapSamba1/ldap-samba-authentication.properties

where ${EXT_ROOT} should be something similar to /opt/alfresco4/tomcat/shared/classes/alfresco/extension/

Custom properties

An example of custom properties are:

# LDAP Connection properties
ldap.samba.authentication.java.naming.provider.url=ldap://ldap.example.com:389
ldap.samba.authentication.base=dc=example,dc=com
ldap.samba.authentication.userbase=ou=People

# The user defined below must be able to execute user search querys in LDAP (administrator)
ldap.samba.java.naming.security.principal=cn=admin,dc=example,dc=com
ldap.samba.java.naming.security.credentials=secret

Notes

Each LDAP user needs to store the password as an MD4 hash and we will solve this by adding a sambaSamAccount object class to the user profile. This object class and its attributes are defined in the samba.schema file, which is part of the samba-doc package. To install this new schema, have a look at the documentation for your Linux distribution in the sections talking about how to add an LDAP schema to OpenLDAP.

It is important to note that the other CIFS-able subsystems must be deactivated (only one of the subsystems can use CIFS - in fact the first one in the chain). In alfresco-global.properties

alfresco.authentication.authenticateCIFS=false
passthru.authentication.authenticateCIFS=false

Where to find more information

For more information about this addon, please fill zylk.net contact / order form

Links

Alfresco custom JDBC authentication addon

2012-08-27T02:08:16Z

What is Alfresco custom JDBC authenticator addon ?

Alfresco custom JDBC authenticator addon provides an out of the box authentication subsystem able to login against a custom table of users storaged in a relational table of a custom application.

It is designed for users integration between an Alfresco repository and a custom application. You can use it with any type of database (mysql, postgresql, oracle....) with its corresponding jdbc driver and it is fully customizable through authentication properties. You can also use CIFS with this subsystem if your password field is stored in MD4.

How to install it

The installation is tracked via an AMP package. Stop Alfresco, copy the AMP file in ${ALF_HOME}/amps and use ${ALF_HOME}/bin/apply_amps script to install de AMP. Then, copy configuration files to the extension directory to customize and configure the authentication parameters. Once they are configured, restart your Alfresco instance.

How to configure it

In alfresco-global.properties, we can add the new subsystem in the authentication.chain of alfresco-global.properties file.

authentication.chain=alfrescoNtlm1:alfrescoNtlm,myldap:ldap,myjdbc:jdbc

Then we can customize the authentication subsystem with the help of the files

${EXT_ROOT}/subsystems/Authentication/jdbc/myjdbc/jdbc-authentication-context.xml
${EXT_ROOT}/subsystems/Authentication/jdbc/myjdbc/jdbc-authentication.properties

where ${EXT_ROOT} should be something similar to /opt/alfresco4/tomcat/shared/classes/alfresco/extension/

Custom JDBC properties

The custom properties of the addon are (for example).

jdbc.driver=org.gjt.mm.mysql.Driver
jdbc.username=root
jdbc.password=secret
jdbc.name=mydb
jdbc.url=jdbc:mysql://localhost:3306/mydb
jdbc.query=SELECT password FROM myusers WHERE id='{1}'

# Default administrators
jdbc.authentication.defaultAdministratorUserNames=zylk,mysql

# CIFS
# If jdbc.authentication.cifs.active = true set jdbc.authentication.password.type = md4
jdbc.authentication.cifs.active=true

# Password encryption type in DB plain|md5|md4
jdbc.authentication.password.type=md4

Notes

It is important to note that the other CIFS-able subsystems must be deactivated (only one of the subsystems can use CIFS - in fact the first one in the chain). In alfresco-global.properties

alfresco.authentication.authenticateCIFS=false
passthru.authentication.authenticateCIFS=false

Where to find more information

For more information about this addon, please fill zylk.net contact / order form

Links