995022: Need to include the UG section for import and export files from the Azure Blob storage

Document-Processing-toc.html

@@ -4770,6 +4770,12 @@
 							<li><a href="/document-processing/excel/spreadsheet/react/nextjs-getting-started">Getting Started with NextJS</a></li>
 							<li><a href="/document-processing/excel/spreadsheet/react/data-binding">Data Binding</a></li>
 							<li><a href="/document-processing/excel/spreadsheet/react/open-save">Open and Save</a></li>
+							<li>Working with Files in Cloud Storage
+								<ul>
+									<li><a href="/document-processing/excel/spreadsheet/react/cloud-storage-integration/azure-blob-storage.md">Microsoft Azure Blob Storage</a>
+									</li>
+								</ul>
+							</li>
 							<li><a href="/document-processing/excel/spreadsheet/react/docker-deployment">Docker Deployment</a></li>
 							<li><a href="/document-processing/excel/spreadsheet/react/worksheet">Worksheet</a></li>
 							<li><a href="/document-processing/excel/spreadsheet/react/cell-range">Cell Range</a></li>

Document-Processing/Excel/Spreadsheet/React/cloud-storage-integration/azure-blob-storage.md

@@ -0,0 +1,274 @@
+---
+layout: post
+title: Opening or Saving document from Azure Blob Storage in React Spreadsheet control | Syncfusion
+description: Learn about how to Open or Save an Excel file from Azure Blob Storage in React Spreadsheet control of Syncfusion Essential JS 2.
+platform: React
+control: Open or Save file from Azure Blob Storage
+documentation: ug
+domainurl: ##DomainURL##
+---
+
+# Open file from Azure Blob Storage
+
+To load a file from Azure Blob Storage in a Spreadsheet Component, you can follow the steps below
+
+**Step 1:** Create a Simple Spreadsheet Sample in React
+
+Start by following the steps provided in this [link](../../React//getting-started.md) to create a simple Spreadsheet sample in React. This will give you a basic setup of the Spreadsheet component.
+
+**Step 2:** Modify the `SpreadsheetController.cs` File in the Web Service Project
+
+1. Create a web service project in .NET Core 3.0 or above. You can refer to this [link](../../../Spreadsheet/React/open-save.md) for instructions on how to create a web service project.
+
+2. Open the `SpreadsheetController.cs` file in your web service project.
+
+3. Import the required namespaces at the top of the file:
+
+```csharp
+
+using System;
+using System.IO;
+using System.Threading.Tasks;
+using Microsoft.AspNetCore.Http;
+using Microsoft.AspNetCore.Mvc;
+using Microsoft.Extensions.Configuration;
+using Syncfusion.EJ2.Spreadsheet;
+using Azure.Storage.Blobs;
+using Azure.Storage.Blobs.Specialized;
+
+```
+
+4. Add the following private fields and constructor parameters to the `SpreadsheetController` class, In the constructor, assign the values from the configuration to the corresponding fields.
+
+```Csharp
+
+private readonly string _storageConnectionString;
+private readonly string _storageContainerName;
+
+public SpreadsheetController(IConfiguration configuration)
+{
+    // Fetch values from appsettings.json
+    _storageConnectionString = configuration.GetValue<string>("connectionString");
+    _storageContainerName = configuration.GetValue<string>("containerName");
+}
+
+```
+
+5. Create the `OpenFromAzure()` method to open the document from the Azure Blob Storage.
+
+```Csharp
+
+[HttpPost]
+[Route("OpenFromAzure")]
+public async Task<IActionResult> OpenFromAzure([FromBody] FileOptions options)
+{
+    if (options == null || string.IsNullOrWhiteSpace(options.FileName) || string.IsNullOrWhiteSpace(options.Extension))
+        return BadRequest("Invalid file options.");
+
+    try
+    {
+        using (MemoryStream stream = new MemoryStream())
+        {
+            string fileName = options.FileName + options.Extension;
+
+            // Connect to Azure Blob Storage
+            BlobServiceClient blobServiceClient = new BlobServiceClient(_storageConnectionString);
+            BlobContainerClient containerClient = blobServiceClient.GetBlobContainerClient(_storageContainerName);
+            BlockBlobClient blockBlobClient = containerClient.GetBlockBlobClient(fileName);
+
+            // Download file into memory
+            await blockBlobClient.DownloadToAsync(stream);
+            stream.Position = 0;
+
+            // Wrap stream as FormFile and convert to Spreadsheet-compatible JSON
+            OpenRequest open = new OpenRequest
+            {
+                File = new FormFile(stream, 0, stream.Length, options.FileName, fileName)
+            };
+
+            string result = Workbook.Open(open);
+            return Content(result, "application/json");
+        }
+    }
+    catch (Exception ex)
+    {
+        Console.WriteLine($"Error: {ex.Message}");
+        return Content("Error occurred while processing the file.");
+    }
+}
+
+// DTO that receives file details from the client
+public class FileOptions
+{
+    public string FileName { get; set; } = string.Empty;
+    public string Extension { get; set; } = string.Empty;
+}
+
+```
+
+6. Open the `appsettings.json` file in your web service project, Add the following lines below the existing `"AllowedHosts"` configuration.
+
+```Json
+
+{
+  "Logging": {
+    "LogLevel": {
+      "Default": "Information",
+      "Microsoft.AspNetCore": "Warning"
+    }
+  },
+  "AllowedHosts": "*",
+  "connectionString": "DefaultEndpointsProtocol=https;AccountName=yourAccount;AccountKey=yourKey;EndpointSuffix=core.windows.net",
+  "containerName": "your-container-name"
+}
+
+```
+N> Note: Install the Azure.Storage.Blobs NuGet package in the service project.
+
+**Step 3:** Modify the index File in the Spreadsheet sample to make a fetch call to the server to retrieve and load the Excel file from the Google Cloud Storage into the client-side spreadsheet.
+
+```typescript
+
+<button class="e-btn" onClick={openFromAzure}>
+  Import XLS file from Azure Blob Storage
+</button>;
+
+const openFromAzure = () => {
+  spreadsheet.showSpinner();
+
+  fetch("https://localhost:portNumber/api/spreadsheet/OpenFromAzure", {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({
+      FileName: fileInfo.name,      // e.g., "Report"
+      Extension: fileInfo.extension // e.g., ".xlsx"
+    })
+  })
+    .then((res) => res.json())
+    .then((data) => {
+      spreadsheet.hideSpinner();
+      spreadsheet.openFromJson({ file: data, triggerEvent: true });
+    })
+    .catch((err) => window.alert("Error importing file: " + err));
+};
+
+```
+
+# Save file to Google Cloud Storage
+
+To save a file to Azure Blob Storage in a Spreadsheet Component, you can follow the steps below
+
+**Step 1:** Create a Simple Spreadsheet Sample in React
+
+Start by following the steps provided in this [link](../../React//getting-started.md) to create a simple Spreadsheet sample in React. This will give you a basic setup of the Spreadsheet component.
+
+**Step 2:** Modify the `SpreadsheetController.cs` File in the Web Service Project
+
+1. Create a web service project in .NET Core 3.0 or above. You can refer to this [link](../../../Spreadsheet/React/open-save.md) for instructions on how to create a web service project.
+
+2. Open the `SpreadsheetController.cs` file in your web service project.
+
+3. Import the required namespaces at the top of the file:
+
+```Csharp
+
+using System;
+using System.IO;
+using System.Threading.Tasks;
+using Microsoft.AspNetCore.Mvc;
+using Microsoft.Extensions.Configuration;
+using Syncfusion.EJ2.Spreadsheet;
+using Azure.Storage.Blobs;
+
+```
+
+4. Add the following private fields and constructor parameters to the `SpreadsheetController` class, In the constructor, assign the values from the configuration to the corresponding fields.
+
+```Csharp
+
+private readonly string _storageConnectionString;
+private readonly string _storageContainerName;
+
+public SpreadsheetController(IConfiguration configuration)
+{
+    _storageConnectionString = configuration.GetValue<string>("connectionString");
+    _storageContainerName = configuration.GetValue<string>("containerName");
+}
+
+```
+
+5. Create the `SaveToAzure()` method to save the document to the Azure Blob storage.
+
+```Csharp
+
+[HttpPost]
+[Route("SaveToAzure")]
+public async Task<IActionResult> SaveToAzure([FromForm] SaveSettings saveSettings)
+{
+    if (saveSettings == null || string.IsNullOrWhiteSpace(saveSettings.FileName))
+        return BadRequest("Invalid save settings.");
+
+    try
+    {
+        // Convert spreadsheet JSON to Excel/PDF/CSV stream
+        Stream fileStream = Workbook.Save(saveSettings);
+        fileStream.Position = 0;
+
+        // Define Azure Blob Storage client
+        BlobServiceClient blobServiceClient = new BlobServiceClient(_storageConnectionString);
+        BlobContainerClient containerClient = blobServiceClient.GetBlobContainerClient(_storageContainerName);
+
+        // Define blob name using file name and save type
+        string blobName = $"{saveSettings.FileName}.{saveSettings.SaveType.ToString().ToLower()}";
+        BlobClient blobClient = containerClient.GetBlobClient(blobName);
+
+        // Upload the Excel file stream to Azure Blob Storage (overwrite if exists)
+        await blobClient.UploadAsync(fileStream, overwrite: true);
+
+        return Ok("Excel file successfully saved to Azure Blob Storage.");
+    }
+    catch (Exception ex)
+    {
+        return BadRequest("Error saving file to Azure Blob Storage: " + ex.Message);
+    }
+}
+
+```
+
+N> Note: Install the Azure.Storage.Blobs NuGet package in the service project. Ensure the configured connection string has permissions to read and write blobs in the specified container.
+
+**Step 3:**  Modify the index File in the Spreadsheet sample to using [`saveAsJson`](https://ej2.syncfusion.com/react/documentation/api/spreadsheet/#saveasjson) method to serialize the spreadsheet and send it to the backend
+
+
+```typescript
+
+<button class="e-btn" onClick={saveToAzure}>
+  Save to Azure Blob Storage
+</button>;
+
+const saveToAzure = () => {
+  spreadsheet.saveAsJson().then((json) => {
+    const formData = new FormData();
+    formData.append("FileName", loadedFileInfo.fileName); // e.g., "Report"
+    formData.append("saveType", loadedFileInfo.saveType); // e.g., "Xlsx"
+    formData.append("JSONData", JSON.stringify(json.jsonObject.Workbook));
+    formData.append(
+      "PdfLayoutSettings",
+      JSON.stringify({ FitSheetOnOnePage: false })
+    );
+
+    fetch("https://localhost:portNumber/api/spreadsheet/SaveToAzure", {
+      method: "POST",
+      body: formData
+    })
+      .then((res) => {
+        if (!res.ok) {
+          throw new Error(`Save failed with status ${res.status}`);
+        }
+        window.alert("Workbook saved successfully to Azure Blob Storage.");
+      })
+      .catch((err) => window.alert("Error saving to server: " + err));
+  });
+};
+
+```