Discussions Descripción general
Discussions es una solución de SharePoint Framework. Todos los foros, temas, respuestas, Me gusta, denuncias, suscripciones, archivos adjuntos e imágenes residen en listas normales de SharePoint y en una biblioteca de documentos del sitio donde se ejecuta el elemento web. Todas las lecturas y escrituras se realizan mediante las API de SharePoint (REST y CSOM) con la identidad del usuario que ha iniciado sesión. No se almacena nada fuera de su inquilino de Microsoft 365 y el paquete no solicita permisos de Microsoft Graph. Este artículo describe el almacenamiento con el detalle necesario para una revisión de seguridad o una evaluación de protección de datos.
Resumen para administradores
| Pregunta | Respuesta |
|---|---|
| ¿Dónde se almacena el contenido? | En cuatro listas y una biblioteca de documentos del sitio que aloja el foro |
| ¿Quién las crea? | El elemento web, durante el primer uso, en el contexto de un usuario con Administrar listas (propietarios del sitio); las listas y columnas que falten se añaden después del mismo modo |
| ¿Se pueden cambiar sus nombres? | Sí: el elemento web las reconoce por identificadores de columna fijos, no por su título |
| ¿Dónde se almacenan los archivos adjuntos? | Como archivos adjuntos de los elementos de Temas de discusión y Publicaciones de discusión |
| ¿Dónde se almacenan las imágenes del texto? | En la biblioteca Recursos de discusión, en una carpeta por año |
| ¿Qué identidad se utiliza? | La del usuario que ha iniciado sesión, en todas las llamadas |
| ¿Qué permisos de API solicita el paquete? | Ninguno; no se llama a Microsoft Graph |
| ¿Qué se envía a Vitextra? | Identificadores técnicos para la comprobación de licencia y la telemetría de uso; ningún contenido |
| ¿Qué ocurre con los datos al quitar el elemento web? | Nada: las listas permanecen en el sitio hasta que se eliminen |
Las listas del sitio
Cuando un propietario del sitio crea el primer foro, el elemento web aprovisiona las siguientes listas en el sitio. Sirven a todos los foros: un sitio puede tener varios y todos comparten las mismas listas.
| Título predeterminado | Tipo | Contenido |
|---|---|---|
| Foros de discusión | Lista personalizada | Un elemento por foro: título, descripción, modo (Discussion, QnA o Mixed), lista de categorías, contador de temas y opción Requiere aprobación |
| Temas de discusión | Lista personalizada | Temas: título, cuerpo, referencia al foro, categoría, tipo (Discussion o Question), estado (Open, Answered, Locked), indicadores de fijado y destacado, contadores, última actividad, respuesta aceptada, Me gusta, estado de aprobación, menciones, denuncias e identificador heredado |
| Publicaciones de discusión | Lista personalizada | Respuestas: cuerpo, referencias al tema y a la respuesta principal, ruta jerárquica almacenada y profundidad, indicador de respuesta aceptada, Me gusta, estado de aprobación, menciones, denuncias e identificador heredado |
| Suscripciones a discusiones | Lista personalizada | Quién sigue cada foro o tema y con qué frecuencia |
| Recursos de discusión | Biblioteca de documentos | Imágenes insertadas en el editor de texto enriquecido (pegadas, arrastradas o cargadas) |
Las listas se crean visibles en Contenido del sitio, con el control de versiones activado, los tipos de contenido desactivados y la edición rápida (en cuadrícula) desactivada. Las dos listas de contenido admiten archivos adjuntos de elementos; la biblioteca permite crear carpetas. Las listas se pueden rastrear, por lo que los temas y las respuestas pueden aparecer en los resultados de búsqueda de SharePoint como cualquier elemento de lista.
El elemento web mantiene actualizadas las listas y columnas. Cuando un moderador (un usuario con Administrar listas) abre una página cuyo elemento web se configuró antes de que existieran la lista de suscripciones o la biblioteca de recursos, se crean automáticamente las listas y columnas que falten. La configuración del foro -Crear foro y Usar foro- también comprueba siempre las listas y añade las columnas introducidas en versiones posteriores, pero solo para usuarios con Administrar listas. Los demás usuarios únicamente localizan las listas existentes. El proceso no cambia nombres ni elimina nada.
📝 Nota
Los títulos de las listas se toman del idioma de interfaz de la persona que crea el foro. En una interfaz en inglés se llaman Discussions Boards, Discussions Topics, Discussions Posts, Discussions Subscriptions y Discussions Assets; en una interfaz en ruso reciben los títulos rusos del producto. Los nombres se pueden cambiar después sin afectar al funcionamiento del elemento web.
Cómo se reconocen las listas
El elemento web no depende de los títulos de las listas. Cada una contiene una columna marcadora con un identificador fijo: Modo en la lista de foros, la columna de búsqueda Foro en la lista de temas, Tema en la de publicaciones, Tipo de destino en la de suscripciones y una columna de texto Recurso de discusión en la biblioteca. Primero busca las listas por título y, si no las encuentra, examina las listas visibles del sitio en busca de estas columnas. Por tanto:
- puede cambiar el nombre de una lista o el nombre para mostrar de una columna; el elemento web seguirá funcionando;
- no debe eliminar las columnas marcadoras ni las demás columnas
Vtx: el elemento web consideraría que falta la lista o no podría leer sus elementos; - las listas deben permanecer en el mismo sitio que la página que aloja el elemento web; no se puede mostrar un foro desde otro sitio.
Las columnas
Todas las columnas que añade el producto tienen nombres internos que empiezan por Vtx; los nombres para mostrar se localizan igual que los títulos de las listas. La referencia completa, con tipos, índices y valores permitidos en columnas de elección, está en KB10426. Referencia de listas y columnas de Discussions. Para revisar los datos, tenga en cuenta lo siguiente:
- Los cuerpos de los temas y las respuestas (
VtxBody) se almacenan como HTML. El editor depura todo mediante una lista de elementos permitidos antes de guardar, y el elemento web vuelve a hacerlo antes de mostrar el contenido. Así, un valor editado directamente en la lista no puede inyectar scripts en la página. - Las personas se almacenan en columnas de personas estándar de SharePoint: el autor y el editor de cada elemento, los usuarios mencionados (
VtxMentions), quienes indican Me gusta (VtxLikedBy) o denuncian (VtxReportedBy), la última persona que respondió (VtxLastReplyBy) y el suscriptor (VtxUser). Una columna de personas hace referencia a la lista de información de usuarios del sitio, no a una copia del perfil. - Los datos de moderación incluyen el estado de aprobación (
VtxApprovalStatus: Approved, Pending o Rejected), el contador de denuncias y quienes las presentaron. - La configuración del foro (
VtxDescription,VtxMode,VtxCategories,VtxRequireApproval) y su título se guardan mediante Configuración del foro, que los moderadores abren desde la barra de comandos. Editar el elemento en Foros de discusión tiene el mismo efecto. Las categorías se almacenan una por línea. - Los contadores (
VtxReplyCount,VtxViewCount,VtxLikeCount,VtxTopicCount) son números actualizados por el elemento web; se pueden corregir en la lista. El contador de visualizaciones aumenta como máximo una vez por sesión del navegador.VtxTopicCounten el elemento del foro aumenta al crear un tema y disminuye al eliminarlo; ambas actualizaciones se intentan sin garantía de éxito, y el valor no se muestra en el elemento web. - El identificador heredado (
VtxLegacyId) conserva el identificador del elemento clásico de Discussion Board desde el que se importó una entrada, para repetir la importación sin duplicados.
Archivos adjuntos e imágenes en el texto
Los archivos que se adjuntan a un tema o una respuesta se almacenan como archivos adjuntos del elemento correspondiente en Temas de discusión o Publicaciones de discusión, en su carpeta estándar de archivos adjuntos de SharePoint. Siguen los permisos del elemento y se eliminan junto con él.
Las imágenes insertadas en el cuerpo de una publicación se cargan en la biblioteca Recursos de discusión. El elemento web crea una carpeta con el año actual (2026, 2027, …) y guarda el archivo con un nombre único formado por una marca de tiempo, un sufijo aleatorio y el nombre original. Así, dos usuarios pueden cargar screenshot.png sin conflictos; las carpetas anuales organizan las imágenes por año. El editor rechaza las imágenes de más de 10 MB. La publicación hace referencia a la imagen por su dirección en la biblioteca, por lo que el lector necesita acceso de lectura a ella, heredado del sitio, para verla.
Cuando el autor o un moderador elimina un tema o una respuesta en el elemento web, tras confirmar la operación, también se eliminan de Recursos de discusión las imágenes insertadas en el texto eliminado. Al eliminar un tema, primero se borran todas sus respuestas, desde las más profundas, y después el tema, junto con las imágenes de todos ellos. No se puede eliminar una respuesta que todavía tenga respuestas anidadas. La limpieza de imágenes se realiza sin garantía de éxito: solo afecta a archivos de Recursos de discusión, un error no detiene la eliminación y una imagen retirada del texto al editar una publicación permanece en la biblioteca.
❗ Importante
Eliminar un archivo de Recursos de discusión no modifica la publicación que lo cita: esta conserva la dirección y muestra una imagen que no se puede cargar. Eliminar un elemento de lista también elimina sus archivos adjuntos. Compruebe por separado si SharePoint permite la recuperación; no se garantiza recuperar los elementos eliminados, los adjuntos y las imágenes.
Qué se almacena en la página
La configuración se conserva en las propiedades del elemento web de la página, como en cualquier elemento web SPFx: el foro seleccionado y su título, los identificadores y direcciones de las listas y las opciones de visualización. Discussions Activity almacena el foro seleccionado, la dirección de su página, el número máximo de elementos y la opción de mostrar el nombre del foro. No se almacena contenido en la caché del navegador ni en el almacenamiento local.
Identidad y permisos
- Cada solicitud es una llamada SharePoint REST o CSOM al sitio de SharePoint correspondiente con el token del usuario que ha iniciado sesión. SharePoint aplica sus permisos a cada llamada; el elemento web solo decide qué botones mostrar (consulte KB10408. Permisos en Discussions: quién puede leer, publicar y moderar).
- El paquete no solicita permisos de API: no aparece nada en Acceso a API del Centro de administración de SharePoint y nunca se llama a Microsoft Graph. Consulte KB10413. Permisos de API y consentimiento del administrador para Discussions. El procedimiento de KB10360. Cómo aprobar los permisos de la API de Microsoft Graph para las soluciones de Vitextra en el centro de administración de SharePoint no es necesario para este producto.
- El selector de personas de las @menciones utiliza la búsqueda de personas estándar de SharePoint del sitio. Si una persona mencionada aún no figura en la lista de información de usuarios, se añade a ella, como ocurre normalmente al rellenar una columna de personas.
- El elemento web no envía correos. Las notificaciones las entrega un flujo de Power Automate que configura el propietario del sitio; consulte KB10414. Cómo funcionan las notificaciones en Discussions: suscripciones, menciones y Power Automate.
El importador de foros clásicos puede leer otro sitio del mismo inquilino. Restaura autores y fechas originales mediante SharePoint CSOM; las demás operaciones de contenido utilizan REST. Todas estas llamadas usan los permisos del usuario que ha iniciado sesión.
Qué se envía fuera del inquilino
| Finalidad | Datos enviados | Destino |
|---|---|---|
| Comprobación de licencia | Identificador del inquilino, identificador de objeto del usuario, dirección del sitio e identificador, nombre y versión del producto | vitextra.com |
| Telemetría de uso | Un evento al cargarse el elemento web (producto y versión, identificador y dirección del sitio, identificador de objeto del usuario, idioma de interfaz y si se ejecuta en Teams), y detalles técnicos de errores | Azure Application Insights |
| Archivos del producto | Una solicitud normal de scripts e iconos de los elementos web | static.vitextra.com, vitextra-storage.azureedge.net |
No se envían foros, temas, respuestas, archivos adjuntos, imágenes, suscripciones ni menciones a Vitextra ni a terceros. El panorama de todos los productos de Vitextra, incluidas las direcciones de red que deben permitirse, se describe en KB10363. Dónde almacenan sus datos los productos de Vitextra: privacidad, residencia de datos y RGPD.
Ciclo de vida de los datos
- Quitar el elemento web de una página deja intactas las listas y su contenido. Vuelva a agregarlo y seleccione el foro existente para continuar.
- Quitar el paquete del catálogo de aplicaciones o del sitio desactiva los elementos web, pero conserva las listas, que siguen siendo legibles en las vistas estándar. Consulte KB10362. Cómo quitar una solución de Vitextra de SharePoint Online y Microsoft Teams.
- Eliminar las listas elimina los foros, temas, respuestas, suscripciones y archivos; pasan a la papelera del sitio.
- La retención, eDiscovery, la auditoría y las etiquetas de confidencialidad se aplican como en cualquier otra lista del sitio.
- La exportación se puede realizar con el comando estándar Exportar a Excel de cada lista o con un flujo de Power Automate; los cuerpos se exportan como HTML.
