# Enterprise Workbot 用のファイル
ボットコマンドに file パラメータが設定されている場合、エンドユーザーは Enterprise Workbot にファイルをアップロードできます。ファイルはユーザーの OneDrive for Business のストレージにアップロードされ、そのデータは後続のアクションで使用できます。トリガー出力のファイルの部分は以下のようになります。
| 出力項目 | 説明 | 例 |
|---|---|---|
| contentType | ファイルが OneDrive にアップロードされ、ダウンロード可能であることを示します。 | application/vnd.microsoft.teams.file.download.info |
| downloadUrl | ファイルの内容を取得するための OneDrive の URL。HTTP GET を発行して、この URL から直接取得できます。 | https://download.link (opens new window) |
| uniqueId | 一意のファイル ID。OneDrive のドライブアイテム ID になります。 | 1150D938-8870-4044-9F2C-5BBDEBA70C9D |
| contentUrl | SharePoint のファイルへのリンク。 | https://contoso.sharepoint.com/personal/johnadams_contoso_com/Documents/Applications/file_example.txt (opens new window) |
| name | ファイルの名前。 | file_example.txt |
| file_comment | ファイルアップロードの際にユーザーが送信したメッセージ。 | This is an example file upload. |
2021年10月30日より前に作成された Workbot の更新
2021年10月30日より前に作成された Enterprise Workbot では、通常、マニフェストの supportsFiles プロパティが true に設定されていません。更新する方法については、こちらを参照してください。
# 動作の仕組み
ファイルのアップロードを必要とするボットコマンドが呼び出されると、ユーザーはファイルをアップロードするように求められます。
ユーザーへのファイルのアップロードの要求
ファイルがアップロードされたら、ユーザーは必要に応じて、[Send] をクリックする前にメッセージを含めることができます。ファイルのデータは後続のレシピアクションで使用できます。
ボットコマンドには複数のファイルパラメータを定義でき、ユーザーはその都度ファイルのアップロードを求められます。ボットコマンド内でパラメータが指定されている順序にかかわらず、その他のデータ型 (string、date/time など) のパラメータが常に、ファイルパラメータよりも先に取得されます。
# 古いボット用のファイルの有効化
Enterprise Workbot が2021年10月30日より前に作成されたものである場合は、マニフェストの supportsFiles プロパティを true に設定する必要があります。このプロパティについては、マニフェストのリファレンスのボットに関するセクションで解説しています。
ボットの所有者として、Microsoft Teams の開発者ポータル (opens new window)でボットにアクセスします。
左側のナビゲーションバーで、[Configure] の下の [Basic information] を選択します。
メインパネルの [Version] で、バージョンを1つ上げ (たとえば現在のバージョンが 1.0.5 の場合は 1.0.6 に上げ)、スクロールして [Save] をクリックします。
左側のナビゲーションバーで、[Configure] の下の [App features] を選択します。
メインパネルで [Bot] をクリックします。
[What can your bot do?] で [Upload and download files] をチェックし、スクロールして [Save] をクリックします。
左側のナビゲーションバーで、[Publish] の下の [App package] を選択します。階層リンクバー ([Developer Portal] マーキーの真下の) で [Download app package] をクリックして、アプリのマニフェストをダウンロードします。後の手順で使用するため、マニフェストはすぐに使用できるようにしておいてください。
左側のナビゲーションバーで、[Teams apps] の下の [Manage apps] を選択します。
検索バーで名前を入力してボットを検索し、ボットの名前をクリックします (ボットの名前をクリックすると、そのボットの設定が表示されます)。
[Update] をクリックし、上記の手順でダウンロードしたアプリのマニフェストを選択します。
# 詳細
Last updated: 2024/7/25 17:12:40