From 8336c907a3084b7333e27da3a2ea601dfc4258f2 Mon Sep 17 00:00:00 2001
From: Roy Ben Shabat <Roy.mail.net@gmail.com>
Date: Thu, 30 Apr 2020 20:17:10 +0300
Subject: FSE automatic update checks.

---
 .../Controllers/FSEController.cs                   | 65 +++++++++++++++++++---
 1 file changed, 58 insertions(+), 7 deletions(-)

(limited to 'Software/Visual_Studio/Web/Tango.MachineService/Controllers')

diff --git a/Software/Visual_Studio/Web/Tango.MachineService/Controllers/FSEController.cs b/Software/Visual_Studio/Web/Tango.MachineService/Controllers/FSEController.cs
index bb3ef588f..7bf420df9 100644
--- a/Software/Visual_Studio/Web/Tango.MachineService/Controllers/FSEController.cs
+++ b/Software/Visual_Studio/Web/Tango.MachineService/Controllers/FSEController.cs
@@ -20,22 +20,17 @@ using Tango.Web.Security;
 using Tango.Web.SMO;
 using Tango.Web.SQLServer;
 using Tango.Web.Storage;
+using static Tango.MachineService.Controllers.FSEController;
 
 namespace Tango.MachineService.Controllers
 {
-    public class FSEController : TangoController
+    public class FSEController : TangoController<TokenObject>
     {
         public class TokenObject
         {
             public String UserGuid { get; set; }
         }
 
-        /// <summary>
-        /// Login to the service.
-        /// </summary>
-        /// <param name="request">The request.</param>
-        /// <returns></returns>
-        /// <exception cref="AuthenticationException"></exception>
         [HttpPost]
         public LoginResponse Login(LoginRequest request)
         {
@@ -179,5 +174,61 @@ namespace Tango.MachineService.Controllers
 
             return response;
         }
+
+        [HttpPost]
+        [JwtTokenFilter]
+        public CheckForUpdatesResponse CheckForUpdates(CheckForUpdatesRequest request)
+        {
+            CheckForUpdatesResponse response = new CheckForUpdatesResponse();
+
+            using (ObservablesContext db = ObservablesContextHelper.CreateContext())
+            {
+                var versions = db.FseVersions.ToList();
+
+                FseVersion latestVersion = null;
+
+                latestVersion = versions.OrderByDescending(x => Version.Parse(x.Version)).FirstOrDefault();
+
+                Version currentVersion = Version.Parse(request.Version);
+
+                String comments = String.Join(Environment.NewLine, versions.OrderBy(x => Version.Parse(x.Version)).Where(x => Version.Parse(x.Version) > currentVersion).Select(x => x.Comments));
+
+                if (latestVersion != null && Version.Parse(latestVersion.Version) != currentVersion)
+                {
+                    var manager = new BlobStorageManager();
+                    var container = manager.GetContainer(MachineServiceConfig.FSE_VERSIONS_CONTAINER);
+                    //var blob = container.GetBlockBlobReference(latestVersion.BlobName);
+                    var installerBlob = container.GetBlockBlobReference(latestVersion.InstallerBlobName);
+
+                    //response.BlobAddress = blob.GenerateReadSignature(TimeSpan.FromMinutes(60));
+
+                    if (!String.IsNullOrWhiteSpace(MachineServiceConfig.CDN_ENDPOINT))
+                    {
+                        //response.CdnAddress = MachineServiceConfig.CDN_ENDPOINT + blob.Uri.AbsolutePath;
+                        response.InstallerCdnAddress = MachineServiceConfig.CDN_ENDPOINT + installerBlob.Uri.AbsolutePath;
+                    }
+
+                    response.IsUpdateAvailable = true;
+                    response.Version = latestVersion.Version;
+                    response.Comments = latestVersion.Comments;
+                }
+            }
+
+            return response;
+        }
+
+        [HttpPost]
+        [JwtTokenFilter]
+        public RefreshTokenResponse RefreshToken(RefreshTokenRequest request)
+        {
+            SQLServerManager sqlServer = new SQLServerManager();
+            var accessToken = sqlServer.GetAccessToken();
+
+            return new RefreshTokenResponse()
+            {
+                AccessToken = accessToken.AccessToken,
+                Expiration = accessToken.ExpiresOn.UtcDateTime,
+            };
+        }
     }
 }
-- 
cgit v1.3.1


From d7e74be2ba2a2a69302a25ce394540d8649c7997 Mon Sep 17 00:00:00 2001
From: Roy Ben Shabat <Roy.mail.net@gmail.com>
Date: Fri, 1 May 2020 00:36:27 +0300
Subject: DefaultUpdatesManager. FSE Downloads Page on MachineService.

---
 .../Tango.FSE.UI/Updates/DefaultUpdatesManager.cs  |   6 +-
 .../Tango.MachineService/App_Start/RouteConfig.cs  |  11 +
 .../Controllers/FSEDownloadsController.cs          |  60 +++++
 .../Tango.MachineService/Images/fse/abstract1.png  | Bin 0 -> 11647 bytes
 .../Tango.MachineService/Images/fse/abstract2.png  | Bin 0 -> 153795 bytes
 .../Tango.MachineService/Images/fse/download.png   | Bin 0 -> 2382 bytes
 .../Images/fse/machine_full.png                    | Bin 0 -> 16884 bytes
 .../Images/fse/twine_logo_colored.png              | Bin 0 -> 27285 bytes
 .../Tango.MachineService.csproj                    |   8 +
 .../Views/FSEDownloads/Index.cshtml                | 246 +++++++++++++++++++++
 .../Views/FSEDownloads/IndexViewModel.cs           |  27 +++
 11 files changed, 357 insertions(+), 1 deletion(-)
 create mode 100644 Software/Visual_Studio/Web/Tango.MachineService/Controllers/FSEDownloadsController.cs
 create mode 100644 Software/Visual_Studio/Web/Tango.MachineService/Images/fse/abstract1.png
 create mode 100644 Software/Visual_Studio/Web/Tango.MachineService/Images/fse/abstract2.png
 create mode 100644 Software/Visual_Studio/Web/Tango.MachineService/Images/fse/download.png
 create mode 100644 Software/Visual_Studio/Web/Tango.MachineService/Images/fse/machine_full.png
 create mode 100644 Software/Visual_Studio/Web/Tango.MachineService/Images/fse/twine_logo_colored.png
 create mode 100644 Software/Visual_Studio/Web/Tango.MachineService/Views/FSEDownloads/Index.cshtml
 create mode 100644 Software/Visual_Studio/Web/Tango.MachineService/Views/FSEDownloads/IndexViewModel.cs

(limited to 'Software/Visual_Studio/Web/Tango.MachineService/Controllers')

diff --git a/Software/Visual_Studio/FSE/Tango.FSE.UI/Updates/DefaultUpdatesManager.cs b/Software/Visual_Studio/FSE/Tango.FSE.UI/Updates/DefaultUpdatesManager.cs
index f953ecf47..b236532bd 100644
--- a/Software/Visual_Studio/FSE/Tango.FSE.UI/Updates/DefaultUpdatesManager.cs
+++ b/Software/Visual_Studio/FSE/Tango.FSE.UI/Updates/DefaultUpdatesManager.cs
@@ -9,6 +9,7 @@ using Tango.Core.DI;
 using Tango.Core.ExtensionMethods;
 using Tango.FSE.BL.Web;
 using Tango.FSE.Common;
+using Tango.FSE.Common.Authentication;
 using Tango.FSE.Common.FSEApplication;
 using Tango.FSE.Common.Notifications;
 using Tango.FSE.Common.Threading;
@@ -41,6 +42,9 @@ namespace Tango.FSE.UI.Updates
         [TangoInject]
         private IDispatcherProvider DispatcherProvider { get; set; }
 
+        [TangoInject]
+        private IAuthenticationProvider AuthenticationProvider { get; set; }
+
 
         /// <summary>
         /// Gets or sets a value indicating whether to perform an automatic update checks.
@@ -181,7 +185,7 @@ namespace Tango.FSE.UI.Updates
 
                 if (vm.DialogResult)
                 {
-                    Process.Start(response.InstallerCdnAddress);
+                    Process.Start(AuthenticationProvider.CurrentEnvironment.MachineServiceAddress + "/fse");
                 }
             });
         }
diff --git a/Software/Visual_Studio/Web/Tango.MachineService/App_Start/RouteConfig.cs b/Software/Visual_Studio/Web/Tango.MachineService/App_Start/RouteConfig.cs
index 613e83e72..51f476be5 100644
--- a/Software/Visual_Studio/Web/Tango.MachineService/App_Start/RouteConfig.cs
+++ b/Software/Visual_Studio/Web/Tango.MachineService/App_Start/RouteConfig.cs
@@ -13,6 +13,17 @@ namespace Tango.MachineService
         {
             routes.IgnoreRoute("{resource}.axd/{*pathInfo}");
 
+            routes.MapRoute(
+                name: "fse",
+                url: "fse",
+                defaults: new
+                {
+                    controller = "FSEDownloads",
+                    action = "Index",
+                    id = UrlParameter.Optional
+                }
+            );
+
             routes.MapRoute(
                 name: "Default",
                 url: "{controller}/{action}/{id}",
diff --git a/Software/Visual_Studio/Web/Tango.MachineService/Controllers/FSEDownloadsController.cs b/Software/Visual_Studio/Web/Tango.MachineService/Controllers/FSEDownloadsController.cs
new file mode 100644
index 000000000..52eb2bbb5
--- /dev/null
+++ b/Software/Visual_Studio/Web/Tango.MachineService/Controllers/FSEDownloadsController.cs
@@ -0,0 +1,60 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Web;
+using System.Web.Mvc;
+using Tango.BL;
+using Tango.MachineService.Filters;
+using Tango.MachineService.Models;
+using Tango.Web.Helpers;
+using System.Data.Entity;
+using Tango.Web.Storage;
+using System.IO;
+using Microsoft.WindowsAzure.Storage.Blob;
+using System.Net.Http;
+using System.Net;
+using System.Net.Http.Headers;
+using System.Net.Mime;
+using Tango.MachineService.Views.FSEDownloads;
+
+namespace Tango.MachineService.Controllers
+{
+    public class FSEDownloadsController : Controller
+    {
+        public ActionResult Index()
+        {
+            IndexViewModel model = new IndexViewModel();
+
+            using (var db = ObservablesContextHelper.CreateContext())
+            {
+                var versions = db.FseVersions.ToList().OrderByDescending(x => Version.Parse(x.Version)).Take(6).ToList();
+
+                var manager = new BlobStorageManager();
+                var container = manager.GetContainer(MachineServiceConfig.FSE_VERSIONS_CONTAINER);
+
+                foreach (var item in versions)
+                {
+                    var installerBlob = container.GetBlockBlobReference(item.InstallerBlobName);
+
+                    model.Downloads.Add(new FSEDownload()
+                    {
+                        Name = $"Tango FSE v{Version.Parse(item.Version).ToString(3)}",
+                        Version = Version.Parse(item.Version).ToString(3),
+                        Comments = item.Comments,
+                        Date = item.LastUpdated.ToString("dddd, dd MMMM yyyy"),
+                        Address = MachineServiceConfig.CDN_ENDPOINT + installerBlob.Uri.AbsolutePath
+                    });
+                }
+
+                if (model.Downloads.Count > 0)
+                {
+                    var latest = model.Downloads.First();
+                    model.Downloads.Remove(latest);
+                    model.LatestDownload = latest;
+                }
+            }
+
+            return View(model);
+        }
+    }
+}
\ No newline at end of file
diff --git a/Software/Visual_Studio/Web/Tango.MachineService/Images/fse/abstract1.png b/Software/Visual_Studio/Web/Tango.MachineService/Images/fse/abstract1.png
new file mode 100644
index 000000000..236545ae9
Binary files /dev/null and b/Software/Visual_Studio/Web/Tango.MachineService/Images/fse/abstract1.png differ
diff --git a/Software/Visual_Studio/Web/Tango.MachineService/Images/fse/abstract2.png b/Software/Visual_Studio/Web/Tango.MachineService/Images/fse/abstract2.png
new file mode 100644
index 000000000..2742c71e5
Binary files /dev/null and b/Software/Visual_Studio/Web/Tango.MachineService/Images/fse/abstract2.png differ
diff --git a/Software/Visual_Studio/Web/Tango.MachineService/Images/fse/download.png b/Software/Visual_Studio/Web/Tango.MachineService/Images/fse/download.png
new file mode 100644
index 000000000..b5d626701
Binary files /dev/null and b/Software/Visual_Studio/Web/Tango.MachineService/Images/fse/download.png differ
diff --git a/Software/Visual_Studio/Web/Tango.MachineService/Images/fse/machine_full.png b/Software/Visual_Studio/Web/Tango.MachineService/Images/fse/machine_full.png
new file mode 100644
index 000000000..ec4890e2e
Binary files /dev/null and b/Software/Visual_Studio/Web/Tango.MachineService/Images/fse/machine_full.png differ
diff --git a/Software/Visual_Studio/Web/Tango.MachineService/Images/fse/twine_logo_colored.png b/Software/Visual_Studio/Web/Tango.MachineService/Images/fse/twine_logo_colored.png
new file mode 100644
index 000000000..2204585dc
Binary files /dev/null and b/Software/Visual_Studio/Web/Tango.MachineService/Images/fse/twine_logo_colored.png differ
diff --git a/Software/Visual_Studio/Web/Tango.MachineService/Tango.MachineService.csproj b/Software/Visual_Studio/Web/Tango.MachineService/Tango.MachineService.csproj
index ee5f3440e..67617ec7f 100644
--- a/Software/Visual_Studio/Web/Tango.MachineService/Tango.MachineService.csproj
+++ b/Software/Visual_Studio/Web/Tango.MachineService/Tango.MachineService.csproj
@@ -313,6 +313,7 @@
     </Compile>
     <Compile Include="App_Start\BundleConfig.cs" />
     <Compile Include="App_Start\FilterConfig.cs" />
+    <Compile Include="Controllers\FSEDownloadsController.cs" />
     <Compile Include="Controllers\DownloadsController.cs" />
     <Compile Include="Controllers\AccountController.cs" />
     <Compile Include="Controllers\FSEController.cs" />
@@ -333,6 +334,7 @@
     </Compile>
     <Compile Include="Models\SessionVariables.cs" />
     <Compile Include="Properties\AssemblyInfo.cs" />
+    <Compile Include="Views\FSEDownloads\IndexViewModel.cs" />
     <None Include="Security\RefreshTokenEncoder.cs" />
     <None Include="Security\RefreshTokenEntity.cs" />
     <None Include="Security\RefreshTokensManager.cs" />
@@ -340,6 +342,12 @@
     <Compile Include="Security\TokenManager.cs" />
     <Compile Include="Startup.cs" />
     <Compile Include="Views\Downloads\IndexViewModel.cs" />
+    <Content Include="Images\fse\abstract1.png" />
+    <Content Include="Images\fse\abstract2.png" />
+    <Content Include="Images\fse\download.png" />
+    <Content Include="Images\fse\machine_full.png" />
+    <Content Include="Images\fse\twine_logo_colored.png" />
+    <Content Include="Views\FSEDownloads\Index.cshtml" />
   </ItemGroup>
   <ItemGroup>
     <Content Include="Global.asax" />
diff --git a/Software/Visual_Studio/Web/Tango.MachineService/Views/FSEDownloads/Index.cshtml b/Software/Visual_Studio/Web/Tango.MachineService/Views/FSEDownloads/Index.cshtml
new file mode 100644
index 000000000..fb64c18a1
--- /dev/null
+++ b/Software/Visual_Studio/Web/Tango.MachineService/Views/FSEDownloads/Index.cshtml
@@ -0,0 +1,246 @@
+@model Tango.MachineService.Views.FSEDownloads.IndexViewModel
+
+@{
+    Layout = null;
+}
+
+<!DOCTYPE html>
+
+<html>
+<head>
+    <meta name="viewport" content="width=device-width" />
+
+    <style>
+
+        body {
+            margin: 0;
+            padding: 0;
+            overflow-x: hidden;
+            font-family: 'Segoe UI';
+        }
+
+        .fse_primary_background {
+            background-color: #303030;
+        }
+
+        .fse_primary_accent_background {
+            background-color: #009FE7;
+        }
+
+        .fse_border_background {
+            background-color: #404040;
+        }
+
+        .fse_gray_foreground {
+            color: #808080;
+        }
+
+        .fse_primary_background_light {
+            background-color: #404040;
+        }
+
+        .fse_primary_foreground {
+            color: #EEEEEE;
+        }
+
+        .fse_primary_accent {
+            color: #009FE7;
+        }
+
+        .fse_header_back {
+            position:fixed;
+            padding: 20px;
+            box-shadow: black 1px 1px 10px 1px;
+            z-index: 100;
+            width: 100%;
+        }
+
+        .fse_machine_logo {
+            position: absolute;
+            left: 20px;
+            top: 20px;
+            width: 120px;
+            float: left;
+        }
+
+        .fse_twine_logo {
+            height: 80px;
+            display: block;
+            margin: auto auto;
+        }
+
+        .fse_container {
+            position: absolute;
+            margin-top: 100px;
+            overflow: hidden;
+            clear: both;
+        }
+
+        .fse_side_abstract {
+            position: fixed;
+            width: 60px;
+            height: 100%;
+            float: left;
+            background-image: url('../../Images/fse/abstract1.png');
+            background-repeat: repeat;
+        }
+
+        .fse_side_abstract_top {
+            position:absolute;
+            box-shadow: black 0px 3px 10px 2px;
+            width:100%;
+        }
+
+        .fse_history_downloads_container {
+            float: left;
+            margin-left: 150px;
+            margin-top: 20px;
+            width: 500px;
+        }
+
+        .fse_history_download {
+            clear: both;
+            margin-top: 60px;
+        }
+
+        .fse_download_title {
+            vertical-align: baseline middle;
+        }
+
+        .fse_download_image {
+            height: 32px;
+        }
+
+        .fse_download_name {
+            margin-top: 5px;
+            margin-left: 5px;
+            vertical-align: top;
+            display: inline-block;
+        }
+
+        .fse_download_date {
+            float: right;
+            margin-top: 5px;
+            vertical-align: top;
+            display: inline-block;
+        }
+
+        .fse_download_separator {
+            clear: both;
+            height: 1px;
+            margin-top: 5px;
+        }
+
+        .fse_download_commets {
+            font-size: 12px;
+            margin-top: 10px;
+        }
+
+        .fse_download_link {
+            float: right;
+            text-decoration: none;
+            padding: 3px 15px;
+            border-radius: 2px;
+            font-size: 14px;
+        }
+
+        .fse_latest_version_container {
+            border-radius: 5px;
+            float: left;
+            margin-top: 100px;
+            margin-left: 200px;
+            width: 400px;
+            text-align: center;
+            box-shadow: black 0px 0px 5px 0px;
+        }
+
+        .fse_download_image_latest {
+            width: 64px;
+            margin-top: 20px;
+        }
+
+        .fse_download_title_latest {
+            margin-top: 10px;
+            font-size: 20px;
+            font-weight: 400;
+            text-align: center;
+        }
+
+        .fse_download_button_latest {
+            display: block;
+            padding: 15px 20px;
+            margin: 30px;
+            margin-top: 90px;
+            font-weight: 700;
+            border-radius: 25px;
+            text-decoration: none;
+            box-shadow: black 0px 0px 5px 0px;
+        }
+
+        .fse_title {
+            position: absolute;
+            display: inline-block;
+            float: left;
+            margin-left: 140px;
+            margin-top: 20px;
+            font-size: 25px;
+            font-weight: 400;
+        }
+    </style>
+
+    <title>Tango FSE</title>
+</head>
+<body class="fse_primary_background fse_primary_foreground">
+    <div>
+
+        <div id="fseAbstract" class="fse_side_abstract">
+            <div class="fse_side_abstract_top">
+
+            </div>
+        </div>
+
+        <div class="fse_header_back fse_primary_background_light">
+            <img src="~/Images/fse/machine_full.png" class="fse_machine_logo" />
+            <span class="fse_title">Tango FSE</span>
+            <img src="~/Images/fse/twine_logo_colored.png" class="fse_twine_logo" />
+        </div>
+
+        <div>
+            <div class="fse_container">
+
+                <div class="fse_history_downloads_container">
+
+                    @foreach (var item in Model.Downloads)
+                    {
+                        <div class="fse_history_download">
+                            <div class="fse_download_title">
+                                <img class="fse_download_image" src="~/Images/fse/download.png" />
+                                <span class="fse_download_name">@item.Name</span>
+                                <span class="fse_download_date">@item.Date</span>
+                            </div>
+                            <div class="fse_download_separator fse_border_background">
+
+                            </div>
+                            <div class="fse_download_commets fse_gray_foreground">
+                                @item.Comments
+                            </div>
+
+                            <a class="fse_download_link fse_primary_background_light fse_primary_accent" href="@item.Address">
+                                Download
+                            </a>
+                        </div>
+                    }
+                </div>
+
+                <div class="fse_latest_version_container fse_primary_background_light">
+                    <img class="fse_download_image_latest" src="~/Images/fse/download.png" />
+                    <div class="fse_download_title_latest">Download Latest Version</div>
+                    <div class="fse_download_title_latest fse_primary_accent" style="margin-top:5px;">v@(Model.LatestDownload.Version)</div>
+                    <div class="fse_download_commets fse_gray_foreground">@Model.LatestDownload.Comments</div>
+                    <a class="fse_download_button_latest fse_primary_accent_background fse_primary_foreground" href="@Model.LatestDownload.Address">DOWNLOAD</a>
+                </div>
+            </div>
+        </div>
+    </div>
+</body>
+</html>
diff --git a/Software/Visual_Studio/Web/Tango.MachineService/Views/FSEDownloads/IndexViewModel.cs b/Software/Visual_Studio/Web/Tango.MachineService/Views/FSEDownloads/IndexViewModel.cs
new file mode 100644
index 000000000..398b5fcc1
--- /dev/null
+++ b/Software/Visual_Studio/Web/Tango.MachineService/Views/FSEDownloads/IndexViewModel.cs
@@ -0,0 +1,27 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Web;
+
+namespace Tango.MachineService.Views.FSEDownloads
+{
+    public class IndexViewModel
+    {
+        public List<FSEDownload> Downloads { get; set; }
+        public FSEDownload LatestDownload { get; set; }
+
+        public IndexViewModel()
+        {
+            Downloads = new List<FSEDownload>();
+        }
+    }
+
+    public class FSEDownload
+    {
+        public String Name { get; set; }
+        public String Version { get; set; }
+        public String Date { get; set; }
+        public String Comments { get; set; }
+        public String Address { get; set; }
+    }
+}
\ No newline at end of file
-- 
cgit v1.3.1


From 278d5d5c43f3e19169af5d996448d3a400f417e1 Mon Sep 17 00:00:00 2001
From: Roy Ben Shabat <Roy.mail.net@gmail.com>
Date: Sun, 10 May 2020 17:54:43 +0300
Subject: Fixed issue with PPC firmware update report on demo machines.

---
 .../Web/Tango.MachineService/Controllers/PPCController.cs        | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

(limited to 'Software/Visual_Studio/Web/Tango.MachineService/Controllers')

diff --git a/Software/Visual_Studio/Web/Tango.MachineService/Controllers/PPCController.cs b/Software/Visual_Studio/Web/Tango.MachineService/Controllers/PPCController.cs
index 2049df665..28acb3647 100644
--- a/Software/Visual_Studio/Web/Tango.MachineService/Controllers/PPCController.cs
+++ b/Software/Visual_Studio/Web/Tango.MachineService/Controllers/PPCController.cs
@@ -344,11 +344,14 @@ namespace Tango.MachineService.Controllers
                         response.IsUpdateAvailable = true;
                     }
 
-                    if (!String.IsNullOrWhiteSpace(request.FirmwareVersion))
+                    if (!machine.IsDemo && machine.SetupFirmware)
                     {
-                        if (Version.Parse(latest_machine_version.FirmwareVersion) > Version.Parse(request.FirmwareVersion))
+                        if (!String.IsNullOrWhiteSpace(request.FirmwareVersion))
                         {
-                            response.IsUpdateAvailable = true;
+                            if (Version.Parse(latest_machine_version.FirmwareVersion) > Version.Parse(request.FirmwareVersion))
+                            {
+                                response.IsUpdateAvailable = true;
+                            }
                         }
                     }
 
-- 
cgit v1.3.1


From d4adb3a3faa36b4500c17e661e09ec2af338b353 Mon Sep 17 00:00:00 2001
From: Roy Ben Shabat <Roy.mail.net@gmail.com>
Date: Mon, 11 May 2020 03:37:33 +0300
Subject: User invitation via Email !

---
 Software/DB/Tango.mdf                              |  Bin 75497472 -> 75497472 bytes
 Software/DB/Tango_log.ldf                          |  Bin 22675456 -> 22675456 bytes
 .../ViewModels/OrganizationUsersViewVM.cs          |    1 +
 .../ViewModels/UserDetailsViewVM.cs                |   44 +-
 .../Views/UserDetailsView.xaml                     |    2 +-
 .../Tango.FSE.BL/Services/AuthenticationService.cs |   16 +
 .../Tango.FSE.BL/Services/OrganizationsService.cs  |   26 +-
 .../FSE/Tango.FSE.BL/Web/FSEWebClientBase.cs       |   18 +
 .../Messages/ForgotPasswordRequest.cs              |   14 +
 .../Messages/ForgotPasswordResponse.cs             |   14 +
 .../Messages/UserInvitationEmailRequest.cs         |   17 +
 .../Messages/UserInvitationEmailResponse.cs        |   14 +
 .../FSE/Tango.FSE.Web/Tango.FSE.Web.csproj         |    4 +
 .../Referenced Assemblies/SendGrid/SendGrid.dll    |  Bin 0 -> 48640 bytes
 .../Referenced Assemblies/SendGrid/SendGrid.xml    | 1388 ++++++++++++++++++++
 .../Controllers/FSEController.cs                   |   80 +-
 .../Tango.MachineService/MachineServiceConfig.cs   |    2 +
 .../Tango.MachineService.csproj                    |    5 +-
 .../Web/Tango.MachineService/Web.config            |    2 +
 19 files changed, 1621 insertions(+), 26 deletions(-)
 create mode 100644 Software/Visual_Studio/FSE/Tango.FSE.Web/Messages/ForgotPasswordRequest.cs
 create mode 100644 Software/Visual_Studio/FSE/Tango.FSE.Web/Messages/ForgotPasswordResponse.cs
 create mode 100644 Software/Visual_Studio/FSE/Tango.FSE.Web/Messages/UserInvitationEmailRequest.cs
 create mode 100644 Software/Visual_Studio/FSE/Tango.FSE.Web/Messages/UserInvitationEmailResponse.cs
 create mode 100644 Software/Visual_Studio/Referenced Assemblies/SendGrid/SendGrid.dll
 create mode 100644 Software/Visual_Studio/Referenced Assemblies/SendGrid/SendGrid.xml

(limited to 'Software/Visual_Studio/Web/Tango.MachineService/Controllers')

diff --git a/Software/DB/Tango.mdf b/Software/DB/Tango.mdf
index d29873151..20cd545f0 100644
Binary files a/Software/DB/Tango.mdf and b/Software/DB/Tango.mdf differ
diff --git a/Software/DB/Tango_log.ldf b/Software/DB/Tango_log.ldf
index 826bbc8e3..d89fbab3d 100644
Binary files a/Software/DB/Tango_log.ldf and b/Software/DB/Tango_log.ldf differ
diff --git a/Software/Visual_Studio/FSE/Modules/Tango.FSE.UsersAndRoles/ViewModels/OrganizationUsersViewVM.cs b/Software/Visual_Studio/FSE/Modules/Tango.FSE.UsersAndRoles/ViewModels/OrganizationUsersViewVM.cs
index ff3978dff..334c8c263 100644
--- a/Software/Visual_Studio/FSE/Modules/Tango.FSE.UsersAndRoles/ViewModels/OrganizationUsersViewVM.cs
+++ b/Software/Visual_Studio/FSE/Modules/Tango.FSE.UsersAndRoles/ViewModels/OrganizationUsersViewVM.cs
@@ -107,6 +107,7 @@ namespace Tango.FSE.UsersAndRoles.ViewModels
             ModularNavigationManager.NavigateTo(UsersAndRolesView.UserDetailsView, new UserDetailsViewVM.NavigationObject()
             {
                 IsNewUser = true,
+                Organization = Organization
             });
         }
 
diff --git a/Software/Visual_Studio/FSE/Modules/Tango.FSE.UsersAndRoles/ViewModels/UserDetailsViewVM.cs b/Software/Visual_Studio/FSE/Modules/Tango.FSE.UsersAndRoles/ViewModels/UserDetailsViewVM.cs
index 304ee15c5..51ce71387 100644
--- a/Software/Visual_Studio/FSE/Modules/Tango.FSE.UsersAndRoles/ViewModels/UserDetailsViewVM.cs
+++ b/Software/Visual_Studio/FSE/Modules/Tango.FSE.UsersAndRoles/ViewModels/UserDetailsViewVM.cs
@@ -24,10 +24,18 @@ namespace Tango.FSE.UsersAndRoles.ViewModels
 
         public class NavigationObject
         {
+            public Organization Organization { get; set; }
             public User User { get; set; }
             public bool IsNewUser { get; set; }
         }
 
+        private Organization _organization;
+        public Organization Organization
+        {
+            get { return _organization; }
+            set { _organization = value; RaisePropertyChangedAuto(); }
+        }
+
         private bool _isNewUser;
         public bool IsNewUser
         {
@@ -95,6 +103,13 @@ namespace Tango.FSE.UsersAndRoles.ViewModels
             set { _rolesCollection = value; RaisePropertyChangedAuto(); }
         }
 
+        private bool _sendInvitation;
+        public bool SendInvitation
+        {
+            get { return _sendInvitation; }
+            set { _sendInvitation = value; RaisePropertyChangedAuto(); }
+        }
+
         public RelayCommand SaveCommand { get; set; }
 
         public RelayCommand GeneratePasswordCommand { get; set; }
@@ -103,6 +118,7 @@ namespace Tango.FSE.UsersAndRoles.ViewModels
         {
             SaveCommand = new RelayCommand(Save, () => IsFree);
             GeneratePasswordCommand = new RelayCommand(GeneratePassword);
+            SendInvitation = true;
         }
 
         private void GeneratePassword()
@@ -216,7 +232,7 @@ namespace Tango.FSE.UsersAndRoles.ViewModels
 
                 IsFree = false;
 
-                using (NotificationProvider.PushTaskItem("Saving user details..."))
+                using (var task = NotificationProvider.PushTaskItem("Saving user details..."))
                 {
                     var rolesToAdd = RolesCollection.Where(x => x.IsSelected).ToList().Where(x => !User.FSERoles.Exists(y => y.Guid == x.Role.Guid)).ToList();
                     var rolesToRemove = User.FSERoles.ToList().Where(x => !RolesCollection.Where(z => z.IsSelected).ToList().Exists(y => y.Role.Guid == x.Guid)).ToList();
@@ -250,11 +266,36 @@ namespace Tango.FSE.UsersAndRoles.ViewModels
                     }
                     else
                     {
+                        User.OrganizationGuid = Organization.Guid;
                         User.Email = Email;
                         User.Password = Password;
 
                         await Services.OrganizationsService.InsertUser(User);
 
+                        if (SendInvitation)
+                        {
+                            bool invitationSent = false;
+                            task.UpdateProgress("Sending email invitation...");
+
+                            while (!invitationSent)
+                            {
+                                try
+                                {
+                                    await Services.OrganizationsService.SendNewUserInvitationEmail(Email, FirstName + " " + LastName, Password);
+                                    invitationSent = true;
+                                }
+                                catch (Exception ex)
+                                {
+                                    if (!await NotificationProvider.ShowWarningQuestion($"The user was created but an error occurred while trying to send the invitation via email.{ex.Message}\nWould you like to try again?"))
+                                    {
+                                        break;
+                                    }
+                                }
+                            }
+                        }
+
+                        await NotificationProvider.ShowSuccess("User created successfully!");
+
                         IsNewUser = false;
                         Password = null;
                         userToLoadGuid = User.Guid;
@@ -334,6 +375,7 @@ namespace Tango.FSE.UsersAndRoles.ViewModels
         {
             User = null;
             IsNewUser = obj.IsNewUser;
+            Organization = obj.Organization;
 
             if (!IsNewUser)
             {
diff --git a/Software/Visual_Studio/FSE/Modules/Tango.FSE.UsersAndRoles/Views/UserDetailsView.xaml b/Software/Visual_Studio/FSE/Modules/Tango.FSE.UsersAndRoles/Views/UserDetailsView.xaml
index 98197eaac..a2ad81cf4 100644
--- a/Software/Visual_Studio/FSE/Modules/Tango.FSE.UsersAndRoles/Views/UserDetailsView.xaml
+++ b/Software/Visual_Studio/FSE/Modules/Tango.FSE.UsersAndRoles/Views/UserDetailsView.xaml
@@ -149,7 +149,7 @@
                         </DockPanel>
 
                         <DockPanel Margin="0 50 0 0" HorizontalAlignment="Center" Visibility="{Binding IsNewUser,Converter={StaticResource BooleanToVisibilityConverter}}">
-                            <CheckBox ToolTip="Send the new user invitation to login to this system with the initial password" Foreground="{StaticResource FSE_PrimaryAccentBrush}">Send invitation via email</CheckBox>
+                            <CheckBox IsChecked="{Binding SendInvitation}" ToolTip="Send the new user invitation to login to this system with the initial password" Foreground="{StaticResource FSE_PrimaryAccentBrush}">Send invitation via email</CheckBox>
                         </DockPanel>
 
                         <Button Margin="0 60 0 0" material:ButtonAssist.CornerRadius="25" Width="250" Height="50" Padding="12" Command="{Binding SaveCommand}">
diff --git a/Software/Visual_Studio/FSE/Tango.FSE.BL/Services/AuthenticationService.cs b/Software/Visual_Studio/FSE/Tango.FSE.BL/Services/AuthenticationService.cs
index 50131d5bd..05ec4f9be 100644
--- a/Software/Visual_Studio/FSE/Tango.FSE.BL/Services/AuthenticationService.cs
+++ b/Software/Visual_Studio/FSE/Tango.FSE.BL/Services/AuthenticationService.cs
@@ -130,6 +130,22 @@ namespace Tango.FSE.BL.Services
             });
         }
 
+        /// <summary>
+        /// Sends the specified email a password reset information.
+        /// </summary>
+        /// <param name="email">The email.</param>
+        /// <returns></returns>
+        public Task SendForgotPasswordEmail(String email)
+        {
+            return Task.Factory.StartNew(() =>
+            {
+                var response = WebClient.SendForgotPasswordEmail(new ForgotPasswordRequest()
+                {
+                    Email = email,
+                }).Result;
+            });
+        }
+
         /// <summary>
         /// Drops the cached login response for the specified user.
         /// </summary>
diff --git a/Software/Visual_Studio/FSE/Tango.FSE.BL/Services/OrganizationsService.cs b/Software/Visual_Studio/FSE/Tango.FSE.BL/Services/OrganizationsService.cs
index 57b448d2e..5ce968085 100644
--- a/Software/Visual_Studio/FSE/Tango.FSE.BL/Services/OrganizationsService.cs
+++ b/Software/Visual_Studio/FSE/Tango.FSE.BL/Services/OrganizationsService.cs
@@ -8,6 +8,7 @@ using Tango.BL;
 using Tango.BL.Builders;
 using Tango.BL.Entities;
 using Tango.BL.Enumerations;
+using Tango.FSE.Web.Messages;
 using Z.EntityFramework.Extensions;
 using Z.EntityFramework.Plus;
 
@@ -135,7 +136,7 @@ namespace Tango.FSE.BL.Services
             });
         }
 
-        public Task<User> InsertUser(User user, bool sendInvitation = false)
+        public Task<User> InsertUser(User user)
         {
             return Task.Factory.StartNew<User>(() =>
             {
@@ -167,11 +168,6 @@ namespace Tango.FSE.BL.Services
 
                 var u = GetUserDetails(user.Guid).Result;
 
-                if (sendInvitation)
-                {
-                    //TODO: reach out to machine service and send an email with the password via SendGrid.
-                }
-
                 return u;
             });
         }
@@ -203,6 +199,24 @@ namespace Tango.FSE.BL.Services
             });
         }
 
+        public Task SendNewUserInvitationEmail(String email, String fullName, String password)
+        {
+            return Task.Factory.StartNew(() =>
+            {
+                Authentication.ThrowIfNoPermission(Permissions.FSE_ManageOrganizationUsersAndRoles);
+                ConnectivityProvider.ThrowIfNoInternet();
+
+                var response = WebClient.SendUserInvitationEmail(new UserInvitationEmailRequest()
+                {
+                    Email = email,
+                    FullName = fullName,
+                    Password = password,
+                    MachineServiceAddress = Authentication.CurrentEnvironment.MachineServiceAddress
+                }).Result;
+
+            });
+        }
+
         public String GenerateRandomPassword()
         {
             String pass = String.Empty;
diff --git a/Software/Visual_Studio/FSE/Tango.FSE.BL/Web/FSEWebClientBase.cs b/Software/Visual_Studio/FSE/Tango.FSE.BL/Web/FSEWebClientBase.cs
index ddfc47d4b..68420ea67 100644
--- a/Software/Visual_Studio/FSE/Tango.FSE.BL/Web/FSEWebClientBase.cs
+++ b/Software/Visual_Studio/FSE/Tango.FSE.BL/Web/FSEWebClientBase.cs
@@ -75,5 +75,23 @@ namespace Tango.FSE.BL.Web
             return Post<Tango.FSE.Web.Messages.RefreshTokenRequest, Tango.FSE.Web.Messages.RefreshTokenResponse>("RefreshToken", request);
         }
 
+        /// <summary>
+        /// Executes the SendUserInvitationEmail action and returns Tango.FSE.Web.Messages.UserInvitationEmailResponse.
+        /// </summary>
+        /// <returns></returns>
+        public Task<Tango.FSE.Web.Messages.UserInvitationEmailResponse> SendUserInvitationEmail(Tango.FSE.Web.Messages.UserInvitationEmailRequest request)
+        {
+            return Post<Tango.FSE.Web.Messages.UserInvitationEmailRequest, Tango.FSE.Web.Messages.UserInvitationEmailResponse>("SendUserInvitationEmail", request);
+        }
+
+        /// <summary>
+        /// Executes the SendForgotPasswordEmail action and returns Tango.FSE.Web.Messages.ForgotPasswordResponse.
+        /// </summary>
+        /// <returns></returns>
+        public Task<Tango.FSE.Web.Messages.ForgotPasswordResponse> SendForgotPasswordEmail(Tango.FSE.Web.Messages.ForgotPasswordRequest request)
+        {
+            return Post<Tango.FSE.Web.Messages.ForgotPasswordRequest, Tango.FSE.Web.Messages.ForgotPasswordResponse>("SendForgotPasswordEmail", request);
+        }
+
     }
 }
