GASでAPIを作ってみた

生成AIで、コードは書いてくれるけど、ログを見れるようにするのも含めて、設定のほうがなかなか大変でした。

ChatGPTもGeminiもコードだけでごにょごにょしてくれるので、「あなたのコードはあってるはずだから、書き換えないで。コードがあってる前提で、私が間違っているとしたらどこ見たらいいのか」を聞きまくってたのはよい思い出。

苦戦したやり取りをチェックリストにしてもらいました。

kintone × GAS連携 展開チェックリスト

1. GAS (Google Apps Script) 側の準備

  • [ ] プロジェクトの新規作成
    • 前のアプリの設定と干渉しないよう、新しくプロジェクトを作成する。
  • [ ] コードの書き換え
    • FOLDER_ID を新アプリ専用のフォルダIDに更新したか。
  • [ ] デプロイ(公開)
    • 種類:ウェブアプリ
    • 実行ユーザー:自分
    • アクセス権:全員
    • 重要: 修正後は必ず「デプロイを管理」から 「新バージョン」 を作成して更新しているか。
  • [ ] 初回承認
    • エディタ上で一度「実行」し、自分のGoogleアカウントでドライブへのアクセスを「許可」したか。

2. kintone 側の設定

  • [ ] フィールドコードの照合
    • コード内の定義とアプリのフィールドコードが一致しているか。
  • [ ] JavaScriptのURL更新
    • GAS_URL を、手順1で新しく発行した「ウェブアプリURL」に書き換えたか。
  • [ ] ライブラリとJSの読み込み順
    1. qrcode.min.js(ライブラリ)
    2. kintone_QR-to-GDrive_...js(自作JS)
    3. 上記の順に並んでいるか。
  • [ ] モバイル版への適用
    • 「スマートフォン用JavaScript設定」にもファイルをアップロードしたか。

3. GCPプロジェクトの設定(Google Drive APIの許可とログ取得) ※ログを見たい時のみ必要

  • [ ] プロジェクトの用意
    • Google Cloud Console で、ログ管理用に新しいプロジェクトを作成するか、既存のプロジェクトを選択しているか。
  • [ ] Google Drive API の有効化
    • プロジェクト内の「ライブラリ」から Google Drive API を検索し、「有効にする」 を押したか。(※忘れると実行エラーになります)
  • [ ] OAuth 同意画面の設定
    • 原則、ステータスを 「公開」 にしているか。
    • もし「テスト」のままにする場合は、実行する自分のアドレスが 「テストユーザー」 に登録されているか。
  • [ ] プロジェクト番号の紐付け
    • GASの「設定(歯車)」>「Google Cloud Platform (GCP) プロジェクト」に、選択したGCPの 「プロジェクト番号」 を入力したか。
  • [ ] ログエクスプローラーの確認
    • Cloud Logging で、GASプロセス開始 などのログが表示されるか。

あの時の経験が言葉になった日

今日は、kintone SIGNPOSTについて。

kintone.cybozu.co.jp

kintone SIGNPOSTを初めて読んだのは紙の書籍でした。 その時、涙があふれてきて、自分でも驚きました。 べつに感動する内容の読み物ではないのに。

先日参加したkintone SIGNPOSTランチ雑談会で、誰かが言っていた「経験が言語化されている」。 その言葉を聞いた瞬間、あの時の涙の理由も言語化された気がしました。

自分がやってきたこと、当時どう感じていたのか。 なんとなく覚えている経験が、kintone SIGNPOSTの言葉として表現されていたのです。

パソコンが部署に1台だったころ

思い出されるエピソードはたくさんありますが、自分の中で印象的なものの一つは、新卒で就職した職場でのQC活動のことです。

当時、パソコンが一人1台なく、研究員は実験ノートと手書きのグラフ用紙が基本でした。 グラフはテンプレートで記号を書く、あれです。

これは、ChatGPTに書いてもらったイラスト。まあざっくりそんな感じ。

