빠른 시작: 사용자 지정 엔터티 만들기Quickstart: Create a custom entity

PowerApps에서 엔터티는 추적하려는 정보를 회사 이름, 위치, 제품, 메일 및 전화 등의 속성을 포함하는 레코드의 형태로 정의합니다.In PowerApps, an entity defines information that you want to track in the form of records, which typically include properties such as company name, location, products, email, and phone. 그런 다음, 엔터티를 참조하는 앱을 개발하여 해당 데이터를 표시할 수 있습니다.You can then surface that data by developing an app that refers to the entity. PowerApps는 조직 내에서 일반적인 시나리오를 다루도록 표준 "기본 제공" 엔터티를 제공하지만 조직에 관련된 데이터를 저장하는 사용자 지정 엔터티를 만들어야 하는 경우가 있을 수 있습니다.PowerApps offers standard "out-of-the-box" entities to cover typical scenarios within an organization (such as tracking appointments), but there may be times when you need to create custom entities to store data that's specific to your organization.

이 빠른 시작에서는 회사가 판매하는 제품에 대한 등급 및 설명을 표시하는 앱을 만드는 데 사용할 수 있는 제품 검토라는 사용자 지정 엔터티를 만드는 방법을 알아봅니다.In this quickstart, you'll learn how to create a custom entity called Product Review that you can use to create an app that displays ratings and comments for products that your company sells.

필수 조건Prerequisites

이 빠른 시작을 수행하려면 다음 항목이 필요합니다.To follow this quickstart, the following items are required:

  • PowerApps 요금제 2 또는 Microsoft Flow 요금제 2 라이선스.Either a PowerApps Plan 2 or Microsoft Flow Plan 2 license. 또는 평가판 PowerApps 계획 2에 등록할 수 있습니다.Alternatively, you can sign up for a free PowerApps Plan 2 trial.
  • 앱용 Common Data Service 내에서 시스템 관리자 또는 시스템 사용자 지정자 보안 역할입니다.Either a System Adminsitrator or System Customizer security role within Common Data Service for Apps.

PowerApps에 로그인Sign in to PowerApps

https://web.powerapps.com에서 PowerApps에 로그인합니다.Sign in to PowerApps at https://web.powerapps.com.

