База знань LMS Collaborator

Для імпорту оргструктури потрібно надіслати POST запит на URI/api/v2/orgstructure/import.

Імпорт оргструктури можна провести двома способами:

• за допомогою CSV-файлу
• в JSON-форматі

Імпорт за допомогою CSV-файлу

До запиту має бути прикріплений файл у форматі CSV наступного вигляду:

код підрозділу;назва підрозділу;код батьківського підрозділу
a3123910441;підрозділ 1;
a2567104662;підрозділ 1.2;a3123910441
a2701216083;підрозділ 1.2.1;a2567104662
a2206647782;підрозділ 1.2.2;a2567104662
a3123410541;підрозділ 2;
a1468104662;підрозділ 2.1;a3123410541
a1206747582;підрозділ 2.1.2;a1468104662

• Запит повинен містити заголовки Content-Type: multipart/form-data та X-Cbr-Authorization: Bearer API_TOKEN.

Приклад запиту:

curl 'https://your-domain.davintoo.com/api/v2/orgstructure/import' -H 'X-Cbr-Authorization: Bearer API_TOKEN' -H 'Content-Type: multipart/form-data' -F 'file=@/path/to/structure.csv'

Імпорт оргструктури в JSON-форматі

Замість CSV-файлу в тіло запиту можна додати інформацію про оргструктуру в JSON-форматі, наприклад:

[
    {
        "uid": "structureid1",
        "parent_uid": "",
        "title": "structure1"
    },
    {
        "uid": "departmentid2",
        "parent_uid": "structureid1",
        "title": "department2"
    },
    {
        "uid": "departmentid3",
        "parent_uid": "structureid1",
        "title": "department3"
    }
]

• Запит повинен містити заголовки Content-Type: application/json та X-Cbr-Authorization: Bearer API_TOKEN
• Налаштування body: raw, JSON

Приклад запиту:

`curl 'https://your-domain.davintoo.com/api/v2/orgstructure/import' -H 'X-Cbr-Authorization: Bearer API_TOKEN' -H 'Content-Type: application/json'

Імпорт декількох оргструктур

Імпорт кількох організаційних структур доступний лише за умови, що в політиках оргструктури увімкнено опцію Дозволити імпорт декількох оргструктур.
Також має бути обраний режим імпорту оргструктури На основі даних імпорту або Гібридний. Якщо встановлено режим За налаштуваннями атрибутів, запит буде відхилено, а система поверне помилку: Invalid orgstructure mode, setup 'import' or 'hybrid'.

Для імпорту обов'язково потрібно передавати префікс, який використовується для розмежування кількох оргcтуктур. Це можна робити одним з двох способів:

• в параметрі запиту
  'https://your-domain.davintoo.com/api/v2/orgstructure/import?prefix=part1'

• в HTTP заголовку
  'X-Cbr-Orgstructure-Prefix: part1'