Base de Connaissance - Français

Apprenez auprès des experts.
TIPS de la semaine

Chaque semaine, découvrez de nouvelles astuces et bonnes pratiques pour devenir un expert !

Voir l'index
Apis in Alteryx: CURL et outil de téléchargement Les connexions API donnent accès à de nombreuses applications Web, systèmes de base de données ou programmes en exposant des objets ou des actions à un développeur dans un format abstrait qui peut facilement être intégré dans un autre programme. En d'autres termes, une API fonctionne comme un point d'intégration où vous pouvez accéder par programmation ou manipuler des informations pour un programme (ou Workflow) que vous construisez. Dans le contexte de l'utilisation du concepteur, les API sont le plus souvent utilisées pour accéder aux magasins de données, utiliser les services hébergés sur le Web tout en fusionnant ou créer des connecteurs. La plupart des API sont dans une architecture reposante, le style architectural du logiciel du World Wide Web, et généralement communiquer sur http avec les mêmes actions http, ou «verbes», que les navigateurs Web utilisent pour récupérer des pages Web et des données de transfert: Get, post, put, supprimer, parmi autres. En tant que tel, tout outil ou logiciel qui vous donne la possibilité d'utiliser le protocole de requête-réponse http vous permettra de communiquer avec ces API reposantes. Les trois que j'utilise le plus couramment pour établir mes connexions sont facteur (une application de test grande qui ressemble à la configuration de l'outil de téléchargement Alteryx), curl (un outil de ligne de commande et l'une des bibliothèques de transfert http/FTP prédominant), et le logiciel favori de tout le monde : Alteryx. Entre ces trois outils, et peut-être un moniteur de trafic Web comme Fiddler (cela vous permettra de voir les demandes http étant envoyés/reçus sur votre réseau), vous devriez être en mesure d'établir, de maintenir et d'automatiser la connectivité à peu près n'importe quelle API de repos de votre choix. Cet article expose brièvement comment le faire dans CURL et Alteryx afin que vous puissiez (1) facilement pivoter entre les deux pour plus de robustesse de dépannage/implémentation et (2) plus facilement mettre en œuvre des connexions API dans vos workflows Alteryx, même quand ils sont documentés par. La première étape de l'établissement d'une connexion API consiste à localiser la documentation du développeur. La qualité et le détail de la documentation pour une API est souvent le réactif limitant de l'établissement d'une connexion, donc assurez-vous d'utiliser une API qui a la meilleure fonctionnalité, puis la documentation. La documentation vous aidera à parcourir l'authentification de l'API avant d'introduire les différentes demandes que vous pouvez faire. Comme curl est fréquemment utilisé parmi les développeurs d'API, vous remarquerez que bon nombre des demandes d'exemple que vous avez introduites seront dans la syntaxe curl. Être capable de déchiffrer ces demandes CURL vous aidera à le recréer facilement dans un programme avec une interface, comme facteur ou Alteryx. Considérez les demandes Get et post ci-dessous (toutes incluses dans le workflow v 10.6 ci-joint pour référence-s'il vous plaît noter que le workflow ne s'exécutera pas en raison d'informations d'identification expurgées à l'API): La documentation nous donne une URL pour communiquer avec via une action http (deux dans ce cas, Get et post), spécifique à cette demande d'inscription des utilisateurs sur les critères de recherche: http://Community.lithium.com/Community-Name/restapi/VC/Search/Users. Il note également un paramètre, ou un argument, pour accompagner la demande-ces mots clés sont le plus souvent associés à la charge utile de la demande. Avec un argument de charge utile pour l'authentification (expurgée), nous allons utiliser ces éléments pour générer nos demandes. Pour les demandes CURL, n'hésitez pas à utiliser l'exécutable installé avec votre concepteur Alteryx, situé dans C:/Program Files/Alteryx/bin/RuntimeData/Analytic_Apps/ par défaut (vous pouvez obtenir votre propre téléchargement ici). Télécharger Demande en curl (ligne de commande): (l'option – i est utilisée pour inclure les en-têtes de réponse pour qu'ils ressemblent au format Alteryx ci-dessous) Demande en Alteryx outil de téléchargement: Publier Demande en curl (ligne de commande): Demande en Alteryx outil de téléchargement: Remarque: une série de commandes curl peut également être implémentée dans un fichier .bat à exécuter dans un workflow via l'outil exécuter la commande (la maîtriser ici). Traduction de la RequestsAbove vous pouvez voir des exemples côte à côte de la syntaxe de CURL et comment la demande de l'API serait regarder dans le concepteur. Bien que nous ne pouvons pas aller sur chaque type de demande que vous pourriez avoir besoin, nous pouvons vous équiper avec un dictionnaire de poche métaphorique qui vous aidera à traduire entre les deux: L'URL de votre demande CURL devra simplement faire son chemin vers le champ URL dans l'onglet de base de l'outil de téléchargement. Le délai d'attente (--connect-timeout dans CURL) peut être modifié dans l'onglet connexion. Les schémas ci-dessous identifient certains des éléments de notre table de recherche, mais dans la syntaxe: En outre, facteur, l'outil mentionné plus haut, peut construire des demandes beaucoup comme dans Alteryx et a un "générer du code" fonctionnalité qui va convertir la demande à la syntaxe de Curl utilisable qui peut être utile dans la traduction. Bien que ce qui précède permet d'élucider quelques-unes des similitudes entre CURL et Alteryx requêtes http, il ya aussi des spécificités notables à l'utilisation de chacun. Par exemple, CURL vous donnera beaucoup plus de contrôle sur les options de configuration plus granulaires pour chaque demande; des choses comme quelle version de http à utiliser, en passant des cookies, en utilisant des proxys, entre autres. Alteryx, d'autre part, vous donne la flexibilité de construire une demande entièrement différente de chaque ligne de données entrant dans l'outil de téléchargement, ce qui rend presque sans effort pour générer un grand nombre de demandes personnalisées à vos données ou d'automatiser les interactions API qui aurait autrement besoin de programmation intimidant. En outre, Alteryx rend beaucoup plus facile d'analyser une réponse API dans des données utilisables de telle sorte qu'il peut être mélangé avec vos autres datasets-tous à l'intérieur du même workflow qui a fait les demandes. Selon les types de demandes que vous allez faire à votre API, vous aurez à regarder les différents formats ci-dessus et de déterminer l'approche optimisée. Par exemple, que faire si vous avez besoin de configuration de demande très spécifique, mais vous vous voyez faire un grand nombre de demandes? Vous pouvez utiliser Alteryx pour automatiser l'écriture de toute la syntaxe de vos commandes curl dans un fichier .bat, puis exécuter ce fichier .bat dans un outil de commande Run à partir de Alteryx. Maintenant que vous connaissez les deux, choisissez judicieusement! 10,5
Afficher l'article complet
Comment écrire à plusieurs onglets séparément sans erreurs Avez-vous déjà essayé d'écrire à plusieurs onglets dans le même workflow et ont reçu une erreur comme ceci: "erreur: données de sortie: impossible d'ouvrir le fichier pour écrire: FULL_FILE_PATH fichier d'ouverture d'erreur .xlsx: FULL_FILE_PATH .xlsx: le processus ne peut pas accéder au fichier parce qu'il est utilisé par un autre processus."? Cela se produit parce que Excel, comme de nombreuses applications, sera confus si plusieurs processus sont en train de se produire à la fois, ce qui explique pourquoi vous ne pouvez pas avoir le même fichier Excel ouvert pendant que vous le lisez à Alteryx. Pour éviter l'écriture simultanée, il y a un outil impressionnant appelé le bloc jusqu'à l'outil fait qui empêchera ceci. Le bloc jusqu'à ce que l'outil Done attende jusqu'à ce que tous les processus en amont soient finis avant d'envoyer le travail en aval. Cet outil a trois sorties. Ce qui est utile à notre sujet dans ce cas est chaque sortie sera traitée dans l'ordre séquentiel. Pour illustrer: Cela sera toujours erreur parce que les outils de sortie dans Alteryx sont utilisés en même temps ainsi Excel sera confus. En revanche, cela fonctionnera toujours parce que le deuxième flux ne sera pas coup de pied jusqu'à ce que le premier flux est terminé. Donc, tout ce que vous avez à faire lors de l'écriture dans le même fichier, mais différents onglets est Assurez-vous d'utiliser un bloc jusqu'à ce que fait pour l'empêcher d'écrire dans le fichier Excel simultanément. Pour plus d'informations sur le bloc jusqu'à ce que l'outil Done cliquez ici. Meilleures pratiques
Afficher l'article complet
La macro cache DataSet v2 Vous pouvez télécharger la macro cache DataSet v2 à partir de la Alteryx Analytics Gallery (dans le district de macros) ici. Pourquoi la mise à jour? L'année dernière, j'ai fait un outil qui m'a permis de créer des «points d'enregistrement» dans mes workflows, et d'éviter de perdre du temps à exécuter l'intégralité du workflow après avoir effectué des modifications incrémentielles. Beaucoup de gens ont répondu à un billet de blog que j'ai écrit à ce sujet, et quelques grandes suggestions est sorti de cette discussion. Un utilisateur a même fait sa propre version mise à jour de la macro, parce qu'il voulait être en mesure de spécifier où les fichiers ont été enregistrés par la macro. C'était vraiment génial, et m'a inspiré à mettre en œuvre certaines des autres suggestions des utilisateurs avaient et partager la macro mise à jour du cache DataSet avec vous les gars ici. Merci à @ErikB de partager sa mise à jour avec moi! Espérons que cela devienne une tendance-si vous vous sentez comme une fonctionnalité est manquant, n'ayez pas peur de commencer à piquer autour des entrailles d'une macro et de faire vos propres changements et de les partager. Cela est bon pour tout le monde parce que cela signifie que nous pouvons faire de meilleurs outils ensemble par la collaboration, mais c'est aussi une excellente occasion d'apprendre de nouveaux modèles et astuces dans Alteryx. Qu'est-ce qui est différent dans cette version? Cette mise à jour est vraiment tout au sujet de la gestion du stockage et du nettoyage des fichiers mis en cache. Dans la version précédente de l'outil, tous les fichiers mis en cache seraient sauvegardés à l'endroit où la macro elle-même vivait. Mais ce n'était pas toujours souhaitable, et si vous l'utilisez beaucoup, vous pourriez vous retrouver avec un grand dossier de fichiers comme ceci: Donc, nous allons jeter un oeil à ce qui est nouveau dans la configuration de l'outil pour traiter ce problème: Pour la plupart, le premier onglet devrait paraître assez familier (et si non, revenir à la poste d'origine pour voir comment il fonctionne), mais il ya trois nouvelles options sous "Write mode" qui vous permettent de spécifier combien de temps vous voulez que les fichiers mis en cache à vivre. Si vous sélectionnez la première option ("Delete après l'arrêt de Alteryx"), les fichiers mis en cache seront écrits dans le répertoire Temp (et en lecture) du Alteryx, qui sera automatiquement effacé lors de la fermeture de Alteryx. Toutefois, si vous sélectionnez la deuxième option, les fichiers seront supprimés après un nombre de jours spécifié. Ceci est déclenché par l'exécution de la macro, donc si vous l'utilisez une fois et plus jamais, alors qu'un fichier mis en cache ne sera pas supprimé. Mais si vous utilisez l'outil régulièrement, alors il va effacer les anciens fichiers. (pour ce faire, la macro maintient un index des emplacements où les fichiers mis en cache ont été créés, puis à chaque fois qu'il est utilisé dans un workflow, il recherche les fichiers mis en cache dans les répertoires qui ont une date d'expiration qui est passée à échéance et les supprime.) (dans une version future, je peux regarder dans l'automatisation de ce avec schtasks.) Enfin, vous avez la possibilité de ne jamais supprimer un fichier mis en cache. (c'est ainsi que l'outil utilisé pour fonctionner.) L'onglet Options avancées Ici, vous pouvez indiquer à la macro où enregistrer les fichiers mis en cache. La première option ("default") va indiquer à la macro d'enregistrer dans un dossier dédié cached_datasets dans le répertoire AppData spécifique à l'utilisateur. Toutefois, si l'option "supprimer après l'arrêt de Alteryx" est sélectionnée dans l'onglet précédent, le fichier sera écrit (et lu à partir de) le répertoire Temp à la place. La deuxième option ("workflow Directory") indique à la macro d'enregistrer les fichiers dans le même répertoire que le workflow dans lequel vous avez inséré la macro cache DataSet v2. Enfin, si vous ne souhaitez pas que la macro vérifie les fichiers mis en cache périmés et les supprime, cochez la dernière option de cet onglet. Voilà. Profiter! Et de garder les commentaires à venir (et bien sûr, vos propres variations)! Teaser Je suis excité de dire que la fonctionnalité de mise en cache va être officiellement intégré dans le produit dans une version future d'une manière très élégante et rationalisée! (certains d'entre vous ont peut-être ramassé sur ce sujet dans le fil des suggestions de produits ici.) J'ai eu le plaisir d'être impliqué dans certaines des discussions de conception initiale autour de la nouvelle fonctionnalité, et je pense sincèrement que ça va être totalement jeu-changer à la façon dont nous développons des workflows dans Alteryx. (c'est tout ce que je peux partager à ce point, mais fera de mon mieux pour fournir des mises à jour comme ils deviennent disponibles!) : smileyvery-Happy: Cette mise à jour de la macro de DataSet de cache inclut des options pour gérer le stockage et le nettoyage des fichiers mis en cache. Cache
Afficher l'article complet
Étiquettes