Power Platform のconnpassコネクタについて

Transcript

1. Power Platform の connpassコネクタ について RPACommunity ライトニングトーク大会 vol.5
2. Miyake Mito 気ままに勉強会 https://kimamani.connpass.com/ @MiTo60448639 https://qiita.com/MiyakeMito 株式会社アイシーソフト Technical Manager www.icsoft.jp https://speakerdeck.com/ miyakemito
3. 免責事項 当スライドは、 2022年10月現在のバージョンでの情報です 今後のアップデート等により、 仕様変更する可能性があります。 また、私の見解による内容が含まれます 間違いなどありましたらご指摘ください。
4. 注意 connpassコネクタはプレミアムコネクタです。 有料ライセンスが必要です。 運用環境での使用は許可されていませんが、開発向けプランや開発 者テナントであれば無償でお試しいただけます。 ▪ 開発者向けプラン https://powerapps.microsoft.com/ja-jp/developerplan/ ▪ Microsoft 365 開発者テナント https://developer.microsoft.com/ja-jp/microsoft-365/dev-program
5. 本日の参考サイト （ふらりさん） 【Power Automate】connpass のイベントを取得する https://flali.hatenablog.com/entry/2022/08/28/195717 【Power Automate】connpass のイベントを取得する2 (グループ編) https://flali.hatenablog.com/entry/2022/08/29/114341 【Power Automate】connpass のイベントを取得する3 (フィルター編) https://flali.hatenablog.com/entry/2022/08/30/114019 5
6. connpass コネクタ ついて
7. connpass コネクタ ◼ connpass API のラッパーです ◼ connpass に登録された、IT勉強会やイベントなどの情報を検 索・収集することができます ◼ Power Apps, Power Automate, Logic Apps で、手軽に connpassとデータ連携可能です connpass コネクタ A P I 7
8. 8 https://learn.microsoft.com/ja-jp/connectors/connpassip/ connpass コネクタ
9. 独立発行者コネクタ (Independent Publisher) 9 ▪ 作成したカスタム コネクタを Microsoft 公式コネクタとして認定を受けることが可能 ▪ 認定を受けるメリットは以下 – APIを 世界中の Power Platform ユーザーに共有され認知される – Microsoft エンジニアチームによるコネクタの検証、品質チェック 等 ▪ 認定コネクタは、独立発行者、認定（検証済み）発行者の２種類 – コネクタの基盤となるサービスを ➢ 独立発行者：所有していない ➢ 認定発行者：所有している ◼ 認定されたコネクタは、プレミアムコネクタとしてリリースされる https://learn.microsoft.com/ja-jp/connectors/custom-connectors/submit-certification
10. connpass コネクタ の使い方
11. リクエスト connpass API リファレンス https://connpass.com/about/api/ イベントのタイトル、キャッチ、概要、住所をAND 条件部分一致で検索します。複数指定可能です OR条件部分一致で検索します。複数指定可能です 複数指定時は、キーワードを (カンマ)区切り 指定した日付に開催されているイベントを検索しま す。複数指定可能です（ym：年月 ymd：年月日） 指定したニックネームのユーザが参加しているイベ ントを検索します。複数指定可能です 指定したニックネームのユーザが管理しているイベ ントを検索します。複数指定可能です グループ 毎に割り当てられた番号で、ひもづいたイ ベントを検索します。複数指定可能です ユーザープロフィール画面のココ グループIDは、APIのレスポンス から取得できます 11
12. リクエスト（advanced ） connpass API リファレンス https://connpass.com/about/api/ イベント毎に割り当てられた番号で検索します。 複数指定可能です 検索結果の何件目から出力するかを指定します。 検索結果の表示順を指定します 1: 更新日時順 2: 開催日時順 3: 新着順 検索結果の最大出力データ数を指定します。 12
13. レスポンス 13 ◼ 応答の各項目は、動的コンテンツで取得可能です もちろん など、ダイレクトに値を取得しても OKです！ body('Search_Events')?['events']?[0]?['title']
14. レスポンス（動的コンテンツ） 14 動的なコンテンツ名 API レスポンスフィールド 型 説明 Number Of Results results_returned 整数 含まれる検索結果の件数 Maximum number results_available 整数 検索結果の総件数 Start position of search results_start 整数 検索の開始位置 events [ events 配列(複数要素) 検索結果のイベントリスト Event Id event_id 整数 イベントID Title title 文字列(UTF-8) タイトル Catchphrase catch 文字列(UTF-8) キャッチ Description description 文字列(UTF-8) 概要(HTML形式) URL event_url 文字列(UTF-8) connpass.com 上のURL Hashtags hash_tag 文字列(UTF-8) Twitterのハッシュタグ Start started_at 文字列(UTF-8) イベント開催日時 (ISO-8601形式) End ended_at 文字列(UTF-8) イベント終了日時 (ISO-8601形式) Capacity limit 整数 定員 Event Type event_type 文字列(UTF-8) イベント参加タイプ series { series オブジェクト グループ Group Id id 整数 グループID Group name title 文字列(UTF-8) グループタイトル Group URL url 文字列(UTF-8) グループのconnpass.com 上のURL Address address 文字列(UTF-8) 開催場所 Place place 文字列(UTF-8) 開催会場 Latitude lat Float 開催会場の緯度 Longitude lon Float 開催会場の経度 Admin Id owner_id 整数 管理者のID Admin Nickname owner_nickname 文字列(UTF-8) 管理者のニックネーム Admin display name owner_display_name 文字列(UTF-8) 管理者の表示名 Participating Users accepted 整数 参加者数 Waiting Users waiting 整数 補欠者数 Update date updated_at 文字列(UTF-8) 更新日時 (ISO-8601形式)
15. やってみよう
16. connpassコネクタの使い方 DEMOします
17. Power Automate で使用する 17
18. ▪ 事前構築済(標準)コネクタ と変わりなく利用可能 Power Automate で使用する ① Connpass を選択 レスポンスを動的コンテンツで取得可能 18 ② Serch Events を選択 ③ パラメータを入力
19. Power Apps で利用する 19
20. ▪ データに接続 ＞ connpass Power Apps で使用する ① 20 ClearCollect(colevents, 'connpass(IndependentPublisher)'. SearchEvent( {keyword:"RPALT", ym:"2.0", nickname:"matsumitsu"})) 応答（JSONオブジェクト）は コレクションに格納する ① データ > データに追加 検索クエリは [パラメータ]: 値 の形式で列挙する ThisItem.description ThisItem.started_at ThisItem.title ThisItem. catch Items: First(colevents).events Launch(ThisItem.event_url) ② connpass コネクタを選択
21. API のレスポンスボディJSONは複雑なので・・・ Power Apps で使用する ② { "results_start": 1, "results_returned": 8, "results_available": 8, "events": [ { "event_id": 260629, "title": "Power Automate や Power Apps の実験端末を作る方法！", "catch": "マイクロソフト Power Automate を学ぶ大人気イベント！", "description": "<hr>¥n<p><img src=¥"http://comucal.co.jp/wp- content/uploads/2021/09/PowerAutomate202209-connpass01.jpg¥" width=¥"700¥">¥n<br></p>¥n<hr>¥n<h2><span style=¥"font-size: 110%;¥">イベント 概要</span></h2>¥n<p><span style=¥"font-size: 100%;¥">¥nPower Automate を中心 に学ぶ「Power Automate Talk支部」</strong>¥n</span></p>", "event_url": "https://rpacommunity.connpass.com/event/260629/", "started_at": "2022-09-28T19:30:00+09:00", "ended_at": "2022-09-28T21:00:00+09:00", "limit": 130, "hash_tag": "RPALT", "event_type": "participation", "accepted": 120, "waiting": 0, "updated_at": "2022-09-28T19:10:00+09:00", "owner_id": 85304, "owner_nickname": "matsumitsu", "owner_display_name": "Mitz", "place": "オンライン", "address": "オンライン", "lat": null, "lon": null, "series": { "id": 5203, "title": "RPACommunity", "url": "https://rpacommunity.connpass.com/" } }, { お供にいかがですか？ Power AppsでもJSONと仲良くなるために https://qiita.com/MiyakeMito/items/ffc c7639b2813dee77ca JSONの読み解き方 https://speakerdeck.com/miyakemito/j sonfalsedu-mijie-kifang 21
22. ありがとうございました