kintone에서는 필드에 오류 메시지를 표시하거나 레코드 자체에 오류 메시지를 표시할 수 있습니다.

🚨 필드 오류 메시지
필드 아래에 표시됩니다.


🚨 레코드 오류 메시지
중앙 상단에 표시됩니다.


이번에는 필드와 레코드에 자유롭게 (?) 오류 메시지를 표시합시다 👀✨✨

앱 준비

필드 유형
필드 코드
비고


수치
짝수

문자열(1행)
우편번호

테이블
테이블

문자열(1행)
품명
테이블 내 필드

수치
단가
테이블 내 필드

수치
개수
테이블 내 필드

계산
금액
단가* 개수, 인테리어 필드

오류 메시지 표시 방법

필드에 오류 메시지 표시

フィールド에 오류 메시지를 표시하려면,
record 오브젝트의 フィールド 의 error property에 에러 메세지를 설정합니다.return event; 를 잊지 마세요!

// 保存前イベント
kintone.events.on(
  ["app.record.create.submit", "app.record.edit.submit"],
  (event) => {
    event.record.偶数.error = "偶数じゃないよ！";
    // return event; がないとエラーが表示されないよ！！！
    return event;
);

이제 다음과 같이 표시됩니다.

테이블의 필드에 오류 메시지 표시

テーブル内のフィールド에 오류 메시지를 표시하려면,
행과 필드를 지정하여 지정된 필드의 error 속성에 오류 메시지를 설정합니다.

// 保存前イベント
kintone.events.on(
  ["app.record.create.submit", "app.record.edit.submit"],
  (event) => {
    // 一番上の行の単価フィールドにエラーメッセージを表示
    event.record.テーブル.value[0].value.単価.error = "高すぎる！";
    return event;
);

이제 다음과 같이 표시됩니다.

레코드에 오류 표시

レコード自体에 오류 메시지를 표시하려면,event 개체의 error 속성에 오류 메시지를 설정합니다.

// 保存前イベント
kintone.events.on(
  ["app.record.create.submit", "app.record.edit.submit"],
  (event) => {
    event.error = "エラーがあります！";
    return event;
);

이제 다음과 같이 표시됩니다.

오류 메시지 지우기

오류 메시지를 지우려면 error 속성을 null로 설정합니다.

// フィールドのエラーメッセージを消す
event.record.偶数.error = null;

// レコードのエラーメッセージを消す
event.error = null;

조건부로 오류 메시지 표시

필드나 레코드의 조건에 따라 오류 메시지를 표시하는 방법입니다.

저장 시 '짝수'가 아닌 경우 필드에 오류 메시지 표시

짝수 필드의 숫자가 0이 아니면 오류 메시지를 표시합니다.

// 偶数じゃなかったらエラー
if (!(event.record.偶数.value % 2 === 0)) {
  event.record.偶数.error = "偶数じゃないよ！";
}

우편번호의 서식(3자리-4자리)이 아니면 필드에 에러 메시지를 표시한다

우편번호의 서식(3자리-4자리)을 정규식으로 나타내고, 일치하지 않으면 에러 메시지를 표시합니다.

// 正規表現 3桁数字-4桁数字
const rx_pcode = /^[0-9]{3}-[0-9]{4}$/;
if (!rx_pcode.test(event.record.郵便番号.value)) {
  event.record.郵便番号.error = "郵便番号じゃないよ";
}

테이블의 필드에 조건부로 오류 메시지를 표시하고 싶습니다.

테이블의 필드에 에러 메세지를 표시하고 싶을 때는 forEach 로 루프 하는 것이 편리합니다.

const rx_pname = /牛乳/;
event.record.テーブル.value.forEach((r) => {
  if (rx_pname.test(r.value.品名.value)) {
    // 品名に牛乳が入ってたらエラーにする
    r.value.品名.error = "牛乳はダメ！";
  }
  if (Number(r.value.単価.value) > 1000) {
    // 単価が1000円より高かったらエラー
    r.value.単価.error = "高すぎる！";
  }
  if (Number(r.value.個数.value) !== 8) {
    // 個数が8個じゃなかったらエラー
    r.value.個数.error = "縁起が悪い！";
  }
});

테이블의 필드에 조건부로 오류 메시지가 표시되면 다음과 같이 표시됩니다.

작업에 30초 이상 걸리면 레코드 오류 메시지 표시

(누가 필요한 조건인지는 모르겠지만)
추가, 편집 표시시에 카운트업을 시작하고,
30초보다 시간이 걸리면 오류 메시지를 표시합니다.

let count = 0;

kintone.events.on(
  ["app.record.edit.show", "app.record.create.show"],
  (event) => {
    const countup = setInterval(() => {
      count++;
    }, 1000);
  }
);

kintone.events.on(
  ["app.record.create.submit", "app.record.edit.submit"],
  (event) => {
    // 30秒よりもかかってしまったらエラーメッセージを表示
    if (count > 30) {
      event.error = "作業が遅い！";
    }
    return event;
  }
);

저장할 때가 아니라 입력할 때마다 입력값이 OK인지 error인지 확인하고 싶습니다.

오류 메시지 표시가 저장되면 느립니다! 라는 것도 있다고 생각합니다.
입력 직후에 입력 내용이 올바른지 알고 싶네요.

짝수 필드를 사용한 예이지만 フィールドの値変更時イベント

짝수라면 오류 메시지를 지우십시오

짝수가 아니면 오류 메시지 표시

그렇다면 OK입니다.

kintone.events.on(
  ["app.record.create.change.偶数", "app.record.edit.change.偶数"],
  (event) => {
    event.error = null;
    // 偶数だったらエラー表示を削す
    if (event.record.偶数.value % 2 === 0) {
      // nullを設定するとエラーメッセージが消えます
      event.record.偶数.error = null;
    } else {
      // 偶数でなければエラーメッセージ表示する
      event.record.偶数.error = "偶数じゃないよ！";
    }
    return event;
  }
);

요약

필드, 레코드에 오류 메시지를 표시하는 방법이었습니다.return event; 없으면 오류 메시지가 표시되지 않으므로 요주의입니다 👀!