/Methods/GetTableData

<< Click to Display Table of Contents >>

Navigation:  API MasterSCADA 4D > Подключение к исполнительной системе по JSON > JSON для HTTP-запросов > Описание JSON-запросов > Справочники >

/Methods/GetTableData

GetTableData - запрос на получение данных справочника (включая зависимые справочники).

Данные запроса

{

 table:   <int64>, - ID справочника в VMInfo

 recId:   <int64>, - ID записи в table, перекрывает параметр filter

 filter:  <string>, - фильтр для справочника

 fields: [<string>, <string>,... ] - список полей

}

Данные ответа

{

 tables: { - все справочники по запросу

   // id справочника : - данные справочника

   <string>: <Table>,

   ...

 },

 main: <string>, - имя основного справочника

 refs: { - связи ref полей со справочниками из tables

   <string>: { - field из <main> справочника

           table: <string>, -  ID справочника из tables

           field: <string> - ID поля, используемое в качестве значения

   },

   ...

}

 

Table : {

 pk: <string>, - ID поля, используемое в качестве Primary_Key

  displayField: <string>, - имя отображаемого поля данного справочника

  fields: [{

       name: <string>, - ID поля

       type: <string>, - SCADA type

       ref:  <bool> - необязательно поле, если True ID поля является внешней зависимостью

     }, {

       name: <string>,

       type: <string>

     },

     ...

 ],

 data: { - порядок значений в массиве соответствует порядку полей в fields.

     <pk1> : [v11, v12],

     <pk2> : [v21, v22],

     ...

 }

}

Пример

Запрос

{

"sessionId":"1234",

 "table":   12345,

  "filter": "{IDModel.Name}='Меркурий 230'",

 "fields": [ "IDMeters", "Serial", "IDModel.NomReestr", "IDModel.Name", "IDModel.IDProduser.Name" ]

}

Ответ

{

   "main": "Metters",

   "refs": {

       "IDModel.Name": {

           "table": "Models",

           "field": "Name"

       },

       "IDModel.NomReestr": {

           "table": "Models",

           "field": "NomReestr"

       },

       "IDModel.IDProduser.Name": {

           "table": "Produce",

           "field": "Name"

       }

   },

   "tables": {

       "Metters": {

           "pk": "IDMeters",

           "fields": [{

                   "name": "Serial",

                   "type": "STRING"

               }, {

                   "name": "IDModel.NomReestr",

                   "type": "DINT",

                   "ref": true

               }, {

                   "name": "IDModel.Name",

                   "type": "DINT",

                   "ref": true

               }, {

                   "name": "IDModel.IDProduser.Name",

                   "type": "DINT",

                   "ref": true

               }

           ],

           "data": {

               "1": ["gsdf45", 2, 2, 1],

               "2": ["65748", 1, 1, 1]

           }

       },

       "Models": {

           "pk": "IDMeters",

           "fields": [{

                   "name": "Name",

                   "type": "STRING"

               }, {

                   "name": "NomReestr",

                   "type": "DINT"

               }

           ],

           "data": {

               "1": ["Меркурий 230 АМ", 467584],

               "2": ["Меркурий 234 ART2 PQR", 4566587],

               "3": ["СВХ 15", 45326]

           }

       },

       "Produce": {

           "pk": "IdProduce",

           "fields": [{

                   "name": "Name",

                   "type": "STRING"

               }

           ],

           "data": {

               "1": "Меркурий 230 АМ",

               "2": "Тепловодохран",

               "3": "МЗТА"

           }

       }

   },

   "code": 0

}