Повний опис
Інтеграція BAS з "Битрикс24" - універсальний обмін між об'єктами "Битрикс24" і "BAS".
Рішення може працювати на хмарному і коробковому "Битрикс24". Налаштування на стороні "Битрикс24" виконані у вигляді скриптів, без зміни "Битрикс24".
Як реалізовано:
-
В "BAS" додано API-команди. Система взаємодії побудована так, що "Битрикс24" - активна сторона, а BAS - віддає і приймає інформацію сторона.
-
Відповідність об'єктів (сутностей) і їх полів налаштовується на стороні BAS.
-
Мінімальний тариф "Битрикс24" - "СРМ +". Не потрібно переходити на тариф «Компанія», як для стандартного обміну з Битрикс24.
Для налаштування обміну використовуються наступні об'єкти метаданих:
1. Довідники "Битрикс24".
2. Cтруктура метаданих.
3. Сутності обміну з "Битрикс24".

Мал.1. Дані для налаштування обміну.
1. «Довідники Битрикс24» (+ Довідник «Значення довідників Битрикс24»).
Передбачено налаштування відповідності значень довідкового типу (довідник, перерахування, ...) до значень в Битрикс24. Це зроблено для тих випадків, коли строкове представлення значень довідника (перерахування) не (завжди) відповідає своєму аналогу в Битрикс24 (мал. 2).
Налаштування обміну значеннями реквізитів виконується в довідниках відповідностей об'єктів "Битрикс24" і "BAS", без зміни програмного коду.
Перелік довідників для обміну:
- Контрагенти;
- Контактні особи;
- Склади;
- Залишки по складам;
- Товари;
- Бізнес-процес.
Мал.2. Налаштування відповідності значень довідкового типу (довідник, перерахування, ...) до значень в "Битрикс24".
Відповідність значень довідників "Битрикс24" - Налаштування відповідності довідкових значень значенням в "Битрикс24".

Мал.3. Налаштування відповідності довідкових значень значенням в "Битрикс24".
2. Структура метаданих - представлення метаданих, що беруть участь в обміні з "Битрикс24", у вигляді довідника (мал. 4).
Мал.4. Структура метаданих.
3. Налаштування відповідності сутностей "Битрикс24" реквізитів або пов'язаних елементів в "BAS".
Дана схема обміну передбачає можливість для користувача (без змін у коді або інших змін конфігурації) доповнення існуючого набору полів обміну сутностей, за умови, що використовуються типи даних "BAS", використовувані в базовій поставці (наприклад, прості типи (рядок, дата, число, логічне) ). Це робиться шляхом створення (якщо необхідно) елемента довідника Структура метаданих і додавання із зазначенням відповідного йому полю суті "Битрикс24" (елемент довідника Сутності обміну з "BAS"). Аналогічно для зв'язаних об'єктів: додати елемент довідника Сутності обміну з BAS та налаштувати зв'язок із зв'язаним об'єктом (мал.5).
Аналогічно при необхідності виключити з обміну деякі поля можна, не вдаючись до змін в коді. Досить просто помітити на видалення елемент довідника Сутності обміну з "BAS".
У наборі обміну існують також програмно визначенні поля, які неможливо визначити простою відповідністю реквізиту довідника/документа або пов'язаному об'єкту. У таких випадках без змін в коді обійтися не вийде. Як приклад, такому полю можна привести параметр Річний оборот. Такого реквізиту в довіднику контрагенти немає, але є відображення даного показника на формі елемента, а самі дані беруться по об'єкту за певний період з відповідного регістру. Очевидно, що для таких полів передбачений тільки односторонній обмін (тобто тільки вивантаження з "BAS" в "Битрикс24")
Але, як показала практика, таких полів не багато, і в більшості випадків зустрічається зв'язок один-до-одного (один реквізит "BAS" відповідає полю суті "Битрикс24").
Мал.5. Сутності метаданих.
Для зручності сприйняття інформації однотипні поля з пов'язаних об'єктів можна пов'язано помістити у вкладену групу (мал. 6).
Мал. 6. Приклад пов'язаних однотипних полів з об'єктами поміщених в вкладену групу (поля контактної інформації).
Але це допускається тільки для зв'язаних об'єктів. Поля обміну зі зв'язком один-до-одного обов'язково повинні знаходиться в кореневій групі суті!
Для зв'язаних об'єктів передбачена можливість налаштування різного відбору для вивантаження в "Битрикс24" і завантаження з нього. При вивантаженні в "Битрикс24", наприклад, може бути вивантажено контактна інформація з типом «Телефон», а завантажуватися це ж поле буде вже не тільки з типом Телефон, а ще й з видом «Робочий», або «телефон контрагента», або «телефон контрагента з "Битрикс24"». Для вивантаження можна задавати «не строго» відбір, а для запису в "BAS" необхідно вказувати відбір якомога конкретніше і точніше. Інакше під час запису даних в регістрі може виникнути помилка і завантажувані дані з "Битрикс24" в "BAS" записані не будуть.
Передбачений зв'язок не тільки реквізиту метаданих з відповідним полем суті "Битрикс24", але також і категорій, і пов'язаного довідника і регістру відомостей з можливістю установки відбору (мал.7).
Мал.7. Зв'язок метаданих з категорією, пов'язаного довідника і регістру відомостей з можливістю установки відбору.
Регістри відомостей.
ID Битрикс24 - Зберігання ідентифікатора об'єкта "Битрикс24" в "BAS".

Мал. 8. Зберігання ідентифікатора об'єкта.
Протокол вивантаження в "Битрикс24" - Фіксація помилок обміну. При необхідності можна фіксувати в тому числі і успішні операції.
Мал.9. Фіксація помилок обміну.
Налаштування обміну значеннями реквізитів виконується в довідниках відповідностей об'єктів "Битрикс24" і "BAS", без зміни програмного коду.
Розробник: Компанія «ЕНСІТІ»
www.nct.ua
info@nct.ua
Варіанти пропозиції: