Curso Alfresco e Ghost

Curso Introducción a
Alfresco
Guillermo Rodríguez
I. Introducción
I. Introducción
Índice
¿Qué es un gestor documental?
Introducción a Alfresco (qué es y un poco de

historia...)
Características de Alfresco
Licencia
I. Introducción
¿Qué es un gestor documental?
Un Gestor Documental (Document Management System)
es un programa que permite gestionar grandes
cantidades de documentos electrónicos.
Los sistemas de gestión documental normalmente

proporcionan almacenaje, seguridad, flujos de trabajo,
versionado, así como capacidades de recuperación e
indexación.
El concepto de Gestor Documental a diferencia de un

Gestor de Contenidos (Content Management System) se
centra en los documentos.
I. Introducción
Introducción a Alfresco
¿Qué es Alfresco?
Sistema de gestión documental libre basado en
estándares abiertos.
Un poco de historia...
Fundado en 2005 por John Newton, cofundador de
Documentum y John Powell, ex COO de Business
Objects.
Sus principales inversores son Accel Partners, Mayfield
Fund y SAP.
El staff técnico original estaba compuesto por ingenieros
provenientes de Documentum y Oracle.
I. Introducción
Características de Alfresco I
Desde el punto de vista del usuario:
Interfaz web
Unidad compartida
Control de versiones
Búsquedas
Integración con portales existentes
Integración con Office
Reglas de contenidos
Etiquetado
Flujos de trabajo
I. Introducción
Características de Alfresco II
Desde el punto de vista del desarrollador/admin:
Basado en estándares abiertos
Programado en Java
Scripts ligeros (JavaScript y Freemarker)
Arquitectura REST
Motor de indexación Lucene
Motor de flujos de trabajo jBPM
Sin instalación en el cliente
Interfaces CIFS, WebDAV, FTP, IMAP
Seguridad (usuarios, grupos, roles, integración
LDAP/AD)
Motor de transformación de datos (OpenOffice y
SWFTools)
I. Introducción
Licencia
Versiones
Existen dos versiones de Alfresco:
Community
Soportada por la comunidad
Enterprise
Suscripción
Certificado
Asistencia técnica
Alfresco Network
II. Alfresco Web Content
Management
II. Alfresco Web Content Management
Pantalla inicial
Pantalla inicio sesión
My Alfresco
Company Home
My Home
Guest Home
Configuración pantalla inicial I
Configuración pantalla inicial II
Configuración pantalla inicial III
Consola de administración
Administración de usuarios
Creación de usuarios I
Creación de usuarios II
Creación de usuarios III
Prueba login nuevo usuario
Creación de espacios I
Creación de espacios II
Creación de contenidos I
Creación de contenidos II
Creación de contenidos III
Creación de contenidos IV
Propiedades de los contenidos I
Propiedades de los contenidos II
Flujos de trabajo I
Flujos de trabajo II
Flujos de trabajo III
Flujos de trabajo IV
Flujos de trabajo VI
Flujos de trabajo VII
Invitar usuarios a un espacio I
Invitar usuarios a un espacio II
Administrar usuarios de un espacio
Crear reglas en un espacio I
Crear reglas en un espacio II
Crear reglas en un espacio III
Crear reglas en un espacio IV
Administrar reglas de un espacio
Búsqueda Avanzada
III. Alfresco Share
III. Alfresco Share
Introducción
Pantalla inicial
Crear sitio nuevo
Configuración del sitio
Funcionalidades (wiki, blog, bibiloteca de
documentos, calendario, enlaces, foro)
III. Alfresco Share
Inicio de sesión
III. Alfresco Share
Pantalla inicial
III. Alfresco Share
III. Alfresco Share
Configurar pantalla inicial
III. Alfresco Share
Crear sitio nuevo I
III. Alfresco Share
Crear sitio nuevo II
III. Alfresco Share
Pantalla inicial de un sitio
III. Alfresco Share
Configuración de un sitio
III. Alfresco Share
Invitar a un usuario a un sitio
III. Alfresco Share
Wiki
III. Alfresco Share
Blog
III. Alfresco Share
Biblioteca de documentos
III. Alfresco Share
Calendario
III. Alfresco Share
Enlaces
III. Alfresco Share
Foro
III. Alfresco Share
Listados de datos
III. Alfresco Share
Usuarios del sitio
IV. Instalación y
Configuración
IV. Instalación y Configuración
Introducción
Obtener Alfresco
Antes de empezar
Ejecutar el instalador
Configuración
Instalar SWFTools
Buscar programas (SWFTools, OpenOffice)
Archivo alfresco-global.properties
Notificaciones por correo electrónico
Traducir interfaz
Varios...
Obtener Alfresco
Página de descarga:
http://wiki.alfresco.com/wiki/Download_and_Insta
ll_Alfresco
En este curso de utilizará la versión Alfresco

