890537: Need to add documentation for validate exceptional handling

ej2-asp-core-mvc/code-snippet/gantt/getting-started/exception-handling/definingColumns.cs

@@ -0,0 +1,89 @@
+public IActionResult Index()
+{
+    ViewBag.DataSource = ganttData();
+    return View();
+}
+
+public static List<GanttDataSource> ganttData()
+        {
+            List<GanttDataSource> GanttDataSourceCollection = new List<GanttDataSource>();
+
+            GanttDataSource Record1 = new GanttDataSource()
+            {
+                TaskId = 1,
+                TaskName = "Project initiation",
+                StartDate = new DateTime(2019, 04, 02),
+                EndDate = new DateTime(2019, 04, 21),
+                SubTasks = new List<GanttDataSource>()
+            };
+            GanttDataSource Child1 = new GanttDataSource()
+            {
+                TaskId = 2,
+                TaskName = "Identify site location",
+                StartDate = new DateTime(2019, 04, 02),
+                Duration = 4,
+                Progress = 50
+            };
+            GanttDataSource Child2 = new GanttDataSource()
+            {
+                TaskId = 3,
+                TaskName = "Perform soil test",
+                StartDate = new DateTime(2019, 04, 02),
+                Duration = 4,
+                Progress = 50
+            };
+            GanttDataSource Child3 = new GanttDataSource()
+            {
+                TaskId = 4,
+                TaskName = "Soil test approval",
+                StartDate = new DateTime(2019, 04, 02),
+                Duration = 4,
+                Progress = 50
+            };
+            Record1.SubTasks.Add(Child1);
+            Record1.SubTasks.Add(Child2);
+            Record1.SubTasks.Add(Child3);
+
+            GanttDataSource Record2 = new GanttDataSource()
+            {
+                TaskId = 5,
+                TaskName = "Project estimation",
+                StartDate = new DateTime(2019, 04, 02),
+                EndDate = new DateTime(2019, 04, 21),
+                SubTasks = new List<GanttDataSource>()
+            };
+            GanttDataSource Child4 = new GanttDataSource()
+            {
+                TaskId = 6,
+                TaskName = "Develop floor plan for estimation",
+                StartDate = new DateTime(2019, 04, 04),
+                Duration = 3,
+                Progress = 50
+            };
+            GanttDataSource Child5 = new GanttDataSource()
+            {
+                TaskId = 7,
+                TaskName = "List materials",
+                StartDate = new DateTime(2019, 04, 04),
+                Duration = 3,
+                Progress = 50
+            };
+            Record2.SubTasks.Add(Child4);
+            Record2.SubTasks.Add(Child5);
+
+            GanttDataSourceCollection.Add(Record1);
+            GanttDataSourceCollection.Add(Record2);
+
+            return GanttDataSourceCollection;
+        }
+
+        public class GanttDataSource
+        {
+            public int TaskId { get; set; }
+            public string TaskName { get; set; }
+            public DateTime StartDate { get; set; }
+            public DateTime EndDate { get; set; }
+            public int? Duration { get; set; }
+            public int Progress { get; set; }
+            public List<GanttDataSource> SubTasks { get; set; }
+	    }

ej2-asp-core-mvc/code-snippet/gantt/getting-started/exception-handling/razor

@@ -0,0 +1,18 @@
+@Html.EJS().Gantt("Gantt").DataSource((IEnumerable<object>)ViewBag.DataSource).Height("450px").TaskFields(ts =>
+    ts.Id("TaskId").Name("TaskName").StartDate("StartDate").ActionFailure("actionFailure").EndDate("EndDate").Duration("Duration").Progress("Progress").Child("SubTasks")
+    ).Columns(col =>
+        {
+            col.Field("TaskName").HeaderText("Job Name").Width(250).Add();
+            col.Field("StartDate").HeaderText("Start Date").Width(250).Add();
+            col.Field("EndDate").HeaderText("End Date").Width(250).Add();
+            col.Field("Duration").HeaderText("Duration").Width(250).Add();
+        }).Render()
+   < script >
+        function actionFailure(args) {
+            var gantt = document.getElementById("Gantt").ej2_instances[0];
+            var span = document.createElement('span');
+            gantt.element.parentNode.insertBefore(span, gantt.element);
+            span.style.color = '#FF0000'
+            span.innerHTML = args.error[0];
+        }
+    </ script >

ej2-asp-core-mvc/code-snippet/gantt/getting-started/exception-handling/tagHelper

