Utilisation d'un contexte de données

Informations d'arrière-plan

Pour plus d'informations sur les entités, consultez les guides suivants :

• À propos du contexte de données
• Fonction : Filtre
• Fonction : Tri
• Fonction : Nouveau (New)
• Fonction : Recherche
• Règle : Créer/Mettre à jour un enregistrement d’entité
• Règle : Supprimer un enregistrement d’entité

Vue d'ensemble (Overview)

Avant de commencer cet exemple, assurez-vous que vous disposez des autorisations appropriées délivrées par le Data Service. Pour plus d'informations, consultez la page Data Service. - Gestion de l'accès.

Pour les besoins de cet exemple, nous utiliserons une entité appelée Client avec les champs suivants :

• Address
• Adresse 2
• Ville
• E-mail (Email)
• Nom
• Téléphone
• Plan
• État (State)
• Code postal

Configuration du contexte de données

1. Ouvrez votre application déjà existante ou lancez-en une nouvelle.
2. Créer une nouvelle table

3. Ajoutez une entité à votre application en cliquant sur le bouton Ajouter en haut de la zone de dessin et en sélectionnant Entité.

   
   

   

   
   
4. Liez la nouvelle entité de la table en l'ajoutant dans le champ Source de données (Data Source) de la table.
5. Ajoutez l'expression suivante dans le champ Contexte de données (Data Context) de la page principale : =Lookup(Customer, [Name, "=", "Demo"]).
   
   

   

   
   
6. Ajoutez un nouveau contrôle de zone de texte.

7. Ajoutez le contexte de données Nom dans le champ Texte par défaut du contrôle de zone de texte. L'aperçu de l'application et de la zone de texte doit afficher le texte configuré à l'aide du contexte de données.

   
   

   

   
   

Utilisation du contexte de données dans les règles

Règle Créer/Mettre à jour un enregistrement d’entité

Le contexte de données ne peut être utilisé que pour mettre à jour une entité existante à l'aide de la règle Créer/Mettre à jour un enregistrement d'entité.

1. Ouvrez votre application déjà existante ou lancez-en une nouvelle.
2. Créer une nouvelle table

3. Ajoutez une entité à votre application en cliquant sur le bouton Ajouter en haut de la zone de dessin et en sélectionnant Entité.

   
   

   

   
   
4. Liez la nouvelle entité de la table en l'ajoutant dans le champ Source de données (Data Source) de la table.
5. Ajoutez l'expression suivante dans le champ Contexte de données (Data Context) de la page principale : =Lookup(Customer, [Name, "=", "Demo"]).
   
   

   

   
   
6. Ajoutez un nouveau contrôle de bouton.

7. Configurez la règle Créer/Mettre à jour un enregistrement d’entité pour le bouton. Ajoutez le contexte de données Client-Page principale dans le champ Quel enregistrement d'entité doit être créé/mis à jour ? . La règle doit être renseignée avec le contexte de données configuré.

   
   

   

   
   

Règle Supprimer un enregistrement d’entité

1. Ouvrez votre application déjà existante ou lancez-en une nouvelle.
2. Créer une nouvelle table

3. Ajoutez une entité à votre application en cliquant sur le bouton Ajouter en haut de la zone de dessin et en sélectionnant Entité.

   
   

   

   
   
4. Liez la nouvelle entité de la table en l'ajoutant dans le champ Source de données (Data Source) de la table.
5. Ajoutez l'expression suivante dans le champ Contexte de données (Data Context) de la page principale : =Lookup(Customer, [Name, "=", "Demo"]).
   
   

   

   
   
6. Ajoutez un nouveau contrôle de bouton.

7. Configurez la règle Supprimer un enregistrement d’entité pour le bouton. Ajoutez le contexte de données Client-Page principale dans le champ Quel enregistrement d'entité doit être supprimé ? . La règle doit supprimer le contexte de données configuré.

   
   

   

   
   

Utilisation de la fonction Nouveau

1. Ouvrez votre application déjà existante ou lancez-en une nouvelle.
2. Créer une nouvelle table

3. Ajoutez une entité à votre application en cliquant sur le bouton Ajouter en haut de la zone de dessin et en sélectionnant Entité.

   
   

   

   
   
4. Liez la nouvelle entité de la table en l'ajoutant dans le champ Source de données (Data Source) de la table.
5. Ajoutez l'expression suivante dans le champ Contexte de données (Data Context) de la page principale : =New(Customer).
   
   

   

   
   

6. Ajouter deux commandes de zone de texte :

   • Ajoutez Data Context.Name dans la propriété Liaison de valeur de la première commande de zone de texte.
   • Ajoutez Data Context.City dans la propriété Liaison de valeur de la deuxième commande de zone de texte.
7. Ajoutez un nouveau contrôle de bouton.
8. Configurez la règle Créer/Mettre à jour un enregistrement d’entité pour le bouton. Ajoutez le contexte de données Client dans le champ Quel enregistrement d'entité doit être créé/mis à jour ? . Ce faisant, les données sont automatiquement liées aux champs.

9. Supprimer les données inutilisées des champs. Assurez-vous de conserver les données configurées à l'étape 6 dans les champs Valeurs à définir.

   
   

   

   
   

Résultats de la procédure

Lors du runtime, lorsque vous ajoutez le nom et la ville du nouveau client dans les deux champs de texte et que vous cliquez sur le bouton, une nouvelle entrée est ajoutée au tableau.

Référencement d'entités de différentes pages

Pour faire référence directement à une valeur de champ d'entité sélectionnée à partir d'un tableau dans une page différente, vous devez utiliser au moins une variable.

Au lieu de créer des variables pour chaque champ, vous pouvez en utiliser une pour l'identifiant de l'entité. Sur la deuxième page, vous pouvez effectuer les actions suivantes :

1. Ajouter une commande de conteneur.
2. Configurez la propriété Contexte de données du conteneur comme suit : Lookup (Entity, [id, "=", myVariableID]).
3. Ajoutez les commandes nécessaires à l'intérieur du conteneur et liez-les aux champs disponibles pour l'entité disponible dans Contexte de données.

Vous pouvez utiliser la fonction Recherche dans ce cas car vous pouvez la traiter comme un objet entité. Cela signifie que vous pouvez mettre à jour cette entité à l'aide de la règle Créer/Mettre à jour l'enregistrement d'entité sur le contexte de données du conteneur.