Функции js, доступные для вызова из dom-модели главной страницы (jsni-функции) в Showcase

Материал из Course Orchestra
Перейти к: навигация, поиск
Showcase

Создание решений на КУРС:Showcase

Также с помощью js функций, определенных внутри главной страницы Showcase, можно вызывать ряд предопределенных JS функций, в частности:

  • для получения текущего пользователя - getCurrentUserNameFeedbackJSNIFunction();
  • для получения полного имени текущего пользователя - getCurrentUserFullNameFeedbackJSNIFunction();
  • для получения email текущего пользователя - getCurrentUserEMailFeedbackJSNIFunction();
  • для получения SID текущего пользователя - getCurrentUserSIDFeedbackJSNIFunction();
  • для получения телефона текущего пользователя - getCurrentUserPhoneFeedbackJSNIFunction();
  • для вызова окна About - showAboutFeedbackJSNIFunction();
  • для получения SessionContext который был на момент открытия главной страницы - getStartingAppSessionContextFeedbackJSNIFunction();

Данные функции можно использовать например для вывода некой информации о сессии и имени пользователя в header и footer.

Также с помощью js функции на клиенте в Showcase может быть вызвано модальное окно в который может быть помещен текст в формате html:

  showModalWindowWithHTMLContent(caption, textHTML, showCloseButton, windowWidth, windowHeight)

где caption - заголовок окна (String), textHTML - HTML, который будет отображаться внутри окна (String), showCloseButton - параметр определяющий будет ли показываться кнопка "Закрыть" (Boolean), windowWidth - параметр определяющий ширину html области окна (Integer), windowHeight - параметр определяющий высоту html области окна (Integer).

Также с помощью js функций на клиенте в Showcase можно вызывать сообщения наподобие стандартных диалоговых окон: тех же, что выдаются при вызове context.message(), context.warning(), context.error() в скриптах Celesta. Это 3 функции:

  showInfoMessageWindow(caption, message)
  showWarningMessageWindow(caption, message)
  showErrorMessageWindow(caption, message)

где caption - заголовок окна (String), message- текст, который будет отображаться внутри окна сообщения (String).

И caption, message - это локализованные строки, которые могут быть переведены на другой язык с помощью Gettext.

Кастомизация страницы about.jsp

Для гибкости кастомизации страницы about.jsp, начиная с версии 5.0.0 Showcase, появилась возможность выводить информацию на страницу "О программе" (например, версию юзердаты и прочие значения, связанные с текущей перспективой), возвращаемую клиентской javascript-функцией.

Для этого необходимо добавить функцию с именем addAdditionalAboutInfo() в файл solution.js перспективы. Пример:

function addAdditionalAboutInfo()
 {//Instead of "Hello, World!" you could place a text that would be printed in window "О программе" 
   return "Hello, World!"; 
 }

Данная функция должна возвращать текст, который будет вставлен в нижнюю часть окна "О программе".

Изменяя функцию addAdditionalAboutInfo() на уровне перспективы в папке пользовательских данных можно выводить дополнительную информацию пользователю, связанную с текущим решением (версия оборудования, решения и т.д.).