Les actions permettent aux utilisateurs d’interagir avec l’application pour changer l’adresse du client, ajouter un nouveau contact et modifier une photo.
Dans le langage 4D, une action permet d’ajouter, de modifier et de supprimer une entité ou une entité de sélection. Mais aussi, elle peut simplement exécuter une méthode de votre serveur 4D.
Pourquoi une action
Vous vous demandez peut-être pourquoi vous devez définir une action pour effectuer des opérations simples telles que l’ajout, la modification ou la suppression.
Rappelez-vous qu’un appareil mobile peut être hors ligne et fonctionner sans connexion Internet. Lorsqu’il se reconnecte au réseau, le périphérique mobile effectue la synchronisation des données. Mais, entre-temps, l’enregistrement peut avoir été modifié par une autre personne ou, dans un exemple métier, un article peut être en rupture de stock, un paiement déjà reçu, etc.
Une action permet donc à votre logique métier d’être cohérente et d’être vérifiée. Avant d’exécuter l’action sur le serveur 4D, vous pouvez vérifier si elle est valide et envisager une autre solution – ou rejeter l’action et en informer l’utilisateur mobile.
Définir votre première action
Dans ce tutoriel, nous allons voir comment traiter une action simple pour changer le statut et le pourcentage d’avancement.
Nous avons préparé la méthode de base « On Mobile App Action » et les méthodes 4D comme « modifyStatus » appelées par la méthode de base. Dans la vidéo, nous ajoutons une action dans le projet pour modifier une entité ou une sélection d’entités, et nous vous montrerons comment les lier à la méthode de base.
Utilisation des paramètres d’action
Dans ce tutoriel, nous allons aller plus loin et créer des actions avec des paramètres:
- une action Add qui permettra de créer une nouvelle tâche,
- une action Edit qui vous permettra de modifier des tâches existantes depuis l’application,
- une action Delete pour supprimer une entité.
Et nous allons suivre pas à pas la modification d’une entité.
Actions hors ligne
Un utilisateur de l’application peut modifier un enregistrement partout, même lorsqu’il travaille hors ligne. Toutes ces tâches sont placées dans la liste des actions en attente jusqu’à ce que le réseau soit accessible. Une fois que l’utilisateur est en ligne, toutes les actions en attente sont systématiquement synchronisées, exécutées, puis visibles dans la liste des actions terminées.
Actions rejetées
Vous pouvez rejeter une action envoyée au serveur par des utilisateurs mobiles pour une raison donnée. Par exemple, cela peut être parce que les paramètres de l’action envoyée ne correspondent pas aux valeurs attendues du côté du serveur.
Dans ce cas, vous pouvez envoyer un feedback aux utilisateurs de votre application, en leur indiquant que quelque chose s’est mal passé côté serveur à l’aide des propriétés statusText et error. Ensuite, l’utilisateur met à jour la tâche en attente et envoie à nouveau l’action.
Ensuite…
Voilà ! Vous savez maintenant comment ajouter, modifier ou supprimer une entité ou une sélection d’entités dans votre application mobile. Vous savez également que vous pouvez appeler une méthode 4D pour envoyer un e-mail, par exemple.
Pour aller plus loin, vous pouvez continuer avec le blog ou la documentation.