Guias

Proporciona una visión general de la plataforma, incluyendo sus objetivos, público objetivo y lineamientos de uso. Incluye una guía operativa para administradores y gestores institucionales.

Descripción general

Obtenga información general sobre la plataforma de Catalogo de Servicios.

Descripción general

Objetivos

Objetivo del Manual

El objetivo del Manual de Uso de la Plataforma de Catálogo de Servicios es proporcionar a los usuarios una guía completa y detallada que les permita comprender, utilizar y administrar eficazmente todas las funciones y características de la plataforma de catálogo de servicios. Este manual tiene como propósito principal:

Objetivos especificos

  1. Orientar a los Usuarios: Proporcionar una introducción clara y accesible a la plataforma, explicando su propósito, funcionalidades y beneficios.

  2. Facilitar la Navegación y Uso: Detallar los pasos y procedimientos necesarios para navegar por la plataforma, acceder a sus diferentes secciones y utilizar sus herramientas de manera eficiente.

  3. Instruir en la Gestión de Servicios: Guiar a los usuarios sobre cómo agregar, modificar, categorizar y retirar servicios dentro del catálogo, resaltando las mejores prácticas para mantener actualizada y precisa la información.

  4. Describir Procesos y Flujo de Trabajo: Explicar los procesos y flujos de trabajo para la gestión de solicitudes de cambio, desde su presentación hasta su aprobación, implementación y seguimiento.

  5. Ofrecer Soporte y Recursos: Proporcionar respuestas a preguntas comunes, soluciones a problemas típicos, acceso a recursos adicionales, enlaces útiles y puntos de contacto para soporte técnico.

  6. Asegurar un Uso Efectivo y Eficiente: Capacitar a los usuarios para utilizar la plataforma de manera efectiva, maximizando su utilidad y minimizando errores o malentendidos en su funcionamiento.

  7. Mejorar la Colaboración y Comunicación: Facilitar la interacción entre usuarios al explicar cómo realizar comentarios, intercambiar información y colaborar en la gestión de servicios y cambios.

  8. Servir como Referencia Centralizada: Constituir una referencia centralizada para todos los aspectos relacionados con la plataforma, desde el uso básico hasta los procedimientos más avanzados y la gestión administrativa.

En resumen, el objetivo fundamental del Manual de Uso de la Plataforma de Catálogo de Servicios es ser una herramienta integral y comprensible que empodere a los usuarios para aprovechar al máximo las funcionalidades de la plataforma, permitiéndoles gestionar eficientemente los servicios y las solicitudes de cambios en el catálogo, y facilitando la colaboración y la comunicación en el contexto de la gestión de servicios.

 

Descripción general

Visión General de la Plataforma

La Plataforma de Catálogo de Servicios es una herramienta integral diseñada para facilitar la gestión centralizada, la presentación y el acceso a una amplia gama de servicios ofrecidos por diversas entidades gubernamentales e instituciones.

Propósito Principal

La plataforma tiene como objetivo principal consolidar y ofrecer un catálogo unificado que reúna información detallada sobre los servicios disponibles para los ciudadanos y otras entidades gubernamentales, con el fin de:

Funcionalidades Clave


Beneficios para los Usuarios

 

Descripción general

Audiencia Objetivo

 

Descripción general

Resumen

La Plataforma de Catálogo de Servicios de República Dominicana es una herramienta integral diseñada para facilitar la gestión centralizada, la presentación y el acceso a una amplia gama de servicios ofrecidos por diversas entidades gubernamentales e instituciones. 

Este manual está diseñado para ser una herramienta de referencia integral para todos los usuarios de la Plataforma de Catálogo de Servicios de República Dominicana. Se espera que, al leer este manual, los usuarios puedan aprovechar al máximo las funcionalidades de la plataforma y contribuir a la mejora continua de la gestión de servicios en el país.

Recursos adicionales:

Comentarios:

Los usuarios pueden dejar sus comentarios sobre este manual en la siguiente sección: https://forms.gle/D7zJCAUn1vEHKXYx6

Acerca de:

La Plataforma de Catálogo de Servicios de República Dominicana ha sido desarrollada por OGTIC. Para obtener más información sobre la plataforma o la entidad desarrolladora, visite el siguiente sitio web: https://ogtic.gob.do 

Esperamos que este manual de usuario sea útil para todos los usuarios de la Plataforma de Catálogo de Servicios de República Dominicana.

Manual de Uso

Administración del Contenido

El módulo de contenido es la forma principal para que los usuarios interactúen con los elementos de una colección. Independientemente de lo que contenga su modelo de datos, el módulo de contenido le permite ver y administrar, ordenar y buscar, o importar y exportar datos.

Página de la colección

La página de colección muestra todos los elementos de una colección y viene con diseños altamente configurables para explorar, visualizar y administrar estos elementos.

El módulo de contenido consta de páginas de colección y páginas de elementos. Use la barra de navegación de la izquierda para moverse entre las colecciones. Cada página de colección muestra todos los elementos de su colección y viene con diseños altamente configurables para explorar, visualizar y administrar elementos. El encabezado de página incluye botones de acción clave para ordenar, buscar, filtrar, crear, editar, archivar y eliminar varios elementos. 



TIP

El módulo Contenido le ayuda a administrar los elementos. Las colecciones se administran en el menú Configuración, ya que estas acciones dan lugar a cambios en el modelo de datos. Para obtener más información, consulte nuestra guía sobre la configuración del modelo de datos.

Buscar elementos

