Actividad de chat de Microsoft Teams

Introducción

Una actividad de Chat de Microsoft Teams, que utiliza su conexión de Microsoft Teams, recupera un chat existente o crea un nuevo chat en Microsoft Teams y está destinado a usarse como destino para consumir datos en una operación.

Crear una actividad de chat de Microsoft Teams

Se crea una instancia de una actividad Chat de Microsoft Teams desde una conexión de Microsoft Teams utilizando su tipo de actividad Chat.

Para crear una instancia de una actividad, arrastre el tipo de actividad al tela de diseño o copie el tipo de actividad y péguelo en el tela de diseño. Para obtener más detalles, consulte Creación de una instancia de actividad en Reutilización de componentes.

Se puede editar una actividad de Chat de Microsoft Teams existente desde estas ubicaciones:

• El tela de diseño (vea menú de acciones del componente en Lienzo de diseño).
• La pestaña Componentes del panel del proyecto (vea menú de acciones de componentes en la pestañaComponentes del panel Proyecto).

Configurar una actividad de chat de Microsoft Teams

Siga estos pasos para configurar una actividad de Chat de Microsoft Teams:

• Paso 1: Ingrese un nombre y especifique la configuración
  Proporcione un nombre para la actividad y especifique si desea seleccionar un chat existente o crear uno nuevo.

• Paso 2: revise los esquemas de datos
  Se muestran todos los esquemas de solicitud o respuesta generados desde el extremo.

Paso 1: Ingrese un nombre y especifique la configuración

En este paso, proporcione un nombre para la actividad y especifique si desea seleccionar un chat existente o crear uno nuevo. A continuación, se describe cada elemento de la interfaz de usuario de este paso.

La interfaz utilizada en este paso de la configuración de una actividad de Chat de Microsoft Teams depende de las opciones Selección de chat y Crear nuevo chat seleccionadas:

• Seleccionar chat existente: Esta opción completará una lista de chats existentes para elegir.

• Ingresar el ID del chat manualmente: Seleccione esta opción para ingresar manualmente el ID de un chat específico.

• Crear nuevo chat: Seleccione esta opción para crear un nuevo chat en lugar de seleccionar uno existente.

Seleccionar un chat existente

• Nombre: Ingrese un nombre para identificar la actividad. El nombre debe ser único para cada actividad de Chat de Microsoft Teams y no debe contener barras diagonales. /o dos puntos :.

• Selección de chat: Elige una de las dos formas de identificar el chat que estás buscando: Seleccionar chat existente o Ingresar ID de chat manualmente. Si quieres crear un nuevo chat, desplázate hacia abajo más allá de la lista de chats existentes y haz clic en Crear nuevo chat.

• Seleccionar un chat: Esta sección muestra los chats disponibles en el extremo de Microsoft Teams.

  • Chat seleccionado: Después de seleccionar un chat, su tipo e identificador se enumeran aquí.

  • Buscar: Ingrese el valor de cualquier columna en el cuadro de búsqueda para filtrar la lista de chats. La búsqueda no distingue entre mayúsculas y minúsculas. Si los chats ya se muestran dentro de la tabla, los resultados de la tabla se filtran en tiempo real con cada pulsación de tecla. Para volver a cargar los chats desde el extremo al realizar una búsqueda, ingrese los criterios de búsqueda y luego actualice, como se describe a continuación.

  • Actualizar: Haga clic en el ícono de actualización o la palabra Actualizar para volver a cargar los chats desde el extremo de Microsoft Teams. Esto puede resultar útil si se han agregado chats a Microsoft Teams. Esta acción actualiza todos los metadatos utilizados para crear la tabla de chats que se muestra en la configuración.

  • Selección de un chat: Dentro de la tabla, haga clic en cualquier parte de una fila para seleccionar un chat. Solo se puede seleccionar un chat. La información disponible para cada chat se obtiene del extremo de Microsoft Teams:

    • Tipo de chat: El tipo de chat (como Grupo o Uno a Uno) y el identificador del chat.

    • Descripción: La descripción del chat, que consta del tema del chat y una lista de miembros del chat.

  Consejo

  Si la tabla no se completa con los equipos disponibles, la conexión de Microsoft Teams puede no funcionar correctamente. Asegúrese de estar conectado volviendo a abrir la conexión y volviendo a probar las credenciales.

