Nuxeo Online Services

Documents

Updated: October 11, 2017 Page Information Edit on GitHub

Concept

Read more about documents, properties and schemas in the Essential Nuxeo Platform Terminology.

Creating a Document Type

To create a document type, click on button "New".

  • Feature ID: The id of the document type. Will be used as the technical id at generation. Convention is to use a capital for the first letter.
  • Extend: The document type that the type being created will extend. Local types are the ones created in your Studio project. Default types are the ones part of the Nuxeo distribution you use (Nuxeo DM 5.6, ...)

Adding a custom type

if you don't find the default type you are looking for, you can add it using the custom type registry.

  • Label: You can put here a label or an i18n key.
  • Description: The description of the document type. This description is here for information purposes.

Definition Tab

  • Extends: See the Creating a Document Type section of this page.
  • Label: See the Creating a Document Type section of this page.
  • Category: The category defines in which column the document type appears on the "new Document" pop up in Nuxeo DM. If you don't want to use the default categories, you can add a new one using the custom document category registry.
  • Icon: The icon that will be displayed in the default list view. Note that you can upload new icons on the resources section.
  • Large Icon: The icon that will be displayed in the "Available document types" pop-up and the Icon view (view available up to Nuxeo Platform 5.8). Note that you can upload new icons on the& resources section.
  • Default view: The default JSF view. This is a technical attribute that you probably don't want to change (will be moved in an advanced section in the future).
  • Lifecycle: the lifecycle the document will follow. You can use a lifecycle that you defined in Studio Modeler.
  • Container types:The document types selected here are the ones from which it will be possible to create the document type being designed.
  • Accepted children types: The document types selected here will be creatable just under the document type being designed. This attribute only appears for document types that have the "folderish" facet.
  • Document Facets: Read the page Available Facets for better understanding of what facets are and which ones are available. If you don't find the facet you are looking for, you can add it using the custom facet registry.
  • Deployment mode: This is particularly useful when you declare a document type that already exists in the default product from Studio, for instance "Folder", or "File". When the contribution generated by Studio is deployed on Nuxeo DM (for instance when you click on "Update" from Admin Center), either you want to delete the previous definition, and use only what was defined from Studio (override), or you just want to "complete" the definition from what you configured in Studio (merge). A concrete example is: by default, an icon is defined for the Folder document type. If you redefine the folder document type from Studio and don't configure the Icon and Big Icon attributes, then if you select "override" for Deployment mode, your folders won't have any icon, while if you select "merge", they will keep the icon that was originally defined.

Schema Tab

This is where you can define a schema for your document type. It shows:

  • The inherited schemas, i.e. schemas from the document type you are extending
  • The Add extra schema to this document type form: Select schemas from other document types to be available for your custom document type.
  • The Add a custom schema form: Define your own schema. This is equivalent to defining the schema from the Schema feature and assign it from the Add extra schema form. Read the Schema page for more information on how to define your schema.

Creation, Edition, View and Header Layout Tabs

Requirement

Select the Nuxeo JSF UI target package in your Application Definition for this feature to be available.

On those tabs, you can respectively configure the creation, edition, view and header layouts of the document type you are designing. They work like the form layouts feature, thus you can follow the same instructions.

However there are a few differences/additional features:

  • The Header layout, which is not on the form layout feature is the part that is displayed on top of the tabs when viewing a document. By default, it displays the title and the description.
  • You don't have to reference the layout anywhere, they will be bound automatically to the document type you are configuring.
  • External Layouts: it is possible to "compose" the creation/edition/view/header layouts as being the aggregation of multiple layouts that are created from the form layouts feature.

Tabs - Default Tabs Filtering

Requirement

Select the Nuxeo JSF UI target package in your Application Definition for this feature to be available.

Documents in DM are displayed with a series of tabs to display all the actions that can be done on documents. By default, a new document type will hold all the tabs. From this view in Studio, you can disable some of them, for the document type you are configuring. This is a binary activation/inactivation. If you want to refine the tabs display rules, you can contribute XML extensions to the action service, so as to override existing contributions (for advanced users).

Tabs - Content Views

Requirement

Select the Nuxeo JSF UI target package in your Application Definition for this feature to be available.

Content view tabs are tabs that display a list of documents in a table, that is the result of an NXQL query (a content view). You configure the content view with the content view feature and just reference it here.

  • Main content: you can choose which content view is used for the document you are configuring. This appears only for document types that are folderish.
  • Trash content: you can choose which content view is used for the document that are displayed in the trash. This appears only for document types that are folderish.
  • Additional tabs configuration:

    • Label: The name displayed for this new tab. Can be a translated key.
    • Content views: You can reference several content views that will be displayed one after the other.
    • Order: The place of the tab on the document . You can put numbers like 0, 5, 10, 40, 150, ...
    • Tab Activation: (TODO: a specific page for this screen that appears in many places on Studio).

Using the Tabs feature

Adding a tab that displays a content view using this feature is easy and straightforward, but you can also use the Tabs feature that provides more refinements like the ability to add buttons, other information, wrappers, etc...

a month ago manonlumeau fix tree item index
2 years ago Manon Lumeau 31 | ix Studio menu label
2 years ago Solen Guitter 30 | Add screenshot for schema and layouts tabs
2 years ago Solen Guitter 29 | NXDOC-769: update Schema tab description
2 years ago Solen Guitter 28 | Fix format and update related how-to's.
3 years ago Solen Guitter 27
3 years ago Solen Guitter 26
3 years ago Solen Guitter 25
3 years ago Solen Guitter 24
3 years ago Solen Guitter 23
3 years ago Solen Guitter 22
3 years ago Manon Lumeau 21
3 years ago Manon Lumeau 20
3 years ago Manon Lumeau 19
3 years ago Manon Lumeau 18
3 years ago Manon Lumeau 17
3 years ago Manon Lumeau 16
3 years ago Manon Lumeau 15
3 years ago Manon Lumeau 14
4 years ago Benjamin Jalon 13
4 years ago Solen Guitter 12 | Added links, fixed typos and resized screenshots
5 years ago Alain Escaffre 11
5 years ago Alain Escaffre 10
5 years ago Alain Escaffre 9
5 years ago Alain Escaffre 8
5 years ago Alain Escaffre 7
5 years ago Alain Escaffre 6
5 years ago Alain Escaffre 5
5 years ago Alain Escaffre 4
5 years ago Alain Escaffre 3
5 years ago Alain Escaffre 2
5 years ago Benjamin Jalon 1
History: Created by Benjamin Jalon