Gestión de la estructura del contenido y del acceso

La estructuración del contenido y la gestión de acceso de un Workspace pueden realizarse tanto desde la página Admin – Explorer page (por un Administrador) como desde la página principal Projects page (por un miembro del Workspace con permisos suficientes). Los comandos y funciones de estas páginas le permiten:

• Explorar las carpetas y los elementos dentro del Workspace. Puede crear, editar y eliminar carpetas, y así construir la estructura del Workspace. Las carpetas y los elementos eliminados se envían a la Trash, donde pueden eliminarse de forma permanente o restaurarse.

• Definir el uso compartido a nivel de carpeta y a nivel de elemento. Esto controla quién puede ver qué contenido hay en el Workspace y, a nivel de carpeta, si otros usuarios pueden simplemente ver una carpeta y su contenido, o también editarla (es decir, liberar/confirmar/cargar datos de diseño en ella).

• Especificar si una carpeta o elemento (como un proyecto) hereda sus permisos de uso compartido de su carpeta principal. Esta es la condición predeterminada.

En cuanto a la estructura y gestión del contenido, las interfaces de las páginas Projects y Explorer difieren en términos de capacidades y comodidad:

• La página Projects del Workspace ofrece un enfoque sencillo para la gestión de carpetas y elementos de proyecto, disponible para Administradores, propietarios de proyectos/elementos y otros usuarios con suficientes derechos de edición.
  Nota: con esta interfaz no puede editar ni establecer permisos de uso compartido para la carpeta Projects de nivel superior (de forma predeterminada), ni crear otra carpeta de nivel superior.

  La mayoría de las tareas de gestión de la estructura y los permisos del Workspace pueden realizarse desde los comandos de la página Projects.

• La página Explorer del Workspace, que es similar al panel Altium Designer Explorer panel y está disponible solo para Administradores, proporciona acceso de gestión a todas las carpetas y elementos, incluidos los datos de Release del proyecto, componentes, contenido gestionado, etc.
  Nota: con esta interfaz no puede compartir un proyecto de diseño ni mover carpetas y elementos.

  La página Explorer proporciona un control detallado de la estructura del Workspace y de la configuración de permisos, incluido el acceso a la carpeta Projects de nivel superior.

Compartir carpetas y elementos

Related page: Control del acceso al contenido del servidor (página de Altium Designer)

La estructura de carpetas del Workspace de Altium 365 incorpora un avanzado esquema de herencia de permisos basado en la propagación de permisos de uso compartido desde los objetos primarios a los secundarios, siendo estos últimos una carpeta o elementos de diseño como proyectos, componentes, archivos BOM, plantillas, etc. Esta disposición simplifica el proceso de organizar la estructura de carpetas de un Workspace y sus permisos de uso compartido para adaptarlos a los requisitos de acceso de los usuarios de la empresa y de los grupos de usuarios.

Un Workspace ofrece las siguientes capacidades de uso compartido:

• Folder-level Sharing – proporciona la capacidad de controlar quién puede ver qué contenido en el Workspace mediante el uso compartido de carpetas. Esto permite controlar si otros usuarios pueden simplemente ver una carpeta y su contenido, o también editarla (es decir, liberar/confirmar/cargar datos de diseño en ella). Un único Workspace puede dividirse en varias “zonas” efectivas de contenido, pero con permisos controlados a nivel de carpeta, lo que permite que el contenido se haga visible u oculto selectivamente según sea necesario, dando a las personas adecuadas el acceso correcto a los datos correctos.

• Item-level Sharing – proporciona la capacidad de controlar quién puede ver y acceder a qué elementos dentro de una carpeta compartida. Este nivel de uso compartido más específico le permite reemplazar (o añadir a) el conjunto de permisos que un elemento ha heredado de su carpeta principal. Siempre que un usuario tenga acceso a la propia carpeta, podrá ver/editar (según se le permita) los elementos dentro de esa carpeta que se hayan compartido con él.

Las capacidades de uso compartido anteriores se ajustarán al esquema de herencia de permisos del Workspace. En el sentido más simple, los permisos aplicados a una carpeta se propagarán hacia abajo por la jerarquía de carpetas mediante las relaciones primario-secundario, de carpeta a subcarpeta, a lo largo de la cadena.

