Interface DocumentsService


@MTOM(enabled=true) public interface DocumentsService
Сервис для работы с документами плагина, файлами документов, а также со справочниками Типы, Журналы, Статусы документов
  • Method Details

    • getDocumentList

      List<Document> getDocumentList(int contractId, String title, Period period) throws ru.bitel.bgbilling.common.BGException, ru.bitel.bgbilling.common.BGMessageException
      Получение списка документов плагина у договора.
      Parameters:
      contractId - код договора
      title - фильтр по названию документа
      period - фильтр по периоду создания документа
      Returns:
      список документов
      Throws:
      ru.bitel.bgbilling.common.BGException
      ru.bitel.bgbilling.common.BGMessageException
    • getDocument

      Document getDocument(int documentId) throws ru.bitel.bgbilling.common.BGException, ru.bitel.bgbilling.common.BGMessageException
      Получение одного единственного документа по его коду.
      Parameters:
      documentId - код документа
      Returns:
      документ
      Throws:
      ru.bitel.bgbilling.common.BGException
      ru.bitel.bgbilling.common.BGMessageException
    • updateDocument

      int updateDocument(Document document) throws ru.bitel.bgbilling.common.BGException, ru.bitel.bgbilling.common.BGMessageException
      Добавление/Обновление документа и привязка его к договору
      Parameters:
      document - документ плагина
      Returns:
      код документа, который был добавлен/обновлен. Нужно для того, чтобы можно было привязывать файлы к еще не сохраненному в БД документу
      Throws:
      ru.bitel.bgbilling.common.BGException
      ru.bitel.bgbilling.common.BGMessageException
    • deleteDocument

      void deleteDocument(List<Integer> documentIdList) throws ru.bitel.bgbilling.common.BGException, ru.bitel.bgbilling.common.BGMessageException
      Удаление документа. Происходит отвязка от договора, а также удаление вложенных файлов.
      Parameters:
      documentId - код документа
      Throws:
      ru.bitel.bgbilling.common.BGException
      ru.bitel.bgbilling.common.BGMessageException
    • updateDocumentStatus

      boolean updateDocumentStatus(int documentId, int statusId, String statusComment) throws ru.bitel.bgbilling.common.BGException, ru.bitel.bgbilling.common.BGMessageException
      Обновление статуса документа.
      Parameters:
      documentId - код документа
      statusId - код статуса
      statusComment - комментарий к статусу
      Returns:
      true - если статус обновлен, false - в противном случае (провал может быть, если у документа уже установлен такой статус прежде)
      Throws:
      ru.bitel.bgbilling.common.BGException
      ru.bitel.bgbilling.common.BGMessageException
    • getAdditionalParams

      String getAdditionalParams(int contractId) throws ru.bitel.bgbilling.common.BGException, ru.bitel.bgbilling.common.BGMessageException
      Метод возвращает набор дополнительных параметров, которые необходимы для автоматического создания директорий при загрузке/выгрузке документов, если документ имеет определенный тип и имя договора соответствует определенному шаблону.
      Parameters:
      contractId - код договора
      Returns:
      мап с параметрами
      Throws:
      ru.bitel.bgbilling.common.BGException
      ru.bitel.bgbilling.common.BGMessageException
    • getDocumentFileList

      List<BGServerFile> getDocumentFileList(int documentId) throws ru.bitel.bgbilling.common.BGException, ru.bitel.bgbilling.common.BGMessageException
      Возвращает список файлов (мета-информация), привязанных к документу. Непосредственное скачивание файлов происходит в методе downloadFile
      Parameters:
      documentId - код документа, чей список файлов необходимо получить
      Returns:
      список файлов
      Throws:
      ru.bitel.bgbilling.common.BGException
      ru.bitel.bgbilling.common.BGMessageException
    • downloadDocumentFile

      BGServerFile downloadDocumentFile(int fileId, int contractId, jakarta.xml.ws.Holder<jakarta.activation.DataHandler> fileData) throws ru.bitel.bgbilling.common.BGException, ru.bitel.bgbilling.common.BGMessageException
      Скачивание указанного файла с сервера. Происходит как в случае простого скачивания для сохранения файла на диске, так и для открытия файла в системном приложении
      Parameters:
      fileId - код файла
      contractId - код договора
      fileData - входной поток с данными файла
      Returns:
      сущность, содержащая информацию о файле в системе BG
      Throws:
      ru.bitel.bgbilling.common.BGException
      ru.bitel.bgbilling.common.BGMessageException
    • deleteDocumentFiles

      void deleteDocumentFiles(List<Integer> fileIds) throws ru.bitel.bgbilling.common.BGException, ru.bitel.bgbilling.common.BGMessageException
      Удаление списка файлов по их идентификаторам. Используется при удалении файлов из документа плагина
      Parameters:
      fileIds - список идентификаторов файлов
      Throws:
      ru.bitel.bgbilling.common.BGException
      ru.bitel.bgbilling.common.BGMessageException
    • updateDocumentFile

      void updateDocumentFile(BGServerFile file) throws ru.bitel.bgbilling.common.BGException, ru.bitel.bgbilling.common.BGMessageException
      Обновление данных вложенного файла (комментарий)
      Parameters:
      file - вложенный файл
      Throws:
      ru.bitel.bgbilling.common.BGException
      ru.bitel.bgbilling.common.BGMessageException
    • documentJournalList

      List<DocumentJournal> documentJournalList() throws ru.bitel.bgbilling.common.BGException, ru.bitel.bgbilling.common.BGMessageException
      Получение списка журналов документов. Используется в справочнике.
      Returns:
      список журналов
      Throws:
      ru.bitel.bgbilling.common.BGException
      ru.bitel.bgbilling.common.BGMessageException
    • documentJournalGet

      DocumentJournal documentJournalGet(int journalId) throws ru.bitel.bgbilling.common.BGException, ru.bitel.bgbilling.common.BGMessageException
      Получение отдельно взятого журнала по коду. Используется в справочнике.
      Parameters:
      journalId -
      Returns:
      журнал
      Throws:
      ru.bitel.bgbilling.common.BGException
      ru.bitel.bgbilling.common.BGMessageException
    • documentJournalUpdate

      int documentJournalUpdate(DocumentJournal journal) throws ru.bitel.bgbilling.common.BGException, ru.bitel.bgbilling.common.BGMessageException
      Добавление/Обновление журнала. Используется в справочнике. В данном случае бросается событие, что данная сущность изменилась и требуется обновление на клиенте.
      Parameters:
      journal - журнал
      Returns:
      количество вставленных/обновленных записей.
      Throws:
      ru.bitel.bgbilling.common.BGException
      ru.bitel.bgbilling.common.BGMessageException
    • documentJournalDelete

      int documentJournalDelete(int journalId) throws ru.bitel.bgbilling.common.BGException, ru.bitel.bgbilling.common.BGMessageException
      Удаление журнала из БД. При этом происходит автоматическая проверка используется ли данный журнал в каком-либо документе. Если используется, то удаление не произойдет.
      Parameters:
      journalId - код журанала
      Returns:
      количество удаленных записей.
      Throws:
      ru.bitel.bgbilling.common.BGException
      ru.bitel.bgbilling.common.BGMessageException
    • documentTypeList

      List<DocumentType> documentTypeList() throws ru.bitel.bgbilling.common.BGException, ru.bitel.bgbilling.common.BGMessageException
      Получение списка типов документов. Используется в справочниках
      Returns:
      список типов документов
      Throws:
      ru.bitel.bgbilling.common.BGException
      ru.bitel.bgbilling.common.BGMessageException
    • documentTypeGet

      DocumentType documentTypeGet(int typeId) throws ru.bitel.bgbilling.common.BGException, ru.bitel.bgbilling.common.BGMessageException
      Получение конкретного типа документа по его коду. Используется в справочниках.
      Parameters:
      typeId - код типа документа
      Returns:
      тип документа
      Throws:
      ru.bitel.bgbilling.common.BGException
      ru.bitel.bgbilling.common.BGMessageException
    • documentTypeUpdate

      int documentTypeUpdate(DocumentType type) throws ru.bitel.bgbilling.common.BGException, ru.bitel.bgbilling.common.BGMessageException
      Добавление/Обновление типа документа. Используется в справочниках. При этом инициируется событие изменения типа документа и при необходимости с сервера подгружается обновленная информация на клиент.
      Parameters:
      type - тип документа
      Returns:
      количество вставленных/обновленных записей.
      Throws:
      ru.bitel.bgbilling.common.BGException
      ru.bitel.bgbilling.common.BGMessageException
    • documentTypeDelete

      int documentTypeDelete(int typeId) throws ru.bitel.bgbilling.common.BGException, ru.bitel.bgbilling.common.BGMessageException
      Удаление типа документа по его коду из БД. Используется в справочнике.
      Parameters:
      typeId - код типа документа
      Returns:
      количество удаленных записей.
      Throws:
      ru.bitel.bgbilling.common.BGException
      ru.bitel.bgbilling.common.BGMessageException
    • documentStatusList

      List<DocumentStatus> documentStatusList() throws ru.bitel.bgbilling.common.BGException, ru.bitel.bgbilling.common.BGMessageException
      Получение списка статусов документа. Используется в справочниках.
      Returns:
      список статусов
      Throws:
      ru.bitel.bgbilling.common.BGException
      ru.bitel.bgbilling.common.BGMessageException
    • documentStatusGet

      DocumentStatus documentStatusGet(int statusId) throws ru.bitel.bgbilling.common.BGException, ru.bitel.bgbilling.common.BGMessageException
      Получение конкретного статуса документа по его коду. Используется в справочниках.
      Parameters:
      statusId - код статуса документа.
      Returns:
      статус документа
      Throws:
      ru.bitel.bgbilling.common.BGException
      ru.bitel.bgbilling.common.BGMessageException
    • documentStatusUpdate

      int documentStatusUpdate(DocumentStatus status) throws ru.bitel.bgbilling.common.BGException, ru.bitel.bgbilling.common.BGMessageException
      Добавление/Обновление статуса документа в БД. Используется в справочниках.
      Parameters:
      status - статус документа
      Returns:
      количество вставленных/обновленных записей.
      Throws:
      ru.bitel.bgbilling.common.BGException
      ru.bitel.bgbilling.common.BGMessageException
    • documentStatusDelete

      int documentStatusDelete(int statusId) throws ru.bitel.bgbilling.common.BGException, ru.bitel.bgbilling.common.BGMessageException
      Удаление статуса документа из БД. Удаление произойдет в том случае, если данный статус нигде в документах не используется. Иначе удаление невозможно.
      Parameters:
      statusId - код статуса.
      Returns:
      количество удаленных записей.
      Throws:
      ru.bitel.bgbilling.common.BGException
      ru.bitel.bgbilling.common.BGMessageException
    • getDocumentStatusLogList

      List<DocumentStatusLogItem> getDocumentStatusLogList(int documentId) throws ru.bitel.bgbilling.common.BGException, ru.bitel.bgbilling.common.BGMessageException
      Получение лога изменений статуса документа по коду документа.
      Parameters:
      documentId - код документа
      Returns:
      история изменений статуса.
      Throws:
      ru.bitel.bgbilling.common.BGException
      ru.bitel.bgbilling.common.BGMessageException
    • updateStatusLog

      List<DocumentStatusLogItem> updateStatusLog(DocumentStatusLogItem item) throws ru.bitel.bgbilling.common.BGException, ru.bitel.bgbilling.common.BGMessageException
      Добавление записи в историю изменений статуса документа. Тут же возвращается обновленная история изменения статусов по договору.
      Parameters:
      item - запись лога
      Returns:
      обновленная история изменений статусов
      Throws:
      ru.bitel.bgbilling.common.BGException
      ru.bitel.bgbilling.common.BGMessageException
    • generateDocument

      Document generateDocument(int cid, int pattern, int journal, int type) throws ru.bitel.bgbilling.common.BGException, ru.bitel.bgbilling.common.BGMessageException
      Генерация документа определенного типа по заданному шаблону с заданным журналом
      Parameters:
      cid - код договора
      pattern - шаблон документа, по которому будет генерироваться документ
      journal - журнал
      type - тип документа
      Returns:
      сгенерированный документ
      Throws:
      ru.bitel.bgbilling.common.BGException
      ru.bitel.bgbilling.common.BGMessageException
    • checkNotFillParams

      List<String> checkNotFillParams(int cid, int patternId, int journal, int type) throws ru.bitel.bgbilling.common.BGException, ru.bitel.bgbilling.common.BGMessageException
      Parameters:
      cid - код договора
      patternId - шаблон документа, по которому будет генерироваться документ
      journal - журнал
      type - тип документа
      Returns:
      список названий незаполненных параметров
      Throws:
      ru.bitel.bgbilling.common.BGException
      ru.bitel.bgbilling.common.BGMessageException
    • getFileNetShare

      File getFileNetShare(int id, String title) throws ru.bitel.bgbilling.common.BGException, ru.bitel.bgbilling.common.BGMessageException
      Возвращает файл для открытия
      Returns:
      файл
      Throws:
      ru.bitel.bgbilling.common.BGException
      ru.bitel.bgbilling.common.BGMessageException
    • sendFileByEmail

      void sendFileByEmail(List<String> emails, List<Integer> fileIds) throws ru.bitel.bgbilling.common.BGException, ru.bitel.bgbilling.common.BGMessageException
      Отравляет файл по почте
      Parameters:
      emails - - адреса получателей
      fileIds - - id'шники отправляемых файлов
      Throws:
      ru.bitel.bgbilling.common.BGException
      ru.bitel.bgbilling.common.BGMessageException
    • sendDocumentLinkFiles

      void sendDocumentLinkFiles(List<String> emails, int documentId, List<Integer> fileIds, int leastTime) throws ru.bitel.bgbilling.common.BGException, ru.bitel.bgbilling.common.BGMessageException
      Отправляет ссылку на файл по почте
      Parameters:
      emails -
      documentId - ID документа
      fileIds - ID файлов, если файл один отправляется сссылка на файл если файлов несколько отсылается ссылка на архив
      leastTime - время жизни ссылки в секундах, 0 - бесконечно
      Throws:
      ru.bitel.bgbilling.common.BGException
      ru.bitel.bgbilling.common.BGMessageException
    • reinitDocumentSecret

      void reinitDocumentSecret(int documentId) throws ru.bitel.bgbilling.common.BGException, ru.bitel.bgbilling.common.BGMessageException
      Throws:
      ru.bitel.bgbilling.common.BGException
      ru.bitel.bgbilling.common.BGMessageException