Update SetupGuide_Javascript (#674)

* add js GetProductsNameNull sample & complete docs

* update toc

* move sample description to sample files.

Author: MaddyDev

docs/SetupGuide_Javascript.md

@@ -13,12 +13,10 @@
       - [Empty Parameter Value](#empty-parameter-value)
       - [Null Parameter Value](#null-parameter-value)
       - [Stored Procedure](#stored-procedure)
-      - [IAsyncEnumerable](#iasyncenumerable)
   - [Output Binding](#output-binding)
     - [function.json Properties for Output Bindings](#functionjson-properties-for-output-bindings)
     - [Setup for Output Bindings](#setup-for-output-bindings)
     - [Samples for Output Bindings](#samples-for-output-bindings)
-      - [ICollector\<T\>/IAsyncCollector\<T\>](#icollectortiasynccollectort)
       - [Array](#array)
       - [Single Row](#single-row)
   - [Trigger Binding](#trigger-binding)
@@ -110,23 +108,19 @@ Note: This tutorial requires that a SQL database is setup as shown in [Create a
 
 #### Query String
 
-_TODO_
+See the [GetProducts](https://github.com/Azure/azure-functions-sql-extension/blob/main/samples/samples-js/GetProducts) sample
 
 #### Empty Parameter Value
 
-_TODO_
+See the [GetProductsNameEmpty](https://github.com/Azure/azure-functions-sql-extension/tree/main/samples/samples-js/GetProductsNameEmpty) sample
 
 #### Null Parameter Value
 
-_TODO_
+See the [GetProductsNameNull](https://github.com/Azure/azure-functions-sql-extension/tree/main/samples/samples-js/GetProductsNameNull) sample
 
 #### Stored Procedure
 
-_TODO_
-
-#### IAsyncEnumerable
-
-_TODO_
+See the [GetProductsStoredProcedure](https://github.com/Azure/azure-functions-sql-extension/tree/main/samples/samples-js/GetProductsStoredProcedure) sample
 
 ## Output Binding
 
@@ -200,17 +194,13 @@ Note: This tutorial requires that a SQL database is setup as shown in [Create a
 
 ### Samples for Output Bindings
 
-#### ICollector&lt;T&gt;/IAsyncCollector&lt;T&gt;
-
-_TODO_
-
 #### Array
 
-_TODO_
+See the [AddProductsArray](https://github.com/Azure/azure-functions-sql-extension/tree/main/samples/samples-js/AddProductsArray) sample
 
 #### Single Row
 
-_TODO_
+See the [AddProduct](https://github.com/Azure/azure-functions-sql-extension/tree/main/samples/samples-js/AddProduct) sample
 
 ## Trigger Binding
 

samples/samples-js/GetProducts/index.js

@@ -1,6 +1,10 @@
 // Copyright (c) Microsoft Corporation. All rights reserved.
 // Licensed under the MIT License. See License.txt in the project root for license information.
 
+// The input binding executes the `select * from Products where Cost = @Cost` query, returning the result as json object in the body.
+// The *parameters* argument passes the `{cost}` specified in the URL that triggers the function,
+// `getproducts/{cost}`, as the value of the `@Cost` parameter in the query.
+// *commandType* is set to `Text`, since the constructor argument of the binding is a raw query.
 module.exports = async function (context, req, products) {
     context.log('JavaScript HTTP trigger function processed a request.');
     context.log(JSON.stringify(products));

samples/samples-js/GetProductsNameEmpty/index.js

@@ -1,6 +1,7 @@
 // Copyright (c) Microsoft Corporation. All rights reserved.
 // Licensed under the MIT License. See License.txt in the project root for license information.
 
+// The parameter value of the `@Name` parameter is an empty string in the parameters arguments.
 module.exports = async function (context, req, products) {
     context.log('JavaScript HTTP trigger function processed a request.');
     context.log(JSON.stringify(products));

samples/samples-js/GetProductsNameNull/function.json

@@ -0,0 +1,29 @@
+{
+  "bindings": [
+    {
+      "authLevel": "function",
+      "name": "req",
+      "type": "httpTrigger",
+      "direction": "in",
+      "methods": [
+        "get"
+      ],
+      "route":"getproducts-namenull/{name}"
+    },
+    {
+      "name": "$return",
+      "type": "http",
+      "direction": "out"
+    },
+    {
+      "name": "products",
+      "type": "sql",
+      "direction": "in",
+      "commandText": "if @Name is null select * from Products where Name is null else select * from Products where @Name = name",
+      "commandType": "Text",
+      "parameters": "@Name={name}",
+      "connectionStringSetting": "SqlConnectionString"
+    }
+  ],
+  "disabled": false
+}

samples/samples-js/GetProductsNameNull/index.js

@@ -0,0 +1,14 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License. See License.txt in the project root for license information.
+
+// If the `{name}` specified in the `getproducts-namenull/{name}` URL is "null",
+// the query returns all rows for which the Name column is `NULL`. Otherwise, it returns
+// all rows for which the value of the Name column matches the string passed in `{name}`
+module.exports = async function (context, req, products) {
+    context.log('JavaScript HTTP trigger function processed a request.');
+    context.log(JSON.stringify(products));
+    return {
+        status: 200,
+        body: products
+    };
+}

samples/samples-js/GetProductsStoredProcedure/index.js

@@ -1,6 +1,9 @@
 // Copyright (c) Microsoft Corporation. All rights reserved.
 // Licensed under the MIT License. See License.txt in the project root for license information.
 
+// `SelectsProductCost` is the name of a procedure stored in the user's database.
+// In this case, *CommandType* is `StoredProcedure`. The parameter value of the `@Cost` parameter in the
+// procedure is once again the `{cost}` specified in the `getproducts-storedprocedure/{cost}` URL.
 module.exports = async function (context, req, products) {
     context.log('JavaScript HTTP trigger function processed a request.');
     context.log(JSON.stringify(products));