필드

필드를 사용하여 모델의 데이터를 분류할 수 있습니다. 예를 들어 Employee 모델에 사람의 이름을 저장하는 FirstName 필드가 있을 수 있습니다.

필드는 테이블의 열이고, 레코드는 행입니다. 데이터는 각 레코드의 필드에 입력됩니다. 예를 들어 네 번째 레코드의 FirstName 필드에 Bob이 포함될 수 있습니다.

서버 스크립트, 클라이언트 스크립트, 바인딩을 사용하여 데이터를 필드에 입력할 수 있습니다.

스크립트의 입력은 필드의 유형과 일치해야 합니다. 스크립트에서 올바른 데이터 유형을 확인하거나, 바인딩 표현식에서 바인딩 변환기를 사용하여 데이터를 올바른 유형으로 변환할 수 있습니다. 가능한 경우 App Maker는 앱 UI의 입력을 자동으로 적절한 유형으로 변환합니다.

필드 만들기

필드를 만들 때는 필드에 포함되는 데이터의 종류를 결정하는 유형을 지정합니다. 예를 들어 문자열 필드는 이름이나 이메일 주소 같은 문자열을 포함하고, 숫자 필드는 숫자를 포함합니다.

다음과 같은 필드를 만들 수 있습니다.

  • 단순 필드 — 최대 하나의 값만 포함할 수 있는 단순한 필드입니다. 앱에서 대부분의 필드가 단순 필드일 것입니다. 레코드의 각 필드에는 아무 것도 포함되지 않거나(null) 단일 값이 포함됩니다. 예를 들어 특정 레코드의 JobTitle 필드는 다음을 포함할 수 있습니다.

    Software Engineer

    단순 필드의 데이터로 레코드를 정렬할 수 있습니다. 테이블 위젯의 열 머리글로 사용되는 라벨에 테이블을 정렬하는 사전 정의된 onClick 작업이 있습니다. 예를 들면 다음과 같습니다.

    window._am.sortTableBy(widget.datasource,
            widget.datasource.model.fields.LastName,
            widget, window._am.TableState);
  • 목록 필드 — 목록 필드에는 두 개 이상의 값이 포함됩니다. App Maker는 목록 필드의 값을 배열로 저장합니다.

    각 레코드의 각 목록 필드에는 아무 것도 포함되지 않거나(빈 배열, [], null 아닌 값), 단일 값 또는 다중 값이 포함됩니다. 예를 들어 특정 레코드의 Measurements 필드에 다음이 포함될 수 있습니다.

    [0.312,1.245,1.434,1.789, 42]

    목록 필드의 데이터로는 레코드를 정렬할 수 없습니다.

단순 필드의 데이터 유형

유형 설명 예시
문자열 유니코드 문자의 문자열 필드: FirstName

콘텐츠: Susan

숫자 64비트 부동 소수점 숫자 필드: EmployeeID

콘텐츠: 13465

부울 true 또는 false 필드: IsActive

콘텐츠: true

날짜 날짜 객체 필드: HireDate

콘텐츠: 2015-09-28

목록 필드의 데이터 유형

유형 설명 예시
List<String> 문자열 목록 필드: FoodAllergies

배열: ["pecans","walnuts","shrimp"]

List<Number> 숫자 목록 필드: MRITesla

배열: [1.2,1.5,3,7]

List<Boolean> 부울 값 목록 필드: Answers

배열: [true,false,false,true]

List<Date> 날짜 목록 필드: ReviewDate

배열: [2014-07-12,2015-07-15]

필드 속성 설정

각 모델의 필드 탭에서 필드 속성을 설정할 수 있습니다.