Busque todos los artículos con uno o más campos que contengan el valor buscado, excluyendo los elementos que se hayan filtrado. Para buscar en los artículos de una colección, siga estos pasos.

  1. Navegue hasta el Módulo de contenido y seleccione la colección deseada.

  2. Escoger buscar en el encabezado de la página y aparecerá una barra de búsqueda.

  3. Escriba el valor que desea buscar.

Filtrar elementos

Los filtros le permiten seleccionar condicionalmente elementos de una colección. Los casos de uso incluyen la personalización de los resultados de búsqueda de elementos, la restricción de los permisos de acceso a los elementos para usuarios o roles específicos, la creación de análisis de paneles con el módulo Insights y más. 

Ordenar automáticamente los artículos

Ordene los elementos alfabética o numéricamente, en orden ascendente o descendente. La ordenación no es posible en ciertos diseños, como el diseño de mapa. Los diseños que admiten la ordenación automática tienen controles en ubicaciones ligeramente diferentes. Para obtener más información, consulte Diseños.

Ver elementos archivados

La aplicación le permite ocultar elementos archivados, mostrarlos junto con otros elementos o mostrar sólo elementos archivados. Para obtener más información sobre cómo archivar un artículo, consulta nuestra guía en la página del artículo. Para cambiar si se muestra un elemento archivado, siga estos pasos.

  1. Navegue hasta el Módulo de contenido y seleccione la colección deseada.

  2. Haz clic en "Archivar" en la barra lateral.

  3. Elija la vista deseada:

    1. "Mostrar elementos"

    2. "Mostrar elementos archivados"

    3. "Mostrar elementos + elementos archivados"

Crear un marcador

Guarde el aspecto de una página de colección para poder volver a la misma vista más adelante. Esto incluye detalles como el diseño, las consultas de búsqueda, los filtros, la clasificación y el orden personalizados, etc. Para crear un marcador desde la página de la colección, siga estos pasos.

  1. Navegue hasta la colección deseada.

  2. Clic Marcador en el encabezado de la página.

  3. Introduzca un nombre (y, opcionalmente) un icono y un color.

  4. Haga clic en Guardar para confirmar.

Su marcador aparecerá en la barra de navegación, debajo de la página de colección asociada.

Importar / Exportar Artículos

Los módulos Contenido, Directorio de usuarios y Biblioteca de archivos permiten importar y exportar múltiples elementos almacenados como archivos. Esto hace que sea rápido y fácil manejar tareas como cargar y descargar información de nuevos clientes; Extracción de datos de ventas para la transformación, los informes, el análisis y mucho más. 

Elimine, archive o edite elementos por lotes

Es posible eliminar, archivar o editar varios elementos a la vez desde la página de colección. La eliminación eliminará permanentemente los elementos de la base de datos, esto no se puede revertir. Al editar por lotes, se abre la página de elementos, lo que le permite realizar la misma edición en varios elementos. 


Siga estos pasos para eliminar, archivar o editar elementos por lotes.

  1. Navegue hasta el Módulo de contenido y seleccione la colección deseada.

  2. Elija un diseño que admita la selección de varios elementos en la barra lateral.

(por ejemplo, el diseño de la mesa o de la tarjeta)

  1. Haga clic en los elementos que desea seleccionar:

    1. Diseño de la tabla: Clic check_box_outline_blank en la columna situada más a la izquierda.

    2. Diseño de la tarjeta: Clic radio_button_unchecked en la esquina superior izquierda de cada Tarjeta.

Una vez seleccionados los elementos, aparecerán los siguientes botones en el encabezado de la página: borrar, archivo, y editar.

Borrar

4. Clic borrar en el encabezado y aparecerá una ventana emergente.

5. Haga clic en "Eliminar” para confirmar la acción.

Archivo

4. Clic archivo en el encabezado y aparecerá una ventana emergente.

5. Haga clic en "Eliminar" para confirmar la acción.

Edición

4. Clic editar en el encabezado y se abrirá la página del elemento.

5. Actualice los detalles del artículo como desee.

6. Haga clic en comprobar para confirmar las ediciones por lotes en todos los elementos.


Página del artículo

La página de elementos es un formulario personalizado para administrar artículos y sus valores de campo. Esta página también incluye opciones para archivar, revertir y comentar un elemento.

Al hacer clic en un elemento en la página Colección, se abrirá su página de artículo. La página de elementos es un formulario que le permite ver, editar o eliminar un elemento y sus valores de campo. También puede comentar, compartir, archivar o revertir un elemento desde este formulario. 

Crear un elemento

Para crear un elemento, siga estos pasos.

  1. Navegue hasta el Módulo de contenido y seleccione la colección deseada.

  2. Clic agregar en el encabezado de la página para abrir la página del elemento.

  3. Rellene los detalles del artículo como desee.

  4. Clic comprobar en el encabezado de la página.

Editar un elemento

Para editar los valores de campo de un elemento, siga estos pasos.

  1. Navegue hasta el Módulo de contenido y seleccione la colección deseada.

  2. Haga clic en el elemento deseado para abrir la página del artículo.

  3. Actualice los detalles del artículo como desee.

  4. Clic comprobar en el encabezado.

Otras opciones de guardado

A la derecha del botón Guardar principal, hay un more_vert que contiene las siguientes opciones de guardado alternativas:

Opciones avanzadas de guardado

Para realizar un guardado avanzado al crear o editar un elemento, siga estos pasos.

  1. Comience a crear un elemento o a editar un elemento.

  2. Clic more_vert para abrir el menú contextual.

  3. Haga clic para elegir su método de guardado avanzado.

    Tienes cuatro opciones:

    1. Ahorre y permanezca

    2. Guardar y crear nuevo

    3. Guardar como copia

    4. Descartar todos los cambios