diff --git a/Software/Visual_Studio/FSE/Tango.FSE.Web/Messages/ForgotPasswordRequest.cs b/Software/Visual_Studio/FSE/Tango.FSE.Web/Messages/ForgotPasswordRequest.cs
new file mode 100644
index 000000000..90ffbf904
--- /dev/null
+++ b/Software/Visual_Studio/FSE/Tango.FSE.Web/Messages/ForgotPasswordRequest.cs
@@ -0,0 +1,14 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+using Tango.Transport.Web;
+
+namespace Tango.FSE.Web.Messages
+{
+    public class ForgotPasswordRequest : WebRequestMessage
+    {
+        public String Email { get; set; }
+    }
+}
diff --git a/Software/Visual_Studio/FSE/Tango.FSE.Web/Messages/ForgotPasswordResponse.cs b/Software/Visual_Studio/FSE/Tango.FSE.Web/Messages/ForgotPasswordResponse.cs
new file mode 100644
index 000000000..bc4d94e64
--- /dev/null
+++ b/Software/Visual_Studio/FSE/Tango.FSE.Web/Messages/ForgotPasswordResponse.cs
@@ -0,0 +1,14 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+using Tango.Transport.Web;
+
+namespace Tango.FSE.Web.Messages
+{
+    public class ForgotPasswordResponse : WebResponseMessage
+    {
+        
+    }
+}
diff --git a/Software/Visual_Studio/FSE/Tango.FSE.Web/Messages/UserInvitationEmailRequest.cs b/Software/Visual_Studio/FSE/Tango.FSE.Web/Messages/UserInvitationEmailRequest.cs
new file mode 100644
index 000000000..b809a598d
--- /dev/null
+++ b/Software/Visual_Studio/FSE/Tango.FSE.Web/Messages/UserInvitationEmailRequest.cs
@@ -0,0 +1,17 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+using Tango.Transport.Web;
+
+namespace Tango.FSE.Web.Messages
+{
+    public class UserInvitationEmailRequest : WebRequestMessage
+    {
+        public String Email { get; set; }
+        public String FullName { get; set; }
+        public String Password { get; set; }
+        public String MachineServiceAddress { get; set; }
+    }
+}
diff --git a/Software/Visual_Studio/FSE/Tango.FSE.Web/Messages/UserInvitationEmailResponse.cs b/Software/Visual_Studio/FSE/Tango.FSE.Web/Messages/UserInvitationEmailResponse.cs
new file mode 100644
index 000000000..36163851a
--- /dev/null
+++ b/Software/Visual_Studio/FSE/Tango.FSE.Web/Messages/UserInvitationEmailResponse.cs
@@ -0,0 +1,14 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+using Tango.Transport.Web;
+
+namespace Tango.FSE.Web.Messages
+{
+    public class UserInvitationEmailResponse : WebResponseMessage
+    {
+
+    }
+}
diff --git a/Software/Visual_Studio/FSE/Tango.FSE.Web/Tango.FSE.Web.csproj b/Software/Visual_Studio/FSE/Tango.FSE.Web/Tango.FSE.Web.csproj
index 19b8330cb..4c9f769c4 100644
--- a/Software/Visual_Studio/FSE/Tango.FSE.Web/Tango.FSE.Web.csproj
+++ b/Software/Visual_Studio/FSE/Tango.FSE.Web/Tango.FSE.Web.csproj
@@ -47,10 +47,14 @@
     <Compile Include="Messages\CheckForUpdatesResponse.cs" />
     <Compile Include="Messages\DownloadTangoVersionRequest.cs" />
     <Compile Include="Messages\DownloadTangoVersionResponse.cs" />
+    <Compile Include="Messages\ForgotPasswordRequest.cs" />
+    <Compile Include="Messages\ForgotPasswordResponse.cs" />
     <Compile Include="Messages\LoginRequest.cs" />
     <Compile Include="Messages\LoginResponse.cs" />
     <Compile Include="Messages\RefreshTokenRequest.cs" />
     <Compile Include="Messages\RefreshTokenResponse.cs" />
+    <Compile Include="Messages\UserInvitationEmailResponse.cs" />
+    <Compile Include="Messages\UserInvitationEmailRequest.cs" />
     <Compile Include="Properties\AssemblyInfo.cs" />
   </ItemGroup>
   <ItemGroup>
