# 정적 엔티티 [**정적 엔티티**](https://success.outsystems.com/ja-jp/documentation/11/reference/outsystems_language/data/modeling_data/static_entity/)는 이름이 지정된 값들의 집합으로 구성되어 있습니다. 정적 엔티티는 항상 전역 범위를 갖는 데이터베이스에 저장되는 리터럴 값으로 생각하면 됩니다. 정적 엔티티의 **레코드** 폴더에는 데이터가 저장되며, 속성은 데이터의 구조를 정의합니다. 정적 엔티티에서 사용 가능한 액션은 **Get<StaticEntity>** 액션뿐입니다. 이는 OutSystems가 데이터의 영속성을 관리하기 때문입니다. 데이터를 모델링할 때, 정적 엔티티는 다른 정적 엔티티의 외래 키만 포함할 수 있다는 점에 유의하세요. 자세한 내용은 [엔티티 관계](https://success.outsystems.com/ja-jp/documentation/11/building_apps/data_management/data_modeling/entity_relationships/)를 확인하세요. ## 정적 엔티티 생성 애플리케이션에 정적 엔티티를 추가하려면, Service Studio에서 다음 단계를 수행하세요: 1. **데이터** 탭으로 이동하여 **엔티티** 폴더를 마우스 오른쪽 버튼으로 클릭한 다음, **데이터베이스에 정적 엔티티 추가**를 선택합니다.  이름을 입력하기 시작합니다. **Enter** 키를 눌러 확정합니다. 2. 새로운 정적 엔티티에는 [기본 속성 세트](https://success.outsystems.com/ja-jp/documentation/11/building_apps/data_management/data_modeling/static_entities/#default-attributes)가 설정됩니다. 새로운 속성을 추가하려면, 정적 엔티티를 마우스 오른쪽 버튼으로 클릭하고 **엔티티 속성 추가**를 선택합니다. 그런 다음, 속성 이름과 데이터 타입을 편집합니다. 3. 마지막으로, 정적 엔티티에 데이터를 추가합니다. 정적 엔티티를 마우스 오른쪽 버튼으로 클릭하고 **레코드 추가**를 선택합니다. 레코드의 속성을 입력합니다. ## 기본 속성 Service Studio는 자동으로 다음 속성들을 생성합니다: **Id** 레코드를 식별하며, 항상 고유합니다. 자동 번호의 사용은 복잡한 시나리오에서 문제가 발생할 수 있으므로 권장되지 않습니다. **Label** 애플리케이션에서 표시할 값을 담고 있습니다. **Order** 최종 사용자에게 레코드를 표시할 순서를 정의합니다. **Is_Active** 실행 시 레코드가 사용 가능한지 여부를 정의합니다. 예를 들어, **Is_Active**가 false로 설정된 레코드는 스캐폴딩이 정적 엔티티를 사용할 때 사용되지 않습니다. 정적 엔티티가 공개된 경우, 라이브러리 모듈에서 집계 소스로 사용할 수 없습니다. ## 정적 엔티티를 엔티티로 변환 기존 정적 엔티티를 엔티티로 변환할 수 있습니다. 정적 엔티티를 엔티티로 변환하려면, 정적 엔티티를 마우스 오른쪽 버튼으로 클릭하고 **상세 정보** 도움말 메뉴로 이동한 다음, **엔티티로 변환**을 선택합니다. 정적 엔티티를 엔티티로 변환한 후: - 정적 엔티티의 레코드는 집계 또는 SQL 쿼리를 통해 데이터베이스 쿼리를 통해 사용 가능하게 됩니다 - **레코드** 폴더는 Service Studio에서 더 이상 사용할 수 없게 됩니다 참고로, 엔티티를 정적 엔티티로 변환하는 것도 가능합니다. ## 예시 사전 정의된 또는 상수 값의 집합이 필요한 경우 정적 엔티티를 사용합니다. 예를 들어, 호텔 앱에서는 "예약됨", "체크인", "체크아웃", "취소" 등의 예약 상태가 필요합니다. 또한 "체크아웃"에 대한 "손님이 방금 떠났습니다"와 같은 상태의 기본 설명도 필요합니다. 정적 엔티티 "Status"는 다음과 같습니다:  정적 엔티티의 레코드 폴더에는 생성한 모든 상태가 포함되어 있습니다. "CheckedOut"을 선택하면 속성 편집기에 다음 세부 정보가 표시됩니다:  체크아웃 상태의 식별자는 `CheckedOut`이고, 레이블은 `"CheckedOut"`입니다. TextDescription 필드는 사용자 정의 필드로, 문자열 값 `"The guest have just left."`를 가지고 있습니다. 체크아웃 상태의 레코드는 해당 식별자를 참조하여 접근할 수 있습니다: `Entities.Status.CheckedOut`