Esta estructura de herencia de permisos se mantiene (a menos que se desactive intencionadamente en algún punto de la jerarquía) cuando se añaden carpetas a la jerarquía, y también cuando se agregan permisos dentro de la jerarquía. Cuando se aplican permisos adicionales a una carpeta que no es la carpeta de nivel superior —es decir, está dentro de la jerarquía—, estos se heredarán hacia abajo desde ese nivel, sin afectar a los permisos existentes.

En la página Projects del Workspace, se puede acceder a los permisos de las carpetas de proyecto y modificarlos desde las opciones Share de la interfaz. Seleccione una entrada de carpeta y luego el botón superior o la opción Share del menú de la entrada para acceder a la ventana Share Item. Tenga en cuenta que:

• de forma predeterminada —cuando un Workspace se activa por primera vez— la carpeta Projects de nivel superior no es accesible en la página Projects, pero estará disponible si se crean otras carpetas de nivel superior. La interfaz de la página Explorer siempre puede acceder a la carpeta Projects.

• la interfaz y la funcionalidad de la ventana operan del mismo modo al compartir un proyecto; esto incluye la capacidad de cambiar el propietario del elemento (carpeta).

En la página Explorer, se accede a los controles de uso compartido haciendo clic con el botón derecho sobre la entrada del árbol de navegación de la carpeta (o elemento) y usando el comando Share Folder (o Share Item) del menú contextual. Aparecerá la ventana Share, desde donde se podrán modificar según sea necesario los permisos de acceso para la carpeta/el elemento.

Cosas que debe tener en cuenta:

• En términos de permisos, un usuario/grupo tiene acceso de lectura/escritura cuando la opción Can Write (Edit) está habilitada. Si esta opción está deshabilitada, solo tiene acceso de lectura (View).

  Habilitar el acceso Edit a una carpeta/elemento para un usuario/grupo equivale efectivamente a agregar otro permiso a su conjunto de permisos (ACL), y cambiar ese acceso de nuevo a View equivale efectivamente a eliminar un permiso del conjunto.

• En cuanto a las selecciones de permisos de uso compartido en la interfaz de usuario:

  • Una opción Can Write marcada (lectura/escritura) en la página Explorer equivale a tener Can Edit seleccionado en la página Projects. 

  • Una opción Can Write desmarcada (solo lectura) en la página Explorer equivale a tener Can View seleccionado en la página Projects.

• Para quitar el acceso compartido a una carpeta/elemento de un usuario/grupo existente:

  • en la página Projects, seleccione la opción Remove del mosaico del usuario/grupo en la ventana Share Item.

  • en la página Explorer, haga clic en el control Remove asociado a la entrada del usuario/grupo () en la ventana Share.

• De forma predeterminada, una carpeta/elemento solo estará disponible para su propietario (inicialmente, su creador) y para todos los miembros del grupo Administrators. Estos permisos son inherentes y no es necesario agregarlos explícitamente. Owners y Administrators tienen permisos de Lectura/Escritura (Ver/Editar).

• Para permitir que todos los usuarios del Workspace vean una carpeta/elemento:

  • en la ventana Share Item de la página Projects, establezca la opción de acceso del mosaico Workspace Members en Can View, o en Can Edit para acceso completo de escritura.

  • en la ventana Share de la página Explorer, seleccione el control Add Workspace Members y desmarque su opción Can Write, o déjela marcada para acceso completo de escritura.

    Tenga en cuenta que hacer lo anterior potencialmente otorgará acceso de Lectura/Escritura a todos los miembros del Workspace. Si desea restringir el acceso a un conjunto específico de usuarios y/o grupos, debe establecer Workspace Members para No access (página Projects) o quitar Workspace Members entry (página Explorer).

• A diferencia de otros elementos, los permisos de uso compartido de un proyecto de diseño no pueden administrarse mediante la página Explorer. En su lugar, se especifican en la ventana Share Item, a la que se accede desde la página Projects. Consulte la página Workspace Projects para obtener información detallada.

Restricciones de uso compartido controladas por herencia