diff --git a/Software/Visual_Studio/Referenced Assemblies/SendGrid/SendGrid.dll b/Software/Visual_Studio/Referenced Assemblies/SendGrid/SendGrid.dll
new file mode 100644
index 000000000..caf5dcd88
Binary files /dev/null and b/Software/Visual_Studio/Referenced Assemblies/SendGrid/SendGrid.dll differ
diff --git a/Software/Visual_Studio/Referenced Assemblies/SendGrid/SendGrid.xml b/Software/Visual_Studio/Referenced Assemblies/SendGrid/SendGrid.xml
new file mode 100644
index 000000000..427de183a
--- /dev/null
+++ b/Software/Visual_Studio/Referenced Assemblies/SendGrid/SendGrid.xml	
@@ -0,0 +1,1388 @@
+<?xml version="1.0"?>
+<doc>
+    <assembly>
+        <name>SendGrid</name>
+    </assembly>
+    <members>
+        <member name="T:SendGrid.Helpers.Mail.MailHelper">
+            <summary>
+            Simplified email sending for common use cases
+            </summary>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.MailHelper.CreateSingleEmail(SendGrid.Helpers.Mail.EmailAddress,SendGrid.Helpers.Mail.EmailAddress,System.String,System.String,System.String)">
+            <summary>
+            Send a single simple email
+            </summary>
+            <param name="from">An email object that may contain the recipient’s name, but must always contain the sender’s email.</param>
+            <param name="to">An email object that may contain the recipient’s name, but must always contain the recipient’s email.</param>
+            <param name="subject">The subject of your email. This may be overridden by SetGlobalSubject().</param>
+            <param name="plainTextContent">The text/plain content of the email body.</param>
+            <param name="htmlContent">The text/html content of the email body.</param>
+            <returns>A SendGridMessage object.</returns>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.MailHelper.CreateSingleTemplateEmail(SendGrid.Helpers.Mail.EmailAddress,SendGrid.Helpers.Mail.EmailAddress,System.String,System.Object)">
+            <summary>
+            Send a single dynamic template email
+            </summary>
+            <param name="from">An email object that may contain the recipient’s name, but must always contain the sender’s email.</param>
+            <param name="to">An email object that may contain the recipient’s name, but must always contain the recipient’s email.</param>
+            <param name="templateId">The ID of the template.</param>
+            <param name="dynamicTemplateData">The data with which to populate the dynamic template.</param>
+            <returns>A SendGridMessage object.</returns>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.MailHelper.CreateSingleEmailToMultipleRecipients(SendGrid.Helpers.Mail.EmailAddress,System.Collections.Generic.List{SendGrid.Helpers.Mail.EmailAddress},System.String,System.String,System.String)">
+            <summary>
+            Send a single simple email to multiple recipients
+            </summary>
+            <param name="from">An email object that may contain the recipient’s name, but must always contain the sender’s email.</param>
+            <param name="tos">A list of email objects that may contain the recipient’s name, but must always contain the recipient’s email.</param>
+            <param name="subject">The subject of your email. This may be overridden by SetGlobalSubject().</param>
+            <param name="plainTextContent">The text/plain content of the email body.</param>
+            <param name="htmlContent">The text/html content of the email body.</param>
+            <returns>A SendGridMessage object.</returns>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.MailHelper.CreateSingleTemplateEmailToMultipleRecipients(SendGrid.Helpers.Mail.EmailAddress,System.Collections.Generic.List{SendGrid.Helpers.Mail.EmailAddress},System.String,System.Object)">
+            <summary>
+            Send a single simple email to multiple recipients
+            </summary>
+            <param name="from">An email object that may contain the recipient’s name, but must always contain the sender’s email.</param>
+            <param name="tos">A list of email objects that may contain the recipient’s name, but must always contain the recipient’s email.</param>
+            <param name="templateId">The ID of the template.</param>
+            <param name="dynamicTemplateData">The data with which to populate the dynamic template.</param>
+            <returns>A SendGridMessage object.</returns>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.MailHelper.CreateMultipleEmailsToMultipleRecipients(SendGrid.Helpers.Mail.EmailAddress,System.Collections.Generic.List{SendGrid.Helpers.Mail.EmailAddress},System.Collections.Generic.List{System.String},System.String,System.String,System.Collections.Generic.List{System.Collections.Generic.Dictionary{System.String,System.String}})">
+            <summary>
+            Send multiple emails to multiple recipients.
+            </summary>
+            <param name="from">An email object that may contain the recipient’s name, but must always contain the sender’s email.</param>
+            <param name="tos">A list of email objects that may contain the recipient’s name, but must always contain the recipient’s email.</param>
+            <param name="subjects">The subject of your email. This may be overridden by SetGlobalSubject().</param>
+            <param name="plainTextContent">The text/plain content of the email body.</param>
+            <param name="htmlContent">The text/html content of the email body.</param>
+            <param name="substitutions">Substitution key/values to customize the content for each email.</param>
+            <returns>A SendGridMessage object.</returns>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.MailHelper.CreateMultipleTemplateEmailsToMultipleRecipients(SendGrid.Helpers.Mail.EmailAddress,System.Collections.Generic.List{SendGrid.Helpers.Mail.EmailAddress},System.String,System.Collections.Generic.List{System.Object})">
+            <summary>
+            Send multiple emails to multiple recipients.
+            </summary>
+            <param name="from">An email object that may contain the recipient’s name, but must always contain the sender’s email.</param>
+            <param name="tos">A list of email objects that may contain the recipient’s name, but must always contain the recipient’s email.</param>
+            <param name="templateId">The ID of the template.</param>
+            <param name="dynamicTemplateData">The data with which to populate the dynamic template.</param>
+            <returns>A SendGridMessage object.</returns>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.MailHelper.StringToEmailAddress(System.String)">
+            <summary>
+            Uncomplex conversion of a <![CDATA["Name <email@email.com>"]]> to EmailAddress
+            </summary>
+            <param name="rfc2822Email">"email@email.com" or <![CDATA["Name <email@email.com>"]]> string</param>
+            <returns>EmailsAddress Object</returns>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.MailHelper.CreateSingleEmailToMultipleRecipients(SendGrid.Helpers.Mail.EmailAddress,System.Collections.Generic.List{SendGrid.Helpers.Mail.EmailAddress},System.String,System.String,System.String,System.Boolean)">
+            <summary>
+            Send a single simple email to multiple recipients with option for displaying all the recipients present in "To" section of email
+            </summary>
+            <param name="from">An email object that may contain the recipient’s name, but must always contain the sender’s email.</param>
+            <param name="tos">A list of email objects that may contain the recipient’s name, but must always contain the recipient’s email.</param>
+            <param name="subject">The subject of your email. This may be overridden by SetGlobalSubject().</param>
+            <param name="plainTextContent">The text/plain content of the email body.</param>
+            <param name="htmlContent">The text/html content of the email body.</param>
+            <param name="showAllRecipients">Displays all the recipients present in the "To" section of email.The default value is false</param>
+            <returns>A SendGridMessage object.</returns>
+        </member>
+        <member name="T:SendGrid.Helpers.Mail.ASM">
+            <summary>
+            An object allowing you to specify how to handle unsubscribes.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.ASM.GroupId">
+            <summary>
+            Gets or sets the unsubscribe group to associate with this email.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.ASM.GroupsToDisplay">
+            <summary>
+            Gets or sets an array containing the unsubscribe groups that you would like to be displayed on the unsubscribe preferences page.
+            https://sendgrid.com/docs/User_Guide/Suppressions/recipient_subscription_preferences.html
+            </summary>
+        </member>
+        <member name="T:SendGrid.Helpers.Mail.Attachment">
+            <summary>
+            Gets or sets an array of objects in which you can specify any attachments you want to include.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.Attachment.Content">
+            <summary>
+            Gets or sets the Base64 encoded content of the attachment.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.Attachment.Type">
+            <summary>
+            Gets or sets the mime type of the content you are attaching. For example, application/pdf or image/jpeg.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.Attachment.Filename">
+            <summary>
+            Gets or sets the filename of the attachment.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.Attachment.Disposition">
+            <summary>
+            Gets or sets the content-disposition of the attachment specifying how you would like the attachment to be displayed. For example, "inline" results in the attached file being displayed automatically within the message while "attachment" results in the attached file requiring some action to be taken before it is displayed (e.g. opening or downloading the file). Defaults to "attachment". Can be either "attachment" or "inline".
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.Attachment.ContentId">
+            <summary>
+            Gets or sets a unique id that you specify for the attachment. This is used when the disposition is set to "inline" and the attachment is an image, allowing the file to be displayed within the body of your email. Ex: <img src="cid:ii_139db99fdb5c3704"></img>
+            </summary>
+        </member>
+        <member name="T:SendGrid.Helpers.Mail.BCCSettings">
+            <summary>
+            Gets or sets the address specified in the mail_settings.bcc object will receive a blind carbon copy (BCC) of the very first personalization defined in the personalizations array.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.BCCSettings.Enable">
+            <summary>
+            Gets or sets a value indicating whether this setting is enabled.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.BCCSettings.Email">
+            <summary>
+            Gets or sets the email address that you would like to receive the BCC.
+            </summary>
+        </member>
+        <member name="T:SendGrid.Helpers.Mail.BypassListManagement">
+            <summary>
+            Allows you to bypass all unsubscribe groups and suppressions to ensure that the email is delivered to every single recipient. This should only be used in emergencies when it is absolutely necessary that every recipient receives your email. Ex: outage emails, or forgot password emails.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.BypassListManagement.Enable">
+            <summary>
+            Gets or sets a value indicating whether this setting is enabled.
+            </summary>
+        </member>
+        <member name="T:SendGrid.Helpers.Mail.ClickTracking">
+            <summary>
+            Allows you to track whether a recipient clicked a link in your email.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.ClickTracking.Enable">
+            <summary>
+            Gets or sets a value indicating whether this setting is enabled.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.ClickTracking.EnableText">
+            <summary>
+            Gets or sets if this setting should be included in the text/plain portion of your email.
+            </summary>
+        </member>
+        <member name="T:SendGrid.Helpers.Mail.Content">
+            <summary>
+            Specifies the content of your email. You can include multiple mime types of content, but you must specify at least one. To include more than one mime type, simply add another object to the array containing the type and value parameters. If included, text/plain and text/html must be the first indices of the array in this order. If you choose to include the text/plain or text/html mime types, they must be the first indices of the content array in the order text/plain, text/html.*Content is NOT mandatory if you using a transactional template and have defined the template_id in the Request
+            </summary>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.Content.#ctor">
+            <summary>
+            Initializes a new instance of the <see cref="T:SendGrid.Helpers.Mail.Content"/> class.
+            </summary>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.Content.#ctor(System.String,System.String)">
+            <summary>
+            Initializes a new instance of the <see cref="T:SendGrid.Helpers.Mail.Content"/> class.
+            </summary>
+            <param name="type">The mime type of the content you are including in your email. For example, text/plain or text/html.</param>
+            <param name="value">The actual content of the specified mime type that you are including in your email.</param>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.Content.Type">
+            <summary>
+            Gets or sets the mime type of the content you are including in your email. For example, text/plain or text/html.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.Content.Value">
+            <summary>
+            Gets or sets the actual content of the specified mime type that you are including in your email.
+            </summary>
+        </member>
+        <member name="T:SendGrid.Helpers.Mail.EmailAddress">
+            <summary>
+            An email object containing the email address and name of the sender or recipient.
+            </summary>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.EmailAddress.#ctor">
+            <summary>
+            Initializes a new instance of the <see cref="T:SendGrid.Helpers.Mail.EmailAddress"/> class.
+            </summary>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.EmailAddress.#ctor(System.String,System.String)">
+            <summary>
+            Initializes a new instance of the <see cref="T:SendGrid.Helpers.Mail.EmailAddress"/> class.
+            </summary>
+            <param name="email">The email address of the sender or recipient.</param>
+            <param name="name">The name of the sender or recipient.</param>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.EmailAddress.Name">
+            <summary>
+            Gets or sets the name of the sender or recipient.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.EmailAddress.Email">
+            <summary>
+            Gets or sets the email address of the sender or recipient.
+            </summary>
+        </member>
+        <member name="T:SendGrid.Helpers.Mail.FooterSettings">
+            <summary>
+            The default footer that you would like appended to the bottom of every email.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.FooterSettings.Enable">
+            <summary>
+            Gets or sets a value indicating whether this setting is enabled.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.FooterSettings.Text">
+            <summary>
+            Gets or sets the plain text content of your footer.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.FooterSettings.Html">
+            <summary>
+            Gets or sets the HTML content of your footer.
+            </summary>
+        </member>
+        <member name="T:SendGrid.Helpers.Mail.Ganalytics">
+            <summary>
+            Allows you to enable tracking provided by Google Analytics.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.Ganalytics.Enable">
+            <summary>
+            Gets or sets a value indicating whether this setting is enabled.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.Ganalytics.UtmSource">
+            <summary>
+            Gets or sets the name of the referrer source. (e.g. Google, SomeDomain.com, or Marketing Email)
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.Ganalytics.UtmMedium">
+            <summary>
+            Gets or sets the name of the marketing medium. (e.g. Email)
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.Ganalytics.UtmTerm">
+            <summary>
+            Gets or sets the identification of any paid keywords.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.Ganalytics.UtmContent">
+            <summary>
+            Gets or sets the differentiation of your campaign from advertisements.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.Ganalytics.UtmCampaign">
+            <summary>
+            Gets or sets the name of the campaign.
+            </summary>
+        </member>
+        <member name="T:SendGrid.Helpers.Mail.Model.HtmlContent">
+            <summary>
+            Helper class for plain html mime types
+            </summary>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.Model.HtmlContent.#ctor(System.String)">
+            <summary>
+            Initializes a new instance of the <see cref="T:SendGrid.Helpers.Mail.Model.HtmlContent"/> class.
+            </summary>
+            <param name="value">The actual content of the specified mime type that you are including in your email.</param>
+        </member>
+        <member name="T:SendGrid.Helpers.Mail.Model.PlainTextContent">
+            <summary>
+            Helper class for plain text mime types
+            </summary>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.Model.PlainTextContent.#ctor(System.String)">
+            <summary>
+            Initializes a new instance of the <see cref="T:SendGrid.Helpers.Mail.Model.PlainTextContent"/> class.
+            </summary>
+            <param name="value">The actual content of the specified mime type that you are including in your email.</param>
+        </member>
+        <member name="T:SendGrid.Helpers.Mail.MailSettings">
+            <summary>
+            A collection of different mail settings that you can use to specify how you would like this email to be handled.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.MailSettings.BccSettings">
+            <summary>
+            Gets or sets the address specified in the mail_settings.bcc object will receive a blind carbon copy (BCC) of the very first personalization defined in the personalizations array.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.MailSettings.BypassListManagement">
+            <summary>
+            Gets or sets the bypass of all unsubscribe groups and suppressions to ensure that the email is delivered to every single recipient. This should only be used in emergencies when it is absolutely necessary that every recipient receives your email. Ex: outage emails, or forgot password emails.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.MailSettings.FooterSettings">
+            <summary>
+            Gets or sets the default footer that you would like appended to the bottom of every email.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.MailSettings.SandboxMode">
+            <summary>
+            Gets or sets the ability to send a test email to ensure that your request body is valid and formatted correctly. For more information, please see our Classroom.
+            https://sendgrid.com/docs/Classroom/Send/v3_Mail_Send/sandbox_mode.html
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.MailSettings.SpamCheck">
+            <summary>
+            Gets or sets the ability to test the content of your email for spam.
+            </summary>
+        </member>
+        <member name="T:SendGrid.Helpers.Mail.OpenTracking">
+            <summary>
+            Allows you to track whether the email was opened or not, but including a single pixel image in the body of the content. When the pixel is loaded, we can log that the email was opened.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.OpenTracking.Enable">
+            <summary>
+            Gets or sets a value indicating whether this setting is enabled.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.OpenTracking.SubstitutionTag">
+            <summary>
+            Gets or sets the ability to specify a substitution tag that you can insert in the body of your email at a location that you desire. This tag will be replaced by the open tracking pixel.
+            </summary>
+        </member>
+        <member name="T:SendGrid.Helpers.Mail.Personalization">
+            <summary>
+            An array of messages and their metadata. Each object within personalizations can be thought of as an envelope - it defines who should receive an individual message and how that message should be handled. For more information, please see our documentation on Personalizations. Parameters in personalizations will override the parameters of the same name from the message level.
+            https://sendgrid.com/docs/Classroom/Send/v3_Mail_Send/personalizations.html
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.Personalization.Tos">
+            <summary>
+            Gets or sets an array of recipients. Each email object within this array may contain the recipient’s name, but must always contain the recipient’s email.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.Personalization.Ccs">
+            <summary>
+            Gets or sets an array of recipients who will receive a copy of your email. Each email object within this array may contain the recipient’s name, but must always contain the recipient’s email.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.Personalization.Bccs">
+            <summary>
+            Gets or sets an array of recipients who will receive a blind carbon copy of your email. Each email object within this array may contain the recipient’s name, but must always contain the recipient’s email.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.Personalization.Subject">
+            <summary>
+            Gets or sets the subject line of your email.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.Personalization.Headers">
+            <summary>
+            Gets or sets the object allowing you to specify specific handling instructions for your email.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.Personalization.Substitutions">
+            <summary>
+            Gets or sets an object following the pattern "substitution_tag":"value to substitute". All are assumed to be strings. These substitutions will apply to the content of your email, in addition to the subject and reply-to parameters.
+            You may not include more than 100 substitutions per personalization object, and the total collective size of your substitutions may not exceed 10,000 bytes per personalization object.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.Personalization.CustomArgs">
+            <summary>
+            Gets or sets the values that are specific to this personalization that will be carried along with the email, activity data, and links. Substitutions will not be made on custom arguments. personalizations[x].custom_args will be merged with message level custom_args, overriding any conflicting keys. The combined total size of the resulting custom arguments, after merging, for each personalization may not exceed 10,000 bytes.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.Personalization.SendAt">
+            <summary>
+            Gets or sets a unix timestamp allowing you to specify when you want your email to be sent from Twilio SendGrid. This is not necessary if you want the email to be sent at the time of your API request.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.Personalization.TemplateData">
+            <summary>
+            Gets or sets the template data object following the pattern "template data key":"template data value". All are assumed to be strings. These key value pairs will apply to the content of your template email, in addition to the subject and reply-to parameters.
+            </summary>
+        </member>
+        <member name="T:SendGrid.Helpers.Mail.SandboxMode">
+            <summary>
+            This allows you to send a test email to ensure that your request body is valid and formatted correctly. For more information, please see our Classroom.
+            https://sendgrid.com/docs/Classroom/Send/v3_Mail_Send/sandbox_mode.html
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.SandboxMode.Enable">
+            <summary>
+            Gets or sets a value indicating whether this setting is enabled.
+            </summary>
+        </member>
+        <member name="T:SendGrid.Helpers.Mail.SpamCheck">
+            <summary>
+            This allows you to test the content of your email for spam.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.SpamCheck.Enable">
+            <summary>
+            Gets or sets a value indicating whether this setting is enabled.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.SpamCheck.Threshold">
+            <summary>
+            Gets or sets the threshold used to determine if your content qualifies as spam on a scale from 1 to 10, with 10 being most strict, or most likely to be considered as spam.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.SpamCheck.PostToUrl">
+            <summary>
+            Gets or sets an Inbound Parse URL that you would like a copy of your email along with the spam report to be sent to. The post_to_url parameter must start with http:// or https://.
+            </summary>
+        </member>
+        <member name="T:SendGrid.Helpers.Mail.SubscriptionTracking">
+            <summary>
+            Allows you to insert a subscription management link at the bottom of the text and html bodies of your email. If you would like to specify the location of the link within your email, you may use the substitution_tag.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.SubscriptionTracking.Enable">
+            <summary>
+            Gets or sets a value indicating whether this setting is enabled.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.SubscriptionTracking.Text">
+            <summary>
+            Gets or sets the text to be appended to the email, with the subscription tracking link. You may control where the link is by using the tag (percent symbol) (percent symbol)
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.SubscriptionTracking.Html">
+            <summary>
+            Gets or sets the HTML to be appended to the email, with the subscription tracking link. You may control where the link is by using the tag (percent symbol) (percent symbol)
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.SubscriptionTracking.SubstitutionTag">
+            <summary>
+            Gets or sets a tag that will be replaced with the unsubscribe URL. for example: [unsubscribe_url]. If this parameter is used, it will override both the textand html parameters. The URL of the link will be placed at the substitution tag’s location, with no additional formatting.
+            </summary>
+        </member>
+        <member name="T:SendGrid.Helpers.Mail.TrackingSettings">
+            <summary>
+            Settings to determine how you would like to track the metrics of how your recipients interact with your email.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.TrackingSettings.ClickTracking">
+            <summary>
+            Gets or sets tracking whether a recipient clicked a link in your email.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.TrackingSettings.OpenTracking">
+            <summary>
+            Gets or sets tracking whether the email was opened or not, but including a single pixel image in the body of the content. When the pixel is loaded, we can log that the email was opened.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.TrackingSettings.SubscriptionTracking">
+            <summary>
+            Gets or sets a subscription management link at the bottom of the text and html bodies of your email. If you would like to specify the location of the link within your email, you may use the substitution_tag.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.TrackingSettings.Ganalytics">
+            <summary>
+            Gets or sets tracking provided by Google Analytics.
+            </summary>
+        </member>
+        <member name="T:SendGrid.Helpers.Mail.SendGridMessage">
+            <summary>
+            Class SendGridMessage builds an object that sends an email through Twilio SendGrid.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.SendGridMessage.From">
+            <summary>
+            Gets or sets an email object containing the email address and name of the sender. Unicode encoding is not supported for the from field.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.SendGridMessage.Subject">
+            <summary>
+            Gets or sets the subject of your email. This may be overridden by personalizations[x].subject.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.SendGridMessage.Personalizations">
+            <summary>
+            Gets or sets a list of messages and their metadata. Each object within personalizations can be thought of as an envelope - it defines who should receive an individual message and how that message should be handled. For more information, please see our documentation on Personalizations. Parameters in personalizations will override the parameters of the same name from the message level.
+            https://sendgrid.com/docs/Classroom/Send/v3_Mail_Send/personalizations.html
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.SendGridMessage.Contents">
+            <summary>
+            Gets or sets a list in which you may specify the content of your email. You can include multiple mime types of content, but you must specify at least one. To include more than one mime type, simply add another object to the array containing the type and value parameters. If included, text/plain and text/html must be the first indices of the array in this order. If you choose to include the text/plain or text/html mime types, they must be the first indices of the content array in the order text/plain, text/html.*Content is NOT mandatory if you using a transactional template and have defined the template_id in the Request
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.SendGridMessage.PlainTextContent">
+            <summary>
+            Gets or sets a Content object with a Mime Type of text/plain.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.SendGridMessage.HtmlContent">
+            <summary>
+            Gets or sets a Content object with a Mime Type of text/html.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.SendGridMessage.Attachments">
+            <summary>
+            Gets or sets a list of objects in which you can specify any attachments you want to include.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.SendGridMessage.TemplateId">
+            <summary>
+            Gets or sets the id of a template that you would like to use. If you use a template that contains content and a subject (either text or html), you do not need to specify those in the respective personalizations or message level parameters.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.SendGridMessage.Headers">
+            <summary>
+            Gets or sets an object containing key/value pairs of header names and the value to substitute for them. You must ensure these are properly encoded if they contain unicode characters. Must not be any of the following reserved headers: x-sg-id, x-sg-eid, received, dkim-signature, Content-Type, Content-Transfer-Encoding, To, From, Subject, Reply-To, CC, BCC
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.SendGridMessage.Sections">
+            <summary>
+            Gets or sets an object of key/value pairs that define large blocks of content that can be inserted into your emails using substitution tags.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.SendGridMessage.Categories">
+            <summary>
+            Gets or sets a list of category names for this message. Each category name may not exceed 255 characters. You cannot have more than 10 categories per request.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.SendGridMessage.CustomArgs">
+            <summary>
+            Gets or sets values that are specific to the entire send that will be carried along with the email and its activity data. Substitutions will not be made on custom arguments, so any string that is entered into this parameter will be assumed to be the custom argument that you would like to be used. This parameter is overridden by any conflicting personalizations[x].custom_args if that parameter has been defined. If personalizations[x].custom_args has been defined but does not conflict with the values defined within this parameter, the two will be merged. The combined total size of these custom arguments may not exceed 10,000 bytes.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.SendGridMessage.SendAt">
+            <summary>
+            Gets or sets a unix timestamp allowing you to specify when you want your email to be sent from SendGrid. This is not necessary if you want the email to be sent at the time of your API request.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.SendGridMessage.Asm">
+            <summary>
+            Gets or sets an object allowing you to specify how to handle unsubscribes.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.SendGridMessage.BatchId">
+            <summary>
+            Gets or sets an ID that represents a batch of emails (AKA multiple sends of the same email) to be associated to each other for scheduling. Including a batch_id in your request allows you to include this email in that batch, and also enables you to cancel or pause the delivery of that entire batch. For more information, please read about Cancel Scheduled Sends.
+            https://sendgrid.com/docs/API_Reference/Web_API_v3/cancel_schedule_send.html
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.SendGridMessage.IpPoolName">
+            <summary>
+            Gets or sets the IP Pool that you would like to send this email from.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.SendGridMessage.MailSettings">
+            <summary>
+            Gets or sets a collection of different mail settings that you can use to specify how you would like this email to be handled.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.SendGridMessage.TrackingSettings">
+            <summary>
+            Gets or sets settings to determine how you would like to track the metrics of how your recipients interact with your email.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Mail.SendGridMessage.ReplyTo">
+            <summary>
+            Gets or sets an email object containing the email address and name of the individual who should receive responses to your email.
+            </summary>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.SendGridMessage.AddTo(System.String,System.String)">
+            <summary>
+            Add a recipient email.
+            </summary>
+            <param name="email">Specify the recipient's email</param>
+            <param name="name">Specify the recipient's name</param>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.SendGridMessage.AddTo(SendGrid.Helpers.Mail.EmailAddress,System.Int32,SendGrid.Helpers.Mail.Personalization)">
+            <summary>
+            Add a recipient email.
+            </summary>
+            <param name="email">An email recipient that may contain the recipient’s name, but must always contain the recipient’s email.</param>
+            <param name="personalizationIndex">Specify the index of the Personalization object where you want to add the recipient email.</param>
+            <param name="personalization">A personalization object to append to the message.</param>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.SendGridMessage.AddTos(System.Collections.Generic.List{SendGrid.Helpers.Mail.EmailAddress},System.Int32,SendGrid.Helpers.Mail.Personalization)">
+            <summary>
+            Add recipient emails.
+            </summary>
+            <param name="emails">A list of recipients. Each email object within this array may contain the recipient’s name, but must always contain the recipient’s email.</param>
+            <param name="personalizationIndex">Specify the index of the Personalization object where you want to add the recipient emails.</param>
+            <param name="personalization">A personalization object to append to the message.</param>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.SendGridMessage.AddCc(System.String,System.String)">
+            <summary>
+            Add a cc email recipient.
+            </summary>
+            <param name="email">Specify the recipient's email</param>
+            <param name="name">Specify the recipient's name</param>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.SendGridMessage.AddCc(SendGrid.Helpers.Mail.EmailAddress,System.Int32,SendGrid.Helpers.Mail.Personalization)">
+            <summary>
+            Add a cc email recipient.
+            </summary>
+            <param name="email">An email recipient that may contain the recipient’s name, but must always contain the recipient’s email.</param>
+            <param name="personalizationIndex">Specify the index of the Personalization object where you want to add the cc email.</param>
+            <param name="personalization">A personalization object to append to the message.</param>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.SendGridMessage.AddCcs(System.Collections.Generic.List{SendGrid.Helpers.Mail.EmailAddress},System.Int32,SendGrid.Helpers.Mail.Personalization)">
+            <summary>
+            Add cc recipient emails.
+            </summary>
+            <param name="emails">A list of cc recipients. Each email object within this array may contain the recipient’s name, but must always contain the recipient’s email.</param>
+            <param name="personalizationIndex">Specify the index of the Personalization object where you want to add the cc emails.</param>
+            <param name="personalization">A personalization object to append to the message.</param>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.SendGridMessage.AddBcc(System.String,System.String)">
+            <summary>
+            Add a bcc recipient emails.
+            </summary>
+            <param name="email">Specify the recipient's email</param>
+            <param name="name">Specify the recipient's name</param>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.SendGridMessage.AddBcc(SendGrid.Helpers.Mail.EmailAddress,System.Int32,SendGrid.Helpers.Mail.Personalization)">
+            <summary>
+            Add a bcc recipient emails.
+            </summary>
+            <param name="email">An email recipient that may contain the recipient’s name, but must always contain the recipient’s email.</param>
+            <param name="personalizationIndex">Specify the index of the Personalization object where you want to add the bcc email.</param>
+            <param name="personalization">A personalization object to append to the message.</param>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.SendGridMessage.AddBccs(System.Collections.Generic.List{SendGrid.Helpers.Mail.EmailAddress},System.Int32,SendGrid.Helpers.Mail.Personalization)">
+            <summary>
+            Add bcc email recipients.
+            </summary>
+            <param name="emails">A list of bcc recipients. Each email object within this array may contain the recipient’s name, but must always contain the recipient’s email.</param>
+            <param name="personalizationIndex">Specify the index of the Personalization object where you want to add the bcc emails.</param>
+            <param name="personalization">A personalization object to append to the message.</param>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.SendGridMessage.SetSubject(System.String,System.Int32,SendGrid.Helpers.Mail.Personalization)">
+            <summary>
+            Add a subject to the email.
+            </summary>
+            <param name="subject">The subject line of your email.</param>
+            <param name="personalizationIndex">Specify the index of the Personalization object where you want to add the subject.</param>
+            <param name="personalization">A personalization object to append to the message.</param>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.SendGridMessage.AddHeader(System.String,System.String,System.Int32,SendGrid.Helpers.Mail.Personalization)">
+            <summary>
+            Add a header to the email.
+            </summary>
+            <param name="headerKey">Header key. (e.g. X-Header)</param>
+            <param name="headerValue">Header value.</param>
+            <param name="personalizationIndex">Specify the index of the Personalization object where you want to add the header.</param>
+            <param name="personalization">A personalization object to append to the message.</param>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.SendGridMessage.AddHeaders(System.Collections.Generic.Dictionary{System.String,System.String},System.Int32,SendGrid.Helpers.Mail.Personalization)">
+            <summary>
+            Add headers to the email.
+            </summary>
+            <param name="headers">A list of Headers.</param>
+            <param name="personalizationIndex">Specify the index of the Personalization object where you want to add the headers.</param>
+            <param name="personalization">A personalization object to append to the message.</param>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.SendGridMessage.AddSubstitution(System.String,System.String,System.Int32,SendGrid.Helpers.Mail.Personalization)">
+            <summary>
+            Add a substitution to the email.
+            You may not include more than 100 substitutions per personalization object, and the total collective size of your substitutions may not exceed 10,000 bytes per personalization object.
+            </summary>
+            <param name="substitutionKey">The substitution key.</param>
+            <param name="substitutionValue">The substitution value.</param>
+            <param name="personalizationIndex">Specify the index of the Personalization object where you want to add the substitution.</param>
+            <param name="personalization">A personalization object to append to the message.</param>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.SendGridMessage.AddSubstitutions(System.Collections.Generic.Dictionary{System.String,System.String},System.Int32,SendGrid.Helpers.Mail.Personalization)">
+            <summary>
+            Add substitutions to the email.
+            </summary>
+            <param name="substitutions">A list of Substitutions.</param>
+            <param name="personalizationIndex">Specify the index of the Personalization object where you want to add the substitutions.</param>
+            <param name="personalization">A personalization object to append to the message.</param>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.SendGridMessage.SetTemplateData(System.Object,System.Int32,SendGrid.Helpers.Mail.Personalization)">
+            <summary>
+            Add dynamic template data to the email.
+            </summary>
+            <param name="dynamicTemplateData">A Template Data object.</param>
+            <param name="personalizationIndex">Specify the index of the Personalization object where you want to add the substitutions.</param>
+            <param name="personalization">A personalization object to append to the message.</param>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.SendGridMessage.AddCustomArg(System.String,System.String,System.Int32,SendGrid.Helpers.Mail.Personalization)">
+            <summary>
+            Add a custom argument to the email.
+            </summary>
+            <param name="customArgKey">The custom argument key.</param>
+            <param name="customArgValue">The custom argument value.</param>
+            <param name="personalizationIndex">Specify the index of the Personalization object where you want to add the custom arg.</param>
+            <param name="personalization">A personalization object to append to the message.</param>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.SendGridMessage.AddCustomArgs(System.Collections.Generic.Dictionary{System.String,System.String},System.Int32,SendGrid.Helpers.Mail.Personalization)">
+            <summary>
+            Add custom arguments to the email.
+            </summary>
+            <param name="customArgs">A list of CustomArgs.</param>
+            <param name="personalizationIndex">Specify the index of the Personalization object where you want to add the custom args.</param>
+            <param name="personalization">A personalization object to append to the message.</param>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.SendGridMessage.SetSendAt(System.Int32,System.Int32,SendGrid.Helpers.Mail.Personalization)">
+            <summary>
+            Specify the unix timestamp to specify when you want the email to be sent from Twilio SendGrid.
+            </summary>
+            <param name="sendAt">Specify the unix timestamp for when you want the email to be sent from Twilio SendGrid</param>
+            <param name="personalizationIndex">Specify the index of the Personalization object where you want to add the send at timestamp.</param>
+            <param name="personalization">A personalization object to append to the message.</param>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.SendGridMessage.SetFrom(System.String,System.String)">
+            <summary>
+            Set the from email.
+            </summary>
+            <param name="email">Specify the recipient's email</param>
+            <param name="name">Specify the recipient's name</param>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.SendGridMessage.SetFrom(SendGrid.Helpers.Mail.EmailAddress)">
+            <summary>
+            Set the from email.
+            </summary>
+            <param name="email">An email object containing the email address and name of the sender. Unicode encoding is not supported for the from field.</param>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.SendGridMessage.SetReplyTo(SendGrid.Helpers.Mail.EmailAddress)">
+            <summary>
+            Set the reply to email.
+            </summary>
+            <param name="email">An email object containing the email address and name of the individual who should receive responses to your email.</param>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.SendGridMessage.SetGlobalSubject(System.String)">
+            <summary>
+            Set a global subject line.
+            </summary>
+            <param name="subject">The subject of your email. This may be overridden by personalizations[x].subject.</param>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.SendGridMessage.AddContent(System.String,System.String)">
+            <summary>
+            Add content to the email.
+            </summary>
+            <param name="mimeType">The mime type of the content you are including in your email. For example, text/plain or text/html.</param>
+            <param name="text">The actual content of the specified mime type that you are including in your email.</param>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.SendGridMessage.AddContents(System.Collections.Generic.List{SendGrid.Helpers.Mail.Content})">
+            <summary>
+            Add contents to the email.
+            </summary>
+            <param name="contents">A list of Content.</param>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.SendGridMessage.AddAttachmentAsync(System.String,System.IO.Stream,System.String,System.String,System.String,System.Threading.CancellationToken)">
+            <summary>
+            Add an attachment from a stream to the email. No attachment will be added in the case that the stream cannot be read. Streams of length greater than int.MaxValue are truncated.
+            </summary>
+            <param name="filename">The filename the attachment will display in the email.</param>
+            <param name="contentStream">The stream to use as content of the attachment.</param>
+            <param name="type">The mime type of the content you are attaching. For example, application/pdf or image/jpeg.</param>
+            <param name="disposition">The content-disposition of the attachment specifying how you would like the attachment to be displayed. For example, "inline" results in the attached file being displayed automatically within the message while "attachment" results in the attached file requiring some action to be taken before it is displayed (e.g. opening or downloading the file). Defaults to "attachment". Can be either "attachment" or "inline".</param>
+            <param name="content_id">A unique id that you specify for the attachment. This is used when the disposition is set to "inline" and the attachment is an image, allowing the file to be displayed within the body of your email. Ex: <![CDATA[ <img src="cid:ii_139db99fdb5c3704"></img> ]]></param>
+            <param name="cancellationToken">A cancellation token which can notify if the task should be canceled.</param>
+            <returns>A <see cref="T:System.Threading.Tasks.Task"/> representing the asynchronous operation.</returns>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.SendGridMessage.AddAttachment(System.String,System.String,System.String,System.String,System.String)">
+            <summary>
+            Add an attachment to the email.
+            </summary>
+            <param name="filename">The filename the attachment will display in the email.</param>
+            <param name="base64Content">The Base64 encoded content of the attachment.</param>
+            <param name="type">The mime type of the content you are attaching. For example, application/pdf or image/jpeg.</param>
+            <param name="disposition">The content-disposition of the attachment specifying how you would like the attachment to be displayed. For example, "inline" results in the attached file being displayed automatically within the message while "attachment" results in the attached file requiring some action to be taken before it is displayed (e.g. opening or downloading the file). Defaults to "attachment". Can be either "attachment" or "inline".</param>
+            <param name="content_id">A unique id that you specify for the attachment. This is used when the disposition is set to "inline" and the attachment is an image, allowing the file to be displayed within the body of your email. Ex: <![CDATA[ <img src="cid:ii_139db99fdb5c3704"></img> ]]></param>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.SendGridMessage.AddAttachment(SendGrid.Helpers.Mail.Attachment)">
+            <summary>
+            Add an attachment to the email.
+            </summary>
+            <param name="attachment">An Attachment.</param>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.SendGridMessage.AddAttachments(System.Collections.Generic.IEnumerable{SendGrid.Helpers.Mail.Attachment})">
+            <summary>
+            Add attachments to the email.
+            </summary>
+            <param name="attachments">A list of Attachments.</param>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.SendGridMessage.SetTemplateId(System.String)">
+            <summary>
+            Add a template id to the email.
+            </summary>
+            <param name="templateID">The id of a template that you would like to use. If you use a template that contains content and a subject (either text or html), you do not need to specify those in the respective personalizations or message level parameters.</param>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.SendGridMessage.AddSection(System.String,System.String)">
+            <summary>
+            Add a section substitution to the email.
+            </summary>
+            <param name="key">The section key.</param>
+            <param name="value">The section replacement value.</param>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.SendGridMessage.AddSections(System.Collections.Generic.Dictionary{System.String,System.String})">
+            <summary>
+            Add sections to the email.
+            </summary>
+            <param name="sections">A list of Sections.</param>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.SendGridMessage.AddGlobalHeader(System.String,System.String)">
+            <summary>
+            Add a global header to the email.
+            </summary>
+            <param name="key">Header key. (e.g. X-Header)</param>
+            <param name="value">Header value.</param>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.SendGridMessage.AddGlobalHeaders(System.Collections.Generic.Dictionary{System.String,System.String})">
+            <summary>
+            Add global headers to the email.
+            </summary>
+            <param name="headers">A list of Headers.</param>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.SendGridMessage.AddCategory(System.String)">
+            <summary>
+            Add a category to the email.
+            </summary>
+            <param name="category">A category name, not to exceed 255 characters. There is a limit of 10 categories per request.</param>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.SendGridMessage.AddCategories(System.Collections.Generic.List{System.String})">
+            <summary>
+            Add categories to the email.
+            </summary>
+            <param name="categories">A list of Categories.</param>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.SendGridMessage.AddGlobalCustomArg(System.String,System.String)">
+            <summary>
+            Add a global custom argument.
+            </summary>
+            <param name="key">The custom arguments key. The value of this key will be overridden by custom args at the personalization level.</param>
+            <param name="value">The custom argument value.</param>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.SendGridMessage.AddGlobalCustomArgs(System.Collections.Generic.Dictionary{System.String,System.String})">
+            <summary>
+            Add global custom arguments.
+            </summary>
+            <param name="customArgs">A list of CustomArgs.</param>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.SendGridMessage.SetGlobalSendAt(System.Int32)">
+            <summary>
+            Set the global send at unix timestamp.
+            </summary>
+            <param name="sendAt">A unix timestamp allowing you to specify when you want your email to be sent from Twilio SendGrid. This is not necessary if you want the email to be sent at the time of your API request.</param>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.SendGridMessage.SetBatchId(System.String)">
+            <summary>
+            Set the email's batch id.
+            </summary>
+            <param name="batchId">
+            This ID represents a batch of emails (AKA multiple sends of the same email) to be associated to each other for scheduling. Including a batch_id in your request allows you to include this email in that batch, and also enables you to cancel or pause the delivery of that entire batch. For more information, please read about Cancel Scheduled Sends.
+            https://sendgrid.com/docs/API_Reference/Web_API_v3/cancel_schedule_send.html
+            </param>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.SendGridMessage.SetAsm(System.Int32,System.Collections.Generic.List{System.Int32})">
+            <summary>
+            Set advanced suppression management. (ASM)
+            </summary>
+            <param name="groupID">The unsubscribe group to associate with this email.</param>
+            <param name="groupsToDisplay">
+            An array containing the unsubscribe groups that you would like to be displayed on the unsubscribe preferences page.
+            https://sendgrid.com/docs/User_Guide/Suppressions/recipient_subscription_preferences.html
+            </param>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.SendGridMessage.SetIpPoolName(System.String)">
+            <summary>
+            Set this email's IP Pool.
+            </summary>
+            <param name="ipPoolName">The IP Pool that you would like to send this email from.</param>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.SendGridMessage.SetBccSetting(System.Boolean,System.String)">
+            <summary>
+            Set the bcc settings.
+            The address specified in the mail_settings.bcc object will receive a blind carbon copy (BCC) of the very first personalization defined in the personalizations array.
+            </summary>
+            <param name="enable">Gets or sets a value indicating whether this setting is enabled.</param>
+            <param name="email">The email address that you would like to receive the BCC.</param>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.SendGridMessage.SetBypassListManagement(System.Boolean)">
+            <summary>
+            Set the bypass list management setting.
+            Allows you to bypass all unsubscribe groups and suppressions to ensure that the email is delivered to every single recipient. This should only be used in emergencies when it is absolutely necessary that every recipient receives your email. Ex: outage emails, or forgot password emails.
+            </summary>
+            <param name="enable">Gets or sets a value indicating whether this setting is enabled.</param>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.SendGridMessage.SetFooterSetting(System.Boolean,System.String,System.String)">
+            <summary>
+            Set the footer setting.
+            The default footer that you would like appended to the bottom of every email.
+            </summary>
+            <param name="enable">Gets or sets a value indicating whether this setting is enabled.</param>
+            <param name="html">The HTML content of your footer.</param>
+            <param name="text">The plain text content of your footer.</param>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.SendGridMessage.SetSandBoxMode(System.Boolean)">
+            <summary>
+            Set the sandbox mode setting.
+            This allows you to send a test email to ensure that your request body is valid and formatted correctly. For more information, please see our Classroom.
+            </summary>
+            <param name="enable">Gets or sets a value indicating whether this setting is enabled.</param>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.SendGridMessage.SetSpamCheck(System.Boolean,System.Int32,System.String)">
+            <summary>
+            Set the spam check setting.
+            This allows you to test the content of your email for spam.
+            </summary>
+            <param name="enable">Gets or sets a value indicating whether this setting is enabled.</param>
+            <param name="threshold">The threshold used to determine if your content qualifies as spam on a scale from 1 to 10, with 10 being most strict, or most likely to be considered as spam.</param>
+            <param name="postToUrl">An Inbound Parse URL that you would like a copy of your email along with the spam report to be sent to. The post_to_url parameter must start with http:// or https://.</param>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.SendGridMessage.SetClickTracking(System.Boolean,System.Boolean)">
+            <summary>
+            Set the click tracking setting.
+            Allows you to track whether a recipient clicked a link in your email.
+            </summary>
+            <param name="enable">Gets or sets a value indicating whether this setting is enabled.</param>
+            <param name="enableText">Indicates if this setting should be included in the text/plain portion of your email.</param>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.SendGridMessage.SetOpenTracking(System.Boolean,System.String)">
+            <summary>
+            Set the open tracking setting.
+            Allows you to track whether the email was opened or not, but including a single pixel image in the body of the content. When the pixel is loaded, we can log that the email was opened.
+            </summary>
+            <param name="enable">Gets or sets a value indicating whether this setting is enabled.</param>
+            <param name="substitutionTag">Allows you to specify a substitution tag that you can insert in the body of your email at a location that you desire. This tag will be replaced by the open tracking pixel.</param>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.SendGridMessage.SetSubscriptionTracking(System.Boolean,System.String,System.String,System.String)">
+            <summary>
+            Set the subscription tracking setting.
+            Allows you to insert a subscription management link at the bottom of the text and html bodies of your email. If you would like to specify the location of the link within your email, you may use the substitution_tag.
+            </summary>
+            <param name="enable">Gets or sets a value indicating whether this setting is enabled.</param>
+            <param name="html">HTML to be appended to the email, with the subscription tracking link. You may control where the link is by using the tag <![CDATA[ <% %> ]]></param>
+            <param name="text">Text to be appended to the email, with the subscription tracking link. You may control where the link is by using the tag <![CDATA[ <% %> ]]></param>
+            <param name="substitutionTag">A tag that will be replaced with the unsubscribe URL. for example: [unsubscribe_url]. If this parameter is used, it will override both the textand html parameters. The URL of the link will be placed at the substitution tag’s location, with no additional formatting.</param>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.SendGridMessage.SetGoogleAnalytics(System.Boolean,System.String,System.String,System.String,System.String,System.String)">
+            <summary>
+            Set the Google analytics setting.
+            Allows you to enable tracking provided by Google Analytics.
+            </summary>
+            <param name="enable">Gets or sets a value indicating whether this setting is enabled.</param>
+            <param name="utmCampaign">The name of the campaign.</param>
+            <param name="utmContent">Used to differentiate your campaign from advertisements.</param>
+            <param name="utmMedium">Name of the marketing medium. (e.g. Email)</param>
+            <param name="utmSource">Name of the referrer source. (e.g. Google, SomeDomain.com, or Marketing Email)</param>
+            <param name="utmTerm">Used to identify any paid keywords.</param>
+        </member>
+        <member name="M:SendGrid.Helpers.Mail.SendGridMessage.Serialize">
+            <summary>
+            Creates the JSON object required to make a request to Twilio SendGrid.
+            </summary>
+            <returns>The JSON object required to make a request to Twilio SendGrid.</returns>
+        </member>
+        <member name="T:SendGrid.Helpers.Reliability.ReliabilitySettings">
+            <summary>
+            Defines the reliability settings to use on HTTP requests
+            </summary>
+        </member>
+        <member name="M:SendGrid.Helpers.Reliability.ReliabilitySettings.#ctor">
+            <summary>
+            Initializes a new instance of the <see cref="T:SendGrid.Helpers.Reliability.ReliabilitySettings"/> class with default settings.
+            </summary>
+        </member>
+        <member name="M:SendGrid.Helpers.Reliability.ReliabilitySettings.#ctor(System.Int32,System.TimeSpan,System.TimeSpan,System.TimeSpan)">
+            <summary>
+            Initializes a new instance of the <see cref="T:SendGrid.Helpers.Reliability.ReliabilitySettings"/> class.
+            </summary>
+            <param name="maximumNumberOfRetries">The maximum number of retries to execute against when sending an HTTP Request before throwing an exception</param>
+            <param name="minimumBackoff">The minimum amount of time to wait between between HTTP retries</param>
+            <param name="maximumBackOff">the maximum amount of time to wait between between HTTP retries</param>
+            <param name="deltaBackOff">the value that will be used to calculate a random delta in the exponential delay between retries</param>
+        </member>
+        <member name="P:SendGrid.Helpers.Reliability.ReliabilitySettings.MaximumNumberOfRetries">
+            <summary>
+                Gets the maximum number of retries to execute against when sending an HTTP Request before throwing an exception. Defaults to 0 (no retries, you must explicitly enable)
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Reliability.ReliabilitySettings.MinimumBackOff">
+            <summary>
+            Gets the minimum amount of time to wait between between HTTP retries. Defaults to 1 second
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Reliability.ReliabilitySettings.MaximumBackOff">
+            <summary>
+            Gets the maximum amount of time to wait between between HTTP retries. Defaults to 10 seconds
+            </summary>
+        </member>
+        <member name="P:SendGrid.Helpers.Reliability.ReliabilitySettings.DeltaBackOff">
+            <summary>
+            Gets the value that will be used to calculate a random delta in the exponential delay between retries. Defaults to 1 second
+            </summary>
+        </member>
+        <member name="T:SendGrid.Helpers.Reliability.RetryDelegatingHandler">
+            <summary>
+            A delegating handler that provides retry functionality while executing a request
+            </summary>
+        </member>
+        <member name="M:SendGrid.Helpers.Reliability.RetryDelegatingHandler.#ctor(SendGrid.Helpers.Reliability.ReliabilitySettings)">
+            <summary>
+            Initializes a new instance of the <see cref="T:SendGrid.Helpers.Reliability.RetryDelegatingHandler"/> class.
+            </summary>
+            <param name="settings">A ReliabilitySettings instance</param>
+        </member>
+        <member name="M:SendGrid.Helpers.Reliability.RetryDelegatingHandler.#ctor(System.Net.Http.HttpMessageHandler,SendGrid.Helpers.Reliability.ReliabilitySettings)">
+            <summary>
+            Initializes a new instance of the <see cref="T:SendGrid.Helpers.Reliability.RetryDelegatingHandler"/> class.
+            </summary>
+            <param name="innerHandler">A HttpMessageHandler instance to set as the inner handler</param>
+            <param name="settings">A ReliabilitySettings instance</param>
+        </member>
+        <member name="M:SendGrid.Helpers.Reliability.RetryDelegatingHandler.SendAsync(System.Net.Http.HttpRequestMessage,System.Threading.CancellationToken)">
+            <inheritdoc />
+        </member>
+        <member name="T:SendGrid.ISendGridClient">
+            <summary>
+            A HTTP client wrapper for interacting with Twilio SendGrid's API
+            </summary>
+        </member>
+        <member name="P:SendGrid.ISendGridClient.UrlPath">
+            <summary>
+            Gets or sets the path to the API resource.
+            </summary>
+        </member>
+        <member name="P:SendGrid.ISendGridClient.Version">
+            <summary>
+            Gets or sets the API version.
+            </summary>
+        </member>
+        <member name="P:SendGrid.ISendGridClient.MediaType">
+            <summary>
+            Gets or sets the request media type.
+            </summary>
+        </member>
+        <member name="M:SendGrid.ISendGridClient.AddAuthorization(System.Collections.Generic.KeyValuePair{System.String,System.String})">
+            <summary>
+            Add the authorization header, override to customize
+            </summary>
+            <param name="header">Authorization header</param>
+            <returns>Authorization value to add to the header</returns>
+        </member>
+        <member name="M:SendGrid.ISendGridClient.MakeRequest(System.Net.Http.HttpRequestMessage,System.Threading.CancellationToken)">
+            <summary>
+            Make the call to the API server, override for testing or customization
+            </summary>
+            <param name="request">The parameters for the API call</param>
+            <param name="cancellationToken">Cancel the asynchronous call</param>
+            <returns>Response object</returns>
+        </member>
+        <member name="M:SendGrid.ISendGridClient.RequestAsync(SendGrid.SendGridClient.Method,System.String,System.String,System.String,System.Threading.CancellationToken)">
+            <summary>
+            Prepare for async call to the API server
+            </summary>
+            <param name="method">HTTP verb</param>
+            <param name="requestBody">JSON formatted string</param>
+            <param name="queryParams">JSON formatted query paramaters</param>
+            <param name="urlPath">The path to the API endpoint.</param>
+            <param name="cancellationToken">Cancel the asynchronous call.</param>
+            <returns>Response object</returns>
+            <exception>The method will NOT catch and swallow exceptions generated by sending a request
+            through the internal http client. Any underlying exception will pass right through.
+            In particular, this means that you may expect
+            a TimeoutException if you are not connected to the internet.</exception>
+        </member>
+        <member name="M:SendGrid.ISendGridClient.SendEmailAsync(SendGrid.Helpers.Mail.SendGridMessage,System.Threading.CancellationToken)">
+            <summary>
+            Make a request to send an email through Twilio SendGrid asynchronously.
+            </summary>
+            <param name="msg">A SendGridMessage object with the details for the request.</param>
+            <param name="cancellationToken">Cancel the asynchronous call.</param>
+            <returns>A Response object.</returns>
+        </member>
+        <member name="T:SendGrid.MimeType">
+            <summary>
+            Helper for the common Twilio SendGrid email mime types.
+            </summary>
+        </member>
+        <member name="F:SendGrid.MimeType.Html">
+            <summary>
+            The mime type for HTML content.
+            </summary>
+        </member>
+        <member name="F:SendGrid.MimeType.Text">
+            <summary>
+            The mime type for plain text content.
+            </summary>
+        </member>
+        <member name="T:SendGrid.Response">
+            <summary>
+            The response received from an API call to Twilio SendGrid
+            </summary>
+        </member>
+        <member name="F:SendGrid.Response.statusCode">
+            <summary>
+            The status code returned from Twilio SendGrid.
+            </summary>
+        </member>
+        <member name="F:SendGrid.Response.body">
+            <summary>
+            The response body returned from Twilio SendGrid.
+            </summary>
+        </member>
+        <member name="F:SendGrid.Response.headers">
+            <summary>
+            The response headers returned from Twilio SendGrid.
+            </summary>
+        </member>
+        <member name="M:SendGrid.Response.#ctor(System.Net.HttpStatusCode,System.Net.Http.HttpContent,System.Net.Http.Headers.HttpResponseHeaders)">
+            <summary>
+            Initializes a new instance of the <see cref="T:SendGrid.Response"/> class.
+            </summary>
+            <param name="statusCode">https://msdn.microsoft.com/en-us/library/system.net.httpstatuscode(v=vs.110).aspx</param>
+            <param name="responseBody">https://msdn.microsoft.com/en-us/library/system.net.http.httpcontent(v=vs.118).aspx</param>
+            <param name="responseHeaders">https://msdn.microsoft.com/en-us/library/system.net.http.headers.httpresponseheaders(v=vs.118).aspx</param>
+        </member>
+        <member name="P:SendGrid.Response.StatusCode">
+            <summary>
+            Gets or sets the status code returned from Twilio SendGrid.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Response.Body">
+            <summary>
+            Gets or sets the response body returned from Twilio SendGrid.
+            </summary>
+        </member>
+        <member name="P:SendGrid.Response.Headers">
+            <summary>
+            Gets or sets the response headers returned from Twilio SendGrid.
+            </summary>
+        </member>
+        <member name="M:SendGrid.Response.DeserializeResponseBodyAsync(System.Net.Http.HttpContent)">
+            <summary>
+            Converts string formatted response body to a Dictionary.
+            </summary>
+            <param name="content">https://msdn.microsoft.com/en-us/library/system.net.http.httpcontent(v=vs.118).aspx</param>
+            <returns>Dictionary object representation of HttpContent</returns>
+        </member>
+        <member name="M:SendGrid.Response.DeserializeResponseHeaders(System.Net.Http.Headers.HttpResponseHeaders)">
+            <summary>
+                Converts string formatted response headers to a Dictionary.
+            </summary>
+            <param name="content">https://msdn.microsoft.com/en-us/library/system.net.http.headers.httpresponseheaders(v=vs.118).aspx</param>
+            <returns>Dictionary object representation of  HttpResponseHeaders</returns>
+        </member>
+        <member name="T:SendGrid.SendGridClient">
+            <summary>
+            A HTTP client wrapper for interacting with Twilio SendGrid's API
+            </summary>
+        </member>
+        <member name="F:SendGrid.SendGridClient.client">
+            <summary>
+            The HttpClient instance to use for all calls from this SendGridClient instance.
+            </summary>
+        </member>
+        <member name="M:SendGrid.SendGridClient.#ctor(System.Net.IWebProxy,System.String,System.String,System.Collections.Generic.Dictionary{System.String,System.String},System.String,System.String)">
+            <summary>
+            Initializes a new instance of the <see cref="T:SendGrid.SendGridClient"/> class.
+            </summary>
+            <param name="webProxy">Web proxy.</param>
+            <param name="apiKey">Your Twilio SendGrid API key.</param>
+            <param name="host">Base url (e.g. https://api.sendgrid.com)</param>
+            <param name="requestHeaders">A dictionary of request headers</param>
+            <param name="version">API version, override AddVersion to customize</param>
+            <param name="urlPath">Path to endpoint (e.g. /path/to/endpoint)</param>
+            <returns>Interface to the Twilio SendGrid REST API</returns>
+        </member>
+        <member name="M:SendGrid.SendGridClient.#ctor(SendGrid.SendGridClientOptions)">
+            <summary>
+            Initializes a new instance of the <see cref="T:SendGrid.SendGridClient"/> class.
+            </summary>
+            <param name="options">A <see cref="T:SendGrid.SendGridClientOptions"/> instance that defines the configuration settings to use with the client </param>
+            <returns>Interface to the Twilio SendGrid REST API</returns>
+        </member>
+        <member name="M:SendGrid.SendGridClient.#ctor(System.Net.Http.HttpClient,System.String,System.String,System.Collections.Generic.Dictionary{System.String,System.String},System.String,System.String)">
+            <summary>
+            Initializes a new instance of the <see cref="T:SendGrid.SendGridClient"/> class.
+            </summary>
+            <param name="httpClient">An optional http client which may me injected in order to facilitate testing.</param>
+            <param name="apiKey">Your Twilio SendGrid API key.</param>
+            <param name="host">Base url (e.g. https://api.sendgrid.com)</param>
+            <param name="requestHeaders">A dictionary of request headers</param>
+            <param name="version">API version, override AddVersion to customize</param>
+            <param name="urlPath">Path to endpoint (e.g. /path/to/endpoint)</param>
+            <returns>Interface to the Twilio SendGrid REST API</returns>
+        </member>
+        <member name="M:SendGrid.SendGridClient.#ctor(System.String,System.String,System.Collections.Generic.Dictionary{System.String,System.String},System.String,System.String)">
+            <summary>
+            Initializes a new instance of the <see cref="T:SendGrid.SendGridClient"/> class.
+            </summary>
+            <param name="apiKey">Your Twilio SendGrid API key.</param>
+            <param name="host">Base url (e.g. https://api.sendgrid.com)</param>
+            <param name="requestHeaders">A dictionary of request headers</param>
+            <param name="version">API version, override AddVersion to customize</param>
+            <param name="urlPath">Path to endpoint (e.g. /path/to/endpoint)</param>
+            <returns>Interface to the Twilio SendGrid REST API</returns>
+        </member>
+        <member name="M:SendGrid.SendGridClient.#ctor(System.Net.Http.HttpClient,SendGrid.SendGridClientOptions)">
+            <summary>
+            Initializes a new instance of the <see cref="T:SendGrid.SendGridClient"/> class.
+            </summary>
+            <param name="httpClient">An optional http client which may me injected in order to facilitate testing.</param>
+            <param name="options">A <see cref="T:SendGrid.SendGridClientOptions"/> instance that defines the configuration settings to use with the client </param>
+            <returns>Interface to the Twilio SendGrid REST API</returns>
+        </member>
+        <member name="T:SendGrid.SendGridClient.Method">
+            <summary>
+            The supported API methods.
+            </summary>
+        </member>
+        <member name="F:SendGrid.SendGridClient.Method.DELETE">
+            <summary>
+            Remove a resource.
+            </summary>
+        </member>
+        <member name="F:SendGrid.SendGridClient.Method.GET">
+            <summary>
+            Get a resource.
+            </summary>
+        </member>
+        <member name="F:SendGrid.SendGridClient.Method.PATCH">
+            <summary>
+            Modify a portion of the resource.
+            </summary>
+        </member>
+        <member name="F:SendGrid.SendGridClient.Method.POST">
+            <summary>
+            Create a resource or execute a function. (e.g send an email)
+            </summary>
+        </member>
+        <member name="F:SendGrid.SendGridClient.Method.PUT">
+            <summary>
+            Update an entire resource.
+            </summary>
+        </member>
+        <member name="P:SendGrid.SendGridClient.UrlPath">
+            <summary>
+            Gets or sets the path to the API resource.
+            </summary>
+        </member>
+        <member name="P:SendGrid.SendGridClient.Version">
+            <summary>
+            Gets or sets the API version.
+            </summary>
+        </member>
+        <member name="P:SendGrid.SendGridClient.MediaType">
+            <summary>
+            Gets or sets the request media type.
+            </summary>
+        </member>
+        <member name="M:SendGrid.SendGridClient.AddAuthorization(System.Collections.Generic.KeyValuePair{System.String,System.String})">
+            <summary>
+            Add the authorization header, override to customize
+            </summary>
+            <param name="header">Authorization header</param>
+            <returns>Authorization value to add to the header</returns>
+        </member>
+        <member name="M:SendGrid.SendGridClient.MakeRequest(System.Net.Http.HttpRequestMessage,System.Threading.CancellationToken)">
+            <summary>
+            Make the call to the API server, override for testing or customization
+            </summary>
+            <param name="request">The parameters for the API call</param>
+            <param name="cancellationToken">Cancel the asynchronous call</param>
+            <returns>Response object</returns>
+        </member>
+        <member name="M:SendGrid.SendGridClient.RequestAsync(SendGrid.SendGridClient.Method,System.String,System.String,System.String,System.Threading.CancellationToken)">
+            <summary>
+            Prepare for async call to the API server
+            </summary>
+            <param name="method">HTTP verb</param>
+            <param name="requestBody">JSON formatted string</param>
+            <param name="queryParams">JSON formatted query paramaters</param>
+            <param name="urlPath">The path to the API endpoint.</param>
+            <param name="cancellationToken">Cancel the asynchronous call.</param>
+            <returns>Response object</returns>
+            <exception cref="T:System.Exception">The method will NOT catch and swallow exceptions generated by sending a request
+            through the internal http client. Any underlying exception will pass right through.
+            In particular, this means that you may expect
+            a TimeoutException if you are not connected to the internet.</exception>
+        </member>
+        <member name="M:SendGrid.SendGridClient.SendEmailAsync(SendGrid.Helpers.Mail.SendGridMessage,System.Threading.CancellationToken)">
+            <summary>
+            Make a request to send an email through Twilio SendGrid asynchronously.
+            </summary>
+            <param name="msg">A SendGridMessage object with the details for the request.</param>
+            <param name="cancellationToken">Cancel the asynchronous call.</param>
+            <returns>A Response object.</returns>
+        </member>
+        <member name="M:SendGrid.SendGridClient.BuildUrl(System.String,System.String)">
+            <summary>
+            Build the final URL
+            </summary>
+            <param name="urlPath">The URL path.</param>
+            <param name="queryParams">A string of JSON formatted query parameters (e.g {'param': 'param_value'})</param>
+            <returns>
+            Final URL
+            </returns>
+        </member>
+        <member name="M:SendGrid.SendGridClient.InitiateClient(System.String,System.String,System.Collections.Generic.Dictionary{System.String,System.String},System.String,System.String)">
+            <summary>
+            Common method to initiate internal fields regardless of which constructor was used.
+            </summary>
+            <param name="apiKey">Your Twilio SendGrid API key.</param>
+            <param name="host">Base url (e.g. https://api.sendgrid.com)</param>
+            <param name="requestHeaders">A dictionary of request headers</param>
+            <param name="version">API version, override AddVersion to customize</param>
+            <param name="urlPath">Path to endpoint (e.g. /path/to/endpoint)</param>
+        </member>
+        <member name="M:SendGrid.SendGridClient.ParseJson(System.String)">
+            <summary>
+            Parses a JSON string without removing duplicate keys.
+            </summary>
+            <remarks>
+            This function flattens all Objects/Array.
+            This means that for example <code>{'id': 1, 'id': 2, 'id': 3}</code> and
+            <code>{'id': [1, 2, 3]}</code> result in the same output.
+            </remarks>
+            <param name="json">The JSON string to parse.</param>
+            <returns>A dictionary of all values.</returns>
+        </member>
+        <member name="T:SendGrid.SendGridClientOptions">
+            <summary>
+            Defines the options to use with the Twilio SendGrid client
+            </summary>
+        </member>
+        <member name="M:SendGrid.SendGridClientOptions.#ctor">
+            <summary>
+            Initializes a new instance of the <see cref="T:SendGrid.SendGridClientOptions"/> class.
+            </summary>
+        </member>
+        <member name="P:SendGrid.SendGridClientOptions.ReliabilitySettings">
+            <summary>
+            Gets or sets the reliability settings to use on HTTP Requests
+            </summary>
+        </member>
+        <member name="P:SendGrid.SendGridClientOptions.ApiKey">
+            <summary>
+            Gets or sets the Twilio SendGrid API key
+            </summary>
+        </member>
+        <member name="P:SendGrid.SendGridClientOptions.RequestHeaders">
+            <summary>
+            Gets or sets the request headers to use on HttpRequests sent to Twilio SendGrid
+            </summary>
+        </member>
+        <member name="P:SendGrid.SendGridClientOptions.Host">
+            <summary>
+            Gets or sets base url (e.g. https://api.sendgrid.com, this is the default)
+            </summary>
+        </member>
+        <member name="P:SendGrid.SendGridClientOptions.Version">
+            <summary>
+            Gets or sets API version, override AddVersion to customize
+            </summary>
+        </member>
+        <member name="P:SendGrid.SendGridClientOptions.UrlPath">
+            <summary>
+            Gets or sets the path to the API endpoint.
+            </summary>
+        </member>
+    </members>
+</doc>
diff --git a/Software/Visual_Studio/Web/Tango.MachineService/Controllers/FSEController.cs b/Software/Visual_Studio/Web/Tango.MachineService/Controllers/FSEController.cs
index 7bf420df9..01878f16a 100644
--- a/Software/Visual_Studio/Web/Tango.MachineService/Controllers/FSEController.cs
+++ b/Software/Visual_Studio/Web/Tango.MachineService/Controllers/FSEController.cs
@@ -1,10 +1,13 @@
-using System;
+using SendGrid;
+using SendGrid.Helpers.Mail;
+using System;
 using System.Collections.Generic;
 using System.Linq;
 using System.Net;
 using System.Net.Http;
 using System.Security.Authentication;
 using System.Threading.Tasks;
+using System.Web;
 using System.Web.Http;
 using Tango.BL;
 using Tango.BL.Builders;
@@ -78,22 +81,6 @@ namespace Tango.MachineService.Controllers
                 AccessTokenExpiration = accessToken.ExpiresOn.UtcDateTime
             };
 
-
-            //Enforce Machine Studio Version ?
-            //if (MachineServiceConfig.ENFORCE_MACHINE_STUDIO_VERSION)
-            //{
-            //    using (var db = ObservablesContextHelper.CreateContext())
-            //    {
-            //        var latest_version = db.MachineStudioVersions.ToList().OrderByDescending(x => Version.Parse(x.Version)).FirstOrDefault();
-
-            //        if (latest_version != null && Version.Parse(latest_version.Version) != client_version)
-            //        {
-            //            versionChangeRequired = true;
-            //            requiredVersion = latest_version.Version;
-            //        }
-            //    }
-            //}
-
             //Return data source
             return new LoginResponse()
             {
@@ -230,5 +217,64 @@ namespace Tango.MachineService.Controllers
                 Expiration = accessToken.ExpiresOn.UtcDateTime,
             };
         }
+
+        [HttpPost]
+        [JwtTokenFilter]
+        public UserInvitationEmailResponse SendUserInvitationEmail(UserInvitationEmailRequest request)
+        {
+            using (ObservablesContext db = ObservablesContextHelper.CreateContext())
+            {
+                if (!db.Users.Any(x => x.Email.ToLower() == request.Email.ToLower()))
+                {
+                    throw new InvalidOperationException("User not found.");
+                }
+            }
+
+            var client = new SendGridClient(MachineServiceConfig.SEND_GRID_API_KEY);
+            SendGridMessage msg = new SendGridMessage();
+            msg.SetFrom("info@twine-s.com", "Twine Solutions LTD");
+            msg.AddTo(request.Email);
+            msg.Subject = "Welcome To Tango FSE";
+            msg.SetTemplateId("d-2af42ed0ea3c44b3abaa61016223555a");
+
+            var dynamicTemplateData = new
+            {
+                DownloadUrl = $"{request.MachineServiceAddress}/fse",
+                request.FullName,
+                request.Password,
+            };
+
+            msg.SetTemplateData(dynamicTemplateData);
+
+            var result = client.SendEmailAsync(msg).GetAwaiter().GetResult();
+
+            if (result.StatusCode != HttpStatusCode.Accepted)
+            {
+                throw new HttpException(result.StatusCode.ToString());
+            }
+
+            return new UserInvitationEmailResponse();
+        }
+
+        [HttpPost]
+        public ForgotPasswordResponse SendForgotPasswordEmail(ForgotPasswordRequest request)
+        {
+            using (ObservablesContext db = ObservablesContextHelper.CreateContext())
+            {
+                if (!db.Users.Any(x => x.Email.ToLower() == request.Email.ToLower()))
+                {
+                    throw new InvalidOperationException("User not found.");
+                }
+            }
+
+            //TODO: create a special link that when surfed will reset the password for the user and display the new temp password.
+            return new ForgotPasswordResponse();
+        }
+
+        [HttpGet]
+        public String ResetPassword(String guid)
+        {
+            return String.Empty; //Reset the password and return the new temp password.
+        }
     }
 }
diff --git a/Software/Visual_Studio/Web/Tango.MachineService/MachineServiceConfig.cs b/Software/Visual_Studio/Web/Tango.MachineService/MachineServiceConfig.cs
index 2a844fbc3..bdddbab8f 100644
--- a/Software/Visual_Studio/Web/Tango.MachineService/MachineServiceConfig.cs
+++ b/Software/Visual_Studio/Web/Tango.MachineService/MachineServiceConfig.cs
@@ -23,5 +23,7 @@ namespace Tango.MachineService
         public static String TFS_PERSONAL_TOKEN => ConfigurationManager.AppSettings[nameof(TFS_PERSONAL_TOKEN)].ToString();
 
         public static String FSE_TFS_USER_EMAIL => ConfigurationManager.AppSettings[nameof(FSE_TFS_USER_EMAIL)].ToString();
+
+        public static String SEND_GRID_API_KEY => ConfigurationManager.AppSettings[nameof(SEND_GRID_API_KEY)].ToString();
     }
 }