Archivar un elemento

Para archivar un elemento, siga estos pasos.

  1. Navegue hasta el Módulo de contenido y seleccione la colección deseada.

  2. Seleccione el elemento deseado para abrir la página del elemento.

  3. Clic archivo ubicado en el encabezado y aparecerá una ventana emergente.

  4. Haga clic en "Archivar" para confirmar la acción.

Revertir un elemento

A medida que se actualizan los valores de campo en los elementos, la plataforma guarda estas revisiones y se pueden comparar en paralelo con el estado actual. 



Para revertir un elemento, siga estos pasos.

  1. Navegue hasta el Módulo de contenido y seleccione la colección deseada.

  2. Seleccione el elemento deseado para abrir la página del elemento.

  3. Haga clic en "Revisiones" en la barra lateral de la página.

  4. Haga clic en la revisión que desea previsualizar y aparecerá un menú lateral.

  5. Vaya a "Revisiones realizadas" en el menú lateral y vea las diferencias de revisión.

  6. Clic restaurar para revertir los valores del elemento y volver a la página del elemento.

  7. Clic comprobar para confirmar y salir a la página de colección.

Vista previa de la revisión

También verá un botón "Vista previa de revisión" en la navegación del menú lateral, que le permitirá obtener una vista previa de todos los valores del elemento para esa revisión.

TIP

También puede revertir elementos mediante programación a través de la API.

Comentar un elemento

Los comentarios son una herramienta colaborativa que se deja en un elemento de la barra lateral y permanece allí para que usted y otros miembros del equipo los vean. Para crear un comentario, siga estos pasos.

  1. Navegue hasta el Módulo de contenido y seleccione la colección deseada.

  2. Seleccione el elemento deseado para abrir la página del elemento.

  3. Haga clic en "Comentarios" en la barra lateral de la página.

  4. Escriba su mensaje en el cuadro de entrada.

  5. Haga clic en el botón "Enviar".


Menciones

También puede buscar y mencionar a cualquier usuario escribiendo el símbolo "@" junto con su nombre o correo electrónico para enviar una notificación en la aplicación, así como un correo electrónico que lo dirija a su comentario.

Editar y eliminar comentarios

Cada comentario muestra la hora en que se creó en la esquina superior derecha. Coloque el cursor sobre esto y el botón more_horiz aparecerá el menú. Clic editar para editar o borrar para eliminar el comentario.

Eliminar un elemento

Para eliminar un elemento, siga estos pasos.

  1. Navegue hasta el Módulo de contenido y seleccione la colección deseada.

  2. Seleccione el elemento deseado para abrir la página del elemento.

  3. Clic borrar ubicado en el encabezado y aparecerá una ventana emergente.

  4. Haga clic en "Eliminar" para confirmar la acción.

Eliminación temporal

Si desea eliminar un elemento de la vista o del uso sin eliminarlo por completo, considere la posibilidad de archivar el elemento en su lugar.

Vista previa 

La vista previa te permite mostrar los cambios en tu servicio antes de publicarla y sin necesidad de actualizar el navegador.

Vista previa del servicio en el editor

En una página de objetos, activa "Activar vista previa" en la parte superior de la página. Cada vez que crees o editas un elemento de tu colección Y "haz clic" en guardar, deberías ver una vista previa en directo del objeto en el lado derecho de la pantalla.

image.png

Al hacer clic en el botón de la laptop también puedes previsualizar tu contenido en pantallas de escritorio y móvil, y también puedes poner la vista previa en directo en una ventana aparte.

Versionado de servicios

Esta guía cubre el proceso de utilizar el Versionado de servicios en Catalogo. El versionado de servicios permite a los equipos crear y gestionar diferentes versiones de sus servicios. Hay varias razones para Utiliza la versión de servicios, incluyendo redactar contenido sin publicarlo, y más formas de colaborar eficazmente.

Conceptos

Uso de versiones en la vista previa en vivo

El campo de versión es una variable dinámica que se puede añadir a la URL de vista previa para que puedas previsualizar una versión específica de un elemento. 

Creando una nueva versión

image.png

Abre un objeto dentro de tu colección versionada. En la parte superior de la vista de objetos, verás un desplegable con la versión principal del contenido mostrada como "principal". Selecciona "Crear versión" y proporciona una clave y un nombre para la nueva versión. Entonces puedes guardar tu nueva versión.


 

Fuente de la versión
Todas las nuevas versiones se originan en el artículo principal. Esto implica que el elemento principal actúa como la única fuente de verdad para otras versiones.

Realizando cambios en una versión

image.png

Abre el elemento en la versión recién creada y haz las ediciones deseadas en el contenido del artículo.

Al guardar los cambios, notarás que el elemento principal permanece intacto, mientras que los cambios solo se reflejan en la versión modificada.

Comparando y promocionando una versión

image.png

Promocionar una versión la convierte en la versión principal (actual) de tu contenido.

Cómo promocionar una versión

  1. Abre la versión que quieres promocionar
  2. Selecciona el "Versión promocional" Opción del desplegable.
  3. En el modal de comparación, revisa los cambios:
    • Los campos con diferencias respecto al elemento principal se resaltan con indicadores de color
    • Revisa cada campo resaltado para entender qué cambiará
  4. Aceptar o rechazar cambios individuales según sea necesario
  5. Clic "Promote" para finalizar y convertir esta versión en el nuevo elemento principal