ワープロ全盛の職場でしたが、私の部署にもパソコンが1台ありました。入社年から考えるとWindows 95。 Excelも入っていましたが、一人で自由に使える環境ではなく、なかなか上達しにくい状況でした。 しかし、私は大学の研究室でMacでExcelを使っていたため、職場の中で圧倒的にExcelに長けており、その部署の定番の少し特殊なレイアウトのグラフをExcelで作ることができました。

そのころ、私は若手研究員として、アシスタントたちとチームを組んでQC活動をしていました。 その取り組みとして、研究員が実験データを既定の用紙に記入(手書き)すると、アシスタントさんがExcelに入力してグラフにする、そんな流れを仕組み化しました。

前のExcelファイルをコピーすれば、いつも同じ形のExcelができる。 入力専用のひな形を用意しておいて、コピーしてから入力するようにすれば、前のデータの削除の手間もない。 そんな工夫をしながら得られた業務改善の効果としては、研究員が手書きでグラフ作成する時間が、アシスタントがExcelに入力する時間に置き換わるというものでした。

そうしてグラフが楽に、きれいに仕上がるようになると、他の研究員もその仕組みでグラフのExcel化をアシスタントに依頼するようになりました。

研究員の手元にあった手書きのノートやグラフ用紙がExcelに置き換わったことで、いつのまにか全員の実験データがひとつのフォルダに集まるようになったのです。

以前は、各自がそれぞれのノートに実験結果を書いているだけで、情報は閉じたまま。 お互いに研究成果が共有しやすくなったとき、その大きな効果に気が付きました。

全員のデータがそろうことで、本人は重要と思わず報告していなかったことが、他の実験と関連して大きなヒントになるといった発見も生まれました。

そうして、

  • 重複や類似の実験が減る
  • 他の人の知見や失敗に触れられる(失敗の情報が貴重)
  • 議論の前提がそろう

といった、「情報がオープンになっていることへの効果」を全員が実感するようになっていきました。

kintone SIGNPOSTの「2-16 オープンな閲覧権限」を読んだとき、その昔の経験が強く思い出されました。

組織内における情報格差が小さくなり、業務の属人化を予防できる。また全文検索による偶発的情報共有が起きることで新たなアイデア創出につながる。

当時は、見せない設定をしていたのではなく、単に物理的に共有が難しかっただけです。 ただ、当たり前だったその壁が壊れて実験データを共有された経験が、「オープンな閲覧権限」の意義をよりはっきりと感じさせてくれました。

言語化できると、経験は誰かの道しるべになる

それまでの私は、「あの時よかったな」という程度の表現しか持っていませんでした。

でも、kintone SIGNPOSTを読んだことで、

  • 自分がやってきたこと
  • なぜうまくいったのか
  • どんな価値が生まれていたのか

が明確な言葉になり、整理されました。こういうことだったんだなあと表現されている感じがうれしくて涙になったのだと思います。

これは思い出と、kintone SIGNPOSTがリンクした経験の一つです。

ほかにも、あの時うまくいった理由、うまくいかなかったわけ、選びそこねた選択肢。 そんな経験を、今の知識と照らし合わせて振り返ることができます。

kintone SIGNPOSTは、先人の経験が言語化されています。 自分の経験を重ねながら読んでみてほしいし、重ねずにはいられない体験をしてほしい本です。

そして、自分の経験もまた、いつか誰かの道しるべになればと願っています。

kintone SIGNPOST勉強会

毎週木曜日のランチタイムに開催されています。 お昼ご飯を食べながら、おしゃべりしている場。おもしろかった体験や、ぐちりたいこと、おしゃべりしている内容を聞いてふと思い出したことをチャット書き込んだりしているなかで、みんなの経験が言語化されるところを体験できる場です。 わたしも参加できる時に参加しています。お気軽にぜひ!

studypost.connpass.com

adventar.org

