Documents can be edited by users with writing rights in a folder.

Documents can be edited in workspaces only. If you want to modify a published document, you need to edit it in the workspace and republish it.

Editing a document means modifying its content (i.e. the attached file of a file document, the text of a note, etc.), or simply editing the title, description or any metadata of the document. You can edit documents individually using an edit form or apply modifications to several documents using the bulk edit form.

The Nuxeo Platform includes a safe edit mechanism that prevents you from inadvertently leaving an edit form without saving. This mechanism consists in displaying a popup for you to confirm you really want to quit without saving when you edit a document and try to quit the edit form or close the browser's window without clicking on the Save button.

In browsers that allow it, a draft is automatically saved for recovery.

Versioning Overview

Every time you modify a document, you can define if the changes should be saved as a new version of the document.

Every document holds a version number, which is a piece of information about the evolution of the document. A version number (V.v) is composed of a major version number (V) and a minor version number (v). When a document is created, its version number is 0.0. Minor version increment are used for secondary changes. Major version increment is usually reserved to significant modifications.

When you edit a document and save your modifications, you have several options regarding the versioning of your document.

Let's say that your current document version is 0.1.

  • You can save modifications without creating a new version of the document, as it is not yet ready. The 0.1 version of the document has been modified, so its version number becomes 0.1+ (the + indicates to other users that version 0.1 has been modified).
  • You can save the modifications in a new version of the document. The version number will then be 0.2 if you increment minor version or 1.0 if you save modifications in a major version. The newly created version is automatically archived in the History tab so it's not lost when users will edit it.

Version number 0.0

When a document is created, its version number is 0.0. This is considered as a draft of the document, which will need to be saved into a first version, either minor or major.

Draft version 0.0 is not archived and the + behavior described above does not apply to 0.0 draft.

Metadata Overview

Metadata are information describing some properties of the workspace, so that they are more accurately referenced. Some metadata are automatically filled in by the system, but most of them need to be filled in by users. When you create a document (file, note, workspace, section, or any other document type), its metadata are empty.

The Nuxeo Platform uses Dublin Core metadata by default. They are listed below:

FieldDescription

Nature

Nature of the document

Subjects

Topic(s) of the document.

Rights

Information about the reproduction rights of the document. Rights informations often encompass Intellectual Property Rights and Copyright.

Source

The references of the resource from which the document's content is derived (totally or partially).

Coverage

Information about the geographic reach of the document.

Created at

Date automatically filled in by the system when the document is created.

Last modified at

Date automatically filled in by the system when the document is modified.

Format

Format of the document, if any is preferred.

Language

Language used in the document.

Expire on

Date on which the document stops being valid. Click on the calendar icon to select a date. This date is not indexed in the system. It is just in indication for users but it is not processed by the application.

Author

User who created the document. This field is automatically filled in by the system.

Contributors

Users who modified the document. This field is automatically filled in by the system.

Last contributor

Last user who modified the document. This field is automatically filled in by the system.

Although metadata are not mandatory, filling them in will make your documents easier to find using Nuxeo search engine.

Virtual navigation

Coverage and subjects are used for virtual navigation.

To fill in or change the metadata of the document, just edit the document.

Editing a Document

To edit a document:

  1. Click on the Edit tab of the document.

    Quick access to modification

    You can also access the Edit tab directly from the folder's content using right click on the document and clicking on Modify.

  2. In the modification form displayed, type your modifications.

  3. Indicate if you want to update the document's version.

  4. Type a comment if you want to indicate why you modified the document. This comment is logged in the document's history and helps other users know what has been changed on the document.
  5. Click on the Save button. The document's Summary tab is displayed.

Office document modification

MS Office and OpenOffice.org documents can be edited directly in their native application using Live Edit or WSS/WebDav.

Bulk Editing

