WebDAV

Mediante este servicio es posible exponer los documentos del dossier mediante el protocolo WebDAV, de manera que éstos puedan ser editados en línea desde un ordenador personal con una aplicación de escritorio, como LibreOffice.

Para hacer esto, primero hay que crear un enlace WebDAV, que no es más que una URL con un código que da acceso a un documento determinado mediante WebDAV, de manera que sólo el conocedor de dicha URL pueda editar el documento.

• POST /dossier-web/api/dav/{id}?otp={otp}
POST /dossier-web/api/dav/{tipo}/{anualidad}/{expediente}/{documento}?otp={otp}
  Crea un nuevo enlace WebDAV para el documento de dossier especificado por su identificador único. Es posible también obtenerlo mediante el tipo, anualidad, número de expediente y nombre del documento, aunque esta forma está desaconsejada. Si no hay errores, devolverá un código HTTP 201 (Created) y la URL del enlace recién creado. Esta URL también se devuelve en la cabecera Location.
  Una vez creado el enlace, éste se puede utilizar para editar el documento, abriéndolo con la aplicación adecuada (LibreOffice, MSWord,...).
  El enlace caducará a las 3 horas de inactividad.
  Para crear el enlace se requieren privilegios, pero una vez creado el enlace, éste permite la edición del documento por cualquier persona que conozca dicho enlace, por lo que es responsabilidad del creador del enlace su difusión. La autenticación para crear un enlace se puede realizar de dos maneras:
  • Mediante autenticación HTTP Básica. En este caso hay que incluir el nombre y la contraseña de un usuario con el rol de gestión en el tipo de expediente correspondiente. Es decir, si se quiere crear un enlace a un documento del dossier de un expediente de Contratación (CTT), el usuario debe tener el rol cttgestion. Con el rol comgestion se pueden crear enlaces, y por lo tanto, editar, TODOS los documento del dossier.
  • Mediante clave OTP (One Time Password). En este caso hay que crear en la base de datos compartida una clave OTP, y después incluirla en la petición para crear el enlace como valor del parámetro otp. El valor de la clave OTP en la base de datos debe coincidir con la ruta de la petición, a partir de /dav, por ejemplo: /dav/299384.