:: Alfresco. Crear documento a partir de plantilla

Es habitual en una empresa o entidad, disponer de una serie de documentos normalizados o plantillas de diversa índole (solicitudes de vacaciones, ofertas técnicas, solicitud de material, hoja de gastos, orden de compra, orden de trabajo,...).
De esta manera, podríamos tener estas plantillas en Alfresco, para que los usuarios con los permisos oportunos pudieran crear documentos a partir de la plantilla seleccionada.

Para que las plantillas estén disponibles para los usuarios de Alfresco, el usuario administrador seguirá los siguientes pasos:
1.- Seleccionará la carpeta siguiente: "Repositorio" > "Diccionario de datos" > "Plantillas de nodos"

2.- Subirá los documentos (plantillas) oportunos a esta ubicación

Una vez copiadas las plantillas de documento en esta ubicación, estarán disponibles a la hora de crear un documento en la biblioteca de documentos, seleccionando:
"Crear" > "Crear documento a partir de plantilla"

De esta manera, el documento creado estará basado en la plantilla seleccionada debiendo el usuario modificarlo con la información pertinente.

:: Liferay. Carga múltiple de ficheros no se muestra en Chrome

A la hora de subir contenidos a la biblioteca de documentos y multimedia del gestor de contenidos Liferay, la opción: "Añadir" > "Múltiples documentos" no está disponible en el navegador Chrome.

En algunas noticias, se indica que Chrome ha dejado de dar soporte a Flash, pero aún así el problema se debe a que posiblemente en alguna de las actualizaciones del navegador la configuración es más restrictiva.

Para habilitar flash en nuestro navegador Chrome, seguiremos los pasos siguientes:
.- En la barra de navegación accedemos a la siguiente url: chrome://settings/content

.- Bajo el apartado: "Privacidad" pulsaremos sobre el botón: "Configuración de contenido"

.- En la capa emergente que nos aparece, buscaremos el epígrafe "Flash" y seleccionaremos la opción: "Permitir que los sitios web ejecuten Flash" (si queremos que así sea), ya que por defecto la opción seleccionada era: "Preguntar antes de permitir que los sitios web ejecuten Flash (recomendado)"

.- Una vez seleccionada esta opción, pulsaremos sobre el botón "Listo"

Tras este cambio en nuestro navegador, en la biblioteca de documentos y multimedia se mostrará la opción: "Múltiples documentos".

:: Liferay. Tip para determinar si un portal está desarrollado en Liferay

Aunque existen multitud de extensiones que permiten identificar los detalles sobre la plataforma de desarrollo de un portal web, una forma rápida y sencilla de determinar si un portal está desarrollado con este gestor, sería:

.- Abrir la consola en el navegador (F12 en Chrome y seleccionar la pestaña "Console")

.- Escribir en la consola "Liferay" y pulsar Intro

Si esta petición nos devuelve un objeto, indicará que el portal web que nos ocupa está desarrollado con este gestor

Si por el contrario la respuesta obtenida es: "Liferay no está definido", indicará que este portal no está desarrollado con Liferay.

:: Liferay. Ocultar detalles de la versión

Es habitual que en los portales desarrollados con el gestor Liferay, no se oculten los detalles de la versión desplegada. Como en otros CMS's quizás sería buena práctica ocultarlos por cuestiones de posibles vulnerabilidades, facilitando de esta manera el trabajo.

En un portal desarrollado en Liferay podemos ver que en las cabeceras aparece toda la información de la versión. Por ejemplo:

Liferay-Portal:Liferay Portal Community Edition 6.2 CE GA6 (Newton / Build 6205 / January 6, 2016)

Para ocultar los detalles de la versión deplegada, debemos añadir la siguiente línea en el fichero "portal-ext.properties".

http.header.version.verbosity=partial

Tras reiniciar el tomcat, la información que veremos en las cabeceras será algo como esto, donde no se dan detalles de la versión del gestor:

Liferay-Portal:Liferay Portal Community Edition

:: Tratar JSON desde C#

Es habitual tener que realizar una petición a una API para consumir un servicio, y que este nos devuelva el resultado en formato JSON del que extraeremos la información necesaria.

Aunque es una tarea sencilla, y únicamente a modo de recordatorio, para llevar a cabo esta tarea desde una aplicación C#, el código sería algo similar a este:


String url = "https://api.sunrise-sunset.org/json" + "?lat=" + txtLatitud.Text + "&lng=" + txtLongitud.Text + "&date=" + fecha;
WebRequest request = WebRequest.Create(url);
WebResponse response = request.GetResponse();

Stream dataStream = response.GetResponseStream();
StreamReader reader = new StreamReader(dataStream);
string responseFromServer = reader.ReadToEnd();

