Slack

La sortie Slack dans ArcGIS Velocity vous permet d’envoyer des messages à des canaux Slack. Ces messages peuvent inclure du texte, des graphiques et des boutons et constituent un moyen de communiquer des informations de manière interactive et attrayante.  Avec Velocity, les données d’entités peuvent être incluses dans le message publié sur un canal Slack. Il s’agit d’un mécanisme permettant de communiquer des informations aux utilisateurs de systèmes différents. 

Pour utiliser ce type de sortie, vous devez d’abord générer l’URL d’un webhook dans Slack. Cette URL de webhook permet ensuite de configurer la sortie Slack dans Velocity.

Exemple

Voici un exemple de cas d’utilisation de la sortie Slack :

Un analyste configure une analyse Big Data planifiée pour traiter un jeu de données sur les accidents de véhicules qui est mis à jour à intervalles réguliers. L’analyste ajoute une sortie Slack à l’analyse qui envoie un message à un canal Slack. Ce message affiche des statistiques de synthèse, notamment le nombre total d’accidents de véhicule et la répartition des accidents selon l’heure de la journée.

Remarques sur l’utilisation

Tenez compte des points suivants lorsque vous utilisez la sortie Slack :

• L’URL du webhook Slack est configurée dans Slack.

  En savoir plus sur la création d’un webhook entrant dans Slack

• Lorsque vous envoyez le code JSON en tant que corps de requête, englobez la sortie JSON dans l’expression Text() Arcade pour la présenter correctement.

Exemples de messages Slack au format JSON

L’exemple suivant crée un message Slack de base affichant des informations sur les embarcations.

Exemple 1 : message Slack de base

 
// 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 
          } 
        ] 
      } 
    ] 
})

L’exemple ci-dessus crée le message suivant qui est relatif aux informations sur les embarcations. Ce dernier inclut le nom et l’identifiant de l’embarcation concernée.

L’exemple suivant génère un message Slack comportant un lien et un texte au format Markdown.

Exemple 2 : message Slack avec un lien et un texte au format 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: " 
            } 
        } 
    ] 
})

L’exemple ci-dessus crée le message suivant qui est relatif à l’embarcation qui vient d’être détectée. Ce dernier inclut le nom de l’embarcation, la date et l’heure et un lien renvoyant à des informations supplémentaires.

Paramètres

Les paramètres de la sortie Slack sont les suivants :

Paramètre	Description	Type de données
URL du webhook Slack (Requis)	URL du webhook entrant créée dans Slack.	Chaîne
Corps POST (Requis)	Expression Arcade JSON. L’expression Text() Arcade doit englober la chaîne JSON.	Expression Arcade
Journalisation supplémentaire (Facultatif)	Vous pouvez activer la journalisation des requêtes et réponses HTTP au format brut générées par Velocity. Remarque : Ce paramètre ne doit être activé qu’à des fins de dépannage et doit être désactivé une fois le dépannage terminé. Une fois activé, lancez l’analyse. Les journaux de niveau débogage sont disponibles sur la page Journaux d’analyse. Pour obtenir de l’aide dans le cadre du dépannage, contactez le Support technique Esri.	Booléen

Considérations et limitations

Voici les considérations et limitations lors de l’utilisation de cette sortie :

• Il est important de comprendre la vitesse des données. Chaque enregistrement envoyé à cette sortie génère une requête séparée. Si plus d’une requête est émise en une seconde, un risque de congestion de la connexion client est possible. Il est recommandé d’utiliser cette sortie pour les incidents qui ne devraient pas se produire très souvent.

  En savoir plus sur les limites de débit des webhooks entrants

• Il est important de comprendre le message qui est envoyé. Slack tronque les messages qui comportent plus de 40 000 caractères. Une valeur text ne doit pas dépasser plus de 4 000 caractères à elle seule.

  En savoir plus sur la troncature du contenu