Base de Connaissance - Français

Apprenez auprès des experts.
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
Exécuter un script Python dans Alteryx Question Puis-je exécuter mes scripts Python dans le concepteur Alteryx? Réponse Oui! Nous pouvons utiliser l'outil exécuter la commande pour faire exactement cela. Voici un exemple, fait dans la version 10.6, démontrant l'utilisation de l'outil exécuter la commande pour exécuter un script Python dans le concepteur et utiliser sa sortie dans le workflow: Pour un script Python, votre commande doit être Python .exe. Si le répertoire où python existe est dans votre variable PATH système, vous pouvez simplement taper Python .exe. Sinon, vous devrez lui donner le chemin complet, en gardant à l'esprit de citer la chaîne si il ya des espaces (par exemple, "Program Files"). Dans les arguments de commande, vous taperez l'emplacement de votre script Python (le répertoire de travail par défaut de Alteryx est le répertoire du module en cours d'exécution, donc il peut être plus facile de garder votre script dans le même dossier pour simplement taper "your_python_script" plutôt que la pleine (Path) et toutes les options nécessaires. N'oubliez pas de citer cette chaîne! L'exemple de script de l'attaché envoie simplement du texte à un fichier texte à utiliser comme entrée pour le concepteur (note: il ne s'exécutera pas, sauf si vous avez configuré votre environnement Python): Comme vous pouvez le voir, nous avons exécuté avec succès un script Python et utilisé l'entrée de résultats de lecture pour apporter le résultat du script dans le concepteur pour un traitement ultérieur. 10,5
Afficher l'article complet
Chaînage des workflows ensemble Nous recevons tout à fait quelques questions sur la façon de chaîner correctement les workflows ensemble. Nous avons quelques options qui dépendent de ce type de Alteryx que vous utilisez. Si vous avez le concepteur seulement, vos options sont d'utiliser les macros d'équipage qui sont trouvées sur la communauté. Aucun lien fourni à mesure que les outils sont mis à jour. Veuillez utiliser la recherche communautaire pour les dernières macros d'équipage. Dans l'ensemble des macros de l'équipage, les outils que vous allez chercher à utiliser sont les outils Runner. Vous pouvez trouver une description des outils ici outils Runner. Remarque: vous devrez créer un autre workflow à l'aide de ces macros pour exécuter les workflows. Si vous avez designer with Scheduler ou Alteryx Server, vous pouvez utiliser les macros de l'équipe sur le planificateur, mais ils ne sont pas en mesure d'être utilisés dans la Galerie. Vous avez d'autres options qui vous permettront de ne pas avoir à construire un autre workflow en utilisant les outils Runner et utiliser le workflow sur la galerie ou planificateur. Lorsque vous disposez d'un planificateur ou d'un serveur, vous avez accès à la commande Alteryx Engine. Cela permettra à Alteryx d'exécuter des workflows via la ligne de commande pour exécuter des workflows ou des programmes supplémentaires. Dans la plupart des cas, le AlteryxEngineCmd sera situé dans C:/Program Files/Alteryx/bin/AlteryxEngineCmd.exe. Super, alors qu'est-ce que je fais avec? Dans votre fenêtre de configuration de workflow, vous disposez d'un onglet appelé événements. Dans cet onglet, vous pouvez ajouter un événement de commande Run. Vous pouvez choisir d'exécuter la commande comme: Dans la commande: vous pouvez soit naviguer à votre AlteryxEngineCmd ou tapez dans l'emplacement comme so-c: Program Files Files/Alteryx/bin/AlteryxEngineCmd.exe Dans les arguments de commande [facultatif]: vous allez ajouter l'emplacement du 2ème Workflow avec le nom du workflow et du type de fichier. exemple: «C:/temp/NHL2. YXMD " Très important: Notez dans l'exemple ci-dessus que nous avons des citations autour de la chaîne. La raison en est que la commande a des difficultés avec les espaces dans les chemins d'accès au répertoire. En mettant des guillemets autour de la chaîne, cela indique à la commande d'ignorer essentiellement les espaces. Cependant, la meilleure pratique est de ne pas avoir des espaces dans vos chemins d'accès au répertoire lors de l'utilisation de cette commande. Échantillon: Note: cette méthode est une grande méthode, mais peut être capricieux. Si vous exécutez un autre processus de commande ou si vous n'avez pas d'accès admin aux dossiers, il peut provoquer des problèmes. Vous avez également une autre option! Vous pouvez transformer vos workflows en applications pour l'utilisation de la galerie ou du planificateur et les exécuter consécutivement. Lorsque vous faites glisser un outil d'interface sur la zone de travail, votre workflow va automatiquement passer à une application. Si vous ne souhaitez pas utiliser un outil d'interface, vous pouvez toujours modifier le workflow en une application pour utiliser l'option d'application chaînée. Une fois que vous modifiez le workflow en une application, vous pouvez utiliser la fenêtre concepteur d'interface pour enchaîner les applications ensemble. Remarque: lors de la création de workflows enchaînés à utiliser dans le planificateur et la Galerie, les workflows et les actifs du Workflow doivent être placés sur le serveur. En outre, le serveur doit avoir accès à toutes les connexions de base de données, répertoires de fichiers et les fichiers d'entrée. Vous voulez en savoir plus sur le concepteur d'interface? Interface-designer-partie-1 Voulez-vous programmer les workflows pour qu'ils s'exécutent de suite? Consultez cet article-planification-workflows-utilisation-Event-Run-commande Apps
Afficher l'article complet
Étiquettes