After the initial installation, users use the App Manager to create and manage the institution's app (or all of the institution's apps, if you have multiple apps).
Ex Libris will give you the URL (App Manager URL) and your initial administrator login credentials for the App Manager. The App Manager can be accessed using any modern browser.
Logging In and Out of the App Manager UI
To log in to the App Manager:
Navigate to the App Manager URL. The App Manager Login page appears.
App Manager Login Page
Enter your login credentials and select the arrow or press Enter on your keyboard. After a successful login, the App Manager Home Page appears. If you forget your password and there are no other administrators to change it for you, contact Ex Libris customer support for assistance.
App Manager Home Page
Most of the common elements and procedures of the UI are explained below.
The Home Page contains a number of configuration modules presented as icons (App Builder, App Settings, and so forth), as well as a user menu (which appears when you select your user name in the top right corner) and an app environment menu (which appears when you select the app name in the top right corner).
This document presents the navigation steps to open an App Manager page as a highlighted path. For example, to open the Profile Config pane within the App Builder, this document indicates for you to navigate to App Builder > Profile Config. This often (but not always) corresponds to the breadcrumbs trail that appears at the top of the page.
Changing Your Password
To change your password:
Select Change Password in the user menu. The Password Change page appears.
Password Change Page
Enter your old password and new password, verify your new password, and select Change my password. Your password is changed.
Logging Out of the App Manager
To log out of the App Manager, select Log out in the user menu. You are logged out and the Login Page reappears.
If you do not perform any activity for twenty minutes, you are automatically logged out of the App Manager.
Switching App Environments
The App Manager enables you to work only on one app at a time. The app you are working on depends on you app environment.
To switch app environments, select a new one from the app environment menu. To locate a specific app environment in the menu, you can enter part of the app name in the search box at the top of the menu. Your current app environment does not appear in the list.
App Environments List
You cannot switch app environments when a specific record is selected in the App Manager. You must exit the record to switch app environments.
Record Selected in the App Manager
Working with Lists
Some screens contain lists of records.
Email Template Record List
- A count of the total number of records appears at the bottom of the list.
- Search: For some lists, you can enter part of a record name in the search box at the top of the list and select Search to filter the list.
When noted, you can also filter the list by selecting a record type on the right side of the list.
- View/Edit: Select a record in the list to view and/or edit it.
- Add: When available, you can add a new record by selecting Add xxx. In some cases, only certain basic fields are available when adding a record. In these cases, after editing the record, you may want to edit the record to configure any additional fields.
- Save: When adding or editing a record, an asterisk * before a field indicates a mandatory field. Several types of save buttons may be available. Select any one of the buttons to save your changes (note that you cannot enter Ctrl + S to save). After saving your changes, the next page that appears depends on the button that you selected:
After saving changes, if the changes affect the app in a visible way, the end-user sees the changes if they log out and in to the app or switch profiles. You can force these changes to appear immediately to the end-user by publishing the app. See Publishing Apps.To exit a record without saving your changes, simply navigate to any other page in the App Manager.
- Save – Display the list of records.
- Save and add another – Display the add record page.
- Save and continue editing – Display the edit page for the record.
- Delete: To delete a single record, select Delete from within the record, and select Yes, I'm sure in the confirmation dialog box. To NOT confirm a deletion, select anywhere in the breadcrumb trail to navigate away from the page.
To delete multiple records, select the records in the list of records, select Delete selected xxx from the Action menu, and select Yes, I'm sure in the confirmation dialog box. Note that this is not possible for some lists of records, for example profiles.
- View History: Select History within a record to view the change history for that record. The change history includes a timestamp for each change, the ID of the user that made the change, and the action that occurred. It is not possible to roll back changes. The change history is for auditing purposes.
Working with the Text Editor
The text editor appears in several locations. The text editor toolbar contains several icons, some of which appear regardless of the module you are currently using. These icons are described below.
Text Editor Toolbar
|Maximize||View fullscreen, with the toolbar attached to the main toolbars. You must exit this mode to save the record or modify any other fields.|
|View Source||Edit the HTML source of the text. You must exit this mode to save the page.|
|Numbered or Bulleted List||Create a numbered or bullet list.|
|Link/Unlink||Insert or remove a hyperlink at the cursor. Select Link to display a dialog box to select the link type. The dialog box contains multiple tabs, depending on what you select for Link Type.
On the Link Info tab, select one of the following for Link Type:
|Image||Insert an image. You must first upload the image to the Asset Manager; see Uploading Files.
After inserting the link to the image, to edit the image, select the image and select Image again.
To delete the image, select the image, and press the Delete key.
When uploading or editing the image, the following options are available:
Select OK to add the image, or select Cancel to return to the text editor without adding the image.
|Insert Horizontal Line||Add a horizontal line.|
|Insert Special Character||Insert a special character. Select a special character from the pane to insert it into the text area.|
|Format Text||Format selected text in bold, italics, or underlined.|
|Style Text||Apply style types to the selected text.|
|Format Paragraph||Format paragraph.|
|Text Color||Apply color to selected text.|
|/||Hide/Display Toolbar||Hide/display the toolbar. The toolbar is redisplayed if you re-access the page.|
Working with the App Builder
The App Builder module (App Builder) is used to configure the look and feel of services, as well as to enable or disable services by profile/app role and to reposition the services in the app. See Configuring Services.
The App Builder presents a unique user interface.
App Builder User Interface
- The Device Display Pane presents a simulation of how the app would appear for a specific device. orientation, profile, and list of app roles. Select the refresh button on the lower right corner of this pane to refresh the view. You can drag and drop services in this pane to change the location in the app for the end-user.
- Use the Device Selection Menu and orientation toggle button to view the app as it would appear on various different devices and orientations. For more information, see Viewing Service Positions by Device Type and Orientation. The height and width (in pixels) of the current display size appears beside the orientation toggle button.
- Use the Profile and Role Selection Menus to view the app as it would appear to end-users who have enabled various different profiles and/or app roles.
- Use the Configuration Tabs to configure the look and feel or specific services, as well as the app roles that can view each service. In addition, you can configure the default look and feel for all services for each profile, as well as the default look and feel for all profiles (for the entire app). Any service property not defined for a specific service inherits the property value from the profile default. Any service property not defined for a service or a profile inherits its value from the app default.
- When working on a specific service, an additional configuration tab for that service appears in the Configuration Tabs. The service is highlighted in the Device Display Pane and all other services are blurred.
- After making any changes in the App Builder, select Save & Publish at the bottom of the Configuration Tabs, and again in the confirmation dialog box, to publish your changes. These changes are immediately available to end-users, even if the end-users are already logged into the app. To discard all changes, navigate to some other area of the App Manager. Select Leave in the confirmation dialog box to confirm losing your changes.
Working with Static Content and the Content Menu
The Content Menu (App Settings > Content > Content) presents a menu of your static content services (also known as pocket guides) and other static app contents.
See Creative Studio for an alternate method of creating and configuring static content services.
There are two types of nodes in these menus:
- Menu nodes – Contain sub-nodes that are either other menu nodes or section nodes.
- Section nodes – Either contain contents or act as redirects to other services.
The menu is divided into three areas:
- Menu Options – Static content services that appear in the main area of the app. These nodes are created, deleted, and customized in the App Builder. You cannot add or delete static content services from this menu. See Creating Services and Deleting Services.
Top level nodes in the Menu Options area are menu nodes. If there are no sub-nodes, the static content service behaves exactly like a basic service: if a redirect is configured for the service, tapping the static content service tile opens the target link. The same thing happens if there is a single sub-node that is a redirect.Otherwise, if there is a single sub-node with static content, the app displays the content. If there is more than one sub-node, the app displays a menu with the sub-nodes as menu options. When the end-user selects a menu option, the app opens the sub-node (either another menu, the content of the node, or the end-user is redirected).
- About – Static content that appears when the end-user selects About (or the device-specific equivalent option) in the app. These nodes are used when configuring a profile.
Top level nodes in the About area are either menu nodes or section nodes. The About menu option functions as a menu node (that cannot be deleted).
- Intro to App – Static content used in other areas of the app, such as a splash screen. These nodes are used when configuring a profile.
Top level nodes in the Intro to App Section area are iPad Intro, iPhone Intro, and Android Intro. These nodes cannot be deleted.
After making changes, the end-user sees the changes if he or she logs out and in to the app or switches profiles. You can force these changes to appear immediately to end-users by publishing the app. See Publishing Apps.
To create a new node:
- Select a menu node and select Create Node. A pane to create a new node appears.
Create New Node
- In Menu description, enter a name for the new node.
- In Type, select Menu or Section. If you select Menu, select Save to save the node and finish the process.
- Otherwise, in Section Type, select page to add static contents or redirect to create a redirect. Additional fields appear depending on your selection.
- If you are creating a redirect, in Url enter the redirect URL and select Save to save the node and finish the process. See Working with App URLs.
Otherwise, enter the static content in the Content field. This field is a simple WYSIWYG HTML editor, enabling you to easily add bold, italics, links, four levels of headings, images, bulleted and numbered lists, and block quotes. Select the second-to-last (second from the right) icon to view/edit the HTML source. The source editor has a number of features, including automatically adding closing tags when you enter open tags and marking errors in the HTML code with red X's on the left of the line numbers. Select the right-most icon to edit full screen.Content Menu - Edit Static Content
- In CSS stylesheet, select Browse to attach a local CSS style sheet that you have previously uploaded to the Asset Manager; see Uploading Files. The local CSS style sheet overrides any settings in the global CSS style sheet (see Configuring the Global CSS Style Sheet), which campusM also applies to your contents.
- When you are done, select Save.
You can drag and drop section nodes in the content menu.
To edit a node:
Select the node in the menu, make any changes, and select Save.
To delete a node:
You can hide content without deleting it by selecting Hidden > Yes when editing the content.
To delete the content, select the node in the menu, select Delete Selected Node, and confirm in the confirmation dialog screen. The selected node and all of its children are deleted. Note that there is no way to undo this.
Options in the UI
See the following sections for information about the top options in the campusM pages.
The options on this page are:
- App Settings
- General Settings – See Configuring App Name and Icons.
- Email Templates – See Configuring App Emails.
- Integration Profiles – See Configuring Integration Profiles.
- Profile Registration Authentication – See Configuring End-User Authentication Types.
- Person Roles – See Enabling/Disabling App Roles for End-Users.
- Web App Icons – See Configuring App Name and Icons.
- Biometric Identification – See Configuring Biometric Identification.
- App Directory
- Customer Web Services
- Enterprise Roles
- iOS Splash Pages
- Problem Page Categories – See Configuring Problem Feedback Categories.
- Problem App Categories – See Configuring Problem Feedback Categories.
- Contact Email Addresses – See Configuring Email Addresses to Receive Feedback.
- Feedback – See Viewing Feedback.
- Problems – See Viewing Feedback.
- Ideas – See Viewing Feedback.
The options on this page are:
- AEK Documentation – See Application Extension Kit (AEK) and Connect Layer Extension Kit (CLEK).
- App Extension Kit
- AEK Publishing – See Publishing the App.
The options on this page are:
- Notification Actions
- Send Individual Notification – See Sending Notifications to End-Users.
- Send Group Notification – See Sending Notifications to End-Users.
- Manage Notification Groups – See Configuring Notification Groups.
- Push Service Settings – TBD
- other actions on this page – See Viewing Sent Notifications and Resending Notifications.
See Uploading Files.
See Product Integrations.
Help and Support Menu
Click the question mark icon at the top right of any page in the App Manager to display the Help and Support Menu. The following options are available:
- Help for this page – display online help documentation for the page you are viewing. (Only available for select pages).
- Browse Online Help – display campusM App Manager documentation
- Raise a Ticket – open a Salesforce Support Ticket
- Release Schedule – display the campusM monthly release schedule
- The current release notes