3.5.4. Сервисы

AS.SERVICES

Функции проигрывателя форм, которые можно использовать или переопределять при разработке приложений.

Подсказка

При разработке мобильного приложения, которое использует проигрыватель форм, хорошей практикой будет заменить вызов стандартных диалогов на нативные.

Предупреждение

При переопределении данных функций будет переопределено базовое поведение приложения, всех соответствующих компонентов. Например, переопределение showDepartmentChooserDialog() заменит диалог у всех компонентов выбора подразделения на форме.

AS.showDatePicker(value, anchor, input, callback)

Показать компонент выбора даты

Аргументы:
  • value (Date) – дата, которая будет отмечена как выбранная
  • anchor (HTMLElement) – якорный компонент, к которому следует привязать компонент выбора даты
  • input (HTMLElement) – компонент, которому будет передан фокус ввода после выбора даты
  • callback (Function) – функция обратного вызова. В функцию будет передан один параметр - выбранная дата, тип Date

Пример использования AS.SERVICES.showDatePicker

showDepartmentChooserDialog(values, multiSelectable, filterUserID, filterPositionID, filterDepartmentID, filterChildDepartmentID, locale, handler)

Показать стандартный диалог выбора подразделения

Аргументы:
  • values (Array) –

    список выбранных элементов, каждый элемент имет следующую структуру

    {
    departmentId: "идентификатор подразделения",         // обязательное поле
    departmentName: "название подразделения",            // обязательное поле
    parentName: "название подразделения, которому принадлежит должность",
    hasChildren: "имеются ли дочерние подразделения",
    status: "текст статуса",
    statusColor: "цвет статуса"
}
  • multiSelectable (boolean) – позволять множественный выбор
  • filterUserID (String) – идентификатор пользователя для фильтрации элементов
  • filterPositionID (String) – идентификатор должности для фильтрации элементов
  • filterDepartmentID (String) – идентификатор подразделения для фильтрации элементов
  • filterChildDepartmentID (String) – идентификатор дочернего подразделения для фильтрации элементов
  • locale (String) – локаль диалога
  • handler (Function) – функция обратного вызова, в которую будет передан массив выбранных элементов, в таком же формате как и передается в метод
showDropDown(values, anchor, minWidth, callback)

Показать всплывающее окно с выбором элементов

Аргументы:
  • values (Array) –

    массив элементов списка, каждый элемент имет следующую структуру

    {
    value: "значение",
    title: "подпись",
    selected: true
}
  • anchor (HTMLElement) – якорный компонент, к которому следует привязать всплывающее окно
  • minWidth (Number) – минимальная ширина всплывающего окна (если не задано, то ширина будет высчитываться исходя из едемента anchor)
  • callback (Function) – функция обратного вызова, в которую будет передано выбранное значение String

Пример использования AS.SERVICES.showDropDown

showPositionChooserDialog(values, multiSelect, filterUserId, filterDepartmentId, showVacant, locale, handler)

Показать стандартный диалог выбора должности

Аргументы:
  • values (Object) –

    список выбранных элементов

    {
    elementID: "идентификатор должности",            //обязательный элемент
    elementName: "название должности",               //обязательный элемент
    departmentName: "название подразделения, которому принадлежит должность",
    status: "текст статуса",
    statusColor: "цвет статуса"
}
  • multiSelect (boolean) – позволять множественный выбор
  • filterUserId (String) – идентификатор пользователя для фильтрации элементов
  • filterDepartmentId (String) – идентификатор подразделения для фильтрации элементов
  • showVacant (boolean) – отобразить только вакантные должности
  • locale (String) – локаль диалога
  • handler (Function) – функция обратного вызова, в которую будет передан массив выбранных элементов, в таком же формате как и передается в метод
showProjectLinkDialog(handler)

Показать стандартный диалог выбора портфеля/проекта

Аргументы:
  • handler (Function) –

    функция обратного вызова, в которую будет передано единственное значение

    {
    actionID: "идентификатор проекта",
    name: "название",
    elementType: Number,   // 256 - план, 128 - портфель
}
showRegisterLinkDialog(registry, handler)

Показать стандартный диалог выбора записи реестра

Аргументы:
  • registry (Object) – реестр, объект результат вызова апи rest/api/registry/info
  • handler (Function) – Функция обратного вызова, в которую будет передан идентификатор выбранного документа
showUserChooserDialog(values, multiSelectable, isGroupSelectable, showWithoutPosition, filterPositionID, filterDepartmentID, locale, handler)

Показать стандартный диалог выбора пользователя

Аргументы:
  • values (Object) –

    список выбранных элементов, имеющих следующую структуру

    {
    personID: "идентификатор пользователя",      // обязательное поле
    personName: "название пользователя",         // обязательное поле
    positionName: "название должности пользователя (если существует)",
    customFields: {
        calendarColor: "цвет статуса",
        calendarStatusLabel: "текст статуса"
    }
}
  • multiSelectable (boolean) – позволять множественный выбор
  • isGroupSelectable (boolean) – позволять выбирать группы
  • showWithoutPosition (boolean) – отобразить не назначенных на должность
  • filterPositionID (String) – идентификатор должности для фильтрации элементов
  • filterDepartmentID (String) – идентификатор подразделения для фильтрации элементов
  • locale (String) – локаль диалога
  • handler (Function) – Функция обратного вызова, в которую будет передан массив элементов, имеюущих ту же структуру что и поле values
showWaitWindow()

Показать окно ожидания

Предупреждение

Если приложение запущено внутри Synergy (например ВМК), то при вызове данного метода будет показано стандартное окно ожидания окно-ожидания

В противном случае метод необходимо реализовать самостоятельно!

Пример использования AS.SERVICES.showWaitWindow/hideWaitWindow

hideWaitWindow()

Скрыть окно ожидания

Пример использования AS.SERVICES.showWaitWindow/hideWaitWindow

unAuthorized()

Функция, которая будет вызвана в случае неуспешной авторизации при вызове методов REST API Synergy.

Приложения могут использовать данный метод для реализации обработки случаев некорректного ввода логина или пароля пользователя.

Пример использования AS.SERVICES.unAuthorized