kintone Café 和歌山 Vol.3 @田辺を開催しました!

5/24開催のkintone Café 和歌山 Vol.3 @田辺、もう終了しましたが、募集ページはこちらでした。
https://kintone-cafe-wakayama.connpass.com/event/335672/

最終的に参加者は22名。県内からは、運営&登壇の和歌山市のまんたにさんに加えて、和歌山市にお勤めの方が2名、新宮市から1名、すさみ町から1名、田辺市内から6名。10カ月ほど前、実際に開催しようと準備を始めたころの「近くで興味がある人なんて誰もいないのではないか…」という思いからすると信じられない、新しい出会いに満ちた回でした。

サムネイル用に写真は湊の交差点のたなべえ。台風の中継の時によくテレビに映ってます。

続きを読む

ブラウザの端っこでマウスをフリフリしてませんか?

「すごくない」kintone その3 Advent Calendar 2024 adventar.org

12/7担当のキミコです。

kinrtoneのアプリの設定画面で、フィールドを掴んで(マウスの左ボタンを押したままの状態で)、矢印キーを押してみてください。
びっくりしました。速くて。
devCampの大阪に行ったときに同席のかたに教えてもらいました。


​kintone Café 和歌山 Vol.2 @田辺を開催しました!

2024年10月19日(土)、​kintone Café 和歌山 Vol.2 @田辺を開催しました!

もう終了しましたが、募集ページはこちらでした。
https://kintone-cafe-wakayama.connpass.com/event/326262/

最終的に参加者は17名。準備当初は、地元の参加者は誰もいないのではないかと思いましたが、最終的に、県内からは和歌山市から3名、新宮市から1名、なんと県の両端から!近隣では、田辺市と白浜町から。また、残念ながらキャンセルとなりましたが、すさみ町のかたからも参加希望をいただいており、関心が高いことを知ることができました。

続きを読む

うわっ・・・私のスクロール多すぎ?

きったんベントカレンダー、その2の10日目担当のキミコです。
ほかのみなさんの記事はこちら!

私からは、今年一番役立っている小技をご紹介します。
私にとっては、kintoneが便利になったけど、kintoneの技じゃない、当たり前ですごくないやつです。

口を抑えてショックを受けている女性のイラスト

ちょっと大きなkintoneアプリを作っているとき、めっちゃスクロールしてませんか?
わたしはしてます。

次世代kintoneを考えよう~愛するがゆえ、物申す~

あれは、9/29、kintone Night Nagoya vol.05 「ありがとうデヂエ記念回:次世代kintoneを考えよう~愛するがゆえ、物申す~」。

note.com

LTは、物申すをテーマに不満大会になるのかと思ったら、意外にも愛するが故、愛あふれる故の、前向きな意欲が満ちる内容です。会場参加者から募集したコメントの紹介コーナーもあり、コメントに対する参加者の知見が持ち寄られた結果、正確な知識として共有されていきます。

そこに投降した私のコメントは・・・

アプリの設定画面でショートカットキーが使いたい!

「Ctrl + s」で「フォームの保存」がしたい

うっかり押すんです。
後悔してるのに、また繰り返す。どうしてもだめなんだ…


「フォームを保存」ボタン、上下のスクロールならついてきてくれますよね。
ありがとうって思うことが断然多いのに、どうしてもっとうまい具合に押せないんだろう。

ショートカット使えるといいよね、という共感の声をもらって、ちょっとうれしくなりました。

つい、htmlで保存する画面が出してしまったときには、裏切られたなんて叫ぶ前に深呼吸をひとつして、「kintoneの改善に協力」で要望しておきましょう。

「アプリの更新」のショートカットも欲しい

保存したら「アプリの更新」。
一番上にしかないの不便じゃないですか。
フィールド数が多いアプリの時、スクロール、めっちゃめんどくさいんです。

こういうことも、口に出して言ってみるもの。
上までぐるぐるスクロールする以外の別解がありました。