Es posible que algunos niveles de acceso de usuario, como Can View o No access en la ventana Share Item de una carpeta, no estén disponibles para su selección porque entrarían en conflicto (rebajarían) el conjunto de permisos heredado de su carpeta principal. De forma predeterminada, los permisos de uso compartido de la carpeta son de acceso completo de escritura para todos los usuarios: Workspace Members Can Edit como se muestra en la ventana Share Item, o Workspace Members puede Write como se muestra en la ventana Share de la página Explorer.

En este caso predeterminado, por ejemplo, las opciones para rebajar los permisos heredados de una carpeta (de Workspace Members Edit a Workspace Members View o No Access) están deshabilitadas para evitar una desconexión involuntaria en la estructura jerárquica de permisos. Tenga en cuenta que siempre puede promover (aumentar) el nivel de acceso compartido, ya que esto simplemente "agrega" al conjunto de permisos existente heredado de la carpeta principal.

Para desconectar intencionalmente la herencia de permisos de Principal a Secundaria para esta carpeta, de modo que pueda aplicarse un nivel de acceso diferente (reducido), desmarque la opción Inherit parent folder permissions en Advanced Settings de la ventana Share Item. Una vez que la carpeta deje de heredar permisos de su carpeta principal, sus propios permisos de acceso podrán modificarse sin restricciones. Consulte la sección siguiente para obtener más información.

Del mismo modo, al cambiar los permisos de uso compartido de carpetas mediante la página Explorer del Workspace, no se permite rebajar los permisos heredados de la carpeta principal. Desmarque la opción Inherit permissions from parent de la ventana Share para desconectar intencionalmente la herencia de permisos de su carpeta principal (Projects en este caso).

Forzar la herencia de permisos

Las opciones Advanced Sharing en las páginas Projects y Admin – Explorer del Workspace ofrecen un comando adicional Enforce inheritance for all child items que habilitará Inherit parent folder permissions para todas las subcarpetas e Items dentro de la carpeta (principal) seleccionada actualmente. Esto tiene el efecto de propagar el conjunto de permisos de la carpeta principal hacia abajo en la jerarquía, ya que cada carpeta/Item hereda los permisos de su elemento principal individual.

Aunque normalmente no es necesario, el proceso del comando puede mitigar la situación en la que las subcarpetas o los elementos estén separados (desconectados) de la jerarquía de herencia. Esto puede ocurrir porque la opción Inherit parent folder permissions de una subcarpeta o elemento se deshabilitó para permitir la eliminación (o degradación) de un permiso heredado existente. En esta situación, un cambio en el conjunto de permisos en el nivel superior de la carpeta no se propagará hacia abajo en la jerarquía a ninguna carpeta/elemento donde la herencia esté desconectada.

Un ejemplo podría ser el caso de varias carpetas de copia de seguridad configuradas solo con acceso Admin, que luego se mueven a una carpeta general de archivo. Cada una de estas carpetas está separada de la jerarquía de carpetas (la opción Inherit parent folder permissions está desactivada/deshabilitada) para permitir la degradación de los permisos de acceso a solo Admin. Cuando estas se mueven a la carpeta de archivo (que también está configurada solo como Admin) conservan su estado separado. Consulte Moving Folders. 

Sin embargo, dado que la herencia de permisos no es continua a través de la jerarquía de la carpeta de archivo, los cambios en su conjunto de permisos de nivel superior, por ejemplo agregar acceso View para Managers, no se propagarán a sus subcarpetas ni a su contenido. Esta situación puede corregirse aplicando el comando Enforce inheritance for all child items, que restaura la herencia de permisos al habilitar la configuración Inherit parent folder permissions para todas las subcarpetas y sus Items. El acceso Manager aplicado se propaga entonces hacia abajo en la jerarquía de la carpeta de archivo.

Los pasos de este ejemplo se ilustran a continuación. Las diversas carpetas incluirían Items como Components o Projects, etc.

Continuidad de la herencia de permisos

