PDF Blocks
料金サポート
無料で始める
ページへ移動

カスタム コネクタを使用する

PDF Blocks コネクタを GitHub からカスタム コネクタとしてインポートし、公開版のコネクタに反映される前にアクションを使用する方法です。

Power Automate で公開されている PDF Blocks コネクタは Microsoft の認定を受けているため、新しいアクションやパラメーターは、当社ではなく Microsoft のレビュー周期に沿って反映されます。コネクタの定義にはすでに含まれているものの、公開版のコネクタにはまだ展開されていない機能(分割・並べ替えアクション、ページの選択、暗号化オプションなど)が必要な場合は、GitHub からインポートして、最新の定義を カスタム コネクタとして自分でインストールできます。

コネクタの定義はオープンソースで、Microsoft の PowerPlatformConnectors リポジトリで公開されています。Power Automate はそこから直接カスタム コネクタを構築できるため、ファイルを手作業でコピーする必要は一切ありません。

カスタム コネクタは単一の Power Platform 環境内にのみ存在し、認定は受けていません。動作は公開版のコネクタとまったく同じです(同じアクション、同じ API キー)が、管理は自分で行う必要があります。後続の更新を取り込むには再インポートしてください。公開版のコネクタが追いついたら、フローを元に戻すことができます。

始める前に

  • 有料の Power Automate プラン(ユーザー単位またはフロー単位)。公開版のコネクタと同じ要件です。
  • 環境内でカスタム コネクタを作成する権限。カスタム コネクタCustom connectors)が表示されない場合は、Power Platform 管理者に問い合わせてください。
  • 接続を作成する際に使う PDF Blocks の API キー。お持ちでない場合ははじめにをご覧ください。

コネクタをインポートする

カスタム コネクタを開く

Power Automate で左側のメニューを展開し、 すべて表示More)を選んでカスタム コネクタを開きます。(Power Apps メーカーポータルの すべて見る → カスタム コネクタ から同じページに移動することもできます。)

GitHub から新しいコネクタを開始する

+ カスタム コネクタの新規作成+ New custom connector)を選択し、 GitHub からインポートするImport from GitHub)を選びます。

カスタム コネクタの新規作成 → GitHub からインポートする。
PDF Blocks コネクタを選択する

GitHub からインポートするダイアログでは、以下を設定します。

  • コネクタの種類Connector Type)を Certified に設定します。これは、 PDF Blocks が置かれているオープンソース リポジトリの認定済みコネクタ フォルダーから読み込まれることを意味します。
  • 分岐Branch)を選択します。必要な更新が含まれる分岐を選んでください (たとえば、最新版なら dev、固定バージョンならリリース用の分岐など)。
  • コネクタConnector)を PDF Blocks に設定します。

続行Continue)を選択します。

Certified の選択、分岐の指定、PDF Blocks コネクタの選択。

インポートする前に正確な定義を確認するには、ダイアログ内の Click here to explore the open source repository リンクを使用してください。

コネクタを作成する

Power Automate がコネクタの定義をエディターに読み込みます。変更は一切不要です。必要であれば 全般General)、セキュリティSecurity)、定義Definition)の各タブを順に確認し、右上のコネクタの作成Create connector)を選択してください。公開版のコネクタと区別できるよう、わかりやすい名前(例:PDF Blocks Next)を付けます。

接続を作成する

カスタム コネクタのアクションをフローに初めて追加すると、Power Automate は公開版のコネクタと同じ接続パラメーター、Connection NameAPI Key、任意項目の Server Hostname の入力を求めます。それぞれの意味については、はじめにをご覧ください。

新しいアクションを使用する

フロー内でアクションを追加し、カスタム コネクタに付けた名前で検索します。公開版のコネクタにまだ含まれていないアクション(PDF をページ数で分割するPDF のページを並べ替えるなど)を含め、他のアクションと並んで表示され、そのまま設定できます。

最新の状態を保つ

カスタム コネクタは、インポート時点での定義のスナップショットです。新しい更新を公開した際は、同じコネクタに対してGitHub からインポートするを繰り返す(または再インポートして作り直す)ことで更新できます。カスタム コネクタと公開版のコネクタは独立しているため、両方をインストールしたままにして、準備が整ったフローから順に移行できます。

関連