\ No newline at end of file
diff --git a/Software/Visual_Studio/Web/Tango.MachineService/Tango.MachineService.csproj b/Software/Visual_Studio/Web/Tango.MachineService/Tango.MachineService.csproj
index 67617ec7f..ea70fb7a6 100644
--- a/Software/Visual_Studio/Web/Tango.MachineService/Tango.MachineService.csproj
+++ b/Software/Visual_Studio/Web/Tango.MachineService/Tango.MachineService.csproj
@@ -188,6 +188,9 @@
     <Reference Include="Owin, Version=1.0.0.0, Culture=neutral, PublicKeyToken=f0ebd12fd5e55cc5, processorArchitecture=MSIL">
       <HintPath>..\..\packages\Owin.1.0\lib\net40\Owin.dll</HintPath>
     </Reference>
+    <Reference Include="SendGrid">
+      <HintPath>..\..\Referenced Assemblies\SendGrid\SendGrid.dll</HintPath>
+    </Reference>
     <Reference Include="System" />
     <Reference Include="System.Data" />
     <Reference Include="System.Data.DataSetExtensions" />
@@ -480,7 +483,7 @@
           <SaveServerSettingsInUserFile>False</SaveServerSettingsInUserFile>
         </WebProjectProperties>
       </FlavorProperties>