It is possible to edit several documents at the same time. When you bulk edit documents, you can edit a set of their metadata. You can bulk edit documents from:

  • a folder Content tab,
  • search results, whatever the search you are using,
  • a virtual navigation list of documents.

To edit several documents at the same time:

  1. Select the documents to edit using the checkboxes on the documents list.

    Document selected in other pages remain selected

    When you navigate from page to page, you selection is not lost and you can bulk-edit documents that are not on the same page.

    There is a drawback: You must make sure to bulk-edit only the correct documents (i.e. there are no checked documents in other pages that, in fact, you don't want to edit.).

  2. Click on the Edit button displayed at the bottom of the list of documents. The bulk edit form is displayed in a popup window. All values are empty by default.
  3. Fill in the relevant metadata and leave other values empty by default. The box corresponding to the edited metadata is automatically checked.

    Bulk edit overwrites previously filled in values

    If you edit metadata for which the document(s) already had a value, the previous value will be replaced by the one you select on the bulk edit form.

  4. Click on the Save button. The selected documents are all modified with the selected values, after a new minor version has been saved for each document. Other values are left as they were.

    It is possible to change the default bulk edit versioning policy. See the page Bulk Edit in the developer documentation.

25 days ago Andrew Goodricke Syntax error fixed
3 years ago Solen Guitter 48
5 years ago Solen Guitter 47 | link to virtual nav addon
5 years ago Manon Lumeau 46
5 years ago Manon Lumeau 45
5 years ago Manon Lumeau 44
5 years ago Solen Guitter 43 | Link update
6 years ago Solen Guitter 42
6 years ago Solen Guitter 41
6 years ago Solen Guitter 40
6 years ago Solen Guitter 39
6 years ago Solen Guitter 38 | Added note about draft version 0.0
6 years ago Solen Guitter 37 | Removed related topics from TOC
6 years ago Solen Guitter 36 | Added link to bulk edit dev doc and dev related doc
6 years ago Solen Guitter 35 | Reorganization
6 years ago Thibaud Arguillere 34
6 years ago Solen Guitter 33 | Updated bulk edit screenshot for 5.8
6 years ago Solen Guitter 32 | Added details on safe edit
6 years ago Solen Guitter 31
6 years ago Solen Guitter 30
6 years ago Solen Guitter 29
6 years ago Solen Guitter 28
6 years ago Solen Guitter 27 | Added new 5.7.1 bulk edit feature
6 years ago Solen Guitter 26 | Added safe edit feature
7 years ago Solen Guitter 24
7 years ago Solen Guitter 25 | Migration of unmigrated content due to installation of a new plugin
7 years ago Solen Guitter 20 | Fixed broken link
7 years ago Solen Guitter 21 | Migrated to Confluence 4.0
7 years ago Solen Guitter 22 | Migration of unmigrated content due to installation of a new plugin
7 years ago Solen Guitter 23 | Migration of unmigrated content due to installation of a new plugin
8 years ago Solen Guitter 19
8 years ago Solen Guitter 18 | Fixed broken link
8 years ago Solen Guitter 17 | Updated screenshot
8 years ago Solen Guitter 16
8 years ago Solen Guitter 15 | Corrected wrong label
8 years ago Solen Guitter 14
8 years ago Solen Guitter 13 | Added last contributor metadata
8 years ago Solen Guitter 12 | Added link to virtual navitation
8 years ago Solen Guitter 11 | Added toc and related pages
8 years ago Solen Guitter 10
8 years ago Solen Guitter 9 | fixed brocken link
8 years ago Solen Guitter 8
8 years ago Solen Guitter 7
8 years ago Benoit Delbosc 6
9 years ago Solen Guitter 5
9 years ago Solen Guitter 4 | update new default version number
9 years ago Solen Guitter 3 | added new "nature" metadata
9 years ago Solen Guitter 2 | fixed broken links
9 years ago Solen Guitter 1
History: Created by Solen Guitter

We'd love to hear your thoughts!

All fields required