The Nuxeo mobile application lets you access content stored in Nuxeo Platform servers on your phone. It provides a seamless experience on essential features such as searching, browsing and managing favorite documents. Available for iOS and Android.
Requirements
iPhone
The Nuxeo mobile application is available for iPhones SE, 5/5c/5s, 6/6+, 7/7+, 8/8+ and X with a minimum version of iOS 8 required.
Android
The minimum required version of Android 4.4.
Nuxeo Platform
Nuxeo Platform Versions
The Nuxeo mobile application is compliant with all Nuxeo Platform versions as of LTS 2015 HF12.
See the Limitations section for previous hotfixes of Nuxeo Platform LTS 2015.
OAuth 2 Configuration
Since Nuxeo Platform 9.2, the Nuxeo mobile application uses an OAuth 2 flow to authorize against the platform. If not already done, you need to register an OAuth 2 client on your Nuxeo Platform with the following attributes:
- Name: Nuxeo Mobile
- Client Id:
nuxeo-mobile - Redirect URIs:
nuxeo://authorize
Installation
The Nuxeo iOS application can be installed from the Apple Store.
The Nuxeo Android application can be installed from Google Play.
Functional Overview
The Nuxeo application allows you to authenticate against a Nuxeo server, browse and search the Nuxeo repository. In addition, you can manage your favorite documents and access your shared/personal collections. Finally, you can start and process workflows tasks on your assets. All features listed below are available using the side ("burger") menu.
Authenticating
Once the application is installed and opened, indicate the Nuxeo server you want to connect to by filling the HTTP information. For example http://NUXEO_SERVER/nuxeo. As soon as the server is detected, the login page is displayed. Depending on your server configuration, it is the default one or your customized login page providing authentication through CAS, OpenID or another authentication system.
|
|
Browsing Content
The Browse menu enables you to browse your documents. The thumbnail of the document is displayed whenever it's available, just like on the regular web user interface (see the Limitations section). Otherwise an icon is displayed. Tap to enter the workspace or see the document. Actions on documents are available by taping the overflow button:
- Share
- Add to/Remove from favorites
- Add to Collections
- Start Process
|
|
For any non folderish document, such as notes and files typically, some information is displayed on the view layout:
- The document thumbnail if available or the preview of content for notes
- The filename and size of the attached file if any
- The creation date, creator username, version, state and list of contributors
If the PDF preview is available, tap the thumbnail zone to preview it. If the document is a text document with several pages, you can navigate through it.
|
|
|
Browsing documents can be made with list view or grid view, allowing to better preview thumbnails. Finally, folder or collection content, as well as search results can be sorted by alphabetical order ('title') or modification date.
|
|
Search
The Search menu enables you to query documents on their title and content, by performing a full-text search. A list of matching documents is provided and you can directly have access them. Once on a document, tap the back icon to go back to search results.
Favorites
You are able to mark as favorite the list of documents you are interested in. "Add to" and "Remove from" favorites actions are available for all document types whether the document is folderish or not. Select the "..." action available on the toolbar. Favorite documents are available directly from the Favorites menu.
|
|
|
Recently Viewed
The Recently Viewed entry displays the last 20 documents viewed on your Nuxeo Mobile application. From this entry you can tap on a document to enter a workspace or display the document. Actions on documents are available by sliding to share, add to your favorites or add a document to a collections.
Collections
The dedicated menu entry enables you to directly access collections: Shared and Personal. Personal collections have been created by yourself and Shared collections are collections where you have been granted at least read permissions.
Browsing your repository, you can add a document to one or several collections. Once you have selected the list of collections, you can view them and uncheck some.
|
|
|
Capture of Documents
Documents such as images, videos, attachments can be shared to Nuxeo. On iOS, from the Share menu associated with a document, add the Nuxeo share destination. On android, the share extension is activated by default.
|
|
|
When capturing a document in Nuxeo, the user can select her personal space (set by default) or browse folders to select the destination.
|
|
|
Workflows
All Nuxeo documents evolve according to defined lifecycle. See workflows documentation for more details. On mobile, default serial and parallel workflows are implemented.
On documents, document lists or collections, access the contextual menu by clicking the overflow button and click on Start Process to choose the workflow type. When consulting a document with a task to process, a banner (black in the screenshot below) allows a direct access to the task screen.
|
|
|
The dedicated Tasks entry enables you to directly access the user tasks and process them. A definition of the task, as well as the deadline, participants and document link is displayed. Once mandatory fields are filled, the user can process it (approval, rejection, or any other action defined in this task).
|
|
|
Share / Open in
You are able to share any document through messages, mail, Slack, Twitter, Facebook.... any available application on your phone for that purpose. The Share button is available on the toolbar of the document view, next to the filename.
In addition, you are able to Open directly documents on your phone by downloading them first and then choose the action that you want. To do so click on the Download button below the thumbnail view.
|
|
Personal Workspace
The personal workspace menu gives you a direct access to your collections and personal documents.
Offline Mode
When your phone loses network connection or when you turn it on airplane mode, an offline banner is displayed. However, assets aren't loaded nor accessible without connection.
|
|
Limitations
Nuxeo Platform LTS 2015 with Hotfix 12
Yet there are two limitations when running against Nuxeo LTS 2015 with hotfix 12, aka. Nuxeo 7.10-HF12:
- It is not possible to mark a document as Favorite from the mobile app but you can have access to documents marked as favorites from the web UI.
Preview isn't available for the Picture and Video document types nor for the File type with PDF content. A simple file icon is displayed instead. To allow previewing these types of documents you can add the following XML contribution to your Nuxeo instance:
<?xml version="1.0"?> <component name="com.my.company.authChainContrib"> <require>org.nuxeo.ecm.platform.ui.web.auth.WebEngineConfig</require> <extension target="org.nuxeo.ecm.platform.ui.web.auth.service.PluggableAuthenticationService" point="chain"> <authenticationChain> <plugins> <plugin>BASIC_AUTH</plugin> <plugin>TOKEN_AUTH</plugin> <plugin>FORM_AUTH</plugin> <plugin>WEBENGINE_FORM_AUTH</plugin> <plugin>ANONYMOUS_AUTH</plugin> <plugin>WEBSERVICES_AUTH</plugin> </plugins> </authenticationChain> </extension> </component>
Nuxeo Platform LTS 2015 until Hotfix 11 Included
If you run the mobile application against a Nuxeo Platform LTS 2015 instance with hotfixes inferior to HF12 installed, it works but in degraded mode:
- Authentication: Only basic default authentication is available.
- Browsing:
- No thumbnails are available in the document listing.
- No preview is available except for Note documents.