엔터티 만들기Create an entity

  1. 탐색 창에서 데이터를 클릭하거나 탭하여 확장한 다음, 엔터티를 클릭하거나 탭합니다.In the navigation pane, click or tap Data to expand it, and then click or tap Entities.

    엔터티 및 세부 정보 목록List of entities and their details

  2. 명령 모음에서 새 엔터티를 클릭하거나 탭합니다.in the command bar, cick or tap New entity.

    엔터티를 만들기 전에 사용 가능한 표준 엔터티의 설명에 대한 엔터티 참조를 확인합니다.Before you create an entity, check out the entity reference for a description of available standard entities. 이러한 엔터티는 일반적인 시나리오를 다룹니다.These entities cover typical scenarios. 이러한 엔터티 중 하나가 있는 그대로 또는 약간 변경된 후에 요구 사항을 충족하는 경우 해당 엔터티부터 시작하여 시간을 줄일 수 있습니다.If one of these entities meets your requirements as is or after minor changes, you can save time by starting with that entity.

  3. 새 엔터티 패널에서 표시 이름 상자에 제품 검토를 입력한 다음, 필요에 따라 설명을 입력합니다(설명은 다른 사람이 이 엔터티를 사용하는 경우 유용함).In the New entity panel, in the Display name box, enter Product review, and then optionally enter a description (descriptions are helpful if other people will use this entity). 패널의 다른 필드는 아래 설명한 것과 같이 채워집니다.Other fields in the panel are autopopulated, as described below. 완료하면 다음을 클릭합니다.When you're done, click Next.

    • 복수 표시 이름 - 이 필드는 표시 이름을 입력하면 채워지지만 필요에 따라 변경할 수 있습니다.Plural display name - This field is autopopulated when you enter a display name, but you can change it if needed. 복수 표시 이름은 Common Data Service WebAPI에서 엔터티의 이름이며, PowerApps 또는 Flow에서 이 엔터티와 상호 작용할 때 사용됩니다.The plural display name is the name of the entity in the Common Data Service WebAPI and is used when interacting with this entity from PowerApps or Flow.

    • 이름 - 이 필드도 표시 이름을 입력하면 채워집니다.Name - This field is also autopopulated when you enter a display name. 접두사는 환경이 만들어질 때 설정되었으며, 만든 엔터티가 다른 엔터티 이름과 충돌하지 않고 다른 환경으로 내보내고 가져올 수 있도록 합니다.The prefix was set up when the environment was created and ensures that the entities you create can be exported and imported into other environments without conflicting with other entity names. Common Data Service 기본 솔루션에 대한 게시자의 접두사를 업데이트하여 이 접두사를 변경할 수 있습니다.You can change this prefix by updating the prefix on your Publisher for the Common Data Service Default Solution. 기존 앱을 중단되지 않도록 유지하기 위해 엔터티를 저장한 후 이름을 변경할 수 없습니다.To keep existing apps from breaking, you cannot change the name after saving the entity.

      새 엔터티New Entity

  4. 엔터티 세부 정보 페이지에서 기본 이름 필드를 클릭하거나 탭하여 기본 이름 패널을 연 다음, 표시 이름 상자에서 기본 이름제품 검토로 바꿉니다.On the entity details page, click or tap the Primary Name field to open the Primary Name panel, and then in the Display name box, replace Primary Name with Product Review. 이름 상자에서 PrimaryNameProductReview로 바꾼 다음, 완료를 클릭하거나 탭합니다.In the Name box, replace PrimaryName with ProductReview, and then click or tap Done.

    기본적으로 모든 엔터티는 다른 엔터티와의 관계를 설정할 때 조회 필드에 사용되는 기본 이름 필드를 포함합니다.By default, every entity contains a Primary Name field, which is used by lookup fields when establishing relationships with other entities. 일반적으로 기본 이름 필드는 엔터티에 저장되는 데이터의 이름 또는 기본 설명을 저장합니다.Typically the Primary Name field stores the name or primary description of the data stored in the entity. 처음으로 엔터티를 저장하기 전에 기본 이름 필드의 이름 및 표시 이름을 업데이트할 수 있습니다.You may update the name and display name of the Primary Name field before saving the entity for the first time.

    엔터티 세부 정보Entity Details

  5. 엔터티에 필드를 추가하려면 다음을 수행합니다.To add a field to the entity, do the following:

    a.a. 명령 모음에서 필드 추가를 클릭하거나 탭하여 필드 속성 패널을 엽니다.In the command bar, click or tap Add field to open the Field properties panel.

    b.b. 표시 이름 상자에 검토 날짜를 입력합니다.In the Display name box, enter Review Date.

    c.c. 데이터 형식 드롭다운 목록에서 날짜만을 선택합니다.From the Data type drop-down list, select Date Only.

    d.d. 필수 확인란을 클릭하거나 탭합니다.Click or tap the Required check box.

    e.e. 완료를 클릭하거나 탭합니다.Click or tap Done.

    자세한 내용은 엔터티에서 필드 관리를 참조하세요.For more information, see Manage fields in an entity.

    새 필드New Field

  6. 이전 단계를 반복하여 다음 구성으로 3개의 필드를 더 추가합니다.Repeat the previous step to add three more fields with the following configurations:

    • 표시 이름 = 제품 등급, 데이터 형식 = 정수, 필수 확인란 클릭하거나 탭Display name = Product Rating; Data type = Whole Number; click or tap Required check box

    • 표시 이름 = 검토자 이름, 데이터 형식 = 텍스트Display name = Reviewer Name; Data type = Text

    • 표시 이름 = 검토자 설명, 데이터 형식 = 텍스트Display name = Reviewer Comment; Data type = Text

      완료되면 엔터티 세부 정보 페이지에 다섯 개의 필드가 나열됩니다.When you're done, you should have five fields listed on your entity details page.

      필드 목록Field list

      모든 엔터티에는 읽기 전용 시스템 필드가 있습니다.Note that all entities have read-only system fields. 기본적으로 시스템 필드는 엔터티에 있는 경우에도 필드 목록에 표시되지 않습니다.By default, system fields are not shown in the list of fields even though they exist in the entity. 모든 필드를 표시하려면 기본에서 모두로 명령 모음의 필터를 변경합니다.To see all fields, change the filter on the command bar from Default to All. 엔터티와 관련된 메타데이터에 대한 자세한 내용은 엔터티 메타데이터를 참조하세요.For more information on the metadata related to an entity, see Entity metadata.

  7. 엔터티 저장을 클릭하여 엔터티를 저장하고 앱에서 사용할 수 있도록 합니다.Click Save entity to save your entity and make it available for use in apps.

    제품 검토 엔터티는 데이터베이스의 엔터티 목록에 표시되어야 합니다.The Product Review entity should appear in the list of entities in your database. 표시되지 않는 경우 기본에서 사용자 지정으로 명령 모음의 필터를 변경합니다.If you don't see it, change the filter in the command bar from Default to Custom.

    필터Filter