@@ -0,0 +1,21 @@
+<ejs-gantt id='Gantt' dataSource="ViewBag.dataSource" height="450px">
+    <e-gantt-taskfields id="TaskId" name="TaskName" startDate="StartDate"
+            endDate="EndDate" duration="Duration" progress="Progress" child="SubTasks"
+            actionFailure="actionFailure">
+    </e-gantt-taskfields>
+    <e-gantt-columns>
+        <e-gantt-column field="TaskName" headerText="Job Name" width="250"></e-gantt-column>
+        <e-gantt-column field="StartDate" headerText="StartDate"></e-gantt-column>
+        <e-gantt-column field="EndDate" headerText="EndDate"></e-gantt-column>
+        <e-gantt-column field="Duration" headerText="Duration"></e-gantt-column>
+    </e-gantt-columns>
+</ejs-gantt>
+
+<script>
+    function actionFailure(e) {
+       var span = document.createElement('span');
+       this.element.parentNode.insertBefore(span, this.element);
+       span.style.color = '#FF0000'
+       span.innerHTML = e.error[0];
+    }
+</script>

ej2-asp-core-mvc/gantt/EJ2_ASP.MVC/getting-started.md

@@ -608,4 +608,34 @@ public class GanttDataSource
 
 ![ASP.NET MVC Gantt with Resources](images/gantt-assign-resource.png)
 
