カスタム エンティティの作成Create a custom entity

組織に固有のデータを格納するカスタム エンティティを作成することができます。You can create a custom entity to store data that is specific to your organization. エンティティを参照するアプリを開発すると、そのデータを表示できるようになります。You can then show that data by developing an app that refers to the entity.

エンティティを作成する方法は、2 つあります。There are two ways to create an entity:

どちらのケースも、Microsoft PowerApps によって自動的にデータが保存され、セキュリティが確保されます。In both cases, Microsoft PowerApps automatically stores and helps secure the data. エンティティの作成後、そのフィールドを作成または編集したり、エンティティ間のリレーションシップを構築したりすることができます。After you create an entity, you can create or modify one or more of its fields, and build relationships between entities.

注: エンティティを作成する前に、標準エンティティの一覧を参照してください。Note: Before you create an entity, see the list of standard entities. これらのエンティティには、アカウントや連絡先などの一般的なシナリオが含まれています。These entities cover typical scenarios, such as accounts and contacts. これらのエンティティのいずれかが既に要件を満たしているか、わずかな変更のみで要件を満たす場合は、そのエンティティを使用することで時間を節約することができます。If one of these entities will meet your requirements out of the box or after only minor changes, you can save yourself some time by starting with that entity.

エンティティの作成Create an entity

    1. powerapps.com で、[Common Data Service] セクションを展開し、左側のナビゲーション ウィンドウで [エンティティ] をクリックまたはタップします。On powerapps.com, expand the Common Data Service section and click or tap Entities in the left navigation pane.
  1. データベースを作成していない場合は、作成する必要があります。If you haven't created a database, you need to create one. 詳細については、「Create a Common Data Service database (Common Data Service サービスの作成)」を参照してください。For more information, see Create a Common Data Service database.
  2. 右上隅にある [新しいエンティティ] をクリックまたはタップします。Near the upper-right corner, click or tap New entity.
  3. [エンティティ名] フィールドに、エンティティの名前を入力します。In the Entity name field, enter a name for the entity. 明確でわかりやすいエンティティ名を指定してください。この名前はエンティティの作成後に変更することはできません。Make sure that the name is clear and meaningful, because you can't change it after you create the entity. この名前は、アプリを開発するときに式の中でエンティティを参照する際に使用します。When you develop an app, you will reference the entity by this name in a formula.
  4. エンティティの表示名と、必要に応じて説明を入力し、[次へ] をクリックまたはタップします。Specify a display name and, optionally, a description for the entity, and then click or tap Next.
  5. 省略可: Title フィールドの値を、実際のデータの内容に合った名前に変更します。Optional: Change the value in the Title field to something that is more meaningful for your data.
  6. [作成] をクリックまたはタップしてエンティティを作成します。Click or tap Create to create the entity.

作成したエンティティが、データベース内のエンティティの一覧に表示されます。Your entity appears in the list of entities in your database. エンティティを一覧の先頭に表示するには、[種類] という列ヘッダーをクリックまたはタップします。To show your entity at the top of the list, click or tap the Type column header. エンティティが種類別に並べ替えられ、すべてのカスタム エンティティが標準エンティティよりも上に表示されます。The entities will be sorted by type, and all custom entities will appear above all standard entities.

システム フィールドとレコード タイトル フィールドSystem fields and the record title field

すべてのエンティティには、システム フィールドが 5 つ存在します。All entities have five system fields. これらのフィールドは、読み取り専用です。These fields are read-only. そのため、変更したり削除したりすることはできません。値を割り当てることもできません。Therefore, you can't change or delete these fields, and you don't assign values to them.

表示名Display name システム フィールド名System field name データ型Data type 説明Description
IdId システム フィールド名System field name Big IntegerBig Integer レコードの一意の識別子。The unique identifier for the record.
Created ByCreated By CreatedByUserCreatedByUser テキストText レコードを作成したユーザー。The user who created a record.
Created Record DateCreated Record Date CreatedOnDateTimeCreatedOnDateTime DateTimeDateTime レコードが作成された日時。The date and time when a record was created.
Last modified ByLast modified By LastModifiedByUserLastModifiedByUser テキストText 前回レコードを変更したユーザー。The user who most recently modified the record.
Modified Record DateModified Record Date LastModifiedDateTimeLastModifiedDateTime DateTimeDateTime 前回レコードが変更された日時。The date and time when a record was most recently modified.

最初から作成したエンティティには、Title という名前のカスタム フィールドも含まれています。If you create an entity from scratch, it also contains a custom field that is named Title. このフィールドは、レコードの Title フィールドとして設定されています。This field is set as the record's Title field. Title フィールドの値は、アプリ内で使用するレコードを常にわかりやすく示す識別子です。The Title field value is the user-friendly identifier of a record whenever you use that record in an app. どのフィールドを Title フィールドにするかは変更できますが、Title フィールドは、すべてのエンティティに必ず 1 つ存在する必要があります。You can change which field is the Title field, but every entity must have a Title field.

次の手順Next steps

プライバシーに関する声明Privacy notice

Microsoft PowerApps の Common Data Service では、Microsoft の診断システムにカスタム エンティティとフィールド名を収集して格納します。With the Microsoft PowerApps common data model we collect and store custom entity and field names in our diagnostic systems. 収集した情報は、お客様向けの Common Data Service の改善に使用します。We use this knowledge to improve the common data model for our customers. 作成者が作成するエンティティとフィールド名は、Microsoft PowerApps コミュニティ全体で共通するシナリオを理解したり、組織に関するスキーマなどの、サービスの標準エンティティの対象範囲のギャップを確認したりする場合に役立ちます。The entity and field names that 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. ただし、カスタム エンティティとフィールド名はリージョン間でレプリケートされ、Microsoft のデータ保持ポリシーに基づいて削除される場合があります。Note, however, the custom entity and field names may be replicated across regions and are deleted in accordance with our data retention policies. Microsoft はお客様のプライバシーを尊重いたします。詳細については、Trust Center を参照してください。Microsoft is committed to your privacy as described further in our Trust Center.