Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Представляет собой особый раздел WebAPIAPI серверов, предназначен для выполнения синхронизации и команд к 1С-Коннект напрямую из информационной базы 1С: Предприятие 8.3 у клиента.Изначально задумывался как канал взаимодействия для Универсальное расширения (плагина) типовой конфигурации интеграции с 1С-Коннект. Ввиду этого протокол реализовывался организации.

Протокол реализован с учетом проблемы неявности авто-запуска механизмов информационной базы клиента организации при её восстановлении/копировании системным администратором организации (т.е. алгоритм интеграции может быть не в единственном экземпляре, и может возникнуть непонимание "откуда же пришла на самом деле та или иная команда в облако 1С-Коннект").

Info

Реализован в виде SOAP-сервиса Учетной системы 1С-Коннект с названием BotAPI.

Особенности реализации:

  • На практике,

    у клиента

    в организации может быть более одной информационной базы

    для 

    для учета деятельности. Во избежание конфликтов синхронизации (или ошибок действий системного администратора), все команды "от лица" конкретной информационной системы должны идентифицироваться уникальным ключом-идентификатором InfobaseID. Вышеозначенный плагин самостоятельно генерирует ключ при первичном запуске в рамках конкретной информационной базы, и использует его в запросах

    BotAPI

    данного раздела API к облаку 1С-Коннект. Если

    клиент

    организация желает самостоятельно реализовать взаимодействие через BotAPI,

    он должен

    она должна взять организацию уникальности InfobaseID на себя.

  • Данный протокол создавался для целей:

    • полу-автоматической или автоматической синхронизации списка сотрудников в информационной системе

      клиента

      организации со списком аккаунтов 1С-Коннект в рамках личного кабинета этой организации. В рамках этой задачи реализованы методы GetEmployeesListAddEmployee, RestoreEmployee, DeleteEmployee.

    • push-уведомлений сотрудников данной организации по указанной линии с конкретным содержанием. Для этой цели реализованы

      методы GetLinesToConsumers, GetEmployeesList, GetConsumersList,

      метод SendNotification.

    • автоматической отправки/рассылки указанного файла указанному сотруднику по указанной линии. Для этой цели реализованы методы AddFile + SendFile. Т.к. один и тот же файл, возможно, большого размера, может потребоваться отправить нескольким адресатам, реализована двух-ступенчатая схема: ввиду ограничений SOAP, сначала необходимо отправить тело файла по HTTP-вызову AddFileвзамен получив уникальный идентификатор этого файла. Далее командой SendFile иницируете отправку файла указанному адресату, указав идентификатор этого файла (UUID). Можете вызвать команду SendFile несколько раз с одним идентификатором файла, тем самым отправив один и тот же файл нескольким адресатам.

    • для осуществления рассылок и файлов по линиям адресатам, предусмотрены методы получения списка адресатов GetConsumersList, GetLinesToConsumersа также списка линий GetSupportLinesList.

Состав команд:

Child pages (Children Display)