「フォームを保存」した後、「F5」でいんじゃね?

by MOVED 加藤さん

た、たしかに・・・

「PageUp」でいいんじゃね?

by kintone エバンジェリスト 石際さん
(2023年show+case unlimited 優勝「TEAM K・F・C」)

おおっ、なるほど・・・

ぐるぐるしたら思い出した

せっかく聞いたキー操作、当日、正確に確認するのを忘れてしまったのですが、言葉一つくらい足りないくらいで全部忘れてしまいそうなことはなく、欲望ならぬボールをぐるぐるした瞬間、思い出しました。
※マウスじゃなくてトラックボールを使っています。

要は、キーボード操作で画面の一番上に戻ればいい。

Windowsなら、先頭までスクロールするなら「Home」キー。末尾までなら「End」キー。1ページずつ上下する「Page Up」「Page Down」。

問題は、私が使っている2台のPCで、Home/End/PageUp/PagaDown系のキーの位置がかなり違うこと。

キーボード操作系の記事をいくつかみてみて、私の手になじんだ新たな解は、「fn + ←」。
「HOME」キーと同じ動作をするようです。「End」キーは「fn + →」です。
2台で似た感じで使えるのがこれだなと。


Macでも同じようなことができます。
Mac のキーボードショートカット - Apple サポート (日本)

fn + 上矢印:page up:1 ページ分上にスクロールします。
fn + 下矢印:page down:1 ページ分下にスクロールします。
fn + 左矢印:home:書類の先頭までスクロールします。
fn + 右矢印:end:書類の末尾までスクロールします。


ショートカットは比較的よく使う派です。
が、WindowsとMacと両方使ってきていて、使い分けないといけないキーボード操作は覚えるのを避けてきていました。
スクロール系の操作は避けてきたあたりです。

でも、「fn + ←」「fn + →」ならいけるかも。
(以降、このあたりの操作を「Home」「End」と表記します)

あなたの適正スクロールは?

「Home」を知って、「アプリの更新」のためのスクロールの量がぐっと減りました。
あわせて「End」も意識できるようになったのが不思議なところ。さらに、スクロール操作が減りました。

なれると、kintone以外の画面でも手が動くようになって、意外にいろんな場面が便利になりますよ。

こうなってくると、なんだかちょっと欲が出てきた感じ。
私のスクロール、もっと少なくてもいいはず。

ほんの少しのすれ違いだけで全部あきらめてしまうのか。
いや、ほんの少しではないと感じたから避けてきたんですけれど。

今回、改めて調べてみると、覚えている以上に、WindowsもMacも類似の操作でできるショートカットキーが増えているような気がします。

いまさら新しく覚えたところで便利になるとも思っていませんでしたが、意外にもこんなに変わることもあるんだなと思いました。

ということで、みなさんも。
さあ見つけるんだ。自分だけのHome。

HOME

HOME

  • アーティスト:B’z
  • Vermillion Records
Amazon

kintone認定システムデザインエキスパート試験(SDE)の受験の記録

2023年8月12日、kintone認定システムデザインエキスパート試験(SDE)を受けました。 ⇒ 受かってました。

今回、申し込み当日は順調だったものの、そのあとプライベートの突発的な出来事があり、申し込んだことを忘れているほどのあわただしさで、毎度毎度の言い訳だらけの準備不足。そんな中でも、気が付いたことがあったのでメモしておきます。あまり、受験対策向けの情報ではありません。

自宅受験

お盆で日程が限られていて、この日の自宅受験しか選べなかったので、初の自宅受験です。

受験場所

帰省の時にしか使われない息子の部屋を使いました。お盆も帰ってこなかったので空いてました。よかった。

PCの事前準備

ピアソンVEUの案内にあるとおりに、PCのチェックを済ませておきます。私の場合は、以前にインストールしていたSpaceDeskというソフトで苦戦しました。アンインストールしても残っているものもあっててこずったので、前日よりももっと余裕のあるタイミングで試しておくのをお勧めします。

