How can we send inputs to an Azure Function?

After a while is very simple to understand what is need to do to send inputs to an Azure Function, however, access to the response output, or outputs, and use them in subsequent connectors… can bring some challenges.

An important thing you need to be aware is that, within Logic Apps, you need to always send a valid JSON message as input to a Webbook Function.

Sending empty inputs to an Azure Function

If your Function doesn’t really need to have any input, you will still need to send a valid JSON message, but because any value that we spend is unnecessary, the trick here is to send an empty JSON message:

Note: without double quotes

If we don’t do this and leave the Input Payload Object empty or “” the Logic App will fail with the following error:

Sending inputs to an Azure Function

To send inputs to the Azure Function we need to, for example, manually create our JSON message as on the “Input payload object” property inside the Configure Function Inputs panel. Let’s look to an example:

• We will add a “Twitter – When a new tweet appears” trigger in the Logic App, that looks for a new tweet containing the hashtag “#LogicApps”
  • For the sake of speed, since they are constantly emerging tweets with this hashtag, I used the hashtag “#nodejs” (that you may see on some pictures)

• After that we want to send the “Tweeted by” and “Tweet text” as inputs for our Azure Function, let’s ignore for now what the function does, the important for now is that the function needs to receive the following JSON format.

To accomplish that on the “INPUT PAYLOAD OBJECT” property we need, for example and be aware that depends on the code that you have inside your function, to:

• On the text property, type:

{“Tweet”: {“by”:

• Here we are starting to create our JSON message
• Next we need to select the “Tweeted by” output from our twitter trigger
  • Note that you can see all the elements/parameters of previous steps that you can use, on the bottom of the window of this action.

• After that, we need to continue to create the remainder of the message by typing:

,”text”:

• The next steap, is to select the “Tweeted text” output from the twitter trigger and finally type the rest of the JSON message:

}}

The end result will look like this:

Retrieving the output of an Azure function

Following the same input sample provide above:

{ 

  "Tweet": { 

    "by": "New York", 

    "text": "21 2nd Street" 

  } 

}

Let’s say that we have the following Azure Function:

module.exports = function (context, data) {   

          

  var Tweet = data.Tweet;   

    

  var d = new Date().getTime();   

  var uuid = 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function(c) {   

        var r = (d + Math.random()*16)%16 | 0;   

        d = Math.floor(d/16);   

        return (c=='x' ? r : (r&0x3|0x8)).toString(16);   

  });   

          

  // Response of the function to be used later.   

  context.res = {      

    body: {         

      Msg: 'Sandro you have a new tweet msg: ' + Tweet.text,   

      FileName: 'TweetMsg_' + uuid + ".txt"       

    }        

  };   

                  

  context.done();   

};

That returns the following output (in result of the input provided earlier):

• A message - "Msg" - that is composed by a static string and the content of the tweet message
• and a filename - "Filename" - composed by a static string, a generated GUID and a TXT extension.

{   

  "Msg": "Sandro you have a new tweet msg: This is #LogicApps demo msg",   

  "FileName": "TweetMsg_315381a5-847f-4962-9f1f-4fb65a958753.txt"  

}

And we want to create a Dropbox file containing only the value of the output parameter “Msg”. Also, the name of the file should be the value of the output parameter “Filename”.

But for now let’s set the filename statically as “Demo1.txt”

• If we add a “Dropbox – Create file” connector to our Logic App

• Set the Folder path, let’s say the root by typing: 

/

• Note: That you can also use the “…” button to navigate to your Dropbox folders
• Click on the Filename and type: 

Demo1.txt

• And then click on “File content” text box, we will notice that the output parameters of the Azure Function are in design “Body” and “Status code”.
  • Let’s select “Body” as the content of the file we want to create.

If we save and execute the Logic App, when a new tweet is found, we will see a new file in our Dropbox, however, the content of the file is not the expected one, instead it will be the entire JSON message that is returned by the function

Because we are defining the file name statically, we can also receive the following error on the following Logic App executions, we will deal with it shortly:

So how I can access to the output parameters and using them on the Dropbox connector properties?

The trick here is:

• At design time, set the function output parameter “Body” both in the “FILE NAME” and “FILE CONTENT” properties of the Dropbox connector (or any other connector)
  • You actually don’t need to do this step, but the reason why we do it’s because normally we are a little lazy and we want the designer do half of the work for us

• And then on the top of the Logic Apps Designer click in “Code view” option, for us to edit this values in “Code View” mode

• Then we need to edit "Create file" inputs to have the expected values

• Change the “inputs” –> “queries” –> “name” property to: 

@{body(‘TwitterPassDataToFunction’)[‘FileName’]

• And the “inputs” –> ”body” to: 

@{body(‘TwitterPassDataToFunction’)[‘Msg’]

Now if we change to the Logic Apps Designer, by clicking “Designer” option, we will notice that the designer already renders these properties to set the expected parameters. Parameters that are not there out-of-the-box:

If we once again save and execute the Logic App, when a new tweet is found, we will see a new file in our Dropbox with the expect file name:

And if we check the content of the file(s), we will also see that the file has the expected content:

We hope that next versions will have a better experience to deal with the Azure Functions outputs to have, by default, a first class experience.

Azure Function returning only one parameter

The previous sample returns two parameters, now if we want to return only one parameter, creating a concept of “a string variable” that you can use in subsequent connectors. We can make small changes to our Azure Function to have a first class experience without the need to switch to “Code View” to change the inputs of the connector.

If we create a new Azure Function from the Logic App Designer it will suggest the following code, that of course we can change:

We will face the same problem as the previous sample, and we would have to access to “Code View” and manually change/set the parameters of the subsequent connectors.

But in this case we can implement a different approach to have a better user experience in the Logic Apps Designer. Instead of following the suggested approach we can implement the following code:

If we now try to execute this function through the Azure Portal, we will notice that the output is no longer a JSON message:

If we, once again, save and execute the Logic App, when a new tweet is found, we will see a new file(s) in our Dropbox are created with the expected file name:

And if we, once again, check the content of the file(s), we will also see that the file has the expected content:

Having this way, a better user experience inside the Logic Apps Designer. However, this approach only works if the output is a single value (int, string, double).

References

This article was originally published at Logic Apps: Tips and Tricks to use Azure Functions inside Logic Apps. But please feel free to improve this article by adding new missing or important content, fixing spelling and so on.

Other languages

• अजूर लॉजिक एप्प्स: अजूर फंक्शन्स को लॉजिक एप्प्स के अंदर कॉल करना (hi-IN)

See Also

Another important place to find a huge amount of Logic Apps related articles is the TechNet Wiki itself. The best entry point is Microsoft Azure App Service Resources on the TechNet Wiki.

Azure Functions