Community 3.3:
http://www.alfresco.com/elqNow/elqRedir.htm?
ref=http://dl.alfresco.com/release/community/buil
d-2860/Alfresco-Community-3.3g-Linux-x86-
Install?dl_file=release/community/build-
2860/Alfresco-Community-3.3g-Linux-x86-Install
Antes de empezar
Instalar:
$ sudo aptitude install sun-java6-jdk
imagemagick libjpeg-dev
Arrancar OpenOffice en modo headless :

$ /usr/lib/openoffice/program/soffice "-
accept=socket,host=localhost,port=8100;urp;S
tarOffice.ServiceManager" -nologo -headless
-nofirststartwizard
Ejecutar el instalador
Dar permisos de ejecución:
$ chmod +x Alfresco-Community-3.3g-Linux-
x86-Install
Ejecutar:
$ ./Alfresco-Community-3.3g-Linux-x86-Install
Instalación I
Instalación II
Instalación III
Instalación IV
Instalación V
Instalación VI
Instalación VII
Instalación VIII
Instalación IX
Instalación X
Instalación XI
Instalación XII
Instalación XIII
Instalación XIV
Instalación XV
Instalar SWFTools
Obtener SWFTools:
http://www.swftools.org/download.html
(descargar versión 0.9 o superior)
Instalar
$ tar xzf swftools-0.9.1.tar.gz
$ cd swftools-0.9.1/
$ ./configure
$ make
$ sudo make install
Buscar programas
Buscar comandos de SWFTools:
$ whereis pdf2swf
pdf2swf: /usr/local/bin/pdf2swf
(Hay que poner la ruta completa)
$ whereis convert
Convert:
/usr/bin/convert/usr/share/man/man1/convert.1.gz
(Hay que poner la carpeta root, donde se encuentra la
carpeta bin)
Buscar comando OpenOffice
$ whereis soffice
soffice: /usr/bin/soffice
(Hay que poner la ruta completa y tener cuidad con la ruta a
ooo.user, ya que hay un bug en el instalador para Debian)
Archivo alfresco-global.properties I
El archivo alfresco-global.properties es el
principal archivo de configuración de Alfresco.
Los elementos básicos de configuración son:

Directorio con los datos (alf_data)
Configuración de la conexión a la B.D.
Programas externos
Correo electrónico
Archivo alfresco-global.properties II
Configuración de los programas externos:
$ vim tomcat/shared/classes/alfresco-global.properties
#
# External locations
# -----------------------
ooo.exe=/usr/bin/soffice
ooo.user=/home/willy/trabajo/charlas/alfresco_eghost_2010/alfresco33c/alf_data
/oouser
jodconverter.officeHome=/home/willy/trabajo/charlas/alfresco_eghost_2010/alfre
sco33c
jodconverter.portNumbers=8101
#ooo.enabled=false
#jodconverter.enabled=true
img.root=/usr
swf.exe=/usr/local/bin/pdf2swf
Notificaciones por correo electrónico
Configuración de envío de notificaciones:
$ vim tomcat/shared/classes/alfresco-global.properties
#
# Sample Gmail settings
# ------------------------------------
mail.host=smtp.gmail.com
mail.port=465
mail.protocol=smtps
mail.username=micorreo@gmail.com
mail.password=miconstraseña
# New Properties
mail.smtps.starttls.enable=true
mail.smtps.auth=true
Traducir el interfaz
Descargar archivo de traducciones:
http://forge.alfresco.com/projects/alfrescoeses/
Descomprimir:
alfresco_3.2_ES-beta1/messages en
tomcat/shared/classes/alfresco/messages
alfresco_3.2_ES-beta1/web-extension en
tomcat/shared/classes/alfresco/web-extension
Varios
Archivo de log:
$ vim alfresco.log
Cambiar el modo de ejecución para que se muestre en la consola en la que lo

