Extensión del escritorio de Conexiones Viva con personalizadores de aplicaciones
La experiencia de escritorio de Conexiones Viva está respaldada por un sitio de SharePoint que se elige como sitio principal en el inquilino de Microsoft 365. Usando los personalizadores de aplicaciones, puede agregar un código personalizado a todas las páginas del sitio.
Usted crea personalizadores de aplicaciones mediante el uso de tecnologías web modernas. Después de que los administradores de SharePoint de su organización los implementen, los personalizadores de aplicaciones se habilitan automáticamente en los sitios seleccionados.
En las secciones siguientes se explican las características más importantes de los personalizadores de aplicaciones que debe tener en cuenta al planear cómo ampliar Conexiones Viva.
Importante
Los personalizadores de aplicaciones solo funcionan con la experiencia de escritorio de Conexiones Viva. No funcionarán en la aplicación móvil Conexiones Viva.
Los personalizadores de aplicaciones no necesitan tener una interfaz de usuario
Los personalizadores de aplicaciones pueden, aunque no es necesario, tener una interfaz de usuario. Puede usar los personalizadores de aplicaciones para agregar código personalizado a cada página del sitio. O en lugar de modificar manualmente cada página, puede construir y habilitar un personalizador de aplicaciones en el sitio que agregará código personalizado a todas las páginas a la vez. Cuando necesite actualizar su código o incluso desactivarlo, podrá hacerlo desde una ubicación central, lo que le ahorrará tiempo.
Dado que los personalizadores de aplicaciones no necesitan tener una interfaz de usuario, son la solución preferida si necesita agregar scripts de análisis a la página o capturar previamente algunos datos de las API. A menos que elija representar una interfaz de usuario, un personalizador de aplicaciones no ocupará espacio en la pantalla.
Precaución
SharePoint, que impulsa Conexiones Viva, expone un conjunto predefinido de puntos de extensibilidad que puede usar para cambiar el aspecto de los sitios y las páginas. Sus clientes pueden pedirle que se salga de estos puntos de extensibilidad y, por ejemplo, cambie la familia de fuentes o reorganice los elementos del menú de la página mediante la manipulación del DOM. ¡No debe hacer eso!
El DOM de una página no es una API. Existe el riesgo de que pueda cambiar en cualquier momento, rompiendo tus personalizaciones sin previo aviso. Al manipular el DOM, también podría romper algunas nuevas características que sus cambios no consideraron.
La interfaz de usuario de un personalizador de aplicaciones se adjunta a un marcador de posición
Cuando cree personalizadores de aplicaciones, puede elegir representar la UI en uno de los marcadores de posición predefinidos. Actualmente, hay dos marcadores de posición disponibles: superior e inferior. El marcador de posición superior aparece entre la barra de navegación de la suite y la navegación del sitio. El marcador de posición inferior aparece al final de la página.
Cuando elige representar una UI en un marcador de posición, obtiene un elemento DOM contenedor que es específico para su personalizador de aplicaciones. Dado que cada personalizador de aplicaciones obtiene su propio elemento DOM, varios personalizadores de aplicaciones pueden representar su interfaz de usuario en el mismo marcador de posición sin sobrescribir el contenido de los demás.
Cuando varios personalizadores de aplicaciones muestran su contenido en un marcador de posición, se apilan en el orden que el desarrollador ha definido. Si es necesario, los administradores del sitio pueden cambiar este orden mediante programación después de habilitar los personalizadores de la aplicación en el sitio.
En lugar de usar un marcador de posición para representar la interfaz de usuario para los personalizadores de la aplicación, puede construir una interfaz de usuario flotante. Una interfaz de usuario flotante es útil si necesita agregar un chat web que flote sobre el contenido de todas las páginas. En lugar de representar el HTML dentro de un marcador de posición, lo agrega al CUERPO de la página y lo hace flotar sobre el contenido de la página utilizando CSS.
Cuando crea la interfaz de usuario para los personalizadores de aplicaciones, usted es el propietario del CSS y el HTML. Considere la posibilidad de usar el lenguaje de diseño de la interfaz de usuario de Fluent para que la solución se integre sin problemas con Conexiones Viva.
Los desarrolladores definen la posición de un personalizador de aplicaciones
Como desarrollador, es usted quien decide si el personalizador de aplicaciones que está creando debe tener una interfaz de usuario o no. Si el personalizador de la aplicación debe tener una interfaz de usuario, usted decide a qué marcador de posición se adjunta.
De forma predeterminada, los editores de contenido no tienen control sobre los personalizadores de aplicaciones. Los administradores de sitios pueden elegir habilitar o deshabilitar un personalizador de aplicaciones, pero no pueden controlar dónde se coloca en la página.
Como desarrollador, puede escribir código personalizado que permita a los propietarios del sitio configurar el personalizador de aplicaciones. Supongamos que crea un personalizador de aplicaciones que muestra un pie de página personalizado. Puede ofrecer a los propietarios de sitios una interfaz de usuario de configuración personalizada para administrar el contenido del pie de página.
Importante
Si quiere proporcionar una interfaz de usuario de configuración para su personalizador de aplicaciones, debe crearla usted mismo. Permitir que sólo los propietarios del sitio administren la configuración, ya que los cambios aparecen en todas las páginas del sitio.
Los administradores de sitio pueden configurar personalizadores de aplicaciones
Los personalizadores de aplicaciones admiten funcionalidades de configuración limitadas. Cuando crea personalizadores de aplicaciones, puede definir propiedades de configuración personalizadas, pero no hay una interfaz de usuario para que los usuarios las configuren. En su lugar, use la API o PowerShell para especificar los valores de estas propiedades.
Las propiedades de configuración de los personalizadores de aplicaciones le permiten parametrizar su solución para poder reutilizarla en diferentes escenarios. Normalmente, estas propiedades se configuran en un script de instalación que se proporciona con la solución.
Recomendación
Considere la posibilidad de crear un personalizador de aplicaciones si desea agregar código a todas las páginas de la experiencia de escritorio de Conexiones Viva. Si la solución no necesita una interfaz de usuario, o si la interfaz de usuario es adecuada para ser mostrada en uno de los marcadores de posición disponibles, cree un personalizador de aplicaciones.
En el siguiente ejercicio, creará un personalizador de aplicaciones que obtiene información de una lista de SharePoint y la muestra en la página en el marcador de posición superior. También probará la solución y la implementará en Conexiones Viva.