MicrosoftFormsからbacklogへの課題起票方法

# 初めに
backlogではメールによる自動的に課題起票できる機能があります。
本記事ではそれを利用し、MicrosoftFormsからbacklogへの自動課題起票方法ついて説明します。

# ■使用ツール
・MicrosoftForms
・PowerAutomat
・backlog
・Outlook

# ■構成図

![2025-04-29_05h09_05.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3934307/4b3a53f7-e1fa-4d22-98c4-0438a4e5a119.png)

# ■MicrosoftForms
#### 【設定手順】
###### 1.新しいフォームをクリックで新規作成

![2025-04-29_05h25_01.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3934307/c835b722-c832-48e6-87fe-769d6cecdf30.png)


###### 2.用途に合わせてタイトルや項目を追加
（今回は作業依頼受付用のフォームを作成します。）

![2025-04-29_05h31_58.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3934307/3e62cc8b-ffac-4ce8-916f-4aa80d2384e7.png)

> 設定した項目は以下です。必須ではない項目に◆つけています。
・会社名​
・氏名​
・環境名​
・件名​
・依頼内容​
・リソース情報​
・関連資料の有無​
　　↳関連資料添付◆​
・緊急度・サービスへの影響​
・対応期日​
・その他補足事項など◆​
・連絡先​
・追加の連絡先の有無​
　　↳追加の連絡先（5件まで）◆

# ■backlog
#### 【設定手順】
###### 1.課題登録用のプロジェクトを作成
以下記事の手順でプロジェクトを作成してください。
[プロジェクトを作成しよう](https://support-ja.backlog.com/hc/ja/articles/360034557094)

###### 2.課題登録用のメールアドレスを取得
以下記事の手順でメールアドレスを発行し、メモしておいてください。あとで使用します。
[メールからBacklogの課題を登録する](https://support-ja.backlog.com/hc/ja/articles/360034367294)

# ■PowerAutomat
大体のフローは以下の通りです。
> フォームが送信される
↓
詳細を取得する
↓
添付画像を取得する
（変数を初期化から条件分岐で画像の有無を判断し取得）
↓
Backlogへ課題登録
↓
自動返信

![2025-04-30_04h43_34.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3934307/2a3b6403-08b5-4348-84e9-22eac589deab.png)

### 【設定手順】
###### 1.自動化したクラウドフローを選択

![2025-04-29_05h56_54.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3934307/9237b96e-77af-40d6-a67d-79a975761cf3.png)

###### 2.新しい応答が送信されるとき（MicrosoftForms）を選択し作成

![2025-04-30_04h17_54.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3934307/addf78d1-1f0a-4159-b882-7710215a6305.png)

###### 3.新しい応答が送信されるときをクリック
・フォームIDは作成したフォームを選択

![2025-04-30_04h22_45.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3934307/94f5fb80-c918-44f0-9bd5-72f6359e3870.png)

###### 4.応答の詳細を取得するを追加
・フォームIDは作成したフォームを選択
・応答IDはフォームの一意識別子を選択

![2025-04-30_04h37_02.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3934307/04168609-7748-47b5-8380-f6f5d8f6fb42.png)

###### 5.変数を初期化するを追加
・Nameは添付ファイル（分かりやすい名前であればなんでも良いです。）
・TypeはArrayを選択

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3934307/05181341-1712-4196-bbf3-174a3ed6291a.png)

###### 6.条件を追加
・条件の真側でJSON の解析を追加
・Contentは関連資料添付を選択
・Schemaは実際に受け取る予定のJSONデータを記入
（実際に受け取るデータのJSONを記入しなければならないため、フォームを送信して実行履歴からデータ内容を確認し、サンプルペイロードを使用してスキーマを生成に張り付けると自動で記入されます。）

![2025-04-30_05h17_03.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3934307/cf9c8d8d-6940-437b-b057-a49b49e450c7.png)

```ruby:今回生成されたSchema
{
    "type": "array",
    "items": {
        "type": "object",
        "properties": {
            "name": {
                "type": "string"
            },
            "link": {
                "type": "string"
            },
            "id": {
                "type": "string"
            },
            "type": {
                "type": [
                    "string",
                    "null"
                ]
            },
            "size": {
                "type": "integer"
            },
            "referenceId": {
                "type": "string"
            },
            "driveId": {
                "type": "string"
            },
            "status": {
                "type": "integer"
            },
            "uploadSessionUrl": {
                "type": [
                    "string",
                    "null"
                ]
            }
        },
        "required": [
            "name",
            "link",
            "id",
            "type",
            "size",
            "referenceId",
            "driveId",
            "status",
            "uploadSessionUrl"
        ]
    }
}
```

###### 7.作成を追加
・入力はBody nameを選択

![2025-04-30_05h34_41.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3934307/1cfbee5b-18b5-4dd6-ad1e-1e9b1c1db7d3.png)

###### 8.パスによるファイル コンテンツの取得を追加
・ファイルパスはフォームに添付されている画像が保存される場所を選択
・コンテンツ タイプの推測ははい

![2025-04-30_05h36_05.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3934307/22122cf7-0e01-4e5c-b409-ff96d636fde8.png)

###### 9.配列変数に追加を追加
・Nameは添付ファイルを選択
・Valueは取得したい値を入力

![2025-04-30_05h42_04.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3934307/157b83f6-ecaa-4dab-9339-f890f04f565c.png)

###### 10.メールの送信（V2）を追加
・名前をBacklog課題登録に変更
・Toは課題登録用のメールアドレスで取得したものを張り付け
・Subjectは課題の件名にしたいものを記入
・Bodyは課題の内容にしたいものを記入

![2025-04-30_05h51_09.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3934307/1d5556ba-cf2f-42cf-b7ac-f5080186a38d.png)

・Attachmentsの配列項目の詳細入力に切り替える→添付ファイルを選択

![2025-04-30_06h00_40.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3934307/1d1ca480-00b3-4377-8e9e-635c30cf1997.png)

###### 11.メールの送信（V2）を追加（おまけ）
・メールでも通知が欲しい場合は追加
・名前を自動返信に変更
・手順10で追加したものと同じ内容で登録

# ■完成するもの
全ての設定が完了してフォームを送信すると以下のような課題が作成されていることが確認できます。
担当者や期限などは適宜設定してください。

![2025-05-05_12h26_50.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3934307/af35e78c-827b-42ae-a0f4-6589d1fb65b4.png)

# ■まとめ
これらを設定することでフォームが送信されると自動で課題が起票できるようになります。
フォームの項目や送信内容を変更することが可能なため、用途に合わせて作り変えてください。
分かりにくいところも多いと思いますが、参考になりましたら幸いです。