Merge pull request #116 from docusign/DEVDOCS-9594

DEVDOCS-9594 and DEVDOCS-9566 - Numerical tabs added to eSign examples 15 (via example 8) and 16

Author: InbarGazit

launcher-csharp/eSignature/Controllers/SetEnvelopeTabValue.cs

@@ -6,6 +6,7 @@ namespace DocuSign.CodeExamples.Controllers
 {
     using DocuSign.CodeExamples.Common;
     using DocuSign.CodeExamples.Models;
+    using DocuSign.eSign.Client;
     using Microsoft.AspNetCore.Mvc;
 
     [Area("eSignature")]
@@ -54,20 +55,30 @@ public IActionResult Create(string signerEmail, string signerName)
             var accessToken = this.RequestItemsService.User.AccessToken; // Represents your {ACCESS_TOKEN}
             var accountId = this.RequestItemsService.Session.AccountId; // Represents your {ACCOUNT_ID}
 
-            // Call the Examples API method to create an envelope and set the tab values
-            (string envelopeId, string redirectUrl) = global::ESignature.Examples.SetEnvelopeTabValue.CreateEnvelopeAndUpdateTabData(
-                signerEmail,
-                signerName,
-                this.signerClientId,
-                accessToken,
-                basePath,
-                accountId,
-                this.Config.TabsDocx,
-                this.dsReturnUrl,
-                this.dsPingUrl);
+            try
+            {
+                // Call the Examples API method to create an envelope and set the tab values
+                (string envelopeId, string redirectUrl) = global::ESignature.Examples.SetEnvelopeTabValue.CreateEnvelopeAndUpdateTabData(
+                    signerEmail,
+                    signerName,
+                    this.signerClientId,
+                    accessToken,
+                    basePath,
+                    accountId,
+                    this.Config.TabsDocx,
+                    this.dsReturnUrl,
+                    this.dsPingUrl);
 
-            this.RequestItemsService.EnvelopeId = envelopeId;
-            return this.Redirect(redirectUrl);
+                this.RequestItemsService.EnvelopeId = envelopeId;
+                return this.Redirect(redirectUrl);
+            }
+            catch (ApiException apiException)
+            {
+                this.ViewBag.errorCode = apiException.ErrorCode;
+                this.ViewBag.errorMessage = apiException.Message;
+
+                return this.View("Error");
+            }
         }
     }
 }

launcher-csharp/eSignature/Examples/CreateNewTemplate.cs

