Client Applications

Nuxeo Mobile

Updated: October 9, 2018 Page Information Edit on GitHub

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 Requirements

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 Requirements

The minimum required version of Android 4.4.

Nuxeo Platform Requirements

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:

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.

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.

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.

Full-text search follows the criteria below:

  • Based on stemming
  • With AND operator (all words must be in the document)
  • Searching on the title, the description and the content (text of a note, content of the main attachment of a file)

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.
10 days ago manonlumeau Move drive and mobile doc to static
2 years ago Solen Guitter 26
2 years ago Anne Jubert 25
2 years ago Anne Jubert 24
2 years ago Anne Jubert 23
2 years ago Anne Jubert 22
2 years ago Anne Jubert 21
2 years ago Anne Jubert 20
2 years ago Anne Jubert 19
2 years ago Solen Guitter 18
2 years ago Anne Jubert 17
2 years ago Anne Jubert 16
2 years ago Anne Jubert 15
2 years ago Solen Guitter 14 | Add links, rephrase and reorganise content a bit
2 years ago Solen Guitter 13
2 years ago Anne Jubert 12
2 years ago Solen Guitter 11
2 years ago Anne Jubert 10
2 years ago Alain Escaffre 9
2 years ago Anne Jubert 8
2 years ago Anne Jubert 7
2 years ago Anne Jubert 6
2 years ago Anne Jubert 5
2 years ago Alain Escaffre 4
2 years ago Anne Jubert 3
2 years ago Anne Jubert 2
2 years ago Antoine Taillefer 1
History: Created by Antoine Taillefer

We'd love to hear your thoughts!

All fields required