Integrate an Automation rule with Microsoft Teams

関連コンテンツ

  • 関連コンテンツがありません

お困りですか?

アトラシアン コミュニティをご利用ください。

コミュニティに質問

robotsnoindex

プラットフォームについて: Server および Data Center のみ。この記事は、Server および Data Center プラットフォームのアトラシアン製品にのみ適用されます。

Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Fisheye および Crucible は除く

This procedure describes how to integrate an automation rule with a Microsoft (MS) Teams channel to show notifications about Jira issues.

Jira から MS Teams チャンネルにメッセージを送信するには、まず Microsoft Teams と Jira 自動化を統合する必要があります。この統合により、自動化が MS Teams チャンネルにメッセージを送信するために使用する Webhook URL が提供されます。この統合はいつでも取り消せます。

MS Teams でワークフローを作成する

Microsoft Teams の統合をセットアップするには、Jira Webhook をリッスンするフロー チェーンを作成する必要があります。

  1. Microsoft Teams にアクセスして 、Jira の通知を送信したいチャンネルを探します。チャンネル名の横にある [その他のオプション] (...) を選択し、次に [ワークフロー] を選択します。

  2. [その他のワークフロー] を選択し、次に [白紙から作成] を選択します。

  3. [Search connectors and triggers (コネクタとトリガーを検索)] フィールドに、「Webhook」と入力します。

  4. [トリガー] で、[When a Teams webhook request is received (Teams Webhook リクエストを受信したとき)] トリガーを選択します。

    1. [Who can trigger the flow (フローをトリガーできるユーザー)] ドロップダウンで [全員] を選択します。

  5. Select New Step, search for Parse JSON, and then select this option under Actions.

    1. [コンテンツ] フィールドに「@{triggerBody()}」と入力します。

    2. In the Schema field, add the following JSON Schema.
JSON スキーマを参照してください 
{
    "type": "object",
    "properties": {
        "summary": {
            "type": "string"
        },
        "sections": {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "activityTitle": {
                        "type": "string"
                    },
                    "activitySubtitle": {
                        "type": "string"
                    },
                    "activityImage": {
                        "type": "string"
                    },
                    "activityText": {
                        "type": "string"
                    },
                    "facts": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "name": {
                                    "type": "string"
                                },
                                "value": {
                                    "type": "string"
                                }
                            },
                            "required": [
                                "name",
                                "value"
                            ]
                        }
                    }
                },
                "required": [
                    "activityTitle"
                ]
            }
        },
        "potentialAction": {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "string"
                    },
                    "targets": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "uri": {
                                    "type": "string"
                                },
                                "os": {
                                    "type": "string"
                                }
                            },
                            "required": [
                                "uri",
                                "os"
                            ]
                        }
                    },
                    "@@type": {
                        "type": "string"
                    }
                },
                "required": [
                    "name",
                    "targets",
                    "@@type"
                ]
            }
        },
        "themeColor": {
            "type": "string"
        },
        "@@context": {
            "type": "string"
        },
        "@@type": {
            "type": "string"
        }
    }
}

6. Select New Step, search for Card, and then select Post message in a chat or channel under Actions. Then:

    1. [Post in (投稿の場所)] ドロップダウンで、[チャンネル] を選択します。

    2. [チーム] と [チャンネル] のドロップダウンで、通知を投稿するチームとチャンネルを選択します。

7. [アダプティブ カード] フィールドに次の JSON を追加します。

