翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# データアクションの作成、編集、または削除
<a name="data-entities-edit-data-actions"></a>

データアクションは、すべてのレコードの取得や ID によるレコードの取得など、エンティティのデータに対してアクションを実行するためにアプリケーションで使用されます。データアクションを使用して、テーブルや詳細ビューなどのコンポーネントに表示される、指定された条件に一致するデータを見つけて返すことができます。

**Contents**
+ [データアクションの作成](#data-entities-data-action-add)
+ [データアクションの編集または設定](#data-entities-data-action-edit)
+ [データアクション条件演算子と例](#data-entities-data-action-operators)
  + [データベースによる条件演算子のサポート](#data-entities-data-action-operators-support)
  + [データアクション条件の例](#data-entities-data-action-operators-examples)
+ [データアクションの削除](#data-entities-data-action-delete)

## データアクションの作成
<a name="data-entities-data-action-add"></a>

**ヒント**  
CTRL\+Z キーを押して、エンティティに対する最新の変更を元に戻すことができます。

1. 必要に応じて、データアクションを作成するエンティティに移動します。

1. **データアクション**タブを選択します。

1. データアクションを作成するには、次の 2 つの方法があります。
   + (推奨) AI を使用して、エンティティ名、フィールド、接続されたデータソースに基づいてデータアクションを生成するには、**データアクションの生成**を選択します。次のアクションが生成されます。

     1. `getAll`: エンティティからすべてのレコードを取得します。このアクションは、レコードのリストを表示したり、複数のレコードに対して一度にオペレーションを実行したりする必要がある場合に便利です。

     1. `getByID`: 一意の識別子 (ID またはプライマリキー) に基づいてエンティティから 1 つのレコードを取得します。このアクションは、特定のレコードに対してオペレーションを表示または実行する必要がある場合に便利です。
   + 単一のデータアクションを追加するには、 **\+ データアクションの追加**を選択します。

1. 新しいデータアクションを表示または設定するには、次のセクション「」を参照してください[データアクションの編集または設定](#data-entities-data-action-edit)。

## データアクションの編集または設定
<a name="data-entities-data-action-edit"></a>

1. 必要に応じて、データアクションを作成するエンティティに移動します。

1. **データアクション**タブを選択します。

1. **フィールド**で、クエリによって返されるフィールドを設定します。デフォルトでは、エンティティ内のすべての設定済みフィールドが選択されます。

   次の手順を実行して、**結合**をデータアクションに追加することもできます。

   1. ** \+ 結合を追加** を選択してダイアログボックスを開きます。

   1. **関連エンティティ**で、現在のエンティティと結合するエンティティを選択します。

   1. **エイリアス**で、必要に応じて関連エンティティの一時エイリアス名を入力します。

   1. **結合タイプ**で、目的の結合タイプを選択します。

   1. 各エンティティからフィールドを選択して結合句を定義します。

   1. **追加** を選択して結合を作成します。

   作成されると、結合セクションに**結合**が表示され、フィールドを**返すドロップダウンに追加のフィールド**が使用可能になります。エンティティ間の連鎖結合など、複数の結合を追加できます。結合されたエンティティのフィールドでフィルタリングおよびソートすることもできます。

   結合を削除するには、結合の横にあるごみ箱アイコンを選択します。これにより、それらのフィールドを使用して、その結合からすべてのフィールドが削除され、依存結合または制約が破棄されます。

1. **条件**で、クエリの出力をフィルタリングするルールを追加、編集、または削除します。ルールをグループに整理し、複数のルールを `AND`または `OR`ステートメントと連鎖させることができます。使用できる演算子の詳細については、「」を参照してください[データアクション条件演算子と例](#data-entities-data-action-operators)。

1. **ソート**で、属性を選択し、昇順または降順を選択して、クエリ結果のソート方法を設定します。ソートルールの横にあるごみ箱アイコンを選択すると、ソート設定を削除できます。

1. **変換結果**では、カスタム JavaScript を入力して、結果を表示またはオートメーションに送信する前に結果を変更またはフォーマットできます。

1. **出力プレビュー**で、設定されたフィールド、フィルター、ソート、JavaScript に基づいてクエリ出力のプレビューテーブルを表示します JavaScript 。

## データアクション条件演算子と例
<a name="data-entities-data-action-operators"></a>

条件演算子を使用して、設定された式値をエンティティ列と比較し、データベースオブジェクトのサブセットを返すことができます。使用できる演算子は、列のデータ型と、Amazon Redshift、Amazon Aurora、Amazon DynamoDB など、エンティティが接続されているデータベースのタイプによって異なります。

次の条件演算子は、すべてのデータベースサービスで使用できます。
+ `=` および `!=`: すべてのデータ型 (プライマリキー列を除く) で使用できます。
+ `<=`、`>=`、`<`、および `>=`: 数値列でのみ使用できます。
+ `IS NULL` および `IS NOT NULL`: null または空の値を持つ列を一致させるために使用されます。Null 値はデータベースごとに解釈が異なることがよくありますが、App Studio では、`NULL`オペレーターは接続されたデータベーステーブルに Null 値を持つレコードを照合して返します。

次の条件演算子は、それらをサポートするデータベースサービスに接続されているエンティティでのみ使用できます。
+ `LIKE` および `NOT LIKE`(Redshift、Aurora): 接続されたデータベースでパターンベースのクエリを実行するために使用されます。`LIKE` 演算子は、指定されたパターンに一致するレコードを検索して返すため、検索機能の柔軟性を提供します。パターンは、パターン内の任意の文字または文字のシーケンスに一致するワイルドカード文字を使用して定義します。各データベース管理システムには一意のワイルドカード文字のセットがありますが、最も一般的な 2 つは任意の文字数 (0 を含む) を表し`%`、1 文字`_`を表すことです。
+ `Contains` および `Not Contains` (DynamoDB): 大文字と小文字を区別する検索を実行して、指定されたテキストが列値内で見つかったかどうかを判断するために使用されます。
+ `Starts With` および `Not Starts With` (DynamoDB): 大文字と小文字を区別する検索を実行して、指定されたテキストが列値の先頭で見つかったかどうかを判断するために使用されます。

### データベースによる条件演算子のサポート
<a name="data-entities-data-action-operators-support"></a>

次の表は、App Studio に接続できる各データベースでサポートされているデータアクション条件演算子を示しています。


|  | =, \!=, <, >, <=, >= | LIKE、NOT LIKE | 含まれる、含まれない | で始まるが で始まらない | IS NULL、IS NOT NULL | 
| --- | --- | --- | --- | --- | --- | 
| **DynamoDB** | はい | いいえ | はい | はい | はい | 
| **Aurora** | はい  | はい | いいえ | なし | はい | 
| **Redshift** | はい  | はい | いいえ | なし | はい | 

### データアクション条件の例
<a name="data-entities-data-action-operators-examples"></a>

、、`name``city`および `hireDate`フィールドを持つ複数の項目を含む次のデータベーステーブルを検討してください。


| 名前 | city | hireDate | 
| --- | --- | --- | 
| アダム | Seattle | 2025-03-01 | 
| アドリエンヌ | Boston | 2025-03-05 | 
| Bob | アルバカーキ | 2025-03-06 | 
| Carlos | シカゴ | 2025-03-10 | 
| キャロライン | NULL | 2025-03-12 | 
| リタ | マイアミ | 2025-03-15 | 

ここで、指定した条件に一致する項目の `name`フィールドを返すデータアクションを App Studio で作成することを検討してください。次のリストには、条件の例と、それぞれに対してテーブルが返す値が含まれています。

**注記**  
例は SQL の例としてフォーマットされています。App Studio では表示されない場合がありますが、演算子の動作を説明するために使用されます。
+ `WHERE name LIKE 'Adam'`: を返します`Adam`。
+ `WHERE name LIKE 'A%'`: `Adam`と を返します`Adrienne`。
+ `WHERE name NOT LIKE 'B_B'`: `Adam`、`Adrienne`、`Carlos`、`Caroline`、および を返します`Rita`。
+ `WHERE contains(name, 'ita')`: を返します`Rita`。
+ `WHERE begins_with(name, 'Car')`: `Carlos`と を返します`Caroline`。
+ `WHERE city IS NULL`: を返します`Caroline`。
+ `WHERE hireDate < "2025-03-06"`: `Adam`と を返します`Adrienne`。
+ `WHERE hireDate >= DateTime.now().toISODate()`: は現在の日付`DateTime.now().toISODate()`を返します。現在の日付が 2025-03-10 のシナリオでは、式は `Carlos`、`Caroline`、および を返します`Rita`。

**ヒント**  
式で日付と時刻を比較する方法の詳細については、「」を参照してください[日付および時間](expressions.md#expressions-date-time)。

## データアクションの削除
<a name="data-entities-data-action-delete"></a>

App Studio エンティティからデータアクションを削除するには、次の手順に従います。

1. 必要に応じて、データアクションを削除するエンティティに移動します。

1. **データアクション**タブを選択します。

1. 削除するデータアクションごとに、**編集**の横にあるドロップダウンメニューを選択し、**削除**を選択します。

1. ダイアログボックスで**確認** を選択します。