Requality

h1. APIForNG

По текущей модели предполагается использование следующих методов:

Для всех методов по умолчанию используется один заголовочный параметр

Authorization со значением Bearer 36AC0A0F7F271314B72986EB54DB2343

1.Получение списка проектов

Method:

GET

Path:

http://localhost:9988/projects

Без дополнительных параметров

Пример выдачи

<pre><code class="javascript">

{

  "success" : true,

  "result" : {

    "projects" : [ "Example", "з1", "arch", "stpo"],

    "count" : 4

  }

}

</code></pre>

Без дополнительных параметров

2. Получение содержимого проекта(иерархия), для expandable - ограниченное 1м уровнем 

Method:

GET

Path:

http://localhost:9988/projects/{arch}[/expandable]

Здесь {arch} - имя проекта, на данный момент регистрозависимо

Без дополнительных параметров

Пример выдачи

<pre><code class="javascript">

{

  "success": true,

  "result": {

    "name": "arch",

    "nodes": [

      {

        "uuid": "243f4afe-1d28-4652-80b9-4ad123b415a4"

        "name": "Documents",

        "type": "DocFolder",

      },

      {

        "uuid": "7a5374ee-eb7a-4731-997d-5f52f00ebc2e"

        "name": "Requirements",

        "type": "Requirement",

        "haveChildren":"true",

        "children": [

          {

            "uuid": "8ccd86e3-5689-43aa-9241-04728447e8f7",

            "name": "001",

            "type": "Requirement",

            "children": [],

          }

        ]

      },

      {

        "uuid": "ff42a6f4-f9ac-48c3-b41c-c36395df8a85",

        "name": "Reports",

        "type": "ReportFolder"

      }

    ],

  }

}

</code></pre>

по умолчанию выдает все дерево с базовым набором из нескольких полей - уникального id uuid, отображаемого имени name, типа type и массива потомков children. 

поле haveChildren присутствует если у узла есть потомки и работает даже когда children не видны в режиме expandable для 2 уровня вложенности

при режиме [expandable] потомки выдаются до 1 уровня вложенности

3. Получение данных по поддереву

Method:

GET

Path:

http://localhost:9988/projects/{TEST}/hierarchy/ff42a6f4-f9ac-48c3-b41c-c36395df8a85[/expandable]

{TEST} - имя проекта

id после /hierarchy это id узла для которого получается поддерево, режим /expandable работает аналогично проекту

Без дополнительных параметров

Пример выдачи

<pre><code class="javascript">

{

  "success": true, 

  "result": 

  {

    "uuid": "ff42a6f4-f9ac-48c3-b41c-c36395df8a85",

    "name": "Reports",

    "type": "ReportFolder",

    "parent": "ff42a6f4-f9ac-48c3-b41c-c36395df8a85"

  }

}

</code></pre>

Содержимое result аналогично описанию одного узла и всех его потомков[или потомков 1 уровня вложенности для expandable] в выдаче проекта

4. Получение свойств узлов

Method:

POST

Path:

http://localhost:9988/projects/TEST/getattributes/

В теле запроса передаются все uuid ы узлов для которых нужно выдать свойства. Конкретная реализация пока уточняется, текущее предположение - просто передавать в текстовом виде с разделителем ;. Возможно будут передаваться в качестве массива по аналогии с передачей данных форм. Пример "4db0fbf4-f383-4740-9d72-891ef112f742;ff42a6f4-f9ac-48c3-b41c-c36395df8a85".

Пример выдачи

<pre><code class="javascript">

