Standard DataWindow JSON – PB Docs 2018

Standard DataWindow JSON

A standard-format DataWindow JSON is an object that contains
elements representing the various aspects of a DataWindow.

Elements

Description

identity

A string identifying the format. Should keep
unchanged.

version

An integer specifying the format version. Currently it
is 1.0.

platform

A string specifying the platform where JSON string is
generated. Values are: PowerBuilder, C#.

mapping-method

An integer specifying the method for mapping columns.
Values are:

  • 0 — Use the index of JSON item to map with the
    DataWindow column.

  • 1 — Use the index of meta-columns to map with the
    DataWindow column.

  • 2 — Use the key of JSON item to map with the
    DataWindow column.

Note: ImportJson function supports only 0 and 1, and
ImportJsonByKey function and GetValueToDataWindow function
ignore this value.

dataobject

An object indicating it is a DataWindow.

name

A string specifying the name of the DataWindow object
(DataObject).

meta-columns (optional)

An array specifying the information of the DataWindow
columns (excluding the computed columns).

For elements about the column meta information, see
COLUMN-META below.

primary-rows (optional)

An array specifying the data row in the DataWindow
primary buffer.

For elements about the DataWindow row, see DW-STANDARD-ROW
below.

filter-rows (optional)

An array specifying the data row in the DataWindow
filter buffer.

For elements about the DataWindow row, see DW-STANDARD-ROW
below.

delete-rows (optional)

An array specifying the data row in the DataWindow
delete buffer.

For elements about the DataWindow row, see DW-STANDARD-ROW
below.

dwchilds (optional)

An object specifying the data in the DataWindowChild.
The column name of the DataWindowChild is the key of
dwchilds. The data row is SIMPLE-ROW. see SIMPLE-ROW below for more
information.

COLUMN-META

COLUMN-META is an object that contains elements representing the
various aspects of the DataWindow column (but not the computed
column).

name — (required) a string specifying the name of the
column.

index — (required) an integer specifying the sequence order of
the column. This value will be used to map with the DataWindow column
when the mapping-method value is set to 1.

datatype — (required) a string specifying the type of the
column. This value is not used by import.

nullable — (required) an integer specifying whether to allow a
null value. 0 – a null value is not allowed, 1 – a null value is
allowed.

DW-STANDARD-ROW

DW-STANDARD-ROW is an object that contains elements representing
the detailed information of the DataWindow row.

row-status — (required) an integer specifying the status of the
DataWindow row. 0 – NotModified!, 1 – DataModified!, 2 – New!, 3 –
NewModified!.

columns — (required) an object specifying the DataWindow column
information including the current value, the column status, and the
original value.

  • CURRENT-VALUE: (required) The current value of the column,
    in the following data type: integer, string, boolean, or
    null.

  • COLUMN-STATUS: (optional) An integer specifying the column
    status. 0 – (default) NotModified!, 1 – DataModified!.

  • ORIGINAL-VALUE: (optional) The original value of the column,
    in the following data type: integer, string, boolean, or null. The
    default type is null.

SIMPLE-ROW

SIMPLE-ROW is an object that contains elements representing the
simple information of the DataWindow row. The data must be in the
following data type: integer, string, boolean, or null.

Example

Here is an example of a standard-format DataWindow JSON
string:


Document get from Powerbuilder help
Thank you for watching.
Was this article helpful?
Subscribe
Notify of
guest
0 Comments
Oldest
Newest Most Voted
Inline Feedbacks
View all comments
0
Would love your thoughts, please comment.x
()
x