MADEJA - Servicios Web de Alfresco

Servicios Web de Alfresco

Alfresco dispone de una API de Servicios web disponible para el acceso al repositorio diseñada para facilitar su
comprensión y utilización, resultar accesible a tantos lenguajes como sea posible y proporcionar acceso remoto
al repositorio.

• Evaluación de los Web Services de Alfresco de acuerdo a MADEJA

• Servicios
• Tipos de datos
• Cabeceras Soap
• Lenguajes de consulta
• Ejemplos de código

Evaluación de los Web Services de Alfresco de acuerdo a MADEJA

MADEJA hace las recomendaciones acerca del desarrollo de Servicios Web en las aplicaciones en el
subsistema de Arquitectura en el área de integración .

De acuerdo a dichas recomendaciones se puede señalar que los servicios web de Alfresco cumplen con dichas
recomendaciones, tal y como se resume a continuación:

• Los WS, son del tipo Contract-first/document literal, lo que se ajusta al escenario ideal marcado en
MADEJA.
• El namespace, pej http://www.alfresco.org/ws/service/repository/1.0, es de tipo URL e incluye número de
versión. En MADEJA se recomienda el formato URN, pero se puede permitir este formato, dado que es el
elegido por el fabricante.
• Al incluir número de versión en el namespace, se cubre el mínimo exigido en MADEJA para el control de
versionado en WS.
• El WSDL tiene cierta división estructural (wdsl, xsd), en este aspecto, se cubre lo mínimos recomendados
por MADEJA al respecto.
• Por último, para la generación de errores se emplean SOAP FAULT, tal y como se recomienda en
MADEJA.

Servicios

La siguiente tabla muestra los distintos conjuntos de servicios web que implementa Alfresco para dar acceso a
las distintas funcionalidades de su repositorio.

Servicio Descripción
Autenticación (Authentication) Login y desconexión
Repositorio (Repository) Consulta y Manipulación del modelo
Contenido (Content) Manipulación de contenido
Autoria (Authoring) Creación colaborativa de contenido
Clasificación (Classification) Aplicación de clasificaciones y categorías
Control de acceso (Access Control) Roles, permisos y propiedad
Acciones (Action) Gestión de acciones y reglas
Administración (Administration) Gestión de usuarios, exportación e importación
Diccionario (Dictionary) Descripciones de modelos

Tipos de datos

Page 1 - 03/03/2009 a las 13:01

 MADEJA - Servicios Web de Alfresco

Cada método de los servicios web se basa en los siguientes tipos de datos para la entrada y salida de
mensajes. Los tipos de datos están enfocados hacia un dominio de contenido y, si es necesario, podrían ser
utilizados fuera del contexto de Web Services si es necesario.

Tipo Descripción
Identificadores (Identifiers) Medios para la identificación y localización de contenido
Contenido (Content) Datos de los contenido
Consulta (Query) Consultas y conjuntos de resultados
Metadatos (Meta Data) Metadatos de los contenidos (diccionario de datos)
Versionado (Versioning) Histórico y gráficos de versiones
Clasificación (Classification) Categorización de contenido

Cabeceras Soap

Las siguientes cabeceras SOAP proporcionan control extra sobre los métodos de los Servicios Web
Cabecera Descripción
Cabecera de Consulta (QueryHeader) Proporciona gestion para consultas
Cabecera de Localización (LocaleHeader) Proporciona gestion para requerimientos localización
Cabecera de NameSpaces (NamespaceHeader) Mapeo de los pefijos de los espacios de nombre
Perfil UsernameToken (UsernameToken Profile) Proporciona gestion de la seguridad de la información

La definición formal de las cabeceras anteriores se encuentra en el SOAP Header XML Schema

Lenguajes de consulta

El núcleo de cualquier interfaz a un gestor de contenidos es el lenguaje de consulta. Actualmente son

soportadas una interfaz Xpath y Lucene pero se está trabajando para implementar un lenguaje de consulta
basado en SQL.

Lenguaje Propósito Descripción

XPath Consulta JCR XPath
Lucene Consulta Estilo Google
Lenguaje de Manipulación de Actualización Lenguaje de manipulación de contenidos
contenidos(CML)

Ejemplos de código

Se va a mostrar ahora algunos códigos de ejemplo de como acceder a la API de servicios web de Alfresco
desde diferentes lenguajes de programación:
* Ejemplos de acceso a Servicios Web para Java
• Ejemplos de acceso a Servicios Web para PHP
• Ejemplos de acceso a Servicios Web con Ruby
• Ejemplos de WSS / WSSE (Web Services Security)
• Web Service Samples for .NET

Page 2 - 03/03/2009 a las 13:01