Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Création, modification ou suppression d'actions relatives aux données
Les actions relatives aux données sont utilisées dans les applications pour exécuter des actions sur les données d'une entité, telles que la récupération de tous les enregistrements ou la récupération d'un enregistrement par ID. Les actions relatives aux données peuvent être utilisées pour localiser et renvoyer des données correspondant à des conditions spécifiques afin de les afficher dans des composants tels que des tableaux ou des vues détaillées.
Table des matières
Création d'actions relatives aux données
Astuce
Vous pouvez appuyer sur CTRL+Z pour annuler la dernière modification apportée à votre entité.
Si nécessaire, accédez à l'entité pour laquelle vous souhaitez créer des actions de données.
Choisissez l'onglet Actions relatives aux données.
Il existe deux méthodes pour créer des actions de données :
(Recommandé) Pour utiliser l'IA afin de générer des actions de données pour vous, en fonction du nom de votre entité, de vos champs et de la source de données connectée, choisissez Générer des actions de données. Les actions suivantes seront générées :
getAll: récupère tous les enregistrements d'une entité. Cette action est utile lorsque vous devez afficher une liste d'enregistrements ou effectuer des opérations sur plusieurs enregistrements à la fois.getByID: extrait un seul enregistrement d'une entité en fonction de son identifiant unique (ID ou clé primaire). Cette action est utile lorsque vous devez afficher ou effectuer des opérations sur un enregistrement spécifique.
Pour ajouter une seule action de données, choisissez + Ajouter une action de données.
Pour afficher ou configurer la nouvelle action de données, consultez la section suivante,Modifier ou configurer des actions relatives aux données.
Modifier ou configurer des actions relatives aux données
Si nécessaire, accédez à l'entité pour laquelle vous souhaitez créer des actions de données.
Choisissez l'onglet Actions relatives aux données.
Dans Champs, configurez les champs à renvoyer par la requête. Par défaut, tous les champs configurés de l'entité sont sélectionnés.
Vous pouvez également ajouter des jointures à l'action sur les données en effectuant les étapes suivantes :
Choisissez + Ajouter une jointure pour ouvrir une boîte de dialogue.
Dans Entité associée, sélectionnez l'entité que vous souhaitez associer à l'entité actuelle.
Dans Alias, entrez éventuellement un nom d'alias temporaire pour l'entité associée.
Dans Type de jointure, sélectionnez le type de jointure souhaité.
Définissez la clause de jointure en sélectionnant les champs de chaque entité.
Choisissez Ajouter pour créer la jointure.
Une fois créée, la jointure sera affichée dans la section Jointures, rendant des champs supplémentaires disponibles dans la liste déroulante Champs à renvoyer. Vous pouvez ajouter plusieurs jointures, y compris des jointures enchaînées entre les entités. Vous pouvez également filtrer et trier par champs les entités jointes.
Pour supprimer une jointure, cliquez sur l'icône de la corbeille située à côté de celle-ci. Cela supprimera tous les champs de cette jointure et supprimera toutes les jointures dépendantes ou les contraintes utilisant ces champs.
Dans Conditions, ajoutez, modifiez ou supprimez des règles qui filtrent le résultat de la requête. Vous pouvez organiser les règles en groupes et enchaîner plusieurs règles avec des
ORinstructionsANDou. Pour plus d'informations sur les opérateurs que vous pouvez utiliser, consultezOpérateurs de conditions d'action sur les données et exemples.Dans Tri, configurez la façon dont les résultats de la requête sont triés en choisissant un attribut et en choisissant l'ordre croissant ou décroissant. Vous pouvez supprimer la configuration de tri en choisissant l'icône de corbeille à côté de la règle de tri.
Dans Transformer les résultats, vous pouvez saisir une valeur personnalisée JavaScript pour modifier ou mettre en forme les résultats avant qu'ils ne soient affichés ou envoyés aux automatismes.
Dans Aperçu de la sortie, affichez un tableau d'aperçu de la sortie de la requête en fonction des champs, des filtres, du tri et des paramètres configurés JavaScript.
Opérateurs de conditions d'action sur les données et exemples
Vous pouvez utiliser des opérateurs de condition pour comparer une valeur d'expression configurée à une colonne d'entité afin de renvoyer un sous-ensemble d'objets de base de données. Les opérateurs que vous pouvez utiliser dépendent du type de données de la colonne et du type de base de données auquel l'entité est connectée, comme Amazon Redshift, Amazon Aurora ou Amazon DynamoDB.
Les opérateurs de condition suivants peuvent être utilisés avec tous les services de base de données :
=et!=: Disponible pour tous les types de données (à l'exception des colonnes de clé primaire).<=,>=<, et>=: Disponible uniquement pour les colonnes numériques.IS NULLetIS NOT NULL: Utilisé pour faire correspondre les colonnes contenant des valeurs nulles ou vides. Les valeurs nulles sont souvent interprétées différemment dans chaque base de données. Toutefois, dans App Studio, l'NULLopérateur fait correspondre et renvoie les enregistrements contenant des valeurs nulles dans la table de base de données connectée.
Les opérateurs de condition suivants ne peuvent être utilisés que dans les entités connectées aux services de base de données qui les prennent en charge :
LIKEetNOT LIKE(Redshift, Aurora) : utilisés pour effectuer des requêtes basées sur des modèles dans la base de données connectée. L'LIKEopérateur offre une fonctionnalité de recherche flexible car il trouve et renvoie des enregistrements correspondant aux modèles spécifiés. Vous définissez les modèles à l'aide de caractères génériques qui correspondent à n'importe quel caractère ou séquence de caractères du modèle. Chaque système de gestion de base de données possède un ensemble unique de caractères génériques, mais les deux plus courants sont%de représenter un nombre quelconque de caractères (y compris 0) et_de représenter un seul caractère.ContainsetNot Contains(DynamoDB) : utilisé pour effectuer une recherche sensible aux majuscules et minuscules afin de déterminer si le texte donné se trouve dans les valeurs des colonnes.Starts WithetNot Starts With(DynamoDB) : utilisé pour effectuer une recherche sensible aux majuscules et minuscules afin de déterminer si le texte donné se trouve au début des valeurs des colonnes.
Support des opérateurs conditionnelles par base de données
Le tableau suivant indique quels opérateurs de condition d'action des données sont pris en charge par chaque base de données pouvant se connecter à App Studio.
| =, !=, <, >, <=, >= | COMME, PAS COMME | Contient, ne contient pas | Commence par, ne commence pas par | EST NUL, N'EST PAS NUL | |
|---|---|---|---|---|---|
|
DynamoDB |
Oui |
Non |
Oui |
Oui |
Oui |
|
Aurora |
Oui |
Oui |
Non |
Non |
Oui |
|
Redshift |
Oui |
Oui |
Non |
Non |
Oui |
Exemples de conditions d'action sur les données
Examinez la table de base de données suivante, qui inclut plusieurs éléments name comportant des hireDate champscity, et.
| name | city | Date d'embauche |
|---|---|---|
|
Adam |
Seattle |
01/03/2025 |
|
Adrienne |
Boston |
05/03/2025 |
|
Bob |
Albuquerque |
06/03/2025 |
|
Carlos |
Chicago |
10/03/2025 |
|
Caroline |
NULL |
12/03/2025 |
|
Rita |
Miami |
15/03/2025 |
À présent, envisagez de créer des actions de données dans App Studio qui renvoient le name champ pour les éléments répondant à des conditions spécifiées. La liste suivante contient des exemples de conditions et les valeurs que le tableau renvoie pour chacune d'entre elles.
Note
Les exemples sont mis en forme sous forme d'exemples SQL. Ils peuvent ne pas apparaître comme dans App Studio, mais ils sont utilisés pour illustrer le comportement des opérateurs.
WHERE name LIKE 'Adam': RetoursAdam.WHERE name LIKE 'A%': RenvoieAdametAdrienne.WHERE name NOT LIKE 'B_B': RenvoieAdamAdrienne,Carlos,Caroline, etRita.WHERE contains(name, 'ita'): RetoursRita.WHERE begins_with(name, 'Car'): RenvoieCarlosetCaroline.WHERE city IS NULL: RetoursCaroline.WHERE hireDate < "2025-03-06": RenvoieAdametAdrienne.WHERE hireDate >= DateTime.now().toISODate(): Notez que celaDateTime.now().toISODate()renvoie la date actuelle. Dans un scénario où la date actuelle est le 10 mars 2025, l'expression renvoieCarlos, etCaroline.Rita
Astuce
Pour plus d'informations sur la comparaison des dates et des heures dans les expressions, consultezDate et heure.
Supprimer des actions relatives aux données
Suivez la procédure suivante pour supprimer des actions de données d'une entité App Studio.
Si nécessaire, accédez à l'entité pour laquelle vous souhaitez supprimer des actions relatives aux données.
Choisissez l'onglet Actions relatives aux données.
Pour chaque action de données que vous souhaitez supprimer, choisissez le menu déroulant à côté de Modifier, puis choisissez Supprimer.
Choisissez Confirmer dans la boîte de dialogue.
