Skip to main content
Version: 1.0.0

Import Matrix Items

Import Matrix Items

Imports or updates records to the selected index

REST API matrixItemApi/importMatrixItem

ParametersDescriptionParameter Options/valueDefault
insertNew Allow inserting new records. If false - only update is allowed true / false false
updExist Allow updating exist records. If false true / false false
rows
Required
Matrix items object array See table below
lines lines object array for each rows array See table below
columns columns object array for each rows array See table below
moves moves array for each lines/columns object See table below

JSON Body Example

{
...

"rows": [
{
...
"lines":
{ ...
"moves": [
{
...

}
]
},
"columns":
{ ...
"moves": [
{
...

}
]
}
}
]
}

Matrix items Data

The following parameters should be included in a rows array (see examples below)

FieldName-matrix itemTypeDescriptionתיאורDefault
itemKey
Required
String (max 20)מפתח פריטItem key
matrixType1-חד מימדית
2-דו מימדית
סוג מטריצהMatrix type
barcode1-רגיל
2-בר קוד
ברקודbarcode
fItemKeyString (max 20)קוד פריטitem key
linesobjectשורותlines
columnsobjectעמודותcolumns

Lines object for each rows array

The following parameters should be included in a lines array (see examples below)

FieldName-matrix itemTypeDescriptionתיאור
lineHeadString (max 20)כותרת שורותLines head
movesarrayשורותlines

Columns object for each rows array

The following parameters should be included in a columns array (see examples below)

FieldName-matrix itemTypeDescriptionתיאור
colHeadString (max 20)כותרת עמודותcolumns head
movesarrayעמודותcolumns

Moves array for each line/column object

The following parameters should be included in a moves array (see examples below)

tip

When updating an existing matrix item's row or column the ID is required, otherwise it is an addition.

FieldName-matrix itemTypeDescriptionתיאור
id
Required when updating line/column
Stringקוד שורה/ עמודה
codeString (max 20)מפתחcode
itemNameString (max 50)שםItem name
forignNameString (max 50)שם לועזיForeign name
nameString (max 15)כותרתhead
disabledboolפעילdisabled

JSON Examples

Example for itm index

{
"insertNew":true,
"updExist":true,
"rows": [
{
"itemKey": "shirt",
"matrixType": 2,
"barcode": 1,
"lines": {
"lineHead": "color",
"moves": [
{
"code": "black",
"itemName": "black",
"forignName": "black",
"name": "black",
"disabled": 0
},
{
"code": "blue",
"itemName": "blue",
"forignName": "blue",
"name": "blue",
"disabled": 0
}
]
},
"columns": {
"colHead": "size",
"moves": [
{
"code": "small",
"itemName": "small",
"forignName": "small",
"name": "S",
"disabled": 0
},
{
"code": "large",
"itemName": " large ",
"forignName": "large",
"name": "L",
"disabled": 0
}
]
}
}
]
}




Deleting Matrix Items

Deletes matrix item from tables

REST API matrixItemApi/deleteMatrixItem

ParametersTypeDescription
itemKey
Required
string Item key in the items table

JSON Example

{
"itemKey": "פריט-מטריצה1"
}

Showing matrix item

Show matrix item data

REST API matrixItemApi/getMatrixItem

ParametersTypeDescription
itemKey
Required
string Item key in the items table

JSON Example

{
"itemKey": "פריט-מטריצה1"
}

Matrix Item OutputData

NameOptions
statusCode200 – OK / 500 - Errors
status
errorsOK / Errors: "error description" / No Permission

JSON Example

 {
"statusCode": 200,
"status": {
"errors": "OK"
}
}