...
| Table of Contents |
|---|
Introducción
Puedes compartir archivos binarios dentro de la plataforma, entre los usuarios de la plataforma y con usuarios externos, si haces el archivo público.
Ver también: APIs REST del Files Repository
Diferentes repositorios de ficheros para diferentes necesidades
Onesait Platform permite almacenar los ficheros en diferentes repositorios, incluso para una misma instalación se pueden tener configurados diferentes tipos simultaneamente. Estos repositorios son:
MongoDB GridFS: Al ser la base de datos de tiempo real de referencia de la plataforma, se trata de la opción por defecto. Proporciona una gestión básica de ficheros, utilizando las capacidades GridFS de MongoDB.
MinIO S3: Es el repositorio de ficheros avanzado de Onesait Platform. Proporciona un almacenamiento compatible con S3, junto con herramientas de gestión avanzada de ficheros en Onesait Plaform (previsualización, versionado, almacenamiento estructurado como un Filesystem tradicional…)
Google Cloud Storage: Implementado en proyectos donde disponer de almacenamiento S3 como servicio es la mejor opción, liberando a los administradores de todas las tareas que implica mantener un gestor de Buckets S3.
La opción de compartir ficheros se hace del mismo modo en los tres tipos de repositorios. Como veremos a continuación, ilustrado desde la opción MongoDB GridFS, desde el listado de ficheros.
¿Cómo usarlo?
1) Ve a https://<instancia de la plataforma>/controlpanel/files/list . También puedes encontrar este enlace en el menú:
...
Después, haz clic en Create.
...
Aparecerá una ventana emergente modal, en la que tienes que escribir los metadatos (que son opcionales), y seleccionar el archivo que quieres compartir.
Hay dos tipos de Modalidad de Almacenamiento: Mongo GridFS y Directory(File). La opción por defecto es GridFS y es la recomendada por varias razones. De cualquier manera, esto es transparente para el usuario.
...
| Info |
|---|
La Plataforma permite configurar el tamaño máximo de los archivos a subir a través de su Configuración Centralizada. Por defecto el límite de tamaño de archivo es de 50 MB. |
2) Una vez subido,
...
verás el archivo en la lista:
...
Por defecto, los archivos subidos no son públicos y no se comparten, por lo que si quieres compartirlo con usuarios de la plataforma, o con usuarios externos, debes hacer clic en el botón 'compartir' o 'público'.
Puedes descargar el archivo haciendo clic en el botón 'descargar' o copiando la url ('copiar enlace') si planeas descargarlo desde un cliente REST.
Nota: Tienes que proporcionar tus credenciales para descargar el archivo de un cliente de REST si el archivo no es público.
Compartir
Puedes compartir el archivo con los usuarios de la plataforma haciendo clic en
...
opciones:
Puedes permitir a los usuarios leer y escribir archivos.
...
También puedes hacer el archivo público. En ese caso, cualquiera puede descargar el archivo:
...
También puedes usar
...
el API REST (APIs REST del Files Repository ) para hacer operaciones CRUD con archivos binarios.
Descargando el archivo
Por defecto, si haces clic en el botón Descargar o pegas la url en un explorador, el archivo se descargará como un archivo adjunto, pero si añades el parámetro de solicitud 'disposition', con cualquier valor, obtendrás el contenido del archivo en el cuerpo de la respuesta, en vez de en un archivo adjunto, por ejemplo:
...