Règles d'association#
Associez des outils de chaîne de valeur les uns aux autres.
Les règles de lien définissent la manière dont les outils intégrés sont associés les uns aux autres. Lorsque des outils sont associés, les objets qui apparaissent dans la chaîne de valeur fournissent des informations et des liens aux outils associés. Vous pourriez, par exemple, lier un dispositif de suivi des problèmes à un outil de contrôle des sources.
Pour définir une règle de lien, spécifiez un champ dans l'outil d'origine de la liaison que vous souhaitez associer à un champ dans l'outil de destination de la liaison, ainsi qu'une expression régulière qui définit le pattern correspondant.
L’exemple suivant illustre comment lier une intégration Git à une intégration Pivotal :
- La propriété
"fromIntegrationName": "my-github"
identifie l'intégration Git définie dans la chaîne de valeur. - La propriété
"fromField": "pr.name"
lie le nom de la demande d'extraction Git à l'outil de destination de la liaison. - La propriété
"toIntegrationName": "my-pivotal"
identifie l'intégration Pivotal définie dans la chaîne de valeur. -
La propriété
"toField": "issue.id"
lie l'ID du problème Pivotal à l'outil d'origine de la liaison.Remarque : Le format par défaut du
id
Jira estBoard-Number
. Par exemple, si leissue.id
Jira estJIR-1
et qu'il était en liaison avec une PR via le problème susmentionné parpr.name
, le nom PR doit inclure le texteJIR-1
. -
La propriété
"pattern": "[[A-Z]+-[0-9]+}"
définit l'expression régulière qui détermine si les liens potentiels correspondent.Remarque : La propriété
pattern
utilise regex pour extraire la chaîne souhaitée d'un champ. Les noms PR incluent souvent une description de la PR avec l'identifiant du problème Jira correspondant. Lorsque cela se produit, il est nécessaire de spécifier la valeur defromField
à utiliser pour la liaison. Si la valeur extraite defromField
n'est pas une correspondance exacte avec letoField
, les intégrations ne seront pas liées.
"linkRules": [
{
"toIntegrationName": "my-pivotal",
"toField": "issue.id",
"pattern": "[[A-Z]+-[0-9]+]",
"fromIntegrationName": "my-github",
"fromField": "pr.name",
},
]
Lorsque des liens sont établis, vous pouvez accéder à des informations à propos des outils liés à partir des particules affectées dans la chaîne de valeur. En général, vous pouvez définir des règles d'association pour tous les outils intégrés et définir plusieurs règles d'association dans une chaîne de valeur unique.
Remarque : Pour ajouter des données liées à une chaîne de valeur, vous devez définir des règles d'association pour vos outils intégrés.
Propriété | Description |
---|---|
toIntegrationName | Nom de l'intégration vers laquelle vous effectuez une liaison. |
toField | Champ dans l'intégration toIntegrationName que vous liez. |
schéma | Expression régulière qui détermine si les zones de liaison correspondent. Par exemple, [[A-Z]+-[0-9]+] . |
fromIntegrationName | Nom de l'intégration depuis laquelle vous effectuez une liaison. |
fromField | Champ dans l'intégration fromIntegrationName que vous liez. |
Sujet parent : Intégration d'outils dans des chaînes de valeur