Discussions Información general
Discussions divide las notificaciones en dos partes. El elemento web registra quién quiere recibir información y sobre qué: mantiene una lista de suscripciones, permite seguir un foro o un tema con una frecuencia elegida y registra a las personas mencionadas en una publicación. El envío de correos queda a cargo de un flujo de Power Automate que el propietario del sitio ejecuta en su propio inquilino. El elemento web nunca envía correos por sí mismo ni solicita el permiso Mail.Send ni ningún otro permiso de Microsoft Graph. Los datos que necesita el flujo están en listas normales de SharePoint del sitio.
Este artículo describe ese contrato: qué garantiza el elemento web en las listas y qué debe hacer un flujo con esos datos.
❗ Importante
La versión 26.10.2 no incluye una plantilla de flujo de Power Automate. El elemento web guarda las suscripciones y menciones como se describe a continuación, pero no se envían correos hasta que exista un flujo en su inquilino. El contrato de este artículo constituye la base para crear ese flujo. Se prevén una plantilla lista para importar y su artículo de configuración para una versión posterior.
Qué hace el elemento web
Seguir un foro o un tema
Los usuarios que pueden publicar (permiso Agregar elementos en el sitio, incluido en Colaborar y Editar) ven un botón Seguir en la barra de comandos del foro y en el encabezado de cada tema. Una pulsación activa el seguimiento con la frecuencia Inmediatamente. La parte desplegable del botón ofrece Inmediatamente, Resumen diario, Resumen semanal y Dejar de seguir. Cuando un usuario sigue un foro o tema, el botón muestra Siguiendo y la frecuencia elegida. El autor de un nuevo tema queda suscrito automáticamente con Inmediatamente. Los visitantes con acceso de solo lectura no disponen del botón porque no pueden escribir en la lista de suscripciones.
Cada suscripción es un elemento de la lista Suscripciones a discusiones, uno por usuario y destino. Volver a seguir el mismo tema con otra frecuencia actualiza el elemento existente en lugar de añadir otro, y Dejar de seguir lo elimina. Por tanto, desactivar las notificaciones significa eliminar las propias suscripciones; no hay una marca independiente para silenciarlas. La guía de usuario se encuentra en KB10404. Seguir foros y temas: suscripciones y frecuencia de los resúmenes.
Menciones
Cuando un usuario escribe @ en el editor y selecciona a una persona, el elemento web inserta en el contenido de la publicación un enlace con el formato <a href="mailto:…" data-mention-id="{siteUserId}">@Name</a> y añade simultáneamente a esa persona a la columna de personas Menciones del tema o la respuesta. La columna es la señal para el flujo: no necesita analizar el HTML para averiguar quién ha sido mencionado. Las menciones se pueden editar junto con la publicación; la columna se reescribe cada vez que se guarda. Consulte KB10403. Usar @menciones en Discussions.
La lista Suscripciones a discusiones
| Columna | Nombre interno | Valor |
|---|---|---|
| Usuario | VtxUser | El suscriptor (columna de personas) |
| Tipo de destino | VtxTargetType | Board o Topic |
| ID de destino | VtxTargetId | Identificador del elemento del foro en Foros de discusión o del elemento del tema en Temas de discusión |
| Frecuencia | VtxFrequency | Immediate, Daily o Weekly |
| Foro | VtxBoard | Columna de búsqueda que hace referencia al foro, también en las suscripciones a temas, para poder consultar todas las suscripciones de un foro con un único filtro |
| Título | Title | Board:{id} o Topic:{id}, para facilitar la lectura en las vistas de lista |
Los valores de las columnas de elección se almacenan en inglés, independientemente del idioma de la interfaz. Los nombres para mostrar de las columnas siguen el idioma de quien creó las listas. La lista reside en el mismo sitio que el foro y hereda sus permisos; por eso se necesitan permisos de publicación para seguirlo.
Eventos a los que responde un flujo
Todos los eventos son eventos normales de elementos de las dos listas de contenido. El flujo utiliza los desencadenadores estándar de SharePoint Cuando se crea un elemento y Cuando se crea o se modifica un elemento.
| Evento | Lista | Condición |
|---|---|---|
| Nuevo tema | Temas de discusión | Elemento creado con Estado de aprobación = Approved |
| Tema aprobado por un moderador | Temas de discusión | Elemento modificado y Estado de aprobación cambiado a Approved |
| Nueva respuesta | Publicaciones de discusión | Elemento creado con Estado de aprobación = Approved |
| Respuesta aprobada | Publicaciones de discusión | Elemento modificado y Estado de aprobación cambiado a Approved |
| Mejor respuesta aceptada | Temas de discusión | Respuesta aceptada cambia de 0 al identificador de una respuesta |
| Mención | Ambas listas | Menciones contiene usuarios |
| Elemento pendiente de moderación | Ambas listas | Elemento creado con Estado de aprobación = Pending |
En un foro sin aprobación, cada elemento nuevo se crea como Approved. En un foro con Requerir aprobación de nuevas publicaciones, los elementos de los miembros se crean como Pending y pasan a Approved cuando un moderador los aprueba. Ese es el momento en que deben recibir el aviso los suscriptores. Los elementos rechazados nunca generan notificaciones.
📝 Nota
El propietario del sitio puede cambiar el nombre de las listas porque el elemento web las reconoce por los identificadores de columna. Por tanto, el flujo debe hacer referencia a las listas por su identificador (GUID), en lugar del título, y leer los valores de las columnas mediante su nombre interno (VtxApprovalStatus, VtxMentions, …).
Quién recibe cada aviso
Las reglas del contrato para los destinatarios son:
- Nuevo tema: los suscriptores del foro, es decir, elementos con Tipo de destino =
Boarde ID de destino = el Foro del tema. - Nueva respuesta: los suscriptores del tema (Tipo de destino =
Topic, ID de destino = el Tema de la respuesta), más los suscriptores del foro al que pertenece ese tema. Se excluye al autor de la respuesta. - Mejor respuesta: el autor de la respuesta aceptada y los suscriptores del tema.
- Mención: los usuarios de la columna Menciones del elemento. Reciben un aviso independientemente de cualquier suscripción y de su frecuencia. La persona mencionada no puede desactivar una mención.
- Pendiente de moderación: los miembros del grupo de propietarios del sitio, que son los moderadores del foro.
Frecuencias
- Immediate: un flujo con el desencadenador Cuando se crea o se modifica un elemento envía un correo por evento a los suscriptores con esta frecuencia.
- Daily y Weekly: un flujo programado recopila los temas cuya Última actividad está dentro del periodo y envía un resumen por suscriptor. Una respuesta actualiza la Última actividad de su tema, de modo que un resumen basado en temas también incluye las respuestas nuevas.
Enlaces en el correo
Un tema se abre mediante la página que aloja el elemento web Discussions, con el parámetro de consulta ?topic={Id}, donde {Id} es el identificador del elemento en Temas de discusión. El elemento web no guarda la dirección de su página en las listas, por lo que esa dirección es un parámetro del flujo. El elemento web Discussions Activity utiliza el mismo enlace directo, descrito en KB10407. Compartir un vínculo a un tema en Discussions (vínculos directos).
Qué debe hacer un flujo
En conjunto, un flujo de envío basado en este contrato:
- se ejecuta en el contexto de un propietario del sitio o un buzón compartido del inquilino; la identidad del remitente es suya, no de Vitextra;
- se desencadena por los eventos de elementos de Temas de discusión y Publicaciones de discusión indicados anteriormente, utilizando el identificador de la lista;
- lee Suscripciones a discusiones, filtrada por Foro (y Tipo de destino / ID de destino), para determinar los destinatarios, y la columna Menciones del elemento para los usuarios mencionados;
- excluye al autor del elemento y evita envíos duplicados a una persona que esté suscrita y mencionada a la vez;
- construye el enlace a partir de su propio parámetro de dirección de página y del identificador del tema;
- para los resúmenes, se ejecuta según una programación y agrupa los temas por suscriptor.
💡 Consejo
Como las suscripciones y menciones son datos de lista normales, el mismo contrato sirve para otros canales además del correo. Un mensaje de chat de Teams o una tarjeta adaptable enviados por el flujo utilizan los mismos destinatarios y el mismo enlace. Solo cambia la acción final del flujo.