ejecutamos:
$ vim tomcat/bin/startup.sh
Al final del archivo cambiar:

exec "$PRGDIR"/"$EXECUTABLE" start "$@"
Por:
exec "$PRGDIR"/"$EXECUTABLE" run "$@"
PermGenSizeError
$ vim tomcat/bin/startup.sh
Añadir al principio la linea:
JAVA_OPTS = "${JAVA_OPTS} -XX:PermSize=512m
-XX:MaxPermSize=512m"
V. Desarrollo sobre
Alfresco
V. Desarrollo sobre Alfresco
Introducción
Instalación Alfresco SDK
Integración con Eclipse
Definición de un modelo de datos
Visualización del modelo de datos
Acciones
Flujos de trabajo
Instalación Alfresco SDK
Prerequisitos:
JDK 1.6.x
Eclipse IDE 3.2+
MySql 1.5.0.67
Descargar:
http://sourceforge.net/projects/alfresco/files/SDK/
Descomprimirlo (no requiere más instalación)

Integración con Eclipse I
Utilizar Eclipse con Java 6
Menú: Window -> Preferences
En el árbol: Java -> Compiler
Seleccionar 1.6 en la opción Compiler
compliance level y dar a OK
Importar los proyectos de Alfresco en Eclipse
Menú: File -> Import
Seleccionar: General -> Exisiting projects into
workspace
Seleccionar el directiorio donde está el SDK de
Alfresco
Integración con Eclipse II
Integración con Eclipse III
Definición de un modelo de datos I
Entorno de extensión de Alfresco WCM:
tomcat/shared/classes/alfresco/extension
Hay que crear un archivo mi-modelo-context.xml

que Alfresco lee al iniciar (Spring) en
omcat/shared/classes/alfresco/. En dicho archivo
hay que indicar qué fichero contendrá el modelo
de datos.
Definición de un modelo de datos II
$ vim tomcat/shared/classes/alfresco/extension/mi-modelo-
context.xml
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE beans PUBLIC '-//SPRING//DTD BEAN//EN'
'http://www.springframework.org/dtd/spring-beans.dtd'>
<beans>

<bean id="extension.dictionaryBootstrap" parent="dictionaryModelBootstrap"
depends-on="dictionaryBootstrap">
<property name="models">
<list>
<value>alfresco/extension/customModel.xml</value>
</list>
</property>
</bean>
</beans>
Definición de un modelo de datos III
Para definir el modelo:
Editar el archivo customModel.xml
Indicar nombre del modelo
Definir Imports
Definir namespaces
Definir tipos de contenido con sus propiedades
Definición de un modelo de datos IV
<?xml version="1.0" encoding="UTF-8"?>



<model name="custom:customModel"
xmlns="http://www.alfresco.org/model/dictionary/1.0">

<description>Custom Model</description>
<author>Guillermo</author>
<version>1.0</version>
<imports>

<import uri="http://www.alfresco.org/model/dictionary/1.0" prefix="d"/>

<import uri="http://www.alfresco.org/model/content/1.0" prefix="cm"/>
</imports>
(...)
Definición de un modelo de datos V
(…)


<namespaces>
<namespace uri="custom.model" prefix="custom"/>
</namespaces>


<types>
<type name="custom:ejemplo">
<title>Expediente</title>
<parent>cm:content</parent>
<properties>
<property name="custom:codigo">
<type>d:text</type>
</property>
<property name="custom:relacionados">
<type>d:text</type>
<multiple>true</multiple>
</property>
</properties>
</type>
</types>
</model>
Visualización del modelo de datos I
Se ha definido el modelo de datos, pero hay que
indicar cómo se debe mostrar ese modelo.
Para hacerlo, hay que editar el archivo web-client-

config-custom.xml:
$ vim tomcat/shared/classes/alfresco/extension/web-client-
config-custom.xml
Visualización del modelo de datos I
<alfresco-config>

<config evaluator="string-compare" condition="Content Wizards">
<content-types>
<type name="custom:ejemplo" display-label="Expediente"/>
</content-types>
</config>

<config evaluator="node-type" condition="custom:ejemplo">
<property-sheet>
<show-property name="custom:codigo"/>
<show-property name="custom:relacionados"/>
</property-sheet>
</config>
(...)
Visualización del modelo de datos II
(…)

<config>
<client>
<simple-search-additional-attributes>
<qname>{custom.model}codigo</qname>
<qname>{custom.model}relacionados</qname>
</simple-search-additional-attributes>
</client>
</config>
(...)
Visualización del modelo de datos II
(...)

<config evaluator="string-compare" condition="Advanced Search">
<advanced-search>
<content-types>
<type name="custom:ejemplo" />
</content-types>
<custom-properties>
<meta-data type="custom:ejemplo" property="custom:codigo" />
<meta-data type="custom:ejemplo" property="custom:relacionados" />
</custom-properties>
</advanced-search>
</config>
</alfresco-config>
Acciones I
Para crear una acción se toma como referencia el
proyecto SDK CustomAction.
El proyecto contiene:
archivo xml que define qué clase implementa la
acción (logger-action-context.xml)
la propia clase (LoggerActionExecuter.java)
se puden añadir archivos de propiedades con las
cadenas de texto (logger-action-
messages.properties)
Acciones II
hello-world-action-context.xml:
<beans>

<bean id="hello-world-action"
class="org.alfresco.sample.HelloWorldActionExecuter" parent="action-
executer"/>

<bean id="hello-world-action-messages"
class="org.alfresco.i18n.ResourceBundleBootstrapComponent">
<property name="resourceBundles">
<list>
<value>org.alfresco.sample.hello-world-action-messages</value>
</list>
</property>
</bean>
</beans>
Acciones III
HelloWorldActionExecuter.java:
public class HelloWorldActionExecuter extends ActionExecuterAbstractBase
{
/** The name of the action */
public static final String NAME = "hello-world-action";
@Override
protected void executeImpl(Action action, NodeRef actionedUponNodeRef)
{
System.out.println("Hello World!!!");
}
@Override
protected void addParameterDefinitions(List<ParameterDefinition> paramList)
{
}
}
Acciones IV
hello-world-action-messages.properties:
# Action title and description
hello-world-action.title=Hello World Action
hello-world-action.description=This action says hello to the world.
Despligue de la acción:
El archivo hello-world-action-context.xml se debe pegar en

la carpeta tomcat/shared/classes/alfresco/extension
El jar que contiene tanto la clase de Java compilada como el
archivo de propiedades hay que copiarlo en
tomcat/webapps/alfresco/WEB-INF/lib
Flujos de trabajo I
Alfresco utiliza el motor jBMP.
Existe un plugin para Eclipse.

Descargar jbpm-jpdl-3.2.3 de:
http://sourceforge.net/projects/jbpm/files/
Descomprimir el contenido de la carpeta

designer/eclipse en la raíz de Eclipse y arrancar
Ecplise.
Se podrán crear proyectos de tipo JbossJBPM.

