Documentation Index
Fetch the complete documentation index at: https://docs.twenty.com/llms.txt
Use this file to discover all available pages before exploring further.
필드 정보
필드는 스프레드시트의 열과 같습니다. 텍스트, 숫자 또는 날짜와 같은 다양한 유형의 데이터를 저장합니다. 필드는 기본 제공 표준 필드 또는 사용자 정의 필드(사용자가 생성한 필드)일 수 있습니다.표준 필드
표준 필드는 일반적인 비즈니스 요구를 처리할 수 있도록 Twenty에 기본 제공됩니다. 예를 들어,이름 및 성은 사람 객체의 표준 필드입니다. 이는 개인 이름에 대한 텍스트 데이터를 저장합니다.
표준 필드를 삭제할 수는 없지만 필요하지 않을 경우 비활성화할 수 있습니다.
또한 표준 SELECT 유형 필드의 옵션을 사용자 지정할 수 있습니다. 예를 들어 기회(Opportunities)에서 Stage 옵션을 설정할 수 있습니다.
사용자 정의 필드
사용자 정의 필드는 모든 객체에 추가할 수 있습니다. 텍스트, 숫자, 날짜, 드롭다운 선택 항목 등을 저장할 수 있습니다. 비즈니스에 특화된 정보를 추적하기 위해 사용자 정의 필드를 사용하세요. 예를 들어, SpaceX의 경우로켓 활성 상태가 사용자 정의 필드가 될 수 있으며, 이는 로켓이 작동 중인지 여부를 나타냅니다.
필드 유형
Twenty는 다양한 필드 유형을 지원합니다:| 유형 | 설명 | 예시 |
|---|---|---|
| 주소 | 거리, 도시, 주/도, 국가, 우편번호가 포함된 구조화된 주소 | 사무실 주소 |
| 배열 | 텍스트 값 목록 | 태그 |
| 부울 | 참/거짓 체크박스 | 활성 여부 |
| 통화 | 통화 코드가 포함된 금액 | 거래 금액(USD) |
| 날짜 | 날짜 값 | 마감일 |
| 날짜 및 시간 | 시간이 포함된 날짜 | 회의 시간 |
| 도메인 | 웹사이트 도메인(회사에 사용) | acme.com |
| 이메일 | 이메일 주소(기본 + 추가) | 연락처 이메일 |
| JSON | 구조화된 JSON 데이터 | 사용자 지정 메타데이터 |
| 링크 | 레이블이 있는 URL(기본 + 보조) | 웹사이트, LinkedIn |
| 긴 텍스트 | 여러 줄 텍스트 | 설명, 메모 |
| 다중 선택 | 미리 정의된 목록에서 여러 항목 선택 | 태그, 카테고리 |
| 숫자 | 숫자 값(정수 또는 소수) | 수량, 점수 |
| 전화 | 국가 코드가 포함된 전화번호 | 업무용 전화 |
| 평점 | 별점(1~5) | 우선순위, 점수 |
| 관계 | 다른 객체의 레코드 링크 | 회사 → 사람 |
| 선택 | 미리 정의된 목록에서 단일 항목 선택 | 단계, 상태 |
| 텍스트 | 한 줄 텍스트 | 이름, 직함 |
사용자 정의 필드 생성
모든 객체에 사용자 정의 필드를 추가하려면 다음 단계를 따르세요:- 왼쪽 사이드바에서
설정으로 이동합니다. 데이터 모델로 이동한 다음 사용자 지정하려는 객체를 선택합니다.필드 추가를 클릭하여 계속 진행합니다.- 요구 사항에 맞는 필드 이름과 유형을 선택합니다. 더 나은 이해를 위해 필드 설명을 추가하는 것을 고려하세요.
필드를 선택하세요.
빠른 방법: 모든 객체 테이블의 오른쪽 상단의 + 버튼을 클릭한 다음 필드 사용자 지정을 선택합니다. 이렇게 하면 바로 데이터 모델 설정으로 이동합니다.
필드 비활성화
데이터를 잃지 않고 앱에서 필드를 숨기려면 필드를 비활성화할 수 있습니다. 삭제 대신 필드를 숨기는 것으로 생각하세요. 다음은 비활성화 방법입니다:- 객체 설정에서 비활성화하려는 필드를 찾습니다.
-
필드 옆에 있는 세 점
⋮을 클릭하여 메뉴를 엽니다. -
드롭다운에서
비활성화를 선택합니다.
- 앱 안에서: 필드가 사라지며 더 이상 새로운 값을 추가할 수 없습니다.
- 기존 관계: 관계 필드인 경우 기존 연결은 유지되지만 새 연결을 만들 수 없습니다.
- API 액세스: 여전히 API를 통해 필드와 그 데이터를 액세스할 수 있습니다.
필드를 고유하게 만들기
동일한 값을 가진 레코드가 없도록 필드를 고유하게 만드세요. 예를 들어, 이메일 주소는 각 사람마다 고유합니다. 고유성을 설정할 때 오류가 발생하면 데이터(삭제된 레코드를 포함하여)에서 중복 값을 확인하세요.필드 구성 모범 사례
명명 규칙 및 제한 사항
- 단수형 및 복수형 이름은 구별되어야 합니다: GraphQL API에는 변이를 위한 구별된 이름이 필요합니다.
- 보호된 필드 이름: 일부 이름은 시스템 용도로 예약되어 있습니다(예:
Type,Application)
통화 및 전화 필드
- 기본 통화: 데이터 모델을 통해 구성할 수 있습니다.
- 기본 국가 코드: 전화 필드를 위해 데이터 모델을 통해 구성할 수 있습니다.
선택 필드
- 각 선택 필드에는 기본 옵션을 선택할 수 있습니다.
레코드 텍스트 필드
- 각 객체에는 하나의 메인 디스플레이 필드가 있습니다: 이 필드는 가장 왼쪽 열에 나타나며 다른 객체와 링크될 때 레코드를 나타냅니다. 텍스트 필드여야 합니다. 예를 들어, 사람은
이름을 주요 필드로 사용하기 때문에 사람을 회사에 연결할 때 회사의 보기에서 이름을 볼 수 있습니다.