Home
Set Up Application Modules
Set up the application modules that are displayed in Ellucian GO.
Registration Module
The Registration module allows students to use their device to register for course sections.
Specify Banner registration messages
Specify the types of course section registration error messages displayed to the mobile user.

Implementation Guide, May 2023, Release 5.6.3
This online help contains comprehensive information about how to install, set up, and maintain Ellucian Mobile.
Ellucian Mobile Overview
Ellucian Mobile, powered by Ellucian Ethos, provides faculty, prospects, students, staff, and other constituents with access to key campus information and services from their mobile devices. This section provides an overview of Ellucian Mobile.
Before You Begin
This section describes some advance preparations that you can make to help your Ellucian Mobile setup process to go as smoothly as possible.
Install Supporting Software
Before you can install the Ellucian Mobile components, there are several prerequisite software components that must be installed. Note that Grails is also required, but does not need to be installed separately because all Grails components that you need are included in the WAR file that you install later.
Install Ellucian Mobile Software
Install the Ellucian Mobile WAR file and perform basic configuration steps.
Set up the Mobile Cloud Configuration System
Set up the Ellucian Mobile Cloud Configuration System. Description of the process for signing from the Ellucian Hub, how to create and enter the configuration settings, and how to specify the SIS credentials.
Manage Users and User Permissions for the Mobile Cloud Configuration System
You can give selected people access to modify specific elements of your mobile configurations, such as user management, configuration management, branding, or sending push notifications.
Customize the Appearance of Ellucian GO
Set up the home screen, select background and text colors, and set up the About screen.
Set Up Location-Aware Features
Set up Ellucian Mobile features that are location-aware; that is, based on proximity to a beacon.
Set Up Application Modules
Set up the application modules that are displayed in Ellucian GO.
- Add an Ellucian module and specify standard settings
  Use this procedure to add an Ellucian application module to Ellucian Mobile and specify the standard settings that apply to all modules. You will also need to specify module-specific settings for most modules.
- Organize the module list
  To help users find the modules that appear in the menu on their devices, you can divide the list into sections and put the sections and modules in any order. The module list in the Cloud Configuration tool reflects the way that sections and modules appear on the devices.
- Audio Module
  Use the Audio module to make audio clips available to users. For example, you can publish an audio clip that contains a message from the school president or your institution's fight song, with or without a static background image.
- Courses Module
  The Courses module allows students and faculty to view information about the courses that they are taking or teaching.
- Directory Module
  The Directory module allows users to search for people at your institution and get contact information for them. You can limit the search to certain groups of people, such as Students and Faculty. You can also control the contact information that is displayed for each person.
- Events Module
  The Events module allows users to view upcoming events on your institution's calendars.
- Feeds Module
  The Feeds module allows users to view news feeds from your institution. Users can view the full text and photos of the news items and share the items with other people. Your institution can have one Feeds module or multiple Feeds modules that focus on different categories of news.
- Grades Module
  The Grades module allows students to view midterm or final grades for all terms that have grades recorded in your information system. (The current term will not appear until midterm grades have been entered.) Users must be signed in to view their grades.
- ILP Module
  Colleague and Banner institutions that use the Ellucian Intelligent Learning Platform (ILP) can make information from supported learning management systems available to students through Ellucian Mobile. With ILP, students can view class assignments, events, and activities on their devices.
- Important Numbers Module
  The Important Numbers module provides users with a directory of important phone numbers and other contact information that you select.
- Maps Module
  The Maps module allows users to view maps of your campuses and get directions. Campus buildings are marked with pins, which users can tap for more information about the building.
- Native App Launcher Module
  Mobile Administrators can add a module that launches a third-party native application from within Ellucian GO on iOS and Android.
- Notifications Module
  The Notifications module allows users to view important messages from your institution.
- Registration Module
  The Registration module allows students to use their device to register for course sections.
  - Configure the Registration module
    Configure one or more Registration application modules at your institution.
  - Specify Banner registration messages
    Specify the types of course section registration error messages displayed to the mobile user.
  - Modify caching for improved registration performance
    Modify caching and memory settings to improve registration performance.
- Student Financials Module
  The Student Financials module provides students with their overall balance and the most recent payment transaction information, with an optional link to a payment gateway or additional account information.
- Video Module
  Use the Video module to make video clips available to users. For example, you might have a video to promote a new academic program or an upcoming fine arts event.
- Web Module
  You can make any web application available as a menu item in Ellucian Mobile. The web applications should be optimized for use on mobile devices, and must be stored on a publicly available URL.
- Partner Modules
  You can add a module in Ellucian Mobile that launches the app of an Ellucian partner from within Ellucian GO. The partner app can be either a native mobile app or web application.
Test and Publish a Configuration
To view your configuration on a device, you must place the configuration into test status. When you are ready to make your configuration available in the public list of institutions on Ellucian GO, you publish the configuration.
Analyze Usage
The Google Analytics Platform lets you measure user interactions across various devices and environments. You can use Google Analytics to view detailed usage statistics of your school's Ellucian Mobile implementation.
Manage Configurations
In addition to the ability to add a new configuration manually, you can create a new configuration by copying an existing one, export configuration information, import configuration information, and migrate a configuration to a different database.
Set up multiple Mobile Integration Server Web Service Apps
If you want to have multiple active configurations at the same time, you need to set up multiple Mobile Integration Server web service apps.
Set up Load Balancing and Redundancy
Multiple Mobile Integration Servers can be set up for a single configuration. This can be done to scale the solution to support more mobile users, or for redundancy. Deployment of multiple Mobile Servers requires a shared data storage using either a Microsoft SQL Server or an Oracle database.
Ellucian Mobile on Wearable Devices
Users can view push notifications on their Android Wear and Apple Watch devices. Users with Apple Watches can also view ILP assignments and maps.
Debugging
Send detailed information from Ellucian Mobile to the log file to support troubleshooting.
Appendices

Specify Banner registration messages

Specify the types of course section registration error messages displayed to the mobile user.

About this task

Note: You can skip this procedure if you want to accept the default: Only course section registration error messages with an errorFlag of F (Fatal) are displayed to mobile users.

If a mobile user attempts to register for a Banner course section and there is an issue with the registration, the Banner Student API will return a message to Ellucian Mobile. This could indicate an error that would prevent registration or an issue that would not prevent registration but that might make registration inadvisable.

Each message (crnError) includes an errorFlag attribute which could be F (Fatal) or W (Warning). By default, only fatal error messages are sent from the mobile server to the mobile device. Warnings are generally intended for an administrator who is registering a student. However, you might want to display both fatal errors and warnings to mobile users. To change the types of error messages sent to mobile users, edit your banner-mobileserver-config.groovy file as described below.

Procedure

Open your banner-mobileserver-config.groovy file in an editor.
Add the following section anywhere in the file.

/*Registration options*/

ellucian.student.registration.banner.crnErrorFlagsToEmit = "F"

Note: The default value of "F" provides the same behavior as if this section was not in the banner-mobileserver-config.groovy file.
To change the course section registration error messages displayed to the mobile user, change ellucian.student.registration.banner.crnErrorFlagsToEmit to include all desired values, separated by commas.
For example, if you want mobile users to see error messages (crnErrors) with errorFlag values of both F (Fatal) and W (Warning), set ellucian.student.registration.banner.crnErrorFlagsToEmit to "F,W".
Save your changes to the banner-mobileserver-config.groovy file.
Restart Tomcat to apply the changes.