HImportJSON (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

HCreateMoveableReplica

HCreateSubscriberReplica

HDeactivateAutoFilter

HDescribeFullTextIndex

HErrorStatusModification

HFilterIncludedBetween

HMigrateLinkedCompositeKey

HRecreateSubscriberReplica

Type of import
Array items

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

HImportJSON (Function)

In french: HImporteJSON

Available only with these kinds of connection

Imports a JSON file in a data file in HFSQL Classic format (data file described in the data model editor or declared by HDeclare, HDeclareExternal or HDescribeFile). Remark: From version 19, HFSQL is the new name of HyperFileSQL.

Versions 23 and later

This function is now available for WINDEV applications in Linux.

This function is now available for WEBDEV sites in Linux.

New in version 23

This function is now available for WINDEV applications in Linux.

This function is now available for WEBDEV sites in Linux.

This function is now available for WINDEV applications in Linux.

This function is now available for WEBDEV sites in Linux.

Example

// Import "C:\MyFiles\Customer.json" into the Customer data file.
// The Customer data file will be overwritten if it already exists (hImpCreation constant)
// A progress bar will be displayed in PROGBAR_ProgBar1
HImportJSON(Customer, "C:\MyFiles\Customer.json", "", "", hImpCreation, PROGBAR_ProgBar1)

Syntax

<Result> = HImportJSON(<Data file> , <Path of JSON file> [, <List of items to import> [, <List of "items" to import> [, <Options> [, <Progress Bar>]]]])

<Result>: Boolean

True if the operation was performed,
False if an error occurred. HError is used to identify the problem.

<Data file>: Character string (with or without quotes)

Name of HFSQL Classic data file into which the import will be performed. This file is automatically created if it does not physically exist.

<Path of JSON file>: Character string (with quotes)

Full access path of the JSON file to import.

<List of items to import>: Optional character string (with quotes)

List of names of data file items into which the import will be performed. The names can be delimited by single quotes and they are separated by commas or CR characters. The names of the composite key items, binary memo items and binary items are ignored.
The non-imported items will be initialized with their default value described in the analysis.
If this parameter is not specified or if it corresponds to an empty string, all the items are imported (except the composite keys, the binary items and the binary memos) in the physical order of description.

<List of "items" to import>: Optional character string (with quotes)

List of names of items to import. If this parameter is not specified or if it corresponds to an empty string, all the items found in the JSON file are imported.

<Options>: Optional Integer constant (or combination of constants)

Type of import to perform:
hImpNormal
(default value) If the import data file already exists, it is filled with the imported data ; otherwise, the data file is created.
hImpCreation If the import data file exists, it is overwritten.
hImpBreakable The import can be interrupted by pressing the Esc key on the keyboard.
If the import is interrupted, the imported records are kept in the data file.

<Progress Bar>: Optional control name or window name

Name of window where the progress bar will be displayed
Name of Progress Bar control that displays the progress.
This parameter is not available.

Remarks

Type of import

If the list of items is specified: the import will find the "JSON items" with the same name as the items.

Example: The data file described in the analysis contains the following items: ITEM1, ITEM2, ... The JSON file must have the following structure:

{"File":
{
"Item1":Data of item 1,
"Item2":Data of item 2,
...
}
}

The names of items found in the JSON file that do not exist in the analysis or that are not specified in the list of items will be ignored during the import.

If the list of JSON items is not specified, the value of the JSON items is included in the item of the HFSQL data file that is named like the JSON item.

Array items

HImportJSON can also be used to import array items.

Component : wd250hf.dll