Upgrade to Pro — share decks privately, control downloads, hide ads and more …

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

MiyakeMito
October 11, 2022

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

MiyakeMito

October 11, 2022
Tweet

More Decks by MiyakeMito

Other Decks in Technology

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 エンジニアチームによるコネクタの検証、品質チェック 等 ▪ 認定コネクタは、独立発行者、認定(検証済み)発行者の2種類 – コネクタの基盤となるサービスを ➢ 独立発行者:所有していない ➢ 認定発行者:所有している ◼ 認定されたコネクタは、プレミアムコネクタとしてリリースされる 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. ありがとうございました