Una vez promocionada, esta versión se convierte en contenido activo y el elemento principal anterior se conserva en el historial de versiones.

Después de promocionar una versión, puedes elegir conservarla o eliminarla.

Visualización y restauración de revisiones

Puedes ver las revisiones de un elemento en la barra lateral derecha del Studio. Cuántos campos se actualizaron en cada revisión se aclara mediante la etiqueta, por ejemplo, "2 campos actualizados". Al hacer clic en una revisión se iniciará el Modal de Comparación de Contenido.

Revisiones Cuadro lateral

Ten en cuenta que una vez que el modal de comparación está abierto, puedes cambiar la revisión que quieres comparar usando el menú desplegable en la parte superior derecha del modal.

Selector de revisiones

Al seleccionar una revisión, verás las diferencias entre la versión actual (indicada a la izquierda) y esa revisión (indicada a la derecha).

Modal de Comparación de Contenidos

Los indicadores de etiqueta 'Actualizado' muestran qué campos se actualizaron en esa revisión, mientras que los indicadores de cambio ayudan a entender cómo se compara actualmente la revisión seleccionada con la versión con la que está asociada. Si la revisión no está asociada a una versión, la comparación será con el elemento principal.

Indicadores de diferenciales

Cuando una interfaz de grupo colapsada contiene campos con actualizaciones o diferencias, aparece un indicador de diferenciación junto al nombre del grupo.

Indicador de diferenciales en grupo colapsado

Cuando se expande, los indicadores de diferencias se muestran junto a cada campo del grupo que tenga actualizaciones o diferencias.

Indicadores de Diferencial en el Grupo AmpliadoEsto puede mitigarse eliminando periódicamente algunos o todos los datos de esta colección. Ten en cuenta que esto podría eliminar sin querer algunas versiones de contenido.

Compartir

La utilidad Recursos compartidos le permite compartir un elemento con cualquier persona, independientemente de sus permisos, incluso si no son usuarios del proyecto.

En cualquier proyecto, ciertas colecciones tendrán permisos de acceso limitados. En algunos casos, es posible que tenga que compartir uno de los elementos de la colección con una persona o un grupo de personas que aún no tengan permiso. En este caso, utilice Recursos compartidos. Los recursos compartidos le permiten compartir un elemento de una colección con cualquier persona, independientemente de sus permisos, e incluso si no son usuarios dentro del proyecto. 

¿Qué es compartir?

En cualquier proyecto, algunas colecciones pueden ser accesibles sólo para ciertos roles de usuario u ocultas al público. Puede decidir compartir uno de los elementos de la colección con una persona o un grupo de personas que aún no tengan permiso. En este caso, utilice Recursos compartidos. Los recursos compartidos te permiten dar acceso a cualquier persona a un artículo. Al crear un recurso compartido en un elemento, se asigna un rol para que el recurso compartido hereda permisos de vista. A continuación, puede compartir el artículo a través de un hipervínculo o correo electrónico. El vínculo lleva a una página que contiene el contenido de solo lectura de ese elemento compartido.

Cómo funciona

  1. Vaya al módulo de contenido.

  2. Vaya a la colección del elemento que desea compartir.

  3. Haga clic en el elemento para abrir su página de artículo.

  4. Haga clic en el botón Compartir en la barra lateral.

  5. En el menú desplegable, haz clic en "Nuevo compartir".

  6. Rellena las opciones para compartir. Todo lo que aparece en el menú de opciones para compartir es opcional, pero ten en cuenta lo siguiente:

  7. Clic comprobar en el encabezado del menú una vez que haya establecido un nombre, un rol y restricciones. Verás tu nuevo recurso compartido en Acciones en la barra lateral.

  8. Haga clic en el botón more_horiz en el lado derecho de tu botón Compartir.

  9. Aquí tienes 4 opciones:

Una vez que un usuario abre el vínculo, se mostrará una página personalizada que muestra el elemento compartido.

Cerrar sesión para probar enlaces

Si abre un enlace para compartir mientras está conectado a la plataforma, se redirigirá al elemento en la aplicación. Al probar un recurso compartido, asegúrese de cerrar la sesión de la aplicación antes de abrir el enlace, o simplemente abra el enlace en otro navegador o pestaña de incógnito.

Menú de opciones para compartir

Creación y visualización de recursos compartidos

La capacidad de un usuario para crear recursos compartidos depende de los permisos de su rol. Si eres un Administrador, ¡enhorabuena! Puedes compartir cualquier artículo que desees. Sin embargo, es probable que los usuarios con otros roles tengan permisos limitados para compartir.

Cualquier recurso compartido heredará los mismos permisos de lectura que el rol al que se asoció en el menú Opciones de uso compartido.

Este sistema permite opciones de configuración absolutamente granulares en Shares... pero también significa que deberá comprender a fondo los usuarios, los roles y los permisos para usar los recursos compartidos correctamente. 


Estos son algunos de los aspectos más destacados de lo que puede hacer:

¿Es seguro compartir datos?

Obviamente, no desea exponer elementos a menos que se compartan explícitamente, sin embargo, algunos elementos pueden estar vinculados a elementos de otras colecciones. Por lo tanto, además de heredar los permisos del rol, la API genera e inserta automáticamente un conjunto de permisos para que solo se pueda ver el elemento compartido (y los elementos vinculados relacionalmente a ese elemento compartido). Como se indicó anteriormente, la visibilidad depende de si el rol asociado al recurso compartido tiene permisos de lectura en esas colecciones vinculadas.

Asignación de un rol

