Customineを使うと、保存したレコードの内容を自動的に他のアプリに転記したり、表示しているアプリのレコードに別アプリのテーブルを書き出す、など「レコード」に関連するカスタマイズを簡単に作成することが出来ます。


ただ、レコードに関する「やること」には様々なものがあるので、どれを利用したらいいか迷ってしまうケースもあるかと思います。


このページでは、レコードの追加および更新に注目してどの「やること」を利用すればいいかの判断基準をご紹介します。


なお「そもそもレコードとは?」という方には、カスタマイズの考え方のヒント・ガイドを、先に一読されることをお勧めします。


レコードの追加および更新に関する「やること」

レコードの追加および更新に関する「やること」の一覧はこちらになります。

やること

更新対象レコード
指定方法

追加・更新

レコードを追加する

なし

追加

テーブルデータをセットしたレコードを追加する

なし

追加

レコードを更新する(キーの値をフィールドで指定) 

キー指定(フィールド)

更新

レコードを更新する(キーの値を直接指定) ※

キー指定(直接指定)

更新

レコードをもとに別のレコードを更新する

キー指定(フィールド)

更新

レコードを指定アプリのテーブルに書き出す

キー指定(直接指定)

更新

レコードを更新または追加する(キーの値をフィールドで指定)

キー指定(フィールド)

追加 or 更新

レコードを更新または追加する(キーの値を直接指定)

キー指定(直接指定)

追加 or 更新

レコードをもとに別のレコードを更新または追加する

キー指定(フィールド)

追加 or 更新

レコードを書き出す

レコード指定

追加 or 更新

レコードを1つずつ書き出す

レコード指定

更新(Webhook用)

テーブル付きでレコードを書き出す

レコード指定

追加 or 更新

テーブル付きでレコードを1つずつ書き出す

レコード指定

更新(Webhook用)

テーブル行を別アプリのレコードへ書き出す

なし

追加


※「レコードを更新する(キーの値をフィールドで指定)」と「レコードを更新する(キーの値を直接指定)」はほぼ同じですが、キーの値をフィールドで指定する点が異なります。特に、テーブルの各行に対してアクションを実行したい場合は、「レコードを更新する(キーの値をフィールドで指定)」を使用します。


これらの「やること」は「更新対象レコード指定方法」と「追加するか、更新するか」によって使い分けることが出来ます。


「追加・更新」については、その「やること」が次のうちどの処理を行えるのかを表記しています。

  • レコードの追加

  • レコードの更新

  • レコードの追加または更新


また、「更新対象レコード指定方法」については次の項にて解説します。


「更新対象レコード指定方法」とは?

「更新対象レコード指定方法」では、レコードを更新する「やること」を使用する場合に、更新するレコードをどのように指定するかを次のいずれかで表しています。

  • キー指定(フィールド)

  • キー指定(直接指定)

  • レコード指定


それぞれについて、詳細をみていきましょう。


キー指定(フィールド)

キー指定(フィールド)は更新対象のレコードを検索する際のキーの値を、カスタマイズ中のアプリのフィールドで指定する方法です。


この指定方法に当てはまる「やること」としては「レコードを更新する(キーの値をフィールドで指定) 」などがあります。


なお、これらの「やること」では次のようなカスタマイズが作成できます。

  • カスタマイズしているアプリの、現在編集(表示)しているレコードの

  • あるフィールドの値を利用して

  • 別アプリまたはこのアプリのレコードを更新する


また具体的には、次のような処理が実現できます。

  • 顧客IDというフィールドを持つ「問合せ管理」アプリを開いていてレコードを保存した時に、

  • そのレコードの顧客IDフィールドの値を使って、

  • 「顧客」アプリの「キーとなる更新先のフィールド」の値と一致したレコードを更新する


キー指定(直接指定)

キー指定(直接指定)は更新対象のレコードを検索する際のキーの値を、直接指定する方法です。この方法では、キーの値を任意に指定したレコード更新が可能になります。


例えば、フィールドに保存されている値やそれらを結合した結果、今日の日付、ログインユーザー、他のアクションの結果など、どのような値でもキーに利用することができます。


