How to import?
24 |25 | 26 | Download and save JSON.bas to a file - open [the page with JSON.bas code](https://github.com/omegastripes/VBA-JSON-parser/blob/master/JSON.bas), right-click on Raw button, choose Save link as... (for Chrome): 27 | 28 |  29 | 30 | Import JSON.bas into the VBA Project - open Visual Basic Editor by pressing Alt+F11, right-click on Project Tree, choose Import File, select downloaded JSON.bas: 31 | 32 |  33 | 34 | Or you may drag'n'drop downloaded JSON.bas from explorer window (or desktop) directly into the VBA Project Tree. 35 | 36 |
37 |How to add reference?
39 |40 | 41 | Open Visual Basic Editor by pressing Alt+F11, click Menu - Tools - References, scroll down to **Microsoft Scripting Runtime** and check it, press OK: 42 | 43 |  44 | 45 | ###  MS Word Object Library compatibility note 46 | When referencing both **Microsoft Scripting Runtime** and **Microsoft Word Object Library** make sure that **Microsoft Scripting Runtime** located above **Microsoft Word Object Library** in the the list, if not so then ajust the position by clicking Priority arrows to the right of the list. 47 | 48 |  49 | 50 | Otherwise you have to change all `Dictionary` references to `Scripting.Dictionary` in your VBA code. 51 | 52 |
53 |139 | **filter()** - fetching elements from array or dictionary by conditions, set like `conds = Array(">=", Array("value", ".dimensions.height"), 15)`.
140 | **sort()** - ordering elements of array or dictionary by value of element by path, set like `".dimensions.height"`.
141 | **slice()** - fetching a part of array or dictionary by beginning and ending indexes.
142 | **selectElement()** - fetching an element from JSON structure by path, set like `".dimensions.height"`.
143 | **joinSubDicts()** - merging properties of subdictionaries from one dictionary to another dictionary.
144 | **joinDicts()** - merging properties from one dictionary to another dictionary.
145 | **nestedArraysToArray()** - converting nested 1d arrays representing table data with header array into array of dictionaries.
146 | 147 | ### JSON To XML DOM converter Beta 148 | 149 | [JSON2XML.bas](https://github.com/omegastripes/VBA-JSON-parser/blob/master/Beta/JSON2XML.bas). Converting JSON string to XML string and loading it into XML DOM (instead of building a structure of dictionaries and arrays) can significantly increase performance for large data sets. Further XML DOM data processing is not yet covered within current version, and can be implemented via DOM methods and XPath. 150 | 151 | ### Douglas Crockford json2.js implementation for VBA Beta 152 | 153 | **jsJsonParser** parser is essential for parsing large amounts of JSON data in VBA, it promptly parses strings up to 10 MB and even larger. This implementation built on [douglascrockford/JSON-js](https://github.com/douglascrockford/JSON-js/blob/master/json2.js), native JS code runs on IE JScript engine hosted by htmlfile ActiveX. Parser is wrapped into class module to make it possible to instantiate htmlfile object and create environment for JS execution in Class_Initialize event prior to parsing methods call. 154 | 155 | There are two methods available to parse JSON string: `parseToJs(sample, success)` and `parseToVb sample, jsJsonData, result, success`, as follows from the names you can parse to native JS entities of JScriptTypeInfo type, or parse to VBA entities which are a structure of nested Dictionaries and Arrays as described in [Purpose and Features](https://github.com/omegastripes/VBA-JSON-parser#purpose-and-features) section. Access to native JS entities is possible using `jsGetProp()` and `jsGetType()` methods. For JS entities processing you have to have at least common knowledge of JavaScript Objects and Arrays. 156 | 157 | Also you can parse to JS entities first, then make some processing and finally convert to VBA entities by calling `parseToVb , jsJsonData, result, success` for further utilization. JS entities can be serialized to JSON string by `stringify(jsJsonData, spacer)` method, if you need to serialize VBA entities, then use `JSON.Serialize()` function from [JSON.bas module](https://github.com/omegastripes/VBA-JSON-parser/blob/master/JSON.bas). If you don't want to mess with JS entities, simply use `parseToVb sample, , result, success` method. Note that convertion to VBA entities will take extra time. 158 | 159 | There are few examples in jsJsonParser_v0.1.1.xlsm workbook of the [last release](https://github.com/omegastripes/VBA-JSON-parser/releases/) 160 | --------------------------------------------------------------------------------