Personnalisation des notifications de GitHub dans Teams

Vous pouvez personnaliser vos notifications en vous abonnant à l’activité pertinente pour votre canal Microsoft Teams et en désinscrire l’activité qui est moins utile pour votre projet.

Notifications activées par défaut

Les notifications suivantes sont activées par défaut, mais vous pouvez les désactiver à l’aide de la commande @GitHub unsubscribe OWNER/REPO [FEATURE].

Notifications désactivées par défaut

Les notifications suivantes sont désactivées par défaut, mais vous pouvez les activer à l’aide de la commande @GitHub subscribe owner/repo [FEATURE].

Vous pouvez vous abonner ou vous désabonner de plusieurs paramètres à la fois. Par exemple:

• Pour activer l'activité des révisions et commentaires des pull requests, utilisez @GitHub subscribe OWNER/REPO reviews comments.
• Pour désactiver l'activité pour les problèmes et les pull requests, utilisez @GitHub unsubscribe OWNER/REPO issues pulls.

Filtrage des notifications

Vous pouvez personnaliser davantage vos notifications avec des filtres de branche et d’étiquette. Les filtres de branche vous permettent de filtrer les notifications de validation en fonction des noms de branche, tandis que les filtres d’étiquettes vous permettent de filtrer les notifications de problèmes et de propositions de modification en fonction des étiquettes appliquées.

Filtres de branches pour les notifications de validation

Les filtres de branche vous permettent de filtrer les notifications de validation en fonction des noms de branche. Par défaut, lorsque vous vous abonnez à l’événement commits , vous recevez des notifications pour votre branche par défaut. Toutefois, vous pouvez choisir de filtrer sur une branche spécifique, ou un modèle de branches ou de toutes les branches.

Vous pouvez vous désabonner de la fonctionnalité de validations à l’aide de @GitHub unsubscribe OWNER/REPO commits.

Filtres d'étiquettes pour les notifications de problèmes et de demande de tirage

Les filtres d’étiquettes vous permettent de filtrer les notifications en fonction des étiquettes appliquées aux issues et aux pull requests. Lorsqu’un filtre d’étiquette est défini, seules les notifications pour les événements incluant l’étiquette spécifiée sont envoyées. Pour plus d’informations sur les étiquettes, consultez Gestion des étiquettes et Filtrage et recherche de problèmes et de demandes de tirage.

Actuellement, il n’est possible d’avoir qu’un seul filtre d’étiquette requis par référentiel. Le tableau ci-dessous montre quels types d’événements sont affectés par les filtres d’étiquettes.

Création de filtres d’étiquettes

Pour créer un filtre d’étiquette, utilisez le format de commande suivant :

@GitHub subscribe [OWNER/REPO] +label:"YOUR-LABEL"

@GitHub subscribe [OWNER/REPO] +label:"YOUR-LABEL"

Cela crée un filtre d’étiquette obligatoire avec la valeur YOUR-LABEL. Les événements entrants qui prennent en charge les filtres sont ignorés, sauf s’ils ont cette étiquette.

Mise à jour des filtres d’étiquettes

Vous pouvez mettre à jour un filtre d’étiquette existant en spécifiant une valeur NEW-LABEL :

@GitHub subscribe [OWNER/REPO] +label:"NEW-LABEL"

@GitHub subscribe [OWNER/REPO] +label:"NEW-LABEL"

Cela remplace le filtre « YOUR-LABEL » par le filtre « NEW-LABEL ».

Suppression des filtres d’étiquettes

Vous pouvez supprimer un filtre d’étiquette existant à l’aide de la commande de désabonnement avec l’option +label :

@GitHub unsubscribe [OWNER/REPO] +label:"NEW-LABEL"

@GitHub unsubscribe [OWNER/REPO] +label:"NEW-LABEL"

Cela supprime le filtre « NEW-LABEL », et le canal reçoit toutes les notifications pour les événements abonnés sans filtrage d’étiquette.

Affichage des filtres d’étiquettes actifs

Pour afficher les filtres d’étiquettes actuellement actifs pour un canal, utilisez la commande suivante :