• Crear nuevo chat: De forma predeterminada, esta opción no está seleccionada y la actividad permite la selección de un chat existente.

• Guardar y salir: Si está habilitado, haga clic para guardar la configuración de este paso y cerrar la configuración de la actividad.

• Siguiente: Haga clic para almacenar temporalmente la configuración de este paso y continuar con el siguiente. La configuración no se guardará hasta que haga clic en el botón Finalizado en el último paso.

• Descartar cambios: Después de realizar cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le solicitará que confirme que desea descartar los cambios.

Ingresar el ID del chat manualmente

• Nombre: Ingrese un nombre para identificar la actividad. El nombre debe ser único para cada actividad de Chat de Microsoft Teams y no debe contener barras diagonales. /o dos puntos :.

• Selección de chat: Elige una de las dos formas de identificar el chat que estás buscando, ya sea Seleccionar chat existente o Ingresar ID de chat manualmente. Si quieres crear un nuevo chat, desplázate hacia abajo más allá del siguiente campo y haz clic en Crear nuevo chat.

• ID de chat: ingresa el identificador del chat.

  Consejo

  Campos con un ícono de variable admite el uso de variables globales, variables del proyecto y variables Jitterbit. Comience escribiendo un corchete abierto [ en el campo o haciendo clic en el icono de la variable para mostrar una lista de las variables existentes para elegir.

• Crear nuevo chat: De forma predeterminada, esta opción no está seleccionada y la actividad permite la selección de un chat existente.

• Guardar y salir: Si está habilitado, haga clic para guardar la configuración de este paso y cerrar la configuración de la actividad.

• Siguiente: Haga clic para almacenar temporalmente la configuración de este paso y continuar con el siguiente paso. La configuración no se guardará hasta que haga clic en el botón Finalizado en el último paso.

• Descartar cambios: Después de realizar cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le solicitará que confirme que desea descartar los cambios.

Crear un nuevo chat

• Nombre: Ingrese un nombre para identificar la actividad. El nombre debe ser único para cada actividad de Chat de Microsoft Teams y no debe contener barras diagonales. /o dos puntos :.

• Crear nuevo chat: De manera predeterminada, esta opción no está seleccionada y la actividad permite seleccionar un chat existente. Seleccione esta opción para crear un nuevo chat. Si la selecciona, estarán disponibles las siguientes opciones.

• Tipo de chat: Seleccione entre Uno a Uno y Grupo como el tipo de chat que se creará.

  • Tema: Si se seleccionó un chat grupal, se puede ingresar un tema para el chat.

• Proporcionar Correo y rol: Proporcione correos de los miembros del chat, ya sea como una lista separada por comas o como una tabla:

  • Si utiliza Proporcionar Correos separados por comas mediante el campo de texto:

    • Correo: Ingrese una lista separada por comas de direcciones de correo de los miembros que se incluirán en el canal.
    • Rol de propietario: Si se selecciona, a todos los miembros agregados al canal se les asignará el rol de_propietario_. Está seleccionado de manera predeterminada. Si se requieren diferentes roles para diferentes miembros, use el método de entrada de tabla.

    

  • Si usa Proporcionar Correos mediante la tabla, use los controles para agregar y eliminar entradas de la tabla.

    • Correo del usuario: Ingrese una dirección de correo de un miembro que se incluirá en el canal.
    • Rol del usuario: Ingrese un rol para el miembro. De manera predeterminada, a todos los miembros agregados al canal se les asignará el rol de_propietario_.

    

    Consejo

    Campos con un ícono de variable admite el uso de variables globales, variables del proyecto y variables Jitterbit. Comience escribiendo un corchete abierto [ en el campo o haciendo clic en el icono de la variable para mostrar una lista de las variables existentes entre las que elegir.

    Importante

    Los campos de la tabla Correos muestran el ícono de variable solo en modo de edición. Para que los valores de las variables de estos campos se completen en tiempo de ejecución, la versión del agente debe ser al menos 10.75 / 11.13.

• Guardar y salir: Si está habilitado, haga clic para guardar la configuración de este paso y cerrar la configuración de la actividad.

• Siguiente: Haga clic para almacenar temporalmente la configuración de este paso y continuar con el siguiente paso. La configuración no se guardará hasta que haga clic en el botón Terminado en el último paso.

• Descartar cambios: Después de realizar cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le solicitará que confirme que desea descartar los cambios.

Paso 2: Revisar los esquemas de datos

Se muestran todos los esquemas de solicitud o respuesta generados desde el extremo. A continuación, se describe cada elemento de la interfaz de usuario de este paso. Los esquemas de datos de solicitud y respuesta que se muestran dependen de si especificó seleccionar un chat existente o Crear nuevo chat en el paso 1.

Si especificó seleccionar un chat existente, se muestran estos esquemas de datos:

Si especificó crear un nuevo chat, se muestran estos esquemas de datos:

• Esquemas de datos: Estos esquemas de datos son heredados por transformaciones adyacentes y se muestran nuevamente durante el mapeo de transformación.

  Nota

  Los datos suministrados en una transformación tienen prioridad sobre la configuración de la actividad.

  El conector de Microsoft Teams utiliza la API REST de Microsoft Graph v1.0. Consulte la documentación de la API para obtener información sobre los nodos y campos del esquema.

• Actualizar: Haga clic en el ícono de actualización o la palabra Actualizar para regenerar esquemas desde el extremo de Microsoft Teams. Esta acción también regenera un esquema en otras ubicaciones en todo el proyecto donde se hace referencia al mismo esquema, como en una transformación adyacente.

• Editar: Haga clic en el ícono de edición sobre cada esquema de datos para ingresar al editor de ese esquema de datos. El editor le permite agregar, eliminar y reorganizar nodos y campos y cambiar sus tipos de datos. Todos los nodos y campos agregados recientemente se configuran en [0, 1]cardinalidad. Los cambios realizados en los esquemas de datos deben ser aceptables para el extremo y deben realizarse solo después de consultar la documentación disponible para el extremo.

• Atrás: Haga clic para almacenar temporalmente la configuración de este paso y regresar al paso anterior.

• Terminado: Haga clic para guardar la configuración de todos los pasos y cerrar la configuración de la actividad.

• Descartar cambios: Después de realizar los cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le solicitará que confirme que desea descartar los cambios.

Próximos pasos

Después de configurar una actividad de Chat de Microsoft Teams, complete la configuración de la operación agregando y configurando otras actividades, transformaciones o secuencias de comandos como pasos de la operación. También puede configurar los ajustes de la operación, que incluyen la capacidad de encadenar operaciones que se encuentran en el mismo flujo de trabajo o en flujos de trabajo diferentes.

Se puede acceder a las acciones del menú de una actividad desde el panel del proyecto y el tela de diseño. Para obtener más información, consulte menú de acciones de la actividad en Conceptos básicos del conector.

Las actividades de Chat de Microsoft Teams se pueden usar como destino con estos patrones de operación:

• Patrón de Transformación
• Patrón de dos transformaciones (como primer o segundo objetivo)

Para utilizar la actividad con funciones de script, escriba los datos en una ubicación temporal y luego use esa ubicación temporal en la función de script.

Cuando esté listo, desplegar y ejecute la operación y validar el comportamiento comprobando los registros de operación.