Un flux ordinaire lit les données que vous lui avez indiquées. Un flux réutilisable indique plutôt ce dont il a besoin, et la personne qui l’exécute fournit les données : quelqu’un sur une carte, l’appelant d’une API, ou un autre flux.
Vous le construisez une fois. Il s’exécute ensuite comme outil personnalisé sur une carte, comme API de flux et comme étape dans d’autres flux.
Indiquer ce que le flux reçoit
Ajoutez une étape « Entrée du flux » partout où le flux doit lire des données qui changent d’une exécution à l’autre. Donnez à chacune :
- un « Libellé », que les gens voient au moment de l’exécution;
- un « Type d'entrée » : « Couche », « Table » ou « Zone »;
- pour une couche, la « Géométrie » acceptée (laissez tout décoché pour accepter n’importe laquelle);
- si elle est « Obligatoire »;
- les « Champs exigés » que les données doivent contenir.
Un flux peut avoir autant d’entrées que nécessaire.
Chaque entrée a aussi un « Échantillon ». L’échantillon sert uniquement quand vous testez ou prévisualisez le flux. Personne qui exécute le flux plus tard ne reçoit vos données d’échantillon. Pour une zone, l’échantillon est « Tout », sauf si vous limitez le test à un rectangle.
Laisser les gens modifier un paramètre
Ouvrez une étape et activez « Demander à l'exécution » à côté d’un paramètre. La personne qui exécute le flux se voit alors demander cette valeur, avec votre libellé, votre texte d’aide et vos limites. La valeur que vous avez saisie reste la valeur par défaut.
Indiquer ce que le flux renvoie
Terminez chaque branche à renvoyer par une étape « Résultat du flux ». Donnez-lui un libellé et un « Type de résultat » : une couche ou une table. Un flux peut renvoyer plusieurs résultats.
Un flux réutilisable renvoie ses données par « Résultat du flux ». Il ne peut pas en plus écrire des fichiers ou des tables de lui-même; retirez donc les étapes d’écriture.
Le tester et l’enregistrer
Choisissez « Actions », puis « Rendre réutilisable… ». La boîte de dialogue présente ce que le flux reçoit, ce qui peut être réglé et ce qu’il renvoie. S’il manque quelque chose, elle le dit, avec un lien vers l’étape.
Appuyez sur « Tester avec les échantillons ». Le flux doit réussir un test avant de pouvoir être enregistré, et toute modification ultérieure du flux exige un nouveau test.
Enregistrez ensuite. Chaque enregistrement crée une nouvelle version, et une version ne change jamais. Modifier le flux plus tard ne touche rien de ce qui utilise déjà une version enregistrée, jusqu’à votre prochain enregistrement.
Utiliser un flux dans un autre flux
Ajoutez une étape « Sous-flux » et choisissez un flux réutilisable. Ses entrées deviennent les ports d’entrée de l’étape, ses résultats deviennent des ports de sortie, et ses paramètres d’exécution deviennent les paramètres de l’étape.
Une étape Sous-flux conserve la version que vous avez choisie. Quand une version plus récente est enregistrée, l’étape propose la mise à jour et ne change que si vous l’acceptez. L’ensemble s’exécute comme une seule exécution, avec un seul journal.
Supprimer et restaurer
Supprimer un flux le place dans la corbeille pendant 14 jours. Pendant ce temps, les outils et les étapes qui en dépendent affichent « Source dans la corbeille » et ne peuvent pas s’exécuter. Restaurez le flux et ils fonctionnent de nouveau. Après une suppression définitive, ils affichent « Source requise » et vous demandent de choisir un autre flux.
Tout ce qui est publié sur Tamaat Server continue de fonctionner dans les deux cas.