APIを使ったkintoneとPower Automate for desktopの連携

ホーム
Power Automate for desktop, kintone
APIを使ったkintoneとPower Automate for desktopの連携

Power Automate for desktop

2023.10.30

APIを使ったkintoneとPower Automate for desktopの連携

前回の記事でkintone 開発者ライセンスの取得方法を紹介したので、せっかくなのでkintone REST APIを使ってPower Automate for desktop(PAD)からレコードを登録する方法も紹介します。

事前準備

APIを使ってアプリの操作を行うにあたり、いくつかの事前準備が必要となります。

アプリの設定画面から各フィールドの「フィールドコード」を設定します。

設定タブから「APIトークン」を開きます。

API実行時に必要になるため、「例」行に表示されているURLからアプリのID(下図例の場合は「3」)をメモ帳等にコピーし、「生成する」ボタンをクリックします。

生成されたAPIトークンをメモ帳等にコピーし、アクセス権を設定し(今回はレコードの登録を行うので「レコード追加」にチェック)、「保存」ボタンをクリックします。アクセス権は後から変更することもできます。

「アプリを更新」ボタンをクリックして設定を反映します。

以上で事前準備は完了です。

PADからkintoneアプリのレコードを登録

APIトークンの準備もできたので、いよいよPADからkintoneアプリのレコード登録を行っていきます。今回操作するアプリのフィールド情報は下記の通りです。
(※テストに使用しているアプリのデータは「個人情報テストデータジェネレーター」で作成したダミーデータになります。)

アプリ名：会員情報管理
アプリID：3

フィールド名	フィールドコード	種類
氏名	氏名	文字列（1行）
氏名（ひらがな）	しめい	文字列（1行）
生年月日	生年月日	日付
性別	性別	ラジオボタン
メールアドレス	メールアドレス	リンク
電話番号	電話番号	文字列（1行）
会社名	会社名	文字列（1行）

2023/11/1 追記：
フィールドコードを取得するための簡易的なブックマークレットを作成しました。

2023.11.01

kintoneアプリのフィールドコード一覧を取得するブックマークレット

kintone REST APIを使うときなど、フィールドコードが必要となる場面は多くありますが、フィールドコードを確認するためにわざわざフォームの編集画面を開いてフィールドの設定を開いて…というのは非常に面倒くさいです。そこで、一覧画面のソースコード...

フロー全体

変数の設定

「変数の設定」アクションでAPIトークンを変数(%APIToken%)の値として設定します。
(機密情報としてマークすると良いでしょう。)

変数の設定

「変数の設定」アクションでサブドメイン(URL「https://(サブドメイン).cybozu.com」の左記部分)を変数(%SubDomain%)の値として設定します。
(必要に応じて機密情報としてマークすると良いでしょう。)

数値をテキストに変換

「数値をテキストに変換」アクションでアプリIDを変数(%AppID%)の値として設定します。
このアクションを使うことで、カスタムオブジェクトをJSONに変換した際(後述)にアプリIDが自動的に数値として変換されることを防ぎます。

JSON をカスタムオブジェクトに変換

「JSON をカスタムオブジェクトに変換」アクションでPOSTするパラメーターの元となるJSONをカスタムオブジェクト(%JsonAsCustomObject%)に変換します。

{
  "app": "",
  "record": {
    "氏名": {
      "value": ""
    },
    "しめい": {
      "value": ""
    },
    "生年月日": {
      "value": ""
    },
    "性別": {
      "value": ""
    },
    "メールアドレス": {
      "value": ""
    },
    "電話番号": {
      "value": ""
    },
    "会社名": {
      "value": ""
    }
  }
}