Інтеграція 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

Варіанти пропозиції: