Desarrollando software para Alfresco (keensoft)

DesarrollandosoftwareparaAlfrescoLaexperienciadekeensoft22deFebrerode2016

Jornada“DesarrollandosoftwareparaAlfresco”Ponentes:AngelBorroy(keensoft)yRichardEsplin (Alfresco)Fecha:22Febrero2016Lugar:Aula1deledificioAdaByron

Agenda• 12:00– 12:45AngelBorroy

– Introducción aAlfresco• 12:45– 13:00RichardEsplin*(Hangout)

– Becoming an Alfresco developer• 13:00– 14:00AngelBorroy

– Tallerdeinstalación,configuración ypuestaenmarchadeAlfresco– Losasistentesquedeseenparticipareneltallerdeberántraersupropioequipo

*LaparticipacióndeRichardEsplin serealizará(mayoritariamente)eninglés


Presentación

keensoft +Alfresco

keensoftkeensoft esunaempresaaragonesafundadaen2007porSantiagoNavarro,queprovenía deTB·Solutions.

Desdeunprimermomento,elobjetivodelacompañíahasidoproveerserviciosinformáticosdecalidad,construyendoparaellounequipodedesarrolladoresexperimentadosquehanprofesionalizado diferenteslíneasdetrabajo:archivo,gestióndocumental,movilidad, big dataydireccióndeproyectos.

Porotraparte,sudecididaapuestapor lainnovaciónhaposicionado alacompañíacomoreferenteanivelnacionalendiferentestecnologíasyproductos.

”Alfresco,comoplataformadegestióndocumentalECM,esunadelaslíneasdeespecializacióndekeensoft.


AngelBorroyAngelBorroyesundesarrolladordesoftwarenacidoenZaragozaconmás de15añosdeexperiencia.ComenzóatrabajarconAlfresco hace4añosyenlaactualidadesunodelosmiembrosmásactivosdelaComunidad:• Miembro fundador deOrder ofthe Bee (http://orderofthebee.org)

– Programme Chair delaBeeCon 2016(http://beecon.buzz)– ParticipanteenelComitédecatalogacióndeaddons

• Ponenteenconferenciasinternacionales– Alfresco Summit2013(Barcelona)– Alfresco Summit2014(London)– BeeCon 2016(Bruselas)– Tech Talk Live#82(https://www.youtube.com/watch?v=fy-dE9uOL-Y)– Tech Talk Live#85(https://www.youtube.com/watch?v=qz2LoVCU8Go)

• Autordediferentescontribuciones yaddons paralaplataforma– GitHub(http://github.com/keensoft)


AlfrescoAlfrescofuefundadaenelaño2005porJohnNewton,queproveníadeDocumentum, ypor JohnPowel,queproveníadeBusinessObjects.Desdeunprimermomento,ambosseconcentraronenproveerunproductoOpenSource queaportasediferentesvaloresdiferencialesalescenariodeplataformasdeECMexistentes.Porotraparte,sudecididaapuestaporlainnovaciónhaposicionado alacompañíaenelcuadrantedevisionariosdeloscuadrosGartnerdeproductosdeECMdurantelosúltimosaños.


RichardEsplinRichardhadesarrolladodiferentesrolesenAlfrescodurantelosúltimosaños.EnlosúltimosmeseshapasadodeserHeadCommunityRelations aProductManager paraAlfrescoCommunity.

RichardesunodelosmiembrosmásactivosdelaComunidaddeAlfresco,atendiendoadesarrolladoresyusuariosatravésdelcanaldechat,delosforos,delawiki,delcorreoelectrónicoydecualquierotramaneraenlaquepuedasllegarhastaél.Conprofundosconocimientostécnicosyvocacióndeayudar,RichardsehaconvertidoenunareferenciafundamentalparalaComunidad

Richard,comolamayoríadelaplantilladeAlfresco,trabajaensucasadesdesuestadonatal,Utah.


ECM

EnterpriseContentManagement

ECM– Definición


”EnterpriseContentManagement(ECM)sonlasestrategias,métodosyherramientasutilizadasparacapturar,gestionar,almacenar,preservaryentregarcontenidoydocumentos relacionadosconlosprocesos organizativos.

ECM- Ámbito


”ECMcubrelagestióndelainformaciónentodoelámbitodelaempresa,silainformaciónsepresentaenformadeundocumentoenpapel,unarchivoelectrónico,unflujodeimpresióndebasededatosoinclusouncorreoelectrónico.

ECM– Ciclodevida


Captura• Escaneo• Digitalización• OCR• Taxonomía• Indexación

Gestión• Documentos• Archivos• Contenidos• DAM• Repositorio• Búsqueda y

recuperación• Colaboración• Seguridad

Almacenamiento y Preservación• Conversión de

formatos• Archivo longevo• Restauración• Migración

Disponibilidad• Sindicación• Publicación• Integración de

contenidos

ECM- Fabricantes


Copyright © 2015 Real Story Group Congres SharePoint 2015

ECM Platforms DM Products Sync and Share

ECM- Mercado


ECM

Paralosusuarios

OrganizaciónclásicaLamayoríadelasorganizacionesclasificansusdocumentosmediante:• Estructurasdecarpetas

– Elsíndromedelaunidadcompartida

• Convencionesdenomenclatura– ElsíndromedelaISO (conperiodicidadanual)

• Propiedadesdedocumentos– Elsíndromedelaautoríauniversal

• Correoelectrónico– Elsíndromedelcarbon-copy


Better Adoption and Productivity

17

Sim

ple

Right Content at the Right Time

Enhance productivity with powerful content management

and custom workflows

Results filteredSimple, consumer‐like search

experience

Supports knowledge mining, discovery and re‐use

Features include:Filtered results based on metadataAuto‐suggestSearch term highlightingSaved searches“More like this” searches

Better Adoption and Productivity

18

Sim

ple

Collaborate with Extended Teams

Securely share content and process, inside and

outside the organization

EstudioIDC2012


©2012 IDC #236480 3

I n f o r m a t i o n W o r k I s D o c u m e n t I n t e n s i v e

Our survey reveals that information workers spend most of their time at work each week performing one document-related activity or another (see Figure 1).

F I G U R E 1

I n f o r m a t i o n W o r k I s H i g h l y D o c u m en t C e n t r i c

Q. Thinking about your typical workweek, how many hours would you say you spend on the following document-related activities?

n = 840 information workers, evenly split across the United States, the United Kingdom, France, Germany, Australia, and Japan Notes: Multiple responses were allowed. Total is 49.5 hours, which is greater than the 44.7 hours information workers say they work each week; subsequent calculations are based on the higher number (49.5). (See the methodology in the Appendix.)

Source: IDC's Information Worker Survey, June 2012

0 2 4 6 8 10

Managing approvals,obtaining signatures

Managing review, merging edits/comments

Filing/organizing documents

Approving/signing documents

Filling in forms

Consolidating and analyzing forms data

Searching for documents

Reviewing/providing feedback

Researching/gathering information

Creating documents

(Hours per week)

Activities related to review/approval of documents (collaboration)

Activities related to creating/managing documents (personal productivity)

Information workers spend most of their time at work each week performing one document-related activity or another.

Horassemanales8,9 :colaboración6,3 :aprobación4,5 :búsquedas(noexitosas)4,0 :introduccióndedatos3,8 :cambiodeformato

EstudioIBM2015


Algunosdatos• 2h re-creando

documentos• 18 minutosparaencontrar

undocumento• 7,5% dedocumentosse

pierden• 3% dedocumentosmal

clasificados

ECM– Colaboración


ECM– Aprobación


ECM– Búsqueda


ECM– Clasificación


Last Name:Fletcher

ECM– Transformación


Alfresco

UnECMOpenSource

Alfresco


San Mateo Atlanta London Maidenhead Sydney Tokyo

Caráctervisionario


• PrimeraimplementacióndelestándarCMIS• Nuevosframeworksyplataformas

– SpringSurf– Activiti– Aikau

• PrimeraenobtenercertificaciónDoD5015.02• PrimeraimplementacióndeSPP• PioneraenlaconcepcióndeHybridCloud

• Accesibledesdemúltiplesdispositivos– Navegadoresweb– Aplicacionesnativas(iOS/Android)

• Integradoconsoftwaredeedición– LibreOffice– MicrosoftOffice– GoogleDocs

• Topologíadeuso– Local– Híbrido– Cloud

HybridCloud


Integración


Versiones


Neutralidadtecnológica


Repo

sitorio)

Alfresco)

APIS)

Interope

rabilid

ad)

Aplicacione

s)

Y)Servicios)

Sistem

as)de)

Almacen

amiento)

.)RDBMS) .)

DM) Share) Workdesk) Mobile) OEM)3rd)Party) Aplicaciones)propias)

API NaKve)Java)

CMIS))

REST) SOAP)JCR)/))

JSR)170)NaKve)REST)

NaKve)SOAP)

.NET

PHP Java

Python

Version)Control) BPMSbased)Workflow)

Security)&)AudiKng)

Content)Modeling)

Indexing,)Search)&)Query)Handler)

Forms)

Policies)and)Aspects)

Templates)&)TransformaKons)

Clustering)&))High)Availability)

Web)Content)Deployment)

Tagging,)Forums,)Wiki,)Blogs)

JMX)Monitoring)

Protocolos)

Sharepoint

IMAP

CIFs

WebDAV

FTP

RM)

Indices)Contenido)

RDBMS)

RDBMS)LDAP)/AD)

SDK)

Tecnología


Características


• Usabilidad– Búsquedaglobal– Previsualizaciónwebdecontenidos(PDF.js)– Orientadoadispositivos(interfazREST)

• Códigoabierto– http://github.com/alfresco– Core comúnentreEnterpriseyCommunity

• Integración– Estándares(CMIS,APIREST,CIFS,WebDAV,FTP,IMAP…)– Tecnologías(Java,JavaScript,Dojo,Freemarker…)

Características


• Addons– http://addons.alfresco.com/browse– http://orderofthebee.org/addons/

• Modelodecontenidos– Tipos,aspectosymetadatos– Lógicaconfigurable(reglas,behaviours)

• Formatos– Nohayrestriccióndetamaño– Extracciónautomáticademetadatos(ApacheTika)– Transformacionesparaprevisualizaciónyfasederendition

(thumbnails)

Características


• Bibliotecadedocumentos– Versionado(contenidoymetadatos),categorías,etiquetas

• Integraciónconsoftwareofimático– MSOffice,LibreOffice/OpenOffice,GoogleDocs– TransformationServer dedicado(soloEnterprise)

• BPM– Activitiesunproductoindependiente(http://www.activiti.org)– Enfoquesdeuso

• Document-centric (pordefecto,integradoenAlfrescoShare)• Human-centric (independiente, integradoconAlfrescoRepo)

Características


• Indexaciónybúsqueda– Metadatosycontenidodelosdocumentos– Respetalospermisosdeusuariosobrelosdocumentos (ACL)– Facetadoconfigurable– BasadoenSOLR4

• AlfrescoShare– Aplicaciónwebcolaborativa– Bibliotecadedocumentos, calendarios,blogs,wikis,foros, listasdedatos…

• Unidadescompartidas– CIFS(samba)/WebDAV– CMISSync(http://cmissync.com/)

Características


• Correoelectrónico– SMTP(Outbound,Inbound)– IMAP

• Otrosservicios– AOS(AlfrescoOfficeServices)– Casemanagement– RecordManagement– Analytics– MediaManagement

Alfresco

ECM- paralosdesarrolladores


VentasTécnico

Habilidadesdedesarrollo


Fuente: temario ACE

Mecanismosdeintegración


• CMIS• AlfrescoWebScripts• Sistemadeficheros• Correoelectrónico• Java• PHP• .NET• Python• CMS

Proyectos


• Repositorio– https://github.com/Alfresco/community-edition

• Clienteweb– https://github.com/Alfresco/share

• Aikau,frameworkdedesarrollowebparaAlfrescoShare– https://github.com/Alfresco/Aikau

• iOSApp– https://github.com/Alfresco/alfresco-ios-app

• AndroidApp– https://github.com/Alfresco/alfresco-android-app

Proyectos


• AlfrescoSDK– https://github.com/Alfresco/alfresco-sdk

• AlfrescoiOSSDK– https://github.com/Alfresco/alfresco-ios-sdk

• AlfrescoAndroidSDK– https://github.com/Alfresco/alfresco-android-sdk

• AlfrescoPHPSDK– https://github.com/Alfresco/alfresco-php-sdk

• AlfrescoCloudSDK– https://www.alfresco.com/develop/cloud

Recursos


• DocumentaciónoficialdeAlfresco– http://docs.alfresco.com/

• AddonsoficialesdeAlfresco– http://addons.alfresco.com

• BlogoficialdeAlfresco– http://blogs.alfresco.com/

• JIRAoficialdeAlfresco– http://issues.alfresco.com

• ForosoficialesdeAlfresco– http://forums.alfresco.com/– http://forums.alfresco.com/es/

• WikioficialdelaComunidaddeAlfresco– http://wiki.alfresco.com

• ChatdeIRC– #alfrescoenfreenode.net

Recursos


• OrderoftheBee– http://orderofthebee.org/

• Blogdekeensoft– http://www.keensoft.es– http://angelborroy.wordpress.com

• SoftwareLoop– http://softwareloop.com/alfresco/

• Loftux– https://www.loftux.com/en/blog

• Redpill– http://alfresco.blog.redpill-

linpro.com/• JeffPotts

– http://ecmarchitect.com/

• TonidelaFuente– http://blyx.com/

• FrancescoCorti– http://fcorti.com/

BecominganAlfrescodeveloper

RichardEsplin @Alfresco

Tallerdeinstalación

keensoft +Alfresco

Consideracionesprevias


• Componentes– AlfrescoShare– AlfrescoRepo(SOLR,LibreOffice,ImageMagick,pdf2swf,Activiti)– Addons (http://addons.alfresco.com/browse)

• Protocolos– CIFS,WebDAV,FTP,IMAP,SMTP,SPP

• Identificación– AlfrescoNTLM,LDAP,LDAP-AD,PASSTHRU,KERBEROS,CAS

• Servicios– APIREST– APICMIS(AtomPub,SOAP)

Puertos(pordefecto)


• HTTP 8080• FTP 21• SMTP 25• CIFS 137,138• IMAP 143• SPP 7070• Tomcat Admin 8005• Tomcat AJP 8009• SOLR 8443• OpenOffice 8100

Dimensionamiento


• Dimensionamiento– NAS

• Tasadetransferencia>200MB/s– Basededatos

• Númerodethreads delservidordeaplicaciones+75 (p.e.275)– Servidordeaplicaciones

• Unthread porcadausuarioconcurrente(p.e.200para2000usuariosnominales)+75

• AlmacenarlosíndicesdeSOLRendiscolocal• Reservarmemoriaespecíficaparatodosloscomponentes(SO,JVM,LibreOffice,…)

– Servidorweb• UtilizarelmóduloAPRconelconectorAJP(instalaciones conTomcat)

Arquitectura


• Utilizarunstack* soportadoporAlfresco• Recomendación:CentOS7+JDK8+Tomcat7+PostgreSQL9

* https://www.alfresco.com/services/subscription/supported-platforms

Mecanismosdeinstalación


• InstaladordeAlfresco– https://www.alfresco.com/products/community/download

• Instalación porcomponentes– https://wiki.alfresco.com/wiki/Community_file_list_5.0.d

• Distribucionesdeterceros– https://github.com/loftuxab/alfresco-ubuntu-install– https://github.com/marsbard/docker-alfresco

• AmazonAWS– https://aws.amazon.com/marketplace/pp/B007IMD9HE

• Boxes(packer,vagrant,docker)– https://github.com/Alfresco/alfresco-spk

Tallerdeinstalación

Instalación enCentOS 7(VirtualBox)

VirtualBox- CentOS7


• Linux/RedHat(64bit)• 4GBRAM• 16GBHD• Networkadapter:Bridge• ImagenminimaldeCentOS7

– CentOS-7-x86_64-Minimal-1511.iso

VirtualBox- CentOS7


Habilitar interfaz de red

Minimal

Cuenta local“alfresco”

DescargadeAlfresco


# sudo yum install wget

# wget https://alf-community-nightly.s3-eu-west-1.amazonaws.com/Community/alfresco-community-installer-20160204-SNAPSHOT-423-linux-x64.bin

# chmod +x alfresco-community-installer-20160204-SNAPSHOT-423-linux-x64.bin

# ./alfresco-community-installer-20160204-SNAPSHOT-423-linux-x64.binSome or all of the libraries necessary to supportLibreOffice were not found on your system: fontconfiglibSM libICE libXrender libXext libcups

InstaladordeAlfresco


# sudo yum install fontconfig libSM libICE libXrenderlibXext cups-libs libGLU

# ./alfresco-community-installer-20160204-SNAPSHOT-423-linux-x64.binPlease select the installation language[1] English – English[2] French – Français[3] Spanish – Español[4] Italian – Italiano...Please choose an option [1] : 1



Installation Type[1] Easy - Installs servers with the default configuration[2] Advanced - Configures server ports and service properties.: Alsochoose optional components to install.Please choose an option [1] : 2

----------------------------------------------------------Java [Y/n] :YPostgreSQL [Y/n] :YLibreOffice [Y/n] :YAlfresco : Y (Cannot be edited)Solr1 [y/N] : NSolr4 [Y/n] :YAlfresco Office Services [Y/n] :nWeb Quick Start [y/N] : NGoogle Docs Integration [Y/n] :n

Is the selection above correct? [Y/n]: Y



--------------------------------------------------------------------------Installation FolderSelect a folder [/home/alfresco/alfresco-community]:

--------------------------------------------------------------------------Database Server ParametersDatabase Server port [5432]:

--------------------------------------------------------------------------Tomcat Port ConfigurationWeb Server domain: [127.0.0.1]:Tomcat Server Port: [8080]:Tomcat Shutdown Port: [8005]:Tomcat SSL Port [8443]:Tomcat AJP Port: [8009]:



--------------------------------------------------------------------------Alfresco FTP PortPort: [2121]:

--------------------------------------------------------------------------LibreOffice Server PortLibreOffice Server Port [8100]:

--------------------------------------------------------------------------Setup is now ready to begin installing Alfresco Community on your computer.Do you want to continue? [Y/n]: Y



# ls -1 alfresco-communityalf_dataalfresco.shampsamps_sharebincommonjavalibreofficepostgresqlsolr4tomcat

keystorepostgresqlsolr4

ImageMagickgspdf2swf

sharedwebapps/alfresco.warwebapps/share.warwebapps/solr4.war

Módulos

ArrancarAlfresco


# systemctl status firewalldfirewalld.serviceActive: inactive (dead)

# /home/alfresco/alfresco-community/alfresco.sh start

# tail -f /home/alfresco/alfresco-community/tomcat/logs/catalina.out...feb 16, 2016 3:01:17 PM org.apache.coyote.AbstractProtocol startINFORMACIÓN: Starting ProtocolHandler ["http-apr-8080"]feb 16, 2016 3:01:17 PM org.apache.coyote.AbstractProtocol startINFORMACIÓN: Starting ProtocolHandler ["ajp-apr-8009"]feb 16, 2016 3:01:17 PM org.apache.coyote.AbstractProtocol startINFORMACIÓN: Starting ProtocolHandler ["http-bio-8443"]feb 16, 2016 3:01:17 PM org.apache.catalina.startup.Catalina startINFORMACIÓN: Server startup in 188056 ms

URLsdeservicio


• Repositorio– http://192.168.1.61:8080/alfresco/

• Share– http://192.168.1.61:8080/share/

• Consoladeadministración– http://192.168.1.61:8080/alfresco/s/admin

• SOLR4– https://192.168.1.61:8443/solr4

(Se usa la IP 192.168.1.61 de manera genérica)

Protocolos


• FTP– ftp://192.168.1.61:2121/ [X]

# telnet 192.168.1.61 2121Trying 192.168.1.61...telnet: connect to address 192.168.1.61: Connection refusedtelnet: Unable to connect to remote host

# alfresco-community/alfresco.sh stop

# vi alfresco-community/tomcat/shared/classes/alfresco-global.properties++ ftp.enabled=true

# alfresco-community/alfresco.sh stop

http://docs.alfresco.com/community/concepts/fileserv-ftp-props.html

Protocolos


• WebDAV– http://192.168.1.61:8080/alfresco/webdav

• CIFS– smb://192.168.1.61/alfresco [X]– http://docs.alfresco.com/community/concepts/fileserv-subsystem-CIFS.html

• IMAPySMTP– http://docs.alfresco.com/community/concepts/email.html

Integración


• APIREST– http://192.168.1.61:8080/alfresco/s/index

• ProtocolosCMIS– SOAP1.0http://192.168.1.61:8080/alfresco/cmisws/cmis?wsdl

– AtomPub1.1 http://192.168.1.61:8080/alfresco/api/-default-/public/cmis/versions/1.1/atom

– Browser1.1 http://192.168.1.61:8080/alfresco/api/-default-/public/cmis/versions/1.1/browser

Integración– APIREST


• APIREST– http://192.168.1.61:8080/alfresco/s/api/login?u=admin&pw=admin

– http://192.168.1.61:8080/alfresco/s/api/people [X]– http://192.168.1.61:8080/alfresco/s/api/people?alf_ticket=TICKET_75834f11d8aefc3efa0480c24de46c1c2115be8a

– http://192.168.1.61:8080/alfresco/s/api/people/admin/sites?alf_ticket=TICKET_75834f11d8aefc3efa0480c24de46c1c2115be8a

Integración– APICMIS


• CMISWorkbenchhttp://chemistry.apache.org/java/developing/tools/dev-tools-workbench.html

Instalarunaddon


# sudo yum install git

# git clone https://github.com/share-extras/js-console.git

# sudo yum install maven

# cd js-console# mvn clean install# cp javascript-console-repo/target/javascript-console-repo.amp$HOME/alfresco-community/amps# cp javascript-console-share/target/javascript-console-share.amp$HOME/alfresco-community/amps_share

# alfresco-community/alfresco.sh stop# alfresco-community/bin/apply_amps.sh# alfresco-community/alfresco.sh start

Instalarunaddon


Buenasprácticasdedesarrollo

keensoft +Alfresco

Recomendacionesgenerales


• Usarsiempre losmecanismosdeextensión– Notoquesningúnficheroincluidoenalfresco.war nishare.war

• Usarunespaciodenombrespropioparalosmodelosdecontenido(tiposyaspectos)– Porejemplo: http://www.keensoft.es/model/content

• Usarunaestructuradepaquetespropia(WebScripts,clasesJava…)– Porejemplo: es/keensoft/alfresco

• EmpaquetarydesplegarlosproyectosconAMP– UtilizaAlfrescoSDK– VersionalosartefactosconMaven

Otrasrecomendaciones


• Elcomitédeaddons deThe Order ofthe Bee estátrabajandoenuncatálogodecriteriosquepermitanidentificarproblemaseneldesarrollodeartefactosparaAlfrescohttps://github.com/OrderOfTheBee/addons/wiki/Inclusion-criteria-overview

• Elobjetivoesclasificarlosaddons disponiblesdeacuerdoaestoscriteriosparaemitirrecomendacionesalosdesarrolladoresyparaaclararalosusuarioslascondicionesdefuncionamiento

• TambiénseestátrabajandoenestadireccióndesdeAlfresco– https://github.com/AlfrescoLabs/technical-validation

Parchesdemantenimiento


• ParalaramaCommunity deAlfresconoseliberanparchesdemantenimiento– Cuandosedetectaunaincidencia,seestablecesuresoluciónpara

unaversiónfutura

• Enocasionesnoesposiblemigraralaúltimaversióndisponible,porloqueseaplicaunparchedemantenimiento– AMPidentificadoconelnúmerodelaincidencia(p.e.alf-mnt-

10938.amp)

• TrasunaactualizacióndeversióndeAlfresco,puedeomitirseeldesplieguedetodoslosAMPsreferentesaincidenciasresueltasporesaversión


[email protected]://github.com/keensoft

@AngelBorroy

http://forums.alfresco.com/eshttp://orderofthebee.orghttp://beecon.buzz

http://angelborroy.wordpress.comhttp://www.keensoft.es/category/blog

Technology

Desarrollando software para Alfresco (keensoft)