+## Error handling
+
+Error handling is used to identify errors, display them and develop recovery strategies to handle errors from gantt. In Gantt, error handling is done by using the [actionFailure](https://help.syncfusion.com/cr/aspnetmvc-js2/Syncfusion.EJ2.Gantt.Gantt.html#Syncfusion_EJ2_Gantt_Gantt_ActionFailure) event. Some of the scenarios that this event handles are:
+* Invalid duration : The [duration](https://help.syncfusion.com/cr/aspnetmvc-js2/Syncfusion.EJ2.Gantt.GanttTaskFields.html#Syncfusion_EJ2_Gantt_GanttTaskFields_Duration) field accepts only numerical values with an optional decimal point. Entering non-numerical values triggers the `actionFailure` event and displays issue information in the event argument.
+* Invalid dependency: The [dependency](https://help.syncfusion.com/cr/aspnetmvc-js2/Syncfusion.EJ2.Gantt.GanttTaskFields.html#Syncfusion_EJ2_Gantt_GanttTaskFields_Dependency) field accepts only a number followed by a predecessor type (FS, FF, SS, SF).  Entering invalid values, such as special characters or incorrect predecessor types, triggers the `actionFailure` event and displays issue information in the event argument.
+* Invalid offset : The `offset` accepts only numerical values or their word equivalents followed by a unit. Entering invalid values, such as special characters triggers `actionFailure` event and displays issue information in the event argument.
+* Failure to map task fields : The data source fields necessary for rendering tasks should be mapped to the Gantt control using the [taskFields](https://help.syncfusion.com/cr/aspnetmvc-js2/Syncfusion.EJ2.Gantt.GanttTaskFields.html) property. Failure to map `taskFields` in the sample triggers `actionFailure` event and displays issue information in the event argument.
+* Failure to map resource fields : To assign resources to a task, resource fields should be mapped to the Gantt control using the [resourceFields](https://help.syncfusion.com/cr/aspnetmvc-js2/Syncfusion.EJ2.Gantt.GanttResourceFields.html). Failure to map `resourceFields` in the sample triggers `actionFailure` event and displays issue information in the event argument.
+* Failure to map `isPrimaryKey` : `isPrimaryKey` field is crucial for CRUD operations. Failure to map [id](https://help.syncfusion.com/cr/aspnetmvc-js2/Syncfusion.EJ2.Gantt.GanttTaskFields.html#Syncfusion_EJ2_Gantt_GanttTaskFields_Id) column in gantt column collection or `isPrimaryKey` field in one of the columns will trigger `actionFailure` event and display issue information in the event argument.
+* Invalid date format : [format](https://help.syncfusion.com/cr/aspnetmvc-js2/Syncfusion.EJ2.Gantt.GanttTimelineTierSettings.html#Syncfusion_EJ2_Gantt_GanttTimelineTierSettings_Format) property under `topTier` and `bottomTier` determines how the timelines are displayed in the top tier and bottom tier of the Gantt chart timeline. If the `format` does not contain a valid standard [date format](https://help.syncfusion.com/cr/aspnetmvc-js2/Syncfusion.EJ2.Gantt.GanttTimelineTierSettings.html#Syncfusion_EJ2_Gantt_GanttTimelineTierSettings_Format), it triggers the `actionFailure` event, displaying issue information in the event argument.
+* Failure to map `hasChildMapping` : [hasChildMapping](https://help.syncfusion.com/cr/aspnetmvc-js2/Syncfusion.EJ2.Gantt.GanttTaskFields.html#Syncfusion_EJ2_Gantt_GanttTaskFields_HasChildMapping) property should configured for [load-on-demand](https://help.syncfusion.com/cr/aspnetmvc-js2/Syncfusion.EJ2.Gantt.Gantt.html#Syncfusion_EJ2_Gantt_Gantt_LoadChildOnDemand). Ensure it properly configured in the [taskFields](https://help.syncfusion.com/cr/aspnetmvc-js2/Syncfusion.EJ2.Gantt.GanttTaskFields.html). Failure to map `hasChildMapping` in the `load-on-demand` sample triggers `actionFailure` event and displays issue information in the event argument.
+* Invalid day in event markers : `day` should configured in [eventMarkers](https://help.syncfusion.com/cr/aspnetcore-js2/Syncfusion.EJ2.Gantt.Gantt.html#Syncfusion_EJ2_Gantt_Gantt_EventMarkers) to render striplines in a particular day. Failure to configure the `day` in `eventMarkers` triggers `actionFailure` event and displays issue information in the event argument.
+
+> Additionally, TreeGrid side error handling information is also displayed from the Gantt `actionFailure` event. For more details on TreeGrid side error handling, refer [here](https://ej2.syncfusion.com/aspnetmvc/documentation/tree-grid/getting-started-core#enable-filtering).
+
+The following code example shows how to use the [actionFailure](https://help.syncfusion.com/cr/aspnetmvc-js2/Syncfusion.EJ2.Gantt.Gantt.html#Syncfusion_EJ2_Gantt_Gantt_ActionFailure) event in the Gantt control to display an exception when `isPrimaryKey` is not configured properly in the Gantt Chart column.
+
+{% tabs %}
+{% highlight razor tabtitle="CSHTML" %}
+{% include code-snippet/gantt/getting-started/exception-handling/razor %}
+{% endhighlight %}
+{% highlight c# tabtitle="DefiningColumns.cs" %}
+{% include code-snippet/gantt/getting-started/exception-handling/definingColumns.cs %}
+{% endhighlight %}
+{% endtabs %}
+
+The following screenshot represents the Gantt Exception handling in `actionFailure` event.
+
+![Error Handling](images/error-handling.png)
+
 N> [View Sample in GitHub](https://github.com/SyncfusionExamples/ASP-NET-MVC-Getting-Started-Examples/tree/main/Gantt/ASP.NET%20MVC%20Razor%20Examples).

ej2-asp-core-mvc/gantt/EJ2_ASP.NETCORE/getting-started.md

@@ -320,6 +320,36 @@ public class GanttResources
 
 ![ASP.NET Core Gantt with Resources](./images/gantt-resources.png)
 
+## Error handling
+
+Error handling is used to identify errors, display them and develop recovery strategies to handle errors from gantt. In Gantt, error handling is done by using the [actionFailure](https://help.syncfusion.com/cr/aspnetcore-js2/Syncfusion.EJ2.Gantt.Gantt.html#Syncfusion_EJ2_Gantt_Gantt_ActionFailure) event. Some of the scenarios that this event handles are:
+* Invalid duration : The [duration](https://help.syncfusion.com/cr/aspnetcore-js2/Syncfusion.EJ2.Gantt.GanttTaskFields.html#Syncfusion_EJ2_Gantt_GanttTaskFields_Duration) field accepts only numerical values with an optional decimal point. Entering non-numerical values triggers the `actionFailure` event and displays issue information in the event argument.
+* Invalid dependency: The [dependency](https://help.syncfusion.com/cr/aspnetcore-js2/Syncfusion.EJ2.Gantt.GanttTaskFields.html#Syncfusion_EJ2_Gantt_GanttTaskFields_Dependency) field accepts only a number followed by a predecessor type (FS, FF, SS, SF).  Entering invalid values, such as special characters or incorrect predecessor types, triggers the `actionFailure` event and displays issue information in the event argument.
+* Invalid offset : The `offset` accepts only numerical values or their word equivalents followed by a unit. Entering invalid values, such as special characters triggers `actionFailure` event and displays issue information in the event argument.
+* Failure to map task fields : The data source fields necessary for rendering tasks should be mapped to the Gantt control using the [taskFields](https://help.syncfusion.com/cr/aspnetcore-js2/Syncfusion.EJ2.Gantt.GanttTaskFields.html) property. Failure to map `taskFields` in the sample triggers `actionFailure` event and displays issue information in the event argument.
+* Failure to map resource fields : To assign resources to a task, resource fields should be mapped to the Gantt control using the [resourceFields](https://help.syncfusion.com/cr/aspnetcore-js2/Syncfusion.EJ2.Gantt.GanttResourceFields.html). Failure to map `resourceFields` in the sample triggers `actionFailure` event and displays issue information in the event argument.
+* Failure to map `isPrimaryKey` : `isPrimaryKey` field is crucial for CRUD operations. Failure to map [id](https://help.syncfusion.com/cr/aspnetcore-js2/Syncfusion.EJ2.Gantt.GanttTaskFields.html#Syncfusion_EJ2_Gantt_GanttTaskFields_Id) column in gantt column collection or `isPrimaryKey` field in one of the columns will trigger `actionFailure` event and display issue information in the event argument.
+* Invalid date format : [format](https://help.syncfusion.com/cr/aspnetcore-js2/Syncfusion.EJ2.Gantt.GanttTimelineTierSettings.html#Syncfusion_EJ2_Gantt_GanttTimelineTierSettings_Format) property under `topTier` and `bottomTier` determines how the timelines are displayed in the top tier and bottom tier of the Gantt chart timeline. If the `format` does not contain a valid standard [date format](https://help.syncfusion.com/cr/aspnetcore-js2/Syncfusion.EJ2.Gantt.GanttTimelineTierSettings.html#Syncfusion_EJ2_Gantt_GanttTimelineTierSettings_Format), it triggers the `actionFailure` event, displaying issue information in the event argument.
+* Failure to map `hasChildMapping` : [hasChildMapping](https://help.syncfusion.com/cr/aspnetcore-js2/Syncfusion.EJ2.Gantt.GanttTaskFields.html#Syncfusion_EJ2_Gantt_GanttTaskFields_HasChildMapping) property should configured for [load-on-demand](https://help.syncfusion.com/cr/aspnetcore-js2/Syncfusion.EJ2.Gantt.Gantt.html#Syncfusion_EJ2_Gantt_Gantt_LoadChildOnDemand). Ensure it properly configured in the [taskFields](https://help.syncfusion.com/cr/aspnetcore-js2/Syncfusion.EJ2.Gantt.GanttTaskFields.html). Failure to map `hasChildMapping` in the `load-on-demand` sample triggers `actionFailure` event and displays issue information in the event argument.
+* Invalid day in event markers : `day` should configured in [eventMarkers](https://help.syncfusion.com/cr/aspnetcore-js2/Syncfusion.EJ2.Gantt.Gantt.html#Syncfusion_EJ2_Gantt_Gantt_EventMarkers) to render striplines in a particular day. Failure to configure the `day` in `eventMarkers` triggers `actionFailure` event and displays issue information in the event argument.
+
+> Additionally, TreeGrid side error handling information is also displayed from the Gantt `actionFailure` event. For more details on TreeGrid side error handling, refer [here](https://ej2.syncfusion.com/aspnetcore/documentation/tree-grid/getting-started-core#enable-filtering).
+
+The following code example shows how to use the [actionFailure](https://help.syncfusion.com/cr/aspnetcore-js2/Syncfusion.EJ2.Gantt.Gantt.html#Syncfusion_EJ2_Gantt_Gantt_ActionFailure) event in the Gantt control to display an exception when `isPrimaryKey` is not configured properly in the Gantt Chart column.
+
+{% tabs %}
+{% highlight cshtml tabtitle="CSHTML" %}
+{% include code-snippet/gantt/getting-started/exception-handling/tagHelper %}
+{% endhighlight %}
+{% highlight c# tabtitle="DefiningColumns.cs" %}
+{% include code-snippet/gantt/getting-started/exception-handling/definingColumns.cs %}
+{% endhighlight %}
+{% endtabs %}
+
+The following screenshot represents the Gantt Exception handling in `actionFailure` event.
+
+![Error Handling](images/error-handling.png)
+
 N> [View Sample in GitHub](https://github.com/SyncfusionExamples/ASP-NET-Core-Getting-Started-Examples/tree/main/Gantt/ASP.NET%20Core%20Tag%20Helper%20Examples).
 
 ## See also