search

MicrosoftDocs / azure-docs

Open source documentation of Microsoft Azure
https://docs.microsoft.com/azure
Creative Commons Attribution 4.0 International
10.21k stars 21.36k forks source link

Azure functions: Storage input binding incomplete documentation #70650

Open sijucm opened 3 years ago

sijucm commented 3 years ago

In the published page located at: https://github.com/msangapu/azure-docs-PUBLIC/blob/master/articles/azure-functions/functions-bindings-storage-blob.md#input---javascript-example

It shows example of a blob storage input trigger as given : context.bindings.myOutputBlob = context.bindings.myInputBlob;

That's so easy to do without carefully not giving any information for the reader on what is in the myOutputBlob for example if I want to process that data instead of copying it into a different container. Very typical of MS to give correct information but useless information. Please, please give some information on what comes in the context.bindings.myOutputBlob or where I can find further documentation/reference. I'm searching desperately but seems like the google-search lead me again and again to this documentation itself.

I'm sorry for the emotions in this post, but it comes out of deep frustration working with MS products. The amount of inconsistencies, lack of any useful documentation, half baked products, rabbit holes of what works with complex permutations and combinations.

JamesTran-MSFT commented 3 years ago

@sijucm Thanks for your feedback! We will investigate and update as appropriate.

ggailey777 commented 3 years ago

assign:ggailey777

ggailey777 commented 3 years ago

@sijucm sorry for the trouble you've had using our documentation for Azure Functions. Since the link you provided was a bit odd, can I get you to confirm that this is the article that you found unhelpful: Azure Blob storage input binding for Azure Functions - Example?

Assuming so, I think we have two issues here:

  1. The search optimization on this article is so bad that you ended up in a old version of the article in @msangapu's public fork of the repo (which is truly odd). @sijucm can you let us know what search terms you were using?
  2. The simple assignment of the input blob object to an output blob object is unhelpful, which I can totally see being an issue.

I am going to #reassign:@craigshoemaker who owns this article to see if we can improve the example to something less trivial. In the meantime, providing an example of what you were wanting to see would be helpful.

Thanks again very much for your helpful feedback!

sijucm commented 3 years ago

Thanks for the response. The page mentioned is correct, I just found the github page that is publishing this. What I searched for is : "Azure functions javascript blob storage input binding data". I cannot find any reference to what comes as the input data to the function. What Object and what are the attributes I can use. I see this page but this does not connect to any advanced reference on the API/documentation.