이름 설명
유형 필드에 저장되는 데이터 유형입니다. 단순 필드는 문자열, 숫자, 부울 또는 날짜이고, 목록 필드는 List<String>, List<Number>, List<Boolean> 또는 List<Date>입니다. 필드 유형은 편집할 수 없습니다. 필드 유형을 변경하려면 필드를 삭제하고 다시 만드세요.
이름 필드에 액세스하는 데 사용되는 고유한 라벨입니다. 영숫자와 밑줄만 포함할 수 있으며 문자로 시작해야 합니다.
SQL 유형 (Google Cloud SQL만) 필드의 데이터를 저장하는 데 사용되는 기본 SQL 유형입니다.
표시 이름 사람이 더 쉽게 읽을 수 있는 필드 이름입니다. 고유할 필요는 없으며 공백과 특수 문자를 포함할 수 있습니다.
설명 필드를 설명하는 속성이며 참고용으로만 사용됩니다.
기본값 사용 이 속성을 선택하면 앱에서 레코드를 만들 때 사용할 기본값을 지정할 수 있습니다.

기본값 사용

기본적으로 App Maker는 기본값이 false인 부울을 제외한 모든 단순 필드의 기본값으로 null을 사용합니다. 목록 필드의 경우 App Maker는 빈 배열을 기본값으로 사용합니다.

기본값 사용을 선택하면 고유한 기본값을 설정할 수 있습니다. null을 허용하지 않는 필수 필드와 자연스러운 기본 상태가 존재하는 필드에 기본값을 설정하면 유용합니다. 예를 들어 Employee 모델에 Status 필드가 있는 경우 새로운 각 레코드는 새로운 활성 상태의 직원을 나타낼 가능성이 높으므로 기본값을 Active로 설정할 수 있습니다.

App Maker는 다음과 같은 경우에 기본값을 초깃값으로 사용합니다.

  • 데이터 소스의 초안 레코드
  • 수동 저장 모드를 사용하는 데이터 소스에서 만든 레코드
  • newRecord()를 사용하여 서버에서 만든 레코드
  • 필드 값이 지정되지 않은 Google 스프레드시트 또는 CSV 파일에서 가져온 레코드

데이터 검증

필드에 데이터 검증 제약조건을 사용하여 필드에 허용되는 데이터를 제한할 수 있습니다. 예를 들어 ZipCode 필드에 5자리 숫자 값을 사용하거나 Name 필드에 2자 이상의 문자를 사용하도록 설정할 수 있습니다. 사용 가능한 제약조건은 필드 유형에 따라 다릅니다.

목록 필드에 검증 기준이 설정되어 있으면 목록의 모든 항목이 검증 기준을 충족해야 합니다. 예를 들면 3.235가 정수가 아니므로 2,3,5,3.235는 정수 검증에 실패합니다.

이름 유형 설명
필수 모두 이를 선택하면 필드가 null이거나, 정의되지 않거나, null 요소가 있는 배열(목록 필드의 경우)인 경우 레코드가 저장되지 않습니다.
최소 길이 및 최대 길이 문자열 필드의 최소 및 최대 문자 길이입니다.
가능한 값 문자열, 숫자, 날짜 필드에서 허용하는 입력을 결정하는 목록입니다.
정규 표현식 문자열 이 값이 저장되는 필드가 포함된 레코드에 대해 문자열이 충족해야 하는 조건의 집합입니다.

정규 표현식에 대해 자세히 알아보세요.

정규 표현식 오류 메시지 문자열 입력이 지정된 정규 표현식과 일치하지 않을 때 앱에 표시되는 오류 메시지입니다.
최솟값 및 최댓값 숫자, 날짜

필드의 최솟값과 최댓값입니다.

위젯이 브라우저의 시간대를 사용하도록 구성되어 있어도 날짜 값은 항상 UTC에 대해 검사됩니다.

정수 숫자 이를 선택하면 필드의 숫자에 유의미한 소수점 자리가 포함되어 있을 경우 레코드가 저장되지 않습니다. 숫자 4., 4.0, 0., .0, 0.0은 아시다시피 정수입니다. 숫자 1.0000000000000001은 정수가 아니지만 소수점 이하의 숫자에 큰 의미가 없으므로 App Maker에서는 이를 정수로 간주합니다.
SQL 유형 날짜

