As of r380, Functions is generally available.
Read more in the Community thread.
Modifications des entrées ou des sorties
Adding, removing, or renaming inputs and outputs requires changes to app trigger actions that call the function.
Suivez cette procédure pour modifier la signature d’une fonction :
- Concevez soigneusement la structure des entrées et des sorties avant de déployer la fonction à grande échelle.
- Entrées : lorsque vous créez une fonction destinée à générer un nouvel enregistrement de table, prenez en compte toutes les colonnes types que la fonction doit remplir lors de la création de l’enregistrement, et pas seulement celles correspondant au premier cas d’utilisation.
- Sorties : les sorties courantes que vous pouvez intégrer à une fonction comprennent :
- Les identifiants des enregistrements de table créés par la fonction
- Les messages visibles par l’opérateur (stockés dans une variable par la logique de la fonction)
- Informez tous les développeurs d’applications avant d’apporter des modifications.
- Mettez à jour la fonction de manière systématique :
- Modifiez la fonction.
- Testez la fonction à l'aide du bouton « Tester » en utilisant des données d'entrée représentatives.
- Testez la fonction de bout en bout dans une application de développement.
- Mettez à jour chaque application pour mapper les nouvelles entrées et sorties.
- À partir de la version r351, la visibilité sur les emplacements d’utilisation d’une fonction est limitée (tant au niveau des applications concernées que de leur emplacement au sein d’une application). Depuis l’onglet « Versions » d’une application, vous pouvez voir quelles fonctions une version utilise.
- Pour les applications qui utilisent une fonction, cliquez sur le bouton « Afficher les erreurs » dans l’éditeur d’application. Une fenêtre modale affiche toutes les références à la fonction dans l’application qui ne fonctionnent pas.
- Testez chaque application en mode développeur.
- Publiez les applications.
Autre approche en cas de modifications majeures
Créez une nouvelle fonction avec une signature mise à jour et migrez les applications progressivement :
- Créez une nouvelle version de la fonction avec de nouveaux paramètres d'entrée (par exemple, CreateSample_v2).
- Migrez les applications hautement prioritaires vers la nouvelle version.
- Migrez les applications restantes au fil du temps.
- Dépréciez et archivez l'ancienne version de la fonction.
Modifier la logique interne de la fonction
Changes to internal function logic (decision trees, calculations, table operations) do not break apps. However, you need to publish apps with a new version to associate the new function logic.
Suivez cette procédure :
- Mettez à jour la logique de la fonction.
- Testez la fonction à l'aide du bouton « Test » en utilisant des données d'entrée représentatives.
- Testez la fonction de bout en bout dans une application de développement.
- Publiez une nouvelle version ( version ) des applications à associer à la fonction mise à jour.
- Surveillez les applications de production afin de détecter tout comportement inattendu.
Bon à savoir : utilisez une procédure de workflow de validation pour les fonctions utilisées dans les applications de production.
Ressources supplémentaires
{{snippet.Avez-vous trouvé ce que vous cherchiez ?}}