Flujos de trabajo II
Crear el proyecto: Nuevo -> Proyecto -> JBoss
JBPM -> Process Project
Hay que darle un nombre y asignarle un motor
jBPM (seleccionando la carpeta donde se ha
descomprimido el archivo jbpm-jpdl).
Para poder desplegarlo directamente hay que
editar el archivo processdefinition.xml. En la
pestaña deployment hay que introducir los datos
de conexión del servidor poniendo
/alfresco/jbpm/deployprocess en la opción Server
Deployer.
Flujos de trabajo III
Pestañas del archivo processdefinition.xml:
Diagram: representación gráfica del flujo de
trabajo, se pueden crear acciones y transiciones
visualmente (bastante útil aunque tiene algunos
fallos)
Deployment: se puede utilizar para desplegar
directamente el workflow en el servidor
Design: vista del archivo xml en árbol
Source: archivo xml
Definición de un flujo de trabajo I
Elementos destacados de un flujo de trabajo:
Estados: existirá un estado inicial (start-state) y
otro final (end-state), así como los estados
intermedios. Los estados se componen de
tareas (task) y transiciones (transition).
Actores (swimlane): los flujos de trabajo pueden
ser asignados, tanto a usuarios como a grupos.
Eventos: pueden realizarse acciones cuando se
den ciertos eventos.
Definición de un flujo de trabajo II

<process-definition xmlns="urn:jbpm.org:jpdl-3.2"
name="workflowejemplo">

<swimlane name="initiator" />

<start-state name="inicio">

<task name="wfl:submitWorkflowEjemploTask" swimlane="initiator" />

<transition name="" to="Estado1">

<action name="action" class="com.sample.action.MessageActionHandler">
<message>Going to the first state!</message>
</action>
</transition>
</start-state>
(...)
Definición de un flujo de trabajo III
(…)

<swimlane name="assignee">
<assignment
class="org.alfresco.repo.workflow.jbpm.AlfrescoAssignment">

<actor>#{bpm_assignee}</actor>
</assignment>
</swimlane>
(...)
Definición de un flujo de trabajo IV
(...)

<task-node name="Estado1">

<task name="wfl:tarea1Task" swimlane="assignee">
<event type="task-create">

<script>
if (bpm_workflowDueDate != void) taskInstance.dueDate = bpm_workflowDueDate;
if (bpm_workflowPriority != void) taskInstance.priority = bpm_workflowPriority;
</script>
</event>
</task>

<transition to="Estado2" name="">
<message>Going to the second state!</message>
</action>
</transition>
</task-node>
(...)
Definición de un flujo de trabajo VI
(...)

<task-node name="Estado2">

<transition to="fin" name="">
<message>Going to the last state!</message>
</action>
</transition>
</task-node>


<end-state name="fin"></end-state>

<event type="process-end">
<message>The End!!!</message>
</action>
</event>
</process-definition>
Modelo de datos I
Además de crear el flujo de trabajo en formato BPM, es
necesario mapear los estados que estemos usando en dicho
workflow con un modelo de datos de Alfresco.
Hay que editar el archivo mi-modelo-context.xml incliur el

nuevo modelo:
$ vim tomcat/shared/classes/alfresco/extension/mi-modelo-
context.xml
Añadimos:
<list>
<value>alfresco/extension/workflowModel.xml</value>
</list>
Modelo de datos II
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE beans PUBLIC '-//SPRING//DTD BEAN//EN'
'http://www.springframework.org/dtd/spring-beans.dtd'>
<beans>

<bean id="extension.dictionaryBootstrap"
parent="dictionaryModelBootstrap" depends-on="dictionaryBootstrap">
<property name="models">
<list>
<value>alfresco/extension/customModel.xml</value>
<value>alfresco/extension/workflowModel.xml</value>
</list>
</property>
</bean>
</beans>
Modelo de datos III
$ vim tomcat/shared/classes/alfresco/extension/workflowModel.xml

<model name="wfl:customModel"
xmlns="http://www.alfresco.org/model/dictionary/1.0">