(Cloud SQL 모델만) App Maker에서 시간대를 처리하는 방법을 제어합니다.

  • TIMESTAMP — 시간대를 포함합니다. App Maker는 데이터베이스에 쓰기 전에 시간을 PT(UTC-7 또는 UTC-8)로 변환합니다.
  • DATE 및 DATETIME — 시간대 정보를 포함하지 않습니다. App Maker는 데이터를 PT(UTC−7 또는 UTC−8)로 읽고 씁니다.

필수 필드가 있는 레코드 만들기

필수 필드가 null이거나 정의되지 않은 레코드를 만들려고 시도하거나 목록 필드에서 null 요소가 있는 배열을 만들려고 시도하면 App Maker에서 오류가 발생합니다. 이러한 오류를 방지하기 위한 몇 가지 방법은 다음과 같습니다.

  • 기본값 할당 — 가장 간단한 해결책입니다. 기본값은 필드 생성 시 필드에 값이 존재하도록 보장하고 검증 오류를 방지합니다.
  • (서버 측) 초안 레코드 사용newRecord() 메서드를 사용하면 레코드를 모델에 저장하기 전에 필수 필드를 설정할 수 있습니다.
  • (클라이언트 측) 초안 레코드 사용 — 자동 저장 모드 데이터 소스에는 레코드를 만들기 전에 스크립트와 데이터 바인딩을 통해 값을 입력할 수 있는 draft 레코드가 있습니다.
  • (클라이언트 측) 수동 저장 모드 데이터 소스 사용수동 저장 모드에서는 검증 오류를 방지하기 위해 레코드를 저장하기 전에 사용자 또는 스크립트가 필수 필드를 채울 수 있습니다.

데이터를 목록 필드로 가져오거나 목록 필드에서 내보내기

데이터를 목록 필드로 가져오거나 목록 필드에서 내보내는 방법은 다음과 같습니다.

  • 서버 또는 클라이언트 스크립트 사용 — 스크립트는 목록 필드의 배열에 있는 항목을 읽고 쓸 수 있습니다.
  • 위젯 사용특정한 위젯과 바인딩 표현식을 목록 필드에 사용할 수 있습니다.
  • 가져오기 및 내보내기 사용 — App Maker는 목록 필드가 포함된 레코드를 가져오거나 내보낼 수 있습니다.

쉼표 및 따옴표 구문

앱의 UI에서, 그리고 가져오기 작업을 위한 Google 스프레드시트 또는 내보내기 작업에서 발생한 Google 스프레드시트에서 목록 필드의 콘텐츠는 쉼표로 구분된 목록입니다. 예를 들면 다음과 같습니다.

capable truck,magnificent truck,best truck
    

문자열 목록 필드의 항목에는 쉼표가 포함될 수 있습니다. 콘텐츠 쉼표와 구분 기호 쉼표를 구별하기 위해 UI에 특수 구문이 사용되며 가져오기와 내보내기에 서로 다른 특수 구문이 사용됩니다. 가져오기와 내보내기의 경우 큰따옴표에도 특수 구문이 사용됩니다.

항목 UI 구문 가져오기 및 내보내기 구문
콘텐츠의 쉼표 \,(백슬래시 쉼표) 사용 목록 항목을 큰따옴표로 묶습니다.
콘텐츠의 큰따옴표 특수 구문 없음 목록 항목은 큰따옴표로 묶고 콘텐츠의 따옴표는 큰따옴표로 만듭니다("가 ""가 됨).

작은따옴표에는 특수 구문이 필요하지 않습니다. 항목에 쉼표와 하나 이상의 큰따옴표가 모두 포함되어 있으면 항목을 하나의 큰따옴표 쌍으로 묶습니다.

항목의 선행 및 후행 공백은 데이터가 저장되면 제거됩니다.

예시
UI 구문 가져오기 및 내보내기 구문
horse,dog,cat horse,dog,cat
horse,dog\,cat horse,"dog,cat"
horse,a "beautiful" dog,cat horse,"a ""beautiful"" dog",cat
horse,a "beautiful\, strange\," exotic dog, cat horse,"a ""beautiful, strange,"" exotic dog",cat