@GitHub subscribe list features

@GitHub subscribe list features

Filtres valides

L’application GitHub dans Teams prend en charge les caractères spéciaux les plus courants pour les filtres d’étiquettes, y compris tous les emojis que Teams et GitHub fournissent en tant que standard. Rarement, vous pouvez rencontrer une étiquette qui contient un caractère spécial qui n’est pas supporté. Par exemple, tout caractère multioctet non codé en tant que :foo:, ou les étiquettes utilisant le , caractère peuvent ne pas fonctionner comme prévu.

GitHub Actions notifications de flux de travail

Vous pouvez vous abonner aux GitHub Actions notifications d’exécution de flux de travail à partir de votre canal ou de votre application personnelle à l’aide de la fonctionnalité « workflows », à l’aide du format @GitHub subscribe OWNER/REPO workflows.

Lorsque vous êtes abonné à des « workflows », les fonctionnalités suivantes sont disponibles :

• Vous serez averti lorsqu’une nouvelle exécution de flux de travail est déclenchée.
• Vous pouvez suivre les notifications d’approbation en tant que réponse dans le thread et vous pouvez approuver les notifications directement à partir du canal ou de l’application personnelle.
• Une fois le flux de travail terminé, vous obtenez une mise à jour en tant que réponse dans le thread afin que vous puissiez voir le contexte complet et l’historique de l’exécution du flux de travail.
• En cas d'échec, vous pouvez choisir de réexécuter le workflow sur place et activer les journaux de débogage si nécessaire.

Filtres de notification de flux de travail

Vous pouvez filtrer les notifications de flux de travail à l’aide des options suivantes :

Vous pouvez configurer des filtres de notification de flux de travail au format suivant :

@GitHub subscribe OWNER/REPO workflows:{name:"YOUR-WORKFLOW-NAME" event:"WORKFLOW-EVENT" branch:"BRANCH-NAME" actor:"USERNAME"}

@GitHub subscribe OWNER/REPO workflows:{name:"YOUR-WORKFLOW-NAME" event:"WORKFLOW-EVENT" branch:"BRANCH-NAME" actor:"USERNAME"}

Vous pouvez également passer plusieurs valeurs pour chaque filtre, séparées par des virgules. Par exemple:

@GitHub subscribe OWNER/REPO workflows:{name:"YOUR-WORKFLOW-NAME","ANOTHER-WORKFLOW-NAME" event:"WORKFLOW-EVENT","ANOTHER-WORKFLOW-EVENT" branch:"BRANCH-NAME","ANOTHER-BRANCH-NAME" actor:"USERNAME","ANOTHER-USERNAME"}

@GitHub subscribe OWNER/REPO workflows:{name:"YOUR-WORKFLOW-NAME","ANOTHER-WORKFLOW-NAME" event:"WORKFLOW-EVENT","ANOTHER-WORKFLOW-EVENT" branch:"BRANCH-NAME","ANOTHER-BRANCH-NAME" actor:"USERNAME","ANOTHER-USERNAME"}

Par défaut, lorsque vous configurez des notifications de workflow sans appliquer de filtres, elles sont configurées pour les workflows déclenchés par des pull requests ciblant votre branche par défaut. Vous pouvez passer une ou plusieurs entrées.

Vous pouvez vous désabonner des notifications de flux de travail à l’aide de la commande : @GitHub unsubscribe OWNER/REPO workflows.

Notifications de déploiement

Vous pouvez également configurer des notifications de déploiement distinctes. Ces déploiements peuvent être effectués à partir de GitHub Actions ou de sources externes à l’aide de l’API de déploiement. Consultez « Points de terminaison d’API REST pour les déploiements ».

Vous pouvez vous abonner ou vous désabonner aux notifications de déploiement à l’aide des commandes suivantes :

@GitHub subscribe OWNER/REPO deployments
@GitHub unsubscribe OWNER/REPO deployments

@GitHub subscribe OWNER/REPO deployments
@GitHub unsubscribe OWNER/REPO deployments