<description>Workflow Model</description>
<author>Guillermo</author>
<version>1.0</version>
<imports>

<import uri="http://www.alfresco.org/model/dictionary/1.0" prefix="d"/>

<import uri="http://www.alfresco.org/model/content/1.0" prefix="cm"/>

<import uri="http://www.alfresco.org/model/bpm/1.0" prefix="bpm"/>
</imports>
(...)
Modelo de datos IV
(...)
<namespaces>
<namespace uri="wfl.model" prefix="wfl"/>
</namespaces>


<types>


<type name="wfl:submitWorkflowEjemploTask">

<parent>bpm:startTask</parent>

<mandatory-aspects>
<aspect>bpm:assignee</aspect>
</mandatory-aspects>
</type>
(...)
Modelo de datos V
(...)

<type name="wfl:estado1Task">

<parent>bpm:workflowTask</parent>

<overrides>

<property name="bpm:packageActionGroup">
<default>add_package_item_actions</default>
</property>


<property name="bpm:packageItemActionGroup">
<default>edit_package_item_actions</default>
</property>
</overrides>
</type>
(...)
Modelo de datos VI
(...)

<type name="wfl:traducidoTask">
<parent>bpm:workflowTask</parent>
</type>
</types>
</model>
Además, hay que reflejarlo en el archivo web-client-config-

custom.xml
$ vim tomcat/shared/classes/alfresco/extension/web-client-
config-custom.xml
Viusalización del modelo de datos I
<alfresco-config>


<config evaluator="node-type" condition="wfl:submitWorkflowEjemploTask" replace="true">

<property-sheet>
<separator name="sep1" display-label-id="general" component-
generator="HeaderSeparatorGenerator" />

<show-property name="bpm:workflowDescription" component-generator="TextAreaGenerator" />

<show-property name="bpm:workflowPriority" />

<show-property name="bpm:workflowDueDate" />
<separator name="sep2" display-label-id="users_and_roles" component-

<show-association name="bpm:assignee" />
</property-sheet>
</config>
(...)
Viusalización del modelo de datos II
(...)
<config evaluator="node-type" condition="wfl:tarea1Task" replace="true">
<property-sheet>
<separator name="sep1" display-label-id="general" component-
<show-property name="bpm:taskId" />
<show-property name="bpm:workflowDescription" component-
generator="TextAreaGenerator" />
<show-property name="bpm:status" />
<show-property name="bpm:dueDate" />
<show-property name="bpm:priority" />
</property-sheet>
</config>
</alfresco-config>
Anexo
Enlaces
Alfresco
http://www.alfresco.com
Gestor Documental en Wikipedia:
http://es.wikipedia.org/wiki/Software_de_gestión_documental

Curso Alfresco e Ghost

Cargado por

Información del documento

Derechos de autor

Formatos disponibles

Compartir este documento

Compartir o incrustar documentos

Opciones para compartir

¿Le pareció útil este documento?

¿Este contenido es inapropiado?

Copyright:

Formatos disponibles

Curso Alfresco e Ghost

Cargado por

Copyright:

Formatos disponibles

Curso Introducción a

Introducción a Alfresco (qué es y un poco de

Los sistemas de gestión documental normalmente

El concepto de Gestor Documental a diferencia de un

En este curso de utilizará la versión Alfresco

Arrancar OpenOffice en modo headless :

Los elementos básicos de configuración son:

Cambiar el modo de ejecución para que se muestre en la consola en la que lo

Al final del archivo cambiar:

Descomprimirlo (no requiere más instalación)

Hay que crear un archivo mi-modelo-context.xml

Para hacerlo, hay que editar el archivo web-client-

El archivo hello-world-action-context.xml se debe pegar en

Existe un plugin para Eclipse.

Descomprimir el contenido de la carpeta

Se podrán crear proyectos de tipo JbossJBPM.

Hay que editar el archivo mi-modelo-context.xml incliur el

Además, hay que reflejarlo en el archivo web-client-config-

También podría gustarte