El objetivo de este documento es que aparezca un icono anclado en la barra de navegación de la aplicación Microsoft Teams para un sitio de SharePoint que queremos que esté disponible para todos los usuarios de Teams o personas específicas. No importa si son miembros de algún Equipo o Canal. La solución proporcionará a los nuevos usuarios acceso al propio portal del cliente para la formación de equipos antes de que se hayan unido o hayan creado su primer equipo.
1 Controles de la aplicación Teams en la consola de administración
2 Controlar quién puede cargar aplicaciones personalizadas
3 Comprobar qué políticas se aplican a un usuario
4 Control de permisos para aplicaciones de Teams
5 Creación de la aplicación
6 Prueba de la aplicación
7 Empaquetado de la aplicación
8 Subir la aplicación
9 Hacer que la aplicación esté disponible
10 Solución Final
Controles de la aplicación Teams en la consola de administración
Las aplicaciones que aparecen en la barra de aplicaciones de Teams se controlan desde la consola de administración de Teams en el inquilino. Aplicaciones de Teams > Políticas de configuración.
¡ Advertencia ! Si no prepara correctamente a su inquilino con anticipación para cargar una aplicación personalizada, aparecerá el siguiente mensaje más adelante en este documento.
¡ Advertencia ! Si no prepara a su inquilino para permitir que solo ciertas personas carguen aplicaciones personalizadas, todos podrán cargar aplicaciones en su tienda de aplicaciones.
Controlar quién puede cargar aplicaciones personalizadas
- En la página de políticas de configuración de la aplicación, cree una nueva política personalizada.
Elegimos el nombre " Política de carga de aplicaciones ", pero todos pueden usar lo que tenga sentido. En la nueva política, cambie a " ON " la capacidad de cargar aplicaciones personalizadas si su identificación de usuario está asignada a esta política.
- Ignore todas las demás configuraciones y haga clic en " Guardar "
- En la pantalla de política, seleccione la nueva política y haga clic en " Administrar usuarios "
- En la página Usuarios administrados, escriba los nombres de los usuarios a los que desea asignar esta política.
- Cualquier usuario que no forme parte de esta política obtendrá el siguiente error al intentar cargar una aplicación.
¡ Advertencia ! Después de guardar la configuración de esta política, pueden pasar horas hasta que entren en vigencia.
Comprobar qué políticas se aplican a un usuario
- Vaya a la pestaña " Usuarios " en el Centro de administración de Teams
- Busque un usuario al que acaba de aplicar la política en el paso anterior y luego marque la casilla junto al usuario. Esto le permitirá ver cuántas políticas se aplican a este usuario.
- A continuación, puede seleccionar la opción " Editar configuración " para editar la configuración de la política del usuario.
- Busque la opción " Política de configuración de la aplicación " y haga clic en el menú desplegable.
- Verá todas las políticas de configuración de aplicaciones actuales que controlan el acceso de este usuario a las aplicaciones de Teams.
Control de permisos para aplicaciones de Teams
- En la consola de administración de Teams, busque la pestaña " Políticas de permisos " en " Aplicaciones de Teams ".
- Haga clic en el botón " Configuración de la aplicación en toda la organización " para verificar los permisos actuales para usar las aplicaciones de Teams en su inquilino.
¡ Advertencia ! Si el administrador de su inquilino ha establecido las siguientes opciones en verde en " Desactivado ", no puede completar con éxito esta misión de documentos de agregar y usar una aplicación personalizada en Teams.
- A continuación, debemos verificar el permiso de la aplicación de nivel de política si la configuración anterior parecía estar activada.
- En las " Políticas de permisos de la aplicación ", seleccione la " Política global (predeterminada en toda la organización) para su configuración marcando la política y haciendo clic en " Editar "
- El mejor escenario es que el cuadro en verde está configurado para todas las aplicaciones y los usuarios están por debajo de esta política. Es el valor predeterminado y ninguna otra política los restringe de esta configuración.
¡Advertencia! Si el administrador ha modificado el permiso de las aplicaciones predeterminadas a algo que no sea " Permitir todas las aplicaciones ", necesitaremos incluir en la lista blanca nuestra aplicación personalizada al final de este documento y la aplicación " Teams Apps Studio " desde el principio para permitir que los vean. los usuarios en Teams.
- En este punto, nuestra aplicación Portal no se ha creado, por lo que no podemos incluirla en la lista blanca hasta que completemos los pasos de este documento y carguemos la aplicación personalizada en el Catálogo de aplicaciones para inquilinos.
- Asegúrese de guardar los cambios que haya realizado y dé tiempo para que los cambios en las políticas surtan efecto.
Crear la aplicación
Ahora que tenemos preparadas nuestras políticas de aplicación y permisos, estamos listos para crear la aplicación personalizada para mostrar el icono vinculado a nuestro portal de SharePoint en la barra de navegación de la aplicación Teams.
- Inicie sesión en la versión web de Teams o en la versión de escritorio como un usuario que agregamos a la " Política de carga de aplicaciones "
- En Teams, haga clic en el ícono de App Store en la barra de navegación de la aplicación a la izquierda de Teams.
- Cuando se abra la tienda, escriba " App Studio " para ubicar la aplicación que necesitamos instalar para que este usuario cree nuestra aplicación personalizada.
- Haga clic en el botón " Agregar " para instalar la aplicación
- Después de que se abra la aplicación App Studio, haga clic en " Editor de manifiesto "
- En la pestaña del editor de Manifiesto, busque " Crear una nueva aplicación "
- A continuación, verá la siguiente pantalla con muchos campos que debemos completar. Los tomaremos una sección a la vez.
- Detalles de la aplicación ¡ Advertencia ! No ponga " Microsoft " en el nombre. Si hace que el " Nombre corto " sea demasiado largo, se truncará y mostrará una elipse junto al nombre.
En la sección de identificación, debe hacer clic en el botón " Generar " para generar una clave única para esta aplicación. Debes rellenar el “ Nombre del paquete ”. Puede usar cualquier nombre simplemente siga el formato que se muestra arriba. La " Versión " también debe configurarse.
- Descripción ¡ Advertencia ! No pongas " Microsoft " en el nombre
- Información del desarrollador
La información del desarrollador solo identifica quién creó la aplicación y un sitio web para obtener más información sobre el desarrollador. Sugeriría vincular a una página donde las personas puedan obtener más información sobre el desarrollo y el propósito de la aplicación. En este ejemplo, solo señalamos el sitio de SharePoint que inicia el sitio de rutas de aprendizaje en un arrendatario.
La URL de la " Declaración de privacidad " apunta a la declaración de privacidad de Microsoft, ya que este ejemplo utiliza el Portal de rutas de aprendizaje de Microsoft. Los " Términos de uso " solo apuntan a la documentación del Portal de rutas de aprendizaje. Se recomienda que estas URL no apunten a sitios alojados externamente. Durante nuestras pruebas de esta aplicación más adelante, veremos las siguientes advertencias.
Necesitará al menos dos logotipos de la página de marca. Deben ser del tamaño exacto indicado en su descripción. Ahora ha completado todas las opciones en la pestaña " Detalles de aplicaciones ". Ahora vaya a la pestaña " Pestañas " en " Capacidades ".
- Haga clic en " Agregar una pestaña personal "
- En la pestaña Nombre, elija un nombre que aparecerá en la página web del portal como se muestra a continuación.
- Establezca cualquier número de identificación de la entidad.
- La " URL de contenido " que tenemos apunta a nuestro portal de rutas de aprendizaje.
- La " URL del sitio web " que hemos apuntado a nuestro portal de rutas de aprendizaje Haga clic en Guardar.
- Inicio de sesión único de la aplicación web
- El identificador de aplicación de AAD en este ejemplo es para un sitio de SharePoint. El número oficial es 00000003-0000-0ff1-ce00-000000000000 no utilice ningún otro número para este ejemplo.
- La " URL de recurso " debe tener el nombre exclusivo de su arrendatario en lugar de mi " m365x360288 ". Presione Guardar después de completar los campos.
- Ahora hemos completado la configuración de nuestra aplicación personalizada.
Prueba de la aplicación
- Debajo del encabezado " Finalizar " en la aplicación App Studio, seleccione " Probar y distribuir ".
- A continuación, verá la siguiente pantalla con una serie de advertencias. No se preocupe por las advertencias en este caso de uso de ejemplo. En un entorno de producción, querrá seguir la guía de hacer que se transfieran a direcciones URL internas.
- Si no pudo ingresar las cosas correctamente, verá la siguiente advertencia.
- Si hizo todo bien, el instalador de la aplicación aparecerá listo para que lo pruebe y agréguelo a sus equipos. Antes de hacer clic en agregar, revise la información acerca de . Verá cómo se utilizó la información de arriba.
- Después de la instalación de la aplicación, se cargará el Portal de rutas de aprendizaje si funciona.
Empaquetado de la aplicación
- Regrese a la aplicación App Studio haciendo clic en la elipse en la barra de navegación de la aplicación.
- Se abrirá la siguiente ventana que muestra la aplicación " App Studio " y la aplicación " Contoso Learning " que acabamos de agregar a nuestro equipo de usuarios. Haga clic en el icono " App Studio " para reiniciar la aplicación. Seleccione el “ Editor de manifiestos ”
- Busque en " Aplicaciones creadas recientemente " la aplicación " Contoso Learning " y haga clic en ella.
- Haga clic en la pestaña " Probar y distribuir "
- Haga clic en el botón " Descargar " para empaquetar la aplicación para su importación.
- Verá una ventana emergente que indica que el paquete se exportó y su nombre de archivo.
- La ubicación será la carpeta de descargas en la PC. Recuerde esa ubicación para la carga en el Portal de aplicaciones para inquilinos.
Subiendo la aplicación
- Regrese a Teams y busque el ícono de " Aplicaciones " en la barra de navegación de la aplicación
- Si su identificación de usuario tiene el permiso correcto otorgado para cargar una aplicación personalizada, puede hacer clic en " Cargar una aplicación personalizada " en la parte inferior de la lista. Haz click en eso. Luego haga clic para cargar a su Inquilino. No estoy seguro de por qué es un doble clic en Navegar a la carpeta de descargas para ubicar nuestro paquete y hacer clic en " Abrir "
- Si no pudo usar una cuenta que se encuentra en la " Política de carga de aplicaciones " que creamos, verá el siguiente error.
- Si tiene éxito, la aplicación ahora aparecerá en el catálogo de aplicaciones para inquilinos.
- Si busca esta aplicación en el catálogo de aplicaciones y hace clic en Agregar, se instalará la aplicación debajo de los puntos suspensivos como lo hizo en la instalación de prueba. ¡DETÉNGASE! No vamos a instalar la aplicación de esa manera. En su lugar, vamos a anclar la aplicación a la barra de navegación de la aplicación utilizando nuestra " Política de configuración de la aplicación ".
Hacer que la aplicación esté disponible
- Localice la Política de configuración de la aplicación que creamos anteriormente y marque la casilla. Luego haga clic en " Editar "
- En " Aplicaciones ancladas ", haga clic en " Agregar aplicaciones ".
- Busque la aplicación " Aprendizaje ", selecciónela y haga clic en " Agregar ". Luego, haga clic en el botón " Agregar " en la parte inferior para cerrar la pantalla.
- Ahora verá la aplicación sobre cómo aparecerá en la barra de navegación de la aplicación. El valor predeterminado está en la parte inferior; puede resaltar la aplicación y moverla hacia arriba. Si está satisfecho con la posición, haga clic en " Guardar "
Solución final
- Ahora esperamos a que la configuración de la directiva se sincronice en los sistemas back-end de Microsoft 365 antes de ver los resultados de nuestro trabajo. No veremos nuestra nueva aplicación en la barra de navegación de la aplicación durante aproximadamente 2 horas.
- Haga clic en el ícono Nueva aplicación y vea el proyecto terminado.
