====== Описание формата ======

==== Navigation ====
  * [[ru:first|Главная]]
  * [[ru:airlay|Информация о системе]]


==== Форматы загрузки ====
===== JSON =====
Формат загрузки Airlay основан на формате  [[https://tools.ietf.org/html/rfc8259|RFC8259 Json]].
===== Пример =====
<code php>
    {
        "type": "Feature",
        "properties": {
            "id": string,
            "name": string,
            "type": "root"/"node",
            "emails": string[], // email адреса подразделения или ответственного лица
            "telegrams": string[] // ид чатов в Telegram
        },
        "system": {
            "relations": [
                {
                    "objectId": string // соответствует id дочернего подразделения
                },
                ...
            ]
        },
        "dataSets": [
            {
                "id": ObjectId,
                "filter": string // см. примечание
                "applyToRead": boolean // Применять ли фильтр у запросам чтения объектов (по умолчанию true)
            }
        ]
    }
</code>
Примечание: [[ru:airlay:layersettings#фильтры|Описание фильтров]]

===== Excel =====
Объекты оргструктуры задаются в виде таблицы. Описание столбцов:
  * **departmentId** - уникальный идентификатор оргструктуры.
  * **parentId** - уникальный идентификатор родительской оргструктуры.
  * **name** - название.
  * **additionalCode** - код оргструктуры.
  * **emails** - электронные адреса оргструктуры (перечисляются через косую черту).
  * **telegrams** - ид чатов в Telegram (перечисляются через косую черту).

Наборы данных задаются на отдельном листе с именем "datasets": 
  * **departmentId** - уникальный идентификатор оргструктуры.
  * **dataSetId** - уникальный идентификатор набора данных.
  * **filter** - фильтр для набора данных.
  * **applyToRead** - флаг "Применять фильтр к запросам на чтение объектов".

===== ИД telegram чата =====
Чтобы узнать ИД telegram чата необходимо:
  * Зайти в telegram.
  * Добавить в чат пользователя или начать чат с пользователем **AirlayBot**.
После этого бот напишет сообщение с ИД чата. Если необходимо снова вывести ИД чата, то отправьте в чат сообщение **/getChatId**.


===== Пример =====
{{ :ru:airlay:example_departments.xlsx |}}