-      <UserProperties BuildVersion_AssemblyInfoFilename="Properties\AssemblyInfo.cs" BuildVersion_UpdateAssemblyVersion="True" BuildVersion_BuildVersioningStyle="None.None.Increment.TimeStamp" BuildVersion_UseGlobalSettings="False" BuildVersion_StartDate="2000/1/1" />
+      <UserProperties BuildVersion_StartDate="2000/1/1" BuildVersion_UseGlobalSettings="False" BuildVersion_BuildVersioningStyle="None.None.Increment.TimeStamp" BuildVersion_UpdateAssemblyVersion="True" BuildVersion_AssemblyInfoFilename="Properties\AssemblyInfo.cs" />
     </VisualStudio>
   </ProjectExtensions>
   <Target Name="EnsureNuGetPackageBuildImports" BeforeTargets="PrepareForBuild">
diff --git a/Software/Visual_Studio/Web/Tango.MachineService/Web.config b/Software/Visual_Studio/Web/Tango.MachineService/Web.config
index e90953ea2..9cfdc9ccd 100644
--- a/Software/Visual_Studio/Web/Tango.MachineService/Web.config
+++ b/Software/Visual_Studio/Web/Tango.MachineService/Web.config
@@ -36,6 +36,8 @@
     <add key="TFS_COLLECTION_URL" value="https://twinetfs.visualstudio.com" />
     <add key="TFS_PERSONAL_TOKEN" value="pyulwgs7m3v7pizz3oxusypdkdfw43txggo5mjwu2ouyv2qwprhq" />
     <add key="FSE_TFS_USER_EMAIL" value="fse@twine-s.com" />
+
+    <add key="SEND_GRID_API_KEY" value="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" />
   </appSettings>
   <!--
     For a description of web.config changes see http://go.microsoft.com/fwlink/?LinkId=235367.
-- 
cgit v1.3.1


From f4da5783b128b3da55eae406b054ae0f6e4d1b55 Mon Sep 17 00:00:00 2001
From: Roy Ben Shabat <Roy.mail.net@gmail.com>
Date: Mon, 11 May 2020 08:24:34 +0300
Subject: Forgot Password ! Reset Password !

---
 .../ViewModels/UserDetailsViewVM.cs                |   2 +-
 .../Tango.FSE.BL/Services/AuthenticationService.cs |   9 +-
 .../FSE/Tango.FSE.BL/Services/GatewayService.cs    |  12 +
 .../Tango.FSE.BL/Services/OrganizationsService.cs  |   5 +-
 .../FSE/Tango.FSE.UI/ViewModels/LoginViewVM.cs     |  44 ++++
 .../FSE/Tango.FSE.UI/Views/LoginView.xaml          |  33 +++
 .../Messages/ForgotPasswordRequest.cs              |   1 +
 .../Messages/UserInvitationEmailRequest.cs         |   3 +-
 .../Controllers/FSEAccountController.cs            |  67 ++++++
 .../Controllers/FSEController.cs                   |  71 +++++-
 .../Images/fse/password_reset.png                  | Bin 0 -> 8106 bytes
 .../Tango.MachineService/Styles/FSE/FSELayout.css  | 175 ++++++++++++++
 .../Tango.MachineService.csproj                    |   8 +-
 .../Views/FSEAccount/ResetPassword.cshtml          |  26 +++
 .../Views/FSEAccount/ResetPasswordVM.cs            |  13 ++
 .../Views/FSEDownloads/Index.cshtml                | 259 +++------------------
 .../Views/Shared/_FSELayout.cshtml                 |  42 ++++
 17 files changed, 516 insertions(+), 254 deletions(-)
 create mode 100644 Software/Visual_Studio/Web/Tango.MachineService/Controllers/FSEAccountController.cs
 create mode 100644 Software/Visual_Studio/Web/Tango.MachineService/Images/fse/password_reset.png
 create mode 100644 Software/Visual_Studio/Web/Tango.MachineService/Styles/FSE/FSELayout.css
 create mode 100644 Software/Visual_Studio/Web/Tango.MachineService/Views/FSEAccount/ResetPassword.cshtml
 create mode 100644 Software/Visual_Studio/Web/Tango.MachineService/Views/FSEAccount/ResetPasswordVM.cs
 create mode 100644 Software/Visual_Studio/Web/Tango.MachineService/Views/Shared/_FSELayout.cshtml

(limited to 'Software/Visual_Studio/Web/Tango.MachineService/Controllers')