dynamic obj = JsonConvert.DeserializeObject(responseFromServer);

if (obj != null)
{ 
this.txtRespuesta.Text = responseFromServer.ToString();

this.txtSunrise.Text = obj.results.sunrise;
this.txtSunset.Text = obj.results.sunset;
}

reader.Close();
response.Close();


:: Alfresco. Importar usuarios desde un CSV

A la hora de crear varios usuarios en Alfresco, podemos hacerlo por medio de un fichero CSV, el cual debe seguir un formato específico.

Esta tarea es útil -por ejemplo- cuando tenemos que crear una relación extensa de usuarios, estableciendo cuotas de disco, o simplemente creando credenciales de acceso al gestor documental.

• La información que puede contener es la siguiente:
User Name,First Name,Last Name,E-mail Address,,Password,Company,Job Title,Location,Telephone,Mobile, Skype,IM,Google User Name,Address,Address Line 2,Address Line 3,Post Code,Telephone,Fax,Email
• Debe estar en UTF-8, ya que de lo contrario tendremos problemas con caracteres extraños
• El separador debe ser el caracter "," (coma)

Si se ha especificado una dirección de correo electrónico para cada cuenta de usuario a crear, estos recibirán un mail con los datos de acceso (siempre y cuando las notificaciones se encuentren habilitadas).

Un ejemplo de fichero CSV para crear varios usuarios en Alfresco podría ser el siguiente:
import_usr01,Usuario 1, Apellidos 1,usr1@netic360.es,,import_usr01,netic360,Desarrollador web,Madrid,123456789
import_usr02,Usuario 2, Apellidos 2,usr2@netic360.es,,import_usr02,netic360,Desarrollador Liferay,Madrid,123456789
import_usr03,Usuario 3 , Apelllidos 3,usr3@netic360.es,,import_usr03,netic360,Desarrollador Liferay,Madrid,123456789
import_usr04,Usuario 4, Apellidos 4,usr4@netic360.es,,import_usr04,netic360,Desarrollador .NET,Madrid,123456789
Dentro de  nuestro Alfresco seleccionaremos "Administración" > "Usuarios"

Tras la pulsación del botón "Subir fichero CSV de usuarios", este fichero se subirá a nuestro Alfresco y será procesado, obteniendo los resultados de la operación.

:: CMIS. Conexión con Alfresco

Describiremos a continuación una prueba de concepto de conexión desde una aplicación desarrollada en C# con Alfresco, a través de CMIS.

¿Qué es CMIS?

De acuerdo a la definición que aparece en la Wikipedia, Content Management Interoperability Services (CMIS) o Servicios de Interoperabilidad de Gestión de Contenidos es un estándar abierto que permite a diferentes sistemas de gestión de contenidos interoperar a través de Internet. En concreto, CMIS define una capa de abstracción para el control de diversos sistemas de gestión de documentos y repositorios, que utilicen protocolos web.

¿Cómo nos conectamos con Alfresco a través de CMIS?

Para llevar a cabo la conexión, tendremos un Alfresco (por ejemplo instalado en local en el puerto 8282) y necesitaremos una función a la que le pasaremos 3 parámetros:

• Ruta: Indica la ruta CMIS (http://localhost:8282/alfresco/api/-default-/public/cmis/versions/1.0/atom)
• Usuario: usuario definido en Alfresco
• Clave: clave de acceso a Alfresco

Estos dos últimos parámetros constituyen las credenciales de acceso a nuestro Alfresco.

Tras pulsar sobre el botón de login, se llamará a la siguiente función, que realizará la conexión a Alfresco a través de CMIS

/* * Conexión con Alfresco */
private static ISession ConexionAlfresco(String ruta, String usuario, String clave)
{
if (System.Diagnostics.Debugger.IsAttached)
  Console.WriteLine("Estableciendo conexión con Alfresco...");
try {
 Dictionary parameters = new Dictionary(); 
 parameters[DotCMIS.SessionParameter.BindingType] = BindingType.AtomPub; //Parámetros de  conexión 
 parameters[DotCMIS.SessionParameter.AtomPubUrl] = ruta;  parameters[DotCMIS.SessionParameter.User] = usuario;  parameters[DotCMIS.SessionParameter.Password] = clave; 
 SessionFactory factory = SessionFactory.NewInstance(); 
 IList repos = factory.GetRepositories(parameters); 
 ISession session = repos.ElementAt(0).CreateSession(); 
  return session; 
 } catch (Exception ex) { 
 Console.WriteLine("ERROR :: No se ha podido establecer la conexión con Alfresco"); 
 return null; 
 } 
}

Puesto que hemos llevado a cabo la conexión con Alfresco utilizando el estándar CMIS desde una aplicación C#, utilizaremos "DotCMIS".