La salida de Slack en ArcGIS Velocity le permite enviar mensajes a canales de Slack. Estos mensajes pueden incluir texto, imágenes y botones, proporcionando una forma interactiva y atractiva de comunicar información.Con Velocity, es posible incluir datos de entidad en el mensaje publicado en un canal de Slack. Se trata de un mecanismo para comunicar información 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 Slack. Luego, se utiliza estaa dirección URL del webhook para configurar la salida de Slack en Velocity.
Ejemplo
Veamos un ejemplo de caso de uso para la salida de Slack:
Un analista configura un análisis de big data programado para procesar un dataset de accidentes de tráfico que se actualiza periódicamente. El analista agrega una salida de Slack al análisis que envía un mensaje a un canal de Slack. Este mensaje proporciona un resumen de estadísticas que incluye el número total de accidentes de tráfico y un desglose de los accidentes por hora del día.
Notas de uso
Tenga en cuenta lo siguiente al trabajar con la salida de Slack:
- La dirección URL del webhook de Slack se configura en Slack.
Más información sobre cómo crear un webhook entrante en Slack
- Al enviar JSON en el cuerpo de una solicitud, ajuste el JSON de salida con la función Text() de Arcade para formatear correctamente el JSON.
Ejemplos de JSON de mensaje de Slack
El ejemplo siguiente crea un mensaje básico de Slack con información sobre el buque.
Ejemplo 1: Mensaje básico de Slack
// Output is wrapped in Text()
Text({
"blocks": [
{
"type": "header",
"text": {
"type": "plain_text",
"text": "Vessel Information",
"emoji": true
}
},
{
"type": "section",
"fields": [
{
"type": "plain_text",
"text": "Vessel Name: " + $feature.name,
"emoji": true
},
{
"type": "plain_text",
"text": "Vessel ID: " + $feature.num,
"emoji": true
}
]
}
]
})
El ejemplo anterior crea el siguiente mensaje de información sobre el buque, e incluye el nombre y el Id. del buque.
El ejemplo siguiente genera un mensaje de Slack con un vínculo y un texto de Markdown.
Ejemplo 2: Mensaje de Slack con un vínculo y texto de Markdown
// Output is wrapped in Text()
Text({
"blocks": [
{
"type": "header",
"text": {
"type": "plain_text",
"text": "New vessel detected at " + $feature.currTime,
"emoji": true
}
},
{
"type": "section",
"text": {
"type": "plain_text",
"text": "Vessel Name " + $feature.name + ", traveling at " + $feature.speed + " miles per hour, was detected entering the service territory.",
"emoji": true
}
},
{
"type": "section",
"text": {
"type": "mrkdwn",
"text": "Click the <https://www.esri.com/en-us/arcgis/products/arcgis-velocity/overview|link> for additional information about this vessel. :boat: "
}
}
]
})
El ejemplo anterior crea el siguiente mensaje de buque recién detectado e incluye el nombre del buque, la fecha y la hora, y un vínculo para obtener más información.
Parámetros
A continuación se indican los parámetros de la salida de Slack:
| Parámetro | Descripción | Tipo de datos |
|---|---|---|
Dirección URL del webhook de Slack (Requerido) | La dirección URL del webhook entrante creada en Slack. | Cadena de caracteres |
Cuerpo POST (Requerido) | La expresión JSON de Arcade. El JSON debe ajustarse con la expresión Text() de Arcade. | Expresión de Arcade |
Registro adicional (Opcional) | 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 separada. Si se realiza más de una solicitud por 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.
Más información sobre los límites de velocidad de los webhooks entrantes
- Es importante comprender el mensaje que se envía. Slack truncará los mensajes que contengan más de 40.000 caracteres, mientras que un valor text simple no debe exceder los 4.000 caracteres.