diff --git a/Software/Visual_Studio/FSE/Modules/Tango.FSE.UsersAndRoles/ViewModels/UserDetailsViewVM.cs b/Software/Visual_Studio/FSE/Modules/Tango.FSE.UsersAndRoles/ViewModels/UserDetailsViewVM.cs
index 51ce71387..dec2651d1 100644
--- a/Software/Visual_Studio/FSE/Modules/Tango.FSE.UsersAndRoles/ViewModels/UserDetailsViewVM.cs
+++ b/Software/Visual_Studio/FSE/Modules/Tango.FSE.UsersAndRoles/ViewModels/UserDetailsViewVM.cs
@@ -281,7 +281,7 @@ namespace Tango.FSE.UsersAndRoles.ViewModels
                             {
                                 try
                                 {
-                                    await Services.OrganizationsService.SendNewUserInvitationEmail(Email, FirstName + " " + LastName, Password);
+                                    await Services.OrganizationsService.SendNewUserInvitationEmail(User.Guid, Password);
                                     invitationSent = true;
                                 }
                                 catch (Exception ex)
diff --git a/Software/Visual_Studio/FSE/Tango.FSE.BL/Services/AuthenticationService.cs b/Software/Visual_Studio/FSE/Tango.FSE.BL/Services/AuthenticationService.cs
index 05ec4f9be..ce2269cb8 100644
--- a/Software/Visual_Studio/FSE/Tango.FSE.BL/Services/AuthenticationService.cs
+++ b/Software/Visual_Studio/FSE/Tango.FSE.BL/Services/AuthenticationService.cs
@@ -8,7 +8,9 @@ using Tango.BL;
 using Tango.BL.Entities;
 using Tango.BL.Enumerations;
 using Tango.FSE.BL.CacheEntities;
+using Tango.FSE.BL.Web;
 using Tango.FSE.Web.Messages;
+using Tango.MachineService.Gateway;
 
 namespace Tango.FSE.BL.Services
 {
@@ -135,13 +137,16 @@ namespace Tango.FSE.BL.Services
         /// </summary>
         /// <param name="email">The email.</param>
         /// <returns></returns>
-        public Task SendForgotPasswordEmail(String email)
+        public Task SendForgotPasswordEmail(String email, EnvironmentConfiguration environment)
         {
             return Task.Factory.StartNew(() =>
             {
-                var response = WebClient.SendForgotPasswordEmail(new ForgotPasswordRequest()
+                FSEWebClient client = new FSEWebClient(environment.MachineServiceAddress);
+
+                var response = client.SendForgotPasswordEmail(new ForgotPasswordRequest()
                 {
                     Email = email,
+                    MachineServiceAddress = environment.MachineServiceAddress
                 }).Result;
             });
         }
diff --git a/Software/Visual_Studio/FSE/Tango.FSE.BL/Services/GatewayService.cs b/Software/Visual_Studio/FSE/Tango.FSE.BL/Services/GatewayService.cs
index 01e89b592..bd82d3615 100644
--- a/Software/Visual_Studio/FSE/Tango.FSE.BL/Services/GatewayService.cs
+++ b/Software/Visual_Studio/FSE/Tango.FSE.BL/Services/GatewayService.cs
@@ -17,6 +17,7 @@ namespace Tango.FSE.BL.Services
     public class GatewayService : FSEServiceBase
     {
         private const string ENVIRONMENTS_COLLECTION = "Environments";
+        private const string WEB_DEBUG_ADDRESS = "http://localhost:1111";
 
         private ReadOnlyObservableCollection<EnvironmentConfiguration> _environments;
         /// <summary>
@@ -49,6 +50,7 @@ namespace Tango.FSE.BL.Services
 
                            try
                            {
+
                                using (var cache = DiskCache.CreateContext())
                                {
                                    var collection = cache.Database.GetCollection<EnvironmentConfiguration>(ENVIRONMENTS_COLLECTION);
@@ -64,6 +66,16 @@ namespace Tango.FSE.BL.Services
                                LogManager.Log(ex, "Error caching online environments.");
                            }
 
+                           bool isWebDebug = Environment.GetCommandLineArgs().Contains("-webDebug");
+
+                           if (isWebDebug)
+                           {
+                               foreach (var item in list)
+                               {
+                                   item.MachineServiceAddress = WEB_DEBUG_ADDRESS;
+                               }
+                           }
+
                            return list;
                        }
 
diff --git a/Software/Visual_Studio/FSE/Tango.FSE.BL/Services/OrganizationsService.cs b/Software/Visual_Studio/FSE/Tango.FSE.BL/Services/OrganizationsService.cs
index 5ce968085..6ca60dc97 100644
--- a/Software/Visual_Studio/FSE/Tango.FSE.BL/Services/OrganizationsService.cs
+++ b/Software/Visual_Studio/FSE/Tango.FSE.BL/Services/OrganizationsService.cs
@@ -199,7 +199,7 @@ namespace Tango.FSE.BL.Services
             });
         }
 
-        public Task SendNewUserInvitationEmail(String email, String fullName, String password)
+        public Task SendNewUserInvitationEmail(String userGuid, String password)
         {
             return Task.Factory.StartNew(() =>
             {
@@ -208,8 +208,7 @@ namespace Tango.FSE.BL.Services
 
                 var response = WebClient.SendUserInvitationEmail(new UserInvitationEmailRequest()
                 {
-                    Email = email,
-                    FullName = fullName,
+                    UserGuid = userGuid,
                     Password = password,
                     MachineServiceAddress = Authentication.CurrentEnvironment.MachineServiceAddress
                 }).Result;
diff --git a/Software/Visual_Studio/FSE/Tango.FSE.UI/ViewModels/LoginViewVM.cs b/Software/Visual_Studio/FSE/Tango.FSE.UI/ViewModels/LoginViewVM.cs
index b9fcf9165..1b663db3c 100644
--- a/Software/Visual_Studio/FSE/Tango.FSE.UI/ViewModels/LoginViewVM.cs
+++ b/Software/Visual_Studio/FSE/Tango.FSE.UI/ViewModels/LoginViewVM.cs
@@ -40,6 +40,8 @@ namespace Tango.FSE.UI.ViewModels
             Logging,
             ChangePassword,
             ChangingPassword,
+            ForgotPassword,
+            SendingForgotPasswordEmail
         }
 
         private Rfc2898Cryptographer _cryptography;
@@ -147,6 +149,9 @@ namespace Tango.FSE.UI.ViewModels
 
         public RelayCommand LoginCommand { get; set; }
         public RelayCommand ChangePasswordCommand { get; set; }
+        public RelayCommand ForgotPasswordCommand { get; set; }
+        public RelayCommand SendPasswordResetEmailCommand { get; set; }
+        public RelayCommand CancelForgotPasswordCommand { get; set; }
 
         #endregion
 
@@ -160,6 +165,9 @@ namespace Tango.FSE.UI.ViewModels
             _cryptography = new Rfc2898Cryptographer();
             LoginCommand = new RelayCommand(Login, () => Email.IsNotNullOrEmpty() && Password.IsNotNullOrEmpty() && SelectedEnvironment != null);
             ChangePasswordCommand = new RelayCommand(ChangePassword, () => CurrentPassword.IsNotNullOrEmpty() && NewPassword.IsNotNullOrEmpty() && NewPassword == NewPasswordConfirm);
+            ForgotPasswordCommand = new RelayCommand(ForgotPassword);
+            SendPasswordResetEmailCommand = new RelayCommand(SendPasswordResetEmail);
+            CancelForgotPasswordCommand = new RelayCommand(CancelForgotPassword);
         }
 
         #endregion
@@ -357,5 +365,41 @@ namespace Tango.FSE.UI.ViewModels
         }
 
         #endregion
+
+        #region Forgot Password
+
+        private void ForgotPassword()
+        {
+            SelectedView = LoginViews.ForgotPassword;
+        }
+
+        private async void SendPasswordResetEmail()
+        {
+            try
+            {
+                IsFree = false;
+                SelectedView = LoginViews.SendingForgotPasswordEmail;
+                await Services.AuthenticationService.SendForgotPasswordEmail(Email, SelectedEnvironment);
+                SelectedView = LoginViews.Login;
+                await NotificationProvider.ShowSuccess("The email was delivered successfully!\nPlease check your email account.");
+            }
+            catch (Exception ex)
+            {
+                LogManager.Log(ex, "Error resetting user password.");
+                await NotificationProvider.ShowError($"An error occurred while trying to send the email.\n{ex.FlattenMessage()}");
+            }
+            finally
+            {
+                IsFree = true;
+                SelectedView = LoginViews.Login;
+            }
+        }
+
+        private void CancelForgotPassword()
+        {
+            SelectedView = LoginViews.Login;
+        }
+
+        #endregion
     }
 }
diff --git a/Software/Visual_Studio/FSE/Tango.FSE.UI/Views/LoginView.xaml b/Software/Visual_Studio/FSE/Tango.FSE.UI/Views/LoginView.xaml
index e92242562..f818d0c10 100644
--- a/Software/Visual_Studio/FSE/Tango.FSE.UI/Views/LoginView.xaml
+++ b/Software/Visual_Studio/FSE/Tango.FSE.UI/Views/LoginView.xaml
@@ -66,6 +66,14 @@
                     <CheckBox Margin="0 10 0 0" IsChecked="{Binding RememberMe}">remember my password</CheckBox>
 
                     <Button IsDefault="True" Margin="0 40 0 0" Height="50" material:ButtonAssist.CornerRadius="24" Command="{Binding LoginCommand}">LOGIN</Button>
+
+                    <Button Command="{Binding ForgotPasswordCommand}" Margin="0 10 0 0" HorizontalAlignment="Right" Content="Forgot password">
+                        <Button.Style>
+                            <Style TargetType="Button" BasedOn="{StaticResource FSE_FlatButton_OpacityHover}">
+                                <Setter Property="Foreground" Value="{StaticResource FSE_GrayBrush}"></Setter>
+                            </Style>
+                        </Button.Style>
+                    </Button>
                 </StackPanel>
 
                 <StackPanel controls:NavigationControl.NavigationName="Logging">
@@ -81,6 +89,7 @@
                     <TextBlock FontSize="{StaticResource FSE_DefaultFontSize}" Margin="0 20 0 0" TextAlignment="Center">
                         <Run Foreground="{StaticResource FSE_OrangeBrush}" FontSize="{StaticResource FSE_LargeFontSize}">Password change required on first login</Run>
                         <LineBreak/>
+                        <LineBreak/>
                         <Run Foreground="{StaticResource FSE_GrayBrush}" FontSize="{StaticResource FSE_SmallFontSize}">The system administrator requires you to change your password before proceeding to the system.</Run>
                     </TextBlock>
 
@@ -97,6 +106,30 @@
                     <ProgressBar Width="200" Height="200" HorizontalAlignment="Center" VerticalAlignment="Center" IsIndeterminate="{Binding IsBusy}" Style="{StaticResource MaterialDesignCircularProgressBar}" Value="0" />
                     <TextBlock HorizontalAlignment="Center" Margin="0 40 0 0" FontSize="18">Updating your password, please wait...</TextBlock>
                 </StackPanel>
+
+                <StackPanel TextElement.FontSize="16" controls:NavigationControl.NavigationName="ForgotPassword">
+
+                    <Image Source="/Images/login.png" Height="100" />
+
+                    <TextBlock FontSize="{StaticResource FSE_DefaultFontSize}" Margin="0 20 0 0" TextAlignment="Center">
+                        <Run Foreground="{StaticResource FSE_OrangeBrush}" FontSize="{StaticResource FSE_LargeFontSize}">Password Reset</Run>
+                        <LineBreak/>
+                        <LineBreak/>
+                        <Run Foreground="{StaticResource FSE_GrayBrush}" FontSize="{StaticResource FSE_SmallFontSize}">If you have forgotten your password we can send you an email with instructions on how to reset your password</Run>
+                    </TextBlock>
+
+                    <StackPanel Width="300">
+                        <TextBox Margin="0 35 0 0" Text="{Binding Email,UpdateSourceTrigger=PropertyChanged}" material:HintAssist.Hint="Email" material:HintAssist.IsFloating="True"></TextBox>
+
+                        <Button IsDefault="True" Margin="0 100 0 0" Height="50" material:ButtonAssist.CornerRadius="24" Style="{StaticResource FSE_Button_Orange}" Command="{Binding SendPasswordResetEmailCommand}">SEND EMAIL</Button>
+                        <Button Command="{Binding CancelForgotPasswordCommand}" Style="{StaticResource FSE_FlatButton_OpacityHover}" Foreground="{StaticResource FSE_GrayBrush}" Margin="0 20 0 0">BACK</Button>
+                    </StackPanel>
+                </StackPanel>
+
+                <StackPanel controls:NavigationControl.NavigationName="SendingForgotPasswordEmail">
+                    <ProgressBar Width="200" Height="200" HorizontalAlignment="Center" VerticalAlignment="Center" IsIndeterminate="{Binding IsBusy}" Style="{StaticResource MaterialDesignCircularProgressBar}" Value="0" />
+                    <TextBlock HorizontalAlignment="Center" Margin="0 40 0 0" FontSize="18">Sending password reset email, please wait...</TextBlock>
+                </StackPanel>
             </controls:NavigationControl>
         </Grid>
     </Grid>
diff --git a/Software/Visual_Studio/FSE/Tango.FSE.Web/Messages/ForgotPasswordRequest.cs b/Software/Visual_Studio/FSE/Tango.FSE.Web/Messages/ForgotPasswordRequest.cs
index 90ffbf904..a8ac52123 100644
--- a/Software/Visual_Studio/FSE/Tango.FSE.Web/Messages/ForgotPasswordRequest.cs
+++ b/Software/Visual_Studio/FSE/Tango.FSE.Web/Messages/ForgotPasswordRequest.cs
@@ -10,5 +10,6 @@ namespace Tango.FSE.Web.Messages
     public class ForgotPasswordRequest : WebRequestMessage
     {
         public String Email { get; set; }
+        public String MachineServiceAddress { get; set; }
     }
 }
diff --git a/Software/Visual_Studio/FSE/Tango.FSE.Web/Messages/UserInvitationEmailRequest.cs b/Software/Visual_Studio/FSE/Tango.FSE.Web/Messages/UserInvitationEmailRequest.cs
index b809a598d..23acbb536 100644
--- a/Software/Visual_Studio/FSE/Tango.FSE.Web/Messages/UserInvitationEmailRequest.cs
+++ b/Software/Visual_Studio/FSE/Tango.FSE.Web/Messages/UserInvitationEmailRequest.cs
@@ -9,8 +9,7 @@ namespace Tango.FSE.Web.Messages
 {
     public class UserInvitationEmailRequest : WebRequestMessage
     {
-        public String Email { get; set; }
-        public String FullName { get; set; }
+        public String UserGuid { get; set; }
         public String Password { get; set; }
         public String MachineServiceAddress { get; set; }
     }
diff --git a/Software/Visual_Studio/Web/Tango.MachineService/Controllers/FSEAccountController.cs b/Software/Visual_Studio/Web/Tango.MachineService/Controllers/FSEAccountController.cs
new file mode 100644
index 000000000..b7728af6a
--- /dev/null
+++ b/Software/Visual_Studio/Web/Tango.MachineService/Controllers/FSEAccountController.cs
@@ -0,0 +1,67 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Web;
+using System.Web.Mvc;
+using Tango.BL;
+using Tango.MachineService.Filters;
+using Tango.MachineService.Models;
+using Tango.Web.Helpers;
+using System.Data.Entity;
+using Tango.Web.Storage;
+using System.IO;
+using Microsoft.WindowsAzure.Storage.Blob;
+using System.Net.Http;
+using System.Net;
+using System.Net.Http.Headers;
+using System.Net.Mime;
+using Tango.MachineService.Views.FSEAccount;
+
+namespace Tango.MachineService.Controllers
+{
+    public class FSEAccountController : Controller
+    {
+        private static Random rnd = new Random();
+
+        public ActionResult ResetPassword(String id)
+        {
+            ResetPasswordVM vm = new ResetPasswordVM();
+            vm.FullName = "Full Name";
+            vm.Password = "Password";
+
+            var reset = FSEController.PendingPasswordResets.SingleOrDefault(x => x.ID == id);
+
+            if (reset != null)
+            {
+                using (ObservablesContext db = ObservablesContextHelper.CreateContext())
+                {
+                    var user = db.Users.SingleOrDefault(x => x.Guid == reset.UserGuid);
+
+                    if (user != null)
+                    {
+                        String newPass = GenerateRandomPassword();
+                        user.Password = Tango.BL.Entities.User.GetPasswordHash(newPass);
+                        user.PasswordChangeRequired = true;
+                        vm.Password = newPass;
+                        vm.FullName = reset.FullName;
+                        db.SaveChanges();
+                    }
+                }
+            }
+
+            return View(vm);
+        }
+
+        private String GenerateRandomPassword()
+        {
+            String pass = String.Empty;
+
+            for (int i = 0; i < 4; i++)
+            {
+                pass += rnd.Next(0, 9).ToString();
+            }
+
+            return pass;
+        }
+    }
+}
\ No newline at end of file
diff --git a/Software/Visual_Studio/Web/Tango.MachineService/Controllers/FSEController.cs b/Software/Visual_Studio/Web/Tango.MachineService/Controllers/FSEController.cs
index 01878f16a..e471ed20c 100644
--- a/Software/Visual_Studio/Web/Tango.MachineService/Controllers/FSEController.cs
+++ b/Software/Visual_Studio/Web/Tango.MachineService/Controllers/FSEController.cs
@@ -23,6 +23,7 @@ using Tango.Web.Security;
 using Tango.Web.SMO;
 using Tango.Web.SQLServer;
 using Tango.Web.Storage;
+using System.Data.Entity;
 using static Tango.MachineService.Controllers.FSEController;
 
 namespace Tango.MachineService.Controllers
@@ -34,6 +35,20 @@ namespace Tango.MachineService.Controllers
             public String UserGuid { get; set; }
         }
 
