La salida de Microsoft Teams en ArcGIS Velocity le permite enviar tarjetas adaptables a chats o canales en Microsoft Teams.Las tarjetas adaptables pueden contener texto, imágenes y botones, proporcionando un mecanismo interactivo y atractivo para comunicar información.Con Velocity, es posible incluir datos de entidad en la tarjeta adaptable publicada en Microsoft Teams.Se trata de un mecanismo para comunicar información de forma eficaz a los usuarios a través de diferentes sistemas.
Para utilizar este tipo de salida, primero debe generar una dirección URL de webhook en Microsoft Teams. Luego, se utiliza la dirección URL del webhook para configurar la salida de Microsoft Teams en Velocity.
Ejemplo
A continuación se presenta un ejemplo de caso de uso para la salida de Microsoft Teams:
Un analista configura un análisis en tiempo real para publicar una tarjeta adaptable en un canal de Microsoft Teams si se emite una advertencia meteorológica severa que interseque el territorio de servicio de la organización.
Notas de uso
Tenga en cuenta lo siguiente al trabajar con la salida de Microsoft Teams:
- La dirección URL del webhook de Microsoft Teams debe configurarse en Microsoft Teams.
- Al enviar JSON en el cuerpo de una solicitud, este debe tener el formato de tarjeta adaptable de Microsoft Teams. Consulte la siguiente sección para ver ejemplos de JSON.
Ejemplos de JSON de tarjeta adaptable de Microsoft Teams
Al formatear el cuerpo de la solicitud JSON, envuelva el JSON de salida con la función Text() de Arcade para formatear correctamente el JSON. El JSON debe tener el formato de una tarjeta adaptable de Microsoft Teams con las siguientes propiedades:
- El campo type debe estar establecido en message.
- La matriz attachments contiene un conjunto de objetos de tarjeta.
- El campo contentType debe estar establecido en el tipo Adaptive Card.
- El objeto content es la tarjeta formateada en JSON.
Los ejemplos siguientes muestran expresiones de Arcade configuradas para generar tarjetas adaptables en formato JSON. Las tarjetas adaptables resultantes se publican en el chat o canal asociado a la dirección URL del webhook de Microsoft Teams.
En el ejemplo siguiente se crea una tarjeta adaptable básica que muestra información sobre un buque, incluido su nombre e Id.
Ejemplo 1: Tarjeta adaptable básica
// Output is wrapped in Text()
Text({
//type is set to "message":
"type":"message",
//attachments contains an array of card objects:
"attachments":[
{
//contentType is set to "application/vnd.microsoft.card.adaptive":
"contentType":"application/vnd.microsoft.card.adaptive",
"contentUrl":null,
//content is the Adaptive Card formatted in JSON
"content":{
"type": "AdaptiveCard",
"speak": "Vessel Information",
"version": "1.5",
"$schema": "https://adaptivecards.io/schemas/adaptive-card.json",
"body": [
{
"type": "TextBlock",
"text": "Vessel Information",
"wrap": true,
"style": "heading",
"color": "Good"
},
{
"type": "FactSet",
"facts": [
{
"title": "Vessel Name",
"value": $feature.name
},
{
"title": "Vessel ID",
"value": $feature.num
}
]
}]
}
}]
})
En el ejemplo 1 se crea el siguiente mensaje para mostrar información sobre un buque, incluido su nombre e Id.
En el ejemplo siguiente se crea una tarjeta adaptable con una imagen y un botón.
Ejemplo 2: Tarjeta adaptable con imagen y botón
// Output is wrapped in Text()
Text({
//type is set to "message":
"type":"message",
//attachments contains an array of card objects:
"attachments":[
{
//contentType is set to "application/vnd.microsoft.card.adaptive":
"contentType":"application/vnd.microsoft.card.adaptive",
"contentUrl":null,
//content is the Adaptive Card formatted in JSON
"content":{
"type": "AdaptiveCard",
"speak": "New vessel detected",
"version": "1.5",
"body": [
{
"type": "TextBlock",
"text": "New vessel detected at " + $feature.ts,
"wrap": true,
"size": "Large",
"weight": "Bolder",
"color": "Attention"
},
{
"type": "ColumnSet",
"columns": [
{
"type": "Column",
"width": "auto",
"items": [
{
"type": "Image",
"url": "https://www.esri.com/content/dam/esrisites/en-us/common/icons/product-logos/Analytics_for_IoT_220.png",
"width": "24px",
"height": "24px",
"style": "Person",
"altText": "ArcGIS Velocity"
}
],
"verticalContentAlignment": "Center"
},
{
"type": "Column",
"width": "stretch",
"items": [
{
"type": "TextBlock",
"text": "ArcGIS Velocity ",
"wrap": true
}
],
"spacing": "Small",
"verticalContentAlignment": "Center"
}
]
},
{
"type": "TextBlock",
"targetWidth": "AtLeast:Narrow",
"text": "Vessel Name " + $feature.name + ", traveling at " + $feature.speed + " miles per hour, was detected entering the service territory.\n \nClick the link below to see additional information.",
"wrap": true
},
{
"type": "ActionSet",
"actions": [
{
"type": "Action.OpenUrl",
"title": "Open",
"url": "https://www.esri.com/en-us/arcgis/products/arcgis-velocity/overview"
}
]
}
],
"$schema": "https://adaptivecards.io/schemas/adaptive-card.json"
}
}]
})
En el ejemplo 2 se crea el siguiente mensaje sobre un buque recién detectado, e incluye el nombre del buque, la fecha, la hora y un botón para obtener información adicional.
Parámetros
A continuación se presentan los parámetros para la salida de Microsoft Teams:
| Parámetro | Descripción | Tipo de datos |
|---|---|---|
Dirección URL del webhook de Microsoft Teams (Requerido) | La dirección URL del webhook entrante creada en Microsoft Teams. | Cadena de caracteres |
Cuerpo POST (Requerido) | La expresión JSON de Arcade. El JSON debe formatearse utilizando el formato de tarjeta adaptable de Microsoft Teams y envolverse en la expresión Text() de Arcade. | Expresión de Arcade |
| Registro adicional (Opcional) | Si lo desea, puede habilitar el registro de solicitudes y respuestas HTTP sin procesar generadas por Velocity. Nota:Este parámetro solo debe activarse con fines de resolución de problemas y desactivarse cuando la resolución de problemas haya finalizado. Cuando esté activado, inicie el análisis: los registros de nivel de depuración están disponibles en la página de registros de análisis. Si necesita ayuda para solucionar problemas, póngase en contacto con Esri TechnicalSoporte. | Booleano |
Consideraciones y limitaciones
A continuación se indican las consideraciones y limitaciones de uso de esta salida:
- Es importante entender la velocidad de los datos. Cada registro enviado a esta salida genera una solicitud independiente y, si se realizan más de cuatro solicitudes en un segundo, la conexión del cliente puede verse limitada. La mejor práctica es utilizar esta salida para incidentes que se espera que ocurran con poca frecuencia.
- Es importante comprender el mensaje que se envía. El límite de tamaño de mensaje actual es 28 KB. Si el tamaño del mensaje excede este límite, recibirá un error.
Consulte cómo crear webhooks entrantes para obtener más información.