Skip to content

Commit 6dbde85

Browse files
committed
include alipay
1 parent e23681d commit 6dbde85

File tree

2 files changed

+102
-27
lines changed

2 files changed

+102
-27
lines changed

README.md

Lines changed: 101 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -1,46 +1,119 @@
1-
# Excel-to-JSON
1+
# 1. Get Started
2+
<a name="Introduction"></a>
3+
[中文](https://excel-to-json.wtsolutions.cn/zh-cn/latest/getstarted.html)
24

3-
[![Documentation Status](https://readthedocs.org/projects/excel-to-json/badge/?version=latest)](http://excel-to-json.readthedocs.io/en/latest/?badge=latest)
5+
Excel to JSON by WTSolutions is a **Microsoft Excel add-in** or **Web Application** which can convert Excel to JSON, both Flat and Nested JSON can be converted.
46

5-
[简体中文](https://github.com/he-yang/Excel-to-JSON-zh-CN)
67

7-
Excel add-in converting excel to json
8+
# 2. Requirements
9+
<a name="Requirements"></a>
10+
`Option 1. Load Excel to JSON in Web Browser`
11+
* A web browser that supports JavaScript, such as Google Chrome, Mozilla Firefox, Safari, or Microsoft Edge.
812

9-
Excel-to-JSON is now available on Microsoft Appsource (formerly known as Office Store). https://store.office.com/app.aspx?assetid=WA104380263
13+
`Option 2. Side-load Excel to JSON in Excel` (recommended)
14+
* Excel 2013 Service Pack 1 or later,
15+
* Excel 2016 for Mac,
16+
* Excel 2016 or later,
17+
* Excel Online,
18+
* Office 365 etc.
1019

11-
## Documentation
12-
[https://excel-to-json.wtsolutions.cn](https://excel-to-json.wtsolutions.cn)
1320

14-
## Get Started
21+
# 3. Quick Start
22+
<a name="Quickstarted"></a>
23+
This quick start is for v 3.0.0
1524

16-
Excel to JSON is a Microsoft Excel add-in which can convert Excel to JSON.
1725

18-
## Requirements
19-
This add-in works with Excel 2013(or higher), Excel Online, Office 365, Excel for Mac.
26+
## 3.1 (Side-)Load Excel to JSON
2027

21-
## Get add-in
22-
* Open a new datasheet in Excel 2013/2016 or higher, Excel Online or Office 365 etc.
23-
* **Insert** Tab or **Home** Tab> Add-ins.
24-
* In the Add-ins search box, search for “Excel-to-JSON”.
25-
* Click the add-in to start it.
26-
* You would see a "Excel-to-JSON" button added to your Excel **Home** Tab. Now you are ready to use this add-in.
28+
`Option 1. Load Excel to JSON in Web Browser`
29+
* Open a web browser that supports JavaScript, such as Google Chrome, Mozilla Firefox, Safari, or Microsoft Edge.
30+
* Open the following URL in your web browser: <a href="https://s.wtsolutions.cn/excel-to-json.html" target="_blank">https://s.wtsolutions.cn/excel-to-json.html</a>
2731

28-
### Use add-in
2932

30-
Note that you should select at least two rows as the first row will be considered as header.
33+
`Option 2. Side-load Excel to JSON in Excel` (recommended)
34+
* Open a new datasheet in Excel 2013/2016 or Excel Online or Office 365.
35+
* **Home** Tab or **Insert** Tab > Add-ins
36+
* In the search box, type in "Excel to JSON"
37+
* Follow the instructions on the screen to install the add-in, and you will see an button JSON-to-Excel added to your **Home** Tab.
38+
* **Home** Tab > Excel to JSON > Convert
39+
* Now you are ready to use this add-in.
40+
41+
42+
<a name="Useadd-in"></a>
43+
44+
## 3.2 Use Excel to JSON
3145

3246
* Prepare your Excel sheet
33-
* Select data you'd like to convert
34-
* Choose Mode: Flat or Nested JSON mode
35-
* If you have subscribed "Pro Features", you can set more options
47+
* Load your Excel Data in one of the two ways:
48+
1. `Load Excel to JSON in web browser`: Copy and Paste your Excel data in the text area, or
49+
2. `Side-load Excel to JSON in Excel`: Select your date directly from Excel worksheet.
50+
* Set Conversion Settings
3651
* Click on "Go" button
3752
* You will later see the converted JSON below the "Go" button
38-
* Later you can "copy+paste" / "copy to clipboard" JSON and save it to your computer
53+
54+
### Input Excel Data
55+
56+
There are two ways for you to input Excel data to Excel-to-JSON:
57+
58+
* `Load Excel to JSON in web browser`
59+
* Copy and Paste your Excel data in the text area
60+
* You can copy and paste your Excel data from Excel, Google Sheets, or any other Excel-compatible software, data are seperated by Tab
61+
* You can also copy and paste comma seperated CSV data
62+
* `Side-load Excel to JSON in Excel`: Select your data directly from Excel worksheet using your mouse.
63+
64+
### Output JSON export
65+
66+
There are several ways for you to save the generated JSON to your local computer.
67+
68+
* `Copy and Paste`. Once JSON generated, you will see them in a textarea, and you can simply copy and paste them anywhere you want.
69+
* `Copy to Clipboard`. Once JSON generated, you can find the "Copy to Clipboard" button, click on the button, and you will have JSON on your clipboard.
70+
* `Save to File`.(Not available to `Excel for Mac` users) Once JSON generated, you can find the "Save As" button, click on the button, and you will be prompted to save the JSON to a file.
71+
72+
73+
74+
75+
## 3.3 Conversion Settings
76+
77+
Line break in an Excel cell will be rendered as `\n`
3978

4079

41-
## Examples
80+
### Select Header, Row/Column
81+
By default, Excel to JSON took the first row as header, but optionally, you can select "First Column as Header".
4282

43-
**Example Excel sheet 1**
83+
If `First Row as Header` selected:
84+
85+
The first (left) column will be considered as the header column(keys for JSON object), and columns on the right will become values for JSON object."
86+
87+
If `First Column as Header` selected:
88+
89+
The first (top) row will be considered as the header row(keys for JSON object), and row below will become values for JSON object.
90+
91+
92+
### Conversion Mode
93+
* `Flat JSON mode`
94+
* Simply convert Excel datasheet to a flat JSON.
95+
* `Nested JSON mode`
96+
* First convert Excel datasheet to a flat JSON
97+
* then, unflatten an object with delimited keys using "Flat" [https://www.npmjs.com/package/flat](https://www.npmjs.com/package/flat)
98+
* unflatten() is called by Excel-to-JSON, with delimiter as ".", overwrite as true. If you have subscribed "Pro Features", you can set other delimeters.
99+
100+
### Nested JSON Key Delimiter
101+
102+
The delimiter used to separate nested properties in the JSON output.
103+
104+
- `Dot (.)`
105+
- `Underscore (_)` [Pro Feature]
106+
- `Double Underscore (__)` [Pro Feature]
107+
- `Slash (/)` [Pro Feature]
108+
109+
### Other Settings
110+
111+
Other settings will be described in [Pro Features](profeatures.md)
112+
113+
# 4. Examples
114+
115+
116+
## 4.1 Example Excel sheet 1
44117

45118

46119
|Name|Age|Company|
@@ -85,7 +158,7 @@ Note that you should select at least two rows as the first row will be considere
85158
]
86159
```
87160

88-
**Example Excel sheet 2**
161+
## 4.2 Example Excel sheet 2
89162

90163
|id|student.name|student.familyname|student.age|
91164
|---|---|---|---|
@@ -114,7 +187,7 @@ Note that you should select at least two rows as the first row will be considere
114187
}]
115188
```
116189

117-
> Using Nested JSON mode
190+
> Using Nested JSON mode, and dot . as delimiter
118191
119192
```json
120193
[{
@@ -141,3 +214,4 @@ Note that you should select at least two rows as the first row will be considere
141214
}]
142215

143216
```
217+

source/profeatures.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,7 @@ Payment method:
2525
- Bank Card (Visa, Mastercard, American Express, JCB, 银联)
2626
- Apple Pay (needs to open the above link using your Apple/IOS/Mac Device)
2727
- Google Pay (needs to open the above link using your Google/Andriod Device)
28+
- Alipay 支付宝
2829
- Link
2930

3031
For subscription terms, kindly refer to the [Terms of Use](termsofuse.md)

0 commit comments

Comments
 (0)