Package ru.bitel.bgbilling.plugins.helpdesk.common.service

# Interface HelpdeskService

@MTOM(enabled=true) public interface HelpdeskService

- ## Method Summary

  Modifier and Type
  Method
  Description
  `void`
  `categoryDelete(int categoryId)`
  `HelpDeskLinks`
  `categoryGroupLinks(int groupId)`
  `List<IdTitle>`
  `categoryGroupList()`
  `SearchResult<IdTitle>`
  `categoryList(Page page)`
  `MapHolder<IdTitle,List<IdTitle>>`
  `categoryMapForContract(int contractId)`
  `List<String>`
  `categorySubcategoryIdsForGroup(int contractId)`
  `void`
  `categoryToGroupAdd(int groupId, List<Integer> categoryIds)`
  `void`
  `categoryToGroupDelete(int groupId, List<Integer> categoryIds)`
  `void`
  `categoryUpdate(int categoryId, String title)`
  `void`
  `contractGroupUpdate(int contractId, int groupId)`
  `ru.bitel.bgbilling.plugins.helpdesk.common.dto.ContractModeDTO`
  `contractModeGet(int contractId)`
  `void`
  `contractModeUpdate(int contractId, String currentModeId)`
  `void`
  `fileDelete(int fileId)`
  `ru.bitel.bgbilling.common.dto.FileDto`
  `fileDownload(int fileId, int contractId)`
  FileDownload("id")
  `FileInfo`
  `fileUpload(String topicId, String uuid, String filename, long size, jakarta.xml.ws.Holder<jakarta.activation.DataHandler> fileData)`
  было FileUpload("id","comment","filename","filedata","size")
  `String`
  `getContractCurrentMode(int contractId)`
  `List<FileInfo>`
  `getMessageFileList(int messageId)`
  `List<ru.bitel.bgbilling.common.model.KeyValue>`
  `getModeList()`
  `MapHolder<String,String>`
  `getParams(int contractId)`
  `SearchResult<IdTitle>`
  `groupList(boolean groupForDirectory, int contractId, Page page)`
  `void`
  `groupUpdate(int groupId, String title)`
  `List<IdTitle>`
  `managerList()`
  `void`
  `messageAdminReadSet(int messageId)`
  `void`
  `messageCommentUpdate(int messageId, String comment)`
  `Message`
  `messageGet(int contractId, int topicId, int messageId)`
  `int`
  `messageNewCount()`
  Количество новых сообщений (всего)
  `int`
  `messageNextId(int topicId, int id)`
  `int`
  `messagePrevId(int topicId, int id)`
  `int`
  `messageUpdate(Message message)`
  `SearchResult<Package>`
  `packageList(Boolean status, Page page)`
  `int`
  `reserveStatusGet(int topicId)`
  Получение резервного статуса у топика.
  `int`
  `reservStatusUpdate(int topicId, int reserveStatus)`
  Обновление статуса резервирования у топика.
  `SearchResult<Message>`
  `searchTopicMessages(int contractId, int topicId, String[] sort, Page page)`
  `void`
  `setParams(int contractId, MapHolder<String,String> properties)`
  `void`
  `subcategoryDelete(int subcategoryId)`
  `SearchResult<IdTitle>`
  `subcategoryList(Page page)`
  `void`
  `subcategoryToCategoryAdd(int groupId, Set<Integer> categoriesIds, Set<Integer> subCategoriesIds)`
  `void`
  `subcategoryToCategoryDelete(int groupId, Set<Integer> categoriesIds, Set<Integer> subCategoriesIds)`
  `void`
  `subcategoryUpdate(int subcategoryId, String title)`
  `void`
  `topicAutocloseUpdate(int topicId, boolean autoclose)`
  `void`
  `topicBindSet(int topicId, String userId)`
  привязка топика к какому то юзеру (или отвязка соответсвенно от всех или к текущему привязка)
  `void`
  `topicCategorySubcategoryUpdate(int topicId, int categoryId, int subcategoryId)`
  `int`
  `topicCostUpdate(int topicId, BigDecimal sum)`
  Установка, обновление стоимости топика.
  `int[]`
  `topicCreate(Topic topic, Message message)`
  `Topic`
  `topicGet(int contractId, int topicId, boolean loadMessages)`
  `Result<Topic>`
  `topicList(int contractId, int id, Boolean history, Date dateFrom, Date dateTo, String title, String message, Page page)`
  `void`
  `topicManagerChange(int topicId, int managerId, String comment)`
  `List<ChangeManager>`
  `topicManagerChangeList(int topicId)`
  `void`
  `topicMarkReadByCustomer(int contractId, int id)`
  `int`
  `topicNotificationUpdate(int topicId, int mode, String value)`
  `void`
  `topicPackageStateSet(int contractId, int topicId, Boolean include)`
  `SearchResult<Topic>`
  `topicSearch(int topicId, String title, String message, int status, String userSelect, boolean onlynew, boolean closed, Period period, Page page)`
  `void`
  `topicStateUpdate(int topicId, boolean state, boolean packageMode)`
  `List<IdTitle>`
  `topicStatusList()`
  `void`
  `topicStatusUpdate(int topicId, int status)`
  `void`
  `topicUpdateState(int contractId, int id, boolean state)`