La opción Rol en el menú Opciones de uso compartido le permite asociar un rol al recurso compartido. A continuación, el recurso compartido heredará los permisos de ese rol.

Asignar un rol existente

  1. Vaya al menú Opciones para compartir.

  2. Haga clic en el cuadro de entrada de rol y aparecerá un nuevo menú lateral (que se muestra arriba).

  3. Seleccione el rol del que desea que su recurso compartido herede los permisos.

  4. Clic comprobar para confirmar.

Creación/edición de un rol

Si su rol tiene configurados los permisos correctos, puede crear un nuevo rol y asignarlo a un recurso compartido "sobre la marcha" en el menú Opciones para compartir. 

Sin embargo, aún deberá navegar a Configuración > Roles y permisos > [Nombre de rol] para configurar los permisos de lectura.

Crear un nuevo rol

  1. Vaya al menú Opciones para compartir.

  2. Clic agregar en el cuadro de entrada de rol y aparecerá el menú de opciones de rol.

  3. Complete las opciones para crear el Rol de acuerdo con sus necesidades.

  4. Clic comprobar para confirmar la creación de roles.

Editar un rol asignado

  1. Vaya al menú Opciones para compartir.

  2. Clic open_in_new en el cuadro de entrada de rol y aparecerá el menú de opciones de rol.

  3. Edite las opciones de rol según sus necesidades.

  4. Clic comprobar para confirmar las ediciones.


¡Estás creando/editando roles reales!

Si crea o edita un rol en este menú, los cambios surtirán efecto en toda la aplicación, no solo en el contexto del recurso compartido.

Limitar el uso compartido por colección

Puede limitar las colecciones que un rol puede compartir:

  1. Vaya a Configuración > Roles y permisos.

  2. Seleccione el [Nombre del rol] que será responsable de crear el recurso compartido.

  3. Busque la [Colección] para la que desea establecer filtros y, a continuación, haga clic en el icono de la columna situada debajo Compartir y aparecerá un pequeño menú.

  4. Escoger comprobar para habilitar y Bloquear para deshabilitar los recursos compartidos en esta colección.

Limitar el uso compartido por elemento

A veces, es posible que desee que un rol determinado pueda compartir algunos elementos, pero no otros. Los filtros le permiten controlar exactamente qué elementos podrá compartir un rol, por ejemplo, compartir solo informes que estén marcados como "Listo". 

Para usar filtros:

  1. Vaya a Configuración > Roles y permisos.

  2. Seleccione el [Nombre del rol] que será responsable de crear el recurso compartido.

  3. Busque la [Colección] para la que desea establecer los filtros y, a continuación, haga clic en el icono de la columna situada debajo Compartir y aparecerá un pequeño menú.

  4. Escoger regla, Utilice Personalizado y aparecerá un menú lateral.

  5. Cree su(s) filtro(s) según sea necesario.

Limitar el uso compartido por campo

Cuando se crea un recurso compartido en algún elemento, se asocia un rol (y, por lo tanto, los permisos del rol) al elemento. Esto le permite establecer permisos de lectura para los campos exactos (incluidos los campos relacionales) que se comparten. Para limitar el uso compartido por campo:

  1. Vaya a Configuración > Roles y permisos.

  2. Seleccione el [Nombre de la función] que se asigna al recurso compartido.

  3. Busque la [Colección] y luego haga clic en el icono en la columna debajo del icono visibilidad y aparecerá un pequeño menú.

  4. Escoger regla, Utilice Personalizado y aparecerá un menú lateral.

  5. Haga clic en Permisos de campo.

  6. Haga clic para marcar los campos de colección para los que desea permitir permisos de lectura.

  7. Escoger comprobar en el menú lateral Encabezado para confirmar los cambios.


Administración de usuarios

Los usuarios, los roles y los permisos trabajan juntos para determinar quién puede acceder a qué dentro de la base de datos. Los usuarios son las cuentas individuales para autenticarse en el proyecto. A cada usuario se le asigna un rol que define sus permisos de acceso.

Usuarios

Recuerda, los usuarios son datos. Son simplemente filas en una tabla de datos “users”. Puede ser fácil olvidar esto si es nuevo en el trabajo con modelos de datos, ya que el término usuarios puede crear un lugar cálido en nuestros corazones que lo distingue o eleva por encima y más allá del término "data". Pero desde la perspectiva del modelo de datos, ese no es el caso. Los usuarios siguen siendo solo datos.

Los proyectos suelen tener muchos tipos diferentes de usuarios. Por ejemplo, necesitará desarrolladores y administradores para diseñar el modelo de datos, así como para administrar todos sus datos. Es posible que su equipo tenga otros usuarios, como analistas de datos, redactores de contenido o administradores, que necesiten acceder a algunos datos confidenciales, pero no a todo el modelo de datos. Por último, es posible que tenga usuarios finales, como clientes, suscriptores, vendedores de terceros, etc., que necesiten acceder a sus propios datos personales, pero que no puedan acceder a ningún otro dato empresarial. Por lo tanto, tenemos que ser capaces de crear permisos para definir a qué puede y no puede acceder un usuario.


TIP

Otro punto clave es que un usuario no necesita ser una persona en absoluto. Un usuario puede ser un bot de IA, un bot de chat, una API o cualquier otra entidad que pueda iniciar sesión e interactuar con la base de datos.

Cómo funciona

Este módulo es un sistema de gestión que permite ver, invitar, crear, editar y eliminar usuarios e información de usuarios. Los usuarios se pueden crear directamente en la aplicación o se les puede invitar a unirse por correo electrónico.

