Módulos de tareas

Los módulos de tareas permiten crear experiencias emergentes modales en la Teams aplicación. En la ventana emergente, puede:

  • Ejecute su propio código HTML o JavaScript personalizado.
  • Mostrar un <iframe> widget basado en, por ejemplo, un vídeo de YouTube o Microsoft Stream.
  • Mostrar una tarjeta adaptable.

Los módulos de tareas son útiles para iniciar y completar tareas o mostrar información enriquecida, como vídeos o paneles de Power Business Intelligence (BI). Una experiencia emergente suele ser más natural para los usuarios que inician y completan tareas en comparación con una pestaña o una experiencia de bot basada en conversación.

Los módulos de tareas se crean sobre la base de Microsoft Teams pestañas. Son esencialmente una pestaña dentro de una ventana emergente. Usan el mismo SDK, por lo que si ha creado una pestaña, ya está familiarizado con la creación de un módulo de tareas.

Los módulos de tarea pueden invocarse de tres maneras:

  • Pestañas de canal o personales: con el SDK Microsoft Teams tabs, puede invocar módulos de tareas desde botones, vínculos o menús de la pestaña. Para obtener más información, vea using task modules in tabs.
  • Bots: usar botones en tarjetas enviadas desde el bot. Esto es útil cuando no se requiere que todos los usuarios de un canal vean lo que está haciendo con un bot. Por ejemplo, cuando los usuarios responden a un sondeo en un canal, no resulta útil ver un registro de esa encuesta que se está creando. Para obtener más información, vea using task modules from Teams bots.
  • Fuera de Teams desde un vínculo profundo: también puede crear direcciones URL para invocar un módulo de tareas desde cualquier lugar. Para obtener más información, vea sintaxis de vínculo profundo del módulo de tareas.

Componentes de un módulo de tareas

Este es el aspecto de un módulo de tareas cuando se invoca desde un bot:

Ejemplo del módulo de tareas

Un módulo de tareas incluye lo siguiente como se muestra en la imagen anterior:

  1. Icono de la color aplicación.

  2. Nombre de la short aplicación.

  3. El título del módulo de tareas especificado en la title propiedad del objeto TaskInfo.

  4. Botón cerrar o cancelar del módulo de tareas. Si el usuario selecciona este botón, la aplicación recibe un err evento. Para obtener más información, vea el ejemplo para enviar el resultado de un módulo de tareas.

    Nota

    Actualmente no es posible detectar el evento cuando se invoca un módulo de err tareas desde un bot.

  5. El rectángulo azul es donde aparece la página web si está cargando su propia página web mediante la propiedad url del objeto TaskInfo. Para obtener más información, vea task module sizing.

  6. Si va a mostrar una tarjeta adaptable mediante la propiedad card del objeto TaskInfo, el relleno se agregará automáticamente. Para obtener más información, vea módulo de tareas CSS para módulos de tareas HTML o JavaScript.

  7. Los botones de tarjeta adaptable se representan después de seleccionar Registrarse. Cuando use su propia página, cree sus propios botones.

Paso siguiente

Consulte también

Tarjetas