Update readme file. (#2)

* Update Readme file

* Add Repo URL in Deploy Button

* Fixes in Deploy Azure Button

* Add URL of Xamarin repo in Azure Deploy Button

* Fix images from Task 2 in Readme file

Author: olgamarti

Diff for: README.md

@@ -1,20 +1,206 @@
-# Introduction 
-TODO: Give a short introduction of your project. Let this section explain the objectives or the motivation behind this project. 
-
-# Getting Started
-TODO: Guide users through getting your code up and running on their own system. In this section you can talk about:
-1.	Installation process
-2.	Software dependencies
-3.	Latest releases
-4.	API references
-
-# Build and Test
-TODO: Describe and show how to build your code and run the tests. 
-
-# Contribute
-TODO: Explain how other users and developers can contribute to make your code better. 
-
-If you want to learn more about creating good readme files then refer the following [guidelines](https://www.visualstudio.com/en-us/docs/git/create-a-readme). You can also seek inspiration from the below readme files:
-- [ASP.NET Core](https://github.com/aspnet/Home)
-- [Visual Studio Code](https://github.com/Microsoft/vscode)
-- [Chakra Core](https://github.com/Microsoft/ChakraCore)
+# Xamarin - Azure Function Challenge - 2019
+
+Welcome to the Xamarin Azure Challenge! The goal of this challenge is to implement and connect your Xamarin app with an Azure Function. 
+
+## Objectives
+
+1. Create and publish an Azure Function resource in Azure.
+2. Configure Xamarin Forms Application.
+3. Find and fix some code errors hidden in the source code.
+4. Submit your information through Xamarin Forms Application to the Azure Function to complete the challenge.
+
+## Prerequisites
+
+* Azure Suscription. If you don't have an Azure Subscription you can get one with VS Dev Essentials and a personal Microsoft Account sign up in [Microsoft VS Dev Essentials Site](https://visualstudio.microsoft.com/dev-essentials/) or you can sign up for a free [Azure trial](https://azure.microsoft.com/en-us/free/). 
+* Visual Studio 2019 + Xamarin. If you don't have Visual Studio 2019 installed in your machine with Xamarin you can follow [this steps](https://docs.microsoft.com/en-us/xamarin/get-started/installation/).
+
+## Task 1: Create and publish an Azure Function resource in Azure
+
+### Clone repository
+
+Ensure you are in the `master` branch, and then, [clone](https://git-scm.com/docs/git-clone) this repository in your computer. Run this command in your favorite terminal and change `<name-repository>` for the correct name.
+
+``` bash
+git clone <name-repository>
+```
+
+After you have cloned the repository, you have 3 options to create and publish your Azure Function.
+
+1. Use Visual Studio to create and publish the Azure Function.
+2. Use Azure Portal to create the Azure Function and Visual Studio to publish it.
+3. Use Azure CLI to create and publish the Azure Function.
+
+You can also use the follwing Deploy to Azure button to create the resources.
+
+[![Deploy to Azure](https://azuredeploy.net/deploybutton.png)](https://azuredeploy.net/?repository=https://github.com/xamarin/XamarinAzureChallenge/doc/deploy)
+
+### <a name="Option1"></a> Option 1: Use Visual Studio to create and publish the Azure Function
+
+> As a prerequisite, you must have an Azure Subscription and be logged with this Microsoft account in your Visual Studio.
+
+1. In Visual Studio go to the Solution Explorer and select XamarinAzureChallenge.Functions project.
+
+![publish](doc/img/solution-explorer.png)
+
+ 2. On the project, right-click and select **Publish**.
+
+![start](doc/img/publish.png)
+
+3. In the Publish window, select Azure Function -> Azure App Service -> Create a new profile.
+
+![start](doc/img/create-profile.png)
+
+3. Create and configure the App Service.
+
+![start](doc/img/configure-profile.png)
+
+- **App Name**: Eg: MicrosoftXamarinChallengeFunctions
+- **Subscription**: Your Subscription name
+- **New Resource Group**: Eg: XamarinAzureChallengeFunctionsRG
+- **New Hosting Plan**: Eg: XamarinAzureChallengeFunctionsHostP
+- **Azure Storage**: Eg: xamazurechallengestore1
+
+4. Once you create or select the Resource Group, Hosting Plan and Storage Account click on **Create**.
+
+This action will take a few minutes.
+
+5. Make sure your resource group was created correctly in the [Azure Portal](http://portal.azure.com).
+
+![ensureAzure](doc/img/ensure-portal-azure.png)
+
+Now, every time you want to deploy your code to Azure, you will only need to click the **Publish** button.
+
+![publishButton](doc/img/publish-button.png)
+
+
+### Option 2: Use Azure Portal to create the Azure Function and Visual Studio to publish it
+
+1. Go to the [Azure Portal](http://portal.azure.com) and click on Create Resource. Enter Function App into the Search Bar.
+
+![portalAzFunction1](doc/img/portal-createAzFunction-1.png)
+
+2. Click Create:
+
+![portalAzFunction2](doc/img/portal-createAzFunction-2.png)
+
+
+3. Name your Function App and choose your Azure Subscription. Configure or create a new the Resource Group, Location, and Storage Account.
+
+- **App Name**: Eg: MicrosoftXamarinChallengeFunctions
+- **Subscription**: Your Subscription name
+- **New Resource Group**: Eg: XamarinAzureChallengeFunctionsRG
+- **New Hosting Plan**: Eg: XamarinAzureChallengeFunctionsHostP
+- **Azure Storage**: Eg: xamazurechallengestore1
+
+4. Go to Visual Studio and click on the Solution Explorer and select XamarinAzureChallenge.Functions project.
+
+![publish](doc/img/solution-explorer.png)
+
+ 5. On the project, right-click in **Publish**
+
+![start](doc/img/publish.png)
+
+6. Select existing resource -> Publish
+
+![portal-publish](doc/img/portal-publish-1.png)
+
+7. In the App Service window, select the Azure Function that you created earlier, and click **OK**.
+
+![portal-publish-2](doc/img/portal-publish-2.png)
+
+Visual Studio will publish your Azure Function. This action will take a few minutes.
+
+## Option 3: Use Azure CLI to create and publish your Azure Function. 
+
+> As a prerequisite, you must have installed [Azure Core Tools version 2.x](https://docs.microsoft.com/en-us/azure/azure-functions/functions-run-local#v2) and [Azure CLI](https://docs.microsoft.com/en-us/cli/azure/install-azure-cli) or [Azure Cloud Shell](https://shell.azure.com/bash).
+
+1. Login into Azure CLI
+
+```
+az login
+```
+
+2. Create a resource group.
+
+```
+az group create --name XamarinAzureChallengeRG --location westeurope
+```
+
+If you have more than one subscription you will need to especify the subscription where the resource groups will be created with ``--subscription.`` 
+
+3. Create an Azure storage account
+
+```
+az storage account create --name xamazurechallengestore1 --location westeurope --resource-group XamarinAzureChallengeRG2 --sku Standard_LRS --subscription bc6ccc1f-0744-4645-99f4-52b017e3b9ba
+```
+
+4. Use the following command to navigate to the project folder `XamarinAzureChallenge.Functions` project folder.
+
+```bash
+cd MyPath\src\XamarinAzureChallenge\XamarinAzureChallenge.Functions
+```
+
+5. Create a function app
+
+```
+az functionapp create --resource-group XamarinAzureChallengeRG2 --consumption-plan-location westeurope --name XamarinAzureChallengeFunctions --storage-account  xamazurechallengestore1 --runtime dotnet --subscription bc6ccc1f-0744-4645-99f4-52b017e3b9ba
+```
+
+6.  Use this command to deploy the project to Azure.
+
+
+```
+func azure functionapp publish XamarinAzureChallengeFunctions
+```
+
+## Task 2: Configuring the Xamarin App
+
+### Configure your deploymemt
+
+After deploy and publish the Azure Function, you are ready to configure the Xamarin app with your Azure Function endpoint.
+
+1. Go the Azure Portal and navigate to your Azure Function App.
+
+2. Open the list of Functions and select SubmitChallengeFunction. On the right panel, go to Get function URL.
+
+![AFEndpoint](/doc/img/AFEndpoint1.png)
+
+3. Copy the URL.
+
+![AFEndpoint2](/doc/img\AFEndpoint2.png)
+
+4. Open the solution *XamarinAzureChallenge.sln* and go to *UserDetailViewModel* class and paste the url in *Endpoint* variable:
+
+![ViewModel](/doc/img/BaseViewModel.png)
+
+
+## Task 3: Goal of this challenge
+
+As you know, this code contains errors. Please find them and fix them to pass this challenge!
+
+**Click [here](/doc/solution.md) to get the solution.**
+
+## Task 4: Submit your information through Xamarin Application 
+
+The next step is to run the Xamarin Application and fill the form with your information. If you followed all the steps, your personal information will be sent to the Azure Function. The Azure Function will send to our internal API the data to participate in the challenge. 
+
+You can run the app in local using an emulator. You can find the instructions [here](https://docs.microsoft.com/en-us/xamarin/android/deploy-test/debugging/debug-on-emulator?tabs=windows).
+
+In addition, you can run the app in a physical device. To setting up and configure your device you can follow [these instrucions](https://docs.microsoft.com/en-us/xamarin/android/deploy-test/debugging/debug-on-device?tabs=windows)
+
+
+## Next Steps
+
+Please, read the Terms and Conditions of this challenge to know more about the next steps. 
+
+## Report an issue
+
+If you found an issue with this challenge, please open an issue in GitHub. 
+
+## Additional Resources
+
+If you are interested in learning more about this topic, you can refer to the following resources:
+
+* [Azure Function Documentation](https://docs.microsoft.com/en-us/azure/azure-functions/)
+* [Xamarin Documentation](https://docs.microsoft.com/en-us/xamarin/)
+* [Azure Samples + Xamarin](https://github.com/Azure-Samples?utf8=%E2%9C%93&q=Xamarin&type=&language=)

Diff for: doc/deploy/azuredeploy.json

@@ -0,0 +1,72 @@
+{
+    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
+    "contentVersion": "1.0.0.0",
+    "parameters": {
+        "storageAccounts_xamarinazurechallenge1_name": {
+            "defaultValue": "xamarinazurechallenge1",
+            "type": "String"
+        },
+        "serverfarms_XamarinAzureChallengeFunctions1_name": {
+            "defaultValue": "XamarinAzureChallengeFunctions1",
+            "type": "String"
+        }
+    },
+    "variables": {},
+    "resources": [
+        {
+            "type": "Microsoft.Storage/storageAccounts",
+            "apiVersion": "2018-07-01",
+            "name": "[parameters('storageAccounts_xamarinazurechallenge1_name')]",
+            "location": "centralus",
+            "tags": {
+                "hidden-related:/providers/Microsoft.Web/sites/XamarinAzureChallengeFunctions1": "empty"
+            },
+            "sku": {
+                "name": "Standard_LRS",
+                "tier": "Standard"
+            },
+            "kind": "Storage",
+            "properties": {
+                "networkAcls": {
+                    "bypass": "AzureServices",
+                    "virtualNetworkRules": [],
+                    "ipRules": [],
+                    "defaultAction": "Allow"
+                },
+                "supportsHttpsTrafficOnly": false,
+                "encryption": {
+                    "services": {
+                        "file": {
+                            "enabled": true
+                        },
+                        "blob": {
+                            "enabled": true
+                        }
+                    },
+                    "keySource": "Microsoft.Storage"
+                }
+            }
+        },
+        {
+            "type": "Microsoft.Web/serverfarms",
+            "apiVersion": "2016-09-01",
+            "name": "[parameters('serverfarms_XamarinAzureChallengeFunctions1_name')]",
+            "location": "Central US",
+            "sku": {
+                "name": "Y1",
+                "tier": "Dynamic",
+                "size": "Y1",
+                "family": "Y",
+                "capacity": 0
+            },
+            "kind": "functionapp",
+            "properties": {
+                "name": "[parameters('serverfarms_XamarinAzureChallengeFunctions1_name')]",
+                "perSiteScaling": false,
+                "reserved": false,
+                "targetWorkerCount": 0,
+                "targetWorkerSizeId": 0
+            }
+        }
+    ]
+}

Diff for: doc/img/AFEndpoint1.png

@@ -0,0 +1,57 @@
+# Solution
+
+We hope you tried to complete this challenge with all your effort and enthusiasm.
+
+If you did, and are still unable to complete the challenge, here you have the solution. We assume you have followed and completed the task 1 and task 2.
+
+## Fixing the errors
+
+1. By POST not by GET
+
+When you were trying make a POST request from Xamarin App to your Azure Function, it answered you with a **404 not found**.
+
+This error is allocated in the signature of the function. This Azure Function will only be triggered by a POST request, but in this code, we specified that the function only accepts GET requests.
+
+Change it to this:
+
+```c#
+public static async Task<HttpResponseMessage> Run([HttpTrigger(AuthorizationLevel.Function, "post", Route = null)]HttpRequestMessage req)
+```
+
+
+2. Encoding.UTF8 not Encoding.UTF7
+
+At this point, it seems that all your code is correct. However, when you try to make a request you get a 500 error, even if the JSON data is correct.
+
+`SendToApi` is throwing 500, simply because the String Encoding is wrong.
+
+Change it to this:
+
+
+```c#
+return await client.PostAsync(_uri, new StringContent(body, Encoding.UTF8, "application/json"));
+```
+
+3. Fix Binding on *UserDataPage.xaml.cs*
+
+The BindingContext of the page is not configure so the bindings and commands that are invoked from the xaml code do not work. To solve this add as the last line of the *UserDataPage* constructor:
+
+```c#
+BindingContext = new UserDataViewModel();
+```
+
+4. Fix serialization issue
+
+The model used to send the data to the Azure Function do not serialize the *Email* to Json. In User.cs class, locate the property *Email* and replace the
+
+ ```c#
+ [JsonIgnore]
+ ```
+
+with
+
+ ```c#
+ [JsonProperty(PropertyName="email")]
+ ```
+
+> Remember to deploy your Azure Function with the fixes!

Diff for: doc/img/AFEndpoint2.png

@@ -22,7 +22,7 @@ public static class SubmitChallengeFunction
         private static HttpClient Client => clientHolder.Value;
 
         [FunctionName(nameof(SubmitChallengeFunction))]
-        public static async Task<IActionResult> Run([HttpTrigger(AuthorizationLevel.Function, "post")][FromBody] User user)
+        public static async Task<IActionResult> Run([HttpTrigger(AuthorizationLevel.Function, "get")][FromBody] User user)
         {
             var (isDataValid, errorMessage) = IsDataValid(user);
 
@@ -78,7 +78,7 @@ private static Task<HttpResponseMessage> SendToApi(User user)
         {
             var serializedUser = JsonConvert.SerializeObject(user);
 
-            var httpContent = new StringContent(serializedUser, Encoding.UTF8, "application/json");
+            var httpContent = new StringContent(serializedUser, Encoding.UTF7, "application/json");
 
             return Client.PostAsync(uri, httpContent);
         }

Diff for: doc/img/BaseViewModel.png

@@ -1,7 +1,8 @@
 {
   "IsEncrypted": false,
   "Values": {
-    "API_HOST": "",
-    "END_POINT": ""
+    "API_HOST": "https://azurexamarinchallengepro.azurewebsites.net",
+    "END_POINT": "registers",
+    "FUNCTIONS_WORKER_RUNTIME": "dotnet"
   }
 }

Diff for: doc/img/binding.png

@@ -7,7 +7,7 @@ public class User
         [JsonProperty("fullname")]
         public string Name { get; set; } = string.Empty;
 
-        [JsonProperty("email")]
+        [JsonIgnore]
         public string Email { get; set; } = string.Empty;
 
         [JsonProperty("phone")]