La continuidad de la herencia de permisos de uso compartido a través de la jerarquía de carpetas del Workspace, como se describió anteriormente, se mantiene a menos que la herencia de permisos de una carpeta desde su carpeta principal se desconecte (deshabilite) explícitamente en algún punto. La propagación de permisos de Principal a Secundaria para una carpeta (o proyecto/Item) se deshabilita al desmarcar su opción Inherit permissions from parent, tal como está disponible en el cuadro de diálogo Share Item. Aunque esa carpeta ya no heredará ningún cambio de permisos realizado en su carpeta principal y la jerarquía de permisos queda efectivamente desconectada (deshabilitada) en este punto, la herencia permanece continua por debajo de este nivel.

La profundidad completa de la herencia de permisos de la carpeta se restaurará si la opción Inherit permissions from parent de esa carpeta "desconectada" se vuelve a habilitar. Entonces volverá a heredar los permisos de la carpeta principal (si aún no están presentes) para restaurar la integridad de permisos entre principal y secundaria.

De acuerdo con el esquema de herencia de permisos habilitado, los permisos de una carpeta/elemento pueden promoverse y ampliarse (efectivamente, la misma acción), pero no pueden degradarse respecto de los de su elemento padre. Esto también se aplica si un permiso agregado para un Grupo/Usuario será común tanto para las entidades Padre como Hija:

• Al agregar un permiso a una carpeta, este sobrescribirá efectivamente el mismo permiso en una carpeta hija si está en un nivel de acceso inferior. Por ejemplo, si el permiso Librarians Read/Write se agrega a una carpeta y su carpeta hija tiene una entrada existente Librarians Read, esta se promoverá a una entrada Librarians Read/Write.
  En esencia, se ha agregado acceso de nivel de escritura a la carpeta padre, y este es heredado por la carpeta hija. Se mantiene la herencia de permisos.

• Por el contrario, al agregar un permiso a una carpeta, este no afectará el mismo permiso en una carpeta hija si tiene un nivel de acceso superior. Por ejemplo, si el permiso Librarians Read se agrega a una carpeta y su carpeta hija tiene una entrada existente Librarians Read/Write, esta no se cambiará (degradará) a una entrada de nivel Read; permanecerá en su nivel de permiso existente.
  En esencia, se ha agregado acceso de nivel de lectura al elemento padre, y esto ya existe en la carpeta hija. Se mantiene la herencia de permisos.

Movimiento de carpetas

Las carpetas del Workspace pueden moverse a cualquier otra ubicación de la estructura de carpetas a través de la página Projects (consulte página Workspace Projects) o el panel Explorer en Altium Designer (consulte Organizing Your Workspace).

La forma en que se determinan los permisos de uso compartido de una carpeta movida depende de la relación de herencia con su carpeta padre actual:

• Cuando la opción Inherit parent folder permissions de una carpeta está habilitada (condición predeterminada), la acción de mover esa carpeta a otra carpeta hará que:

  • herede el conjunto de permisos de su nueva carpeta padre (incluido el Owner de esa carpeta).

  • pierda sus permisos heredados originales.

    • * Los permisos “heredados” de una carpeta/proyecto son los adoptados de su elemento padre: han sido heredados.

  • conserve sus permisos extendidos anteriores.

    • * Los permisos “extendidos” de una carpeta/proyecto son aquellos que se han agregado específicamente para ampliar el acceso del usuario; no han sido heredados de su elemento padre.

• En resumen, los permisos del padre anterior se reemplazan por los permisos del nuevo padre, pero los que se hayan agregado se moverán con la carpeta.

• Cuando la opción Inherit parent folder permissions de una carpeta está deshabilitada (no adopta los permisos de su elemento padre), la acción de mover esa carpeta a otra carpeta hará que:

  • conserve sus permisos originales.

  • conserve el estado deshabilitado de su configuración Inherit parent folder permissions.

• En resumen, es literalmente un evento de movimiento sin otros cambios. Esto podría considerarse la forma más segura de mover una carpeta y su contenido, ya que evita la posibilidad de cambios inesperados en los permisos debido a la herencia desde su nueva carpeta padre.

Gestión de los permisos de creación de proyectos