Cuando se crea un usuario, también se le debe asignar un rol. Este rol define los permisos de acceso a los datos del usuario dentro de Directus. En otras palabras, determina lo que un usuario puede ver y hacer dentro de la aplicación.

El directorio de usuarios se compone de dos páginas: la página del directorio de usuarios y la página de detalles del usuario. Tiene las mismas características y funcionalidades que el módulo de contenido, como la clasificación manual y automática, la edición/eliminación/archivo por lotes, la importación/exportación de archivos, etc.

Página del directorio de usuarios

La página Directorio de usuarios enumera todos los usuarios de un proyecto, con una navegación que permite un acceso rápido a los usuarios por rol. Esta página tiene la misma funcionalidad que la página de colección.

Los siguientes solo son visibles una vez que se seleccionan los usuarios.

Opciones de diseño

La barra lateral > opciones de diseño (indicado por cuando se minimiza la barra lateral)layers le permite ajustar la forma en que se muestran los usuarios en el directorio de usuarios. 

Página de detalles del usuario

Se puede acceder a la página de perfil de un usuario desde el Directorio de usuarios o haciendo clic en el menú de usuario en la parte inferior de la barra de módulos. La página de perfil tiene las mismas características y funcionalidad que la página de elementos. Los administradores pueden agregar y personalizar campos en Configuración > modelo de datos > usuarios, pero los siguientes están disponibles de forma predeterminada.

Preferencias del usuario

Tema

Opciones de administración

Información de solo lectura

Información en la barra lateral (indicado por cuando se minimiza la barra lateral)info También incluye los siguientes detalles de solo lectura:

Ver un usuario

Se hace referencia a los usuarios a lo largo de la aplicación, a menudo con fines de rendición de cuentas. Al pasar el cursor sobre un usuario en este contexto, aparecerá una ventana emergente con información básica. Al hacer clic en esa ventana emergente, accederá a una vista de la página de perfil de ese usuario.

Invitar a un usuario

Para invitar a las personas a convertirse en usuarios por correo electrónico y asignarles automáticamente un rol en el proceso, siga estos pasos.

  1. Vaya a Configuración > Control de acceso > [Rol].

  2. Haga clic person_add en el encabezado de la página.

  3. Introduzca una o más direcciones de correo electrónico, separadas por una coma y un espacio.

  4. Haga clic en Invitar para confirmar.


TIP

En lugar de correos electrónicos separados por comas, también puede agregar nuevos correos electrónicos línea por línea.

Crear un usuario

Para crear un usuario y asignarle su rol (y otros detalles), siga estos pasos.

  1. Vaya a Configuración > Control de acceso > [Rol].

  2. En la sección Usuarios en rol, haga clic en Crear nuevo y se abrirá un cajón.

  3. Rellene los datos del usuario como desee. El usuario recién creado ahora será visible en Usuarios en rol.

  4. Haga clic en el encabezado de la página para confirmar y el cajón se cerrará.

Editar detalles del usuario

Para editar los detalles del usuario, siga estos pasos:

  1. Vaya a la biblioteca de usuario.

  2. Haga clic en el usuario que desea administrar y se abrirá la página de detalles del usuario.

  3. Restablezca los detalles del usuario como desee.

El detalle del usuario solo es editable por el usuario actual y los administradores, y los siguientes campos sólo están disponibles para los administradores:

Archivar un usuario

Para archivar un usuario, siga estos pasos:

  1. Vaya a la biblioteca de usuario.

  2. Haga clic en el usuario que desea archivar para ir a su página de detalles de usuario.

  3. Haga clic en en el encabezado.archive

  4. Confirme esta decisión haciendo clic en Archivar en el cuadro de diálogo.


Deshabilita el acceso

El estado archivado es equivalente a una eliminación temporal. Estos Usuarios no pueden acceder a la Aplicación o API.

Eliminar un usuario

Para eliminar un usuario, siga estos pasos:

  1. Vaya a la biblioteca de usuario.

  2. Seleccione uno o más usuarios que desee eliminar.

  3. Haga clic en en el encabezado.delete

  4. Confirme esta decisión haciendo clic en Eliminar en el cuadro de diálogo.


Cambio irreversible

Esta acción es permanente y no se puede deshacer. Por favor, proceda con precaución. Si desea eliminar temporalmente a los usuarios, consulte Archivar un usuario.

Asignar rol a un usuario existente

Para asignar un rol a un usuario existente, siga estos pasos.

  1. Vaya a Configuración > Control de acceso > [Rol].

  2. En la sección Usuarios en rol, haga clic en Agregar existente y se abrirá un cajón.

  3. Seleccione los usuarios que desee.

  4. Haga clic para confirmar y el cajón se cerrará. Los usuarios agregados ahora serán visibles en Usuarios en rol.check

  5. Haga clic en el encabezado de la página para confirmar.check

Eliminar el rol del usuario

Para eliminar a un usuario de un rol, siga estos pasos.

  1. En la sección Usuarios en rol, haga clic en y el usuario se eliminará del rol.close

  2. Haga clic en el encabezado de la página para confirmar.check

Los usuarios ahora tienen un rol NULL, permisos públicos, hasta que se les asigne un nuevo rol.


Roles

En muchos casos, tu proyecto tendrá varios usuarios haciendo lo mismo (gerentes, escritores, suscriptores, etc.). Si asignamos permisos directamente al usuario, tendríamos que configurar los mismos permisos una y otra vez, lo que hace que sea tedioso cambiar las configuraciones para todos los usuarios que hacen el mismo trabajo y también conduce a una mayor probabilidad de configuración incorrecta. 