@@ -12,7 +12,7 @@ namespace ESignature.Examples
 
     public static class CreateNewTemplate
     {
-        private static string templateName = "Example Signer and CC template";
+        private static string templateName = "Example Signer and CC template v2";
 
         /// <summary>
         /// Generates a new DocuSign Template based on static information in this class
@@ -28,7 +28,7 @@ public static (bool createdNewTemplate, string templateId, string resultsTemplat
             docuSignClient.Configuration.DefaultHeader.Add("Authorization", "Bearer " + accessToken);
             TemplatesApi templatesApi = new TemplatesApi(docuSignClient);
             TemplatesApi.ListTemplatesOptions options = new TemplatesApi.ListTemplatesOptions();
-            options.searchText = "Example Signer and CC template";
+            options.searchText = "Example Signer and CC template v2";
             EnvelopeTemplateResults results = templatesApi.ListTemplates(accountId, options);
 
             string templateId;
@@ -156,23 +156,19 @@ public static EnvelopeTemplate MakeTemplate(string resultsTemplateName, string d
                 new ListItem { Text = "Violet", Value = "Violet" },
             };
 
-            // The SDK can't create a number tab at this time. Bug DCM-2732
-            // Until it is fixed, use a text tab instead.
-            //   , number = docusign.Number.constructFromObject({
-            //         documentId: "1", pageNumber: "1", xPosition: "163", yPosition: "260",
-            //         font: "helvetica", fontSize: "size14", tabLabel: "numbersOnly",
-            //         height: "23", width: "84", required: "false"})
-            Text textInsteadOfNumber = new Text();
-            textInsteadOfNumber.DocumentId = "1";
-            textInsteadOfNumber.PageNumber = "1";
-            textInsteadOfNumber.XPosition = "153";
-            textInsteadOfNumber.YPosition = "260";
-            textInsteadOfNumber.Font = "helvetica";
-            textInsteadOfNumber.FontSize = "size14";
-            textInsteadOfNumber.TabLabel = "numbersOnly";
-            textInsteadOfNumber.Height = "23";
-            textInsteadOfNumber.Width = "84";
-            textInsteadOfNumber.Required = "false";
+            Numerical numerical = new Numerical();
+            numerical.ValidationType = "Currency";
+            numerical.DocumentId = "1";
+            numerical.PageNumber = "1";
+            numerical.XPosition = "153";
+            numerical.YPosition = "260";
+            numerical.Font = "helvetica";
+            numerical.FontSize = "size14";
+            numerical.TabLabel = "numericalCurrency";
+            numerical.Height = "23";
+            numerical.Width = "84";
+            numerical.Required = "false";
+
 
             RadioGroup radioGroup = new RadioGroup();
             radioGroup.DocumentId = "1";
@@ -209,7 +205,8 @@ public static EnvelopeTemplate MakeTemplate(string resultsTemplateName, string d
             // numberTabs: [number],
             signer1Tabs.RadioGroupTabs = new List<RadioGroup> { radioGroup };
             signer1Tabs.SignHereTabs = new List<SignHere> { signHere };
-            signer1Tabs.TextTabs = new List<Text> { text, textInsteadOfNumber };
+            signer1Tabs.TextTabs = new List<Text> { text };
+            signer1Tabs.NumericalTabs = new List<Numerical> { numerical };
 
             signer1.Tabs = signer1Tabs;
 

launcher-csharp/eSignature/Examples/SetEnvelopeTabValue.cs

@@ -83,22 +83,28 @@ public static (string, string) CreateEnvelopeAndUpdateTabData(
             // and as a pure number in a custom field ('salary') in the envelope
             int salary = 123000;
 
-            Text textSalary = new Text
+            Numerical numericalSalary = new Numerical
             {
-                AnchorString = "/salary/",
-                AnchorUnits = "pixels",
-                AnchorYOffset = "-9",
-                AnchorXOffset = "5",
-                Font = "helvetica",
-                FontSize = "size11",
-                Bold = "true",
-                Locked = "true",
-
-                // Convert number to String: 'C2' sets the string
-                // to currency format with two decimal places
-                Value = salary.ToString("C2"),
+                ValidationType = "Currency",
+                XPosition = "210",
+                YPosition = "235",
+                Height = "20",
+                Width = "70",
+                PageNumber = "1",
+                DocumentId = "1",
+                MinNumericalValue = "0",
+                MaxNumericalValue = "1000000",
                 TabId = "salary",
                 TabLabel = "Salary",
+                NumericalValue = salary.ToString(),
+                LocalePolicy = new LocalePolicyTab
+                {
+                    CultureName = "en-US",
+                    CurrencyCode = "usd",
+                    CurrencyPositiveFormat = "csym_1_comma_234_comma_567_period_89",
+                    CurrencyNegativeFormat = "minus_csym_1_comma_234_comma_567_period_89",
+                    UseLongCurrencyFormat = "true",
+                },
             };
 
             TextCustomField salaryCustomField = new TextCustomField
@@ -131,7 +137,8 @@ public static (string, string) CreateEnvelopeAndUpdateTabData(
             Tabs signer1Tabs = new Tabs
             {
                 SignHereTabs = new List<SignHere> { signHere },
-                TextTabs = new List<Text> { textLegal, textFamiliar, textSalary },
+                TextTabs = new List<Text> { textLegal, textFamiliar },
+                NumericalTabs = new List<Numerical> { numericalSalary },
             };
             signer1.Tabs = signer1Tabs;
             Recipients recipients = new Recipients

launcher-csharp/eSignature/Views/SetEnvelopeTabValue/eg016.cshtml

@@ -1,7 +1,7 @@
 @{
     int formNumber = 0;
-    int signerEmailInputNumber = 0;
-    int signerNameInputNumber = 1;
+    int signerEmailInputNumber = 1;
+    int signerNameInputNumber = 0;
 }
 
 <h4>@Html.Raw(ViewBag.CodeExampleText.ExampleName)</h4>

launcher-csharp/launcher-csharp.csproj

@@ -38,7 +38,7 @@
   <ItemGroup>
     <PackageReference Include="DocuSign.Admin" Version="1.1.0" />
     <PackageReference Include="DocuSign.Click" Version="1.2.2" />
-    <PackageReference Include="DocuSign.eSign.dll" Version="6.0.0" />
+    <PackageReference Include="DocuSign.eSign.dll" Version="6.2.0" />
     <PackageReference Include="DocuSign.Monitor" Version="1.1.0" />
     <PackageReference Include="DocuSign.Rooms" Version="1.3.0" />
     <PackageReference Include="Microsoft.AspNetCore.Session" Version="2.2.0" />