Con la configuración predeterminada del Workspace, los proyectos creados o cargados por los miembros del Workspace se almacenan en la carpeta Projects, disponible con acceso de escritura para todos los usuarios (como se hereda de la carpeta padre Projects), y se accede a ellos directamente a través de la página Projects. Esta disposición simple es conveniente para los usuarios, pero permite que cualquier miembro del Workspace cree proyectos accesibles en esta ubicación principal (de nivel superior). Para implementar un control más avanzado sobre quién puede crear (y acceder a) proyectos en la carpeta Projects, o en subcarpetas adicionales, los administradores del Workspace pueden definir los permisos de uso compartido de la carpeta del proyecto mediante la página Explorer, o en Altium Designer, el panel Explorer.

Como se describió anteriormente, se accede a los permisos de carpeta en la página Explorer del Workspace desde la opción Share Folder del menú contextual que aparece al hacer clic con el botón derecho en una entrada de carpeta. Por ejemplo, el acceso a la carpeta Projects puede modificarse configurando el permiso predeterminado (Workspace Members) como solo lectura (desmarcando Can Write) o eliminándolo por completo, y luego agregando permisos de acceso para usuarios específicos (Add User) o grupos de usuarios (Add Role) según sea necesario.

Los permisos de escritura actualizados determinarán qué miembros del Workspace pueden crear (o cargar) proyectos en la carpeta Projects; en el ejemplo mostrado anteriormente, solo aquellos que sean miembros del grupo Managers. Las restricciones de permisos también se aplicarán a los usuarios que crean un nuevo proyecto en Altium Designer.

Para una jerarquía de carpetas estructurada en la que los permisos y el acceso de usuarios/grupos estén configurados en consecuencia, por ejemplo, con apertura progresiva hacia abajo en el árbol de carpetas, este enfoque puede proporcionar niveles adecuados de acceso mediante permisos para usuarios y grupos en función de la carpeta de destino.

Permisos predeterminados de creación de proyectos

Como alternativa a la disposición predeterminada, en la que un proyecto recién añadido heredará el conjunto de permisos de su carpeta principal, puede especificar un conjunto fijo de permisos para todos los proyectos nuevos habilitando la opción Default Permissions for new projects en la vista Projects view de la página Admin – Settings. Esta disposición puede adaptarse mejor a una jerarquía de permisos de carpetas menos estructurada, en la que todos los proyectos de usuario se crean en una ubicación específica, como la carpeta Projects.

Cuando está habilitada, un proyecto recién creado adoptará los permisos especificados por esta opción en lugar de heredar los permisos de su carpeta principal. La configuración inicial de la opción coincide con la configuración predeterminada del Workspace: acceso de escritura para todos los usuarios, y puede cambiarse según sus necesidades. Un ejemplo de esto podría ser acceso Write (edición) para Ingenieros y acceso View (solo lectura) para Bibliotecarios.

Points of note:

• Los Administradores siempre tienen acceso de escritura a todos los proyectos (y carpetas), por lo que esta configuración no puede modificarse (es de solo lectura).

• El Propietario del proyecto (el usuario que creó un proyecto) tiene acceso completo al proyecto y, por inferencia, a su carpeta principal, ya que se requieren permisos de escritura en la carpeta para crear un proyecto nuevo.

• Es poco probable que la aplicación de un conjunto fijo de permisos de proyecto (como se describió anteriormente) incluya los permisos de la carpeta principal, por lo que la herencia de permisos padre-hijo del proyecto (carpeta-proyecto) se desactiva automáticamente; diapositiva n.º 4, arriba. Si se vuelve a aplicar manualmente al proyecto, el conjunto de permisos de la carpeta principal se añadirá al proyecto; consulte Permission Inheritance Continuity más arriba para obtener más información.

• El comportamiento de adopción de permisos descrito para proyectos nuevos también se aplicará al clonar un proyecto.

Creación de proyecto sin acceso de escritura a carpeta

Cuando un usuario sin acceso de escritura a la carpeta Projects (o a alguna otra carpeta que se haya especificado como default storage location) realiza una operación de Create o Upload de proyecto, el sistema creará automáticamente una estructura Personal Folder específica del usuario para almacenar el nuevo proyecto. Esta aparece como una carpeta de nivel superior basada en la dirección de correo electrónico del miembro, con una subcarpeta My Projects que almacena los proyectos de ese usuario. La estructura/jerarquía de carpetas pertenece al usuario que ha iniciado sesión y solo está disponible para él (y para los administradores), y no es visible para otros usuarios.

