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

by MiyakeMito

Slide 1

Slide 1 text

Power Platform の connpassコネクタについて RPACommunity ライトニングトーク大会 vol.5

Slide 2

Slide 2 text

Miyake Mito 気ままに勉強会 https://kimamani.connpass.com/ @MiTo60448639 https://qiita.com/MiyakeMito 株式会社アイシーソフト Technical Manager www.icsoft.jp https://speakerdeck.com/ miyakemito

Slide 3

Slide 3 text

免責事項当スライドは、 2022年10月現在のバージョンでの情報です今後のアップデート等により、仕様変更する可能性があります。また、私の見解による内容が含まれます間違いなどありましたらご指摘ください。

Slide 4

Slide 4 text

注意 connpassコネクタはプレミアムコネクタです。有料ライセンスが必要です。運用環境での使用は許可されていませんが、開発向けプランや開発者テナントであれば無償でお試しいただけます。 ■ 開発者向けプラン https://powerapps.microsoft.com/ja-jp/developerplan/ ■ Microsoft 365 開発者テナント https://developer.microsoft.com/ja-jp/microsoft-365/dev-program

Slide 5

Slide 5 text

本日の参考サイト（ふらりさん）【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

Slide 6

Slide 6 text

connpass コネクタついて

Slide 7

Slide 7 text

connpass コネクタ ◼ connpass API のラッパーです ◼ connpass に登録された、IT勉強会やイベントなどの情報を検索・収集することができます ◼ Power Apps, Power Automate, Logic Apps で、手軽に connpassとデータ連携可能です connpass コネクタ A P I 7

Slide 8

Slide 8 text

8 https://learn.microsoft.com/ja-jp/connectors/connpassip/ connpass コネクタ

Slide 9

Slide 9 text

独立発行者コネクタ (Independent Publisher) 9 ■ 作成したカスタムコネクタを Microsoft 公式コネクタとして認定を受けることが可能 ■ 認定を受けるメリットは以下 – APIを世界中の Power Platform ユーザーに共有され認知される – Microsoft エンジニアチームによるコネクタの検証、品質チェック等 ■ 認定コネクタは、独立発行者、認定（検証済み）発行者の２種類 – コネクタの基盤となるサービスを ➢ 独立発行者：所有していない ➢ 認定発行者：所有している ◼ 認定されたコネクタは、プレミアムコネクタとしてリリースされる https://learn.microsoft.com/ja-jp/connectors/custom-connectors/submit-certification

Slide 10

Slide 10 text

connpass コネクタの使い方

Slide 11

Slide 11 text

リクエスト connpass API リファレンス https://connpass.com/about/api/ イベントのタイトル、キャッチ、概要、住所をAND 条件部分一致で検索します。複数指定可能です OR条件部分一致で検索します。複数指定可能です複数指定時は、キーワードを (カンマ)区切り指定した日付に開催されているイベントを検索します。複数指定可能です（ym：年月 ymd：年月日）指定したニックネームのユーザが参加しているイベントを検索します。複数指定可能です指定したニックネームのユーザが管理しているイベントを検索します。複数指定可能ですグループ毎に割り当てられた番号で、ひもづいたイベントを検索します。複数指定可能ですユーザープロフィール画面のココグループIDは、APIのレスポンスから取得できます 11

Slide 12

Slide 12 text

リクエスト（advanced ） connpass API リファレンス https://connpass.com/about/api/ イベント毎に割り当てられた番号で検索します。複数指定可能です検索結果の何件目から出力するかを指定します。検索結果の表示順を指定します 1: 更新日時順 2: 開催日時順 3: 新着順検索結果の最大出力データ数を指定します。 12

Slide 13

Slide 13 text

レスポンス 13 ◼ 応答の各項目は、動的コンテンツで取得可能ですもちろんなど、ダイレクトに値を取得しても OKです！ body('Search_Events')?['events']?[0]?['title']

Slide 14

Slide 14 text

レスポンス（動的コンテンツ） 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形式)

Slide 15

Slide 15 text

やってみよう

Slide 16

Slide 16 text

connpassコネクタの使い方 DEMOします

Slide 17

Slide 17 text

Power Automate で使用する 17

Slide 18

Slide 18 text

■ 事前構築済(標準)コネクタと変わりなく利用可能 Power Automate で使用する ① Connpass を選択レスポンスを動的コンテンツで取得可能 18 ② Serch Events を選択 ③ パラメータを入力

Slide 19

Slide 19 text

Power Apps で利用する 19

Slide 20

Slide 20 text

■ データに接続＞ 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 コネクタを選択

Slide 21

Slide 21 text

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": "

¥n

イベント概要

¥n

¥nPower Automate を中心に学ぶ「Power Automate Talk支部」¥n

", "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

Slide 22

Slide 22 text

ありがとうございました