Модуль для Битрикс «Клиентская база api»

Модуль предоставляет простые классы и методы для взаимодействия с Клиентской базой через её апи.

Модуль доступен на Маркетплейсе Битрикса (скоро).

Настройка модуля

После установки на сайт, настройка производится в административной части: «Настройки» - «Настройки модулей» - «Клиентская база api».

На странице настроек необходимо ввести:

• имя сайта, на котором установлена Клиентская база (с http/https). Если КБ установлена на в корневую папку, то имя сайта следует ввести вместе с той папкой, в которую она устновлена;
• логин пользователя Клиентской базы, от лица и с правами которого будет осуществляться подключение;
• api-ключ этого пользвателя.

Если все данные верны, то после сохранения настроек появится надпись [есть подключение]. После этого можно обращаться к Клиентской базе с помощью классов и методов модуля.

Использование модуля

Модуль реализует все возможности, доступные в апи Клиентской базы на апрель 2018 года.

Взаимодействие с Клиентской базой возможно как с помощью классов сущностей, так и с помощью основного класса \Rover\CB\Rest. Классы сущностей являются обёрткой над \Rover\CB\Rest и реализуют более удобные методы для доступа к конкретным сущностям КБ.

Классы сущностей расположены в пространстве имён \Rover\CB\Rest\. Их методы практически идентичны методам апи клиенской базы.

Пример

Получение списка пользователей с помощью класса Rover\CB\Rest\User:

use Bitrix\Main\Loader;
use Rover\CB\Rest\User;

if (Loader::includeModule('rover.cb')) {

    try{

        $users = User::getInstance()->getList();

        echo '<pre>';
        print_r($users);
        echo '</pre>';

    } catch (\Exception $e){
        ShowError($e->getMessage());
    }

} else {
    ShowError("Не удалось подключить модуль «Клиентская база api»");
}

Результат будет примерно таким:

Array
(
    [data] => Array
        (
            [1] => Array
                (
                    [id] => 1
                    [fio] => ...
                    [group_id] => 1
                    [arc] => 0
                )

            [10] => Array
                (
                    [id] => 10
                    [fio] => ...
                    [group_id] => 1
                    [arc] => 0
                )

            ...
            
        )

    [count] => 5
    [code] => 0
    [message] => Done
)

Вместо Rover\CB\Rest\User::getInstance()->getList() можно использовать \Rover\CB\Rest::getInstance()->requestPost('/api/user/get_list/'). Вообще, с помощью класса \Rover\CB\Rest можно обратиться ко всем методам апи Клисентской базы, в т.ч. и к тем, которые могут быть еще не реализованы в классах сущностей.

Доступные классы

\Rover\CB\Rest

• static getInstance() - получеат экземпляр класса \Rover\CB\Rest;
• requestPost($url, array $data = array()) - post-запрос к КБ
• requestGet($url, array $data = array()) - get-запрос к КБ
• request($method, $url, array $data = array()) - запрос к КБ. Метод поределяется переменной $method

Классы сущностей

Классы сущностей реализуют все методы \Rover\CB\Rest, за тем исключением, что static getInstance() возвращает экземпляр вызвавшего её класса.

Методы классов сущностей принимают те же параметы и в том же порядке, что и методы апи КБ, кроме параметра access_id: он не нужен. Более детальную информацию о них можно прочесть в справке по апи КБ.

\Rover\CB\Rest\Data Работа с данными в таблицах.

• create($tableId, $cals = true, array $data = array())
• read($tableId, $cals = true, array $fields = array(), array $filter = array(), array $sort = array(), $start = 0, $limit = 500)
• update($tableId, $cals = true, array $data = array(), array $filter = array())
• delete($tableId, $cals = true, array $filter = array())
• files($tableId, $fileFieldId, $lineId, $fileName) - получение файла, прикременного к записи. Описание здесь;

\Rover\CB\Rest\DataLine, \Rover\CB\Rest\DataRow - вспомогательные классы для \Rover\CB\Rest\Data. Реализуют те же методы за тем отличием, что в массивах данных, фильтра и сортировки не надо указывать ключи line и row соотвественно.

\Rover\CB\Rest\Group Работа с группами.

• getList(array $filter = array()) *

\Rover\CB\Rest\Group - Работа с таблицами

• getList(array $filter = array()) *
• getPerms($id)
• getInfo($id)

\Rover\CB\Rest\User - Работа с пользователями

• getList(array $filter = array()) *

* в массиве $filter можно передать данные для фильтрации результата в формате array('filterKey' => 'filterValue').

Требования

• php 5.3 или выше;
• модуль php CURL;
• «Конструктор административной части» (rover.fadmin) 1.6.8 или выше.

Контакты

По всем вопросам вы можете связаться со мной по email: rover.webdev@gmail.com, либо через форму на сайте https://rover-it.me.