エンティティをカスタマイズする

はじめに

Data Service には、システム組み込みフィールドがあります。新しいエンティティを作成すると、一連の既定フィールドが自動的に作成されますが、固有のフィールドを追加することで、定義したエンティティをカスタマイズできます。

フィールドの型

以下の型のフィールドを作成できます。

Text: 少量のテキストの保存に使用します。
Number: 数値の保存に使用します。正または負の値を指定できます。使用する小数点以下の桁数を指定する必要があります。
Yes/No: [はい] または [いいえ] の値の選択に使用します。
Date-Time: 日付と時刻を含む値の保存に使用します。日付と時刻は、日付の選択カレンダーを使用して選択できます。
Relationship: 2 つのエンティティ間のリレーションシップの作成に使用します。
Choice Set: 列挙値のリストを保存し、そこから 1 つまたは複数の値を選択できるようにするために使用します。
File: ファイルの保存に使用します。
Auto-number: レコードインデックスを自動的に増やすために使用します。

注: フィールドの型ごとに異なる詳細情報を指定する必要があります。詳細については、「エンティティフィールドの型」に記載されたリンクから、各フィールド固有のページにアクセスしてください。

フィールドを作成する

エンティティデータにフィールドを追加するには、以下の手順を実行します。

[エンティティ] のリストから、フィールドを追加するエンティティを選択します。そのエンティティに定義されたフィールドのリストを含む [フィールド] タブが表示されます。
[新しいフィールドを作成] をクリックすると、[フィールドを作成] ウィザードが開きます。
新しいフィールドの [表示名] を入力します。[表示名] は、Studio にエンティティをインポートしたときに表示される名前です。このフィールドはエンティティの作成後に変更できます。
新しいフィールドの [名前] を入力します。[名前] には英数字を使用できますが、先頭は文字である必要があります。3 文字から 30 文字で設定する必要があります。

注:
[名前] フィールドには、[表示名] に指定した値が自動的に入力されます。値は、エンティティの作成プロセス中にのみ変更できます。エンティティの作成後は [名前] フィールドは編集できなくなります。
ドロップダウンリストから [型] フィールドを選択します。
ユーザーにフィールドの値の指定を強制するには、[必須] チェックボックスをオンにします。
フィールドレコードに一意の値を強制するには、[一意の値のみ] チェックボックスをオンにします。

重要:
このオプションは、[Text] フィールド型と [Number] フィールド型で使用できます。

必要に応じて、数値に設定された小数の桁数を最大まで入力しましょう。そうしないと、Data Service は数値を少数の最大桁数まで切り上げてしまい、一意性に関するエラーが発生してしまいます。たとえば、小数点以下の精度を 3 桁に設定した上で 3.015 や 3.0148 などの値を入力すると、後者の値は 3.015 に切り上げられ、一意性に関するエラーが発生してしまいます。

このオプションでは大文字と小文字が区別されません。つまり、「Unique Value」と「unique VALUE」は重複として識別されます。

[詳細を表示] をクリックして、任意のフィールドレコードのプロパティを以下のとおりに設定します。

オプション	説明
最長文字数	[Text] フィールドに、ユーザーが指定できる最大文字数を設定します。既定では、200 文字まで使用できます。
最大値	[Number] フィールドに、ユーザーが指定できる最大値を設定します。既定値は `1,000,000,000,000` です。
最小値	[Number] フィールドに、ユーザーが指定できる最小値を設定します。既定値は `-1,000,000,000,000` です。
小数点以下桁数	[Number] フィールドに、ユーザーが指定できる小数点以下の桁数を指定します。既定値は `2` です。これにより、`23,45` など、少数点以下の桁数が 2 つの数値が指定できます。
既定値	ユーザーがデータを指定しない場合に使用する既定値を設定します。
説明	フィールドの説明を追加します。
ロールベースのフィールドアクセス	明示的な権限を付与することでデータへのアクセスを制限するには、このオプションを選択します。

(任意) [フィールドを作成] ウィザードを開いたままにするには、[もう 1 つ作成] チェックボックスをオンにします。これにより、手順の手順 2 をスキップすることができるため選択したエンティティで複数のフィールドを迅速に作成できます。
[保存] をクリックします。

[フィールド] リストに新しいフィールドが表示されます。

フィールドを更新する

作成したフィールドを更新するには、以下の手順を実行します。

注:

システム組み込みフィールドは更新できません。
カスタマイズされたフィールドの [名前] と [型] は変更できません。

[フィールド] タブで、編集するフィールドの上にカーソルをホバーさせます。
項目に対応する [フィールドを編集] アイコンをクリックします。アイコンは、行の右側に表示されています。
[フィールドを編集] パネルが表示されます。変更を加えます。

注:
フィールドが [一意の値のみ] オプションをオンにした状態で作成された場合は、オプションをオフにすることで重複を再度許可できます。 [一意の値のみ] チェックボックスをオフにすると、後から再度選択できなくなる点にご注意ください。
[保存] をクリックします。

フィールドを削除する

作成したフィールドを削除するには、以下の手順を実行します。

注: システム組み込みフィールドは削除できません。

[フィールド] タブ上で、削除するフィールドの上にカーソルをホバーさせます。
フィールドの行の最後にある [その他のオプション] メニューをクリックし、[削除] を選択します。
[削除] ボタンをアクティブ化するには、[フィールドを削除] ダイアログにフィールドの表示名を入力します。
[削除] をクリックして操作を確定します。

ロールベースのフィールドアクセスを有効化または無効化する

ロールベースのフィールドアクセスを使用すると、データアクセスを制限できます。ロールベースのフィールドアクセスを有効化できるのはカスタムフィールドに対してのみです。システムの組み込みフィールドでは使用できません。

フィールドに対して [ロールベースのフィールドアクセス] オプションを有効化した後は、ユーザーがフィールドにアクセスするための明示的な権限が付与されるようにロールを更新する必要があります。詳しくは、「アクセス権を管理する」をご覧ください。

注: 標準のロールでは、ロールベースのフィールドアクセスに対して有効なフィールドのデータにはアクセスできなくなります。このデータへのアクセス権が必要なユーザーには、フィールド内のデータにアクセスする権限を含むカスタムロールが割り当てられている必要があります。

[フィールド] タブで、ロールベースのフィールドアクセスを有効化 (または無効化) するフィールドにカーソルを合わせます。
フィールドの行の端にある [その他のオプション] メニューをクリックし、メニューから [ロールベースのフィールドアクセスを有効化] (または [ロールベースのフィールドアクセスを無効化]) オプションを選択します。
[有効化] (または [無効化]) をクリックして操作を確定します。

確認メッセージが表示されます。以下の画像でご確認ください。

重要: フィールドに対して [ロールベースのフィールドアクセス] を有効化すると、ユーザーに割り当てられている既存ロールにフィールドレベルの権限が含まれてない場合は、ユーザーはそのフィールド内のデータにアクセスできなくなります。
[ロールを管理] をクリックして、[ユーザー管理] ページの [ロール] タブを開きます。ここでカスタムロールを更新してフィールドへのアクセス権を付与できます。