Este problema es un ejemplo de duplicación de datos. Para evitar esto, creamos roles, configuramos los permisos del rol una vez y, a continuación, asignamos el rol a los usuarios según lo deseen.

Independientemente del proyecto, la base de datos SQL siempre necesitará un rol de administrador y un rol público. Además, es posible que necesite cualquier número de roles personalizados.

Administradores 

Un rol de administrador proporciona un control completo y sin restricciones sobre la base de datos, incluido el modelo de datos y todos los datos de TI. Esto no se puede limitar, ya que por definición ya no sería un rol de administrador. Necesita al menos un usuario con un rol de administrador. De lo contrario, sería imposible administrar completamente la base de datos.

Público

Un rol público define los permisos de acceso para las solicitudes no autenticadas a la base de datos. Esto significa que si se habilita un permiso de acceso para este rol, todos los usuarios tienen habilitado este permiso. Recuerde que la base de datos no tiene ni idea de qué datos le gustaría que viera el público. Por lo tanto, para estar seguros, todos los permisos comienzan desactivados de forma predeterminada. Depende de los administradores volver a configurarlos y definir exactamente a qué tiene acceso el rol público.

Roles personalizados

Además de estos dos tipos extremos de roles, es posible que tenga que crear más roles, cada uno con su propio conjunto único de permisos. Los roles que creas y los permisos que configuras para ellos son completamente abiertos y dependen de las necesidades de tu proyecto.

Ver un rol

Para ver una función existente, vaya a Configuración > Control de acceso > [Rol]. Ahora puede ver los permisos del rol y otros detalles.

Crear un rol

Para crear un rol, siga estos pasos.

  1. Vaya a Configuración > Control de acceso.

  2. Haga clic en el encabezado de la página.add

  3. Introduzca un nombre de rol único.

  4. Alterne el acceso a la aplicación y el acceso de administrador como desee.

  5. Haga clic en Guardar para confirmar.


TIP

A continuación, es probable que tenga que configurar los detalles del rol y los permisos del rol.

Configurar los detalles del rol

Además de definir permisos, los roles vienen con una serie de otras opciones de configuración. Para configurar los detalles de un rol, siga estos pasos.

  1. Vaya a Configuración > Control de acceso > [Rol].

  2. Configure las siguientes opciones como desee:

  3. Haga clic en el encabezado de la página para confirmar.



Acceso a la aplicación frente al acceso de administrador

Los roles con acceso a la aplicación habilitado se crean con los permisos mínimos necesarios para iniciar sesión en la aplicación y acceder a su propia información de perfil. Los roles que no tienen habilitado el acceso de administrador ni el acceso a aplicaciones se crean con permisos públicos. Siempre puede volver a configurar los permisos más adelante.

Eliminar un rol

Para eliminar un rol, siga estos pasos.

  1. Vaya a Configuración > Control de acceso > [Rol].

  2. Haga clic en el encabezado de la página y aparecerá una ventana emergente.delete

  3. Haga clic en Eliminar para confirmar.


Usuarios con un rol eliminado

Si elimina un rol que todavía tiene usuarios en él, a esos usuarios se les asignará un rol NULL, que los limita a permisos públicos. Sin embargo, siempre puedes asignarles un nuevo rol.


Roles integrados

La plataforma no le permite eliminar el rol público integrado ni el rol de administrador. 



Permisos

Recuerde que, para la mayoría de los proyectos, no sería seguro ni ético dar a todos los usuarios acceso completo a los datos. Los usuarios podrían dañar accidentalmente los datos o incluso realizar acciones maliciosas contra el proyecto y sus usuarios. Por ejemplo, es posible que un estudiante necesite poder ver su calificación, pero no pueda cambiarla.

Por lo tanto, hay cuatro tipos de permisos para cada tabla de datos, en función de las cuatro acciones CRUD que puede realizar con los datos de una base de datos: crear, leer, actualizar y eliminar... Puede configurar los permisos CRUD en cada tabla de datos como desee. Por ejemplo, puede conceder:

Configurar permisos

Para configurar los permisos de acceso de un rol, siga estos pasos.

  1. Vaya a Configuración > Control de acceso > [Rol] y desplácese hasta Permisos.
    Cada colección es una fila. Sus permisos CRUDS están en columnas.

  2. Haga clic en el icono de la colección y el tipo de permiso que desea establecer y aparecerá una información sobre herramientas. Si desea ajustar los permisos de las colecciones del sistema de Directus, haga clic en Colecciones del sistema para expandir el menú y acceder a estas colecciones.

  3. Haga clic en el icono de la fila de colección correspondiente y en la columna de permisos CRUDS y aparecerá un menú emergente con los siguientes niveles de permisos:

  4. A partir de aquí, hay dos posibilidades:


Roles de administrador

Si configura los detalles del rol para que tengan acceso de administrador, la configuración de permisos está deshabilitada.

Configurar permisos personalizados

Para configurar permisos de acceso personalizados para un rol, siga estos pasos.

  1. Siga los pasos para configurar los permisos y elija Usar personalizado en el paso cuatro.

  2. Configure validaciones de permisos de acceso personalizadas como desee. Para cada permiso CRUDS, tendrá uno o más de los siguientes submenús:

  3. Haga clic en el encabezado del cajón lateral para confirmar y guardar los permisos de acceso personalizados.

Alternar todos los permisos de colección

Para conceder o restringir todos los permisos CRUDS a una colección a la vez, siga estos pasos.

  1. Vaya a Configuración > Control de acceso > [Rol].

  2. Pase el ratón por encima del nombre de la colección deseada y aparecerán las siguientes opciones:

Restablecer los permisos del sistema

Esto solo está disponible cuando el acceso a aplicaciones está habilitado al configurar los detalles del rol. Si realizó configuraciones personalizadas en las colecciones del sistema, se revertirá. Para restablecer los permisos del sistema, siga estos pasos.

  1. Vaya a Configuración > Control de acceso > [Rol].

  2. En la parte inferior de Permisos, haga clic en Colecciones del sistema para mostrar las colecciones del sistema.

  3. Desplácese hasta la parte inferior y elija Restablecer permisos del sistema a:

  4. Haga clic en Restablecer para confirmar.


TIP

Es posible que observe que al activar el acceso a la aplicación, los permisos mínimos se modificarán de forma rígida para que no se puedan restringir. Sin embargo, puede volver a configurar los valores predeterminados recomendados.

Reglas de negocio

En muchos casos, tendrá que conceder permisos a los datos en función de su valor o de alguna otra lógica condicional. Este tipo de permiso condicional a menudo se denomina regla de negocio.

Para dar un ejemplo, las instituciones deben ser capaces de leer para sus propios servicios, pero no para los servicios de otras instituciones. Por lo tanto, podría crear una regla de negocio para el rol, de modo que un usuario solo pueda ver su propia institución.

Es común tener varias reglas de negocio complejas en un proyecto.

Gestión de servicios

Gestión de servicios

Flujo de trabajo entre gestores y analistas

Flujo de trabajo para la gestión y publicación de servicios

Esta sección describe el flujo de trabajo institucional para la creación, revisión y publicación de servicios en el Catálogo de Servicios del Estado Dominicano, detallando las responsabilidades y acciones de los gestores institucionales y los analistas en cada etapa.

El flujo está diseñado para garantizar:

1. Roles involucrados

Gestores institucionales

Son los responsables de:

Analistas

Son los responsables de:

2. Estados del servicio

Durante su ciclo de vida, un servicio puede encontrarse en los siguientes estados:

Cada estado define qué acciones están permitidas y quién puede realizarlas.

3. Flujo completo del servicio

Paso 1: Creación del servicio (Estado: Borrador)

📌 Objetivo del estado Borrador:
Permitir la construcción inicial del servicio sin restricciones.

Paso 2: Envío a revisión (Estado: En revisión)

📌 Objetivo del estado En revisión:
Solicitar formalmente la validación institucional del servicio.

Paso 3: Revisión del servicio por el analista

El analista revisa el servicio considerando:

El analista puede tomar una de dos decisiones:

Opción A: Servicio aprobado (Estado: Publicado)

📌 Objetivo del estado Publicado:
Garantizar una fuente confiable, estable y validada de información pública.

Opción B: Servicio con observaciones (Estado: Corrección)

📌 Objetivo del estado Corrección:
Permitir ajustes sin reiniciar el proceso desde cero.

Paso 4: Corrección del servicio (Estado: Corrección)

Este ciclo puede repetirse hasta que el servicio cumpla con los criterios de publicación.

4. Publicación y mantenimiento del servicio

Cuando un servicio está en estado Publicado:

📌 Esto garantiza que:

5. Archivado de servicios

6. Resumen del flujo

  1. Gestor crea el servicio → Borrador

  2. Gestor envía el servicio → En revisión

  3. Analista revisa:

    • Aprueba → Publicado

    • Solicita cambios → Corrección

  4. Gestor corrige → En revisión

  5. Analista publica → Publicado

7. Consideraciones finales

Gestión de servicios

Versionamiento de servicios

1. ¿Qué es una versión de un servicio?

Una versión es una copia controlada de un servicio existente que permite realizar modificaciones sin afectar el servicio vigente que consultan otras plataformas y sistemas del Estado.

El versionamiento existe para:

La versión no reemplaza automáticamente al servicio principal. Solo se convierte en oficial cuando es promovida y aprobada según las reglas establecidas.

2. Servicio principal vs versiones

En el Catálogo existen dos niveles de información:

Servicio principal

Versiones del servicio

3. Estados del servicio y su impacto en el versionamiento

El comportamiento del versionamiento depende del estado del servicio principal, no del estado asignado dentro de la versión.

Estados editables por gestores

Los gestores solo pueden editar directamente un servicio cuando el servicio principal está en alguno de los siguientes estados:

En estos casos:

Estados no editables por gestores

Cuando el servicio principal se encuentra en estados como:

Ocurre lo siguiente:

Esto es intencional y responde a la necesidad de proteger la información oficial del Catálogo.

4. ¿Por qué un gestor no puede promover una versión si el servicio está publicado?

Promover una versión implica actualizar el servicio principal.

Cuando un servicio está en estado En revisión o Publicado:

Por esta razón:

Esto garantiza:

5. Flujo correcto de trabajo para gestores usando versiones

Cuando un gestor necesita actualizar un servicio que ya está en revisión o publicado, el proceso correcto es:

  1. Crear una nueva versión del servicio.

  2. Realizar los cambios necesarios dentro de esa versión.

  3. Marcar la versión como lista para revisión (según el flujo definido).

  4. Notificar al equipo responsable de validación para que:

    • Revise los cambios.

    • Decida si la versión puede ser promovida.

Hasta que esto ocurra:

6. Flujo de trabajo para analistas

Los analistas tienen la responsabilidad de:

Una vez promovida:

7. Consideraciones importantes