受験中

試験中はオンラインでWebカメラ越しに監督してくれています。カメラからずれると注意されます。私の場合、頬づえをついて傾いていくようで、カメラから外れているという警告が出ました。2回目には「次には試験中止になる」というような意味の厳しい文面でした。くたっとなって作業している人はこの点も要注意です。

試験終了

余韻もなくシュッと終わりました。ほんとに余韻がない。間違ったのかと思うくらい。
アンケートがあるようなのでやってみました。まずアカウントを作るところから。アカウントを作った後は、自分でアンケートを作れるような雰囲気の画面でしたが、もともと用意されていたアンケートがどれかわからず、そのまま終了しました。

試験

順序は逆に。

実績登録

今回は前もって作文してました。ちょうど、ジュリドンさんのツイートを見かけました。

客観的な意見がもらえるのは本当に助かります。

あと、ChatGPTに評価観点・評価尺度もおしえて、作文の内容が基準・尺度と照らしてどうか評価させたり、小問1~3で整合性が取れているか指摘をさせてみたのは実用的だと思いました。

でも、当日はちゃんと覚えれてなくて、ちょっと違う感じで改めて書いているので、結局何を提出したのやら。何度書いても、ある程度の質で書けるようにしておきたいものです。

小論文

実績作文の準備で気づいたこと。
KMEとSDEで、それぞれの試験が証明するものや、評価観点・評価尺度や配点を意識してみると、kintone SIGNPOSTをもとにした具体的な記述がしやすくなりそうです。

カイゼンマネジメントエキスパート(Kaizen Management Expert)

kintone認定 カイゼンマネジメントエキスパートは、
チームのための継続的な業務改善を推進することができるスキルがあることを証明します。

システムデザインエキスパート(System Design Expert)

kintone認定 システムデザインエキスパートは、
kintoneを使った業務改善プロジェクトを推進することができるスキルがあることを証明します。

自分の場合は、ちょうどSDEの場合に配点が高いところが、理解が弱いなと実感しました。小論文でも、その部分を意識して思い出しながら書くようにしていたので、時間不足となりました。


受けてみて

自分に足りていないところが客観的にわかるので、それが資格試験を受験するときに好きなところです。

JavaScriptを書く、書かないはあまり関係なくて、kintoneと連携サービスやプラグインを、運用保守まで考えながら構築していて、ユーザー管理もがっつり担当されている方なら、SDEの出題範囲はカバーできるように思います。
なので、現場での業務改善に携わっている方なら、KMEと難易度は変わらないように感じられるのではないかと。構築支援の立場だと、違いがある、KMEのほうが難しく感じるのではないかと思います。

今回、自分に足りない知識がはっきり感じられたけれど、それをいつ埋めるのかは悩むところ。
自分が何をしたいのか、決めていかないとな~。迷いの深まる夏でした。

参考

cybozu.co.jp

↑ 認定資格についての説明と、「最新の出題傾向と評価方法(PDF)をダウンロードする」のPDFは熟読必須。


kintone.cybozu.co.jp

パターン実践ガイドは試験対策にも超便利。用語集は文字数がシビアな中で使いやすい語彙がそろっています。


page.cybozu.co.jp

合格者と語る! kintone 認定 システムデザインエキスパート 徹底解剖
倉林 一範 氏
小堀 範行 氏
南山 寿理 氏

↑ このイベントのレポートは参考になるのではないかと思います。

www.r3it.com

↑ 学び方の基本はここに。

note.com

「実績登録パートから始めて20分で事前準備を完璧に再現する」
これやりたいけどできてません。

www.r3it.com

↑ X(旧Twitter)もあわせて、息をするように勉強する気配や工夫が楽しく感じられる。

他、KMEの対策もそのまま参考になりますよ。

結果

うかってました。