+        public class PasswordReset
+        {
+            public String ID { get; set; }
+            public String UserGuid { get; set; }
+            public String FullName { get; set; }
+        }
+
+        public static List<PasswordReset> PendingPasswordResets { get; set; }
+
+        static FSEController()
+        {
+            PendingPasswordResets = new List<PasswordReset>();
+        }
+
         [HttpPost]
         public LoginResponse Login(LoginRequest request)
         {
@@ -222,9 +237,13 @@ namespace Tango.MachineService.Controllers
         [JwtTokenFilter]
         public UserInvitationEmailResponse SendUserInvitationEmail(UserInvitationEmailRequest request)
         {
+            User user;
+
             using (ObservablesContext db = ObservablesContextHelper.CreateContext())
             {
-                if (!db.Users.Any(x => x.Email.ToLower() == request.Email.ToLower()))
+                user = db.Users.Include(x => x.Contact).SingleOrDefault(x => x.Guid == request.UserGuid);
+
+                if (user == null)
                 {
                     throw new InvalidOperationException("User not found.");
                 }
@@ -233,15 +252,15 @@ namespace Tango.MachineService.Controllers
             var client = new SendGridClient(MachineServiceConfig.SEND_GRID_API_KEY);
             SendGridMessage msg = new SendGridMessage();
             msg.SetFrom("info@twine-s.com", "Twine Solutions LTD");
-            msg.AddTo(request.Email);
+            msg.AddTo(user.Email);
             msg.Subject = "Welcome To Tango FSE";
             msg.SetTemplateId("d-2af42ed0ea3c44b3abaa61016223555a");
 
             var dynamicTemplateData = new
             {
                 DownloadUrl = $"{request.MachineServiceAddress}/fse",
-                request.FullName,
-                request.Password,
+                FullName = user.Contact.FirstName,
+                Password = request.Password,
             };
 
             msg.SetTemplateData(dynamicTemplateData);
@@ -259,22 +278,50 @@ namespace Tango.MachineService.Controllers
         [HttpPost]
         public ForgotPasswordResponse SendForgotPasswordEmail(ForgotPasswordRequest request)
         {
+            User user;
+
             using (ObservablesContext db = ObservablesContextHelper.CreateContext())
             {
-                if (!db.Users.Any(x => x.Email.ToLower() == request.Email.ToLower()))
+                user = db.Users.Include(x => x.Contact).SingleOrDefault(x => x.Email.ToLower() == request.Email.ToLower());
+
+                if (user == null)
                 {
                     throw new InvalidOperationException("User not found.");
                 }
             }
 
-            //TODO: create a special link that when surfed will reset the password for the user and display the new temp password.
-            return new ForgotPasswordResponse();
-        }
+            String resetId = Guid.NewGuid().ToString();
 
-        [HttpGet]
-        public String ResetPassword(String guid)
-        {
-            return String.Empty; //Reset the password and return the new temp password.
+            var client = new SendGridClient(MachineServiceConfig.SEND_GRID_API_KEY);
+            SendGridMessage msg = new SendGridMessage();
+            msg.SetFrom("info@twine-s.com", "Twine Solutions LTD");
+            msg.AddTo(request.Email);
+            msg.Subject = "Tango FSE Password Reset";
+            msg.SetTemplateId("d-18065487dae4456b8684d4b47a91e4a6");
+
+            var dynamicTemplateData = new
+            {
+                ResetPasswordUrl = $"{request.MachineServiceAddress}/FSEAccount/ResetPassword?id={resetId}",
+                FullName = user.Contact.FirstName,
+            };
+
+            msg.SetTemplateData(dynamicTemplateData);
+
+            var result = client.SendEmailAsync(msg).GetAwaiter().GetResult();
+
+            if (result.StatusCode != HttpStatusCode.Accepted)
+            {
+                throw new HttpException(result.StatusCode.ToString());
+            }
+
+            PendingPasswordResets.Add(new PasswordReset()
+            {
+                ID = resetId,
+                UserGuid = user.Guid,
+                FullName = user.Contact.FirstName,
+            });
+
+            return new ForgotPasswordResponse();
         }
     }
 }
diff --git a/Software/Visual_Studio/Web/Tango.MachineService/Images/fse/password_reset.png b/Software/Visual_Studio/Web/Tango.MachineService/Images/fse/password_reset.png
new file mode 100644
index 000000000..c1d42d7c4
Binary files /dev/null and b/Software/Visual_Studio/Web/Tango.MachineService/Images/fse/password_reset.png differ
diff --git a/Software/Visual_Studio/Web/Tango.MachineService/Styles/FSE/FSELayout.css b/Software/Visual_Studio/Web/Tango.MachineService/Styles/FSE/FSELayout.css
new file mode 100644
index 000000000..8c268d7c8
--- /dev/null
+++ b/Software/Visual_Studio/Web/Tango.MachineService/Styles/FSE/FSELayout.css
@@ -0,0 +1,175 @@
+body {
+    margin: 0;
+    padding: 0;
+    overflow-x: hidden;
+    font-family: 'Segoe UI';
+}
+
+.fse_primary_background {
+    background-color: #303030;
+}
+
+.fse_primary_accent_background {
+    background-color: #009FE7;
+}
+
+.fse_border_background {
+    background-color: #404040;
+}
+
+.fse_gray_foreground {
+    color: #808080;
+}
+
+.fse_primary_background_light {
+    background-color: #404040;
+}
+
+.fse_primary_foreground {
+    color: #EEEEEE;
+}
+
+.fse_primary_accent {
+    color: #009FE7;
+}
+
+.fse_header_back {
+    position: fixed;
+    padding: 20px;
+    box-shadow: black 1px 1px 10px 1px;
+    z-index: 100;
+    width: 100%;
+}
+
+.fse_machine_logo {
+    position: absolute;
+    left: 20px;
+    top: 20px;
+    width: 120px;
+    float: left;
+}
+
+.fse_twine_logo {
+    height: 80px;
+    display: block;
+    margin: auto auto;
+}
+
+.fse_container {
+    position: absolute;
+    margin-top: 100px;
+    overflow: hidden;
+    clear: both;
+    width:100%;
+}
+
+.fse_side_abstract {
+    position: fixed;
+    width: 60px;
+    height: 100%;
+    float: left;
+    background-image: url('../../Images/fse/abstract1.png');
+    background-repeat: repeat;
+}
+
+.fse_side_abstract_top {
+    position: absolute;
+    box-shadow: black 0px 3px 10px 2px;
+    width: 100%;
+}
+
+.fse_history_downloads_container {
+    float: left;
+    margin-left: 150px;
+    margin-top: 20px;
+    width: 500px;
+}
+
+.fse_history_download {
+    clear: both;
+    margin-top: 60px;
+}
+
+.fse_download_title {
+    vertical-align: baseline middle;
+}
+
+.fse_download_image {
+    height: 32px;
+}
+
+.fse_download_name {
+    margin-top: 5px;
+    margin-left: 5px;
+    vertical-align: top;
+    display: inline-block;
+}
+
+.fse_download_date {
+    float: right;
+    margin-top: 5px;
+    vertical-align: top;
+    display: inline-block;
+}
+
+.fse_download_separator {
+    clear: both;
+    height: 1px;
+    margin-top: 5px;
+}
+
+.fse_download_commets {
+    font-size: 12px;
+    margin-top: 10px;
+}
+
+.fse_download_link {
+    float: right;
+    text-decoration: none;
+    padding: 3px 15px;
+    border-radius: 2px;
+    font-size: 14px;
+}
+
+.fse_latest_version_container {
+    border-radius: 5px;
+    float: left;
+    margin-top: 100px;
+    margin-left: 200px;
+    width: 400px;
+    text-align: center;
+    box-shadow: black 0px 0px 5px 0px;
+}
+
+.fse_download_image_latest {
+    width: 64px;
+    margin-top: 20px;
+}
+
+.fse_download_title_latest {
+    margin-top: 10px;
+    font-size: 20px;
+    font-weight: 400;
+    text-align: center;
+}
+
+.fse_download_button_latest {
+    display: block;
+    padding: 15px 20px;
+    margin: 30px;
+    margin-top: 90px;
+    font-weight: 700;
+    border-radius: 25px;
+    text-decoration: none;
+    box-shadow: black 0px 0px 5px 0px;
+}
+
+.fse_title {
+    position: absolute;
+    display: inline-block;
+    float: left;
+    margin-left: 140px;
+    margin-top: 20px;
+    font-size: 25px;
+    font-weight: 400;
+}
diff --git a/Software/Visual_Studio/Web/Tango.MachineService/Tango.MachineService.csproj b/Software/Visual_Studio/Web/Tango.MachineService/Tango.MachineService.csproj
index ea70fb7a6..9b25a25a8 100644
--- a/Software/Visual_Studio/Web/Tango.MachineService/Tango.MachineService.csproj
+++ b/Software/Visual_Studio/Web/Tango.MachineService/Tango.MachineService.csproj
@@ -316,6 +316,7 @@
     </Compile>
     <Compile Include="App_Start\BundleConfig.cs" />
     <Compile Include="App_Start\FilterConfig.cs" />
+    <Compile Include="Controllers\FSEAccountController.cs" />
     <Compile Include="Controllers\FSEDownloadsController.cs" />
     <Compile Include="Controllers\DownloadsController.cs" />
     <Compile Include="Controllers\AccountController.cs" />
@@ -337,6 +338,7 @@
     </Compile>
     <Compile Include="Models\SessionVariables.cs" />
     <Compile Include="Properties\AssemblyInfo.cs" />
+    <Compile Include="Views\FSEAccount\ResetPasswordVM.cs" />
     <Compile Include="Views\FSEDownloads\IndexViewModel.cs" />
     <None Include="Security\RefreshTokenEncoder.cs" />
     <None Include="Security\RefreshTokenEntity.cs" />
@@ -349,8 +351,12 @@
     <Content Include="Images\fse\abstract2.png" />
     <Content Include="Images\fse\download.png" />
     <Content Include="Images\fse\machine_full.png" />
+    <Content Include="Images\fse\password_reset.png" />
     <Content Include="Images\fse\twine_logo_colored.png" />
+    <Content Include="Styles\FSE\FSELayout.css" />
     <Content Include="Views\FSEDownloads\Index.cshtml" />
+    <Content Include="Views\Shared\_FSELayout.cshtml" />
+    <Content Include="Views\FSEAccount\ResetPassword.cshtml" />
   </ItemGroup>
   <ItemGroup>
     <Content Include="Global.asax" />
@@ -483,7 +489,7 @@
           <SaveServerSettingsInUserFile>False</SaveServerSettingsInUserFile>
         </WebProjectProperties>
       </FlavorProperties>
-      <UserProperties BuildVersion_StartDate="2000/1/1" BuildVersion_UseGlobalSettings="False" BuildVersion_BuildVersioningStyle="None.None.Increment.TimeStamp" BuildVersion_UpdateAssemblyVersion="True" BuildVersion_AssemblyInfoFilename="Properties\AssemblyInfo.cs" />
+      <UserProperties BuildVersion_AssemblyInfoFilename="Properties\AssemblyInfo.cs" BuildVersion_UpdateAssemblyVersion="True" BuildVersion_BuildVersioningStyle="None.None.Increment.TimeStamp" BuildVersion_UseGlobalSettings="False" BuildVersion_StartDate="2000/1/1" />
     </VisualStudio>
   </ProjectExtensions>
   <Target Name="EnsureNuGetPackageBuildImports" BeforeTargets="PrepareForBuild">
diff --git a/Software/Visual_Studio/Web/Tango.MachineService/Views/FSEAccount/ResetPassword.cshtml b/Software/Visual_Studio/Web/Tango.MachineService/Views/FSEAccount/ResetPassword.cshtml
new file mode 100644
index 000000000..f0281d462
--- /dev/null
+++ b/Software/Visual_Studio/Web/Tango.MachineService/Views/FSEAccount/ResetPassword.cshtml
@@ -0,0 +1,26 @@
+@model Tango.MachineService.Views.FSEAccount.ResetPasswordVM
+
+@{
+    Layout = "~/Views/Shared/_FSELayout.cshtml";
+}
+
+<style>
+    .center-div {
+        position:relative;
+        clear: both;
+        margin-top: 100px;
+        text-align:center;
+    }
+</style>
+
+<div class="center-div">
+    <img src="~/Images/fse/password_reset.png" />
+    <h2>Hello @Model.FullName,</h2>
+    <br />
+    <h3>Your Tango FSE password was successfully reset</h3>
+    <div>Your new temporary password is:</div>
+    <div style="color:darkorange;font-weight:400">@Model.Password</div>
+    <br/>
+    <div style="color:gray">Please login to your account using the Tango FSE software to complete the process</div>
+</div>
+
diff --git a/Software/Visual_Studio/Web/Tango.MachineService/Views/FSEAccount/ResetPasswordVM.cs b/Software/Visual_Studio/Web/Tango.MachineService/Views/FSEAccount/ResetPasswordVM.cs
new file mode 100644
index 000000000..c1a1a3106
--- /dev/null
+++ b/Software/Visual_Studio/Web/Tango.MachineService/Views/FSEAccount/ResetPasswordVM.cs
@@ -0,0 +1,13 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Web;
+
+namespace Tango.MachineService.Views.FSEAccount
+{
+    public class ResetPasswordVM
+    {
+        public String FullName { get; set; }
+        public String Password { get; set; }
+    }
+}
\ No newline at end of file
diff --git a/Software/Visual_Studio/Web/Tango.MachineService/Views/FSEDownloads/Index.cshtml b/Software/Visual_Studio/Web/Tango.MachineService/Views/FSEDownloads/Index.cshtml
index fb64c18a1..7353ab76e 100644
--- a/Software/Visual_Studio/Web/Tango.MachineService/Views/FSEDownloads/Index.cshtml
+++ b/Software/Visual_Studio/Web/Tango.MachineService/Views/FSEDownloads/Index.cshtml
@@ -1,246 +1,39 @@
 @model Tango.MachineService.Views.FSEDownloads.IndexViewModel
 
 @{
-    Layout = null;
+    Layout = "~/Views/Shared/_FSELayout.cshtml";
 }
 
-<!DOCTYPE html>
 
-<html>
-<head>
-    <meta name="viewport" content="width=device-width" />
+<div class="fse_history_downloads_container">
 
-    <style>
-
-        body {
-            margin: 0;
-            padding: 0;
-            overflow-x: hidden;
-            font-family: 'Segoe UI';
-        }
-
-        .fse_primary_background {
-            background-color: #303030;
-        }
-
-        .fse_primary_accent_background {
-            background-color: #009FE7;
-        }
-
-        .fse_border_background {
-            background-color: #404040;
-        }
-
-        .fse_gray_foreground {
-            color: #808080;
-        }
-
-        .fse_primary_background_light {
-            background-color: #404040;
-        }
-
-        .fse_primary_foreground {
-            color: #EEEEEE;
-        }
-
-        .fse_primary_accent {
-            color: #009FE7;
-        }
-
-        .fse_header_back {
-            position:fixed;
-            padding: 20px;
-            box-shadow: black 1px 1px 10px 1px;
-            z-index: 100;
-            width: 100%;
-        }
-
-        .fse_machine_logo {
-            position: absolute;
-            left: 20px;
-            top: 20px;
-            width: 120px;
-            float: left;
-        }
-
-        .fse_twine_logo {
-            height: 80px;
-            display: block;
-            margin: auto auto;
-        }
-
-        .fse_container {
-            position: absolute;
-            margin-top: 100px;
-            overflow: hidden;
-            clear: both;
-        }
-
-        .fse_side_abstract {
-            position: fixed;
-            width: 60px;
-            height: 100%;
-            float: left;
-            background-image: url('../../Images/fse/abstract1.png');
-            background-repeat: repeat;
-        }
-
-        .fse_side_abstract_top {
-            position:absolute;
-            box-shadow: black 0px 3px 10px 2px;
-            width:100%;
-        }
-
-        .fse_history_downloads_container {
-            float: left;
-            margin-left: 150px;
-            margin-top: 20px;
-            width: 500px;
-        }
-
-        .fse_history_download {
-            clear: both;
-            margin-top: 60px;
-        }
-
-        .fse_download_title {
-            vertical-align: baseline middle;
-        }
-
-        .fse_download_image {
-            height: 32px;
-        }
-
-        .fse_download_name {
-            margin-top: 5px;
-            margin-left: 5px;
-            vertical-align: top;
-            display: inline-block;
-        }
-
-        .fse_download_date {
-            float: right;
-            margin-top: 5px;
-            vertical-align: top;
-            display: inline-block;
-        }
-
-        .fse_download_separator {
-            clear: both;
-            height: 1px;
-            margin-top: 5px;
-        }
-
-        .fse_download_commets {
-            font-size: 12px;
-            margin-top: 10px;
-        }
-
-        .fse_download_link {
-            float: right;
-            text-decoration: none;
-            padding: 3px 15px;
-            border-radius: 2px;
-            font-size: 14px;
-        }
-
-        .fse_latest_version_container {
-            border-radius: 5px;
-            float: left;
-            margin-top: 100px;
-            margin-left: 200px;
-            width: 400px;
-            text-align: center;
-            box-shadow: black 0px 0px 5px 0px;
-        }
-
-        .fse_download_image_latest {
-            width: 64px;
-            margin-top: 20px;
-        }
-
-        .fse_download_title_latest {
-            margin-top: 10px;
-            font-size: 20px;
-            font-weight: 400;
-            text-align: center;
-        }
-
-        .fse_download_button_latest {
-            display: block;
-            padding: 15px 20px;
-            margin: 30px;
-            margin-top: 90px;
-            font-weight: 700;
-            border-radius: 25px;
-            text-decoration: none;
-            box-shadow: black 0px 0px 5px 0px;
-        }
-
-        .fse_title {
-            position: absolute;
-            display: inline-block;
-            float: left;
-            margin-left: 140px;
-            margin-top: 20px;
-            font-size: 25px;
-            font-weight: 400;
-        }
-    </style>
-
-    <title>Tango FSE</title>
-</head>
-<body class="fse_primary_background fse_primary_foreground">
-    <div>
-
-        <div id="fseAbstract" class="fse_side_abstract">
-            <div class="fse_side_abstract_top">
+    @foreach (var item in Model.Downloads)
+    {
+        <div class="fse_history_download">
+            <div class="fse_download_title">
+                <img class="fse_download_image" src="~/Images/fse/download.png" />
+                <span class="fse_download_name">@item.Name</span>
+                <span class="fse_download_date">@item.Date</span>
+            </div>
+            <div class="fse_download_separator fse_border_background">
 
             </div>
-        </div>
+            <div class="fse_download_commets fse_gray_foreground">
+                @item.Comments
+            </div>
 
-        <div class="fse_header_back fse_primary_background_light">
-            <img src="~/Images/fse/machine_full.png" class="fse_machine_logo" />
-            <span class="fse_title">Tango FSE</span>
-            <img src="~/Images/fse/twine_logo_colored.png" class="fse_twine_logo" />
+            <a class="fse_download_link fse_primary_background_light fse_primary_accent" href="@item.Address">
+                Download
+            </a>
         </div>
+    }
+</div>
 
-        <div>
-            <div class="fse_container">
-
-                <div class="fse_history_downloads_container">
-
-                    @foreach (var item in Model.Downloads)
-                    {
-                        <div class="fse_history_download">
-                            <div class="fse_download_title">
-                                <img class="fse_download_image" src="~/Images/fse/download.png" />
-                                <span class="fse_download_name">@item.Name</span>
-                                <span class="fse_download_date">@item.Date</span>
-                            </div>
-                            <div class="fse_download_separator fse_border_background">
+<div class="fse_latest_version_container fse_primary_background_light">
+    <img class="fse_download_image_latest" src="~/Images/fse/download.png" />
+    <div class="fse_download_title_latest">Download Latest Version</div>
+    <div class="fse_download_title_latest fse_primary_accent" style="margin-top:5px;">v@(Model.LatestDownload.Version)</div>
+    <div class="fse_download_commets fse_gray_foreground">@Model.LatestDownload.Comments</div>
+    <a class="fse_download_button_latest fse_primary_accent_background fse_primary_foreground" href="@Model.LatestDownload.Address">DOWNLOAD</a>
+</div>
 
-                            </div>
-                            <div class="fse_download_commets fse_gray_foreground">
-                                @item.Comments
-                            </div>
-
-                            <a class="fse_download_link fse_primary_background_light fse_primary_accent" href="@item.Address">
-                                Download
-                            </a>
-                        </div>
-                    }
-                </div>
-
-                <div class="fse_latest_version_container fse_primary_background_light">
-                    <img class="fse_download_image_latest" src="~/Images/fse/download.png" />
-                    <div class="fse_download_title_latest">Download Latest Version</div>
-                    <div class="fse_download_title_latest fse_primary_accent" style="margin-top:5px;">v@(Model.LatestDownload.Version)</div>
-                    <div class="fse_download_commets fse_gray_foreground">@Model.LatestDownload.Comments</div>
-                    <a class="fse_download_button_latest fse_primary_accent_background fse_primary_foreground" href="@Model.LatestDownload.Address">DOWNLOAD</a>
-                </div>
-            </div>
-        </div>
-    </div>
-</body>
-</html>
diff --git a/Software/Visual_Studio/Web/Tango.MachineService/Views/Shared/_FSELayout.cshtml b/Software/Visual_Studio/Web/Tango.MachineService/Views/Shared/_FSELayout.cshtml
new file mode 100644
index 000000000..15ca9f651
--- /dev/null
+++ b/Software/Visual_Studio/Web/Tango.MachineService/Views/Shared/_FSELayout.cshtml
@@ -0,0 +1,42 @@
+<!DOCTYPE html>
+<html>
+<head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width" />
+    <title>@ViewBag.Title</title>
+    @*@Styles.Render("~/Content/css")*@
+    @*@Scripts.Render("~/bundles/modernizr")*@
+
+    <link rel="stylesheet" href="~/Styles/FSE/FSELayout.css">
+    @RenderSection("styles", required: false)
+</head>
+<body class="fse_primary_background fse_primary_foreground">
+
+    <header class="header"></header>
+
+    <div>
+
+        <div id="fseAbstract" class="fse_side_abstract">
+            <div class="fse_side_abstract_top">
+
+            </div>
+        </div>
+
+        <div class="fse_header_back fse_primary_background_light">
+            <img src="~/Images/fse/machine_full.png" class="fse_machine_logo" />
+            <span class="fse_title">Tango FSE</span>
+            <img src="~/Images/fse/twine_logo_colored.png" class="fse_twine_logo" />
+        </div>
+
+        <div>
+            <div class="fse_container">
+                @RenderBody()
+            </div>
+        </div>
+    </div>
+
+    @Scripts.Render("~/bundles/jquery")
+    @*@Scripts.Render("~/bundles/bootstrap")*@
+    @RenderSection("scripts", required: false)
+</body>
+</html>
-- 
cgit v1.3.1