Desde la perspectiva de un administrador del Workspace, las carpetas personales del miembro se agrupan bajo una carpeta Home de nivel superior, como se evidencia en la página Projects y en la jerarquía de carpetas de la página Explorer, y también en el árbol de carpetas del panel Explorer pane folder tree de Altium Designer.

Descarga de una revisión de elemento

Para los miembros del Workspace, el contenido del proyecto (archivos fuente, archivos generados, datos liberados, etc.) puede descargarse a través de las vistas Design y Releases del proyecto. En la página Explorer puede descargar datos directamente desde la interfaz haciendo clic en el control Download () a la derecha de la entrada de una revisión de elemento.

Navegación por la estructura del Workspace

Aunque la navegación orientada a proyectos del contenido del Workspace está disponible para todos los miembros del Workspace a través de las páginas Projects y Components, los administradores del Workspace pueden navegar y acceder a todo el contenido a través de la interfaz de la página Explorer, como se describe a continuación.

Los administradores pueden navegar al contenido del Workspace:

1. Haciendo clic en el nombre de una carpeta cuyo contenido desee examinar.

2. Usando la función de búsqueda. Introduzca una palabra clave basada en el ID, el comentario o la descripción de un elemento, y después pulse Enter o haga clic en el icono de la lupa (). Se examinará todo el Workspace y se mostrarán los resultados de la búsqueda en forma de elementos coincidentes.

   Después de una búsqueda, puede volver a la vista normal del contenido del Workspace haciendo clic de nuevo en la entrada de la página Admin – Explorer , en el árbol de navegación de la interfaz del navegador situado en el extremo izquierdo. Como alternativa, borre el campo de búsqueda y pulse Enter.

Funciones adicionales

Las siguientes funciones adicionales pueden encontrarse al explorar contenido a través de la interfaz de navegador del Workspace:

• Navigate – este comando, que se encuentra en el menú contextual al hacer clic con el botón derecho sobre un elemento, se utiliza para llevarle rápidamente a ese elemento en el panel Explorer panel de Altium Designer. Altium Designer se abrirá para hacerlo (se le pedirá confirmación si desea abrir X2.exe – el ejecutable fuente de Altium Designer).

  Si Altium Designer ya se está ejecutando, se utilizará esa instancia.

• Full item info – este comando, que se encuentra en el menú contextual al hacer clic con el botón derecho sobre una revisión de elemento, se utiliza para presentar una vista que enumera todos los detalles de esa revisión. En efecto, es simplemente una vista que incluye todas las distintas vistas de aspecto disponibles para esa revisión de elemento (excepto Summary).

  Al usar el comando en el nivel del elemento principal se mostrarán los detalles de la revisión más reciente de ese elemento.

• Follow/UnFollow – use el comando Follow , que se encuentra en el menú contextual al hacer clic con el botón derecho sobre una carpeta de tipo Components, para seguir la carpeta. Cualquier actividad dentro de la carpeta seguida (creación de componentes, liberación, cambio de estado de revisión o eliminación) se señalará mediante una notificación por correo electrónico enviada desde el Workspace (siempre que las notificaciones por correo electrónico hayan sido habilitadas para el Workspace por un Administrador). Use el comando UnFollow para dejar de seguir la actividad de componentes dentro de esa carpeta.

• Remove Folder – use este comando, que se encuentra en el menú al hacer clic con el botón derecho sobre una carpeta, para mover esa carpeta y todo su contenido (subcarpetas y elementos contenidos en ellas) al área aislada Trash del Workspace. Las entidades en Trash pueden eliminarse permanentemente o restaurarse, según sea necesario. Si se elimina una carpeta de proyecto, cualquier liberación y paquete de fabricación asociados también se moverán a Trash.

• Remove Item – use este comando, que se encuentra en el menú al hacer clic con el botón derecho sobre un elemento, para mover ese elemento al área aislada Trash del Workspace. Las entidades en Trash pueden eliminarse permanentemente o restaurarse, según sea necesario. Si se elimina un elemento de componente, también tendrá la opción de mover sus modelos asociados a Trash al mismo tiempo. Tenga en cuenta que estos solo pueden eliminarse si no se están utilizando en otro lugar (por uno o más componentes).