{

  "success": true,

  "result": {

    "attributes": {

      "4db0fbf4-f383-4740-9d72-891ef112f742":{

        "Вид": {

          "value": "",

          "type": "STRING"

        },

        "_index": {

          "value": "1",

          "type": "STRING"

        },

        "_name": {

          "value": "Хронология",

          "type": "STRING"

        },

        "_type": {

          "value": "Requirement",

          "type": "STRING"

        },

        "_id": {

          "value": "001",

          "type": "STRING"

        },

        "ForeignID": {

          "value": "1",

          "type": "STRING"

        }

      },

      "9dffaddf-a55a-4fa1-a3bc-4a5fade4169f":{

        "Вид": {

          "value": "Заголовок",

          "enumName": "Вид",

          "valueType": "STRING",

          "type": "ENUM"

        },

        "_index": {

          "value": "1",

          "type": "STRING"

        },

        "_tags": {

          "value": [

            {

              "value": "section_Архитектура_ПО_Поток_управления"

            }

          ],

          "valuesType": "STRING",

          "type": "LIST"

        },

        "_type": {

          "value": "Requirement",

          "type": "STRING"

        },

        "_id": {

          "value": "Поток управления",

          "type": "STRING"

        },

        "_description": {

          "value": " ",

          "type": "HTML"

        },

        "ForeignID": {

          "value": "2",

          "type": "STRING"

        }

      }

    }

  }

}

</code></pre>

В примере выдача свойств двух узлов. Они расположены в result в виде словаря где ключ это id а значение - набор свойств узла.

5. Метод для работы с ресурсами. Текущая реализация

Method:

GET

Path:

http://localhost:9988/projects/{TEST}/nodes/{n}/resources/{resFolder}/{res}

{Test} имя проекта

{n} - uuid узла

{resFolder} папка с ресурсами(внутри {node_id}_resources, например "images")

{res} имя файла

Возвращает ответ типа APPLICATION_OCTET_STREAM включающий в себя содержимое нужного ресурса. В теле также передается имя файла.

Если ресурса нет то выдается ответ NOT_FOUND типа plain text

Если передано некорректное имя папки с ресурсами(включающее недопустимые символы) то выдается ответ INVALID FOLDER типа plain text

Предположительно появится метод получения ресурсов по списку для множества узлов но потом

Возможный формат передачи данных - json пары

<pre><code class="javascript">

{"uuid":"resfolder/resname","uuid2":"resfolder2/resname2"}

</code></pre>

Возможный тип возвращаемого значения - multipart/mixed. Но при этом размер возвращаемых данных может оказаться значительным

6. Метод для получения связей

Method:

POST

Path:

http://localhost:9988/projects/{TEST}/getlinks

В теле запроса передаются все uuid ы узлов для которых нужно выдать свойства. Текущее предположение - в текстовом виде с разделителем ';'. Пример "4db0fbf4-f383-4740-9d72-891ef112f742;ff42a6f4-f9ac-48c3-b41c-c36395df8a85".

Результат включает в себя аналог словаря uuid:{ссылки}. Если для узла ссылок нет то в выдачу он не попадает.

ссылки разбиты на 4 раздела

linkToRelations - исходящие ссылки по свойствам

linkedByRelations - входящие ссылки по свойствам

linkToTerms - связи от использования термина из другого узла к определению в данном узле

linkedByTerms - связи от использования термина из данного узла к определению в другом узле

Пример выдачи

<pre><code class="javascript">

{

  "success": true,

  "result": {

    "links": {

      "7a5374ee-eb7a-4731-997d-5f52f00ebc2e": {

        "linkToRelations": {

          "reg": [

            {

              "haveChildren": true,

              "name": "Архитектура ПО",

              "type": "Requirement",

              "parent": "7a5374ee-eb7a-4731-997d-5f52f00ebc2e",

              "externalId": "9",

              "uuid": "188f8992-12e1-4acc-bf5a-fd568b1a2161"

            }

          ],

        },

        "linkedByRelations": {

          "d": [

            {

              "haveChildren": true,

              "name": "если E = 2 k -1",

              "type": "Requirement",

              "project": "SQRT",

              "parent": "ba51211b-d1c6-46ae-9333-bdad409b1fdb",

              "uuid": "127bfded-ae30-4365-9274-c116201a4ac1"

            },

            {

              "name": "001",

              "type": "Requirement",

              "project": "SQRT",

              "parent": "ebc37a22-15c5-482d-9e4c-8c23461fca39",

              "uuid": "57b80f94-9011-43d8-844f-5bef23e37afb"

            },

            {

              "name": "002",

              "type": "Requirement",

              "project": "SQRT",

              "parent": "4b40ef1a-de18-4d71-8825-2ef16b502cd0",

              "uuid": "658b8768-55b8-45b5-99b3-f03ba252acb7"

            }

          ]

        }

      }

    }

  }

} 

</code></pre>