- ## Method Details

  - ### reservStatusUpdate

    int reservStatusUpdate(int topicId, int reserveStatus) throws Exception, ru.bitel.bgbilling.common.BGMessageException
    Обновление статуса резервирования у топика. Если устанавлиемый статус "BLOCKED", но средств на счету не достаточно, то устанавливается статус IN_WHAIT. И уже в дольнейшем будет произведена попытка заболокировать требуемую сумму.
    Parameters:
      `topicId` - - код топика.
      `reserveStatus` - - устанавливаемый статуc. смотреть значения в `HelpDeskConstants`;
    Returns:
      - кол-во изменненых строк в БД.
    Throws:
      `Exception`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### reserveStatusGet

    int reserveStatusGet(int topicId) throws Exception, ru.bitel.bgbilling.common.BGMessageException
    Получение резервного статуса у топика.
    Parameters:
      `topicId` - - ид топика.
    Returns:
      - статусы из `HelpDeskConstants`
    Throws:
      `Exception`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### topicCostUpdate

    int topicCostUpdate(int topicId, BigDecimal sum) throws Exception, ru.bitel.bgbilling.common.BGMessageException
    Установка, обновление стоимости топика. При дальнейшем переводе на сервайсы заменить обычным обновлением топика</>.
    Parameters:
      `topicId` - - ид топика.
      `sum` - - устанавливамя стоимость.
    Returns:
      - кол-во измененных строк в БД.
    Throws:
      `Exception`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### topicNotificationUpdate

    int topicNotificationUpdate(int topicId, int mode, String value) throws Exception, ru.bitel.bgbilling.common.BGMessageException
    Throws:
      `Exception`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### fileDelete

    void fileDelete(int fileId) throws Exception, ru.bitel.bgbilling.common.BGMessageException
    Throws:
      `Exception`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### fileDownload

    ru.bitel.bgbilling.common.dto.FileDto fileDownload(int fileId, int contractId) throws Exception, ru.bitel.bgbilling.common.BGMessageException
    FileDownload("id")
    Parameters:
      `fileId` - ид файла
      `cid` -
    Returns:
    Throws:
      `Exception`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### fileUpload

    FileInfo fileUpload(String topicId, String uuid, String filename, long size, jakarta.xml.ws.Holder<jakarta.activation.DataHandler> fileData) throws Exception, ru.bitel.bgbilling.common.BGMessageException
    было FileUpload("id","comment","filename","filedata","size")
    Parameters:
      `topicId` -
    Throws:
      `Exception`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### categoryMapForContract

    MapHolder<IdTitle,List<IdTitle>> categoryMapForContract(int contractId) throws Exception, ru.bitel.bgbilling.common.BGMessageException
    Throws:
      `Exception`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### topicCreate

    int[] topicCreate(Topic topic, Message message) throws Exception, ru.bitel.bgbilling.common.BGMessageException
    Throws:
      `Exception`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### topicGet

    Topic topicGet(int contractId, int topicId, boolean loadMessages) throws Exception, ru.bitel.bgbilling.common.BGMessageException
    Throws:
      `Exception`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### topicSearch

    SearchResult<Topic> topicSearch(int topicId, String title, String message, int status, String userSelect, boolean onlynew, boolean closed, Period period, Page page) throws Exception, ru.bitel.bgbilling.common.BGMessageException
    Throws:
      `Exception`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### topicList

    Result<Topic> topicList(int contractId, int id, Boolean history, Date dateFrom, Date dateTo, String title, String message, Page page) throws Exception, ru.bitel.bgbilling.common.BGMessageException
    Throws:
      `Exception`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### topicMarkReadByCustomer

    void topicMarkReadByCustomer(int contractId, int id) throws Exception
    Throws:
      `Exception`

  - ### topicUpdateState

    void topicUpdateState(int contractId, int id, boolean state) throws Exception
    Throws:
      `Exception`

  - ### messageUpdate

    int messageUpdate(Message message) throws Exception
    Throws:
      `Exception`

  - ### messagePrevId

    int messagePrevId(int topicId, int id) throws Exception
    Throws:
      `Exception`

  - ### messageNextId

    int messageNextId(int topicId, int id) throws Exception
    Throws:
      `Exception`

  - ### messageNewCount

    int messageNewCount() throws Exception, ru.bitel.bgbilling.common.BGMessageException
    Количество новых сообщений (всего)
    Returns:
    Throws:
      `Exception`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### topicStatusList

    List<IdTitle> topicStatusList() throws Exception, ru.bitel.bgbilling.common.BGMessageException
    Throws:
      `Exception`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### categoryList

    SearchResult<IdTitle> categoryList(Page page) throws Exception
    Throws:
      `Exception`

  - ### categoryUpdate

    void categoryUpdate(int categoryId, String title) throws Exception, ru.bitel.bgbilling.common.BGMessageException
    Throws:
      `Exception`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### categoryDelete

    void categoryDelete(int categoryId) throws Exception, ru.bitel.bgbilling.common.BGMessageException
    Throws:
      `Exception`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### categoryToGroupAdd

    void categoryToGroupAdd(int groupId, List<Integer> categoryIds) throws Exception, ru.bitel.bgbilling.common.BGMessageException
    Throws:
      `Exception`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### categoryToGroupDelete

    void categoryToGroupDelete(int groupId, List<Integer> categoryIds) throws Exception, ru.bitel.bgbilling.common.BGMessageException
    Throws:
      `Exception`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### categoryGroupList

    List<IdTitle> categoryGroupList() throws Exception, ru.bitel.bgbilling.common.BGMessageException
    Throws:
      `Exception`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### categoryGroupLinks

    HelpDeskLinks categoryGroupLinks(int groupId) throws Exception, ru.bitel.bgbilling.common.BGMessageException
    Throws:
      `Exception`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### subcategoryList

    SearchResult<IdTitle> subcategoryList(Page page) throws Exception
    Throws:
      `Exception`

  - ### subcategoryToCategoryAdd

    void subcategoryToCategoryAdd(int groupId, Set<Integer> categoriesIds, Set<Integer> subCategoriesIds) throws Exception, ru.bitel.bgbilling.common.BGMessageException
    Throws:
      `Exception`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### subcategoryToCategoryDelete

    void subcategoryToCategoryDelete(int groupId, Set<Integer> categoriesIds, Set<Integer> subCategoriesIds) throws Exception, ru.bitel.bgbilling.common.BGMessageException
    Throws:
      `Exception`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### categorySubcategoryIdsForGroup

    List<String> categorySubcategoryIdsForGroup(int contractId) throws Exception, ru.bitel.bgbilling.common.BGMessageException
    Throws:
      `Exception`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### managerList

    List<IdTitle> managerList() throws Exception, ru.bitel.bgbilling.common.BGMessageException
    Throws:
      `Exception`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### topicManagerChangeList

    List<ChangeManager> topicManagerChangeList(int topicId) throws Exception, ru.bitel.bgbilling.common.BGMessageException
    Throws:
      `Exception`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### topicManagerChange

    void topicManagerChange(int topicId, int managerId, String comment) throws Exception, ru.bitel.bgbilling.common.BGMessageException
    Throws:
      `Exception`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### topicStatusUpdate

    void topicStatusUpdate(int topicId, int status) throws Exception, ru.bitel.bgbilling.common.BGMessageException
    Throws:
      `Exception`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### topicStateUpdate

    void topicStateUpdate(int topicId, boolean state, boolean packageMode) throws Exception, ru.bitel.bgbilling.common.BGMessageException
    Throws:
      `Exception`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### topicAutocloseUpdate

    void topicAutocloseUpdate(int topicId, boolean autoclose) throws Exception, ru.bitel.bgbilling.common.BGMessageException
    Throws:
      `Exception`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### topicCategorySubcategoryUpdate

    void topicCategorySubcategoryUpdate(int topicId, int categoryId, int subcategoryId) throws Exception, ru.bitel.bgbilling.common.BGMessageException
    Throws:
      `Exception`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### topicBindSet

    void topicBindSet(int topicId, String userId) throws Exception, ru.bitel.bgbilling.common.BGMessageException
    привязка топика к какому то юзеру (или отвязка соответсвенно от всех или к текущему привязка)
    Throws:
      `Exception`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### topicPackageStateSet

    void topicPackageStateSet(int contractId, int topicId, Boolean include) throws Exception, ru.bitel.bgbilling.common.BGMessageException
    Throws:
      `Exception`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### messageCommentUpdate

    void messageCommentUpdate(int messageId, String comment) throws Exception, ru.bitel.bgbilling.common.BGMessageException
    Throws:
      `Exception`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### messageAdminReadSet

    void messageAdminReadSet(int messageId) throws Exception, ru.bitel.bgbilling.common.BGMessageException
    Throws:
      `Exception`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### contractModeGet

    ru.bitel.bgbilling.plugins.helpdesk.common.dto.ContractModeDTO contractModeGet(int contractId) throws Exception, ru.bitel.bgbilling.common.BGMessageException
    Throws:
      `Exception`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### contractModeUpdate

    void contractModeUpdate(int contractId, String currentModeId) throws Exception
    Throws:
      `Exception`

  - ### contractGroupUpdate

    void contractGroupUpdate(int contractId, int groupId) throws Exception
    Throws:
      `Exception`

  - ### getContractCurrentMode

    String getContractCurrentMode(int contractId) throws Exception, ru.bitel.bgbilling.common.BGMessageException
    Throws:
      `Exception`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### getModeList

    List<ru.bitel.bgbilling.common.model.KeyValue> getModeList() throws Exception, ru.bitel.bgbilling.common.BGMessageException
    Throws:
      `Exception`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### getParams

    MapHolder<String,String> getParams(int contractId) throws Exception, ru.bitel.bgbilling.common.BGMessageException
    Throws:
      `Exception`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### setParams

    void setParams(int contractId, MapHolder<String,String> properties) throws Exception, ru.bitel.bgbilling.common.BGMessageException
    Throws:
      `Exception`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### groupList

    SearchResult<IdTitle> groupList(boolean groupForDirectory, int contractId, Page page) throws Exception
    Throws:
      `Exception`

  - ### groupUpdate

    void groupUpdate(int groupId, String title) throws Exception, ru.bitel.bgbilling.common.BGMessageException
    Throws:
      `Exception`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### subcategoryUpdate

    void subcategoryUpdate(int subcategoryId, String title) throws Exception, ru.bitel.bgbilling.common.BGMessageException
    Throws:
      `Exception`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### subcategoryDelete

    void subcategoryDelete(int subcategoryId) throws Exception, ru.bitel.bgbilling.common.BGMessageException
    Throws:
      `Exception`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### messageGet

    Message messageGet(int contractId, int topicId, int messageId) throws Exception, ru.bitel.bgbilling.common.BGMessageException
    Throws:
      `Exception`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### searchTopicMessages

    SearchResult<Message> searchTopicMessages(int contractId, int topicId, String[] sort, Page page) throws Exception, ru.bitel.bgbilling.common.BGMessageException
    Throws:
      `Exception`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### getMessageFileList

    List<FileInfo> getMessageFileList(int messageId) throws Exception, ru.bitel.bgbilling.common.BGMessageException
    Throws:
      `Exception`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### packageList

    SearchResult<Package> packageList(Boolean status, Page page) throws Exception, ru.bitel.bgbilling.common.BGMessageException
    Throws:
      `Exception`
      `ru.bitel.bgbilling.common.BGMessageException`