ユーザフィールド
機能概要
ユーザフィールドとは、アカウントに参加しているユーザと、DBに登録されているレコードを結びつけることができるフィールドタイプです。
予めアプリロールでユーザフィールドを抽出条件に設定しておくことで、アプリ利用からDBのレコードを閲覧する際に、ログインしているユーザに紐づいたレコードのみを表示することなどができます。
ユーザフィールドを活用することで、例えば以下のようなことが実現できます。
・申請/承認フロー
・問い合わせ管理
機能仕様
ユーザフィールドに登録できるユーザはアカウントに参加しているユーザのみです。
ユーザの追加方法はユーザ招待/除外をご参照ください。
ユーザフィールドから取得できる情報
ユーザフィールドからは以下の情報を取得できます。
| 項目 | 例 |
|---|---|
| ユーザID | 1234 |
| 名 | 太郎 |
| 姓 | スパイラル |
| メインメールアドレス | spiral@example.com |
| サブメールアドレス | spiral-sub@example.com |
| 状態（有効/無効） | true |
有効ユーザ/無効ユーザ
ユーザの状態は有効/無効で管理され、以下に該当するユーザは無効ユーザとなり取得できる情報はユーザIDのみとなります。
・対象ユーザがアカウントから除外されている
・対象ユーザが削除されている
DBのユーザフィールド対応
・1DBにつき5フィールドまで追加できます。
・フィールドのデフォルト値にレコード作成者を設定することができます。
詳しくはフィールドのデフォルト値をご参照ください。
・2フィールド間ユニーク制約は非対応です。
・トリガ＞レコードアクション＞発動条件＞簡易条件に設定できます。
※関数条件は非対応です。
・トリガ＞レコードアクション＞処理マッピング＞アクション先DBフィールド、格納値に設定できます。
詳しくはDBトリガのレコードアクションをご参照ください。
※関数設定は非対応です。
※アクション先DBフィールドにユーザフィールドを選択した場合、格納値に設定できるフィールドはユーザフィールドのみです。
・トリガ＞非同期アクション＞メール配信アクション＞宛先フィールドにユーザフィールドのメインメールアドレスを設定できます。
※宛先の指定方法がレコードの場合のみ設定可能です。
※宛先フィールドがユーザフィールドの場合、配信条件の「他DBメールアドレス抽出」は利用できません。
※宛先フィールドがメールアドレスの場合も、「他DBメールアドレス抽出」でユーザフィールドは設定できません。
※他の配信機能ではユーザフィールドは非対応です。
詳しくはDBトリガのメールアクションをご参照ください。
アプリロールのユーザフィールド対応
・アプリロール＞レコード操作権限＞抽出条件に設定できます。
この設定によりアプリ利用画面から自分自身と紐づくレコードのみ閲覧や変更を行う等の制限ができます。
・アプリロール＞フィールド権限＞選択ユーザ制限設定を行えます。
この設定によりフィールドのデータを作成/変更が可能なユーザを制限することができます。（30人まで）
詳しくはアプリロールをご参照ください。
アプリ利用のユーザフィールド対応
・アプリ利用画面からユーザフィールドの閲覧や編集ができます。
※ユーザフィールドへの登録や編集は1件ずつのみ可能です。
・詳細検索（簡易）に設定できます。
この設定により自分自身に紐づくレコードのみの検索などができます。
詳しくはアプリ利用画面のレコード詳細検索をご参照ください。
・詳細検索（高度）で使用できます。
簡易検索と同様に自分自身に紐づくレコードのみの検索などができます。
詳しくは条件式や計算式の記法をご参照ください。
・アプリ利用画面からのメール配信、レコード一括操作（一括ダウンロード、一括登録、一括更新、一括更新登録、一括編集）は非対応です。
APIのユーザフィールド対応
・DB一覧を取得、DBを取得
レスポンスよりユーザフィールドに関する設定情報を取得できるようになります。
・DBを作成、DBを変更
リクエスト時にユーザフィールドに関する設定情報を指定できるようになります。
・レコード一覧を取得、レコードを取得、参照先フィールドを含めたレコード一覧を取得、参照先フィールドを含めたレコードを取得
レスポンスよりユーザフィールドの情報を取得できるようになります。
参照先フィールドを含めたレコード一覧を取得、参照先フィールドを含めたレコードを取得で指定可能な参照方法などは
参照先フィールドを含めたレコード取得APIをご参照ください。
また、レコード一覧を取得APIではリクエスト時のパラメータ「where」にユーザフィールドを指定できるようになります。
リクエスト例、レスポンス例はAPIリファレンス、フィールドタイプリファレンス、条件式や計算式の記法を参照ください。
・レコードを登録、レコードを変更
リクエスト時にユーザフィールドを指定できるようになります。
サイト管理のユーザフィールド
・サイト管理ではユーザフィールドは非対応です。