In the case of my team, we used some data to try and predict how long an employee might stay at a certain organization.<\/p>\n
This was my first foray into Machine learning, so it was not a complex model by any means. I used the Azure Machine Learning<\/a> studio to build the model, and one of the things I noticed was it could also set up a Predictive Web Service to interact with the model. By default, you can use Excel to input data into the model and get a prediction as an output, but that was way too bland and boring for me!<\/p>\n I\u2019m going to use PowerApps<\/a> and Flow<\/a> for this. We need to have something ready in a day and a half, so I am absolutely firing up these two to get something out there fast. But, with connecting to an ML web Service, there are some caveats:<\/p>\n Now, since I only needed this to work for a short amount of time, I was able to use a P1 trial, but be aware of the above if you want to work with Custom Connectors.<\/p>\n I wanted Flow to handle the input\/output of the data for a few reasons. Flow is much more flexible with sending and receiving JSON data, and it\u2019s much easier to troubleshoot when connecting to a web service.<\/strong> So, we\u2019re going to need to create a custom connector to bridge the gap between the model and Flow.<\/p>\n We need to go to Flow, expand the Data menu, and click on \u201cCustom Connectors.\u201d On this screen, we can now \u201cCreate a Custom Connector.\u201d When you click this button, you receive a few options on how to get the endpoint details. The Azure ML endpoint uses Swagger to define the endpoint. In my testing, I found that \u201cImport an OpenAPI\u201d from URL just errors out, so I used \u201cImport a Postman Collection.<\/p>\n But, this also means we now need to create a Postman Collection.<\/p>\n Postman is a tool if you do any development for API\u2019s, and it\u2019s free! I\u2019m not going to go into the full functionality of the product in this article, but you can download it here<\/a>.<\/p>\n Once installed, open up Postman, and in the top bar, click on \u201cImport.\u201d Since we now have connectivity to the API, we can test it to ensure it works. I\u2019m going to test the POST functionality of the Request-Response endpoint. Now, if I click \u201cSend\u201d to send a request to the endpoint, I just get back: The Azure ML Endpoint uses an API key to allow authorization for requests. But, how do I add that authorization to my Postman request? Well, the Azure ML service provides a handy Document to tell us the Headers, Body, and responses to expect. Right below where I found the URL for my Request-Response endpoint, there is a link called \u201cAPI Help.\u201d Clicking on it will bring you to a full document that provides assistance with the API: Now, when I click Send, I no longer get an authorization error. But, I get an error nonetheless: Now, let\u2019s give our Request a body. The easiest way to do this is to go back to the API Help Document, scroll down a bit, and you see a sample Body request the API expects. Now, just copy and paste everything in the Sample Request Box to the Body of the Postman Request and click Send. Awesome, we got a response back. <\/p>\n Currently, Flow and PowerApps will only read a Postman v1 collection, so make sure that is set, and click Export. Save the file to a location you can remember:<\/p>\n Our data and analytics experts share six challenges that derail the productivity of your machine learning initiatives and why applying MLOps can help solve them.<\/p>\n\n <\/div>\n Head back over to Flow, click on \u201cCreate Custom Connector\u201d and click \u201cImport from Postman File.\u201d Provide a name for your Custom Connector and click Import. Find the Postman File we created and click \u201cContinue\u201d Congratulations! You\u2019ve now successfully connected Microsoft Flow (and PowerApps) to an Azure Machine Learning Web Service. In Part 2, we\u2019ll create a sample Flow and PowerApp that takes advantage of this new Custom Connector!<\/p>\n Part four of a Women in Tech series<\/a> and originally posted on Jo’s blog, here<\/a>.\u00a0<\/em><\/p>\n","protected":false},"excerpt":{"rendered":" Learn how to use PowerApps and Flow to create a custom connector model in Azure Machine Learning with this step-by-step walkthrough.<\/p>\n","protected":false},"author":86,"featured_media":33375,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"_oasis_is_in_workflow":0,"_oasis_original":0,"_oasis_task_priority":"","_relevanssi_hide_post":"","_relevanssi_hide_content":"","_relevanssi_pin_for_all":"","_relevanssi_pin_keywords":"","_relevanssi_unpin_keywords":"","_relevanssi_related_keywords":"","_relevanssi_related_include_ids":"","_relevanssi_related_exclude_ids":"","_relevanssi_related_no_append":"","_relevanssi_related_not_related":"","_relevanssi_related_posts":"","_relevanssi_noindex_reason":"","footnotes":""},"categories":[1],"tags":[19123],"coauthors":[15564],"class_list":["post-26748","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-uncategorized","tag-machine-learning","resource-categories-blogs","orbitmedia_post_topic-artificial-intelligence","orbitmedia_post_topic-enterprise-collaboration","orbitmedia_post_topic-power-platform"],"acf":[],"publishpress_future_action":{"enabled":false,"date":"2024-09-16 12:58:12","action":"change-status","newStatus":"draft","terms":[],"taxonomy":"category"},"_links":{"self":[{"href":"https:\/\/centricconsulting.com\/wp-json\/wp\/v2\/posts\/26748"}],"collection":[{"href":"https:\/\/centricconsulting.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/centricconsulting.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/centricconsulting.com\/wp-json\/wp\/v2\/users\/86"}],"replies":[{"embeddable":true,"href":"https:\/\/centricconsulting.com\/wp-json\/wp\/v2\/comments?post=26748"}],"version-history":[{"count":0,"href":"https:\/\/centricconsulting.com\/wp-json\/wp\/v2\/posts\/26748\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/centricconsulting.com\/wp-json\/wp\/v2\/media\/33375"}],"wp:attachment":[{"href":"https:\/\/centricconsulting.com\/wp-json\/wp\/v2\/media?parent=26748"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/centricconsulting.com\/wp-json\/wp\/v2\/categories?post=26748"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/centricconsulting.com\/wp-json\/wp\/v2\/tags?post=26748"},{"taxonomy":"author","embeddable":true,"href":"https:\/\/centricconsulting.com\/wp-json\/wp\/v2\/coauthors?post=26748"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}Getting Prepared<\/h2>\n
\n
![\"OpenAPI\"](\"https:\/\/centricconsulting.com\/wp-content\/uploads\/2019\/04\/Screen1-111x300.png\")
Let\u2019s Start with Flow<\/p>\n![\"Create](\"https:\/\/centricconsulting.com\/wp-content\/uploads\/2019\/04\/Screen2.png\")
<\/p>\nPlease Mr. Postman<\/h2>\n
\n![\"Postman](\"https:\/\/centricconsulting.com\/wp-content\/uploads\/2019\/04\/Screen5.png\")
\nNow we need to give Postman the URL to our Azure ML Service Swagger doc. You can get the endpoint from your Azure ML Service Dashboard:
\n![\"Azure](\"https:\/\/centricconsulting.com\/wp-content\/uploads\/2019\/04\/Screen4.png\")
\nIn this case, I need to use the Request-Response endpoint (as this sample PowerApp won\u2019t be doing batch requests). I need to take the URL they provided me, but I need to replace the \/execute?api-version=s.0&format=swagger<\/strong> and replace it with \/swagger.json<\/strong> This is the correct URL to my swagger document in the service. Once I click Import, Postman connects the endpoint, reads the swagger document, and provides full details about my API.
\n![\"Swagger](\"https:\/\/centricconsulting.com\/wp-content\/uploads\/2019\/04\/Screen7.png\")
<\/p>\n
\n{
\n\u201cerror\u201d: {
\n\u201ccode\u201d: \u201cUnauthorized\u201d,
\n\u201cmessage\u201d: \u201cRequest is unauthorized to access resource.\u201d,
\n\u201cdetails\u201d: [
\n{
\n\u201ccode\u201d: \u201cScoreRequestUnauthorized\u201d,
\n\u201cmessage\u201d: \u201cInvalid credentials provided.\u201d
\n}
\n]\n}
\n}<\/p>\n
\n![\"API](\"https:\/\/centricconsulting.com\/wp-content\/uploads\/2019\/04\/Screen9.png\")
\nSo, in this document, I can see I need an authorization header, that includes Bearer and my API Key. I can add a header in Postman that looks like this (I\u2019ve blocked out most of my API key, so hopefully you get the idea):
\n![\"Send](\"https:\/\/centricconsulting.com\/wp-content\/uploads\/2019\/04\/Screen10.png\")
<\/p>\n
\n{
\n\u201cerror\u201d: {
\n\u201ccode\u201d: \u201cBadArgument\u201d,
\n\u201cmessage\u201d: \u201cInvalid argument provided.\u201d,
\n\u201cdetails\u201d: [
\n{
\n\u201ccode\u201d: \u201cRequestBodyInvalid\u201d,
\n\u201cmessage\u201d: \u201cNo request body provided or error in deserializing the request body.\u201d
\n}
\n]\n}
\n}<\/p>\n
\n![\"API](\"https:\/\/centricconsulting.com\/wp-content\/uploads\/2019\/04\/Screen12.png\")
<\/p>\n
\n![\"Sample](\"https:\/\/centricconsulting.com\/wp-content\/uploads\/2019\/04\/Screen13.png\")
\nWe now know the endpoint works, so we can save this as a Postman Collection. To do so, just click on the ellipses next to the collection name, and click \u201cExport:\u201d
\n![\"Postman](\"https:\/\/centricconsulting.com\/wp-content\/uploads\/2019\/04\/Screen14-146x300.png\")
<\/p>\n![\"Postman](\"https:\/\/centricconsulting.com\/wp-content\/uploads\/2019\/04\/Screen15.png\")
<\/p>\n\n Time to Connect the ML Service to Flow<\/h2>\n
\n![\"Custom](\"https:\/\/centricconsulting.com\/wp-content\/uploads\/2019\/04\/Screen16.png\")
\nOnce Postman file is imported, we can now further define the Connector. You can add a custom Icon or Description on the General Page:
\n![\"Connector](\"https:\/\/centricconsulting.com\/wp-content\/uploads\/2019\/04\/Screen17.png\")
\nOn the Security Page, we need to define the security settings users need to use to connect to this. Since we\u2019re using an API key, choose that option from the Authentication Type Drop down. I named my Parameter label \u201cAPI Key\u201d but you can choose whatever is more descriptive for you. For Parameter name, enter in \u201cAuthorization.\u201d The location is \u201cHeader\u201d
\n![\"API](\"https:\/\/centricconsulting.com\/wp-content\/uploads\/2019\/04\/Screen18.png\")
\nOn the Definition tab, you can see all of the information gleaned from the endpoint. I recommend accepting the defaults here, but you can play around with some of the namings if so desired:
\n![\"Definition](\"https:\/\/centricconsulting.com\/wp-content\/uploads\/2019\/04\/Screen19.png\")
\nFinally, click on \u201cCreate Connector\u201d to complete the process. (Optional: Once the Connector has been created, you can try testing it from the \u201cTest Tab\u201d)<\/p>\n![\"Create](\"https:\/\/centricconsulting.com\/wp-content\/uploads\/2019\/04\/Screen20-300x46.png\")
<\/p>\nSuccess!<\/h2>\n
\n