Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
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: ¿Cómo compartir Ficheros a través de la API REST del Files Repository? 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.

...

image-20240719-085054.pngImage Added

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 Modo de Almacenamiento: Mongo GridFS y Directorio (Archivo). La opción por defecto, y recomendada por varias razones, es GridFS. Ambas son transparentes al usuario.

image-20240719-085126.pngImage Added

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:

...

image-20240719-085230.pngImage Added

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'.

...

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  Image Removed. opciones:

image-20240719-085317.pngImage Added

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:

...

por ejemplo: https://lab.onesaitplatform.com/controlpanel/files/5bb779a8008920000b398abf

image-20240719-085517.pngImage Added

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:

...