Instructions sur la création d’applications

Pour les applications Web, vous pouvez uniquement lire et écrire dans les fichiers se trouvant dans le même dossier que votre application ou dans un dossier inférieur ; en d'autres termes, tout dossier qui se trouve dans le dossier contenant l'application (le sous-dossier peut être situé plusieurs niveaux sous le dossier de l'application). Cette règle s'applique également aux macros que vous souhaitez utiliser pour votre application, sauf s'il s'agit d'une macro standard faisant partie du programme d'installation du produit Alteryx ou d'un programme d'installation de données.

Lorsque vous utilisez l' outil Action pour mettre à jour/modifier la valeur, n'utilisez pas l'option Remplacer une chaîne spécifique  : sauf si vous n'avez pas le choix. Si vous modifiez la configuration de l'outil au sein de votre workflow dans le cadre d'un processus de développement continu, vous pouvez éliminer cet outil Action, car il se peut que cette chaîne n'existe plus. Évidemment, à certains moments vous devez utiliser cette option. Mais n'oubliez pas que, si vous modifiez cette chaîne dans l'outil, vous risquez de devoir également mettre à jour l'outil Action.

Si vous utilisez un outil Action pour mettre à jour un outil Détour , essayez d'être complet et de mettre à jour le détour pour les deux cas possibles, c'est-à-dire le détour gauche et le détour droit. Si vous ne mettez à jour que l'un de ces choix et si vous modifiez le workflow au cours du développement, vous n'aurez pas anticipé les moments où le workflow devra emprunter un autre chemin.

Tous les détours doivent être finalisés, particulièrement avant de joindre les flux de données d’un détour à un autre endroit du workflow. Un outil Fin du détour n'a pas besoin d'être configuré, ce qui le rend très simple d'emploi. N'oubliez pas de les utiliser ou de finaliser le détour avec un outil de sortie.

Lorsque vous écrivez des questions, pensez à vos utilisateurs en anticipant les erreurs les plus courantes. Vous pouvez créer des avertissements au moyen d'un outil Message d'erreur . Par exemple, si l'utilisateur doit sélectionner une option, affichez un message d'erreur lorsqu'il ne sélectionne rien. Cela peut éviter que le moteur n'indique des erreurs trop complexes pour que l'utilisateur puisse comprendre comment les corriger. Dans l'idéal, vous devez prévoir un message d'erreur pour chaque question destinée à l'utilisateur. Vous pouvez également prévoir des conditions plus complexes pour vous assurer que le contenu sera correctement renseigné. Par exemple, si l’utilisateur doit indiquer dans une zone de texte jusqu’à 5 zones de chalandise séparées par virgules (par exemple 1, 2, 3, 4, 5), vous pouvez utiliser une expression régulière pour vérifier qu’il n’y a pas plus de 4 virgules dans la zone de texte.

Vous pouvez également tenter d'anticiper les cas où l'application peut avoir un problème même lorsqu'elle est correctement configurée. Par exemple, l'utilisateur peut saisir une adresse qui n'est pas géocodable et qui ne renvoie aucun résultat. Vous pouvez aisément gérer les messages dans votre application en filtrant les géocodes erronés puis en utilisant l' outil Message pour informer l'utilisateur : « L'adresse saisie n'est pas géocodable. Vérifiez que l’adresse est valide et apportez les modifications nécessaires ou indiquez une autre adresse et relancez l’exécution. »

Si vous mettez à jour le XML brut pour un outil ou si vous utilisez des caractères spéciaux dans vos applications, n'oubliez pas que sur le Web, le résultat ne sera pas forcément celui attendu. Par exemple, une sélection de l' outil Liste déroulante ou l' outil Zone de liste sur le moteur peut contenir du texte tel que : Age By Sex Summary Report:<Report Type=”summary”>Age By Sex Summary Report</Report>

Pourtant, sur le Web la question ne s'affiche pas correctement. Par conséquent, pour une action vous n'obtenez probablement pas l'effet souhaité. Pour corriger ce problème, vous pouvez modifier le texte : Age By Sex Summary Report:<Report Type="summary">Age By Sex Summary Report</Report>

Alors, si vous utilisez la réponse à la question dans une action, vous devrez la mettre à jour comme suit : EscapeXMLMetacharacters([AllocateSummaryReport])

La fonction d'échappement des métacaractères XML a été ajoutée à la bibliothèque de formules dans la version 8.0. Vous pouvez y accéder depuis la catégorie spécialisée. Cette fonction remplace tous les métacaractères XML par les versions avec échappement.

Il est préférable de ne pas ajouter l' outil Union configuré manuellement dans les applications. En effet, dans la plupart des cas, le workflow change au moment de l'exécution. Au lieu de configurer l’outil Union en mode manuel, insérez des outils Sélectionner dans chaque connexion alimentant l'outil Union. Lorsque vous configurez l'outil Sélectionner, renommez et réorganisez les champs à votre convenance en prenant soin de ne pas inclure les champs de type Dynamique/Inconnu. Configurez l’outil Union à l’aide de la fonction Configuration auto par nom ou Configuration auto par position.

L’organisation de l’application est effectuée en partie à l’aide de plusieurs conteneurs d’outils pour les différentes sections de l’application. Par exemple, tous les outils de génération de rapports figurent généralement dans la dernière section d'une application et peuvent être placés dans un conteneur d'outils appelé « Génération de rapports ».

Un outil Conteneur d'outils peut être être codé par couleur suivant la fonction qu'il met en évidence. Le codage couleur des conteneurs d'outils permet de comprendre plus facilement ce que fait une application, en particulier lorsqu'elle est visualisée avec un petit zoom. Il s'avère utile pour dépanner ou déboguer une application créée par un tiers.

Les outils Interface doivent être placés dans leurs propres conteneurs et identifiés comme il se doit avec des couleurs. Pour les applications contenant plusieurs onglets, il est utile de placer les outils composant chaque onglet dans leur propre conteneur.

Les annotations sont des zones de texte associées à un outil spécifique. Elles peuvent être très utiles pour décrire le rôle de chaque outil. Il est très intéressant de noter que, si vous déplacez l’outil, l’annotation se déplace également. Sous Configuration du workflow , définissez les annotations  sur Afficher.

Si nécessaire, vous pouvez placer des annotations en haut ou en bas d'un outil.  Pour modifier l' annotation , cliquez sur l'outil , sélectionnez l'onglet Annotation et sélectionnez ou désélectionnez Placer l'annotation en haut .

Un outil Entrée de macro doit inclure des données. L’ajout des données est très important pour faciliter le dépannage ou le débogage des problèmes. Une saisie de texte est intégrée à l’outil Entrée de macro. Il s’agit de la méthode recommandée pour l’entrée des macros. Si vous avez besoin d’un fichier plus volumineux pour l’entrée de données, vous devez l’incorporer à la macro dans la mesure du possible. Les dépendances des fichiers de données pour les macros doivent être nommées selon le modèle suivant :

Nomdelamacro.Nomdufichierdedonnées.yxdb

Les noms d’entrées et de sorties ne doivent pas être associés à un numéro d’outil. Dans l’onglet Propriétés de l’outil Entrée de macro, vérifiez que le nom est suffisamment descriptif. Le nom que vous spécifiez ici est visible par les utilisateurs lorsqu'ils configurent l'outil macro.

Lorsqu'il existe plusieurs entrées et sorties, l'ajout d'une abréviation du connecteur aide l'utilisateur à configurer l'outil en fournissant une étiquette sur l'ancrage d'outil lorsque l'outil est placé sur le canevas. Pour plus d'informations, consultez la section Outil Entrée de macro ou Outil Sortie de macro .

Les noms d’onglets doivent être descriptifs pour aider l’utilisateur à configurer l’outil Macro. Les onglets sont visibles par l'utilisateur au moment de la configuration. Le nom d'onglet par défaut est « Questions ». Il n'est pas très descriptif et il est généralement laissé tel quel lors du développement de macros (ou d'applications) ne contenant qu'un seul onglet. Voir Fenêtre Concepteur d'interface .

Les macros connexes utilisées dans un workflow parent doivent être enregistrées avec la macro parente ou dans un répertoire annexe et nommées ainsi : Nomduparent.Nomconnexe.yxmc .