teamSendTextMessage

teamSendTextMessage(…)

Cette commande permet d’envoyer un message texte dans une discussion Team à condition que l’utilisateur associé soit un membre de la discussion. Le message accepte la syntaxe markdown.

Pour utiliser cette commande sur VisiaTEAM, il faut inviter l’utilisateur Api JENKINS dans la discussion cible.

Paramètres

  • discussion

    • description : identifiant de la discussion
    • type : String
    • obligatoire : oui
  • message

    • description : texte du message à envoyer. Accepte le Markdown
    • type : String
    • obligatoire : oui
  • clientCredentials

    • description : identifiant associé aux informations du client dans le gestionnaire d’identité
    • type : String
    • obligatoire : non
    • valeur par défaut : '5f15c6e6-45f3-412a-91c3-5605f6f3b61e' (identifiants associés à VisiaTEAM)
  • userCredendials

    • description : identifiant associé aux informations de l’utilisateur dans le gestionnaire d’identité
    • type : String
    • obligatoire : non
    • valeur par défaut : '7aa6cf7e-ba8d-4067-a7be-d3832470736a' (identifiants associés à VisiaTEAM)
  • debug

    • description : activation de la trace détaillée
    • type : Boolean
    • obligatoire : non
    • valeur par défaut : false
  • tenant

    • description : identifiant du tenant Moovapps Team
    • type : String
    • obligatoire : non
    • valeur par défaut : 'visiativ'
    • valeurs disponibles : 'visiativ', 'preview@mechanical'

Pour ajouter de nouvelles définitions de tenant à cette bibliothèque, veuillez contacter l’équipe DevOps

Exemples

Exemple simple ne fonctionnant qu’avec VisiaTEAM (valeurs par défaut)

#!groovy
@Library("team") _

pipeline {
  agent any
  stages {
    stage('notify') {
      steps {
        script {
          def message = 'ceci est un message très **important**'
          teamSendTextMessage discussion: '5ad0a5964cedfd0001c55ae1', message: message
        }
      }
    }
  }
}

Exemple plus complexe fonctionnant avec l’environnement de test de l’équipe Team

#!groovy
@Library("team") _

pipeline {
  agent any
  stages {
    stage('notify') {
      steps {
        script {
          def message = input([
            message: 'Jenkins Team notifier',
            parameters: [string(defaultValue: '', description: '', name: 'Message')]
          ])
          teamSendTextMessage([
            discussion: '5ad599572abece00014814ae',
            message: message,
            debug: true,
            clientCredentials: '20ffac45-9ad2-4734-82d3-e95501e3a36a',
            userCredendials: 'e3826cef-8f24-440e-8f62-4dae398052de',
            tenant: 'preview@mechanical'
          ])
        }
      }
    }
  }
}