다음 단계Next steps

이 빠른 시작에서는 특정 회사에서 판매된 각 제품에 대한 등급 및 설명을 표시하는 앱을 만드는 데 사용할 수 있는 제품 검토라는 사용자 지정 엔터티를 만드는 방법을 알아봤습니다.In this quickstart, you learned how to create a custom entity called Product Review that can be used to create an app that displays ratings and comments for each product sold by a particular company. 다음으로 각 제품을 수신하는 검토 및 설명과 연결할 수 있도록 엔터티 간의 관계를 정의하는 방법을 알아봅니다(이 경우 표준 제품 엔터티와 사용자 지정 하는 제품 검토 엔터티 간).Next, learn how to define relationships between entities (in this case between the standard Product entity and your custom Product Review entity) so you can associate each product with the reviews and comments it receives.

개인 정보 취급 방침Privacy notice

Microsoft PowerApps 공통 데이터 모델을 통해 Microsoft는 사용자 지정 엔터티 및 필드 이름을 진단 시스템에 수집 및 저장합니다.With the Microsoft PowerApps common data model, Microsoft collects and stores custom entity and field names in our diagnostic systems. 이 정보는 고객을 위한 공통 데이터 모델을 향상하기 위해 사용합니다.We use this knowledge to improve the common data model for our customers. 앱 작성자가 만드는 엔터티 및 필드 이름은 Microsoft PowerApps 커뮤니티에서 공통된 시나리오를 이해하고 조직에 관련된 스키마와 같은 서비스의 표준 엔터티 범위의 격차를 확인하는 데 도움을 줍니다.The entity and field names that app Creators create help us understand scenarios that are common across the Microsoft PowerApps community and ascertain gaps in the service’s standard entity coverage, such as schemas related to organizations. 이러한 엔터티와 연결된 데이터베이스 테이블의 데이터는 Microsoft에 의해 액세스되거나 사용되지 않고 데이터베이스가 프로비전되는 영역 외부에서 복제되지 않습니다.The data in the database tables associated with these entities is not accessed or used by Microsoft or replicated outside of the region in which the database is provisioned. 단, 사용자 지정 엔터티 및 필드 이름은 지역에 걸쳐 복제될 수 있고 데이터 보존 정책에 따라 삭제될 수 있습니다.Note, however, that the custom entity and field names may be replicated across regions and are deleted in accordance with our data retention policies. Microsoft는 보안 센터에서 더 자세히 설명한 것과 같이 개인 정보 보호를 위해 노력합니다.Microsoft is committed to your privacy as described further in our Trust Center.