Skip to content

Commit 9ebe823

Browse files
committed
1011162: Addressed review comments.
1 parent 5bd0bd1 commit 9ebe823

2 files changed

Lines changed: 20 additions & 15 deletions

File tree

Document-Processing/Excel/Spreadsheet/React/open-excel-files.md

Lines changed: 16 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -9,13 +9,13 @@ documentation: ug
99

1010
# Open Excel Files in Syncfusion React Spreadsheet
1111

12-
The React Spreadsheet component follows an open, server‑assisted workflow to import Excel files accurately and efficiently. When a user uploads an Excel file, the component sends it to the server instead of handling the parsing in the browser. This ensures smooth performance even for large or heavily formatted workbooks.
12+
The React Spreadsheet component uses a server‑assisted workflow to import Excel files accurately and efficiently. When a user uploads an Excel file, the component sends the file to the server for parsing, ensuring smooth performance because the heavy processing workload is handled on the server side.
1313

14-
On the server, the [`Syncfusion.EJ2.Spreadsheet library`](https://www.nuget.org/packages/Syncfusion.EJ2.Spreadsheet.AspNet.Core), built on top of [`Syncfusion XlsIO`](https://help.syncfusion.com/document-processing/excel/excel-library/net/overview), reads the Excel file and extracts all relevant detailsdata, styles, formulas, formatting, and sheet structure. The server then converts this information into a Spreadsheet‑compatible JSON workbook.
14+
On the server, the [`Syncfusion.EJ2.Spreadsheet library`](https://www.nuget.org/packages/Syncfusion.EJ2.Spreadsheet.AspNet.Core) built on top of [`Syncfusion XlsIO`](https://help.syncfusion.com/document-processing/excel/excel-library/net/overview), reads the Excel file and extracts all relevant details, including data, styles, formulas, formatting, and sheet structure. The server then converts this information into a Spreadsheet‑compatible JSON workbook.
1515

16-
Once the processing is complete, the JSON data is returned to the client, where the React Spreadsheet component renders the workbook in the browser. This process preserves the original Excel layout and ensures the imported content appears with full fidelity.
16+
Once processing is complete, the JSON workbook is returned to the client, where the React Spreadsheet component renders it in the browser. This workflow preserves the original Excel layout and ensures the imported content appears with full fidelity.
1717

18-
To enable opening Excel files, set the [`allowOpen`](https://ej2.syncfusion.com/react/documentation/api/spreadsheet/index-default#allowopen) property to **true** and specify the service url using th [`openUrl`](https://ej2.syncfusion.com/react/documentation/api/spreadsheet/index-default#openurl) property. The control will send the uploaded file to this endpoint, where it is processed and returned as JSON for the Spreadsheet to render.
18+
To enable opening Excel files, set the [`allowOpen`](https://ej2.syncfusion.com/react/documentation/api/spreadsheet/index-default#allowopen) property to **true** and specify the service url using the [`openUrl`](https://ej2.syncfusion.com/react/documentation/api/spreadsheet/index-default#openurl) property. The control will send the uploaded file to this endpoint, where it is processed and returned as JSON for the Spreadsheet to render.
1919

2020
For a quick walkthrough on how the open functionality works, refer to the following video:
2121
{% youtube "https://www.youtube.com/watch?v=MpwiXmL1Z_o" %}
@@ -39,11 +39,16 @@ The following sample shows the `Open` option by using the [`openUrl`](https://ej
3939

4040
Please find the below table for the [beforeOpen](https://ej2.syncfusion.com/react/documentation/api/spreadsheet/index-default#beforeopen) event arguments.
4141

42-
| **Parameter** | **Type** | **Description** |
43-
| ----- | ----- | ----- |
44-
| file | FileList or string or File | To get the file stream. `FileList` - contains length and item index. <br/> `File` - specifies the file lastModified and file name. |
45-
| cancel | boolean | To prevent the open operation. |
46-
| requestData | object | To provide the Form data. |
42+
## BeforeOpenEventArgs – Properties
43+
44+
| **Property** | **Type** | **Description** |
45+
|-------------------|-------------------------------|-------------|
46+
| **cancel** | `boolean` | Specifies whether the open action should be canceled. |
47+
| **file** | `FileList` \| `string` \| `File` | Specifies the file to be opened. |
48+
| **parseOptions** | [`WorkbookParseOptions`](https://ej2.syncfusion.com/react/documentation/api/spreadsheet/workbookparseoptions) | Specifies the parsing options that control how the Excel file is interpreted during loading. |
49+
| **password** | `string` | Specifies the password required to open the Excel file, if it is protected. |
50+
| **requestData** | object | Specifies any additional data sent along with the open request. |
51+
| **requestType** | `string` | Specifies the type of open request that triggered the **beforeOpen** event. Possible values:<br><br>• **initial** – The default request made when loading a workbook.<br>• **chunk** – A follow‑up request to load a portion of the workbook when chunking is enabled and the server provides a chunk plan.<br>• **thresholdLimitConfirmed** – A request made after the user confirms a threshold warning (such as *maximumDataLimit* or *maximumFileSizeLimit*) and chooses to proceed. |
4752

4853
> * Use `Ctrl + O` keyboard shortcut to open Excel documents.
4954
> * The default value of the [allowOpen](https://ej2.syncfusion.com/react/documentation/api/spreadsheet/index-default#allowopen) property is `true`. For demonstration purpose, we have showcased the [allowOpen](https://ej2.syncfusion.com/react/documentation/api/spreadsheet/index-default#allowopen) property in previous code snippet.
@@ -108,9 +113,9 @@ The following Excel file formats are supported for opening in the Spreadsheet co
108113
109114
### Open Excel files from local system
110115
111-
If you explore your machine to select and upload an Excel document using the file uploader, you will receive the uploaded document as a raw file in the [success](https://ej2.syncfusion.com/react/documentation/api/uploader/index-default#success) event of the file uploader. In this `success` event, you should pass the received raw file as an argument to the Spreadsheet's [open](https://ej2.syncfusion.com/react/documentation/api/spreadsheet/index-default#open) method to see the appropriate output.
116+
If you explore your machine to select and upload an Excel document using the file upload component, you will receive the uploaded document as a raw file in the [success](https://ej2.syncfusion.com/react/documentation/api/uploader/index-default#success) event of the file upload component. In this `success` event, you should pass the received raw file as an argument to the Spreadsheet's [open](https://ej2.syncfusion.com/react/documentation/api/spreadsheet/index-default#open) method to see the appropriate output.
112117
113-
The following code example shows how to import an Excel document using file uploader in spreadsheet.
118+
The following code example shows how to import an Excel document using file upload component in spreadsheet.
114119
115120
{% tabs %}
116121
{% highlight js tabtitle="app.jsx" %}

Document-Processing/Excel/Spreadsheet/React/save-excel-files.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -9,11 +9,11 @@ documentation: ug
99

1010
# Save Excel Files in Syncfusion React Spreadsheet
1111

12-
When exporting an Excel file from the React Spreadsheet component, the workflow is handled through a clear server‑side process. First, the Spreadsheet content displayed in the browser is serialized into a structured JSON workbook. This JSON contains all the necessary details—such as data, formatting, formulas, styles, and sheet structure.
12+
When exporting an Excel file from the React Spreadsheet component, the process is handled through a streamlined server‑side workflow. The Spreadsheet content displayed in the browser is first serialized into a structured JSON workbook. This JSON includes all essential details—such as data, formulas, formatting, styles, and sheet configuration.
1313

14-
This JSON workbook is then sent to the server, where the [`Syncfusion.EJ2.Spreadsheet library`](https://www.nuget.org/packages/Syncfusion.EJ2.Spreadsheet.AspNet.Core) uses [`Syncfusion XlsIO`](https://help.syncfusion.com/document-processing/excel/excel-library/net/overview) to convert the JSON data into a fully formatted Excel file. XlsIO rebuilds the workbook with complete fidelity, preserving all the features applied in the Spreadsheet.
14+
Once generated, this JSON workbook is sent to the server, where the [`Syncfusion.EJ2.Spreadsheet library`](https://www.nuget.org/packages/Syncfusion.EJ2.Spreadsheet.AspNet.Core) uses [`Syncfusion XlsIO`](https://help.syncfusion.com/document-processing/excel/excel-library/net/overview) to convert the JSON data into a fully formatted Excel file. During this process, the JSON workbook is parsed and its contents are mapped to an XlsIO Workbook instance, ensuring that all data, styles, formulas, and other Spreadsheet features are accurately preserved.
1515

16-
Since, the server is responsible for generating the final Excel file, the total export time can vary depending on the workbook’s complexity, including the number of sheets, amount of formatting, and usage of advanced features like formulas or conditional formatting. Once the generation is complete, the Excel file is returned to the client for download.
16+
Since the server is responsible for generating the final Excel file, the total export time can vary depending on the workbook’s complexity. Factors such as the level of formatting, styles and the use of advanced features like formulas or conditional formatting can influence processing time. After the file is successfully generated, it is sent back to the client for download.
1717

1818
To enable saving Excel files, set the [`allowSave`](https://ej2.syncfusion.com/react/documentation/api/spreadsheet/index-default#allowsave) property to **true** and specify the service URL using the [`saveUrl`](https://ej2.syncfusion.com/react/documentation/api/spreadsheet/index-default#saveurl) property. When a save action is triggered, the control sends the spreadsheet model to this endpoint, where it is processed and returned as a downloadable Excel file.
1919

@@ -62,7 +62,7 @@ Please find the below table for the [`save`](https://ej2.syncfusion.com/document
6262

6363
| **Parameter** | **Type** | **Description** |
6464
|-----------------------|------------------------|------------------------------------------------------------------|
65-
| options | `Object` | Options for opening the JSON object. |
65+
| options | [`SaveOptions`](https://ej2.syncfusion.com/react/documentation/api/spreadsheet/saveoptions) | Options for opening the JSON object. |
6666
| jsonConfig *(optional)* | [`SerializationOptions`](https://ej2.syncfusion.com/react/documentation/api/spreadsheet/serializationOptions) | Specify the serialization options to customize the loading of the JSON data. |
6767

6868
The following code example demonstrates how to save an Excel file programmatically in the Spreadsheet.

0 commit comments

Comments
 (0)