Client Applications

Nuxeo Mobile

Updated: March 18, 2024

The Nuxeo Mobile application is deprecated.

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.

Mobile Menu
Mobile 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.

Mobile Connection
Mobile Connection
Mobile Login Page
Mobile Login Page

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:

Mobile Actions Overflow
Mobile Actions Overflow
Mobile Actions Overflow Menu
Mobile Actions Overflow Menu

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.

Mobile Browse
Mobile Browse
Mobile Document View
Mobile Document View
Mobile Document Preview
Mobile Document Preview

When previewing a document, you can hide the top bar by taping the screen.

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.

Mobile Browse Grid
Mobile Browse Grid
Mobile Browse Sort
Mobile Browse Sort

Tapping a sort order twice switches between ascendant and descendant sort order

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.

Mobile Search
Mobile Search

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.

Mobile Favorites
Mobile Favorites
Mobile Add Favorite
Mobile Add Favorite
Mobile Remove Favorite
Mobile Remove Favorite

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.

Mobile Recently Viewed
Mobile Recently Viewed

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.

Mobile Collections
Mobile Collections
Mobile Collections JPG
Mobile Collections JPG
Mobile Collections Added
Mobile Collections Added

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.

Mobile Capture Add Nuxeo
Mobile Capture Add Nuxeo
Mobile Capture Share Photo
Mobile Capture Share Photo
Mobile Capture Share Photo Android
Mobile Capture Share Photo Android

When capturing a document in Nuxeo, the user can select her personal space (set by default) or browse folders to select the destination.

Mobile Capture Folder Selection
Mobile Capture Folder Selection
Mobile Capture Folder Done
Mobile Capture Folder Done
Mobile Capture Done
Mobile Capture Done

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).

Mobile Workflow Start Process
Mobile Workflow Start Process
Mobile Worfklow Task View
Mobile Worfklow Task View
Mobile Workflow Approve Reject
Mobile Workflow Approve Reject

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.

Mobile Share Action
Mobile Share Action

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.

Mobile Open in Download
Mobile Open in Download
Mobile Open Action
Mobile Open Action

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.

Mobile Offline Mode
Mobile Offline Mode
Mobile Offline Mode Refresh
Mobile Offline Mode Refresh

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.