JSON スキーマを参照してください 
{
    "type": "AdaptiveCard",
    "body": [
        {
            "type": "ColumnSet",
            "columns": [
                {
                    "type": "Column",
                    "items": [
                        {
                            "type": "TextBlock",
                            "weight": "Bolder",
                            "text": "@{body('Parse_JSON')['sections'][0]['activityTitle']}",
                            "wrap": true
                        }
                    ],
                    "width": "stretch"
                }
            ]
        },
        {
            "type": "TextBlock",
            "text": "@{body('Parse_JSON')['sections'][0]['activityText']}",
            "wrap": true
        },
        {
            "type": "TextBlock",
            "weight": "Bolder",
            "text": "@{body('Parse_JSON')['sections'][1]['activityTitle']}",
            "wrap": true
        },
        {
            "type": "ColumnSet",
            "columns": [
                {
                    "type": "Column",
                    "items": [
                        {
                            "type": "TextBlock",
                            "weight": "Bolder",
                            "text": "@{body('Parse_JSON')['sections'][1]['facts'][0]['name']}",
                            "wrap": true
                        }
                    ],
                    "width": "auto"
                },
                {
                    "type": "Column",
                    "width": "auto",
                    "items": [
                        {
                            "type": "RichTextBlock",
                            "horizontalAlignment": "Right",
                            "inlines": [
                                {
                                    "type": "TextRun",
                                    "text": "@{body('Parse_JSON')['sections'][1]['facts'][0]['value']}"
                                }
                            ]
                        }
                    ],
                    "verticalContentAlignment": "Center"
                }
            ]
        },
        {
            "type": "ColumnSet",
            "columns": [
                {
                    "type": "Column",
                    "items": [
                        {
                            "type": "TextBlock",
                            "weight": "Bolder",
                            "text": "@{body('Parse_JSON')['sections'][1]['facts'][1]['name']}",
                            "wrap": true
                        }
                    ],
                    "width": "auto"
                },
                {
                    "type": "Column",
                    "width": "auto",
                    "items": [
                        {
                            "type": "RichTextBlock",
                            "horizontalAlignment": "Right",
                            "inlines": [
                                {
                                    "type": "TextRun",
                                    "text": "@{body('Parse_JSON')['sections'][1]['facts'][1]['value']}"
                                }
                            ]
                        }
                    ],
                    "verticalContentAlignment": "Center"
                }
            ]
        },
        {
            "type": "ColumnSet",
            "columns": [
                {
                    "type": "Column",
                    "items": [
                        {
                            "type": "TextBlock",
                            "weight": "Bolder",
                            "text": "@{body('Parse_JSON')['sections'][1]['facts'][2]['name']}",
                            "wrap": true
                        }
                    ],
                    "width": "auto"
                },
                {
                    "type": "Column",
                    "width": "auto",
                    "items": [
                        {
                            "type": "RichTextBlock",
                            "horizontalAlignment": "Right",
                            "inlines": [
                                {
                                    "type": "TextRun",
                                    "text": "@{body('Parse_JSON')['sections'][1]['facts'][2]['value']}"
                                }
                            ]
                        }
                    ],
                    "verticalContentAlignment": "Center"
                }
            ]
        }
    ],
    "actions": [
        {
            "type": "Action.OpenUrl",
            "title": "@{body('Parse_JSON')['potentialAction'][0]['name']}",
            "url": "@{body('Parse_JSON')['potentialAction'][0]['targets'][0]['uri']}"
        }
    ],
    "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
    "version": "1.6"
}

8. Verify that the step chain looks like on the screenshot, and then select Save.

9. Copy the webhook URL to the clipboard.

データを送信できるように、Webhook ドメインを許可リストに追加します。そうしないと、Webhook がブロックされる可能性があります。


Webhook URL を Jira に貼り付ける

次のステップは、使用している Jira 自動化のバージョンによって異なります。

設定完了です! Microsoft Teams チャンネルと統合されました。

マークダウンのサポート

Microsoft Team messages support basic markdown for rich formatting. The only limitations are:

  • 画像

  • Inline HTML

  • HTML blocks

  • カスタム ノード

* や # などの特殊文字を文字としてメッセージ中に表示する場合は、文字をエスケープする必要があります。エスケープされていない特殊文字は、マークダウン関数として扱われます。\#\ のように、バックスラッシュで囲むことで文字をエスケープできます。

例

バグが発生したら、Microsoft Teams チャンネルにメッセージを送信します。メッセージ本文は、以下を使用してマークダウン言語でフォーマットされたスマート値を使用しています。

  1. Bold

  2. 斜体

  3. Link

このルールがトリガーされると、Microsoft Teams 内のメッセージは次のように表示されます。

これで完了です。これで、Microsoft Teams で Jira からのメッセージを受信できるようになりました。

最終更新日 2024 年 11 月 4 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する

関連コンテンツ

  • 関連コンテンツがありません
Powered by Confluence and Scroll Viewport.