Customineによるkintoneアプリのカスタマイズでは、「〜した時」「〜する」のように、条件とやりたいことの組み合わせでカスタマイズを構築していきます。


このページは、「実現したいカスタマイズをCustomineでどのように設定すればいいか」、また「やりたいことは分かるが、それをどう設定したらいいか」といった方向けの、全般的なガイドとしてご利用ください。


「やること」とは

「やること」には例えば「フィールドに値をセットする」や「レコードを更新または追加する」のようにレコードを追加更新するものや、「ボタンをメニュー位置に配置する」や「フィールドに吹き出しを設定する」のように見た目に関することなど、様々な「やること」があります。


他にどのような「やること」があるのかは、やることの一覧を確認してみてください。


「条件」とは

条件は例えば「追加画面・編集画面を表示した時」のような「〜した時」、更に追加の条件で例えば「フィールド値が特定の値ならば」のような条件を追加していくことで表現できます。


条件の一覧はこちらにありますのでご確認ください。


レコードとは

レコードとはkintoneアプリで取り扱うデータの1単位で、このレコードを追加 *したり編集 *していくことで、データを共有します(* サイボウズ様のサイトにリンクしています)。


Customineでは、様々なものをレコードとして取り扱うことが可能です。


レコードの取得方法

取得したレコードは絞り込んだり、集計したり、ポップアップに表示して選択させたり、一覧表示したりすることが出来ます。


取得したレコードを絞り込み・集計・表示

絞り込んだり、集計したり、ポップアップで表示しているだけでは、もとのレコードは何も変更されません。

集計結果をフィールドにセットしたり、絞り込んだレコードをテーブルや別アプリに書き出したりすることで、その結果が保存されます。


レコードの追加・いま開いているレコードの更新

レコードを更新する方法は、色々あります。

フィールドに値をセットしてレコードを更新する例として、以下のような記事を公開しておりますので、こちらも参考にしてください。


いま開いているレコード以外を操作する方法としては、例えばレコードを追加したい場合、「レコードを追加する」などがあります。

このように、いま開いているkintoneアプリでも、別のkintoneアプリでも、権限があるアプリであればどのアプリでも追加・更新が可能です。


ただし、この別のレコードを更新するときには、「主キー」という考え方が必要になってきます。


主キーとは : レコードを更新する場合に必要な考え方

主キーとは、kintoneアプリの中で、値がずっと変わらず、同じデータを必ず一意に特定できるような値(フィールド)のことです。一意に特定できれば良いので、できるだけ短いもので、また特に連番である必然性はありません(Customineのアクション番号もそのような性質を持ちます)。


こう書くと、『「レコード番号」で一意に特定できるじゃないか』と思う方もいるかもしれませんが、 レコード番号はキーにはなりません。 なぜかというと、kintone上でレコードを削除して、同じ内容のレコードを作成すると、別のレコード番号が振られます。これでは、同じレコードを一意に特定できているとは言えません。 ですので、例えばkintoneのルックアップの「コピー元のフィールド」にも、レコード番号は使ってはいけません。


顧客管理アプリを例に取ると、「会社名」「電話番号」「メールアドレス」などのフィールドは、統廃合で変わったり、重複する可能性があるのでキーにはなりえません。 これらの代わりに、ずっと変わらずに必ず一意に特定できる値、例えば「顧客ID」のようなフィールドを「必須項目にする」「値の重複を禁止する」設定で用意し、これを主キーとして利用するようにします。


主キーの発行方法について

この「顧客ID」の発行については、Customineであればマスタアプリで「自動採番を行う」などで採番してもいいですし、kintone以外で採番されているのであればそれをCSV出力して同期するなど、業務の運用に沿った方法で発行してください。


別アプリ(自アプリを含む)のレコードを更新

キーがあれば、別アプリ(自アプリを含む)のレコードを更新することが出来るようになります。 まず、いま開いているレコードのフィールドをキーとして、別のレコードを更新したいときには、以下のような「やること」を利用します。

取得したレコードをもとに、別のアプリに書き出したり、レコードを更新したいときには、以下のような「やること」を利用します。

これらの「やること」を使って、別アプリにレコードを追加したり、特定のキーを持つレコードを更新したりすることが可能です。


分からなくなったとき

作成したカスタマイズがうまく動かないときには、いろいろな方法で動かない原因を探し出して、取り除く必要があります。このような作業を「デバッグ」と言います。


デバッグの方法には色々ありますが、まず動作しているカスタマイズの現状を把握することから始めてください。以下にいくつかの方法を挙げておきます。

  • 他のアクションの実行が完了した時」で、意図したアクションの完了を待っているかどうか
  • 動かないアクションが含まれているページ 以外 をすべて「無効」にし、そのページだけで動作を確認する。更にそのページの中で、確認したいアクション 以外 を全て無効にして、動作を確認する
  • 意図したレコードが取得できているかを「レコードの一覧をポップアップで表示する」で表示してみる
  • レコードが更新されない、フィールドにセットされないとき、「情報ダイアログを表示する」でキーや更新しようとしているフィールドの値を表示してみる

これらの方法でもよく分からなかった場合には、チャットサポートまで、お気軽にお問い合わせいただければ幸いです!