その分、各アプリでのキーの持ち方や作成方法はよく検討する必要があります。

また、利用者の権限では見えないフィールドやアプリの情報は、キーの作成には利用できないのでご注意下さい。


なお、この指定方法に当てはまる「やること」としては「レコードを更新する(キーの値を直接指定) 」などがあります。


これらの「やること」を利用すると、次のようなカスタマイズが作成できます。

  • カスタマイズしているアプリを開いている利用者の権限で

  • 更新するキーの値を指定(作成)し

  • 別アプリまたはこのアプリのレコードを更新する


また具体的には、次のような処理が実現できます。

  • 申請書IDというフィールドを持つ「予算申請」アプリを開いていて、

  • 今日の日付と申請書IDを次のような式でキーに指定し、

    • = today() & 申請書ID

  • 「利用実績」アプリにレコードを追加または更新する


レコード指定

レコード指定は、更新対象のレコードとして、レコードを取得するアクション(例えば「条件を組み立ててレコードを取得する」など)で取得したレコードを指定する方法です。


レコードを取得する「やること」は、これ以外にも「テーブル行をレコードとして取得する」や「一覧で選択されたレコードを取得する」、「関連レコード一覧の条件でレコードを取得する」など、色々な種類があります。


このように、Customineではテーブルや関連レコードなど、様々なものをレコードとして取り扱うことが可能です。これを利用して取得したレコードをそのまま、もしくは値を書き換えながら、別のアプリや同じアプリに書き出すことができます。


ただし、利用者の権限では取得できないレコードについては、書き出し元として取得できないことに注意して下さい。


なお、この指定方法に当てはまる「やること」としては「レコードを書き出す」などがあります。


これらの「やること」を利用すると、次のようなカスタマイズが作成できます。

  • カスタマイズしているアプリを開いている利用者の権限で

  • 書き出しに必要な情報を持つアプリからレコードを取得し

  • そのレコードをそのまま、もしくは値を書き換えながら

  • 別アプリまたはこのアプリのレコードを追加・更新する


また具体的には、次のような処理が実現できます。

  • あるアプリの一覧画面を開いていて、

  • 一覧にチェックボックス列を追加する」を使ってその一覧画面で選択されたレコードを取得し、

  • そのレコードの内容を書き換えたり、今日の日付などをセットするよう

  • 取得したレコードをマッピングを元に更新する


自アプリへ取り込む「やること」

こちらは追加画面や編集画面などで自アプリへ取り込みを行う「やること」の一覧になります。

やること

(自アプリへの取り込み)

元レコード指定方法

実行できる画面

他のアプリからフィールドの値をコピーする

キー指定(フィールド)

追加・編集画面、一覧画面のインライン編集モード

レコードをテーブルに書き出す

レコード指定

追加・編集・詳細画面

テーブルに行を追加する

なし

追加・編集画面


追加・編集画面を表示しているときに、これらのやることを設定したアクションを実行した結果、フィールドへの値のセットやテーブルに行が追加されたあと、利用者が画面の保存ボタンを押してレコードを保存する、といった流れで自アプリへの取り込みを行えます。


なお、やること「レコードをテーブルに書き出す」は詳細画面でも実行できる「やること」で、テーブルに書き出すための元データとしてレコードを取得しておく必要があります。


例えば、Customineの「やること」で配置したボタンを押した時に、元データとして必要なレコードを取得するアクションを実行し、それを元にテーブルに書き出す(行を追加する)、というようなことが可能です。


ただ、詳細画面で行う場合は変更前の状態が表示されたままになるので、やること「画面をリロードする」を使用して画面の再読み込みを行い、変更後の状態を表示する必要がありますのでご注意ください。


まとめ

実現したいカスタマイズによって、適切な「やること」を選択していただき、思い通りのカスタマイズを作成して下さい!


どの「やること」を選択すべきか、よく分からない場合には、チャットでお問い合わせください。

ご不明な点がございましたら、Customineドキュメントサポートページも、ぜひご活用ください。